WebServerExtension handles two extensions points. To register a directory in the Webserver:

<extension point="osp.web.server.directory" 
           path="URI" 
           resource="dir inside bundle" 
           allowSpecialization="none|owner|all"
           index="index.html"/>

To register a RequestHandlerFactory for a given server uri/set of uris:

<extension point="osp.web.server.requesthandler" 
           path="URI"
           class="MyRequestHandlerFactory" 
           library="MyLib"/>

Note that the extension points are automatically removed if a bundle is stopped.

The following attributes can be specified for both extension points:

• path: the URI on the server to which the resource or handler is mapped
• description: user-readable description of resource or handler
• secure: if "true", require a secure (HTTPS) connection to access the resource
• realm: specify authentication realm (together with permission)
• permission: specify the necessary access permission for this resource. HTTP Basic Authentication is used to obtain the user's user name and password, which are then checked against the specified permission using the authorization service.
• hidden: if "true", path is not included by WebServerDispatcher::listVirtualPaths()

The following attributes can be specified for "osp.web.server.directory":

• resource: specify a directory within the bundle where the HTML, image and other files are located.
• index: specify the name of the default document (defaults to "index.html").

The following attributes can be specified for "osp.web.server.requesthandler":

• class: the class name of the request handler factory.
• library: the name of the shared library containing the request handler factory.

Creates the WebServerExtension. Expects a not null pointer to the Web which must be valid during the whole life-time of the extension object

Destroys the WebServerExtension.

See also: Poco::OSP::ExtensionPoint::handleExtension()

When a bundle is stopped, all of its request handlers and mappings are automatically disabled.