org.datanucleus.store.ldap.query

Class JDOQLQuery

java.lang.Object

org.datanucleus.store.query.Query<T>

org.datanucleus.store.query.AbstractJavaQuery

org.datanucleus.store.query.AbstractJDOQLQuery

org.datanucleus.store.ldap.query.JDOQLQuery

All Implemented Interfaces:

Serializable, org.datanucleus.ExecutionContextListener

public class JDOQLQuery
extends org.datanucleus.store.query.AbstractJDOQLQuery

JDOQL query for LDAP datastores. There are two modes:

• If the extension datanucleus.query.evaluateInMemory is set to true the query filter is evaluated in-memory. This means only a simple LDAP search is performed for all objects of the requisite "distinguished name" to limit it to the candidate class. Then utilises the generic JDOQLEvaluator to do in-memory imposition of the JDOQL filter, ordering, result etc.
• If the extension is absent a more specific LDAP search is performed in order to limit the number of matching objects on the LDAP server side. Nevertheless the resulting candidates are additionally evaluated the in-memory. One reason is that most LDAP attributes are case insensitive so an LDAP search may return more objects and they must be filtered additionally using the in-memory evaluator.

Performs a simple LDAP search for all objects of the requisite "distinguished name" to limit it to the candidate class. Then utilises the generic JDOQLEvaluator to do in-memory imposition of the JDOQL filter, ordering, result etc.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.datanucleus.store.query.Query

org.datanucleus.store.query.Query.QueryType, org.datanucleus.store.query.Query.SubqueryDefinition

Field Summary

Fields inherited from class org.datanucleus.store.query.AbstractJavaQuery

candidateCollection, singleString

Fields inherited from class org.datanucleus.store.query.Query

candidateClass, candidateClassName, clr, compilation, ec, explicitParameters, explicitVariables, EXTENSION_CHECK_UNUSED_PARAMETERS, EXTENSION_CLOSE_RESULTS_AT_EC_CLOSE, EXTENSION_COMPILATION_CACHED, EXTENSION_EVALUATE_IN_MEMORY, EXTENSION_EXCLUDE_SUBCLASSES, EXTENSION_FLUSH_BEFORE_EXECUTION, EXTENSION_JDOQL_STRICT, EXTENSION_JPQL_STRICT, EXTENSION_LOAD_RESULTS_AT_COMMIT, EXTENSION_MULTITHREAD, EXTENSION_RESULT_CACHE_TYPE, EXTENSION_RESULT_SIZE_METHOD, EXTENSION_RESULTS_CACHED, EXTENSION_SQL_SYNTAX_CHECKS, EXTENSION_USE_FETCH_PLAN, extensions, filter, from, fromInclNo, fromInclParam, grouping, having, ignoreCache, implicitParameters, imports, inputParameters, insertFields, insertSelectQuery, LANGUAGE_JDOQL, LANGUAGE_JPQL, LANGUAGE_SQL, ordering, parameterNames, parsedImports, queryResults, range, result, resultClass, resultClassName, resultDistinct, storeMgr, subclasses, subqueries, tasks, toExclNo, toExclParam, type, unique, unmodifiable, update

Constructor Summary

Constructors

Constructor and Description
JDOQLQuery(org.datanucleus.store.StoreManager storeMgr, org.datanucleus.ExecutionContext ec) Constructs a new query instance that uses the given persistence manager.
JDOQLQuery(org.datanucleus.store.StoreManager storeMgr, org.datanucleus.ExecutionContext ec, JDOQLQuery q) Constructs a new query instance having the same criteria as the given query.
JDOQLQuery(org.datanucleus.store.StoreManager storeMgr, org.datanucleus.ExecutionContext ec, String query) Constructor for a JDOQL query where the query is specified using the "Single-String" format.

Method Summary

Modifier and Type	Method and Description
protected Object	performExecute(Map parameters)

Methods inherited from class org.datanucleus.store.query.AbstractJDOQLQuery

compileGeneric, compileInternal, compileSubqueries, getLanguage, getQueryCacheKey, getSingleStringQuery, getSupportedExtensions, setGrouping, setResult

Methods inherited from class org.datanucleus.store.query.AbstractJavaQuery

dereferenceFilter, discardCompiled, evaluateInMemory, performDeletePersistentAll, setCandidates, setCandidates, toString

Methods inherited from class org.datanucleus.store.query.Query

addExtension, addSubquery, applyImplicitParameterValueToCompilation, applyImplicitParameterValueToSubqueries, assertIsModifiable, assertIsOpen, assertSupportsCancel, cancel, cancel, cancelTaskObject, checkForMissingParameters, checkParameterTypesAgainstCompilation, checkUnusedParameters, close, closeAll, compile, declareExplicitParameters, declareExplicitVariables, declareImports, deepFindSymbolForParameterInCompilation, deletePersistentAll, deletePersistentAll, deletePersistentAll, deregisterTask, equals, execute, executeQuery, executeWithArray, executeWithMap, executionContextClosing, getBooleanExtensionProperty, getCandidateClass, getCandidateClassMetaData, getCandidateClassName, getCompilation, getDatastoreReadTimeoutMillis, getDatastoreWriteTimeoutMillis, getExecutionContext, getExplicitParametersDeclaration, getExplicitVariablesDeclaration, getExtension, getExtensions, getFetchPlan, getFilter, getFrom, getGrouping, getHaving, getIgnoreCache, getImplicitParameters, getImportsDeclaration, getInputParameters, getInsertFields, getInsertSelectQuery, getNativeQuery, getOrdering, getParameterMapForValues, getParsedImports, getQueryManager, getRange, getRangeFromIncl, getRangeFromInclParam, getRangeToExcl, getRangeToExclParam, getResult, getResultClass, getResultClassName, getResultDistinct, getSerializeRead, getStoreManager, getStringExtensionProperty, getSubqueryForVariable, getType, getUpdate, hashCode, hasSubqueryForVariable, isCompiled, isSubclasses, isUnique, isUnmodifiable, prepareDatastore, processesRangeInDatastoreQuery, registerTask, resolveClassDeclaration, setCacheResults, setCandidateClass, setCandidateClassName, setCompilation, setDatastoreReadTimeoutMillis, setDatastoreWriteTimeoutMillis, setExtensions, setFetchPlan, setFilter, setFrom, setHaving, setIgnoreCache, setImplicitParameter, setImplicitParameter, setInsertFields, setInsertSelectQuery, setOrdering, setRange, setRange, setResultClass, setResultClassName, setResultDistinct, setResultMetaData, setSerializeRead, setSubclasses, setType, setUnique, setUnmodifiable, setUpdate, shouldReturnSingleRow, supportsTimeout, useCaching, useFetchPlan, useResultsCaching

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JDOQLQuery

public JDOQLQuery(org.datanucleus.store.StoreManager storeMgr,
                  org.datanucleus.ExecutionContext ec)

Constructs a new query instance that uses the given persistence manager.

Parameters:

storeMgr - StoreManager for this query

ec - the associated ExecutionContext for this query.

JDOQLQuery

public JDOQLQuery(org.datanucleus.store.StoreManager storeMgr,
                  org.datanucleus.ExecutionContext ec,
                  JDOQLQuery q)

Constructs a new query instance having the same criteria as the given query.

Parameters:

storeMgr - StoreManager for this query

ec - The ExecutionContext

q - The query from which to copy criteria.

JDOQLQuery

public JDOQLQuery(org.datanucleus.store.StoreManager storeMgr,
                  org.datanucleus.ExecutionContext ec,
                  String query)

Constructor for a JDOQL query where the query is specified using the "Single-String" format.

Parameters:

storeMgr - StoreManager for this query

ec - The persistence manager

query - The query string

Method Detail

performExecute

protected Object performExecute(Map parameters)

Specified by:

performExecute in class org.datanucleus.store.query.Query