public class TXQuery extends java.lang.Object implements TXQDynamicContext, java.io.Serializable
Modifier and Type | Field and Description |
---|---|
protected java.util.HashMap<java.lang.String,java.lang.String> |
extVarialbles |
Constructor and Description |
---|
TXQuery(java.lang.String expression)
Initializes the query with the given XQuery expression.
|
Modifier and Type | Method and Description |
---|---|
void |
bindBase64Binary(javax.xml.namespace.QName varname,
byte[] value)
Binds external variable of type xs:base64Binary to prepared XQuery.
|
void |
bindBoolean(javax.xml.namespace.QName varname,
boolean value)
Binds external variable of type xs:boolean to prepared XQuery.
|
void |
bindByte(javax.xml.namespace.QName varname,
byte value)
Binds external variable of type xs:byte to prepared XQuery.
|
void |
bindDate(javax.xml.namespace.QName varname,
java.util.Calendar value,
java.lang.String format)
Binds external variable of type xs:date to prepared XQuery.
|
void |
bindDateTime(javax.xml.namespace.QName varname,
java.util.Calendar value,
java.lang.String format)
Binds external variable of type xs:dateTime to prepared XQuery.
|
void |
bindDecimal(javax.xml.namespace.QName varname,
java.math.BigDecimal value)
Binds external variable of type xs:decimal to prepared XQuery.
|
void |
bindDouble(javax.xml.namespace.QName varname,
double value)
Binds external variable of type xs:double to prepared XQuery.
|
void |
bindDuration(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:duration to prepared XQuery.
|
void |
bindEntity(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:ENTITY to prepared XQuery.
|
void |
bindFloat(javax.xml.namespace.QName varname,
float value)
Binds external variable of type xs:float to prepared XQuery.
|
void |
bindGDay(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:gDay to prepared XQuery.
|
void |
bindGMonth(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:gMonth to prepared XQuery.
|
void |
bindGMonthDay(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:gMonthDay to prepared XQuery.
|
void |
bindGYear(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:gYear to prepared XQuery.
|
void |
bindGYearMonth(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:gYearMonth to prepared XQuery.
|
void |
bindHexBinary(javax.xml.namespace.QName varname,
byte[] value)
Binds external variable of type xs:hexBinary to prepared XQuery.
|
void |
bindID(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:ID to prepared XQuery.
|
void |
bindIDRef(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:IDREF to prepared XQuery.
|
void |
bindInt(javax.xml.namespace.QName varname,
int value)
Binds external variable of type xs:int to prepared XQuery.
|
void |
bindInteger(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:integer to prepared XQuery.
|
void |
bindLanguage(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:language to prepared XQuery.
|
void |
bindLong(javax.xml.namespace.QName varname,
long value)
Binds external variable of type xs:long to prepared XQuery.
|
void |
bindName(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:Name to prepared XQuery.
|
void |
bindNCName(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:NCName to prepared XQuery.
|
void |
bindNegativeInteger(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:negativeInteger to prepared XQuery.
|
void |
bindNMToken(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:NMTOKEN to prepared XQuery.
|
void |
bindNonNegativeInteger(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:nonNegativeInteger to prepared XQuery.
|
void |
bindNonPositiveInteger(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:nonPositiveInteger to prepared XQuery.
|
void |
bindNormalizedString(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:normalizedString to prepared XQuery.
|
void |
bindNotation(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:NOTATION to XQuery.
|
void |
bindPositiveInteger(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:positiveInteger to prepared XQuery.
|
void |
bindQName(javax.xml.namespace.QName varname,
javax.xml.namespace.QName value)
Binding variable of type QName is possible only if QName is outside of any namespace.
|
void |
bindSequence(javax.xml.namespace.QName varname,
TXQTypes[] type,
java.lang.String[] sequence)
Binds external variable of type Sequence to prepared XQuery.
|
void |
bindSequence(javax.xml.namespace.QName varname,
TXQTypes type,
java.lang.String[] sequence)
Binds external variable of type Sequence to prepared XQuery.
|
void |
bindShort(javax.xml.namespace.QName varname,
short value)
Binds external variable of type xs:short to prepared XQuery.
|
void |
bindString(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:string to prepared XQuery.
|
void |
bindTime(javax.xml.namespace.QName varname,
java.util.Calendar value,
java.lang.String format)
Binds external variable of type xs:time to prepared XQuery.
|
void |
bindToken(javax.xml.namespace.QName varname,
java.lang.String value)
Binds external variable of type xs:token to prepared XQuery.
|
void |
bindUnsignedByte(javax.xml.namespace.QName varname,
short value)
Binds external variable of type xs:unsignedByte to prepared XQuery.
|
void |
bindUnsignedInt(javax.xml.namespace.QName varname,
long value)
Binds external variable of type xs:unsignedInt to prepared XQuery.
|
void |
bindUnsignedLong(javax.xml.namespace.QName varname,
java.math.BigInteger value)
Binds external variable of type xs:unsignedLong to prepared XQuery.
|
void |
bindUnsignedShort(javax.xml.namespace.QName varname,
int value)
Binds external variable of type xs:unsignedShort to prepared XQuery.
|
void |
bindURI(javax.xml.namespace.QName varname,
java.net.URI value)
Binds external variable of type xs:anyURI to prepared XQuery.
|
boolean |
equals(java.lang.Object obj)
Indicates whether some other object is "equal to" this one.
|
java.lang.String |
getExpression()
Gets the xquery expression.
|
TMediaType |
getMediaType()
Gets the media-type parameter of serialization spec for this xquery.
|
TOutputMethod |
getOutputMethod()
Gets the output method parameter of serialization spec for this xquery.
|
TQuerySearchMode |
getQuerySearchMode()
Gets the _querysearchmode parameter for this query.
|
TSensitive |
getSensitive()
Gets the current sensitive parameter for this xquery.
|
int |
hashCode()
Returns a hash code value for the object.
|
static TXQuery |
newInstance(java.lang.String expression)
Factory method for the instantiation of a TXQuery instance.
|
protected void |
setExpression(java.lang.String expression)
Sets the concrete xquery expression.
|
void |
setMediaType(TMediaType mediaType)
Sets the media-type parameter of serialization spec for this xquery.
|
void |
setOutputMethod(TOutputMethod outputMethod)
Sets the output method parameter of serialization spec for this xquery.
|
void |
setQuerySearchMode(TQuerySearchMode querySearchMode)
Sets the _querysearchmode parameter for this query.
|
void |
setSensitive(TSensitive sensitive)
Sets the sensitive parameter for this xquery.
|
java.lang.String |
toString()
Returns the String representation of this TQuery instance.
|
protected java.util.HashMap<java.lang.String,java.lang.String> extVarialbles
public TXQuery(java.lang.String expression)
expression
- is the xquery expression.public static TXQuery newInstance(java.lang.String expression)
expression
- is the XQuery expression.protected void setExpression(java.lang.String expression)
expression
- is the Tamino query expression.public java.lang.String getExpression()
public void setSensitive(TSensitive sensitive)
Please refer to the description of the X-Machine Commands in the Tamino Server documentation for details on the usage of this parameter.
The default is TSensitive.NO
sensitive
- parameter for this xquery.public TSensitive getSensitive()
public void setOutputMethod(TOutputMethod outputMethod)
output
- method parameter of serialization spec.public TOutputMethod getOutputMethod()
public void setMediaType(TMediaType mediaType)
media-type
- parameter of serialization spec.public TMediaType getMediaType()
public void bindBoolean(javax.xml.namespace.QName varname, boolean value) throws TXQTypeException
bindBoolean
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a boolean value of external variable.TXQTypeException
public void bindByte(javax.xml.namespace.QName varname, byte value) throws TXQTypeException
bindByte
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a byte value of external variable.TXQTypeException
public void bindShort(javax.xml.namespace.QName varname, short value) throws TXQTypeException
bindShort
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a short value of external variable.TXQTypeException
public void bindInt(javax.xml.namespace.QName varname, int value) throws TXQTypeException
bindInt
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a int value of external variable.TXQTypeException
public void bindLong(javax.xml.namespace.QName varname, long value) throws TXQTypeException
bindLong
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a long value of external variable.TXQTypeException
public void bindFloat(javax.xml.namespace.QName varname, float value) throws TXQTypeException
bindFloat
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a float value of external variable.TXQTypeException
public void bindDouble(javax.xml.namespace.QName varname, double value) throws TXQTypeException
bindDouble
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a double value of external variable.TXQTypeException
public void bindInteger(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindInteger
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a integer value of external variable.TXQTypeException
public void bindDecimal(javax.xml.namespace.QName varname, java.math.BigDecimal value) throws TXQTypeException
bindDecimal
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a decimal value of external variable.TXQTypeException
public void bindString(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindString
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a string value of external variable.TXQTypeException
public void bindDateTime(javax.xml.namespace.QName varname, java.util.Calendar value, java.lang.String format) throws TXQTypeException
bindDateTime
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a dateTime value of external variable.format
- is a format of dateTime value of external variable. e.g.(yyyy-MM-dd'T'hh:mm:ss)TXQTypeException
public void bindBase64Binary(javax.xml.namespace.QName varname, byte[] value) throws TXQTypeException
bindBase64Binary
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a base64Binary value of external variable.TXQTypeException
public void bindHexBinary(javax.xml.namespace.QName varname, byte[] value) throws TXQTypeException
bindHexBinary
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a hexBinary value of external variable.TXQTypeException
public void bindDuration(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindDuration
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a duration value of external variable.TXQTypeException
public void bindTime(javax.xml.namespace.QName varname, java.util.Calendar value, java.lang.String format) throws TXQTypeException
bindTime
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a time value of external variable.format
- is a format of time value of external variable. e.g.(hh:mm:ss)TXQTypeException
public void bindDate(javax.xml.namespace.QName varname, java.util.Calendar value, java.lang.String format) throws TXQTypeException
bindDate
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a date value of external variable.format
- is a format of date value of external variable. e.g.(yyyy-MM-dd)TXQTypeException
public void bindGYearMonth(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindGYearMonth
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a gYearMonth value of external variable.TXQTypeException
public void bindGYear(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindGYear
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a gYear value of external variable.TXQTypeException
public void bindGMonthDay(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindGMonthDay
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a gMonthDay value of external variable.TXQTypeException
public void bindGDay(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindGDay
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a gDay value of external variable.TXQTypeException
public void bindGMonth(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindGMonth
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a gMonth value of external variable.TXQTypeException
public void bindURI(javax.xml.namespace.QName varname, java.net.URI value) throws TXQTypeException
bindURI
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a anyURI value of external variable.TXQTypeException
public void bindToken(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindToken
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a token value of external variable.TXQTypeException
public void bindNormalizedString(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindNormalizedString
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a normalizedString value of external variable.TXQTypeException
public void bindNotation(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
varname
- is a QName that represents external variable.value
- is a notation value of external variable.TXQTypeException
public void bindLanguage(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindLanguage
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a language value of external variable.TXQTypeException
public void bindName(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindName
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a Name value of external variable.TXQTypeException
public void bindNMToken(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindNMToken
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a NMTOKEN value of external variable.TXQTypeException
public void bindNCName(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindNCName
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a NCName value of external variable.TXQTypeException
public void bindID(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindID
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a ID value of external variable.TXQTypeException
public void bindIDRef(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindIDRef
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a IDREF value of external variable.TXQTypeException
public void bindEntity(javax.xml.namespace.QName varname, java.lang.String value) throws TXQTypeException
bindEntity
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a ENTITY value of external variable.TXQTypeException
public void bindNonPositiveInteger(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindNonPositiveInteger
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a nonPositiveInteger value of external variable.TXQTypeException
public void bindNonNegativeInteger(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindNonNegativeInteger
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a nonNegativeInteger value of external variable.TXQTypeException
public void bindNegativeInteger(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindNegativeInteger
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a negativeInteger value of external variable.TXQTypeException
public void bindUnsignedLong(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindUnsignedLong
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a unsignedLong value of external variable.TXQTypeException
public void bindPositiveInteger(javax.xml.namespace.QName varname, java.math.BigInteger value) throws TXQTypeException
bindPositiveInteger
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a positiveInteger value of external variable.TXQTypeException
public void bindUnsignedInt(javax.xml.namespace.QName varname, long value) throws TXQTypeException
bindUnsignedInt
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a unsignedInt value of external variable.TXQTypeException
public void bindUnsignedShort(javax.xml.namespace.QName varname, int value) throws TXQTypeException
bindUnsignedShort
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a unsignedShort value of external variable.TXQTypeException
public void bindUnsignedByte(javax.xml.namespace.QName varname, short value) throws TXQTypeException
bindUnsignedByte
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a unsignedByte value of external variable.TXQTypeException
public void bindQName(javax.xml.namespace.QName varname, javax.xml.namespace.QName value) throws TXQTypeException
bindQName
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is a QName value of external variable.TXQTypeException
public void bindSequence(javax.xml.namespace.QName varname, TXQTypes type, java.lang.String[] sequence) throws TXQTypeException
bindSequence
in interface TXQDynamicContext
varname
- is a QName that represents external variable.value
- is an array of items in a Sequence.TXQTypeException
public void bindSequence(javax.xml.namespace.QName varname, TXQTypes[] type, java.lang.String[] sequence) throws TXQTypeException
varname
- is a QName that represents external variable.value
- is an array of items in a Sequence.TXQTypeException
public void setQuerySearchMode(TQuerySearchMode querySearchMode)
It has turned out that these “short-term” locks might live too long. Then, while a query request is reading indizes, concurrent updates have to wait until this short lock becomes available. To prevent starvation of these update requests, newly arriving read request have to queue up behind the update requests. As a consequence, even very short read requests need a long time until they can be processed.
To increase transaction throughput and to solve above mentioned problem we may require to process queries without these “short-term” doctype locks. But giving up the “short-term” doctype lock during index processing implies that one can no longer rely on many assumptions about the correctness of the result.
In order to specify that query request should not use "short-term" locks, set _querysearchmode="approximate" i.e. TQuery.setQuerySearchMode(TQuerySearchMode.APPROXIMATE). Default value for this parameter is - "accurate"
_querysearchmode
- parameter for this query.public TQuerySearchMode getQuerySearchMode()
public java.lang.String toString()
toString
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
obj
- the reference object with which to compare.public int hashCode()
hashCode
in class java.lang.Object
Copyright (c) 2017 Software AG. All Rights Reserved.