Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.7.0)

E10653-08

oracle.jbo
Interface AttributeDef

All Superinterfaces:
ExprWrappable, Properties
All Known Subinterfaces:
AttributeInterface, Variable
All Known Implementing Classes:
AssociationDefImpl, AttributeDefHelper, AttributeDefImpl, AttributeDefImpl, AttributeDefImpl, AttributeDefOverAttr, AttributeInfo, CmrAccessorDefImpl, DCVariableImpl, DCVCSubstAttrDef, DomainAttributeDef, JUCtrlParameterDef, VariableImpl, ViewAttributeDefImpl, ViewCriteriaItem, ViewCriteriaItemCompound, ViewCriteriaItemCompoundImpl, ViewCriteriaItemImpl, WSAttributeDefImpl

public interface AttributeDef
extends Properties

Defines access to named attribute definitions.

Since:
JDeveloper 3.0
See Also:
Row, RowSet, StructureDef

Field Summary
static byte ATTR_ASSOCIATED_ROW
          An association or view link accessor that returns a single row.
static byte ATTR_ASSOCIATED_ROWITERATOR
          An association or view link accessor that returns a row iterator.
static byte ATTR_DYNAMIC
          Indicates that this attribute definition is for a dynamic attribute.
static byte ATTR_ENTITY_DERIVED
          Indicates that this attribute in a view object is mapped to a transient attribute of the entity object.
static byte ATTR_HIDDEN
          A hidden attribute.
static byte ATTR_PERSISTENT
          A persistent attribute that is mapped to a column in a database table.
static byte ATTR_ROWSET
          Indicates that this attribute definition is for a view accessor.
static byte ATTR_SQL_DERIVED
          An attribute whose value is retrieved via a SQL expression.
static byte ATTR_TRANSIENT
          A transient attribute which is not mapped to a database column or a SQL expression.
static byte ATTR_VARIABLE
          Indicates that this attribute definition is for a Variable.
static byte READONLY
          The attribute cannot be modified.
static byte UPDATEABLE
          The attribute can be freely modified.
static byte UPDATEABLE_WHILE_NEW
          The attribute can be modified until it is committed, but cannot be subsequently modified.
 
Method Summary
 ViewObject getAccessorVO(ViewObject originVO)
          For an accessor attribute, this method creates a View Object that works for the View Link definition.
 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 getElemSQLType()
          Returns the jdbc type of the elements of this attribute.
 java.lang.Class getElemType()
          Returns the element type of the attribute.
 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.
 ListBindingDef getListBindingDef()
           
 java.lang.String getLOVName()
          Gets the name of the LOV (list of values) associated with this attribute definition.
 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.
 AttributeHints getUIHelper()
          Returns the user interface hints interface for retrieving hint information such as labels, prompts,...
 byte getUpdateableFlag()
          Tests if an attribute can be modified.
 boolean isDiscrColumn()
          Tests if an attribute is a discriminator.
 boolean isMandatory()
          Tests if an 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()
           
 
Methods inherited from interface oracle.jbo.Properties
getProperties, getProperty, getProperty, refreshProperty
 

Field Detail

ATTR_VARIABLE

static final byte ATTR_VARIABLE
Indicates that this attribute definition is for a Variable.

See Also:
Constant Field Values

ATTR_PERSISTENT

static final byte ATTR_PERSISTENT
A persistent attribute that is mapped to a column in a database table.

See Also:
Constant Field Values

ATTR_SQL_DERIVED

static final byte ATTR_SQL_DERIVED
An attribute whose value is retrieved via a SQL expression.

See Also:
Constant Field Values

ATTR_ASSOCIATED_ROW

static final byte ATTR_ASSOCIATED_ROW
An association or view link accessor that returns a single row.

See Also:
Constant Field Values

ATTR_TRANSIENT

static final byte ATTR_TRANSIENT
A transient attribute which is not mapped to a database column or a SQL expression.

See Also:
Constant Field Values

ATTR_DYNAMIC

static final byte ATTR_DYNAMIC
Indicates that this attribute definition is for a dynamic attribute. See ViewObject.addDynamicAttribute() for detail.

See Also:
Constant Field Values

ATTR_ENTITY_DERIVED

static final byte ATTR_ENTITY_DERIVED
Indicates that this attribute in a view object is mapped to a transient attribute of the entity object.

See Also:
Constant Field Values

ATTR_ASSOCIATED_ROWITERATOR

static final byte ATTR_ASSOCIATED_ROWITERATOR
An association or view link accessor that returns a row iterator.

See Also:
Constant Field Values

ATTR_ROWSET

static final byte ATTR_ROWSET
Indicates that this attribute definition is for a view accessor.

See Also:
Constant Field Values

ATTR_HIDDEN

static final byte ATTR_HIDDEN
A hidden attribute.

See Also:
Constant Field Values

READONLY

static final byte READONLY
The attribute cannot be modified.

See Also:
Constant Field Values

UPDATEABLE_WHILE_NEW

static final byte UPDATEABLE_WHILE_NEW
The attribute can be modified until it is committed, but cannot be subsequently modified.

See Also:
Constant Field Values

UPDATEABLE

static final byte UPDATEABLE
The attribute can be freely modified.

See Also:
Constant Field Values
Method Detail

getAttributeKind

byte getAttributeKind()
Gets the attribute value.

Returns:
one of the ATTR constants defined for this class.

getName

java.lang.String getName()
Gets the name of the attribute.

Returns:
the name of the attribute.

getColumnName

java.lang.String getColumnName()
Gets the name of the database column the attribute represents.

Returns:
the name of the column.

getColumnNameForQuery

java.lang.String getColumnNameForQuery()
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.

Returns:
the column name to be used in query.

getIndex

int getIndex()
Gets the index of the attribute in the context of a StoreInfo instance.

Returns:
the index of the attribute row's definition object.

getJavaType

java.lang.Class getJavaType()
Gets the Java class of the object stored for this attribute definition.

Returns:
the class of the attribute.

getLOVName

java.lang.String getLOVName()
Gets the name of the LOV (list of values) associated with this attribute definition.

Returns:
the name of the LOV (may be null)

getListBindingDef

ListBindingDef getListBindingDef()

getSQLType

int getSQLType()
Gets the JDBC type of the attribute.

Returns:
the JDBC type.
See Also:
Types

getScale

int getScale()
Get the scale value of a numeric attribute.

Returns:
the scale value for this attribute, if applicable.

getPrecision

int getPrecision()
Gets the precision of a numeric or string attribute.

'Precision' for a string is the maximum length.

Returns:
the precision value for this attribute.

isDiscrColumn

boolean isDiscrColumn()
Tests if an attribute is a discriminator. Discriminating attributes are those whose values determine the (sub)type representing the entity.

Returns:
true if this is a Discriminator Column; false otherwise.

isSelected

boolean isSelected()

isQueriable

boolean isQueriable()
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.

Returns:
true if this attribute is queriable.

getUpdateableFlag

byte getUpdateableFlag()
Tests if an attribute can be modified.

Returns:
READONLY, UPDATEABLE, or UPDATEABLE_WHILE_NEW.

isPrimaryKey

boolean isPrimaryKey()
Tests if an attribute is a Primary Key.

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

boolean isMandatory()
Tests if an attribute does not allow null values.

Returns:
true if this attribute cannot store a null value

getUIHelper

AttributeHints getUIHelper()
Returns the user interface hints interface for retrieving hint information such as labels, prompts,...

See Also:
AttributeHints

getElemType

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.

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

getElemSQLType

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.

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.

getAccessorVO

ViewObject getAccessorVO(ViewObject originVO)
For an accessor attribute, this method creates a View Object that works for the View Link definition.

Parameters:
originVO - the View Object that owns the accessor
Returns:
a ViewObject instance.

Oracle Fusion Middleware Java API Reference for Oracle ADF Model
11g Release 1 (11.1.1.7.0)

E10653-08

Copyright © 1997, 2013, Oracle. All rights reserved.