XQilla Class Reference

Provides factory methods for creating XQQuery and DynamicContext objects. More...

#include <XQilla.hpp>

Inheritance diagram for XQilla:

[legend]List of all members.

Public Types
enum	Flags { NO_STATIC_RESOLUTION = 0x1, NO_ADOPT_CONTEXT = 0x2 }
	Flags used by the XQilla methods. These are used by bitwise OR-ing (|) their values together. More...
enum	Language { XQUERY, XPATH2, XQUERY_FULLTEXT, XPATH2_FULLTEXT }
	Enumeration used to select a language to parse. More...
Public Member Functions
	XQilla (xercesc::MemoryManager *memMgr=0)
	Constructs the object.
	~XQilla ()
	Destructs the object.
Static Public Member Functions
Parsing Methods
static XQQuery *	parse (const XMLCh *query, Language language=XQUERY, DynamicContext *context=0, const XMLCh *queryFile=NULL, unsigned int flags=0, xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Parse the expression contained in the given query string.
static XQQuery *	parse (const xercesc::InputSource &querySrc, Language language=XQUERY, DynamicContext *context=0, unsigned int flags=0, xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Parse the expression from the given InputSource.
static XQQuery *	parseFromURI (const XMLCh *queryFile, Language language=XQUERY, DynamicContext *context=0, unsigned int flags=0, xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Parse the expression residing at the given URL.
Factory Methods
static DynamicContext *	createContext (xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Creates a context suitable for parsing an expression with.

---

Detailed Description

Provides factory methods for creating XQQuery and DynamicContext objects.

This class calls XQillaPlatformUtils::initialize() when it is constructed, and XQillaPlatformUtils::terminate() when it destructs, so there is no need to seperately initialize or terminate either Xerces or XQilla.

---

Member Enumeration Documentation

enum XQilla::Flags

Flags used by the XQilla methods. These are used by bitwise OR-ing (|) their values together.

Enumerator:

NO_STATIC_RESOLUTION	Don't perform static resolution.
NO_ADOPT_CONTEXT	Don't adopt the context and delete it when the XQQuery is deleted.

enum XQilla::Language

Enumeration used to select a language to parse.

Enumerator:

XQUERY	Parse an XQuery expression.
XPATH2	Parse an XPath 2.0 expression.
XQUERY_FULLTEXT	Parse an XQuery Full-Text expression.
XPATH2_FULLTEXT	Parse an XPath 2.0 Full-Text expression.

---

Constructor & Destructor Documentation

XQilla::XQilla

(

xercesc::MemoryManager *

memMgr = 0

)

Constructs the object.

In the process, XQillaPlatformUtils::initialize() is called to initialize XQilla and Xerces.

Parameters:

memMgr

If provided, this is the MemoryManager used to initialize Xerces.

XQilla::~XQilla

(

)

Destructs the object.

In the process, XQillaPlatformUtils::terminate() is called to terminate XQilla and Xerces.

---

Member Function Documentation

static XQQuery* XQilla::parse	(	const XMLCh *	query,
		Language	language = XQUERY,
		DynamicContext *	context = 0,
		const XMLCh *	queryFile = NULL,
		unsigned int	flags = 0,
		xercesc::MemoryManager *	memMgr = xercesc::XMLPlatformUtils::fgMemoryManager
	)			[static]

Parse the expression contained in the given query string.

Parameters:

	query	A string containing the expression to parse.
	language	The language to parse the string as. Defaults to XQUERY.
	context	If specified, the context to use for parsing this expression. A default context is used if this parameter is 0.
	queryFile	The name of the file that query originates in. This is passed back to the user in an XQException if an error occurs.
	flags	A bitwise OR of the Flags constants, that control aspects of how the XQQuery object is created.
	memMgr	If specified, the memory manager used to create the XQQuery object.

Returns:

The object that represents the parsed expression.

Exceptions:

XQException

If a parse error occurs.

static XQQuery* XQilla::parse	(	const xercesc::InputSource &	querySrc,
		Language	language = XQUERY,
		DynamicContext *	context = 0,
		unsigned int	flags = 0,
		xercesc::MemoryManager *	memMgr = xercesc::XMLPlatformUtils::fgMemoryManager
	)			[static]

Parse the expression from the given InputSource.

Parameters:

	querySrc	An InputSource which the expression will be parsed from.
	language	The language to parse the string as. Defaults to XQUERY.
	context	If specified, the context to use for parsing this expression. A default context is used if this parameter is 0.
	flags	A bitwise OR of the Flags constants, that control aspects of how the XQQuery object is created.
	memMgr	If specified, the memory manager used to create the XQQuery object.

Returns:

The object that represents the parsed expression.

Exceptions:

XQException

If a parse error occurs.

static XQQuery* XQilla::parseFromURI	(	const XMLCh *	queryFile,
		Language	language = XQUERY,
		DynamicContext *	context = 0,
		unsigned int	flags = 0,
		xercesc::MemoryManager *	memMgr = xercesc::XMLPlatformUtils::fgMemoryManager
	)			[static]

Parse the expression residing at the given URL.

Parameters:

	queryFile	The URL of the expression to parse.
	language	The language to parse the string as. Defaults to XQUERY.
	context	If specified, the context to use for parsing this expression. A default context is used if this parameter is 0.
	flags	A bitwise OR of the Flags constants, that control aspects of how the XQQuery object is created.
	memMgr	If specified, the memory manager used to create the XQQuery object.

Returns:

The object that represents the parsed expression.

Exceptions:

XQException

If a parse error occurs.

static DynamicContext* XQilla::createContext

(

xercesc::MemoryManager *

memMgr = xercesc::XMLPlatformUtils::fgMemoryManager

)

[static]

Creates a context suitable for parsing an expression with.

Parameters:

memMgr

The memory manager used to create the DynamicContext.

Returns:

An implementation of DynamicContext

---

The documentation for this class was generated from the following file:

• XQilla.hpp

---