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 int
EAGER_JOIN
Deprecated.use theFetchMode
enum instead.static int
EAGER_NONE
Deprecated.use theFetchMode
enum instead.static int
EAGER_PARALLEL
Deprecated.use theFetchMode
enum instead.static int
SIZE_LAST
Deprecated.use theLRSSizeAlgorithm
enum instead.static int
SIZE_QUERY
Deprecated.use theLRSSizeAlgorithm
enum instead.static int
SIZE_UNKNOWN
Deprecated.use theLRSSizeAlgorithm
enum instead.static int
SYNTAX_DATABASE
Deprecated.use theJoinSyntax
enum instead.static int
SYNTAX_SQL92
Deprecated.use theJoinSyntax
enum instead.static int
SYNTAX_TRADITIONAL
Deprecated.use theJoinSyntax
enum 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 JDBCFetchPlan
addFetchGroup(java.lang.String group)
Addsgroup
to the set of fetch group to use when loading objects.JDBCFetchPlan
addFetchGroups(java.lang.String... groups)
Addsgroups
to the set of fetch group names to use when loading objects.JDBCFetchPlan
addFetchGroups(java.util.Collection groups)
Addsgroups
to the set of fetch group names to use when loading objects.JDBCFetchPlan
addField(java.lang.Class cls, java.lang.String field)
Addsfield
to the set of field names to use when loading objects.JDBCFetchPlan
addField(java.lang.String field)
Addsfield
to the set of fully-qualified field names to use when loading objects.JDBCFetchPlan
addFields(java.lang.Class cls, java.lang.String... fields)
Addsfields
to the set of field names to use when loading objects.JDBCFetchPlan
addFields(java.lang.Class cls, java.util.Collection fields)
Addsfields
to the set of field names to use when loading objects.JDBCFetchPlan
addFields(java.lang.String... fields)
Addsfields
to the set of fully-qualified field names to use when loading objects.JDBCFetchPlan
addFields(java.util.Collection fields)
Addsfields
to the set of fully-qualified field names to use when loading objects.JDBCFetchPlan
clearFetchGroups()
Clears the set of fetch group names to use wen loading data.JDBCFetchPlan
clearFields()
Clears the set of field names to use wen loading data.FetchMode
getEagerFetchMode()
Eager fetch mode in loading relations.FetchDirection
getFetchDirection()
Result set fetch direction.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.IsolationLevel
getIsolation()
The isolation level for queries issued to the database.JoinSyntax
getJoinSyntax()
SQL join syntax.int
getLRSSize()
Deprecated.usegetLRSSizeAlgorithm()
instead.LRSSizeAlgorithm
getLRSSizeAlgorithm()
How to determine the size of a large result set.ResultSetType
getResultSetType()
Type of JDBC result set to use for query results.FetchMode
getSubclassFetchMode()
Eager fetch mode in loading subclasses.JDBCFetchPlan
removeFetchGroup(java.lang.String group)
Remove the given fetch group.JDBCFetchPlan
removeFetchGroups(java.lang.String... groups)
Removesgroups
from the set of fetch group names to use when loading objects.JDBCFetchPlan
removeFetchGroups(java.util.Collection groups)
Removesgroups
from the set of fetch group names to use when loading objects.JDBCFetchPlan
removeField(java.lang.Class cls, java.lang.String field)
Remove the given field.JDBCFetchPlan
removeField(java.lang.String field)
Remove the given fully-qualified field.JDBCFetchPlan
removeFields(java.lang.Class cls, java.lang.String... fields)
Removesfields
from the set of field names to use when loading objects.JDBCFetchPlan
removeFields(java.lang.Class cls, java.util.Collection fields)
Removesfields
from the set of field names to use when loading objects.JDBCFetchPlan
removeFields(java.lang.String... fields)
Removesfields
from the set of fully-qualified field names to use when loading objects.JDBCFetchPlan
removeFields(java.util.Collection fields)
Removesfields
from the set of fully-qualified field names to use when loading objects.JDBCFetchPlan
resetFetchGroups()
Resets the set of fetch groups to the list in the global configuration.JDBCFetchPlan
setEagerFetchMode(int mode)
Deprecated.usesetEagerFetchMode(FetchMode)
instead.JDBCFetchPlan
setEagerFetchMode(FetchMode mode)
Eager fetch mode in loading relations.JDBCFetchPlan
setFetchBatchSize(int fetchBatchSize)
Set the fetch batch size for large result set support.JDBCFetchPlan
setFetchDirection(int direction)
Deprecated.usesetFetchDirection(FetchDirection)
instead.JDBCFetchPlan
setFetchDirection(FetchDirection direction)
Result set fetch direction.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.JDBCFetchPlan
setIsolation(IsolationLevel level)
The isolation level for queries issued to the database.JDBCFetchPlan
setJoinSyntax(int syntax)
Deprecated.usesetJoinSyntax(JoinSyntax)
instead.JDBCFetchPlan
setJoinSyntax(JoinSyntax syntax)
SQL join syntax.JDBCFetchPlan
setLockTimeout(int timeout)
The number of milliseconds to wait for an object lock, or -1 for no limit.JDBCFetchPlan
setLRSSize(int lrsSizeMode)
Deprecated.usesetLRSSizeAlgorithm(LRSSizeAlgorithm)
instead.JDBCFetchPlan
setLRSSizeAlgorithm(LRSSizeAlgorithm lrsSizeAlgorithm)
How to determine the size of a large result set.JDBCFetchPlan
setMaxFetchDepth(int depth)
The maximum fetch depth when loading an object.JDBCFetchPlan
setQueryResultCacheEnabled(boolean cache)
Control whether or not query caching is enabled.JDBCFetchPlan
setQueryTimeout(int timeout)
The number of milliseconds to wait for a query, or -1 for no limit.JDBCFetchPlan
setReadLockMode(jakarta.persistence.LockModeType mode)
The lock level to use for locking loaded objects.JDBCFetchPlan
setResultSetType(int mode)
Deprecated.usesetResultSetType(ResultSetType)
instead.JDBCFetchPlan
setResultSetType(ResultSetType type)
Type of JDBC result set to use for query results.JDBCFetchPlan
setSubclassFetchMode(int mode)
Deprecated.usesetSubclassFetchMode(FetchMode)
instead.JDBCFetchPlan
setSubclassFetchMode(FetchMode mode)
Eager fetch mode in loading subclasses.JDBCFetchPlan
setWriteLockMode(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 theFetchMode
enum instead.- See Also:
- Constant Field Values
-
EAGER_JOIN
@Deprecated static final int EAGER_JOIN
Deprecated.use theFetchMode
enum instead.- See Also:
- Constant Field Values
-
EAGER_PARALLEL
@Deprecated static final int EAGER_PARALLEL
Deprecated.use theFetchMode
enum instead.- See Also:
- Constant Field Values
-
SIZE_UNKNOWN
@Deprecated static final int SIZE_UNKNOWN
Deprecated.use theLRSSizeAlgorithm
enum instead.- See Also:
- Constant Field Values
-
SIZE_LAST
@Deprecated static final int SIZE_LAST
Deprecated.use theLRSSizeAlgorithm
enum instead.- See Also:
- Constant Field Values
-
SIZE_QUERY
@Deprecated static final int SIZE_QUERY
Deprecated.use theLRSSizeAlgorithm
enum instead.- See Also:
- Constant Field Values
-
SYNTAX_SQL92
@Deprecated static final int SYNTAX_SQL92
Deprecated.use theJoinSyntax
enum instead.- See Also:
- Constant Field Values
-
SYNTAX_TRADITIONAL
@Deprecated static final int SYNTAX_TRADITIONAL
Deprecated.use theJoinSyntax
enum instead.- See Also:
- Constant Field Values
-
SYNTAX_DATABASE
@Deprecated static final int SYNTAX_DATABASE
Deprecated.use theJoinSyntax
enum 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.TransactionIsolation
value.- 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.TransactionIsolation
value.- Since:
- 0.9.7
-
addFetchGroup
JDBCFetchPlan addFetchGroup(java.lang.String group)
Description copied from interface:FetchPlan
Addsgroup
to the set of fetch group to use when loading objects.- Specified by:
addFetchGroup
in interfaceFetchPlan
-
addFetchGroups
JDBCFetchPlan addFetchGroups(java.util.Collection groups)
Description copied from interface:FetchPlan
Addsgroups
to the set of fetch group names to use when loading objects.- Specified by:
addFetchGroups
in interfaceFetchPlan
-
addFetchGroups
JDBCFetchPlan addFetchGroups(java.lang.String... groups)
Description copied from interface:FetchPlan
Addsgroups
to the set of fetch group names to use when loading objects.- Specified by:
addFetchGroups
in interfaceFetchPlan
-
addField
JDBCFetchPlan addField(java.lang.Class cls, java.lang.String field)
Description copied from interface:FetchPlan
Addsfield
to the set of field names to use when loading objects.
-
addField
JDBCFetchPlan addField(java.lang.String field)
Description copied from interface:FetchPlan
Addsfield
to 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:FetchPlan
Addsfields
to 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:FetchPlan
Addsfields
to the set of field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.util.Collection fields)
Description copied from interface:FetchPlan
Addsfields
to the set of fully-qualified field names to use when loading objects.
-
addFields
JDBCFetchPlan addFields(java.lang.String... fields)
Description copied from interface:FetchPlan
Addsfields
to the set of fully-qualified field names to use when loading objects.
-
clearFetchGroups
JDBCFetchPlan clearFetchGroups()
Description copied from interface:FetchPlan
Clears 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:
clearFetchGroups
in interfaceFetchPlan
-
clearFields
JDBCFetchPlan clearFields()
Description copied from interface:FetchPlan
Clears 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:
clearFields
in interfaceFetchPlan
-
removeFetchGroup
JDBCFetchPlan removeFetchGroup(java.lang.String group)
Description copied from interface:FetchPlan
Remove the given fetch group.- Specified by:
removeFetchGroup
in interfaceFetchPlan
-
removeFetchGroups
JDBCFetchPlan removeFetchGroups(java.util.Collection groups)
Description copied from interface:FetchPlan
Removesgroups
from the set of fetch group names to use when loading objects.- Specified by:
removeFetchGroups
in interfaceFetchPlan
-
removeFetchGroups
JDBCFetchPlan removeFetchGroups(java.lang.String... groups)
Description copied from interface:FetchPlan
Removesgroups
from the set of fetch group names to use when loading objects.- Specified by:
removeFetchGroups
in interfaceFetchPlan
-
removeField
JDBCFetchPlan removeField(java.lang.Class cls, java.lang.String field)
Description copied from interface:FetchPlan
Remove the given field.- Specified by:
removeField
in interfaceFetchPlan
-
removeField
JDBCFetchPlan removeField(java.lang.String field)
Description copied from interface:FetchPlan
Remove the given fully-qualified field.- Specified by:
removeField
in interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.Class cls, java.util.Collection fields)
Description copied from interface:FetchPlan
Removesfields
from the set of field names to use when loading objects.- Specified by:
removeFields
in interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.Class cls, java.lang.String... fields)
Description copied from interface:FetchPlan
Removesfields
from the set of field names to use when loading objects.- Specified by:
removeFields
in interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.lang.String... fields)
Description copied from interface:FetchPlan
Removesfields
from the set of fully-qualified field names to use when loading objects.- Specified by:
removeFields
in interfaceFetchPlan
-
removeFields
JDBCFetchPlan removeFields(java.util.Collection fields)
Description copied from interface:FetchPlan
Removesfields
from the set of fully-qualified field names to use when loading objects.- Specified by:
removeFields
in interfaceFetchPlan
-
resetFetchGroups
JDBCFetchPlan resetFetchGroups()
Description copied from interface:FetchPlan
Resets the set of fetch groups to the list in the global configuration.- Specified by:
resetFetchGroups
in interfaceFetchPlan
-
setQueryResultCacheEnabled
JDBCFetchPlan setQueryResultCacheEnabled(boolean cache)
Description copied from interface:FetchPlan
Control 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:
setQueryResultCacheEnabled
in interfaceFetchPlan
-
setFetchBatchSize
JDBCFetchPlan setFetchBatchSize(int fetchBatchSize)
Description copied from interface:FetchPlan
Set the fetch batch size for large result set support. Defaults to theopenjpa.FetchBatchSize
setting. Note that this property will be ignored under some data stores.- Specified by:
setFetchBatchSize
in interfaceFetchPlan
-
setLockTimeout
JDBCFetchPlan setLockTimeout(int timeout)
Description copied from interface:FetchPlan
The number of milliseconds to wait for an object lock, or -1 for no limit.- Specified by:
setLockTimeout
in interfaceFetchPlan
-
setMaxFetchDepth
JDBCFetchPlan setMaxFetchDepth(int depth)
Description copied from interface:FetchPlan
The maximum fetch depth when loading an object.- Specified by:
setMaxFetchDepth
in interfaceFetchPlan
-
setReadLockMode
JDBCFetchPlan setReadLockMode(jakarta.persistence.LockModeType mode)
Description copied from interface:FetchPlan
The lock level to use for locking loaded objects.- Specified by:
setReadLockMode
in interfaceFetchPlan
-
setWriteLockMode
JDBCFetchPlan setWriteLockMode(jakarta.persistence.LockModeType mode)
Description copied from interface:FetchPlan
The lock level to use for locking dirtied objects.- Specified by:
setWriteLockMode
in interfaceFetchPlan
-
setQueryTimeout
JDBCFetchPlan setQueryTimeout(int timeout)
Description copied from interface:FetchPlan
The number of milliseconds to wait for a query, or -1 for no limit.- Specified by:
setQueryTimeout
in 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
-
-