Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.openjpa.kernel;
import java.io.Serializable;
import java.util.Collection;
import java.util.Map;
import java.util.Set;
import org.apache.openjpa.lib.rop.ResultList;
import org.apache.openjpa.lib.rop.ResultObjectProvider;
import org.apache.openjpa.meta.FieldMetaData;
/**
* Allows configuration and optimization of how objects are loaded from
* the data store.
*
* @since 0.3.0
* @author Abe White
* @author Pinaki Poddar
*/
public interface FetchConfiguration
extends Serializable, Cloneable, LockLevels, LockScopes, QueryFlushModes {
/**
* Constant to revert any setting back to its default value.
*/
int DEFAULT = -99;
/**
* Constant indicating that a field does not require fetching.
*
* @see #requiresFetch
*/
int FETCH_NONE = 0;
/**
* Constant indicating that a field requires a fetch and load of fetched
* data.
*
* @see #requiresFetch
*/
int FETCH_LOAD = 1;
/**
* Constant indicating that a reference to the field's value must be
* fetched, but loading data is not necessary. Used when we know the
* data will be loaded anyway, such as when traversing the back-ptr of
* a bidirectional relation where the other side is also being fetched.
*
* @see #requiresFetch
*/
int FETCH_REF = 2;
/**
* Return the context associated with this configuration;
* may be null if it has not been set or this object has been serialized.
*/
StoreContext getContext();
/**
* Called automatically by the system to associate the fetch configuration
* with a context before use. The fetch configuration properties should
* be synchronized with the context's configuration object. Subclasses
* for specific back ends cannot rely on the context's configuration
* implementing their back end's configuration sub-interface.
*/
void setContext(StoreContext ctx);
/**
* Clone this instance.
*/
Object clone();
/**
* Copy the state from the given fetch configuration to this one.
*/
void copy(FetchConfiguration fetch);
/**
* Return the fetch batch size for large result set support.
* Defaults to the openjpa.FetchBatchSize setting. Note
* that this property will be ignored under some data stores.
*/
int getFetchBatchSize();
/**
* Set the fetch batch size for large result set support.
* Defaults to the openjpa.FetchBatchSize setting. Note
* that this property will be ignored under some data stores.
*/
FetchConfiguration setFetchBatchSize(int fetchBatchSize);
/**
* Return the maximum depth of fetched instance graph.
* Defaults to 1
*/
int getMaxFetchDepth();
/**
* Set the maximum depth of the fetched instance graph.
*
* @param max denotes limiting length of traversal path from a root
* instance. -1 implies no limit. 0 is not
* permissible.
*/
FetchConfiguration setMaxFetchDepth(int max);
/**
* Return whether or not query caching is enabled. If this returns
* true but the datacache plugin is not installed, caching
* will not be enabled. If this
* returns false, query caching will not be used
* even if the datacache plugin is installed.
*/
boolean getQueryCacheEnabled();
/**
* 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.
*/
FetchConfiguration setQueryCacheEnabled(boolean cache);
/**
* The query automatic flush configuration.
*/
int getFlushBeforeQueries();
/**
* The query automatic flush configuration.
*/
FetchConfiguration setFlushBeforeQueries(int flush);
/**
* Affirms if extended path lookup feature is active.
*
* @since 2.0.0
*/
boolean getExtendedPathLookup();
/**
* Sets extended path lookup feature.
*
* @since 2.0.0
*/
FetchConfiguration setExtendedPathLookup(boolean flag);
/**
* Returns immutable set of names of the fetch groups that this component
* will use when loading objects. Defaults to the
* openjpa.FetchGroups setting. This set is not thread safe.
*/
Set getFetchGroups();
/**
* Return true if the given fetch group has been added.
*/
boolean hasFetchGroup(String group);
/**
* Adds group to the set of fetch group names to
* use when loading objects.
*/
FetchConfiguration addFetchGroup(String group);
/**
* Adds groups to the set of fetch group names to
* use when loading objects.
*/
FetchConfiguration addFetchGroups(Collection groups);
/**
* Remove the given fetch group.
*/
FetchConfiguration removeFetchGroup(String group);
/**
* Removes groups from the set of fetch group names
* to use when loading objects.
*/
FetchConfiguration removeFetchGroups(Collection groups);
/**
* Clears the set of fetch group names to use when 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.
*/
FetchConfiguration clearFetchGroups();
/**
* Resets the set of fetch groups to the list in the global configuration.
*/
FetchConfiguration resetFetchGroups();
/**
* Returns the set of fully-qualified field names that this component
* will use when loading objects. Defaults to the empty set. This set is
* not thread safe.
*/
Set getFields();
/**
* Return true if the given fully-qualified field has been added.
*/
boolean hasField(String field);
/**
* Adds field to the set of fully-qualified field names to
* use when loading objects.
*/
FetchConfiguration addField(String field);
/**
* Adds fields to the set of fully-qualified field names to
* use when loading objects.
*/
FetchConfiguration addFields(Collection fields);
/**
* Remove the given fully-qualified field.
*/
FetchConfiguration removeField(String field);
/**
* Removes fields from the set of fully-qualified field names
* to use when loading objects.
*/
FetchConfiguration removeFields(Collection fields);
/**
* Clears the set of field names to use when loading
* data. After this operation is invoked, only those fields in
* the configured fetch groups will be loaded when loading an object.
*/
FetchConfiguration clearFields();
/**
* The number of milliseconds to wait for an object lock, or -1 for no
* limit.
*
* @since 0.3.1
*/
int getLockTimeout();
/**
* The number of milliseconds to wait for an object lock, or -1 for no
* limit.
*
* @since 0.3.1
*/
FetchConfiguration setLockTimeout(int timeout);
/**
* The lock scope for next fetch.
*
* @since 2.0.0
*/
int getLockScope();
/**
* The lock scope for next fetch.
*
* @since 2.0.0
*/
FetchConfiguration setLockScope(int scope);
/**
* The number of milliseconds to wait for a query, or -1 for no
* limit.
*
* @since 2.0.0
*/
int getQueryTimeout();
/**
* The number of milliseconds to wait for a query, or -1 for no
* limit.
*
* @since 2.0.0
*/
FetchConfiguration setQueryTimeout(int timeout);
/**
* The lock level to use for locking loaded objects.
*
* @since 0.3.1
*/
int getReadLockLevel();
/**
* The lock level to use for locking loaded objects.
*
* @since 0.3.1
*/
FetchConfiguration setReadLockLevel(int level);
/**
* The lock level to use for locking dirtied objects.
*
* @since 0.3.1
*/
int getWriteLockLevel();
/**
* Gets the current storage mode for data cache.
*
* @since 2.0.0
*/
DataCacheStoreMode getCacheStoreMode();
/**
* Sets the current storage mode for data cache.
*
* @since 2.0.0
*/
void setCacheStoreMode(DataCacheStoreMode mode);
/**
* Gets the current retrieve mode for data cache.
*
* @since 2.0.0
*/
DataCacheRetrieveMode getCacheRetrieveMode();
/**
* Sets the current retrieve mode for data cache.
*
* @since 2.0.0
*/
void setCacheRetrieveMode(DataCacheRetrieveMode mode);
/**
* The lock level to use for locking dirtied objects.
*
* @since 0.3.1
*/
FetchConfiguration setWriteLockLevel(int level);
/**
* Return a new result list for the current fetch configuration.
*/
ResultList newResultList(ResultObjectProvider rop);
/**
* Sets an arbitrary query hint that may be utilized during execution.
* The hint may be specific to a particular database. A hint, if known
* to this receiver, may have a corresponding setter method, then the hint sets the value.
* Otherwise the hint is stored opaquely by the receiver.
*
* @param name the name of the hint
* @param value the value of the hint. If the hint has a corresponding setter, then
* the type of value must be same as the setter argument.
* @param original the value of the hint as specified by the user.
*
* @since 2.0.0
*/
void setHint(String name, Object value, Object original);
/**
* Sets an arbitrary query hint that may be utilized during execution.
* The hint may be specific to a particular database. A hint, if known
* to this receiver, may have a corresponding setter method, then the hint sets the value.
* Otherwise the hint is stored opaquely by the receiver.
*
* This is same as calling {@linkplain #setHint(String, Object, Object)} with the third
* argument being the same as the second.
*
* @param name the name of the hint
* @param value the value of the hint. If the hint has a corresponding setter, then
* the type of value must be same as the setter argument.
*
* @since 2.0.0
*/
void setHint(String key, Object value);
/**
* Get the hint value for the specific key as originally set by the caller, or null if the hint is not specified.
*
* @param name the hint name
* @since 0.4.0
*/
Object getHint (String key);
/**
* Get an immutable view of the currently active hints and their values.
* The values are as specified by the user.
*
* @since 2.0.0
*/
Map getHints();
/**
* Affirm if the given hint has been set in this receiver.
*
*/
boolean isHintSet(String key);
/**
* Affirm if the Fetch Plan currently matches the Persistence Unit's configured default.
*
*/
boolean isDefaultPUFetchGroupConfigurationOnly();
/**
* Root classes for recursive operations. This set is not thread safe.
*/
Set> getRootClasses();
/**
* Root classes for recursive operations.
*/
FetchConfiguration setRootClasses(Collection> classes);
/**
* Root instances for recursive operations. This set is not thread safe.
*/
Set
