13.4.2 Element description

13.4.2.1 kauri:module

Makes available certain module context as beans within the Spring bean container.

Syntax:

<kauri:module restletContext="restletContext" classLoader="classLoader" handle="module" conf="confRegistry"/>

All the attributes are optional. The values of the attributes are the bean names under which to make the beans available, and can be freely chosen.

The following attributes are available:

• restletContext: the org.restlet.Context object for the current module. Among other things, this is useful to perform internal requests. For example: restletContext.getClientDispatcher().get("module:/static/foo.html")
• classLoader: makes the class loader of the current module available. Normally the context classloader will also be set to the module class loader, but it is convenient to have an explicit handle to it
• handle: provides access to the API of the current module. The bean implements the org.kauriproject.runtime.rapi.KauriModule interface defined by the kauri-runtime-rapi artifact.
• conf: provides access to the configuration registry. See Configuration

13.4.2.2 kauri:import-service

Imports a Java service (= declares a dependency on a Java service).

Syntax:

<kauri:import-service service="..." name="..." id="..."/>

Attributes:

• service: the fully qualified name of a Java interface
• name: (optional) a name for this dependency. If not specified, the value of the id attribute will be used as name. The name is useful for explicit wiring, see the wiring.xml reference.
• id: the bean name under which to make the service available in the Spring bean container.

13.4.2.3 kauri:export-service

Exports (= provides) a Java service.

Syntax:

<kauri:export-service service="..." name="..." ref="..."/>

Attributes:

• service: the fully qualified name of the Java interface (each export can make only the functionality of one Java interface available).
• name: (optional) a name for this export. If not specified, the value of the ref attribute will be used as name. The name is useful for explicit wiring, see the wiring.xml reference.
• ref: the name of the bean within the current Spring container which delivers the implementation of the exported service.

13.4.2.4 kauri:import-restservice

Imports a REST-service (= declares a dependency on a REST-service).

Syntax:

<kauri:import-restservice name="..." type="..."/>

Attributes:

• name: name of the dependency. This is also the bean name under which the service will be made available within the Spring container.
• type: (optional) a free-form string identifying the type of the service. Unlike Java services, we can't really check the type, but if a type is specified here, and this service is wired to a REST-service from another module which also specifies a type, then the types need to correspond (= the strings should be equal).

The type of the bean that will be made available is org.restlet.Restlet.

13.4.2.5 kauri:export-restservice

Exports (= provides) a REST-service.

Syntax:

<kauri:export-restservice ref="..." name="..." type="..."/>

Attributes:

• ref: name of the bean to export. The bean should be of the type org.restlet.Restlet.
• name: (optional) name for this export. Used to identify the export when wiring the services in the wiring.xml By default the same as the ref attribute.
• type: (optional) see description at kauri:import-restservice.