XML:DB Home

Index
Requirements
Working Draft
API Use Cases

Mail List
Mail Archive
Authors
Members of the XML:DB API Mailing List - xapi-dev@xmldb.org
Kimbro Staken (Editor) - kstaken@dbxmlgroup.com
Status
Working Draft (Experimental) - 2001-03-16
Notice
This is a XML:DB Working Draft for review by all interested parties. It is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Working Drafts as reference material or to cite them as other than "work in progress". This work is part of the XML:DB Project. Comments on this specification should be sent to XML:DB API mailing list xapi-dev@xmldb.org.
Abstract
This document defines a draft specification for the XML Database API. This API is being developed through the mailing lists of the XML:DB organization and the contents are attributed to the members of those lists.

Table of Contents


1 SAXResource Module
    1.1 SAXResource
        1.1.1 IDL Specification
        1.1.2 Methods

Appendices



SAXResource Module

SAXResource enables handling of data via SAX ContentHandler objects. To facilitate this methods have been added to those normally provided by Resource to enable the setting and retireving of SAX ContentHandler objects.

The Resource.setContent() method has no use on a SAXResource. Calls to the method will not change the content of the Resource.

SAXResource

IDL Specification


// Stub SAX ContentHandler to enable IDL to compile.
interface ContentHandler {
};

interface SAXResource : base::Resource {
   void setContentHandler( in ContentHandler handler );
   ContentHandler getContentHandler();
}; 
               

Methods

setContentHandler

Sets the ContentHandler object to use when retrieving data from the data base. The ContentHandler is not actually used until getContent is called.

Parameters

handler The ContentHandler to use when reading the data


Exceptions

To be defined


getContentHandler

Returns the ContentHandler that can be used to store data to this resource. The ContentHandler can then be used by the application as part of a normal SAX parse. The ContentHandler returned sets the internal content of the Resource just as if setContent had been called on a non SAX Resource.

Return Value

The ContentHandler that can be used to set the content of this resource.


Exceptions

To be defined






Copyright © 2000,2001 The XML:DB Initiative. All Rights Reserved.