Various Copland services related to dealing with WEBrick servers and servlets.
A default HTTP server. This may configured via the DefaultHTTPServerConfiguration and DefaultServletList configuration points. This allows applications that only need a single WEBrick server to more easily set up that server. Applications that need multiple servers will need to define multiple service points themselves.
Implementor
A service factory for creating new WEBrick HTTP servers.
Implementor
copland/webrick/http-server-factory/Copland::WEBrick::HTTPServerFactory
Schema
servlets
[configuration]
(required)
The configuration point containing the list of servlets that should be added to this server. The configuration should conform to the ServletList schema.
setup
[configuration]
(required)
The configuration point containing the setup information for the new server. The configuration should conform to the HTTPServerConfiguration schema.
A service factory for creating new servlets that wrap existing services, and which export certain methods of those services for invocation via HTTP.
Implementor
- factory: copland.BuilderFactory
- class: copland/webrick/www-rpc-servlet-factory/Copland::WEBrick::WWWRPCServletFactory
- properties:
Schema
interface
[array]
(required)
A list of methods exported by this service.
method
[string]
(required)
The name of the method on the service.
alias
[string]
The name by which the method should be exported.
help
[string]
Arbitrary text describing this method.
parameters
[array]
The array of parameter names recognized by this interface, in the order in which they should be sent to the method.
service
[service]
(required)
The service to make available via the servlet.
This is the default point for configurating a WEBrick server. Applications may define their own configuration points and reuse the schema this point defines.
Schema
The list of servlets that should be added to a WEBrick server. This is the default configuration point. Applications may define their own and reuse the shema this point defines.
Schema
This configuration point contains all of the result handler services that will be used by the ResultHandlers service to handle data returned by RPC services. Applications may define their own handler services and contribute them to this configuration point.
Schema
service
[service]
(required)
The service to contribute. It must implement at least one method, "handle", which should accept three parameters: the data to handle, the HTTP request object, and the HTTP response object.
after
[array]
A list of handler names that this service should always be tried after.
before
[array]
A list of handler names that this service should always be tried before.
name
[string]
An optional name to assign this handler. This allows the handler to be referenced in other handlers' before and after lists.
This schema defines the format of a list of servlet mappings for a WEBrick server.