public class ServletWebServer extends WebServer
This is a subclass of the WebServer
, which offers a minimal
servlet API. It is recommended to use this class, rather than the
WebServer
, because it offers you a smooth migration path to
a full blown servlet engine.
Use of the ServletWebServer
goes like this: First of all,
create a servlet. It may be an instance of XmlRpcServlet
or
a subclass thereof. Note, that servlets are stateless: One servlet
may be used by multiple threads (aka requests) concurrently. In
other words, the servlet must not have any instance variables,
other than those which are read only after the servlets
initialization.
The XmlRpcServlet is by default using a property file named
org/apache/xmlrpc/server/webserver/XmlRpcServlet.properties
.
See the PropertyHandlerMapping
for details on the property
file.
final int port = 8088; XmlRpcServlet servlet = new XmlRpcServlet(); ServletWebServer webServer = new ServletWebServer(servlet, port); webServer.start();
Modifier and Type | Class and Description |
---|---|
static class |
ServletWebServer.Exception
This exception is thrown by the request handling classes,
advising the server, that it should return an error response.
|
accept, deny, server, serverSocket
Constructor and Description |
---|
ServletWebServer(javax.servlet.http.HttpServlet pServlet,
int pPort)
Creates a new instance, which is listening on all
local IP addresses and the given port.
|
ServletWebServer(javax.servlet.http.HttpServlet pServlet,
int pPort,
InetAddress pAddr)
Creates a new instance, which is listening on the
given IP address and the given port.
|
Modifier and Type | Method and Description |
---|---|
protected ThreadPool.Task |
newTask(WebServer pWebServer,
XmlRpcStreamServer pXmlRpcServer,
Socket pSocket) |
acceptClient, allowConnection, createServerSocket, denyClient, getPort, getXmlRpcServer, isParanoid, log, log, newThreadPool, newXmlRpcStreamServer, run, setParanoid, shutdown, start
public ServletWebServer(javax.servlet.http.HttpServlet pServlet, int pPort) throws javax.servlet.ServletException
pServlet
- The servlet, which is handling requests.pPort
- The servers port number; 0 for a random
port being choosen.javax.servlet.ServletException
- Initializing the servlet failed.public ServletWebServer(javax.servlet.http.HttpServlet pServlet, int pPort, InetAddress pAddr) throws javax.servlet.ServletException
pServlet
- The servlet, which is handling requests.pPort
- The servers port number; 0 for a random
port being choosen.pAddr
- The servers IP address.javax.servlet.ServletException
- Initializing the servlet failed.protected ThreadPool.Task newTask(WebServer pWebServer, XmlRpcStreamServer pXmlRpcServer, Socket pSocket) throws IOException
newTask
in class WebServer
IOException
Copyright © 2001–2016 The Apache Software Foundation. All rights reserved.