/*******************************************************************************
* Copyright (c) 2011, 2012 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 v1.0 and Eclipse Distribution License v. 1.0
* which accompanies this distribution.
* The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
* and the Eclipse Distribution License is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* Contributors:
* Oracle - initial API and implementation
* 02/08/2012-2.4 Guy Pelletier
* - 350487: JPA 2.1 Specification defined support for Stored Procedure Calls
* 06/20/2012-2.5 Guy Pelletier
* - 350487: JPA 2.1 Specification defined support for Stored Procedure Calls
* 08/24/2012-2.5 Guy Pelletier
* - 350487: JPA 2.1 Specification defined support for Stored Procedure Calls
******************************************************************************/
package org.eclipse.persistence.internal.jpa.metadata.queries;
import java.util.Map;
import org.eclipse.persistence.internal.jpa.JPAQuery;
import org.eclipse.persistence.internal.jpa.metadata.accessors.MetadataAccessor;
import org.eclipse.persistence.internal.jpa.metadata.accessors.objects.MetadataAccessibleObject;
import org.eclipse.persistence.internal.jpa.metadata.accessors.objects.MetadataAnnotation;
import org.eclipse.persistence.internal.jpa.metadata.xml.XMLEntityMappings;
import org.eclipse.persistence.internal.sessions.AbstractSession;
import org.eclipse.persistence.queries.StoredFunctionCall;
/**
* INTERNAL:
* Object to hold onto a named stored function query.
*
* Key notes:
* - any metadata mapped from XML to this class must be compared in the
* equals method.
* - all metadata mapped from XML should be initialized in the initXMLObject
* method.
* - when loading from annotations, the constructor accepts the metadata
* accessor this metadata was loaded from. Used it to look up any
* 'companion' annotation needed for processing.
* - methods should be preserved in alphabetical order.
*
* @author James Sutherland
* @since EclipseLink 2.3
*/
public class NamedStoredFunctionQueryMetadata extends NamedStoredProcedureQueryMetadata {
private StoredProcedureParameterMetadata returnParameter;
/**
* INTERNAL:
* Used for OX mapping.
*/
public NamedStoredFunctionQueryMetadata() {
super("<named-stored-function-query>");
}
/**
* INTERNAL:
* Used for annotation mapping.
*/
public NamedStoredFunctionQueryMetadata(MetadataAnnotation namedStoredProcedureQuery, MetadataAccessor accessor) {
super(namedStoredProcedureQuery, accessor);
this.returnParameter = new StoredProcedureParameterMetadata((MetadataAnnotation) namedStoredProcedureQuery.getAttribute("returnParameter"), accessor);
setProcedureName((String) namedStoredProcedureQuery.getAttribute("functionName"));
}
/**
* INTERNAL:
*/
@Override
public boolean equals(Object objectToCompare) {
if (super.equals(objectToCompare) && objectToCompare instanceof NamedStoredFunctionQueryMetadata) {
NamedStoredFunctionQueryMetadata query = (NamedStoredFunctionQueryMetadata) objectToCompare;
return valuesMatch(this.returnParameter, query.getReturnParameter());
}
return false;
}
/**
* INTERNAL:
* Used for OX mapping.
*/
public StoredProcedureParameterMetadata getReturnParameter() {
return returnParameter;
}
/**
* INTERNAL:
*/
@Override
public void initXMLObject(MetadataAccessibleObject accessibleObject, XMLEntityMappings entityMappings) {
super.initXMLObject(accessibleObject, entityMappings);
// Initialize parameters ...
initXMLObject(this.returnParameter, accessibleObject);
}
/**
* INTERNAL:
*/
@Override
public void process(AbstractSession session) {
// Build the stored procedure call.
StoredFunctionCall call = new StoredFunctionCall();
// Process the stored procedure parameters.
boolean callByIndex = callByIndex();
for (StoredProcedureParameterMetadata parameter : getParameters()) {
parameter.processArgument(call, callByIndex, -1);
}
if (getReturnParameter() != null) {
getReturnParameter().processResult(call, -1);
}
// Process the procedure name.
call.setProcedureName(getProcedureName());
// Process the query hints.
Map<String, Object> hints = processQueryHints(session);
JPAQuery query = new JPAQuery(getName(), call, hints);
// Process the result class.
if (!getResultClass().isVoid()) {
query.setResultClassName(getJavaClassName(getResultClass()));
} else if (hasResultSetMapping(session)) {
query.addResultSetMapping(getResultSetMapping());
}
session.addJPAQuery(query);
}
/**
* INTERNAL:
* Used for OX mapping.
*/
public void setReturnParameter(StoredProcedureParameterMetadata returnParameter) {
this.returnParameter = returnParameter;
}
}