org.apache.cocoon.components.source.impl
Class XMLDBSource

java.lang.Object
  org.apache.avalon.framework.logger.AbstractLogEnabled
      org.apache.cocoon.components.source.impl.XMLDBSource

All Implemented Interfaces:

LogEnabled, ModifiableSource, Source, XMLizable

public class XMLDBSource

extends AbstractLogEnabled

implements Source, ModifiableSource, XMLizable

This class implements the xmldb:// pseudo-protocol and allows to get XML content from an XML:DB enabled XML database.

Version:

CVS $Id: XMLDBSource.java 265726 2005-09-01 13:41:41Z sylvain $

Author:

Gianugo Rabellino, Vadim Gritsenko

Nested Class Summary

class

XMLDBSource.XMLDBOutputStream

Field Summary

protected static String	CDATA
protected static String	COLLECTION Element <collection>
protected static String	COLLECTION_BASE_ATTR
protected static String	COLLECTION_COUNT_ATTR Attribute collections on the root element indicates count of collections in the collection
protected static String	COLLECTIONS Root element <collections>
protected Context	context The Avalon context
protected ServiceManager	manager ServiceManager
protected static String	NAME_ATTR Attribute name on the collection/resource element
protected XMLDBSource.XMLDBOutputStream	os XMLDBOutputStream for writing to Modifiable resource
protected String	password The supplied password
static String	PREFIX Source prefix
protected static String	QCOLLECTION Element <xmldb:collection> (raw name)
protected static String	QCOLLECTIONS Root element <xmldb:collections> (raw name)
protected static String	QRESOURCE Element <resource> (raw name)
protected static String	QRESULT Element <xmldb:result> (raw name)
protected static String	QRESULTSET Root element <xmldb:results> (raw name)
protected String	query The part of URL after # sign
protected static String	QUERY_ATTR
protected static String	RESOURCE Element <resource>
protected static String	RESOURCE_COUNT_ATTR Attribute resources on the root element indicates count of resources in the collection
protected static String	RESULT Element <result>
protected static String	RESULT_DOCID_ATTR
protected static String	RESULT_ID_ATTR
protected static String	RESULTS_COUNT_ATTR
protected static String	RESULTSET Root element <results>
protected String	systemId The System ID
static String	URI Source namespace
protected String	url The requested URL
protected String	user The supplied user

Constructor Summary

XMLDBSource(Logger logger, SourceCredential credential, String url, ServiceManager manager, Context context)
The constructor.

Method Summary

boolean	canCancel(OutputStream stream) Can the data sent to an OutputStream returned by getOutputStream() be cancelled ?
void	cancel(OutputStream stream) Cancel the data sent to an OutputStream returned by getOutputStream().
void	delete() Delete the source
boolean	exists()
long	getContentLength()
InputStream	getInputStream() Get an InputSource for the given URL.
long	getLastModified()
String	getMimeType()
OutputStream	getOutputStream() Return an XMLDBSource.XMLDBOutputStream to write to.
String	getScheme()
String	getURI()
SourceValidity	getValidity()
void	recycle()
void	refresh()
void	toSAX(ContentHandler handler) Stream SAX events to a given ContentHandler.

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

URI

public static final String URI

Source namespace

See Also:

Constant Field Values

PREFIX

public static final String PREFIX

Source prefix

See Also:

Constant Field Values

COLLECTIONS

protected static final String COLLECTIONS

Root element <collections>

See Also:

Constant Field Values

QCOLLECTIONS

protected static final String QCOLLECTIONS

Root element <xmldb:collections> (raw name)

See Also:

Constant Field Values

RESOURCE_COUNT_ATTR

protected static final String RESOURCE_COUNT_ATTR

Attribute resources on the root element indicates count of resources in the collection

See Also:

Constant Field Values

COLLECTION_COUNT_ATTR

protected static final String COLLECTION_COUNT_ATTR

Attribute collections on the root element indicates count of collections in the collection

See Also:

Constant Field Values

COLLECTION_BASE_ATTR

protected static final String COLLECTION_BASE_ATTR

See Also:

Constant Field Values

COLLECTION

protected static final String COLLECTION

Element <collection>

See Also:

Constant Field Values

QCOLLECTION

protected static final String QCOLLECTION

Element <xmldb:collection> (raw name)

See Also:

Constant Field Values

RESOURCE

protected static final String RESOURCE

Element <resource>

See Also:

Constant Field Values

QRESOURCE

protected static final String QRESOURCE

Element <resource> (raw name)

See Also:

Constant Field Values

NAME_ATTR

protected static final String NAME_ATTR

Attribute name on the collection/resource element

See Also:

Constant Field Values

RESULTSET

protected static final String RESULTSET

Root element <results>

See Also:

Constant Field Values

QRESULTSET

protected static final String QRESULTSET

Root element <xmldb:results> (raw name)

See Also:

Constant Field Values

QUERY_ATTR

protected static final String QUERY_ATTR

See Also:

Constant Field Values

RESULTS_COUNT_ATTR

protected static final String RESULTS_COUNT_ATTR

See Also:

Constant Field Values

RESULT

protected static final String RESULT

Element <result>

See Also:

Constant Field Values

QRESULT

protected static final String QRESULT

Element <xmldb:result> (raw name)

See Also:

Constant Field Values

RESULT_DOCID_ATTR

protected static final String RESULT_DOCID_ATTR

See Also:

Constant Field Values

RESULT_ID_ATTR

protected static final String RESULT_ID_ATTR

See Also:

Constant Field Values

CDATA

protected static final String CDATA

See Also:

Constant Field Values

url

protected String url

The requested URL

user

protected String user

The supplied user

password

protected String password

The supplied password

query

protected String query

The part of URL after # sign

systemId

protected String systemId

The System ID

manager

protected final ServiceManager manager

ServiceManager

os

protected XMLDBSource.XMLDBOutputStream os

XMLDBOutputStream for writing to Modifiable resource

context

protected final Context context

The Avalon context

Constructor Detail

XMLDBSource

public XMLDBSource(Logger logger,
                   SourceCredential credential,
                   String url,
                   ServiceManager manager,
                   Context context)

The constructor.

Parameters:

logger - the Logger instance.

credential - username and password

url - the URL being queried.

manager - component manager

Method Detail

toSAX

public void toSAX(ContentHandler handler)
           throws SAXException

Stream SAX events to a given ContentHandler. If the requested resource is a collection, build an XML view of it.

Specified by:

toSAX in interface XMLizable

Throws:

SAXException

recycle

public void recycle()

getURI

public String getURI()

Specified by:

getURI in interface Source

getContentLength

public long getContentLength()

Specified by:

getContentLength in interface Source

getLastModified

public long getLastModified()

Specified by:

getLastModified in interface Source

exists

public boolean exists()

Specified by:

exists in interface Source

getMimeType

public String getMimeType()

Specified by:

getMimeType in interface Source

getScheme

public String getScheme()

Specified by:

getScheme in interface Source

getValidity

public SourceValidity getValidity()

Specified by:

getValidity in interface Source

refresh

public void refresh()

Specified by:

refresh in interface Source

getInputStream

public InputStream getInputStream()
                           throws IOException

Get an InputSource for the given URL.

Specified by:

getInputStream in interface Source

Throws:

IOException

getOutputStream

public OutputStream getOutputStream()
                             throws IOException,
                                    MalformedURLException

Return an XMLDBSource.XMLDBOutputStream to write to.

Specified by:

getOutputStream in interface ModifiableSource

Throws:

IOException

MalformedURLException

delete

public void delete()
            throws SourceException

Delete the source

Specified by:

delete in interface ModifiableSource

Throws:

SourceException

canCancel

public boolean canCancel(OutputStream stream)

Can the data sent to an OutputStream returned by getOutputStream() be cancelled ?

Specified by:

canCancel in interface ModifiableSource

Returns:

true if the stream can be cancelled

cancel

public void cancel(OutputStream stream)
            throws IOException

Cancel the data sent to an OutputStream returned by getOutputStream().

After cancelling, the stream should no longer be used.

Specified by:

cancel in interface ModifiableSource

Throws:

IOException