org.eclipse.persistence.internal.xr.QueryHandler Maven / Gradle / Ivy
Show all versions of eclipselink Show documentation
/*
* Copyright (c) 1998, 2021 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0,
* or the Eclipse Distribution License v. 1.0 which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause
*/
// Contributors:
// Oracle - initial API and implementation from Oracle TopLink
package org.eclipse.persistence.internal.xr;
// Javase imports
// Java extension imports
import javax.xml.namespace.QName;
// EclipseLink imports
import org.eclipse.persistence.queries.Call;
import org.eclipse.persistence.queries.DataModifyQuery;
import org.eclipse.persistence.queries.DataReadQuery;
import org.eclipse.persistence.queries.DatabaseQuery;
import org.eclipse.persistence.queries.ReadAllQuery;
import org.eclipse.persistence.queries.ReadObjectQuery;
import org.eclipse.persistence.queries.ValueReadQuery;
/**
* INTERNAL: QueryHandler sets out the basic rules for how Operations can
* use different types of queries (DataRead, ValueRead, etc.)
*
* @author Mike Norman - [email protected]
* @since EclipseLink 1.x
*/
public abstract class QueryHandler {
protected DatabaseQuery databaseQuery;
public DatabaseQuery getDatabaseQuery() {
return databaseQuery;
}
public void setDatabaseQuery(DatabaseQuery databaseQuery) {
this.databaseQuery = databaseQuery;
}
@SuppressWarnings("unused")
public void validate(XRServiceAdapter xrService, QueryOperation queryOperation) {
}
public void initialize(XRServiceAdapter xrService, QueryOperation queryOperation) {
initializeDatabaseQuery(xrService, queryOperation);
initializeCall(xrService, queryOperation, getDatabaseQuery());
initializeArguments(xrService, queryOperation, getDatabaseQuery());
}
/**
*
INTERNAL: Initialize this QueryHandler's DatabaseQuery
* @param xrService the given DBWSService
* @param queryOperation the given QueryOperation
*/
public void initializeDatabaseQuery(XRServiceAdapter xrService, QueryOperation queryOperation) {
DatabaseQuery databaseQueryToInitialize;
if (queryOperation.hasResponse()) {
QName type = queryOperation.getResult().getType();
if (queryOperation.isCollection()) {
if (queryOperation.isSimpleXMLFormat() ||
(xrService.descriptorsByQName.containsKey(type) &&
xrService.getORSession().getClassDescriptorForAlias(
xrService.descriptorsByQName.get(type).getAlias()).isAggregateDescriptor() &&
!xrService.getORSession().getClassDescriptorForAlias(
xrService.descriptorsByQName.get(type).getAlias()).isObjectRelationalDataTypeDescriptor()
)) {
// data-read query
databaseQueryToInitialize = new DataReadQuery();
}
else {
if (!xrService.descriptorsByQName.containsKey(type)) {
// data-read query
databaseQueryToInitialize = new DataReadQuery();
}
else {
// read-all query for the class mapped to the type
databaseQueryToInitialize =
new ReadAllQuery(xrService.getTypeClass(type));
}
}
}
else {
if (queryOperation.isSimpleXMLFormat() ||
(xrService.descriptorsByQName.containsKey(type) &&
xrService.getORSession().getClassDescriptorForAlias(xrService.descriptorsByQName.get(type).getAlias()).isAggregateDescriptor() &&
!xrService.getORSession().getClassDescriptorForAlias(xrService.descriptorsByQName.get(type).getAlias()).isObjectRelationalDataTypeDescriptor()
)) {
// data-read query
databaseQueryToInitialize = new DataReadQuery();
}
else if (!xrService.descriptorsByQName.containsKey(type)) {
// value read query
databaseQueryToInitialize = new ValueReadQuery();
}
else {
// read object query for the class mapped to the type
databaseQueryToInitialize = new ReadObjectQuery(xrService.getTypeClass(type));
}
}
}
else {
databaseQueryToInitialize = new DataModifyQuery();
}
databaseQueryToInitialize.bindAllParameters();
setDatabaseQuery(databaseQueryToInitialize);
}
/**
*
INTERNAL: Initialize this QueryHandler's DatabaseQuery's
* {@link Call}. Typically no work is required, but for some QueryHandlers
* (JPQLQueryHandler, StoredProcedureQueryHandler, etc.) special
* handling may be required.
* @param xrService the given DBWSService
* @param queryOperation the given QueryOperation
* @param databaseQuery the given DatabaseQuery
*/
@SuppressWarnings("unused")
public void initializeCall(XRServiceAdapter xrService, QueryOperation queryOperation,
DatabaseQuery databaseQuery) {
}
/**
*
INTERNAL: Initialize this QueryHandler's DatabaseQuery's
* arguments from the {@link Operation}'s {@link Parameter Parameters}
* @param xrService the given DBWSService
* @param queryOperation the given QueryOperation
* @param databaseQuery the given DatabaseQuery
*/
@SuppressWarnings("unused")
public void initializeArguments(XRServiceAdapter xrService, QueryOperation queryOperation,
DatabaseQuery databaseQuery) {
for (int i = 0; i < queryOperation.getParameters().size(); i++) {
Parameter o = queryOperation.getParameters().get(i);
if (o instanceof Parameter) {
Parameter p = o;
String name = p.getName();
if (name != null && name.length() > 0 ) {
databaseQuery.addArgument(name);
continue;
}
}
String s = Integer.toString(i + 1);
databaseQuery.addArgument(s);
}
}
}