Package com.saxonica.xqj
Class SaxonXQMetaData
java.lang.Object
com.saxonica.xqj.SaxonXQMetaData
- All Implemented Interfaces:
XQMetaData
Saxon implementation of the XQMetaData interface
-
Constructor Summary
ConstructorsConstructorDescriptionSaxonXQMetaData
(SaxonXQConnection connection) Create the metadata for a given Saxon configuration -
Method Summary
Modifier and TypeMethodDescriptionint
Gets the maximum number of characters allowed in an expression in this data source.int
Gets the maximum number of characters allowed in a user name.int
Gets the major version of this product.int
Gets the minor version of this product.Gets the name of this product.Gets the full version of this product.Returns a set ofjava.lang.String
, each of which specifies a character encoding method the XQJ implmentation supports to parse the XQuery query text.Gets the user name associated with this connection.int
Gets the major version number of XQJ specification supported by this implementation.int
Gets the minor version number of XQJ specification supported by this implementation.Gets the full version of XQJ specification supported by this implementation.boolean
Query if XQuery full axis feature is supported in this connection.boolean
Query if XQuery module feature is supported in this connection.boolean
Query if the associated conection is restricted for read only use.boolean
Query if XQuery schema import feature is supported in this connection.boolean
Query if XQuery schema validation feature is supported in this connection.boolean
Query if XQuery serialization feature is supported in this connection.boolean
Query if XQuery static typing extensions are supported in this connection.boolean
Query if XQuery static typing feature is supported in this data source.boolean
Query if transaction is supported in this data source.boolean
Check if the user defined XML schema type is supported in this connection.boolean
Query if the XQuery encoding declaration is supported by the XQJ implementation.boolean
isXQueryEncodingSupported
(String encoding) Query if a character encoding method of the XQuery query text is supported by the XQJ implmentation.boolean
Query if XQueryX format is supported in this data source.boolean
Query if this connection was created from a JDBC connection.
-
Constructor Details
-
SaxonXQMetaData
Create the metadata for a given Saxon configuration- Parameters:
connection
- the Saxon connection
-
-
Method Details
-
getMaxExpressionLength
Description copied from interface:XQMetaData
Gets the maximum number of characters allowed in an expression in this data source.- Specified by:
getMaxExpressionLength
in interfaceXQMetaData
- Returns:
- the maximum length of expression as an integer. A zero value means that there is no limit or the limit is unknown
- Throws:
XQException
- if the connection is no longer valid
-
getMaxUserNameLength
Description copied from interface:XQMetaData
Gets the maximum number of characters allowed in a user name.- Specified by:
getMaxUserNameLength
in interfaceXQMetaData
- Returns:
- the maximum length of user name as an integer. A zero value means that there is no limit or the limit is unknown
- Throws:
XQException
- if the connection is no longer valid
-
getProductMajorVersion
Description copied from interface:XQMetaData
Gets the major version of this product.- Specified by:
getProductMajorVersion
in interfaceXQMetaData
- Returns:
- a integer indicating the major version of this product
- Throws:
XQException
- if the connection is no longer valid
-
getProductMinorVersion
Description copied from interface:XQMetaData
Gets the minor version of this product.- Specified by:
getProductMinorVersion
in interfaceXQMetaData
- Returns:
- a integer indicating the minor version of this product
- Throws:
XQException
- if the connection is no longer valid
-
getProductName
Description copied from interface:XQMetaData
Gets the name of this product. The value of string returned by this method is implementation-defined.- Specified by:
getProductName
in interfaceXQMetaData
- Returns:
- a string indicating the product name
- Throws:
XQException
- if the connection is no longer valid
-
getProductVersion
Description copied from interface:XQMetaData
Gets the full version of this product. The format and value of the string returned by this method is implementation-defined.- Specified by:
getProductVersion
in interfaceXQMetaData
- Returns:
- a string indicating the product version
- Throws:
XQException
- if the connection is no longer valid
-
getSupportedXQueryEncodings
Description copied from interface:XQMetaData
Returns a set ofjava.lang.String
, each of which specifies a character encoding method the XQJ implmentation supports to parse the XQuery query text.
For an example, for an XQJ impmentation which is able to parse the XQuery encoded in "UTF-8" or "UTF-16", it returns a
java.util.Set
of "UTF-8" and "UTF-16".If the implemetation is not able to generate a list of encodings supported, an empty set is returned. If a non-empty set is returned, the encodings returned in this set are guaranteed to be supported. Note that encodings not in the returned set might also be supported. For example, if the set has two encoding methods: 'UTF-8' and 'UTF-16', they are supported by the implementation. However, this does not mean 'Shift-Js' is not supported. It might be supported.
- Specified by:
getSupportedXQueryEncodings
in interfaceXQMetaData
- Returns:
- a
java.util.Set
ofjava.lang.String
, each of which is an XQuery query text encoding method - Throws:
XQException
- if the connection is no longer valid
-
getUserName
Description copied from interface:XQMetaData
Gets the user name associated with this connection.- Specified by:
getUserName
in interfaceXQMetaData
- Returns:
- the user's name
- Throws:
XQException
- if the connection is no longer valid
-
getXQJMajorVersion
Description copied from interface:XQMetaData
Gets the major version number of XQJ specification supported by this implementation.- Specified by:
getXQJMajorVersion
in interfaceXQMetaData
- Returns:
- an integer indicating the XQJ major version
- Throws:
XQException
- if the connection is no longer valid
-
getXQJMinorVersion
Description copied from interface:XQMetaData
Gets the minor version number of XQJ specification supported by this implementation.- Specified by:
getXQJMinorVersion
in interfaceXQMetaData
- Returns:
- an integer indicating the XQJ minor version
- Throws:
XQException
- if the connection is no longer valid
-
getXQJVersion
Description copied from interface:XQMetaData
Gets the full version of XQJ specification supported by this implementation.- Specified by:
getXQJVersion
in interfaceXQMetaData
- Returns:
- a string indicating the version of XQJ specification
- Throws:
XQException
- if the connection is no longer valid
-
isFullAxisFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery full axis feature is supported in this connection.- Specified by:
isFullAxisFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isModuleFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery module feature is supported in this connection.- Specified by:
isModuleFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isReadOnly
Description copied from interface:XQMetaData
Query if the associated conection is restricted for read only use.- Specified by:
isReadOnly
in interfaceXQMetaData
- Returns:
true
if the associated connection is for read-only;false
otherwise- Throws:
XQException
- if the connection is no longer valid
-
isSchemaImportFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery schema import feature is supported in this connection.- Specified by:
isSchemaImportFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isSchemaValidationFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery schema validation feature is supported in this connection.- Specified by:
isSchemaValidationFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isSerializationFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery serialization feature is supported in this connection.- Specified by:
isSerializationFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isStaticTypingExtensionsSupported
Description copied from interface:XQMetaData
Query if XQuery static typing extensions are supported in this connection.- Specified by:
isStaticTypingExtensionsSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isStaticTypingFeatureSupported
Description copied from interface:XQMetaData
Query if XQuery static typing feature is supported in this data source.- Specified by:
isStaticTypingFeatureSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isTransactionSupported
Description copied from interface:XQMetaData
Query if transaction is supported in this data source.- Specified by:
isTransactionSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
isUserDefinedXMLSchemaTypeSupported
Description copied from interface:XQMetaData
Check if the user defined XML schema type is supported in this connection. If this method returnstrue
, thenXQItemAccessor.instanceOf(XQItemType)
must be able to determine if the type of anXQItemAccessor
is an instance of theXQItemType
even if either of them is a user defined XML schema type which is defined by the non-predefined XML schema. The pre-defined XML Schema refers to the XML schema whose schema URL is"http://www.w3.org/2001/XMLSchema"
- Specified by:
isUserDefinedXMLSchemaTypeSupported
in interfaceXQMetaData
- Returns:
true
if the user defined XML schema type is supported in this connection,false
otherwise.- Throws:
XQException
- if the connection is no longer valid
-
isXQueryEncodingDeclSupported
Description copied from interface:XQMetaData
Query if the XQuery encoding declaration is supported by the XQJ implementation.- Specified by:
isXQueryEncodingDeclSupported
in interfaceXQMetaData
- Returns:
true
if the XQuery encoding declaration is supported;false
otherwise- Throws:
XQException
- if the connection is no longer valid
-
isXQueryEncodingSupported
Description copied from interface:XQMetaData
Query if a character encoding method of the XQuery query text is supported by the XQJ implmentation.- Specified by:
isXQueryEncodingSupported
in interfaceXQMetaData
- Parameters:
encoding
-String
representing the character encoding method of the XQuery query text.- Returns:
true
if an XQuery query character encoding method is supported,false
otherwise- Throws:
XQException
- if (1) the connection is no longer valid, or (2) the specifiedencoding
parameter isnull
-
isXQueryXSupported
Description copied from interface:XQMetaData
Query if XQueryX format is supported in this data source.- Specified by:
isXQueryXSupported
in interfaceXQMetaData
- Returns:
true
if so; otherwisefalse
- Throws:
XQException
- if the connection is no longer valid
-
wasCreatedFromJDBCConnection
Description copied from interface:XQMetaData
Query if this connection was created from a JDBC connection.- Specified by:
wasCreatedFromJDBCConnection
in interfaceXQMetaData
- Returns:
true
, if this connection was created from a JDBC connection,false
otherwise.- Throws:
XQException
- if the connection is no longer valid
-