public interface ServletContainerAdapter
It's OK if you don't start or stop your container when this adapter is
called. You can treat the startIfNotRunning()
and
stopIfRunning()
methods as suggestions, they only indicate what
the UPnP stack wants to do. If your servlet container handles other
services, keep it running all the time.
An implementation must be thread-safe, all methods might be called concurrently by several threads.
Modifier and Type | Method and Description |
---|---|
int |
addConnector(String host,
int port)
Might be called several times to set up the connectors.
|
void |
registerServlet(String contextPath,
javax.servlet.Servlet servlet)
Might be called several times to register (the same) handler for UPnP
requests, should only register it once.
|
void |
removeConnector(String host,
int port)
Removes a previously added connector.
|
void |
setExecutorService(ExecutorService executorService)
Might be called several times to integrate the servlet container with Cling's executor
configuration.
|
void |
startIfNotRunning()
Start your servlet container if it isn't already running, might be called multiple times.
|
void |
stopIfRunning()
Stop your servlet container if it's still running, might be called multiple times.
|
void setExecutorService(ExecutorService executorService)
ExecutorService
,
make sure the Jetty container won't shut it down when stopIfRunning()
is called!executorService
- The service to use when spawning new servlet execution threads.int addConnector(String host, int port) throws IOException
host
- The host address for the socket.port
- The port, might be -1
to bind to an ephemeral port.IOException
- If the connector couldn't be opened to retrieve the registered local port.void removeConnector(String host, int port)
host
- The host address of the socket.port
- The port of the connectorvoid registerServlet(String contextPath, javax.servlet.Servlet servlet)
contextPath
- The context path prefix for all UPnP requests.servlet
- The servlet handling all UPnP requests.void startIfNotRunning()
void stopIfRunning()
Copyright © 2016 4th Line GmbH, Switzerland. All rights reserved.