EclipseLink 2.3.2, build 'v20111125-r10461' API Reference

org.eclipse.persistence.queries
Class JPQLCall

java.lang.Object
  extended by org.eclipse.persistence.queries.JPQLCall
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, Call

public class JPQLCall
extends java.lang.Object
implements java.io.Serializable, Call

Purpose: Used as an abstraction of a database invocation. A call is an JPQL string.

Responsibilities:

See Also:
Serialized Form
Author:
Jon Driscoll and Joel Lucuik
Since:
TopLink 4.0

Field Summary
protected  boolean isParsed
           
protected  java.lang.String jpqlString
           
protected  DatabaseQuery query
           
 
Constructor Summary
JPQLCall()
          PUBLIC: Create a new JPQLCall.
JPQLCall(java.lang.String jpqlString)
          PUBLIC: Create a new JPQLCall with an jpqlString.
 
Method Summary
 org.eclipse.persistence.internal.queries.DatabaseQueryMechanism buildNewQueryMechanism(DatabaseQuery query)
          INTERNAL: Return the appropriate mechanism, with the call added as necessary.
 org.eclipse.persistence.internal.queries.DatabaseQueryMechanism buildQueryMechanism(DatabaseQuery query, org.eclipse.persistence.internal.queries.DatabaseQueryMechanism mechanism)
          INTERNAL: Return the appropriate mechanism, with the call added as necessary.
 java.lang.Object clone()
          INTERNAL: Return a clone of the call.
 java.lang.String getCallString()
          INTERNAL: Return the string for the call
 java.lang.String getEjbqlString()
          INTERNAL: Return the EJBQL string for this call
 java.lang.String getJPQLString()
          INTERNAL: Return the EJBQL string for this call
 java.lang.String getLogString(org.eclipse.persistence.internal.databaseaccess.Accessor accessor)
          INTERNAL: Return the SQL string for this call.
 DatabaseQuery getQuery()
          Back reference to query, unfortunately required for events.
 java.lang.String getSQLString()
          INTERNAL: Return the SQL string for this call.
 boolean isFinished()
          Return whether all the results of the call have been returned.
 boolean isJPQLCall()
          INTERNAL: Yes this is an JPQLCall
 boolean isNothingReturned()
          The return type is one of, NoReturn, ReturnOneRow or ReturnManyRows.
 boolean isOneRowReturned()
          The return type is one of, NoReturn, ReturnOneRow or ReturnManyRows.
 boolean isParsed()
          INTERNAL Is this query Parsed
 void populateQuery(org.eclipse.persistence.internal.sessions.AbstractSession session)
          Populate the query using the information retrieved from parsing the EJBQL.
 java.sql.PreparedStatement prepareStatement(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor, org.eclipse.persistence.internal.sessions.AbstractRecord translationRow, org.eclipse.persistence.internal.sessions.AbstractSession session)
          INTERNAL: Prepare the JDBC statement, this may be parameterize or a call statement.
 void setEjbqlString(java.lang.String jpqlString)
          INTERNAL: Set the EJBQL string for this call
 void setIsParsed(boolean newIsParsed)
          INTERNAL Set the isParsed state
 void setJPQLString(java.lang.String jpqlString)
          INTERNAL: Set the JPQL string for this call
 void setQuery(DatabaseQuery query)
          INTERNAL: Back reference to query, unfortunately required for events.
 java.lang.String toString()
          INTERNAL: Print the JPQL string.
 void translate(org.eclipse.persistence.internal.sessions.AbstractRecord translationRow, org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow, org.eclipse.persistence.internal.sessions.AbstractSession session)
          INTERNAL: translate method comment.
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

query

protected DatabaseQuery query

jpqlString

protected java.lang.String jpqlString

isParsed

protected boolean isParsed
Constructor Detail

JPQLCall

public JPQLCall()
PUBLIC: Create a new JPQLCall.


JPQLCall

public JPQLCall(java.lang.String jpqlString)
PUBLIC: Create a new JPQLCall with an jpqlString.

Method Detail

buildNewQueryMechanism

public org.eclipse.persistence.internal.queries.DatabaseQueryMechanism buildNewQueryMechanism(DatabaseQuery query)
INTERNAL: Return the appropriate mechanism, with the call added as necessary.

Specified by:
buildNewQueryMechanism in interface Call

buildQueryMechanism

public org.eclipse.persistence.internal.queries.DatabaseQueryMechanism buildQueryMechanism(DatabaseQuery query,
                                                                                           org.eclipse.persistence.internal.queries.DatabaseQueryMechanism mechanism)
INTERNAL: Return the appropriate mechanism, with the call added as necessary.

Specified by:
buildQueryMechanism in interface Call

clone

public java.lang.Object clone()
Description copied from interface: Call
INTERNAL: Return a clone of the call.

Specified by:
clone in interface Call
Overrides:
clone in class java.lang.Object

getCallString

public java.lang.String getCallString()
INTERNAL: Return the string for the call


getEjbqlString

public java.lang.String getEjbqlString()
INTERNAL: Return the EJBQL string for this call


getJPQLString

public java.lang.String getJPQLString()
INTERNAL: Return the EJBQL string for this call


getQuery

public DatabaseQuery getQuery()
Back reference to query, unfortunately required for events.


getLogString

public java.lang.String getLogString(org.eclipse.persistence.internal.databaseaccess.Accessor accessor)
INTERNAL: Return the SQL string for this call. Always return null since this is an EJBQL call

Specified by:
getLogString in interface Call

getSQLString

public java.lang.String getSQLString()
INTERNAL: Return the SQL string for this call. Always return null since this is an EJBQL call


isJPQLCall

public boolean isJPQLCall()
INTERNAL: Yes this is an JPQLCall


isFinished

public boolean isFinished()
Return whether all the results of the call have been returned.

Specified by:
isFinished in interface Call

isParsed

public boolean isParsed()
INTERNAL Is this query Parsed


populateQuery

public void populateQuery(org.eclipse.persistence.internal.sessions.AbstractSession session)
Populate the query using the information retrieved from parsing the EJBQL.


prepareStatement

public java.sql.PreparedStatement prepareStatement(org.eclipse.persistence.internal.databaseaccess.DatabaseAccessor accessor,
                                                   org.eclipse.persistence.internal.sessions.AbstractRecord translationRow,
                                                   org.eclipse.persistence.internal.sessions.AbstractSession session)
                                            throws java.sql.SQLException
INTERNAL: Prepare the JDBC statement, this may be parameterize or a call statement. If caching statements this must check for the pre-prepared statement and re-bind to it.

Throws:
java.sql.SQLException

setEjbqlString

public void setEjbqlString(java.lang.String jpqlString)
INTERNAL: Set the EJBQL string for this call


setJPQLString

public void setJPQLString(java.lang.String jpqlString)
INTERNAL: Set the JPQL string for this call


setIsParsed

public void setIsParsed(boolean newIsParsed)
INTERNAL Set the isParsed state


setQuery

public void setQuery(DatabaseQuery query)
INTERNAL: Back reference to query, unfortunately required for events.


translate

public void translate(org.eclipse.persistence.internal.sessions.AbstractRecord translationRow,
                      org.eclipse.persistence.internal.sessions.AbstractRecord modifyRow,
                      org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: translate method comment.


isNothingReturned

public boolean isNothingReturned()
The return type is one of, NoReturn, ReturnOneRow or ReturnManyRows.

Specified by:
isNothingReturned in interface Call

isOneRowReturned

public boolean isOneRowReturned()
The return type is one of, NoReturn, ReturnOneRow or ReturnManyRows.

Specified by:
isOneRowReturned in interface Call

toString

public java.lang.String toString()
INTERNAL: Print the JPQL string.

Overrides:
toString in class java.lang.Object

EclipseLink 2.3.2, build 'v20111125-r10461' API Reference