[Xmldb-org-xapi] xapi/idl Makefile,NONE,1.1 XQueryService.idl,NONE,1.1 Changes,1.1,1.2 XMLResource.i
Brought to you by:
reinhapa
Menu
▾
▴
[Xmldb-org-xapi] xapi/idl Makefile,NONE,1.1 XQueryService.idl,NONE,1.1 Changes,1.1,1.2 XMLResource.idl,1.1,1.2 base.idl,1.1,1.2
|
From: Per N. <per...@us...> - 2004-06-12 20:41:32
|
Update of /cvsroot/xmldb-org/xapi/idl In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv32262/xmldb.org/xapi/idl Modified Files: Changes XMLResource.idl base.idl Added Files: Makefile XQueryService.idl Log Message: added XQueryService Index: base.idl =================================================================== RCS file: /cvsroot/xmldb-org/xapi/idl/base.idl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- base.idl 30 May 2004 11:54:44 -0000 1.1 +++ base.idl 12 Jun 2004 20:41:24 -0000 1.2 @@ -166,6 +166,13 @@ Resource getMembersAsResource() raises (XMLDBException); long getSize() raises (XMLDBException); void clear() raises (XMLDBException); - } + }; + + interface CompiledExpression { + /** + * Prepare the expression for being reused. + */ + void reset(); + }; }; }; }; }; --- NEW FILE: Makefile --- SOURCES = `find . -name "*.idl"` BUILD = ../build/interfaces interfaces: rm -r $(BUILD) mkdir -p $(BUILD) #idlj -td $(BUILD) $(SOURCES) idlj -f server -td $(BUILD) base.idl idlj -f server -td $(BUILD) XMLResource.idl idlj -f server -td $(BUILD) BinaryResource.idl idlj -f server -td $(BUILD) CollectionManagementService.idl idlj -f server -td $(BUILD) XPathQueryService.idl idlj -f server -td $(BUILD) TransactionService.idl idlj -f server -td $(BUILD) XUpdateQueryService.idl idlj -f server -td $(BUILD) XQueryService.idl rm $(BUILD)/org/xmldb/api/base/*POA.java rm $(BUILD)/org/xmldb/api/base/*Helper.java rm $(BUILD)/org/xmldb/api/base/*Holder.java rm $(BUILD)/org/xmldb/api/modules/*POA.java --- NEW FILE: XQueryService.idl --- /* * The XML:DB Initiative Software License, Version 1.0 * * * Copyright (c) 2000-2004 The XML:DB Initiative. All rights * reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. The end-user documentation included with the redistribution, * if any, must include the following acknowledgment: * "This product includes software developed by the * XML:DB Initiative (http://www.xmldb.org/)." * Alternately, this acknowledgment may appear in the software itself, * if and wherever such third-party acknowledgments normally appear. * * 4. The name "XML:DB Initiative" must not be used to endorse or * promote products derived from this software without prior written * permission. For written permission, please contact in...@xm.... * * 5. Products derived from this software may not be called "XML:DB", * nor may "XML:DB" appear in their name, without prior written * permission of the XML:DB Initiative. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the XML:DB Initiative. For more information * on the XML:DB Initiative, please see <http://www.xmldb.org/>. */ #include "base.idl" module org { module xmldb { module api { module modules { interface XQueryService : base::Service { const string serviceName = "XQueryService"; const string version = "1.0"; /** * Sets a namespace mapping in the internal namespace map used to evaluate * queries. If <code>prefix</code> is null or empty the default namespace is * associated with the provided URI. A null or empty <code>uri</code> results * in an exception being thrown. * * @param prefix The prefix to set in the map. If * <code>prefix</code> is empty or null the * default namespace will be associated with the provided URI. * @param uri The URI for the namespace to be associated with prefix. * */ void setNamespace( in string prefix, in string uri ) raises (base::XMLDBException); /** * Returns the URI string associated with <code>prefix</code> from * the internal namespace map. If <code>prefix</code> is null or empty the * URI for the default namespace will be returned. If a mapping for the * <code>prefix</code> can not be found null is returned. * * @param prefix The prefix to retrieve from the namespace map. * @return The URI associated with <code>prefix</code> * @exception XMLDBException with expected error codes.<br /> * <code>ErrorCodes.VENDOR_ERROR</code> for any vendor * specific errors that occur.<br /> */ string getNamespace( in string prefix ) raises (base::XMLDBException); /** * Removes the namespace mapping associated with <code>prefix</code> from * the internal namespace map. If <code>prefix</code> is null or empty the * mapping for the default namespace will be removed. * * @param prefix The prefix to remove from the namespace map. If * <code>prefix</code> is null or empty the mapping for the default * namespace will be removed. * @exception XMLDBException with expected error codes.<br /> * <code>ErrorCodes.VENDOR_ERROR</code> for any vendor * specific errors that occur.<br /> */ void removeNamespace( in string prefix ) raises (base::XMLDBException); void clearNamespaces() raises (base::XMLDBException); base::ResourceSet query( in string query ) raises (base::XMLDBException); base::ResourceSet queryResource( in string id, in string query ) raises (base::XMLDBException); /** * Compiles the specified XQuery and returns a handle to the compiled * code, which can then be passed to {@link #execute(CompiledExpression)}. */ base::CompiledExpression compile(in string query) raises (base::XMLDBException); /** * Execute a compiled XQuery. * * The implementation should pass all namespaces and variables declared through * {@link XQueryService} to the compiled XQuery code. */ base::ResourceSet execute(in base::CompiledExpression expression) raises (base::XMLDBException); /** * Declare a global, external XQuery variable and assign a value to it. The variable * has the same status as a variable declare through the <code>declare variable</code> * statement in the XQuery prolog. * * The variable can be referenced inside the XQuery expression as * <code>$variable</code>. For example, if you declare a variable with * * <pre> * declareVariable("name", "HAMLET"); * </pre> * * you may use the variable in an XQuery expression as follows: * * <pre> * //SPEECH[SPEAKER=$name] * </pre> * * * @param qname a valid QName by which the variable is identified. Any * prefix should have been mapped to a namespace, using {@link #setNamespace(String, String)}. * For example, if a variable is called <b>x:name</b>, a prefix/namespace mapping should have * been defined for prefix <code>x</code> before calling this method. * * @param initialValue the initial value, which is assigned to the variable * */ void declareVariable(in string qname, in Object initialValue) raises (base::XMLDBException); /** * Enable or disable XPath 1.0 compatibility mode. In XPath 1.0 * compatibility mode, some XQuery expressions will behave different. * In particular, additional automatic type conversions will be applied * to the operands of numeric operators. * * @param backwardsCompatible */ void setXPathCompatibility(in boolean backwardsCompatible); void setModuleLoadPath(in string path); }; }; }; }; }; Index: XMLResource.idl =================================================================== RCS file: /cvsroot/xmldb-org/xapi/idl/XMLResource.idl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- XMLResource.idl 30 May 2004 11:54:44 -0000 1.1 +++ XMLResource.idl 12 Jun 2004 20:41:24 -0000 1.2 @@ -65,7 +65,7 @@ interface XMLResource : base::Resource { const string RESOURCE_TYPE = "XMLResource"; - string getDocumentId() raises (XMLDBException); + string getDocumentId() raises (base::XMLDBException); Node getContentAsDOM() raises (base::XMLDBException); void setContentAsDOM( in Node content) raises (base::XMLDBException); void getContentAsSAX( in ContentHandler handler ) raises (base::XMLDBException); Index: Changes =================================================================== RCS file: /cvsroot/xmldb-org/xapi/idl/Changes,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- Changes 30 May 2004 11:54:44 -0000 1.1 +++ Changes 12 Jun 2004 20:41:24 -0000 1.2 @@ -51,4 +51,7 @@ Changed DatabaseManager.getProperty, setProperty and getDatabases to not throw exceptions. Added a resourceType parameter to Collection.createResource() +-- 2004-jun-12 +Added XQueryService and CompiledExpression + |
