Interface JDBCFetchConfiguration
-
- All Superinterfaces:
java.lang.Cloneable
,EagerFetchModes
,FetchConfiguration
,JoinSyntaxes
,LockLevels
,LockScopes
,LRSSizes
,QueryFlushModes
,java.io.Serializable
- All Known Implementing Classes:
DelegatingJDBCFetchConfiguration
,JDBCFetchConfigurationImpl
,TargetFetchConfiguration
public interface JDBCFetchConfiguration extends FetchConfiguration, EagerFetchModes, LRSSizes, JoinSyntaxes
JDBC extensions to OpenJPA'sFetchConfiguration
.- Since:
- 0.3.0
- Author:
- Abe White
-
-
Field Summary
-
Fields inherited from interface org.apache.openjpa.jdbc.kernel.EagerFetchModes
EAGER_JOIN, EAGER_NONE, EAGER_PARALLEL
-
Fields inherited from interface org.apache.openjpa.kernel.FetchConfiguration
DEFAULT, FETCH_LOAD, FETCH_NONE, FETCH_REF
-
Fields inherited from interface org.apache.openjpa.jdbc.sql.JoinSyntaxes
SYNTAX_DATABASE, SYNTAX_SQL92, SYNTAX_TRADITIONAL
-
Fields inherited from interface org.apache.openjpa.kernel.LockLevels
LOCK_NONE, LOCK_READ, LOCK_WRITE
-
Fields inherited from interface org.apache.openjpa.kernel.LockScopes
LOCKSCOPE_EXTENDED, LOCKSCOPE_NORMAL
-
Fields inherited from interface org.apache.openjpa.jdbc.kernel.LRSSizes
SIZE_LAST, SIZE_QUERY, SIZE_UNKNOWN
-
Fields inherited from interface org.apache.openjpa.kernel.QueryFlushModes
FLUSH_FALSE, FLUSH_TRUE, FLUSH_WITH_CONNECTION
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description JDBCFetchConfiguration
addFetchInnerJoin(java.lang.String field)
Addsfield
to the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
addFetchInnerJoins(java.util.Collection<java.lang.String> fields)
Addsfields
to the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
addJoin(java.lang.String field)
Addsfield
to the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
addJoins(java.util.Collection<java.lang.String> fields)
Addsfields
to the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
clearJoins()
Clears the set of field names to join when loading data.int
getEagerFetchMode()
Return the eager fetch mode.int
getFetchDirection()
The fetch direction to use as a constant fromResultSet
.java.util.Set<java.lang.String>
getFetchInnerJoins()
Returns the names of the inner fetch joins that this component will use when loading objects.boolean
getIgnoreDfgForFkSelect()
Affirms if foreign key for a relation field will be pre-fetched as part of the owning object irrespective of whether the field is included in the default fetch group of this fetch configuration.int
getIsolation()
The isolation level for queries issued to the database.java.util.Set<java.lang.String>
getJoins()
Returns the names of the joins that this component will use when loading objects.int
getJoinSyntax()
The join syntax to use.int
getLRSSize()
The large result set size mode to use.int
getResultSetType()
The result set type to use as a constant fromResultSet
.int
getSubclassFetchMode()
Return the subclass fetch mode.int
getSubclassFetchMode(ClassMapping cls)
Return the effective subclass fetch mode for the given type.boolean
hasFetchInnerJoin(java.lang.String field)
Return true if the given fully-qualified inner fetch join has been added.boolean
hasJoin(java.lang.String field)
Return true if the given fully-qualified join has been added.JDBCFetchConfiguration
removeJoin(java.lang.String field)
Removesfield
to the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
removeJoins(java.util.Collection<java.lang.String> fields)
Removesfields
from the set of fully-qualified field names to eagerly join when loading objects.JDBCFetchConfiguration
setEagerFetchMode(int mode)
Set the eager fetch mode.JDBCFetchConfiguration
setFetchDirection(int direction)
The fetch direction to use as a constant fromResultSet
.void
setIgnoreDfgForFkSelect(boolean b)
Affirms if foreign key for a relation field will be pre-fetched as part of the owning object irrespective of whether the field is included in the default fetch group of this fetch configuration.JDBCFetchConfiguration
setIsolation(int level)
The isolation level for queries issued to the database.JDBCFetchConfiguration
setJoinSyntax(int syntax)
The join syntax to use.JDBCFetchConfiguration
setLRSSize(int lrsSize)
The large result set size mode to use.JDBCFetchConfiguration
setResultSetType(int type)
The result set type to use as a constant fromResultSet
.JDBCFetchConfiguration
setSubclassFetchMode(int mode)
Set the subclass fetch mode.JDBCFetchConfiguration
traverseJDBC(FieldMetaData fm)
Convenience method to cast traversal to store-specific type.-
Methods inherited from interface org.apache.openjpa.kernel.FetchConfiguration
addFetchGroup, addFetchGroups, addField, addFields, clearFetchGroups, clearFields, clone, copy, getCacheRetrieveMode, getCacheStoreMode, getContext, getExtendedPathLookup, getFetchBatchSize, getFetchGroups, getFields, getFlushBeforeQueries, getHint, getHints, getLockScope, getLockTimeout, getMaxFetchDepth, getQueryCacheEnabled, getQueryTimeout, getReadLockLevel, getRootClasses, getRootInstances, getWriteLockLevel, hasFetchGroup, hasField, isDefaultPUFetchGroupConfigurationOnly, isFetchConfigurationSQLCacheAdmissible, isHintSet, lock, newResultList, removeFetchGroup, removeFetchGroups, removeField, removeFields, requiresFetch, requiresLoad, resetFetchGroups, setCacheRetrieveMode, setCacheStoreMode, setContext, setExtendedPathLookup, setFetchBatchSize, setFlushBeforeQueries, setHint, setHint, setLockScope, setLockTimeout, setMaxFetchDepth, setQueryCacheEnabled, setQueryTimeout, setReadLockLevel, setRootClasses, setRootInstances, setWriteLockLevel, traverse, unlock
-
-
-
-
Method Detail
-
getEagerFetchMode
int getEagerFetchMode()
Return the eager fetch mode. Defaults to theopenjpa.jdbc.EagerFetchMode
setting.
-
setEagerFetchMode
JDBCFetchConfiguration setEagerFetchMode(int mode)
Set the eager fetch mode. Defaults to theopenjpa.jdbc.EagerFetchMode
setting.
-
getSubclassFetchMode
int getSubclassFetchMode()
Return the subclass fetch mode. Defaults to theopenjpa.jdbc.SubclassFetchMode
setting.
-
getSubclassFetchMode
int getSubclassFetchMode(ClassMapping cls)
Return the effective subclass fetch mode for the given type.
-
setSubclassFetchMode
JDBCFetchConfiguration setSubclassFetchMode(int mode)
Set the subclass fetch mode. Defaults to theopenjpa.jdbc.SubclassFetchMode
setting.
-
getResultSetType
int getResultSetType()
The result set type to use as a constant fromResultSet
. Defaults to theopenjpa.jdbc.ResultSetType
setting.
-
setResultSetType
JDBCFetchConfiguration setResultSetType(int type)
The result set type to use as a constant fromResultSet
. Defaults to theopenjpa.jdbc.ResultSetType
setting.
-
getFetchDirection
int getFetchDirection()
The fetch direction to use as a constant fromResultSet
. Defaults to theopenjpa.jdbc.FetchDirection
setting.
-
setFetchDirection
JDBCFetchConfiguration setFetchDirection(int direction)
The fetch direction to use as a constant fromResultSet
. Defaults to theopenjpa.jdbc.FetchDirection
setting.
-
getLRSSize
int getLRSSize()
The large result set size mode to use. Defaults to theopenjpa.jdbc.LRSSize
setting.
-
setLRSSize
JDBCFetchConfiguration setLRSSize(int lrsSize)
The large result set size mode to use. Defaults to theopenjpa.jdbc.LRSSize
setting.
-
getJoinSyntax
int getJoinSyntax()
The join syntax to use.
-
setJoinSyntax
JDBCFetchConfiguration setJoinSyntax(int syntax)
The join syntax to use.
-
getJoins
java.util.Set<java.lang.String> getJoins()
Returns the names of the joins that this component will use when loading objects. Defaults to the empty set. This set is not thread safe.- Since:
- 0.4.0.0
-
hasJoin
boolean hasJoin(java.lang.String field)
Return true if the given fully-qualified join has been added.- Since:
- 0.4.0.0
-
addJoin
JDBCFetchConfiguration addJoin(java.lang.String field)
Addsfield
to the set of fully-qualified field names to eagerly join when loading objects. Each class can have at most one to-many eagerly joined fields.- Since:
- 0.4.0.0
-
addJoins
JDBCFetchConfiguration addJoins(java.util.Collection<java.lang.String> fields)
Addsfields
to the set of fully-qualified field names to eagerly join when loading objects. Each class can have at most one to-many eagerly joined fields.- Since:
- 0.4.0.0
-
removeJoin
JDBCFetchConfiguration removeJoin(java.lang.String field)
Removesfield
to the set of fully-qualified field names to eagerly join when loading objects.- Since:
- 0.4.0.0
-
removeJoins
JDBCFetchConfiguration removeJoins(java.util.Collection<java.lang.String> fields)
Removesfields
from the set of fully-qualified field names to eagerly join when loading objects.- Since:
- 0.4.0.0
-
clearJoins
JDBCFetchConfiguration clearJoins()
Clears the set of field names to join when loading data.- Since:
- 0.4.0.0
-
getIsolation
int getIsolation()
The isolation level for queries issued to the database. This overrides the persistence-unit-wide
openjpa.jdbc.TransactionIsolation
value.Must be one of
Connection.TRANSACTION_NONE
,Connection.TRANSACTION_READ_UNCOMMITTED
,Connection.TRANSACTION_READ_COMMITTED
,Connection.TRANSACTION_REPEATABLE_READ
,Connection.TRANSACTION_SERIALIZABLE
, or -1 for the default connection level specified by the context in which this fetch configuration is being used.- Since:
- 0.9.7
-
setIsolation
JDBCFetchConfiguration setIsolation(int level)
The isolation level for queries issued to the database. This overrides the persistence-unit-wide
openjpa.jdbc.TransactionIsolation
value.Must be one of
Connection.TRANSACTION_NONE
,Connection.TRANSACTION_READ_UNCOMMITTED
,Connection.TRANSACTION_READ_COMMITTED
,Connection.TRANSACTION_REPEATABLE_READ
,Connection.TRANSACTION_SERIALIZABLE
, or -1 for the default connection level specified by the context in which this fetch configuration is being used.- Since:
- 0.9.7
-
traverseJDBC
JDBCFetchConfiguration traverseJDBC(FieldMetaData fm)
Convenience method to cast traversal to store-specific type.
-
getFetchInnerJoins
java.util.Set<java.lang.String> getFetchInnerJoins()
Returns the names of the inner fetch joins that this component will use when loading objects. Defaults to the empty set. This set is not thread safe.- Since:
- 1.0.3
-
hasFetchInnerJoin
boolean hasFetchInnerJoin(java.lang.String field)
Return true if the given fully-qualified inner fetch join has been added.- Since:
- 1.0.3
-
addFetchInnerJoin
JDBCFetchConfiguration addFetchInnerJoin(java.lang.String field)
Addsfield
to the set of fully-qualified field names to eagerly join when loading objects. Each class can have at most one to-many eagerly joined fields.- Since:
- 1.0.3
-
addFetchInnerJoins
JDBCFetchConfiguration addFetchInnerJoins(java.util.Collection<java.lang.String> fields)
Addsfields
to the set of fully-qualified field names to eagerly join when loading objects. Each class can have at most one to-many eagerly joined fields.- Since:
- 1.0.3
-
getIgnoreDfgForFkSelect
boolean getIgnoreDfgForFkSelect()
Affirms if foreign key for a relation field will be pre-fetched as part of the owning object irrespective of whether the field is included in the default fetch group of this fetch configuration.
By default, foreign key for a relation field is pre-fetched as part of the owning object only if the field in included in the default fetch group of this fetch configuration.- Since:
- 2.2.0
-
setIgnoreDfgForFkSelect
void setIgnoreDfgForFkSelect(boolean b)
Affirms if foreign key for a relation field will be pre-fetched as part of the owning object irrespective of whether the field is included in the default fetch group of this fetch configuration.
By default, foreign key for a relation field is pre-fetched as part of the owning object only if the field in included in the default fetch group of this fetch configuration.- Since:
- 2.2.0
-
-