2.6 2.6 2.5 2.5 2.4 2.4 2.3 2.3 2.2 2.2 2.1 2.1 2.0 2.0 1.1 1.1 1.0 1.0

Serve static files

Do you have a part of your web application that serves static pages like Javadocs? Well, no need to setup an Apache server just for that, use instead the dedicated Directory class. See how simple it is to use it:

// URI of the root directory.
public static final String ROOT_URI = "file:///c:/restlet/docs/api/";

[...]

// Create a component
Component component = new Component();
component.getServers().add(Protocol.HTTP, 8182);
component.getClients().add(Protocol.FILE);

// Create an application
Application application = new Application(component.getContext()) {
    @Override
    public Restlet createRoot() {
        return new Directory(getContext(), ROOT_URI);
    }
};

// Attach the application to the component and start it
component.getDefaultHost().attach("", application);
component.start();

As you may notice, the application is instantiated by passing the context of its parent component, contrary to the previous sample code from paragraph 5. The main reason resides in the fact the dispatching of client requests made by an application need to be handled by client connectors which are controlled by the component and shared between all the contained applications.

In order to run this example, you need to specify a valid value for ROOT_URI. In this case, it is set to “file:///c:/restlet/docs/api/”. Note that no additional configuration is needed. If you want to customize the mapping between file extensions and metadata (media type, language or encoding) or if you want to specify a different index name, you can use the Application’s “metadataService” property.