/**********************************************************************
Copyright (c) 2009 Google Inc.
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.
**********************************************************************/
package org.datanucleus.store.appengine.query;
import org.datanucleus.ObjectManager;
import org.datanucleus.exceptions.NucleusUserException;
import org.datanucleus.store.appengine.FatalNucleusUserException;
import org.datanucleus.store.query.AbstractJDOQLQuery;
import org.datanucleus.store.query.QueryTimeoutException;
import java.util.Map;
import javax.jdo.JDOQueryTimeoutException;
/**
* Implementation of JDOQL for the app engine datastore.
*
* @author Max Ross <maxr@google.com>
*/
public class JDOQLQuery extends AbstractJDOQLQuery {
/**
* The underlying Datastore query implementation.
*/
private final DatastoreQuery datastoreQuery;
/**
* Constructs a new query instance that uses the given object manager.
*
* @param om The associated ObjectManager for this query.
*/
public JDOQLQuery(ObjectManager om) {
this(om, (JDOQLQuery) null);
}
/**
* Constructs a new query instance having the same criteria as the given query.
*
* @param om The ObjectManager.
* @param q The query from which to copy criteria.
*/
public JDOQLQuery(ObjectManager om, JDOQLQuery q) {
super(om, q);
datastoreQuery = new DatastoreQuery(this);
}
/**
* Constructor for a JDOQL query where the query is specified using the "Single-String" format.
*
* @param om The object manager.
* @param query The JDOQL query string.
*/
public JDOQLQuery(ObjectManager om, String query) {
super(om, query);
datastoreQuery = new DatastoreQuery(this);
}
/**
* {@inheritDoc}
*/
@Override
protected Object performExecute(Map parameters) {
@SuppressWarnings("unchecked")
Map<String, ?> params = parameters;
if (range != null && !range.equals("")) {
// Range is of the format "from, to"
String[] fromTo = range.split(",");
if (fromTo.length != 2) {
throw new NucleusUserException("Malformed RANGE clause: " + range);
}
fromInclNo = Long.parseLong(fromTo[0].trim());
toExclNo = Long.parseLong(fromTo[1].trim());
}
try {
return datastoreQuery.performExecute(
LOCALISER, compilation, fromInclNo, toExclNo, params, true);
} catch (QueryTimeoutException e) {
throw new JDOQueryTimeoutException(e.getMessage());
}
}
// Exposed for tests.
DatastoreQuery getDatastoreQuery() {
return datastoreQuery;
}
@Override
protected void checkParameterTypesAgainstCompilation(Map parameterValues) {
// Disabled as part of our DataNuc 1.1.3 upgrade so that we can be
// continue to allow multi-value properties and implicit conversions.
// TODO(maxr) Re-enable the checks that don't break multi-value filters
// and implicit conversions.
}
@Override
public void setSubclasses(boolean subclasses) {
// We don't support queries that also return subclasses
if (subclasses) {
throw new FatalNucleusUserException(
"The App Engine datastore does not support queries that return subclass entities.");
}
super.setSubclasses(subclasses);
}
}