Interface JDBCFetchPlan
-
- All Superinterfaces:
FetchPlan
- All Known Implementing Classes:
JDBCFetchPlanImpl
public interface JDBCFetchPlan extends FetchPlan
JDBC extensions to the fetch plan.- Since:
- 0.4.1
- Author:
- Abe White, Pinaki Poddar
-
-
Field Summary
Fields Modifier and Type Field Description static intEAGER_JOINDeprecated.use theFetchModeenum instead.static intEAGER_NONEDeprecated.use theFetchModeenum instead.static intEAGER_PARALLELDeprecated.use theFetchModeenum instead.static intSIZE_LASTDeprecated.use theLRSSizeAlgorithmenum instead.static intSIZE_QUERYDeprecated.use theLRSSizeAlgorithmenum instead.static intSIZE_UNKNOWNDeprecated.use theLRSSizeAlgorithmenum instead.static intSYNTAX_DATABASEDeprecated.use theJoinSyntaxenum instead.static intSYNTAX_SQL92Deprecated.use theJoinSyntaxenum instead.static intSYNTAX_TRADITIONALDeprecated.use theJoinSyntaxenum instead.-
Fields inherited from interface org.apache.openjpa.persistence.FetchPlan
DEFAULT, DEPTH_INFINITE, GROUP_ALL, GROUP_DEFAULT
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description JDBCFetchPlanaddFetchGroup(java.lang.String group)Addsgroupto the set of fetch group to use when loading objects.JDBCFetchPlanaddFetchGroups(java.lang.String... groups)Addsgroupsto the set of fetch group names to use when loading objects.JDBCFetchPlanaddFetchGroups(java.util.Collection groups)Addsgroupsto the set of fetch group names to use when loading objects.JDBCFetchPlanaddField(java.lang.Class cls, java.lang.String field)Addsfieldto the set of field names to use when loading objects.JDBCFetchPlanaddField(java.lang.String field)Addsfieldto the set of fully-qualified field names to use when loading objects.JDBCFetchPlanaddFields(java.lang.Class cls, java.lang.String... fields)Addsfieldsto the set of field names to use when loading objects.JDBCFetchPlanaddFields(java.lang.Class cls, java.util.Collection fields)Addsfieldsto the set of field names to use when loading objects.JDBCFetchPlanaddFields(java.lang.String... fields)Addsfieldsto the set of fully-qualified field names to use when loading objects.JDBCFetchPlanaddFields(java.util.Collection fields)Addsfieldsto the set of fully-qualified field names to use when loading objects.JDBCFetchPlanclearFetchGroups()Clears the set of fetch group names to use wen loading data.JDBCFetchPlanclearFields()Clears the set of field names to use wen loading data.FetchModegetEagerFetchMode()Eager fetch mode in loading relations.FetchDirectiongetFetchDirection()Result set fetch direction.booleangetIgnoreDfgForFkSelect()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.IsolationLevelgetIsolation()The isolation level for queries issued to the database.JoinSyntaxgetJoinSyntax()SQL join syntax.intgetLRSSize()Deprecated.usegetLRSSizeAlgorithm()instead.LRSSizeAlgorithmgetLRSSizeAlgorithm()How to determine the size of a large result set.ResultSetTypegetResultSetType()Type of JDBC result set to use for query results.FetchModegetSubclassFetchMode()Eager fetch mode in loading subclasses.JDBCFetchPlanremoveFetchGroup(java.lang.String group)Remove the given fetch group.JDBCFetchPlanremoveFetchGroups(java.lang.String... groups)Removesgroupsfrom the set of fetch group names to use when loading objects.JDBCFetchPlanremoveFetchGroups(java.util.Collection groups)Removesgroupsfrom the set of fetch group names to use when loading objects.JDBCFetchPlanremoveField(java.lang.Class cls, java.lang.String field)Remove the given field.JDBCFetchPlanremoveField(java.lang.String field)Remove the given fully-qualified field.JDBCFetchPlanremoveFields(java.lang.Class cls, java.lang.String... fields)Removesfieldsfrom the set of field names to use when loading objects.JDBCFetchPlanremoveFields(java.lang.Class cls, java.util.Collection fields)Removesfieldsfrom the set of field names to use when loading objects.JDBCFetchPlanremoveFields(java.lang.String... fields)Removesfieldsfrom the set of fully-qualified field names to use when loading objects.JDBCFetchPlanremoveFields(java.util.Collection fields)Removesfieldsfrom the set of fully-qualified field names to use when loading objects.JDBCFetchPlanresetFetchGroups()Resets the set of fetch groups to the list in the global configuration.JDBCFetchPlansetEagerFetchMode(int mode)Deprecated.usesetEagerFetchMode(FetchMode)instead.JDBCFetchPlansetEagerFetchMode(FetchMode mode)Eager fetch mode in loading relations.JDBCFetchPlansetFetchBatchSize(int fetchBatchSize)Set the fetch batch size for large result set support.JDBCFetchPlansetFetchDirection(int direction)Deprecated.usesetFetchDirection(FetchDirection)instead.JDBCFetchPlansetFetchDirection(FetchDirection direction)Result set fetch direction.voidsetIgnoreDfgForFkSelect(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.JDBCFetchPlansetIsolation(IsolationLevel level)The isolation level for queries issued to the database.JDBCFetchPlansetJoinSyntax(int syntax)Deprecated.usesetJoinSyntax(JoinSyntax)instead.JDBCFetchPlansetJoinSyntax(JoinSyntax syntax)SQL join syntax.JDBCFetchPlansetLockTimeout(int timeout)The number of milliseconds to wait for an object lock, or -1 for no limit.JDBCFetchPlansetLRSSize(int lrsSizeMode)Deprecated.usesetLRSSizeAlgorithm(LRSSizeAlgorithm)instead.JDBCFetchPlansetLRSSizeAlgorithm(LRSSizeAlgorithm lrsSizeAlgorithm)How to determine the size of a large result set.JDBCFetchPlansetMaxFetchDepth(int depth)The maximum fetch depth when loading an object.JDBCFetchPlansetQueryResultCacheEnabled(boolean cache)Control whether or not query caching is enabled.JDBCFetchPlansetQueryTimeout(int timeout)The number of milliseconds to wait for a query, or -1 for no limit.JDBCFetchPlansetReadLockMode(jakarta.persistence.LockModeType mode)The lock level to use for locking loaded objects.JDBCFetchPlansetResultSetType(int mode)Deprecated.usesetResultSetType(ResultSetType)instead.JDBCFetchPlansetResultSetType(ResultSetType type)Type of JDBC result set to use for query results.JDBCFetchPlansetSubclassFetchMode(int mode)Deprecated.usesetSubclassFetchMode(FetchMode)instead.JDBCFetchPlansetSubclassFetchMode(FetchMode mode)Eager fetch mode in loading subclasses.JDBCFetchPlansetWriteLockMode(jakarta.persistence.LockModeType mode)The lock level to use for locking dirtied objects.-
Methods inherited from interface org.apache.openjpa.persistence.FetchPlan
getCacheRetrieveMode, getCacheStoreMode, getDelegate, getExtendedPathLookup, getFetchBatchSize, getFetchGroups, getFields, getHint, getHints, getLockScope, getLockTimeout, getMaxFetchDepth, getQueryResultCache, getQueryResultCacheEnabled, getQueryTimeout, getReadLockMode, getWriteLockMode, hasField, hasField, setCacheRetrieveMode, setCacheStoreMode, setExtendedPathLookup, setHint, setLockScope, setQueryResultCache
-
-
-
-
Field Detail
-
EAGER_NONE
@Deprecated static final int EAGER_NONE
Deprecated.use theFetchModeenum instead.- See Also:
- Constant Field Values
-
EAGER_JOIN
@Deprecated static final int EAGER_JOIN
Deprecated.use theFetchModeenum instead.- See Also:
- Constant Field Values
-
EAGER_PARALLEL
@Deprecated static final int EAGER_PARALLEL
Deprecated.use theFetchModeenum instead.- See Also:
- Constant Field Values
-
SIZE_UNKNOWN
@Deprecated static final int SIZE_UNKNOWN
Deprecated.use theLRSSizeAlgorithmenum instead.- See Also:
- Constant Field Values
-
SIZE_LAST
@Deprecated static final int SIZE_LAST
Deprecated.use theLRSSizeAlgorithmenum instead.- See Also:
- Constant Field Values
-
SIZE_QUERY
@Deprecated static final int SIZE_QUERY
Deprecated.use theLRSSizeAlgorithmenum instead.- See Also:
- Constant Field Values
-
SYNTAX_SQL92
@Deprecated static final int SYNTAX_SQL92
Deprecated.use theJoinSyntaxenum instead.- See Also:
- Constant Field Values
-
SYNTAX_TRADITIONAL
@Deprecated static final int SYNTAX_TRADITIONAL
Deprecated.use theJoinSyntaxenum instead.- See Also:
- Constant Field Values
-
SYNTAX_DATABASE
@Deprecated static final int SYNTAX_DATABASE
Deprecated.use theJoinSyntaxenum instead.- See Also:
- Constant Field Values
-
-
Method Detail
-
getEagerFetchMode
FetchMode getEagerFetchMode()
Eager fetch mode in loading relations.
-
setEagerFetchMode
JDBCFetchPlan setEagerFetchMode(FetchMode mode)
Eager fetch mode in loading relations.
-
getSubclassFetchMode
FetchMode getSubclassFetchMode()
Eager fetch mode in loading subclasses.
-
setSubclassFetchMode
JDBCFetchPlan setSubclassFetchMode(FetchMode mode)
Eager fetch mode in loading subclasses.
-
getResultSetType
ResultSetType getResultSetType()
Type of JDBC result set to use for query results.
-
setResultSetType
JDBCFetchPlan setResultSetType(ResultSetType type)
Type of JDBC result set to use for query results.
-
getFetchDirection
FetchDirection getFetchDirection()
Result set fetch direction.
-
setFetchDirection
JDBCFetchPlan setFetchDirection(FetchDirection direction)
Result set fetch direction.
-
getLRSSizeAlgorithm
LRSSizeAlgorithm getLRSSizeAlgorithm()
How to determine the size of a large result set.
-
setLRSSizeAlgorithm
JDBCFetchPlan setLRSSizeAlgorithm(LRSSizeAlgorithm lrsSizeAlgorithm)
How to determine the size of a large result set.
-
getJoinSyntax
JoinSyntax getJoinSyntax()
SQL join syntax.
-
setJoinSyntax
JDBCFetchPlan setJoinSyntax(JoinSyntax syntax)
SQL join syntax.
-
getIsolation
IsolationLevel getIsolation()
The isolation level for queries issued to the database. This overrides the persistence-unit-wideopenjpa.jdbc.TransactionIsolationvalue.- Since:
- 0.9.7
-
setIsolation
JDBCFetchPlan setIsolation(IsolationLevel level)
The isolation level for queries issued to the database. This overrides the persistence-unit-wideopenjpa.jdbc.TransactionIsolationvalue.- Since:
- 0.9.7
-
addFetchGroup
JDBCFetchPlan addFetchGroup(java.lang.String group)
Description copied from interface:FetchPlanAddsgroupto the set of fetch group to use when loading objects.- Specified by:
addFetchGroupin interfaceFetchPlan
-
addFetchGroups
JDBCFetchPlan addFetchGroups(java.util.Collection groups)
Description copied from interface:FetchPlanAddsgroupsto the set of fetch group names to use when loading objects.- Specified by:
addFetchGroupsin interfaceFetchPlan
-
addFetchGroups
JDBCFetchPlan addFetchGroups(java.lang.String... groups)
Description copied from interface:FetchPlanAddsgroupsto the set of fetch group names to use when loading objects.- Specified by:
addFetchGroupsin interfaceFetchPlan
-
addField
JDBCFetchPlan addField(java.lang.Class cls, java.lang.String field)
Description copied from interface:FetchPlanAddsfieldto the set of field names to use when loading objects.
-
addField
JDBCFetchPlan addField(java.lang.String field)
Description copied from interface:FetchPlanAddsfieldto the set of fully-qualified field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.lang.Class cls, java.util.Collection fields)
Description copied from interface:FetchPlanAddsfieldsto the set of field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.lang.Class cls, java.lang.String... fields)
Description copied from interface:FetchPlanAddsfieldsto the set of field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.util.Collection fields)
Description copied from interface:FetchPlanAddsfieldsto the set of fully-qualified field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.lang.String... fields)
Description copied from interface:FetchPlanAddsfieldsto the set of fully-qualified field names to use when loading objects.
-
clearFetchGroups
JDBCFetchPlan clearFetchGroups()
Description copied from interface:FetchPlanClears the set of fetch group names to use wen loading data. After this operation is invoked, only those fields in the default fetch group (and any requested field) will be loaded when loading an object.- Specified by:
clearFetchGroupsin interfaceFetchPlan
-
clearFields
JDBCFetchPlan clearFields()
Description copied from interface:FetchPlanClears the set of field names to use wen loading data. After this operation is invoked, only those fields in the configured fetch groups will be loaded when loading an object.- Specified by:
clearFieldsin interfaceFetchPlan
-
removeFetchGroup
JDBCFetchPlan removeFetchGroup(java.lang.String group)
Description copied from interface:FetchPlanRemove the given fetch group.- Specified by:
removeFetchGroupin interfaceFetchPlan
-
removeFetchGroups
JDBCFetchPlan removeFetchGroups(java.util.Collection groups)
Description copied from interface:FetchPlanRemovesgroupsfrom the set of fetch group names to use when loading objects.- Specified by:
removeFetchGroupsin interfaceFetchPlan
-
removeFetchGroups
JDBCFetchPlan removeFetchGroups(java.lang.String... groups)
Description copied from interface:FetchPlanRemovesgroupsfrom the set of fetch group names to use when loading objects.- Specified by:
removeFetchGroupsin interfaceFetchPlan
-
removeField
JDBCFetchPlan removeField(java.lang.Class cls, java.lang.String field)
Description copied from interface:FetchPlanRemove the given field.- Specified by:
removeFieldin interfaceFetchPlan
-
removeField
JDBCFetchPlan removeField(java.lang.String field)
Description copied from interface:FetchPlanRemove the given fully-qualified field.- Specified by:
removeFieldin interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.Class cls, java.util.Collection fields)
Description copied from interface:FetchPlanRemovesfieldsfrom the set of field names to use when loading objects.- Specified by:
removeFieldsin interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.Class cls, java.lang.String... fields)
Description copied from interface:FetchPlanRemovesfieldsfrom the set of field names to use when loading objects.- Specified by:
removeFieldsin interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.String... fields)
Description copied from interface:FetchPlanRemovesfieldsfrom the set of fully-qualified field names to use when loading objects.- Specified by:
removeFieldsin interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.util.Collection fields)
Description copied from interface:FetchPlanRemovesfieldsfrom the set of fully-qualified field names to use when loading objects.- Specified by:
removeFieldsin interfaceFetchPlan
-
resetFetchGroups
JDBCFetchPlan resetFetchGroups()
Description copied from interface:FetchPlanResets the set of fetch groups to the list in the global configuration.- Specified by:
resetFetchGroupsin interfaceFetchPlan
-
setQueryResultCacheEnabled
JDBCFetchPlan setQueryResultCacheEnabled(boolean cache)
Description copied from interface:FetchPlanControl whether or not query caching is enabled. This has no effect if the datacache plugin is not installed, or if the query cache size is set to zero.- Specified by:
setQueryResultCacheEnabledin interfaceFetchPlan
-
setFetchBatchSize
JDBCFetchPlan setFetchBatchSize(int fetchBatchSize)
Description copied from interface:FetchPlanSet the fetch batch size for large result set support. Defaults to theopenjpa.FetchBatchSizesetting. Note that this property will be ignored under some data stores.- Specified by:
setFetchBatchSizein interfaceFetchPlan
-
setLockTimeout
JDBCFetchPlan setLockTimeout(int timeout)
Description copied from interface:FetchPlanThe number of milliseconds to wait for an object lock, or -1 for no limit.- Specified by:
setLockTimeoutin interfaceFetchPlan
-
setMaxFetchDepth
JDBCFetchPlan setMaxFetchDepth(int depth)
Description copied from interface:FetchPlanThe maximum fetch depth when loading an object.- Specified by:
setMaxFetchDepthin interfaceFetchPlan
-
setReadLockMode
JDBCFetchPlan setReadLockMode(jakarta.persistence.LockModeType mode)
Description copied from interface:FetchPlanThe lock level to use for locking loaded objects.- Specified by:
setReadLockModein interfaceFetchPlan
-
setWriteLockMode
JDBCFetchPlan setWriteLockMode(jakarta.persistence.LockModeType mode)
Description copied from interface:FetchPlanThe lock level to use for locking dirtied objects.- Specified by:
setWriteLockModein interfaceFetchPlan
-
setQueryTimeout
JDBCFetchPlan setQueryTimeout(int timeout)
Description copied from interface:FetchPlanThe number of milliseconds to wait for a query, or -1 for no limit.- Specified by:
setQueryTimeoutin interfaceFetchPlan
-
setEagerFetchMode
@Deprecated JDBCFetchPlan setEagerFetchMode(int mode)
Deprecated.usesetEagerFetchMode(FetchMode)instead.
-
setSubclassFetchMode
@Deprecated JDBCFetchPlan setSubclassFetchMode(int mode)
Deprecated.usesetSubclassFetchMode(FetchMode)instead.
-
setResultSetType
@Deprecated JDBCFetchPlan setResultSetType(int mode)
Deprecated.usesetResultSetType(ResultSetType)instead.
-
setFetchDirection
@Deprecated JDBCFetchPlan setFetchDirection(int direction)
Deprecated.usesetFetchDirection(FetchDirection)instead.
-
getLRSSize
@Deprecated int getLRSSize()
Deprecated.usegetLRSSizeAlgorithm()instead.
-
setLRSSize
@Deprecated JDBCFetchPlan setLRSSize(int lrsSizeMode)
Deprecated.usesetLRSSizeAlgorithm(LRSSizeAlgorithm)instead.
-
setJoinSyntax
@Deprecated JDBCFetchPlan setJoinSyntax(int syntax)
Deprecated.usesetJoinSyntax(JoinSyntax)instead.
-
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
-
-