Interface ApplicationConfiguration


public interface ApplicationConfiguration
An ApplicationConfiguration describes an RWT application, including the entrypoints, URL mappings, themes, etc. that constitute the application.

The configure method will be called by the framework in order to configure an application instance before it is started. An implementation must at least register an entrypoint that provides the user interface for the application. A simple implementation of this interface looks like this:

 public class ExampleConfiguration implements ApplicationConfiguration {

   public void configure( Application application ) {
     configuration.addEntryPoint( "/example", ExampleEntryPoint.class, null );
   }
 }
 

The configure method is called only once during the lifetime of an application. The configuration of the application takes place before the system is activated. Therefore, manipulation of the configuration instance at a later point in time is unsupported.

There can be more than one application instance at runtime, running on different network ports or in different contexts. In most cases, developers do not have to create an application instance explicitly. The ApplicationConfiguration can be registered with the the surrounding container instead. For example, in a servlet container, the application can be registered as context-param in the web.xml (see CONFIGURATION_PARAM), in OSGi it can be registered as a service, and when using the workbench with RAP, the application is registered with an extension-point.

Apart from this, an ApplicationRunner can be used to run an application with this configuration.

Since:
2.0
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    This constant contains the context parameter name to register an ApplicationConfiguration in a servlet container environment when running RAP without OSGi.
    static final String
    This constant contains the context parameter name to configure the web application's context directory on disk.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    configure(Application application)
    Implementations must use this method to configure an application.
  • Field Details

    • CONFIGURATION_PARAM

      static final String CONFIGURATION_PARAM
      This constant contains the context parameter name to register an ApplicationConfiguration in a servlet container environment when running RAP without OSGi. To do so, the fully qualified class name of the implementation has to be registered as a context-param in the web.xml. Example:
       <context-param>
         <param-name>org.eclipse.rap.applicationConfiguration</param-name>
         <param-value>com.example.ExampleConfiguration</param-value>
       </context-param&gt
       
      See Also:
    • RESOURCE_ROOT_LOCATION

      static final String RESOURCE_ROOT_LOCATION
      This constant contains the context parameter name to configure the web application's context directory on disk.
      See Also:
  • Method Details

    • configure

      void configure(Application application)
      Implementations must use this method to configure an application. The method is called by the framework once before the application is started.
      Parameters:
      application - the application to configure