Changes between Version 1 and Version 2 of waue/2009/0813

Timestamp:

Aug 13, 2009, 1:30:09 PM (16 years ago)

Author:

waue

Comment:

--

waue/2009/0813

@@ -1 @@
-鑲嵌 jetty code 
+鑲嵌 jetty 5.1.x code 
 
-
-
+ = ServletHandler =
 
 Using the ServletHandler
 
-If you do not wish to use web applications but you want to deploy servlets, then you need to register at least one context and at least the ServletHandler with the server. You are able to statically configure individual servlets at a specific URL pattern, or use dynamic mapping to extract servlet names from the request URL.
+If you do not wish to use web applications but you want to deploy servlets, then you need to register at least one context and at least the ServletHandler with the server. 
 
-The ServletHandler can be used with a HttpServer:
+ ==  HttpServer ==
+You are able to statically configure individual servlets at a specific URL pattern, or use dynamic mapping to extract servlet names from the request URL.
+
+ * Code Example:  Using ServletHandler in HttpServer
+
 {{{
+#!java
 HttpServer server = new HttpServer();
 server.addListener(":8080");
@@ -18 +22 @@
 context.addHandler(handler);
 }}}
-Code Example:  Using ServletHandler in HttpServer
+
+ == org.mortbay.jetty.Server ==
 
 Alternately, the org.mortbay.jetty.Server can be used instead of a HttpServer, so that it's conveniance methods may be used:
+
+ * Code Example:  Using ServletHandler in Server
 {{{
+#!java
 Server server = new Server();
 server.addListener(":8080");
@@ -29 +37 @@
                    "org.mortbay.servlet.Dump");
 }}}
-Code Example:  Using ServletHandler in Server
 
-Using Static Servlet Mappings
-The examples above used defined servlet mappings to map a request URL to a servlet. Prefix (eg "/dump/*"), suffix (eg. "*.jsp"), exact (eg "/path") or default ("/") mappings may be used and they are all within the scope of the context path:
+
+ ===  Static Servlet  ===
+
+ * Using Static Servlet Mappings
+
+The examples above used defined servlet mappings to map a request URL to a servlet. 
+
+Prefix (eg "/dump/*"), suffix (eg. "*.jsp"), exact (eg "/path") or default ("/") mappings may be used and they are all within the scope of the context path:
+
+ * Code Example:  Static servlet mappings
 {{{
 #!java
@@ -47 +62 @@
 context.addServlet("Default","/",
                    "org.mortbay.jetty.servlet.Default");
+
 }}}
-Code Example:  Static servlet mappings
+
 
 Examples of URLs that will be mapped to these servlets are:
@@ -59 +75 @@
  || /anythingelse        || Not this context || 
 
-Using Dynamic Servlets
+=== Using Dynamic Servlets ===
+
 Servlets can be discovered dynamically by using the org.mortbay.jetty.servlet.Invoker servlet. This servlet uses the request URI to determine a servlet class or the name of a previously registered servlet:
+
+ * Code Example:  Dynamic servlet mappings
+
 {{{
 #!java
@@ -72 +92 @@
                    "org.mortbay.jetty.servlet.Invoker");
 }}}
-Code Example:  Dynamic servlet mappings
+
 
 Examples of URLs that will be mapped to these servlets are:
@@ -81 +101 @@
 By default, the Invoker will only load servlets from the context classloader, so the last URL above will result in an error. The Invoker can be configured to allow any servlet to be run, but this can be a secuirty issue.
 
-Deploying Web Applications
+=== Deploying Web Applications ===
 
 The Servlet Specification details a standard layout for web applications. If your content is packaged according to these specifications, then simply call the addWebApplication(...)methods on the  org.mortbay.jetty.Server instance, specifying at minimum a context path, the directory or war file of your application. Jetty is then able to discover and configure all the required handlers including security, static content and servlets.
@@ -91 +111 @@
 This example configures a web application located in the directory ./webapps/myapp/ at the context path / for a virtual host myhost:
 
+ * Code Example: Configuring a web application
+
+{{{
+#!sh
 server.addWebApplication("myhost","/","./webapps/myapp/");
+}}}
 
-Code Example: Configuring a web application
 
 The arguments to the addWebApplication method are:
@@ -107 +131 @@
 
 
-Multiple Web Applications
+=== Multiple Web Applications ===
 
 To make things even easier, if you have multiple web apps to deploy, you can accomplish this with a single method call:
 
+ * Code Example: Configuring multiple web apps
+{{{
 server.addWebApplications ("myhost","./webapps/");
-
-Code Example: Configuring multiple web apps
-
+}}}
 
 Given the code above, Jetty would look in the directory "./webapps/" for all war files and subdirectories, and configure itself with each web application specified therein. For example, assuming the directory webapps contained the war files webapps/root.war, webapps/customer.war and webapps/admin.war, then Jetty would create the contexts "/", "/customer/*" and "/admin/*" mapped to the respective war files. NOTE the special mapping of war files (or directories) named root to the context "/".
 
 In order to actually deploy the web application, it is also necessary to configure a port listener. The full code example to deploy the web application in the code snippet is:
+
+ * Code Example:  Deploying a web application
+
 {{{
 #!java
@@ -128 +155 @@
 server.start();
 }}}
-Code Example:  Deploying a web application
 
 
-Using XML
+
+ = Using XML = 
 
 The same web application can be deployed instead via an XML configuration file instead of calls to the API. The name of the file is passed to Jetty as an argument on the command line (see the section on  Jetty demonstrations for instructions). The following excerpt deploys the same web application as given in the code example above:
+
 {{{
 #!xml
@@ -158 +186 @@
 
 }}}
+