/**********************************************************************
Copyright (c) 2011 Andy Jefferson and others. All rights reserved.
Licensed 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.
Contributors :
...
***********************************************************************/
package org.datanucleus.store.mongodb.query;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import org.datanucleus.exceptions.NucleusUserException;
import org.datanucleus.metadata.AbstractClassMetaData;
import org.datanucleus.query.evaluator.JDOQLEvaluator;
import org.datanucleus.query.evaluator.JavaQueryEvaluator;
import org.datanucleus.store.ExecutionContext;
import org.datanucleus.store.StoreManager;
import org.datanucleus.store.connection.ManagedConnection;
import org.datanucleus.store.mongodb.MongoDBUtils;
import org.datanucleus.store.query.AbstractJDOQLQuery;
import org.datanucleus.store.query.Query;
import org.datanucleus.store.query.QueryManager;
import org.datanucleus.util.NucleusLogger;
import com.mongodb.BasicDBObject;
import com.mongodb.DB;
/**
* Implementation of JDOQL for MongoDB datastores.
*/
public class JDOQLQuery extends AbstractJDOQLQuery
{
/** The compilation of the query for this datastore. Not applicable if totally in-memory. */
protected transient MongoDBQueryCompilation datastoreCompilation = null;
/**
* Constructs a new query instance that uses the given execution context.
* @param ec Execution Context
*/
public JDOQLQuery(ExecutionContext ec)
{
this(ec, (JDOQLQuery) null);
}
/**
* Constructs a new query instance having the same criteria as the given query.
* @param ec Execution Context
* @param q The query from which to copy criteria.
*/
public JDOQLQuery(ExecutionContext ec, JDOQLQuery q)
{
super(ec, q);
}
/**
* Constructor for a JDOQL query where the query is specified using the "Single-String" format.
* @param ec Execution Context
* @param query The query string
*/
public JDOQLQuery(ExecutionContext ec, String query)
{
super(ec, query);
}
/**
* Utility to remove any previous compilation of this Query.
*/
protected void discardCompiled()
{
super.discardCompiled();
datastoreCompilation = null;
}
/**
* Method to return if the query is compiled.
* @return Whether it is compiled
*/
protected boolean isCompiled()
{
if (evaluateInMemory())
{
// Don't need datastore compilation here since evaluating in-memory
return compilation != null;
}
else
{
// Need both to be present to say "compiled"
if (compilation == null || datastoreCompilation == null)
{
return false;
}
return true;
}
}
/**
* Convenience method to return whether the query should be evaluated in-memory.
* @return Use in-memory evaluation?
*/
protected boolean evaluateInMemory()
{
if (candidateCollection != null)
{
if (compilation != null && compilation.getSubqueryAliases() != null)
{
// TODO In-memory evaluation of subqueries isn't fully implemented yet, so remove this when it is
NucleusLogger.QUERY.warn("In-memory evaluator doesn't currently handle subqueries completely so evaluating in datastore");
return false;
}
Object val = getExtension(EXTENSION_EVALUATE_IN_MEMORY);
if (val == null)
{
return true;
}
Boolean bool = Boolean.valueOf((String)val);
if (bool != null && !bool.booleanValue())
{
// User has explicitly said to not evaluate in-memory
return false;
}
return true;
}
return super.evaluateInMemory();
}
/**
* Method to compile the JDOQL query.
* Uses the superclass to compile the generic query populating the "compilation", and then generates
* the datastore-specific "datastoreCompilation".
* @param parameterValues Map of param values keyed by param name (if available at compile time)
*/
protected synchronized void compileInternal(Map parameterValues)
{
if (isCompiled())
{
return;
}
// Compile the generic query expressions
super.compileInternal(parameterValues);
boolean inMemory = evaluateInMemory();
if (candidateCollection != null && inMemory)
{
// Querying a candidate collection in-memory, so just return now (don't need datastore compilation)
// TODO Maybe apply the result class checks ?
return;
}
if (candidateClass == null)
{
throw new NucleusUserException(LOCALISER.msg("021009", candidateClassName));
}
// Make sure any persistence info is loaded
ec.hasPersistenceInformationForClass(candidateClass);
AbstractClassMetaData cmd = ec.getMetaDataManager().getMetaDataForClass(candidateClass, clr);
if (candidateClass.isInterface())
{
// Query of interface
String[] impls = ec.getMetaDataManager().getClassesImplementingInterface(candidateClass.getName(), clr);
if (impls.length == 1 && cmd.isImplementationOfPersistentDefinition())
{
// Only the generated implementation, so just use its metadata
}
else
{
// Use metadata for the persistent interface
cmd = ec.getMetaDataManager().getMetaDataForInterface(candidateClass, clr);
if (cmd == null)
{
throw new NucleusUserException("Attempting to query an interface yet it is not declared 'persistent'." +
" Define the interface in metadata as being persistent to perform this operation, and make sure" +
" any implementations use the same identity and identity member(s)");
}
}
}
QueryManager qm = getQueryManager();
StoreManager storeMgr = ec.getStoreManager();
String datastoreKey = storeMgr.getQueryCacheKey();
String cacheKey = getQueryCacheKey();
if (useCaching())
{
// Allowing caching so try to find compiled (datastore) query
datastoreCompilation = (MongoDBQueryCompilation)qm.getDatastoreQueryCompilation(datastoreKey,
getLanguage(), cacheKey);
if (datastoreCompilation != null)
{
// Cached compilation exists for this datastore so reuse it
setResultDistinct(compilation.getResultDistinct());
return;
}
}
datastoreCompilation = new MongoDBQueryCompilation();
synchronized (datastoreCompilation)
{
if (inMemory)
{
// Generate statement to just retrieve all candidate objects for later processing
}
else
{
// Try to generate statement to perform the full query in the datastore
compileQueryFull(parameterValues, cmd);
}
}
if (cacheKey != null)
{
qm.addDatastoreQueryCompilation(datastoreKey, getLanguage(), cacheKey, datastoreCompilation);
}
}
protected Object performExecute(Map parameters)
{
ManagedConnection mconn = ec.getStoreManager().getConnection(ec);
try
{
DB db = (DB)mconn.getConnection();
long startTime = System.currentTimeMillis();
if (NucleusLogger.QUERY.isDebugEnabled())
{
NucleusLogger.QUERY.debug(LOCALISER.msg("021046", "JDOQL", getSingleStringQuery(), null));
}
List candidates = null;
if (candidateCollection != null)
{
candidates = new ArrayList(candidateCollection);
}
else if (candidateExtent != null)
{
candidates = new ArrayList();
Iterator iter = candidateExtent.iterator();
while (iter.hasNext())
{
candidates.add(iter.next());
}
}
else
{
BasicDBObject filterObject = null;
if (datastoreCompilation != null)
{
if (datastoreCompilation.isFilterComplete())
{
filterObject = datastoreCompilation.getFilter();
}
}
Map<String, Object> options = new HashMap();
if (getBooleanExtensionProperty("slave-ok", false))
{
options.put("slave-ok", true);
}
// Execute as much as possible in the datastore
candidates = MongoDBUtils.getObjectsOfCandidateType(ec, db, candidateClass, subclasses,
ignoreCache, getFetchPlan(), filterObject, options);
}
// Apply any result restrictions to the results
JavaQueryEvaluator resultMapper = new JDOQLEvaluator(this, candidates, compilation,
parameters, ec.getClassLoaderResolver());
Collection results = resultMapper.execute(true, true, true, true, true);
if (NucleusLogger.QUERY.isDebugEnabled())
{
NucleusLogger.QUERY.debug(LOCALISER.msg("021074", "JDOQL",
"" + (System.currentTimeMillis() - startTime)));
}
return results;
}
finally
{
mconn.release();
}
}
/**
* Method to compile the query for the datastore attempting to evaluate the whole query in the datastore
* if possible. Sets the components of the "datastoreCompilation".
* @param parameters Input parameters (if known)
* @param candidateCmd Metadata for the candidate class
*/
private void compileQueryFull(Map parameters, AbstractClassMetaData candidateCmd)
{
if (type != Query.SELECT)
{
return;
}
long startTime = 0;
if (NucleusLogger.QUERY.isDebugEnabled())
{
startTime = System.currentTimeMillis();
NucleusLogger.QUERY.debug(LOCALISER.msg("021083", getLanguage(), toString()));
}
// Generate filter, result DBObjects as appropriate
QueryToMongoDBMapper mapper = new QueryToMongoDBMapper(compilation, parameters, candidateCmd, ec, this);
mapper.compile();
datastoreCompilation.setFilterComplete(mapper.isFilterComplete());
datastoreCompilation.setFilter(mapper.getFilterObject());
datastoreCompilation.setResultComplete(mapper.isResultComplete());
datastoreCompilation.setResult(mapper.getResultObject());
if (candidateCollection != null)
{
// Restrict to the supplied candidate ids
}
// Apply any range
if (range != null)
{
}
// Set any extensions (TODO Support locking if possible with MongoDB)
if (NucleusLogger.QUERY.isDebugEnabled())
{
NucleusLogger.QUERY.debug(LOCALISER.msg("021084", getLanguage(), System.currentTimeMillis()-startTime));
}
}
}