org.apache.openjpa.jdbc.kernel
Interface JDBCFetchConfiguration

All Superinterfaces:
Cloneable, EagerFetchModes, FetchConfiguration, JoinSyntaxes, LockLevels, LRSSizes, QueryFlushModes, Serializable
All Known Implementing Classes:
DelegatingJDBCFetchConfiguration, JDBCFetchConfigurationImpl

public interface JDBCFetchConfiguration
extends FetchConfiguration, EagerFetchModes, LRSSizes, JoinSyntaxes

JDBC extensions to OpenJPA's FetchConfiguration.

Since:
0.3.0
Author:
Abe White

Field Summary
 
Fields inherited from interface org.apache.openjpa.kernel.FetchConfiguration
DEFAULT, FETCH_LOAD, FETCH_NONE, FETCH_REF
 
Fields inherited from interface org.apache.openjpa.kernel.LockLevels
LOCK_NONE, LOCK_READ, LOCK_WRITE
 
Fields inherited from interface org.apache.openjpa.kernel.QueryFlushModes
FLUSH_FALSE, FLUSH_TRUE, FLUSH_WITH_CONNECTION
 
Fields inherited from interface org.apache.openjpa.jdbc.kernel.EagerFetchModes
EAGER_JOIN, EAGER_NONE, EAGER_PARALLEL
 
Fields inherited from interface org.apache.openjpa.jdbc.kernel.LRSSizes
SIZE_LAST, SIZE_QUERY, SIZE_UNKNOWN
 
Fields inherited from interface org.apache.openjpa.jdbc.sql.JoinSyntaxes
SYNTAX_DATABASE, SYNTAX_SQL92, SYNTAX_TRADITIONAL
 
Method Summary
 JDBCFetchConfiguration addJoin(String field)
          Adds field to the set of fully-qualified field names to eagerly join when loading objects.
 JDBCFetchConfiguration addJoins(Collection fields)
          Adds fields 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 from ResultSet.
 int getIsolation()
          The isolation level for queries issued to the database.
 Set 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 from ResultSet.
 int getSubclassFetchMode()
          Return the subclass fetch mode.
 int getSubclassFetchMode(ClassMapping cls)
          Return the effective subclass fetch mode for the given type.
 boolean hasJoin(String field)
          Return true if the given fully-qualified join has been added.
 JDBCFetchConfiguration removeJoin(String field)
          Removes field to the set of fully-qualified field names to eagerly join when loading objects.
 JDBCFetchConfiguration removeJoins(Collection fields)
          Removes fields 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 from ResultSet.
 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 from ResultSet.
 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, getContext, getFetchBatchSize, getFetchGroups, getFields, getFlushBeforeQueries, getHint, getLockTimeout, getMaxFetchDepth, getQueryCacheEnabled, getReadLockLevel, getRootClasses, getRootInstances, getWriteLockLevel, hasFetchGroup, hasField, lock, newResultList, removeFetchGroup, removeFetchGroups, removeField, removeFields, requiresFetch, requiresLoad, resetFetchGroups, setContext, setFetchBatchSize, setFlushBeforeQueries, setHint, setLockTimeout, setMaxFetchDepth, setQueryCacheEnabled, setReadLockLevel, setRootClasses, setRootInstances, setWriteLockLevel, traverse, unlock
 

Method Detail

getEagerFetchMode

int getEagerFetchMode()
Return the eager fetch mode. Defaults to the openjpa.jdbc.EagerFetchMode setting.


setEagerFetchMode

JDBCFetchConfiguration setEagerFetchMode(int mode)
Set the eager fetch mode. Defaults to the openjpa.jdbc.EagerFetchMode setting.


getSubclassFetchMode

int getSubclassFetchMode()
Return the subclass fetch mode. Defaults to the openjpa.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 the openjpa.jdbc.SubclassFetchMode setting.


getResultSetType

int getResultSetType()
The result set type to use as a constant from ResultSet. Defaults to the openjpa.jdbc.ResultSetType setting.


setResultSetType

JDBCFetchConfiguration setResultSetType(int type)
The result set type to use as a constant from ResultSet. Defaults to the openjpa.jdbc.ResultSetType setting.


getFetchDirection

int getFetchDirection()
The fetch direction to use as a constant from ResultSet. Defaults to the openjpa.jdbc.FetchDirection setting.


setFetchDirection

JDBCFetchConfiguration setFetchDirection(int direction)
The fetch direction to use as a constant from ResultSet. Defaults to the openjpa.jdbc.FetchDirection setting.


getLRSSize

int getLRSSize()
The large result set size mode to use. Defaults to the openjpa.jdbc.LRSSize setting.


setLRSSize

JDBCFetchConfiguration setLRSSize(int lrsSize)
The large result set size mode to use. Defaults to the openjpa.jdbc.LRSSize setting.


getJoinSyntax

int getJoinSyntax()
The join syntax to use.


setJoinSyntax

JDBCFetchConfiguration setJoinSyntax(int syntax)
The join syntax to use.


getJoins

Set 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(String field)
Return true if the given fully-qualified join has been added.

Since:
0.4.0.0

addJoin

JDBCFetchConfiguration addJoin(String field)
Adds field 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(Collection fields)
Adds fields 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(String field)
Removes field to the set of fully-qualified field names to eagerly join when loading objects.

Since:
0.4.0.0

removeJoins

JDBCFetchConfiguration removeJoins(Collection fields)
Removes fields 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.



Copyright © 2006-2008 Apache Software Foundation. All Rights Reserved.