org.xmldb.api.sdk.modules

Class SimpleXMLResource

Implemented Interfaces:
Resource, XMLResource
Known Direct Subclasses:
XMLResourceImpl

public abstract class SimpleXMLResource
extends BaseResource
implements XMLResource

Provides access to XML resources stored in the database. An XMLResource can be accessed either as text XML or via the DOM or SAX APIs.

The default behavior for getContent and setContent is to work with XML data as text so these methods work on String content.

Field Summary

protected String
content
protected String
documentID

Fields inherited from class org.xmldb.api.sdk.modules.BaseResource

content, id, parent

Fields inherited from interface org.xmldb.api.modules.XMLResource

RESOURCE_TYPE

Constructor Summary

SimpleXMLResource(Collection parent, String id, String documentID)
Create a new XMLResource without any content.
SimpleXMLResource(Collection parent, String id, String documentID, String content)
Create a fully initialized XMLResource

Method Summary

Object
getContent()
Retrieves the content from the resource.
Node
getContentAsDOM()
Returns the content of the Resource as a DOM Node.
void
getContentAsSAX(ContentHandler handler)
Allows you to use a ContentHandler to parse the XML data from the database for use in an application.
String
getDocumentId()
Returns the ID for the parent document of this resource.
String
getResourceType()
Returns the resource type for this Resource.
void
setContent(Object value)
Sets the content for this resource.
void
setContentAsDOM(Node content)
Sets the content of the Resource using a DOM Node as the source.
ContentHandler
setContentAsSAX()
Sets the content of the Resource using a SAX ContentHandler.

Methods inherited from class org.xmldb.api.sdk.modules.BaseResource

getId, getParentCollection

Field Details

content

protected String content

documentID

protected String documentID

Constructor Details

SimpleXMLResource

public SimpleXMLResource(Collection parent,
                         String id,
                         String documentID)
Create a new XMLResource without any content.

SimpleXMLResource

public SimpleXMLResource(Collection parent,
                         String id,
                         String documentID,
                         String content)
Create a fully initialized XMLResource

Method Details

getContent

public Object getContent()
            throws XMLDBException
Retrieves the content from the resource. The type of the content varies depending what type of resource is being used.
Specified by:
getContent in interface Resource
Returns:
the content of the resource.

getContentAsDOM

public Node getContentAsDOM()
            throws XMLDBException
Returns the content of the Resource as a DOM Node.
Specified by:
getContentAsDOM in interface XMLResource
Returns:
The XML content as a DOM Node

getContentAsSAX

public void getContentAsSAX(ContentHandler handler)
            throws XMLDBException
Allows you to use a ContentHandler to parse the XML data from the database for use in an application.
Specified by:
getContentAsSAX in interface XMLResource
Parameters:
handler - the SAX ContentHandler to use to handle the Resource content.

getDocumentId

public String getDocumentId()
            throws XMLDBException
Returns the ID for the parent document of this resource.
Specified by:
getDocumentId in interface XMLResource

getResourceType

public String getResourceType()
            throws XMLDBException
Returns the resource type for this Resource.
Specified by:
getResourceType in interface Resource
Returns:
the resource type for the Resource.

setContent

public void setContent(Object value)
            throws XMLDBException
Sets the content for this resource. The type of content that can be set depends on the type of resource being used.
Specified by:
setContent in interface Resource
Parameters:
value - the content value to set for the resource.

setContentAsDOM

public void setContentAsDOM(Node content)
            throws XMLDBException
Sets the content of the Resource using a DOM Node as the source.
Specified by:
setContentAsDOM in interface XMLResource
Parameters:
content - The new content value

setContentAsSAX

public ContentHandler setContentAsSAX()
            throws XMLDBException
Sets the content of the Resource using a SAX ContentHandler.
Specified by:
setContentAsSAX in interface XMLResource
Returns:
a SAX ContentHandler that can be used to add content into the Resource.