com.asual.lesscss.loader

Class StreamResourceLoader

java.lang.Object

com.asual.lesscss.loader.StreamResourceLoader

All Implemented Interfaces:

ResourceLoader

Direct Known Subclasses:

ClasspathResourceLoader, FilesystemResourceLoader, HTTPResourceLoader, JNDIResourceLoader

public abstract class StreamResourceLoader
extends Object
implements ResourceLoader

A base class for loader implementations. Each loader implementation is associated with a URL schema name. When requested resource path starts with the loader's associated schema, schema name is stripped and lookup is retried with plain name instead. Paths starting with other schema names are rejected, plain names are checked using openStream(String) - a non null return value indicates valid resource.

Author:

Rafał Krzewski

Constructor Summary

Constructors

Constructor and Description
StreamResourceLoader()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	exists(String resource, String[] paths) Checks if the given resource exists.
protected abstract String	getSchema() Returns the schema name associated with the loader.
String	load(String resource, String[] paths, String charset) Loads the given resource's contents.
protected abstract InputStream	openStream(String path) Returns an InputStream for reading the resource.
protected String	readStream(InputStream is, String charset)

Methods inherited from class java.lang.Object

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

Constructor Detail

StreamResourceLoader

public StreamResourceLoader()

Method Detail

getSchema

protected abstract String getSchema()

Returns the schema name associated with the loader.

Returns:

schema name.

openStream

protected abstract InputStream openStream(String path)
                                   throws IOException

Returns an InputStream for reading the resource.

Parameters:

path - the path of the resource.

Returns:

an InputStream or null if the resource does not exist.

Throws:

IOException - when i/o operation fails.

exists

public boolean exists(String resource,
             String[] paths)
               throws IOException

Description copied from interface: ResourceLoader

Checks if the given resource exists.

Specified by:

exists in interface ResourceLoader

Parameters:

resource - relative resource file path.

paths - paths to search for resource under.

Returns:

true if the resource exists.

Throws:

IOException - when i/o error occurs while checking for resource existence.

load

public String load(String resource,
          String[] paths,
          String charset)
            throws IOException

Description copied from interface: ResourceLoader

Loads the given resource's contents.

Specified by:

load in interface ResourceLoader

Parameters:

resource - relative resource file path.

paths - paths to search for resource under.

charset - character set name, valid with respect to Charset.

Returns:

resource contents as a string.

Throws:

IOException - when i/o error occurs while loading the resource, or charset is invalid.

readStream

protected String readStream(InputStream is,
                String charset)
                     throws IOException

Throws:

IOException