EclipseLink 1.0_1.0M2 API Reference - Incubation

org.eclipse.persistence.eis.interactions
Class XQueryInteraction

java.lang.Object
  extended by DatasourceCall
      extended by org.eclipse.persistence.eis.interactions.EISInteraction
          extended by org.eclipse.persistence.eis.interactions.MappedInteraction
              extended by org.eclipse.persistence.eis.interactions.XMLInteraction
                  extended by org.eclipse.persistence.eis.interactions.XQueryInteraction

public class XQueryInteraction
extends XMLInteraction

Defines the specification for a call to a JCA interaction that uses XQuery. Translates the XQuery from the query arguments. Builds the input and output XML records.

Author:
James
Since:
OracleAS TopLink 10g (10.0.3)

Field Summary
protected  java.lang.String xQueryString
           
 
Fields inherited from class org.eclipse.persistence.eis.interactions.XMLInteraction
inputRootElementName, outputRootElementName
 
Fields inherited from class org.eclipse.persistence.eis.interactions.MappedInteraction
argumentNames, inputResultPath
 
Fields inherited from class org.eclipse.persistence.eis.interactions.EISInteraction
arguments, functionName, inputRecordName, inputRow, interactionSpec, outputArgumentNames, outputArguments, outputResultPath, properties
 
Constructor Summary
XQueryInteraction()
          Default constructor.
XQueryInteraction(java.lang.String xQueryString)
          Construct the interaction with the XQuery string.
 
Method Summary
protected  char argumentMarker()
          INTERNAL: Return the character to use for the argument marker. ?
 org.w3c.dom.Element createInputDOM(EISAccessor accessor)
          Create a DOM for this interaction.
 java.lang.String getLogString(Accessor accessor)
          Return the string for logging purposes.
 java.lang.String getQueryString()
          INTERNAL: Return the query string.
 java.lang.String getXQueryString()
          PUBLIC: Return the XQuery string.
 boolean isQueryStringCall()
           
 void prepare(AbstractSession session)
          INTERNAL: Translate the custom query markers.
 void setQueryString(java.lang.String queryString)
          INTERNAL: Set the query string.
 void setXQueryString(java.lang.String xQueryString)
          PUBLIC: Set the XQuery string.
 void translate(AbstractRecord translationRow, AbstractRecord modifyRow, AbstractSession session)
          INTERNAL: Allow the call to translate the XQuery arguments.
protected  java.lang.String whitespace()
          INTERNAL: Return the characters that represent non-arguments names.
 
Methods inherited from class org.eclipse.persistence.eis.interactions.XMLInteraction
buildRow, buildRows, createField, createInputRecord, createXMLRecord, getInputRootElementName, getOutputRootElementName, setInputRootElementName, setOutputRootElementName
 
Methods inherited from class org.eclipse.persistence.eis.interactions.MappedInteraction
addArgument, addArgument, addArgumentValue, getArgumentNames, getInputResultPath, setArgumentNames, setInputResultPath
 
Methods inherited from class org.eclipse.persistence.eis.interactions.EISInteraction
addOutputArgument, addOutputArgument, createRecordElement, getArguments, getFunctionName, getInputRecordName, getInputRow, getInteractionSpec, getOutputArgumentNames, getOutputArguments, getOutputResultPath, getProperties, getProperty, hasArguments, hasOutputArguments, isEISInteraction, setArguments, setFunctionName, setInputRecordName, setInputRow, setInteractionSpec, setOutputArgumentNames, setOutputArguments, setOutputResultPath, setProperties, setProperty, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

xQueryString

protected java.lang.String xQueryString
Constructor Detail

XQueryInteraction

public XQueryInteraction()
Default constructor.


XQueryInteraction

public XQueryInteraction(java.lang.String xQueryString)
Construct the interaction with the XQuery string.

Method Detail

getXQueryString

public java.lang.String getXQueryString()
PUBLIC: Return the XQuery string.


setXQueryString

public void setXQueryString(java.lang.String xQueryString)
PUBLIC: Set the XQuery string.


getQueryString

public java.lang.String getQueryString()
INTERNAL: Return the query string.


setQueryString

public void setQueryString(java.lang.String queryString)
INTERNAL: Set the query string.


translate

public void translate(AbstractRecord translationRow,
                      AbstractRecord modifyRow,
                      AbstractSession session)
INTERNAL: Allow the call to translate the XQuery arguments.

Overrides:
translate in class EISInteraction

createInputDOM

public org.w3c.dom.Element createInputDOM(EISAccessor accessor)
Create a DOM for this interaction. Convert the database row or arguments into an XML DOM tree. Handles arguments different as the XQuery and input can both have parameters.

Overrides:
createInputDOM in class XMLInteraction

prepare

public void prepare(AbstractSession session)
INTERNAL: Translate the custom query markers.

Overrides:
prepare in class XMLInteraction

getLogString

public java.lang.String getLogString(Accessor accessor)
Return the string for logging purposes.

Overrides:
getLogString in class XMLInteraction

argumentMarker

protected char argumentMarker()
INTERNAL: Return the character to use for the argument marker. ? is used in SQL, however other query languages such as XQuery need to use other markers.


whitespace

protected java.lang.String whitespace()
INTERNAL: Return the characters that represent non-arguments names.


isQueryStringCall

public boolean isQueryStringCall()

EclipseLink 1.0_1.0M2 API Reference - Incubation