org.rapidcontext.app.web

Class FileWebService

java.lang.Object

org.rapidcontext.core.storage.StorableObject

org.rapidcontext.core.type.WebService

org.rapidcontext.app.web.FileWebService

All Implemented Interfaces:

HttpUtil

Direct Known Subclasses:

AppWebService

public class FileWebService
extends WebService

A file web service. This service is used for retrieving binary (or text) files from the storage, usually the standard web site files (HTML, CSS, JavaScript, etc). This web service only support HTTP GET requests.

Version:

1.0

Author:

Per Cederberg

Nested Class Summary

Nested classes/interfaces inherited from interface org.rapidcontext.util.HttpUtil

HttpUtil.HEADER, HttpUtil.Helper, HttpUtil.METHOD, HttpUtil.STATUS

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	KEY_PATH The dictionary key for the base storage path for files.
static Path	PATH_FILES The web files storage path.

Fields inherited from class org.rapidcontext.core.type.WebService

KEY_DESCRIPTION, KEY_MATCH, matchers, METHODS_GET, METHODS_GET_POST, METHODS_POST, PATH

Fields inherited from class org.rapidcontext.core.storage.StorableObject

dict, KEY_CLASSNAME, KEY_ID, KEY_TYPE

Constructor Summary

Constructors

Constructor and Description
FileWebService(java.lang.String id, java.lang.String type, Dict dict) Creates a new file web service from a serialized representation.

Method Summary

Modifier and Type	Method and Description
protected void	doGet(Request request) Processes an HTTP GET request.
protected java.lang.String[]	methodsImpl(Request request) Returns the HTTP methods implemented for the specified request.
Path	path() Returns the base storage path for file lookups.
protected void	processFile(Request request, Path path) Processes a storage file retrieval request (if possible).

Methods inherited from class org.rapidcontext.core.type.WebService

description, doDelete, doHead, doOptions, doPatch, doPost, doPut, doTrace, errorBadRequest, errorForbidden, errorInternal, errorMethodNotAllowed, errorNotFound, errorUnauthorized, findAllMatchers, headerAllow, methods, process, session

Methods inherited from class org.rapidcontext.core.storage.StorableObject

activate, destroy, id, init, isActive, isModified, passivate, serialize, toString, type

Methods inherited from class java.lang.Object

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

Field Detail

PATH_FILES

public static final Path PATH_FILES

The web files storage path.

KEY_PATH

public static final java.lang.String KEY_PATH

The dictionary key for the base storage path for files.

See Also:

Constant Field Values

Constructor Detail

FileWebService

public FileWebService(java.lang.String id,
                      java.lang.String type,
                      Dict dict)

Creates a new file web service from a serialized representation.

Parameters:

id - the object identifier

type - the object type name

dict - the serialized representation

Method Detail

path

public Path path()

Returns the base storage path for file lookups.

Overrides:

path in class StorableObject

Returns:

the base storage path

methodsImpl

protected java.lang.String[] methodsImpl(Request request)

Returns the HTTP methods implemented for the specified request. The OPTIONS or HEAD methods doesn't have to be added to the result (added automatically later).

Specified by:

methodsImpl in class WebService

Parameters:

request - the request to check

Returns:

the array of HTTP method names supported

See Also:

WebService.methods(Request)

doGet

protected void doGet(Request request)

Processes an HTTP GET request.

Overrides:

doGet in class WebService

Parameters:

request - the request to process

processFile

protected void processFile(Request request,
                           Path path)

Processes a storage file retrieval request (if possible).

Parameters:

request - the request to process

path - the storage path to the binary file