oracle.adf.model.generic
Class AttributeDefImpl

java.lang.Object
oracle.jbo.common.NamedObjectImpl
oracle.jbo.mom.DefinitionObject
oracle.adf.model.generic.AttributeDefImpl

All Implemented Interfaces:

AttributeDef, oracle.jbo.AttributeHints, oracle.jbo.Properties, oracle.jbo.rules.ValidationManager

public class AttributeDefImpl

extends oracle.jbo.mom.DefinitionObject

implements AttributeDef, oracle.jbo.AttributeHints, oracle.jbo.rules.ValidationManager

The AttributeDefHelper class implement the AttributeDef interface

10.1.3.1.0:

INTERNAL

See Also:

RowImpl

Field Summary

Fields inherited from class oracle.jbo.mom.DefinitionObject

mBaseDefObject, mExtendedDefObjects, mObjectResolved

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties

Fields inherited from interface oracle.jbo.AttributeDef

ATTR_ASSOCIATED_ROW, ATTR_ASSOCIATED_ROWITERATOR, ATTR_DYNAMIC, ATTR_ENTITY_DERIVED, ATTR_PERSISTENT, ATTR_SQL_DERIVED, ATTR_TRANSIENT, ATTR_VARIABLE, READONLY, UPDATEABLE, UPDATEABLE_WHILE_NEW

Fields inherited from interface oracle.jbo.AttributeHints

ATTRIBUTE_CTL_DISPLAYHEIGHT, ATTRIBUTE_CTL_DISPLAYWIDTH, ATTRIBUTE_CTL_FORMTYPE, ATTRIBUTE_CTL_TYPE, ATTRIBUTE_DISPLAY_HINT, ATTRIBUTE_DISPLAY_HINT_DISPLAY, ATTRIBUTE_DISPLAY_HINT_HIDE, ATTRIBUTE_FORM_TYPE_DETAIL, ATTRIBUTE_FORM_TYPE_SHORT, ATTRIBUTE_LABEL, ATTRIBUTE_TOOLTIP, CTLTYPE_DATE, CTLTYPE_DEFAULT, CTLTYPE_EDIT, CTLTYPE_IMAGE, CTLTYPE_LIST, CTLTYPE_LOV, CTLTYPE_TOGGLE, FMT_FORMAT, FMT_FORMATTER

Constructor Summary

AttributeDefImpl(java.lang.String nm, java.lang.String type, java.lang.String accName, boolean editable, int index)
Deprecated. since 10.1.2. Use a constructor variant that takes StructureDefImpl.

AttributeDefImpl(StructureDefImpl def, java.lang.String nm, java.lang.String cnm, int idx, java.lang.String typ, java.lang.String cnmType, byte upd, boolean pk, boolean reqd, java.lang.String elemClzName)
Deprecated. since 10.1.3. Use a constructor variant that takes StructureDefImpl.

Method Summary

void	addValidator(oracle.jbo.rules.JboValidatorInterface intf)
boolean	displayInShortForm(LocaleContext locale)
byte	getAttributeKind() Gets the attribute value.
java.lang.String	getColumnName() Gets the name of the database column the attribute represents.
java.lang.String	getColumnNameForQuery() Gets the column name to be used in query statement.
int	getControlType(LocaleContext locale) Returns the preferred control type for this attribute
int	getDisplayHeight(LocaleContext locale) Returns the display width for this attribute
java.lang.String	getDisplayHint(LocaleContext locale) Retrieves the displya hint that dictates whether this attributr should be visible or not.
int	getDisplayWidth(LocaleContext locale) Returns the display width for this attribute
int	getElemSQLType() Returns the jdbc type of the elements of this attribute.
java.lang.Class	getElemType() Returns the element type of the attribute.
java.lang.String	getFormat(LocaleContext locale)
java.lang.String	getFormattedAttribute(oracle.jbo.AttributeList attrList, LocaleContext locale)
oracle.jbo.format.Formatter	getFormatter(LocaleContext locale)
java.lang.String	getFormatterClassName(LocaleContext locale) returns the formatter object stored in the ui hints
java.lang.String	getHint(LocaleContext locale, java.lang.String sHintName) Return defaulted hint value
java.lang.String	getHintValue(LocaleContext locale, java.lang.String sHintName) Return non-defaulted hint value
int	getIndex() Gets the index of the attribute in the context of a StoreInfo instance.
java.lang.Class	getJavaType() Gets the Java class of the object stored for this attribute definition.
java.lang.String	getJavaTypeName()
java.lang.String	getLabel(LocaleContext locale) Retrieves the label to be used in any attribute prompts
java.lang.String	getLocaleName(LocaleContext locale, java.lang.String sName)
java.lang.String	getName() Gets the name of the attribute.
int	getPrecision() Gets the precision of a numeric or string attribute.
int	getScale() Get the scale value of a numeric attribute.
int	getSQLType() Gets the JDBC type of the attribute.
java.lang.String	getTooltip(LocaleContext locale) Retrives the tooltip text to be used for this attribute
oracle.jbo.AttributeHints	getUIHelper() return the AttributeHints interface implemented by this class
byte	getUpdateableFlag() Tests if an attribute can be modified.
java.util.ArrayList	getValidators()
boolean	hasFormatInformation(LocaleContext locale)
boolean	isMandatory() Return true if this attribute does not allow null values.
boolean	isPrimaryKey() Tests if an attribute is a Primary Key.
boolean	isQueriable() Tests if an attribute is queriable.
boolean	isSelected() Tests if an attribute is transient.
java.lang.Object	parseFormattedAttribute(java.lang.String sValue, LocaleContext locale)
void	setPrecisionScale(int prec, int scale) Use setPrecisionScale(int, int, boolean) to indicate if this def should imply applying precision validation as well.
void	setPrecisionScale(int prec, int scale, boolean applyValidation)
void	validate(oracle.jbo.AttributeList al, java.lang.Object newValue)

Methods inherited from class oracle.jbo.mom.DefinitionObject

addExtendedDefObject, finishedLoading, getBaseDefObject, getContainerDef, getContainerName, getExtendedDefObjects, hasExtendedDefObjects, isBaseDefFor, isDynamicDefinitionObject, isObjectResolved, loadProperties, resolveReferences, setBaseDefObject, setName, setObjectResolved, setParent

Methods inherited from class oracle.jbo.common.NamedObjectImpl

getFullName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, refreshProperty, setFullName, setPropertiesMap, setProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface oracle.jbo.Properties

getProperties, getProperty, refreshProperty

Constructor Detail

AttributeDefImpl

public AttributeDefImpl(java.lang.String nm,
                        java.lang.String type,
                        java.lang.String accName,
                        boolean editable,
                        int index)

Deprecated. since 10.1.2. Use a constructor variant that takes StructureDefImpl.

Construct a new instance.

Parameters:

nm - The AttributeDefImpl instance name. Must be unique for for the parent StructureDefImpl instance.

type - The type of the value that is returned by this AttributeDefImpl instance.

accName - The name that should be used to acquire the AttributeDefImpl value from the owning StructureDefImpl. If The owning StructureDefImpl instance is dynamic then this should be a map key. If the owning StructureDefImpl instance references a a JavaBean then this should be a JavaBean property name.

editable - a boolean indicating if the AttributeDefImpl value is editable.

index - The index of the AttributeDefImpl instance in its owning StructureDefImpl instance.

AttributeDefImpl

public AttributeDefImpl(StructureDefImpl def,
                        java.lang.String nm,
                        java.lang.String cnm,
                        int idx,
                        java.lang.String typ,
                        java.lang.String cnmType,
                        byte upd,
                        boolean pk,
                        boolean reqd,
                        java.lang.String elemClzName)

Deprecated. since 10.1.3. Use a constructor variant that takes StructureDefImpl.

Construct a new instance. For internal use only.

Parameters:

def - instance to which this attribute definition belongs.

nm - The AttributeDefImpl instance name. Must be unique for for the parent StructureDefImpl instance.

cnm - Name of the source to which this attribute is mapped to in the source data objects for this definition

idx - Index of this attribute within the structure definition.

typ - The type of the value that is returned by this AttributeDefImpl instance.

cnmType - The type of the value that the source data objects provide for this attribute.

upd - One of the three udpateable flags in AttributeDef.

pk - Whether this attribute should be a primarykey participant

reqd - Whether this attribute requires a non-null value.

elemClzName - Name of the class to which the objects in this attribute belongs if this attribute represents a collection type attribute (e.g., Array domain)

Method Detail

setPrecisionScale

public void setPrecisionScale(int prec,
                              int scale)

Use setPrecisionScale(int, int, boolean) to indicate if this def should imply applying precision validation as well.

setPrecisionScale

public void setPrecisionScale(int prec,
                              int scale,
                              boolean applyValidation)

getUIHelper

public oracle.jbo.AttributeHints getUIHelper()

return the AttributeHints interface implemented by this class

Specified by:

getUIHelper in interface AttributeDef

See Also:

AttributeHints

getLocaleName

public java.lang.String getLocaleName(LocaleContext locale,
                                      java.lang.String sName)

Specified by:

getLocaleName in interface oracle.jbo.AttributeHints

getLabel

public java.lang.String getLabel(LocaleContext locale)

Retrieves the label to be used in any attribute prompts

Specified by:

getLabel in interface oracle.jbo.AttributeHints

getTooltip

public java.lang.String getTooltip(LocaleContext locale)

Retrives the tooltip text to be used for this attribute

Specified by:

getTooltip in interface oracle.jbo.AttributeHints

getDisplayHint

public java.lang.String getDisplayHint(LocaleContext locale)

Retrieves the displya hint that dictates whether this attributr should be visible or not. The two possible values are: ATTRIBUTE_DISPLAY_HINT_DISPLAY = "Display"; ATTRIBUTE_DISPLAY_HINT_HIDE = "Hide";

Specified by:

getDisplayHint in interface oracle.jbo.AttributeHints

getControlType

public int getControlType(LocaleContext locale)

Returns the preferred control type for this attribute

Specified by:

getControlType in interface oracle.jbo.AttributeHints

getDisplayWidth

public int getDisplayWidth(LocaleContext locale)

Returns the display width for this attribute

Specified by:

getDisplayWidth in interface oracle.jbo.AttributeHints

getDisplayHeight

public int getDisplayHeight(LocaleContext locale)

Returns the display width for this attribute

Specified by:

getDisplayHeight in interface oracle.jbo.AttributeHints

getHint

public java.lang.String getHint(LocaleContext locale,
                                java.lang.String sHintName)

Return defaulted hint value

Specified by:

getHint in interface oracle.jbo.AttributeHints

getHintValue

public java.lang.String getHintValue(LocaleContext locale,
                                     java.lang.String sHintName)

Return non-defaulted hint value

Specified by:

getHintValue in interface oracle.jbo.AttributeHints

getFormat

public java.lang.String getFormat(LocaleContext locale)

Specified by:

getFormat in interface oracle.jbo.AttributeHints

getFormatter

public oracle.jbo.format.Formatter getFormatter(LocaleContext locale)

Specified by:

getFormatter in interface oracle.jbo.AttributeHints

hasFormatInformation

public boolean hasFormatInformation(LocaleContext locale)

Specified by:

hasFormatInformation in interface oracle.jbo.AttributeHints

getFormattedAttribute

public java.lang.String getFormattedAttribute(oracle.jbo.AttributeList attrList,
                                              LocaleContext locale)

Specified by:

getFormattedAttribute in interface oracle.jbo.AttributeHints

parseFormattedAttribute

public java.lang.Object parseFormattedAttribute(java.lang.String sValue,
                                                LocaleContext locale)

Specified by:

parseFormattedAttribute in interface oracle.jbo.AttributeHints

displayInShortForm

public boolean displayInShortForm(LocaleContext locale)

Specified by:

displayInShortForm in interface oracle.jbo.AttributeHints

getFormatterClassName

public java.lang.String getFormatterClassName(LocaleContext locale)

returns the formatter object stored in the ui hints

Specified by:

getFormatterClassName in interface oracle.jbo.AttributeHints

getName

public java.lang.String getName()

Description copied from interface: AttributeDef

Gets the name of the attribute.

Specified by:

getName in interface AttributeDef

getColumnName

public java.lang.String getColumnName()

Description copied from interface: AttributeDef

Gets the name of the database column the attribute represents.

Specified by:

getColumnName in interface AttributeDef

Returns:

the name of the column.

getColumnNameForQuery

public java.lang.String getColumnNameForQuery()

Description copied from interface: AttributeDef

Gets the column name to be used in query statement. If the VO involves multiple entity usages, the column name may have to be qualified with the table alias for the appropriate entity. If the query statement is a full query ("expert mode"), the where-clause in the outer select must use column alias used for the inner select. This method takes care of all this and returns the right column name to be used for a query statement.

Specified by:

getColumnNameForQuery in interface AttributeDef

Returns:

the column name to be used in query.

getIndex

public int getIndex()

Description copied from interface: AttributeDef

Gets the index of the attribute in the context of a StoreInfo instance.

Specified by:

getIndex in interface AttributeDef

Returns:

the index of the attribute row's definition object.

getJavaType

public java.lang.Class getJavaType()

Description copied from interface: AttributeDef

Gets the Java class of the object stored for this attribute definition.

Specified by:

getJavaType in interface AttributeDef

Returns:

the class of the attribute.

getJavaTypeName

public java.lang.String getJavaTypeName()

getSQLType

public int getSQLType()

Description copied from interface: AttributeDef

Gets the JDBC type of the attribute.

Specified by:

getSQLType in interface AttributeDef

Returns:

the JDBC type.

See Also:

Types

getAttributeKind

public byte getAttributeKind()

Description copied from interface: AttributeDef

Gets the attribute value.

Specified by:

getAttributeKind in interface AttributeDef

Returns:

one of the ATTR constants defined for this class.

isSelected

public boolean isSelected()

Description copied from interface: AttributeDef

Tests if an attribute is transient. Transient attributes are those whose values are derived when needed. There is no mapping onto a column in a table for these values.

Specified by:

isSelected in interface AttributeDef

Returns:

true if this attribute is transient.

isQueriable

public boolean isQueriable()

Description copied from interface: AttributeDef

Tests if an attribute is queriable.

Queriable attributes are those that may have a filter condition for the WHERE clause If this method returns false, the attribute will not be used in constructing the WHERE clause of SQL statements to fetch data.

Specified by:

isQueriable in interface AttributeDef

Returns:

true if this attribute is queriable.

getUpdateableFlag

public byte getUpdateableFlag()

Description copied from interface: AttributeDef

Tests if an attribute can be modified.

Specified by:

getUpdateableFlag in interface AttributeDef

Returns:

READONLY, UPDATEABLE, or UPDATEABLE_WHILE_NEW.

isPrimaryKey

public boolean isPrimaryKey()

Description copied from interface: AttributeDef

Tests if an attribute is a Primary Key.

Specified by:

isPrimaryKey in interface AttributeDef

Returns:

true if this is either a Primary Key attribute or part of the attributes that constitute the Primary Key for a given row.

isMandatory

public boolean isMandatory()

Return true if this attribute does not allow null values.

Specified by:

isMandatory in interface AttributeDef

Returns:

true if this attribute cannot store a null value

getPrecision

public int getPrecision()

Description copied from interface: AttributeDef

Gets the precision of a numeric or string attribute.

'Precision' for a string is the maximum length.

Specified by:

getPrecision in interface AttributeDef

Returns:

the precision value for this attribute.

getScale

public int getScale()

Description copied from interface: AttributeDef

Get the scale value of a numeric attribute.

Specified by:

getScale in interface AttributeDef

Returns:

the scale value for this attribute, if applicable.

getElemType

public java.lang.Class getElemType()

Returns the element type of the attribute.

For VARRAYs, this method returns the class name of the elements that are in the VARRAY.

Element type is relevant only if the attribute is an array attribute.

Specified by:

getElemType in interface AttributeDef

Returns:

the attribute's element class, or null if the attribute is not an array attribute.

getElemSQLType

public int getElemSQLType()

Returns the jdbc type of the elements of this attribute.

For VARRAYs, this method returns the jdbc type of the elements that are in the VARRAY.

Element type is relevant only if the attribute is an array attribute.

Specified by:

getElemSQLType in interface AttributeDef

Returns:

the jdbc type (java.sql.Types.*) of this attribute's elements, or java.sql.Types.NULL if this attribute is not an array attribute.

addValidator

public void addValidator(oracle.jbo.rules.JboValidatorInterface intf)

Specified by:

addValidator in interface oracle.jbo.rules.ValidationManager

getValidators

public java.util.ArrayList getValidators()

Specified by:

getValidators in interface oracle.jbo.rules.ValidationManager

validate

public void validate(oracle.jbo.AttributeList al,
                     java.lang.Object newValue)