org.sapia.resource
Interface ResourceHandler

All Known Implementing Classes:

ClasspathResourceHandler, FileResourceHandler, UrlResourceHandler

public interface ResourceHandler

Specifies the behavior of classes used to resolve resources.

Author:

Yanick Duchesne

Method Summary

boolean	accepts(java.lang.String uri) Returns true if this handler "recognizes" resources with the given URI.
boolean	accepts(java.net.URI uri)
java.io.InputStream	getResource(java.lang.String uri) Returns the stream corresponding to the given URI.
Resource	getResourceObject(java.lang.String uri) Returns the resource object corresponding to the given URI.

Method Detail

getResource

java.io.InputStream getResource(java.lang.String uri)
                                throws java.io.IOException,
                                       ResourceNotFoundException

Returns the stream corresponding to the given URI.

Parameters:

uri - a URI.

Returns:

an InputStream.

Throws:

ResourceNotFoundException - if a resource corresponding to the URI could does not exist.

java.io.IOException - if a problem occurs.

getResourceObject

Resource getResourceObject(java.lang.String uri)
                           throws java.io.IOException

Returns the resource object corresponding to the given URI.

Parameters:

uri - a URI.

Returns:

a Resource.

Throws:

java.io.IOException - if a problem occurs.

accepts

boolean accepts(java.lang.String uri)

Returns true if this handler "recognizes" resources with the given URI. This methods is used to hold resource handlers in a chain of responsability.

Parameters:

uri - a URI.

Returns:

true if this handler can handle resources with the given URI.

accepts

boolean accepts(java.net.URI uri)

Parameters:

uri - a URI.

Returns:

true if this handler can handle resources with the given URI.

See Also:

accepts(String)