org.apache.cocoon.components.source.util
Class SourceUtil

java.lang.Object
  org.apache.cocoon.components.source.util.SourceUtil

public abstract class SourceUtil

extends Object

This class contains some utility methods for the source resolving.

Version:

$Id: SourceUtil.html 1304280 2012-03-23 11:18:01Z ilgrosso $

Field Summary

protected static REProgram

uripattern

Constructor Summary

SourceUtil()

Method Summary

static String	getAuthority(String uri) Return the authority of a URI.
static String	getFragment(String uri) Return the fragment of a URI.
static InputSource	getInputSource(Source source) Get an InputSource object
static String	getPath(String uri) Return the path of a URI.
static String	getPathWithoutAuthority(String uri) Return the path of a URI, if the URI can't contains a authority.
static String	getQuery(String uri) Return the query of a URI.
static String	getScheme(String uri) Return the scheme of a URI.
static Source	getSource(String uri, Parameters typeParameters, SourceParameters resourceParameters, SourceResolver resolver) Get a Source object
static org.apache.cocoon.ProcessingException	handle(SourceException se) Make a ProcessingException from a SourceException.
static org.apache.cocoon.ProcessingException	handle(String message, SourceException se) Make a ProcessingException from a SourceException.
static void	handleSAXException(String source, SAXException e) Handle SAXException catched in Generator's generate method.
static void	parse(org.apache.cocoon.core.xml.SAXParser parser, Source source, ContentHandler handler) Generates SAX events from the given source by parsing it.
static void	parse(ServiceManager manager, Source source, ContentHandler handler) Deprecated. use parse(SAXParser, Source, ContentHandler) instead
static void	toCharacters(Source source, String encoding, ContentHandler handler) Generates character SAX events from the given source.
static Document	toDOM(ServiceManager manager, Source source) Generates a DOM from the given source
static Document	toDOM(ServiceManager manager, String mimeTypeHint, Source source) Generates a DOM from the given source
static void	toSAX(ServiceManager manager, Source source, ContentHandler handler) Generates SAX events from the given source.
static void	toSAX(ServiceManager manager, Source source, ContentHandler handler, Parameters typeParameters, boolean filterDocumentEvent) Generates SAX events from the given source with possible URL rewriting.
static void	toSAX(ServiceManager manager, Source source, String mimeTypeHint, ContentHandler handler) Generates SAX events from the given source by using XMLizer.
static void	toSAX(XMLizable source, ContentHandler handler) Generates SAX events from the XMLizable and handle SAXException.
static void	toSAX(XMLizer xmlizer, Source source, String mimeTypeHint, ContentHandler handler) Generates SAX events from the given source by using XMLizer.

Methods inherited from class java.lang.Object

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

Field Detail

uripattern

protected static REProgram uripattern

Constructor Detail

SourceUtil

public SourceUtil()

Method Detail

toSAX

public static void toSAX(ServiceManager manager,
                         Source source,
                         ContentHandler handler,
                         Parameters typeParameters,
                         boolean filterDocumentEvent)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the given source with possible URL rewriting.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException

IOException

toSAX

public static void toSAX(XMLizable source,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the XMLizable and handle SAXException.

Parameters:

source - the data

Throws:

SAXException

IOException

org.apache.cocoon.ProcessingException

toSAX

public static void toSAX(ServiceManager manager,
                         Source source,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the given source.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException

IOException

toSAX

public static void toSAX(ServiceManager manager,
                         Source source,
                         String mimeTypeHint,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the given source by using XMLizer.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException

IOException

toSAX

public static void toSAX(XMLizer xmlizer,
                         Source source,
                         String mimeTypeHint,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the given source by using XMLizer.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException

IOException

toCharacters

public static void toCharacters(Source source,
                                String encoding,
                                ContentHandler handler)
                         throws SAXException,
                                IOException,
                                org.apache.cocoon.ProcessingException

Generates character SAX events from the given source.

Parameters:

source - The data

encoding - The character encoding of the data

Throws:

SAXException

IOException

org.apache.cocoon.ProcessingException

parse

public static void parse(ServiceManager manager,
                         Source source,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Deprecated. use parse(SAXParser, Source, ContentHandler) instead

Generates SAX events from the given source by parsing it.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException

IOException

parse

public static void parse(org.apache.cocoon.core.xml.SAXParser parser,
                         Source source,
                         ContentHandler handler)
                  throws SAXException,
                         IOException,
                         org.apache.cocoon.ProcessingException

Generates SAX events from the given source by parsing it.

NOTE: If the implementation can produce lexical events, care should be taken that handler can actually directly implement the LexicalHandler interface!

Parameters:

source - the data

Throws:

org.apache.cocoon.ProcessingException - if error during processing source data occurs

SAXException

IOException

toDOM

public static Document toDOM(ServiceManager manager,
                             Source source)
                      throws SAXException,
                             IOException,
                             org.apache.cocoon.ProcessingException

Generates a DOM from the given source

Parameters:

source - The data

Returns:

Created DOM document.

Throws:

IOException - If a io exception occurs.

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException - If a SAX exception occurs.

toDOM

public static Document toDOM(ServiceManager manager,
                             String mimeTypeHint,
                             Source source)
                      throws SAXException,
                             IOException,
                             org.apache.cocoon.ProcessingException

Generates a DOM from the given source

Parameters:

source - The data

Returns:

Created DOM document.

Throws:

IOException - If a io exception occurs.

org.apache.cocoon.ProcessingException - if no suitable converter is found

SAXException - If a SAX exception occurs.

handle

public static org.apache.cocoon.ProcessingException handle(SourceException se)

Make a ProcessingException from a SourceException. If the exception is a SourceNotFoundException then a ResourceNotFoundException is thrown.

Parameters:

se - Source exception

Returns:

Created processing exception.

handle

public static org.apache.cocoon.ProcessingException handle(String message,
                                                           SourceException se)

Make a ProcessingException from a SourceException. If the exception is a SourceNotFoundException then a ResourceNotFoundException is thrown.

Parameters:

message - Additional exception message.

se - Source exception.

Returns:

Created processing exception.

handleSAXException

public static void handleSAXException(String source,
                                      SAXException e)
                               throws org.apache.cocoon.ProcessingException,
                                      IOException,
                                      SAXException

Handle SAXException catched in Generator's generate method.

Parameters:

source - Generator's source

e - SAXException happened in the generator's generate method.

Throws:

org.apache.cocoon.ProcessingException

IOException

SAXException

getInputSource

public static InputSource getInputSource(Source source)
                                  throws IOException,
                                         org.apache.cocoon.ProcessingException

Get an InputSource object

Parameters:

source - Source.

Returns:

Input stream of the source.

Throws:

IOException - If a io exception occurs.

org.apache.cocoon.ProcessingException - If an exception occurs during processing.

getSource

public static Source getSource(String uri,
                               Parameters typeParameters,
                               SourceParameters resourceParameters,
                               SourceResolver resolver)
                        throws IOException,
                               SAXException,
                               SourceException

Get a Source object

Parameters:

uri - URI of the source.

typeParameters - Type of Source query. Currently, only method parameter (value typically GET or POST) is recognized. May be null.

resourceParameters - Parameters of the source. May be null

resolver - Resolver for the source.

Returns:

The resolved source.

Throws:

IOException - If a io exception occurs.

SAXException - If a SAX exception occurs.

SourceException - If the source an exception throws.

getScheme

public static String getScheme(String uri)

Return the scheme of a URI. Just as there are many different methods of access to resources, there are a variety of schemes for identifying such resources. (see RFC 2396).

Parameters:

uri - Uniform resource identifier.

Returns:

Scheme of the URI.

getAuthority

public static String getAuthority(String uri)

Return the authority of a URI. This authority is typically defined by an Internet-based server or a scheme-specific registry of naming authorities (see RFC 2396).

Parameters:

uri - Uniform resource identifier.

Returns:

Scheme of the URI.

getPath

public static String getPath(String uri)

Return the path of a URI. The path contains data, specific to the authority (or the scheme if there is no authority component), identifying the resource within the scope of that scheme and authority (see RFC 2396).

Parameters:

uri - Uniform resource identifier.

Returns:

Path of the URI.

getPathWithoutAuthority

public static String getPathWithoutAuthority(String uri)

Return the path of a URI, if the URI can't contains a authority. This implementation differ to the RFC 2396.

Parameters:

uri - Uniform resource identifier.

Returns:

Path of the URI.

getQuery

public static String getQuery(String uri)

Return the query of a URI. The query is a string of information to be interpreted by the resource (see RFC 2396).

Parameters:

uri - Uniform resource identifier.

Returns:

Query of the URI.

getFragment

public static String getFragment(String uri)

Return the fragment of a URI. When a URI reference is used to perform a retrieval action on the identified resource, the optional fragment identifier, consists of additional reference information to be interpreted by the user agent after the retrieval action has been successfully completed (see RFC 2396).

Parameters:

uri - Uniform resource identifier.

Returns:

Fragment of the URI.