/lib/docs/org/apache/xmlrpc/webserver/WebServer.html

http://mp-rechnungs-und-kundenverwaltung.googlecode.com/ · HTML · 820 lines · 716 code · 80 blank · 24 comment · 0 complexity · fe08bc6ddcfd6d94c5febb653d942bbe MD5 · raw file 

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <!--NewPage-->
    3. 

  3. <HTML>
    4. 

  4. <HEAD>
    5. 

  5. <!-- Generated by javadoc (build 1.6.0_0) on Mon Apr 20 21:45:59 CEST 2009 -->
    6. 

  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
    7. 

  7. <TITLE>
    8. 

  8. WebServer (Apache XML-RPC 3.1.2 API)
    9. 

  9. </TITLE>
    10. 

  10. 

  11. <META NAME="date" CONTENT="2009-04-20">
    12. 

  12. 

  13. <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
    14. 

  14. 

  15. <SCRIPT type="text/javascript">
    16. 

  16. function windowTitle()
    17. 

  17. {
    18. 

  18.     if (location.href.indexOf('is-external=true') == -1) {
    19. 

  19.         parent.document.title="WebServer (Apache XML-RPC 3.1.2 API)";
    20. 

  20.     }
    21. 

  21. }
    22. 

  22. </SCRIPT>
    23. 

  23. <NOSCRIPT>
    24. 

  24. </NOSCRIPT>
    25. 

  25. 

  26. </HEAD>
    27. 

  27. 

  28. <BODY BGCOLOR="white" onload="windowTitle();">
    29. 

  29. <HR>
    30. 

  30. 

  31. 

  32. <!-- ========= START OF TOP NAVBAR ======= -->
    33. 

  33. <A NAME="navbar_top"><!-- --></A>
    34. 

  34. <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
    35. 

  35. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
    36. 

  36. <TR>
    37. 

  37. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
    38. 

  38. <A NAME="navbar_top_firstrow"><!-- --></A>
    39. 

  39. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
    40. 

  40.   <TR ALIGN="center" VALIGN="top">
    41. 

  41.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    42. 

  42.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    43. 

  43.   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    44. 

  44.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/WebServer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    45. 

  45.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    46. 

  46.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    47. 

  47.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    48. 

  48.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    49. 

  49.   </TR>
    50. 

  50. </TABLE>
    51. 

  51. </TD>
    52. 

  52. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
    53. 

  53. </EM>
    54. 

  54. </TD>
    55. 

  55. </TR>
    56. 

  56. 

  57. <TR>
    58. 

  58. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    59. 

  59. &nbsp;<A HREF="../../../../org/apache/xmlrpc/webserver/ServletWebServer.Exception.html" title="class in org.apache.xmlrpc.webserver"><B>PREV CLASS</B></A>&nbsp;
    60. 

  60. &nbsp;<A HREF="../../../../org/apache/xmlrpc/webserver/XmlRpcServlet.html" title="class in org.apache.xmlrpc.webserver"><B>NEXT CLASS</B></A></FONT></TD>
    61. 

  61. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    62. 

  62.   <A HREF="../../../../index.html?org/apache/xmlrpc/webserver/WebServer.html" target="_top"><B>FRAMES</B></A>  &nbsp;
    63. 

  63. &nbsp;<A HREF="WebServer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
    64. 

  64. &nbsp;<SCRIPT type="text/javascript">
    65. 

  65.   <!--
    66. 

  66.   if(window==top) {
    67. 

  67.     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
    68. 

  68.   }
    69. 

  69.   //-->
    70. 

  70. </SCRIPT>
    71. 

  71. <NOSCRIPT>
    72. 

  72.   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
    73. 

  73. </NOSCRIPT>
    74. 

  74. 

  75. 

  76. </FONT></TD>
    77. 

  77. </TR>
    78. 

  78. <TR>
    79. 

  79. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    80. 

  80.   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
    81. 

  81. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    82. 

  82. DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
    83. 

  83. </TR>
    84. 

  84. </TABLE>
    85. 

  85. <A NAME="skip-navbar_top"></A>
    86. 

  86. <!-- ========= END OF TOP NAVBAR ========= -->
    87. 

  87. 

  88. <HR>
    89. 

  89. <!-- ======== START OF CLASS DATA ======== -->
    90. 

  90. <H2>
    91. 

  91. <FONT SIZE="-1">
    92. 

  92. org.apache.xmlrpc.webserver</FONT>
    93. 

  93. <BR>
    94. 

  94. Class WebServer</H2>
    95. 

  95. <PRE>
    96. 

  96. java.lang.Object
    97. 

  97.   <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>org.apache.xmlrpc.webserver.WebServer</B>
    98. 

  98. </PRE>
    99. 

  99. <DL>
    100. 

  100. <DT><B>All Implemented Interfaces:</B> <DD>java.lang.Runnable</DD>
    101. 

  101. </DL>
    102. 

  102. <DL>
    103. 

  103. <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../../org/apache/xmlrpc/webserver/ServletWebServer.html" title="class in org.apache.xmlrpc.webserver">ServletWebServer</A></DD>
    104. 

  104. </DL>
    105. 

  105. <HR>
    106. 

  106. <DL>
    107. 

  107. <DT><PRE>public class <B>WebServer</B><DT>extends java.lang.Object<DT>implements java.lang.Runnable</DL>
    108. 

  108. </PRE>
    109. 

  109. 

  110. <P>
    111. 

  111. <p>The <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>WebServer</CODE></A> is a minimal HTTP server, that might be used
    112. 

  112.  as an embedded web server.</p>
    113. 

  113.  <p>Use of the <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>WebServer</CODE></A> has grown very popular amongst users
    114. 

  114.  of Apache XML-RPC. Why this is the case, can hardly be explained,
    115. 

  115.  because the <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>WebServer</CODE></A> is at best a workaround, compared to
    116. 

  116.  full blown servlet engines like Tomcat or Jetty. For example, under
    117. 

  117.  heavy load it will almost definitely be slower than a real servlet
    118. 

  118.  engine, because it does neither support proper keepalive (multiple
    119. 

  119.  requests per physical connection) nor chunked mode (in other words,
    120. 

  120.  it cannot stream requests).</p>
    121. 

  121.  <p>If you still insist in using the <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>WebServer</CODE></A>, it is
    122. 

  122.  recommended to use its subclass, the <A HREF="../../../../org/apache/xmlrpc/webserver/ServletWebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>ServletWebServer</CODE></A> instead,
    123. 

  123.  which offers a minimal subset of the servlet API. In other words,
    124. 

  124.  you keep yourself the option to migrate to a real servlet engine
    125. 

  125.  later.</p>
    126. 

  126.  <p>Use of the <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver"><CODE>WebServer</CODE></A> goes roughly like this: First of all,
    127. 

  127.  create a property file (for example "MyHandlers.properties") and
    128. 

  128.  add it to your jar file. The property keys are handler names and
    129. 

  129.  the property values are the handler classes. Once that is done,
    130. 

  130.  create an instance of WebServer:
    131. 

  131.  <pre>
    132. 

  132.    final int port = 8088;
    133. 

  133.    final String propertyFile = "MyHandler.properties";
    134. 

  134. 

  135.    PropertyHandlerMapping mapping = new PropertyHandlerMapping();
    136. 

  136.    ClassLoader cl = Thread.currentThread().getContextClassLoader();
    137. 

  137.    mapping.load(cl, propertyFile);
    138. 

  138.    WebServer webServer = new WebServer(port);
    139. 

  139.    XmlRpcServerConfigImpl config = new XmlRpcServerConfigImpl();
    140. 

  140.    XmlRpcServer server = webServer.getXmlRpcServer();
    141. 

  141.    server.setConfig(config);
    142. 

  142.    server.setHandlerMapping(mapping);
    143. 

  143.    webServer.start();
    144. 

  144.  </pre>
    145. 

  145. <P>
    146. 

  146. 

  147. <P>
    148. 

  148. <HR>
    149. 

  149. 

  150. <P>
    151. 

  151. <!-- =========== FIELD SUMMARY =========== -->
    152. 

  152. 

  153. <A NAME="field_summary"><!-- --></A>
    154. 

  154. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    155. 

  155. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    156. 

  156. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
    157. 

  157. <B>Field Summary</B></FONT></TH>
    158. 

  158. </TR>
    159. 

  159. <TR BGCOLOR="white" CLASS="TableRowColor">
    160. 

  160. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    161. 

  161. <CODE>protected &nbsp;java.util.List</CODE></FONT></TD>
    162. 

  162. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#accept">accept</A></B></CODE>
    163. 

  163. 

  164. <BR>
    165. 

  165. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    166. 

  166. </TR>
    167. 

  167. <TR BGCOLOR="white" CLASS="TableRowColor">
    168. 

  168. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    169. 

  169. <CODE>protected &nbsp;java.util.List</CODE></FONT></TD>
    170. 

  170. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#deny">deny</A></B></CODE>
    171. 

  171. 

  172. <BR>
    173. 

  173. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    174. 

  174. </TR>
    175. 

  175. <TR BGCOLOR="white" CLASS="TableRowColor">
    176. 

  176. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    177. 

  177. <CODE>protected &nbsp;<A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A></CODE></FONT></TD>
    178. 

  178. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#server">server</A></B></CODE>
    179. 

  179. 

  180. <BR>
    181. 

  181. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    182. 

  182. </TR>
    183. 

  183. <TR BGCOLOR="white" CLASS="TableRowColor">
    184. 

  184. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    185. 

  185. <CODE>protected &nbsp;java.net.ServerSocket</CODE></FONT></TD>
    186. 

  186. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#serverSocket">serverSocket</A></B></CODE>
    187. 

  187. 

  188. <BR>
    189. 

  189. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    190. 

  190. </TR>
    191. 

  191. </TABLE>
    192. 

  192. &nbsp;
    193. 

  193. <!-- ======== CONSTRUCTOR SUMMARY ======== -->
    194. 

  194. 

  195. <A NAME="constructor_summary"><!-- --></A>
    196. 

  196. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    197. 

  197. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    198. 

  198. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
    199. 

  199. <B>Constructor Summary</B></FONT></TH>
    200. 

  200. </TR>
    201. 

  201. <TR BGCOLOR="white" CLASS="TableRowColor">
    202. 

  202. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#WebServer(int)">WebServer</A></B>(int&nbsp;pPort)</CODE>
    203. 

  203. 

  204. <BR>
    205. 

  205. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a web server at the specified port number.</TD>
    206. 

  206. </TR>
    207. 

  207. <TR BGCOLOR="white" CLASS="TableRowColor">
    208. 

  208. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#WebServer(int, java.net.InetAddress)">WebServer</A></B>(int&nbsp;pPort,
    209. 

  209.           java.net.InetAddress&nbsp;pAddr)</CODE>
    210. 

  210. 

  211. <BR>
    212. 

  212. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a web server at the specified port number and IP address.</TD>
    213. 

  213. </TR>
    214. 

  214. </TABLE>
    215. 

  215. &nbsp;
    216. 

  216. <!-- ========== METHOD SUMMARY =========== -->
    217. 

  217. 

  218. <A NAME="method_summary"><!-- --></A>
    219. 

  219. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    220. 

  220. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    221. 

  221. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
    222. 

  222. <B>Method Summary</B></FONT></TH>
    223. 

  223. </TR>
    224. 

  224. <TR BGCOLOR="white" CLASS="TableRowColor">
    225. 

  225. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    226. 

  226. <CODE>&nbsp;void</CODE></FONT></TD>
    227. 

  227. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#acceptClient(java.lang.String)">acceptClient</A></B>(java.lang.String&nbsp;pAddress)</CODE>
    228. 

  228. 

  229. <BR>
    230. 

  230. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add an IP address to the list of accepted clients.</TD>
    231. 

  231. </TR>
    232. 

  232. <TR BGCOLOR="white" CLASS="TableRowColor">
    233. 

  233. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    234. 

  234. <CODE>protected &nbsp;boolean</CODE></FONT></TD>
    235. 

  235. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#allowConnection(java.net.Socket)">allowConnection</A></B>(java.net.Socket&nbsp;s)</CODE>
    236. 

  236. 

  237. <BR>
    238. 

  238. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Checks incoming connections to see if they should be allowed.</TD>
    239. 

  239. </TR>
    240. 

  240. <TR BGCOLOR="white" CLASS="TableRowColor">
    241. 

  241. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    242. 

  242. <CODE>protected &nbsp;java.net.ServerSocket</CODE></FONT></TD>
    243. 

  243. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#createServerSocket(int, int, java.net.InetAddress)">createServerSocket</A></B>(int&nbsp;pPort,
    244. 

  244.                    int&nbsp;backlog,
    245. 

  245.                    java.net.InetAddress&nbsp;addr)</CODE>
    246. 

  246. 

  247. <BR>
    248. 

  248. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Factory method to manufacture the server socket.</TD>
    249. 

  249. </TR>
    250. 

  250. <TR BGCOLOR="white" CLASS="TableRowColor">
    251. 

  251. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    252. 

  252. <CODE>&nbsp;void</CODE></FONT></TD>
    253. 

  253. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#denyClient(java.lang.String)">denyClient</A></B>(java.lang.String&nbsp;pAddress)</CODE>
    254. 

  254. 

  255. <BR>
    256. 

  256. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add an IP address to the list of denied clients.</TD>
    257. 

  257. </TR>
    258. 

  258. <TR BGCOLOR="white" CLASS="TableRowColor">
    259. 

  259. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    260. 

  260. <CODE>&nbsp;int</CODE></FONT></TD>
    261. 

  261. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#getPort()">getPort</A></B>()</CODE>
    262. 

  262. 

  263. <BR>
    264. 

  264. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the port, on which the web server is running.</TD>
    265. 

  265. </TR>
    266. 

  266. <TR BGCOLOR="white" CLASS="TableRowColor">
    267. 

  267. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    268. 

  268. <CODE>&nbsp;<A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A></CODE></FONT></TD>
    269. 

  269. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#getXmlRpcServer()">getXmlRpcServer</A></B>()</CODE>
    270. 

  270. 

  271. <BR>
    272. 

  272. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcServer.html" title="class in org.apache.xmlrpc.server"><CODE>XmlRpcServer</CODE></A>.</TD>
    273. 

  273. </TR>
    274. 

  274. <TR BGCOLOR="white" CLASS="TableRowColor">
    275. 

  275. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    276. 

  276. <CODE>protected &nbsp;boolean</CODE></FONT></TD>
    277. 

  277. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#isParanoid()">isParanoid</A></B>()</CODE>
    278. 

  278. 

  279. <BR>
    280. 

  280. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the client filtering state.</TD>
    281. 

  281. </TR>
    282. 

  282. <TR BGCOLOR="white" CLASS="TableRowColor">
    283. 

  283. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    284. 

  284. <CODE>&nbsp;void</CODE></FONT></TD>
    285. 

  285. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#log(java.lang.String)">log</A></B>(java.lang.String&nbsp;pMessage)</CODE>
    286. 

  286. 

  287. <BR>
    288. 

  288. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Logs a message.</TD>
    289. 

  289. </TR>
    290. 

  290. <TR BGCOLOR="white" CLASS="TableRowColor">
    291. 

  291. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    292. 

  292. <CODE>&nbsp;void</CODE></FONT></TD>
    293. 

  293. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#log(java.lang.Throwable)">log</A></B>(java.lang.Throwable&nbsp;pError)</CODE>
    294. 

  294. 

  295. <BR>
    296. 

  296. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Logs an error.</TD>
    297. 

  297. </TR>
    298. 

  298. <TR BGCOLOR="white" CLASS="TableRowColor">
    299. 

  299. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    300. 

  300. <CODE>protected &nbsp;<A HREF="../../../../org/apache/xmlrpc/util/ThreadPool.Task.html" title="interface in org.apache.xmlrpc.util">ThreadPool.Task</A></CODE></FONT></TD>
    301. 

  301. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#newTask(org.apache.xmlrpc.webserver.WebServer, org.apache.xmlrpc.server.XmlRpcStreamServer, java.net.Socket)">newTask</A></B>(<A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver">WebServer</A>&nbsp;pServer,
    302. 

  302.         <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A>&nbsp;pXmlRpcServer,
    303. 

  303.         java.net.Socket&nbsp;pSocket)</CODE>
    304. 

  304. 

  305. <BR>
    306. 

  306. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    307. 

  307. </TR>
    308. 

  308. <TR BGCOLOR="white" CLASS="TableRowColor">
    309. 

  309. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    310. 

  310. <CODE>protected &nbsp;<A HREF="../../../../org/apache/xmlrpc/util/ThreadPool.html" title="class in org.apache.xmlrpc.util">ThreadPool</A></CODE></FONT></TD>
    311. 

  311. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#newThreadPool()">newThreadPool</A></B>()</CODE>
    312. 

  312. 

  313. <BR>
    314. 

  314. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    315. 

  315. </TR>
    316. 

  316. <TR BGCOLOR="white" CLASS="TableRowColor">
    317. 

  317. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    318. 

  318. <CODE>protected &nbsp;<A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A></CODE></FONT></TD>
    319. 

  319. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#newXmlRpcStreamServer()">newXmlRpcStreamServer</A></B>()</CODE>
    320. 

  320. 

  321. <BR>
    322. 

  322. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
    323. 

  323. </TR>
    324. 

  324. <TR BGCOLOR="white" CLASS="TableRowColor">
    325. 

  325. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    326. 

  326. <CODE>&nbsp;void</CODE></FONT></TD>
    327. 

  327. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#run()">run</A></B>()</CODE>
    328. 

  328. 

  329. <BR>
    330. 

  330. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Listens for client requests until stopped.</TD>
    331. 

  331. </TR>
    332. 

  332. <TR BGCOLOR="white" CLASS="TableRowColor">
    333. 

  333. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    334. 

  334. <CODE>&nbsp;void</CODE></FONT></TD>
    335. 

  335. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#setParanoid(boolean)">setParanoid</A></B>(boolean&nbsp;pParanoid)</CODE>
    336. 

  336. 

  337. <BR>
    338. 

  338. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Switch client filtering on/off.</TD>
    339. 

  339. </TR>
    340. 

  340. <TR BGCOLOR="white" CLASS="TableRowColor">
    341. 

  341. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    342. 

  342. <CODE>&nbsp;void</CODE></FONT></TD>
    343. 

  343. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#shutdown()">shutdown</A></B>()</CODE>
    344. 

  344. 

  345. <BR>
    346. 

  346. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stop listening on the server port.</TD>
    347. 

  347. </TR>
    348. 

  348. <TR BGCOLOR="white" CLASS="TableRowColor">
    349. 

  349. <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    350. 

  350. <CODE>&nbsp;void</CODE></FONT></TD>
    351. 

  351. <TD><CODE><B><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#start()">start</A></B>()</CODE>
    352. 

  352. 

  353. <BR>
    354. 

  354. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Spawns a new thread which binds this server to the port it's
    355. 

  355.  configured to accept connections on.</TD>
    356. 

  356. </TR>
    357. 

  357. </TABLE>
    358. 

  358. &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
    359. 

  359. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    360. 

  360. <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
    361. 

  361. <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
    362. 

  362. </TR>
    363. 

  363. <TR BGCOLOR="white" CLASS="TableRowColor">
    364. 

  364. <TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
    365. 

  365. </TR>
    366. 

  366. </TABLE>
    367. 

  367. &nbsp;
    368. 

  368. <P>
    369. 

  369. 

  370. <!-- ============ FIELD DETAIL =========== -->
    371. 

  371. 

  372. <A NAME="field_detail"><!-- --></A>
    373. 

  373. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    374. 

  374. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    375. 

  375. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
    376. 

  376. <B>Field Detail</B></FONT></TH>
    377. 

  377. </TR>
    378. 

  378. </TABLE>
    379. 

  379. 

  380. <A NAME="serverSocket"><!-- --></A><H3>
    381. 

  381. serverSocket</H3>
    382. 

  382. <PRE>
    383. 

  383. protected java.net.ServerSocket <B>serverSocket</B></PRE>
    384. 

  384. <DL>
    385. 

  385. <DL>
    386. 

  386. </DL>
    387. 

  387. </DL>
    388. 

  388. <HR>
    389. 

  389. 

  390. <A NAME="accept"><!-- --></A><H3>
    391. 

  391. accept</H3>
    392. 

  392. <PRE>
    393. 

  393. protected final java.util.List <B>accept</B></PRE>
    394. 

  394. <DL>
    395. 

  395. <DL>
    396. 

  396. </DL>
    397. 

  397. </DL>
    398. 

  398. <HR>
    399. 

  399. 

  400. <A NAME="deny"><!-- --></A><H3>
    401. 

  401. deny</H3>
    402. 

  402. <PRE>
    403. 

  403. protected final java.util.List <B>deny</B></PRE>
    404. 

  404. <DL>
    405. 

  405. <DL>
    406. 

  406. </DL>
    407. 

  407. </DL>
    408. 

  408. <HR>
    409. 

  409. 

  410. <A NAME="server"><!-- --></A><H3>
    411. 

  411. server</H3>
    412. 

  412. <PRE>
    413. 

  413. protected final <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A> <B>server</B></PRE>
    414. 

  414. <DL>
    415. 

  415. <DL>
    416. 

  416. </DL>
    417. 

  417. </DL>
    418. 

  418. 

  419. <!-- ========= CONSTRUCTOR DETAIL ======== -->
    420. 

  420. 

  421. <A NAME="constructor_detail"><!-- --></A>
    422. 

  422. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    423. 

  423. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    424. 

  424. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
    425. 

  425. <B>Constructor Detail</B></FONT></TH>
    426. 

  426. </TR>
    427. 

  427. </TABLE>
    428. 

  428. 

  429. <A NAME="WebServer(int)"><!-- --></A><H3>
    430. 

  430. WebServer</H3>
    431. 

  431. <PRE>
    432. 

  432. public <B>WebServer</B>(int&nbsp;pPort)</PRE>
    433. 

  433. <DL>
    434. 

  434. <DD>Creates a web server at the specified port number.
    435. 

  435. <P>
    436. 

  436. <DL>
    437. 

  437. <DT><B>Parameters:</B><DD><CODE>pPort</CODE> - Port number; 0 for a random port, choosen by the
    438. 

  438.  operating system.</DL>
    439. 

  439. </DL>
    440. 

  440. <HR>
    441. 

  441. 

  442. <A NAME="WebServer(int, java.net.InetAddress)"><!-- --></A><H3>
    443. 

  443. WebServer</H3>
    444. 

  444. <PRE>
    445. 

  445. public <B>WebServer</B>(int&nbsp;pPort,
    446. 

  446.                  java.net.InetAddress&nbsp;pAddr)</PRE>
    447. 

  447. <DL>
    448. 

  448. <DD>Creates a web server at the specified port number and IP address.
    449. 

  449. <P>
    450. 

  450. <DL>
    451. 

  451. <DT><B>Parameters:</B><DD><CODE>pPort</CODE> - Port number; 0 for a random port, choosen by the
    452. 

  452.  operating system.<DD><CODE>pAddr</CODE> - Local IP address; null for all available IP addresses.</DL>
    453. 

  453. </DL>
    454. 

  454. 

  455. <!-- ============ METHOD DETAIL ========== -->
    456. 

  456. 

  457. <A NAME="method_detail"><!-- --></A>
    458. 

  458. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    459. 

  459. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    460. 

  460. <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
    461. 

  461. <B>Method Detail</B></FONT></TH>
    462. 

  462. </TR>
    463. 

  463. </TABLE>
    464. 

  464. 

  465. <A NAME="newXmlRpcStreamServer()"><!-- --></A><H3>
    466. 

  466. newXmlRpcStreamServer</H3>
    467. 

  467. <PRE>
    468. 

  468. protected <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A> <B>newXmlRpcStreamServer</B>()</PRE>
    469. 

  469. <DL>
    470. 

  470. <DD><DL>
    471. 

  471. </DL>
    472. 

  472. </DD>
    473. 

  473. <DD><DL>
    474. 

  474. </DL>
    475. 

  475. </DD>
    476. 

  476. </DL>
    477. 

  477. <HR>
    478. 

  478. 

  479. <A NAME="createServerSocket(int, int, java.net.InetAddress)"><!-- --></A><H3>
    480. 

  480. createServerSocket</H3>
    481. 

  481. <PRE>
    482. 

  482. protected java.net.ServerSocket <B>createServerSocket</B>(int&nbsp;pPort,
    483. 

  483.                                                    int&nbsp;backlog,
    484. 

  484.                                                    java.net.InetAddress&nbsp;addr)
    485. 

  485.                                             throws java.io.IOException</PRE>
    486. 

  486. <DL>
    487. 

  487. <DD>Factory method to manufacture the server socket.  Useful as a
    488. 

  488.  hook method for subclasses to override when they desire
    489. 

  489.  different flavor of socket (i.e. a <code>SSLServerSocket</code>).
    490. 

  490. <P>
    491. 

  491. <DD><DL>
    492. 

  492. </DL>
    493. 

  493. </DD>
    494. 

  494. <DD><DL>
    495. 

  495. <DT><B>Parameters:</B><DD><CODE>pPort</CODE> - Port number; 0 for a random port, choosen by the operating
    496. 

  496.  system.<DD><CODE>backlog</CODE> - <DD><CODE>addr</CODE> - If <code>null</code>, binds to
    497. 

  497.  <code>INADDR_ANY</code>, meaning that all network interfaces on
    498. 

  498.  a multi-homed host will be listening.
    499. 

  499. <DT><B>Throws:</B>
    500. 

  500. <DD><CODE>java.io.IOException</CODE> - Error creating listener socket.</DL>
    501. 

  501. </DD>
    502. 

  502. </DL>
    503. 

  503. <HR>
    504. 

  504. 

  505. <A NAME="start()"><!-- --></A><H3>
    506. 

  506. start</H3>
    507. 

  507. <PRE>
    508. 

  508. public void <B>start</B>()
    509. 

  509.            throws java.io.IOException</PRE>
    510. 

  510. <DL>
    511. 

  511. <DD>Spawns a new thread which binds this server to the port it's
    512. 

  512.  configured to accept connections on.
    513. 

  513. <P>
    514. 

  514. <DD><DL>
    515. 

  515. </DL>
    516. 

  516. </DD>
    517. 

  517. <DD><DL>
    518. 

  518. 

  519. <DT><B>Throws:</B>
    520. 

  520. <DD><CODE>java.io.IOException</CODE> - Binding the server socket failed.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#run()"><CODE>run()</CODE></A></DL>
    521. 

  521. </DD>
    522. 

  522. </DL>
    523. 

  523. <HR>
    524. 

  524. 

  525. <A NAME="setParanoid(boolean)"><!-- --></A><H3>
    526. 

  526. setParanoid</H3>
    527. 

  527. <PRE>
    528. 

  528. public void <B>setParanoid</B>(boolean&nbsp;pParanoid)</PRE>
    529. 

  529. <DL>
    530. 

  530. <DD>Switch client filtering on/off.
    531. 

  531. <P>
    532. 

  532. <DD><DL>
    533. 

  533. </DL>
    534. 

  534. </DD>
    535. 

  535. <DD><DL>
    536. 

  536. <DT><B>Parameters:</B><DD><CODE>pParanoid</CODE> - True to enable filtering, false otherwise.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#acceptClient(java.lang.String)"><CODE>acceptClient(java.lang.String)</CODE></A>, 
    537. 

  537. <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#denyClient(java.lang.String)"><CODE>denyClient(java.lang.String)</CODE></A></DL>
    538. 

  538. </DD>
    539. 

  539. </DL>
    540. 

  540. <HR>
    541. 

  541. 

  542. <A NAME="isParanoid()"><!-- --></A><H3>
    543. 

  543. isParanoid</H3>
    544. 

  544. <PRE>
    545. 

  545. protected boolean <B>isParanoid</B>()</PRE>
    546. 

  546. <DL>
    547. 

  547. <DD>Returns the client filtering state.
    548. 

  548. <P>
    549. 

  549. <DD><DL>
    550. 

  550. </DL>
    551. 

  551. </DD>
    552. 

  552. <DD><DL>
    553. 

  553. 

  554. <DT><B>Returns:</B><DD>True, if client filtering is enabled, false otherwise.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#acceptClient(java.lang.String)"><CODE>acceptClient(java.lang.String)</CODE></A>, 
    555. 

  555. <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#denyClient(java.lang.String)"><CODE>denyClient(java.lang.String)</CODE></A></DL>
    556. 

  556. </DD>
    557. 

  557. </DL>
    558. 

  558. <HR>
    559. 

  559. 

  560. <A NAME="acceptClient(java.lang.String)"><!-- --></A><H3>
    561. 

  561. acceptClient</H3>
    562. 

  562. <PRE>
    563. 

  563. public void <B>acceptClient</B>(java.lang.String&nbsp;pAddress)</PRE>
    564. 

  564. <DL>
    565. 

  565. <DD>Add an IP address to the list of accepted clients. The parameter can
    566. 

  566.  contain '*' as wildcard character, e.g. "192.168.*.*". You must call
    567. 

  567.  setParanoid(true) in order for this to have any effect.
    568. 

  568. <P>
    569. 

  569. <DD><DL>
    570. 

  570. </DL>
    571. 

  571. </DD>
    572. 

  572. <DD><DL>
    573. 

  573. <DT><B>Parameters:</B><DD><CODE>pAddress</CODE> - The IP address being enabled.
    574. 

  574. <DT><B>Throws:</B>
    575. 

  575. <DD><CODE>java.lang.IllegalArgumentException</CODE> - Parsing the address failed.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#denyClient(java.lang.String)"><CODE>denyClient(java.lang.String)</CODE></A>, 
    576. 

  576. <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#setParanoid(boolean)"><CODE>setParanoid(boolean)</CODE></A></DL>
    577. 

  577. </DD>
    578. 

  578. </DL>
    579. 

  579. <HR>
    580. 

  580. 

  581. <A NAME="denyClient(java.lang.String)"><!-- --></A><H3>
    582. 

  582. denyClient</H3>
    583. 

  583. <PRE>
    584. 

  584. public void <B>denyClient</B>(java.lang.String&nbsp;pAddress)</PRE>
    585. 

  585. <DL>
    586. 

  586. <DD>Add an IP address to the list of denied clients. The parameter can
    587. 

  587.  contain '*' as wildcard character, e.g. "192.168.*.*". You must call
    588. 

  588.  setParanoid(true) in order for this to have any effect.
    589. 

  589. <P>
    590. 

  590. <DD><DL>
    591. 

  591. </DL>
    592. 

  592. </DD>
    593. 

  593. <DD><DL>
    594. 

  594. <DT><B>Parameters:</B><DD><CODE>pAddress</CODE> - The IP address being disabled.
    595. 

  595. <DT><B>Throws:</B>
    596. 

  596. <DD><CODE>java.lang.IllegalArgumentException</CODE> - Parsing the address failed.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#acceptClient(java.lang.String)"><CODE>acceptClient(java.lang.String)</CODE></A>, 
    597. 

  597. <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#setParanoid(boolean)"><CODE>setParanoid(boolean)</CODE></A></DL>
    598. 

  598. </DD>
    599. 

  599. </DL>
    600. 

  600. <HR>
    601. 

  601. 

  602. <A NAME="allowConnection(java.net.Socket)"><!-- --></A><H3>
    603. 

  603. allowConnection</H3>
    604. 

  604. <PRE>
    605. 

  605. protected boolean <B>allowConnection</B>(java.net.Socket&nbsp;s)</PRE>
    606. 

  606. <DL>
    607. 

  607. <DD>Checks incoming connections to see if they should be allowed.
    608. 

  608.  If not in paranoid mode, always returns true.
    609. 

  609. <P>
    610. 

  610. <DD><DL>
    611. 

  611. </DL>
    612. 

  612. </DD>
    613. 

  613. <DD><DL>
    614. 

  614. <DT><B>Parameters:</B><DD><CODE>s</CODE> - The socket to inspect.
    615. 

  615. <DT><B>Returns:</B><DD>Whether the connection should be allowed.</DL>
    616. 

  616. </DD>
    617. 

  617. </DL>
    618. 

  618. <HR>
    619. 

  619. 

  620. <A NAME="newTask(org.apache.xmlrpc.webserver.WebServer, org.apache.xmlrpc.server.XmlRpcStreamServer, java.net.Socket)"><!-- --></A><H3>
    621. 

  621. newTask</H3>
    622. 

  622. <PRE>
    623. 

  623. protected <A HREF="../../../../org/apache/xmlrpc/util/ThreadPool.Task.html" title="interface in org.apache.xmlrpc.util">ThreadPool.Task</A> <B>newTask</B>(<A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html" title="class in org.apache.xmlrpc.webserver">WebServer</A>&nbsp;pServer,
    624. 

  624.                                   <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A>&nbsp;pXmlRpcServer,
    625. 

  625.                                   java.net.Socket&nbsp;pSocket)
    626. 

  626.                            throws java.io.IOException</PRE>
    627. 

  627. <DL>
    628. 

  628. <DD><DL>
    629. 

  629. </DL>
    630. 

  630. </DD>
    631. 

  631. <DD><DL>
    632. 

  632. 

  633. <DT><B>Throws:</B>
    634. 

  634. <DD><CODE>java.io.IOException</CODE></DL>
    635. 

  635. </DD>
    636. 

  636. </DL>
    637. 

  637. <HR>
    638. 

  638. 

  639. <A NAME="run()"><!-- --></A><H3>
    640. 

  640. run</H3>
    641. 

  641. <PRE>
    642. 

  642. public void <B>run</B>()</PRE>
    643. 

  643. <DL>
    644. 

  644. <DD>Listens for client requests until stopped.  Call <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#start()"><CODE>start()</CODE></A> to invoke this method, and <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#shutdown()"><CODE>shutdown()</CODE></A> to
    645. 

  645.  break out of it.
    646. 

  646. <P>
    647. 

  647. <DD><DL>
    648. 

  648. <DT><B>Specified by:</B><DD><CODE>run</CODE> in interface <CODE>java.lang.Runnable</CODE></DL>
    649. 

  649. </DD>
    650. 

  650. <DD><DL>
    651. 

  651. 

  652. <DT><B>Throws:</B>
    653. 

  653. <DD><CODE>java.lang.RuntimeException</CODE> - Generally caused by either an
    654. 

  654.  <code>UnknownHostException</code> or <code>BindException</code>
    655. 

  655.  with the vanilla web server.<DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#start()"><CODE>start()</CODE></A>, 
    656. 

  656. <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#shutdown()"><CODE>shutdown()</CODE></A></DL>
    657. 

  657. </DD>
    658. 

  658. </DL>
    659. 

  659. <HR>
    660. 

  660. 

  661. <A NAME="newThreadPool()"><!-- --></A><H3>
    662. 

  662. newThreadPool</H3>
    663. 

  663. <PRE>
    664. 

  664. protected <A HREF="../../../../org/apache/xmlrpc/util/ThreadPool.html" title="class in org.apache.xmlrpc.util">ThreadPool</A> <B>newThreadPool</B>()</PRE>
    665. 

  665. <DL>
    666. 

  666. <DD><DL>
    667. 

  667. </DL>
    668. 

  668. </DD>
    669. 

  669. <DD><DL>
    670. 

  670. </DL>
    671. 

  671. </DD>
    672. 

  672. </DL>
    673. 

  673. <HR>
    674. 

  674. 

  675. <A NAME="shutdown()"><!-- --></A><H3>
    676. 

  676. shutdown</H3>
    677. 

  677. <PRE>
    678. 

  678. public void <B>shutdown</B>()</PRE>
    679. 

  679. <DL>
    680. 

  680. <DD>Stop listening on the server port.  Shutting down our <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#listener"><CODE>listener</CODE></A> effectively breaks it out of its <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#run()"><CODE>run()</CODE></A>
    681. 

  681.  loop.
    682. 

  682. <P>
    683. 

  683. <DD><DL>
    684. 

  684. </DL>
    685. 

  685. </DD>
    686. 

  686. <DD><DL>
    687. 

  687. <DT><B>See Also:</B><DD><A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#run()"><CODE>run()</CODE></A></DL>
    688. 

  688. </DD>
    689. 

  689. </DL>
    690. 

  690. <HR>
    691. 

  691. 

  692. <A NAME="getPort()"><!-- --></A><H3>
    693. 

  693. getPort</H3>
    694. 

  694. <PRE>
    695. 

  695. public int <B>getPort</B>()</PRE>
    696. 

  696. <DL>
    697. 

  697. <DD>Returns the port, on which the web server is running.
    698. 

  698.  This method may be invoked after <A HREF="../../../../org/apache/xmlrpc/webserver/WebServer.html#start()"><CODE>start()</CODE></A> only.
    699. 

  699. <P>
    700. 

  700. <DD><DL>
    701. 

  701. </DL>
    702. 

  702. </DD>
    703. 

  703. <DD><DL>
    704. 

  704. 

  705. <DT><B>Returns:</B><DD>Servers port number</DL>
    706. 

  706. </DD>
    707. 

  707. </DL>
    708. 

  708. <HR>
    709. 

  709. 

  710. <A NAME="log(java.lang.Throwable)"><!-- --></A><H3>
    711. 

  711. log</H3>
    712. 

  712. <PRE>
    713. 

  713. public void <B>log</B>(java.lang.Throwable&nbsp;pError)</PRE>
    714. 

  714. <DL>
    715. 

  715. <DD>Logs an error.
    716. 

  716. <P>
    717. 

  717. <DD><DL>
    718. 

  718. </DL>
    719. 

  719. </DD>
    720. 

  720. <DD><DL>
    721. 

  721. <DT><B>Parameters:</B><DD><CODE>pError</CODE> - The error being logged.</DL>
    722. 

  722. </DD>
    723. 

  723. </DL>
    724. 

  724. <HR>
    725. 

  725. 

  726. <A NAME="log(java.lang.String)"><!-- --></A><H3>
    727. 

  727. log</H3>
    728. 

  728. <PRE>
    729. 

  729. public void <B>log</B>(java.lang.String&nbsp;pMessage)</PRE>
    730. 

  730. <DL>
    731. 

  731. <DD>Logs a message.
    732. 

  732. <P>
    733. 

  733. <DD><DL>
    734. 

  734. </DL>
    735. 

  735. </DD>
    736. 

  736. <DD><DL>
    737. 

  737. <DT><B>Parameters:</B><DD><CODE>pMessage</CODE> - The being logged.</DL>
    738. 

  738. </DD>
    739. 

  739. </DL>
    740. 

  740. <HR>
    741. 

  741. 

  742. <A NAME="getXmlRpcServer()"><!-- --></A><H3>
    743. 

  743. getXmlRpcServer</H3>
    744. 

  744. <PRE>
    745. 

  745. public <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcStreamServer.html" title="class in org.apache.xmlrpc.server">XmlRpcStreamServer</A> <B>getXmlRpcServer</B>()</PRE>
    746. 

  746. <DL>
    747. 

  747. <DD>Returns the <A HREF="../../../../org/apache/xmlrpc/server/XmlRpcServer.html" title="class in org.apache.xmlrpc.server"><CODE>XmlRpcServer</CODE></A>.
    748. 

  748. <P>
    749. 

  749. <DD><DL>
    750. 

  750. </DL>
    751. 

  751. </DD>
    752. 

  752. <DD><DL>
    753. 

  753. 

  754. <DT><B>Returns:</B><DD>The server object.</DL>
    755. 

  755. </DD>
    756. 

  756. </DL>
    757. 

  757. <!-- ========= END OF CLASS DATA ========= -->
    758. 

  758. <HR>
    759. 

  759. 

  760. 

  761. <!-- ======= START OF BOTTOM NAVBAR ====== -->
    762. 

  762. <A NAME="navbar_bottom"><!-- --></A>
    763. 

  763. <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
    764. 

  764. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
    765. 

  765. <TR>
    766. 

  766. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
    767. 

  767. <A NAME="navbar_bottom_firstrow"><!-- --></A>
    768. 

  768. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
    769. 

  769.   <TR ALIGN="center" VALIGN="top">
    770. 

  770.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    771. 

  771.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    772. 

  772.   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    773. 

  773.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/WebServer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    774. 

  774.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    775. 

  775.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    776. 

  776.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    777. 

  777.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    778. 

  778.   </TR>
    779. 

  779. </TABLE>
    780. 

  780. </TD>
    781. 

  781. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
    782. 

  782. </EM>
    783. 

  783. </TD>
    784. 

  784. </TR>
    785. 

  785. 

  786. <TR>
    787. 

  787. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    788. 

  788. &nbsp;<A HREF="../../../../org/apache/xmlrpc/webserver/ServletWebServer.Exception.html" title="class in org.apache.xmlrpc.webserver"><B>PREV CLASS</B></A>&nbsp;
    789. 

  789. &nbsp;<A HREF="../../../../org/apache/xmlrpc/webserver/XmlRpcServlet.html" title="class in org.apache.xmlrpc.webserver"><B>NEXT CLASS</B></A></FONT></TD>
    790. 

  790. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    791. 

  791.   <A HREF="../../../../index.html?org/apache/xmlrpc/webserver/WebServer.html" target="_top"><B>FRAMES</B></A>  &nbsp;
    792. 

  792. &nbsp;<A HREF="WebServer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
    793. 

  793. &nbsp;<SCRIPT type="text/javascript">
    794. 

  794.   <!--
    795. 

  795.   if(window==top) {
    796. 

  796.     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
    797. 

  797.   }
    798. 

  798.   //-->
    799. 

  799. </SCRIPT>
    800. 

  800. <NOSCRIPT>
    801. 

  801.   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
    802. 

  802. </NOSCRIPT>
    803. 

  803. 

  804. 

  805. </FONT></TD>
    806. 

  806. </TR>
    807. 

  807. <TR>
    808. 

  808. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    809. 

  809.   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
    810. 

  810. <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    811. 

  811. DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
    812. 

  812. </TR>
    813. 

  813. </TABLE>
    814. 

  814. <A NAME="skip-navbar_bottom"></A>
    815. 

  815. <!-- ======== END OF BOTTOM NAVBAR ======= -->
    816. 

  816. 

  817. <HR>
    818. 

  818. Copyright &#169; 2001-2009 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.
    819. 

  819. </BODY>
    820. 

  820. </HTML>
    821.