org.ops4j.pax.web.service.spi.model

Interface ModelRegistrationTask<T>

Type Parameters:

T - task can run a value, which can also be of type Void.

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ModelRegistrationTask<T>

A task that can be passed to ServerModel#run(ModelRegistrationTask) to ensure running it in single threaded "configuration/registration" event loop.

Method Summary

Modifier and Type	Method and Description
T	run() Run a task on behalf of WebContainer implementations, where we better ensure synchronous manipulation of internal Pax Web model and invocation of ServerController

Method Detail

run

T run()
throws javax.servlet.ServletException,
      org.osgi.service.http.NamespaceException,
      IllegalArgumentException,
      IllegalStateException

Run a task on behalf of WebContainer implementations, where we better ensure synchronous manipulation of internal Pax Web model and invocation of ServerController

When all such tasks are ensured to be run in single configuration thread, we can make the code much easier and avoid any locking/synchronization mechanism.

Task can throw any API exception and will be handled correctly even across thread boundaries.

Returns:

Throws:

javax.servlet.ServletException

org.osgi.service.http.NamespaceException

IllegalArgumentException

IllegalStateException