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, DEBUG_QUERY = 0x4, NO_OPTIMIZATION = 0x8 }
	Flags used by the XQilla methods. These are used by bitwise OR-ing (|) their values together. More...
enum	Language {   XQUERY = 0x00, XPATH2 = 0x01, FULLTEXT = 0x02, UPDATE = 0x04,   EXTENSIONS = 0x08, XSLT2 = 0x10, XQUERY_FULLTEXT = (XQUERY | FULLTEXT), XPATH2_FULLTEXT = (XPATH2 | FULLTEXT),   XQUERY_UPDATE = (XQUERY | UPDATE), XQUERY_FULLTEXT_UPDATE = (XQUERY | FULLTEXT | UPDATE), XSLT2_FULLTEXT = (XSLT2 | 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
XQQuery *	parse (const XMLCh *query, 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.
XQQuery *	parse (const xercesc::InputSource &querySrc, DynamicContext *context=0, unsigned int flags=0, xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Parse the expression from the given InputSource.
XQQuery *	parseFromURI (const XMLCh *queryFile, DynamicContext *context=0, unsigned int flags=0, xercesc::MemoryManager *memMgr=xercesc::XMLPlatformUtils::fgMemoryManager)
	Parse the expression residing at the given URL.
Factory Methods
DynamicContext *	createContext (Language language=XQUERY, XQillaConfiguration *conf=0, 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.

Examples:

simple-basic.cpp, and simple-context-item.cpp.

---

Member Enumeration Documentation

enum XQilla::Flags

Flags used by the XQilla methods. These are used by bitwise OR-ing (|) their values together. Enumeration values: NO_STATIC_RESOLUTION  Don't perform static resolution or any optimization. NO_ADOPT_CONTEXT  Don't adopt the context and delete it when the XQQuery is deleted. DEBUG_QUERY  Build debugging hooks into the query to enable the use of DebugListener. NO_OPTIMIZATION  Don't perform optimization.

enum XQilla::Language

Enumeration used to select a language to parse. Enumeration values: XQUERY  XPATH2  FULLTEXT  UPDATE  EXTENSIONS  XSLT2  XQUERY_FULLTEXT  XPATH2_FULLTEXT  XQUERY_UPDATE  XQUERY_FULLTEXT_UPDATE  XSLT2_FULLTEXT

---

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

DynamicContext* XQilla::createContext (  Language  language = XQUERY, XQillaConfiguration *  conf = 0, 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

XQQuery* XQilla::parse (  const xercesc::InputSource &  querySrc, 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. 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.

XQQuery* XQilla::parse (  const XMLCh *  query, 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. 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. Examples: simple-basic.cpp, and simple-context-item.cpp.

XQQuery* XQilla::parseFromURI (  const XMLCh *  queryFile, 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. 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.

---

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

• XQilla.hpp

---