Package org.apache.openjpa.jdbc.meta
Class ClassMappingInfo
- java.lang.Object
-
- org.apache.openjpa.jdbc.meta.MappingInfo
-
- org.apache.openjpa.jdbc.meta.ClassMappingInfo
-
- All Implemented Interfaces:
java.io.Serializable
,SourceTracker
,Commentable
public class ClassMappingInfo extends MappingInfo implements SourceTracker, Commentable
Information about the mapping from a class to the schema, in raw form. The columns and tables used in mapping info will not be part of theSchemaGroup
used at runtime. Rather, they will be structs with the relevant pieces of information filled in.- Author:
- Abe White
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.apache.openjpa.jdbc.meta.MappingInfo
MappingInfo.ForeignKeyDefaults, MappingInfo.TableDefaults
-
-
Field Summary
-
Fields inherited from class org.apache.openjpa.jdbc.meta.MappingInfo
JOIN_FORWARD, JOIN_INVERSE, JOIN_NONE
-
Fields inherited from interface org.apache.openjpa.lib.xml.Commentable
EMPTY_COMMENTS
-
Fields inherited from interface org.apache.openjpa.lib.meta.SourceTracker
SRC_ANNOTATIONS, SRC_OTHER, SRC_XML
-
-
Constructor Summary
Constructors Constructor Description ClassMappingInfo()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
addIndex(DBIdentifier table, Index idx)
Add index for the given table.void
addSecondaryTable(java.lang.String second)
Deprecated.void
addSecondaryTable(DBIdentifier second)
void
addUnique(java.lang.String table, Unique unique)
Deprecated.void
addUnique(DBIdentifier table, Unique unique)
Add a unique constraint for the given table.protected void
clear(boolean canFlags)
Clear mapping information.void
copy(MappingInfo info)
Copy missing info from the instance to this one.java.lang.String
getClassName()
The described class name.int
getColNumber()
Return the column number in the line of the file at which this instance was parsed.java.lang.String[]
getComments()
Return comments, or empty array if none.Column[]
getDataStoreIdColumns(ClassMapping cls, Column[] tmplates, Table table, boolean adapt)
Return the datastore identity columns for the given class, based on the given templates.java.lang.String
getHierarchyStrategy()
The default strategy for subclasses in this hierarchy.Index[]
getIndices(MetaDataContext cm, boolean adapt)
Get all indices associated with both the primary and/or secondary tables.int
getLineNumber()
Return the line number of the file at which this instance was parsed.java.lang.String
getResourceName()
Return the domain-meaningful name of the resource that was loaded from this source.DBIdentifier
getSchemaIdentifier()
java.lang.String
getSchemaName()
Deprecated.DBIdentifier
getSecondaryTableIdentifier(DBIdentifier tableName)
DBIdentifier[]
getSecondaryTableIdentifiers()
java.util.List<Column>
getSecondaryTableJoinColumns(java.lang.String tableName)
Deprecated.java.util.List<Column>
getSecondaryTableJoinColumns(DBIdentifier tableName)
java.lang.String
getSecondaryTableName(java.lang.String tableName)
Deprecated.java.lang.String[]
getSecondaryTableNames()
Deprecated.java.io.File
getSourceFile()
Return the file from which this instance was parsed.java.lang.Object
getSourceScope()
Return the domain-dependent scope of this instance within its file.int
getSourceType()
Return the type of source.ForeignKey
getSuperclassJoin(ClassMapping cls, Table table, boolean adapt)
Return the join from this class to its superclass.Table
getTable(ClassMapping cls, boolean adapt)
Return the primary table for the given class.Table
getTable(ClassMapping cls, java.lang.String tableName, boolean adapt)
Deprecated.Table
getTable(ClassMapping cls, DBIdentifier tableName, boolean adapt)
Return the named table for the given class.DBIdentifier
getTableIdentifier()
java.lang.String
getTableName()
Deprecated.Unique[]
getUniques(java.lang.String table)
Deprecated.Unique[]
getUniques(DBIdentifier table)
Get the unique constraints of the given primary or secondary table.Unique[]
getUniques(MetaDataContext cm, boolean adapt)
Get all the unique constraints associated with both the primary and/or secondary tables.boolean
hasSchemaComponents()
Return true if this info has columns, foreign key information, index information, etc.boolean
isJoinedSubclass()
Whether there is a join to the superclass table.void
setClassName(java.lang.String name)
The described class name.void
setColNumber(int colNum)
void
setComments(java.lang.String[] comments)
Set comments.void
setHierarchyStrategy(java.lang.String strategy)
The default strategy for subclasses in this hierarchy.void
setJoinedSubclass(boolean joined)
Whether there is a join to the superclass table.void
setLineNumber(int lineNum)
void
setSchemaIdentifier(DBIdentifier schema)
void
setSchemaName(java.lang.String schema)
Deprecated.void
setSecondaryTableJoinColumns(java.lang.String tableName, java.util.List<Column> cols)
Deprecated.void
setSecondaryTableJoinColumns(DBIdentifier tableName, java.util.List<Column> cols)
void
setSource(java.io.File file, int srcType)
void
setTableIdentifier(DBIdentifier table)
void
setTableName(java.lang.String table)
Deprecated.void
syncWith(ClassMapping cls)
Synchronize internal information with the mapping data for the given class.-
Methods inherited from class org.apache.openjpa.jdbc.meta.MappingInfo
assertNoForeignKey, assertNoIndex, assertNoJoin, assertNoSchemaComponents, assertNoUnique, assertStrategy, canForeignKey, canIndex, canUnique, clear, createColumns, createForeignKey, createIndex, createTable, createTable, createUnique, getColumnIO, getColumns, getColumns, getColumns, getForeignKey, getIndex, getJoinDirection, getStrategy, getUnique, isImplicitRelation, mergeColumn, setCanForeignKey, setCanIndex, setCanUnique, setColumnIO, setColumns, setForeignKey, setImplicitRelation, setIndex, setJoinDirection, setStrategy, setUnique, syncColumn, syncColumns, syncForeignKey, syncIndex, syncUnique
-
-
-
-
Method Detail
-
getClassName
public java.lang.String getClassName()
The described class name.
-
setClassName
public void setClassName(java.lang.String name)
The described class name.
-
getHierarchyStrategy
public java.lang.String getHierarchyStrategy()
The default strategy for subclasses in this hierarchy.
-
setHierarchyStrategy
public void setHierarchyStrategy(java.lang.String strategy)
The default strategy for subclasses in this hierarchy.
-
getTableName
@Deprecated public java.lang.String getTableName()
Deprecated.The given table name.
-
getTableIdentifier
public DBIdentifier getTableIdentifier()
-
setTableName
@Deprecated public void setTableName(java.lang.String table)
Deprecated.The given table name.
-
setTableIdentifier
public void setTableIdentifier(DBIdentifier table)
-
getSchemaName
@Deprecated public java.lang.String getSchemaName()
Deprecated.The default schema name for unqualified tables.
-
getSchemaIdentifier
public DBIdentifier getSchemaIdentifier()
-
setSchemaName
@Deprecated public void setSchemaName(java.lang.String schema)
Deprecated.The default schema name for unqualified tables.
-
setSchemaIdentifier
public void setSchemaIdentifier(DBIdentifier schema)
-
isJoinedSubclass
public boolean isJoinedSubclass()
Whether there is a join to the superclass table.
-
setJoinedSubclass
public void setJoinedSubclass(boolean joined)
Whether there is a join to the superclass table.
-
getSecondaryTableNames
@Deprecated public java.lang.String[] getSecondaryTableNames()
Deprecated.Return the class-level joined tables.
-
getSecondaryTableIdentifiers
public DBIdentifier[] getSecondaryTableIdentifiers()
-
getSecondaryTableName
@Deprecated public java.lang.String getSecondaryTableName(java.lang.String tableName)
Deprecated.We allow fields to reference class-level joins using just the table name, whereas the class join might have schema, etc information. This method returns the name of the given table as listed in a class-level join, or the given name if no join exists.
-
getSecondaryTableIdentifier
public DBIdentifier getSecondaryTableIdentifier(DBIdentifier tableName)
-
getSecondaryTableJoinColumns
@Deprecated public java.util.List<Column> getSecondaryTableJoinColumns(java.lang.String tableName)
Deprecated.Return any columns defined for the given class level join, or empty list if none.
-
getSecondaryTableJoinColumns
public java.util.List<Column> getSecondaryTableJoinColumns(DBIdentifier tableName)
-
addSecondaryTable
@Deprecated public void addSecondaryTable(java.lang.String second)
Deprecated.Adds a Secondary table of given name to this mapping. A secondary table must be known before unique constraints are added to a Secondary table.
-
addSecondaryTable
public void addSecondaryTable(DBIdentifier second)
-
setSecondaryTableJoinColumns
@Deprecated public void setSecondaryTableJoinColumns(java.lang.String tableName, java.util.List<Column> cols)
Deprecated.Declare the given class-level join to the named (secondary) table.
-
setSecondaryTableJoinColumns
public void setSecondaryTableJoinColumns(DBIdentifier tableName, java.util.List<Column> cols)
-
getTable
@Deprecated public Table getTable(ClassMapping cls, java.lang.String tableName, boolean adapt)
Deprecated.Return the named table for the given class.
-
getTable
public Table getTable(ClassMapping cls, DBIdentifier tableName, boolean adapt)
Return the named table for the given class.
-
getTable
public Table getTable(ClassMapping cls, boolean adapt)
Return the primary table for the given class.
-
getDataStoreIdColumns
public Column[] getDataStoreIdColumns(ClassMapping cls, Column[] tmplates, Table table, boolean adapt)
Return the datastore identity columns for the given class, based on the given templates.
-
getSuperclassJoin
public ForeignKey getSuperclassJoin(ClassMapping cls, Table table, boolean adapt)
Return the join from this class to its superclass. The table for this class must be set.
-
syncWith
public void syncWith(ClassMapping cls)
Synchronize internal information with the mapping data for the given class.
-
hasSchemaComponents
public boolean hasSchemaComponents()
Description copied from class:MappingInfo
Return true if this info has columns, foreign key information, index information, etc.- Overrides:
hasSchemaComponents
in classMappingInfo
-
clear
protected void clear(boolean canFlags)
Description copied from class:MappingInfo
Clear mapping information.- Overrides:
clear
in classMappingInfo
- Parameters:
canFlags
- whether to clear information about whether we can place indexed, foreign keys, etc on this mapping
-
copy
public void copy(MappingInfo info)
Description copied from class:MappingInfo
Copy missing info from the instance to this one.- Overrides:
copy
in classMappingInfo
-
addUnique
@Deprecated public void addUnique(java.lang.String table, Unique unique)
Deprecated.Add a unique constraint for the given table.- Parameters:
table
- must be primary table or secondary table name added a priori to this receiver.unique
- the unique constraint. null means no-op.
-
addUnique
public void addUnique(DBIdentifier table, Unique unique)
Add a unique constraint for the given table.- Parameters:
table
- must be primary table or secondary table name added a priori to this receiver.unique
- the unique constraint. null means no-op.
-
addIndex
public void addIndex(DBIdentifier table, Index idx)
Add index for the given table.- Parameters:
table
- must be primary table or secondary table name added a priori to this receiver.idx
- the index. null means no-op.
-
getUniques
@Deprecated public Unique[] getUniques(java.lang.String table)
Deprecated.Get the unique constraints of the given primary or secondary table.
-
getUniques
public Unique[] getUniques(DBIdentifier table)
Get the unique constraints of the given primary or secondary table.
-
getUniques
public Unique[] getUniques(MetaDataContext cm, boolean adapt)
Get all the unique constraints associated with both the primary and/or secondary tables.
-
getIndices
public Index[] getIndices(MetaDataContext cm, boolean adapt)
Get all indices associated with both the primary and/or secondary tables.
-
getSourceFile
public java.io.File getSourceFile()
Description copied from interface:SourceTracker
Return the file from which this instance was parsed.- Specified by:
getSourceFile
in interfaceSourceTracker
-
getSourceScope
public java.lang.Object getSourceScope()
Description copied from interface:SourceTracker
Return the domain-dependent scope of this instance within its file.- Specified by:
getSourceScope
in interfaceSourceTracker
-
getSourceType
public int getSourceType()
Description copied from interface:SourceTracker
Return the type of source.- Specified by:
getSourceType
in interfaceSourceTracker
-
setSource
public void setSource(java.io.File file, int srcType)
-
getResourceName
public java.lang.String getResourceName()
Description copied from interface:SourceTracker
Return the domain-meaningful name of the resource that was loaded from this source. I.e., if we had loaded the source for a Java class, this would return the name of the class.- Specified by:
getResourceName
in interfaceSourceTracker
-
getComments
public java.lang.String[] getComments()
Description copied from interface:Commentable
Return comments, or empty array if none.- Specified by:
getComments
in interfaceCommentable
-
setComments
public void setComments(java.lang.String[] comments)
Description copied from interface:Commentable
Set comments.- Specified by:
setComments
in interfaceCommentable
-
getLineNumber
public int getLineNumber()
Description copied from interface:SourceTracker
Return the line number of the file at which this instance was parsed.- Specified by:
getLineNumber
in interfaceSourceTracker
-
setLineNumber
public void setLineNumber(int lineNum)
-
getColNumber
public int getColNumber()
Description copied from interface:SourceTracker
Return the column number in the line of the file at which this instance was parsed.- Specified by:
getColNumber
in interfaceSourceTracker
-
setColNumber
public void setColNumber(int colNum)
-
-