|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.5.0) E13403-06 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DBObjectBuilder<T extends DBObject>
The DBObjectBuilder
interface provides a mechanism for constructing new instances representing database objects.
A DBObjectProvider
can use a DBObjectBuilder to construct data model instances without needing to know how the data model is being determined. For example, a generic JDBC implementation of DBObjectBuilder for tables could use the information from DatabaseMetaData to create the model; an Oracle specific DBObjectBuilder could query the data dictionary directly; and an offline DBObjectBuilder could convert an XML file into the table data model.
DBObjectBuilder
implementations may implement lazy instantiation of the SchemaObject instances they create. A lazily instantiated SchemaObject will always have its Schema and Name properties set; however, any additional properties may not be initialized until a caller requests them. The DBObjectBuilder should set itself as the builder on the lazily instantiated SchemaObject; the SchemaObject will call the buildObject
method on the DBObjectBuilder to fill in the rest of the data. The DBObjectBuilder implementation determines how much information is filled in when the SchemaObject is created.
If the DBObjectBuilder implementation does not implement lazy instantiation, createObject
should return a complete SchemaObject. Calling buildObject
on a complete SchemaObject should return immediately.
DBObjectProvider
Field Summary | |
---|---|
static java.lang.String |
BASE_COMPONENT_KEY Deprecated. with no replacement. Property building is done using property names. |
Method Summary | |
---|---|
void |
buildObject(T object) Requests that the specified object be completed. |
void |
buildObjectComponent(T object, java.lang.String key) Requests that part of the specified object, signifed by the given key, is built. |
T |
createObject(java.lang.String name, Schema schema, DBObjectID id) Requests the creation of a new SchemaObject of the type built by this DBObjectBuilder instance. |
Field Detail |
---|
@Deprecated
static final java.lang.String BASE_COMPONENT_KEY
Method Detail |
---|
T createObject(java.lang.String name, Schema schema, DBObjectID id)
DBObjectBuilder
instance.name
- The name of the new objectschema
- The schema containing the new objectid
- the DBObjectID for the new objectvoid buildObject(T object) throws DBException
object
- The object needing buildingDBException
- if an error occurs trying to build the objectvoid buildObjectComponent(T object, java.lang.String key) throws DBException
object
-key
-DBException
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.5.0) E13403-06 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |