Removed usages of JXURL in documentation. Also updated proxy webapp. Resolves #1747.
This commit is contained in:
WalkerWatch
parent
f2cf8b9bf8
commit
3ee7f9fe4a
|
|
@ -192,7 +192,7 @@
|
|||
<overWrite>true</overWrite>
|
||||
<includes>**</includes>
|
||||
<outputDirectory>${assembly-directory}/demo-base/webapps</outputDirectory>
|
||||
<destFileName>xref-proxy.war</destFileName>
|
||||
<destFileName>javadoc-proxy.war</destFileName>
|
||||
</artifactItem>
|
||||
<artifactItem>
|
||||
<groupId>org.eclipse.jetty.example-async-rest</groupId>
|
||||
|
|
|
|||
|
|
@ -45,8 +45,7 @@
|
|||
<ul>
|
||||
<li><a href="http://www.eclipse.org/jetty/">Jetty Homepage</a></li>
|
||||
<li><a href="http://www.eclipse.org/jetty/documentation/current">Jetty Documentation</a> (<a href="/doc/">local</a>)</li>
|
||||
<li><a href="/proxy/apidocs/">Javadoc</a> (via transparent proxy)</li>
|
||||
<li><a href="/proxy/xref/">Xref</a> (via transparent proxy)</li>
|
||||
<li><a href="/proxy/current/">Javadoc</a> (via transparent proxy)</li>
|
||||
<li><a
|
||||
href="http://www.eclipse.org/jetty/powered">Jetty Powered</a></li>
|
||||
</ul>
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.proxy.BalancerServlet`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-proxy
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/proxy/BalancerServlet.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/proxy/BalancerServlet.html
|
||||
|
||||
[[balancer-servlet-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlets.CGI`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlets/CGI.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlets/CGI.html
|
||||
|
||||
[[cgi-servlet-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlets.CrossOriginFilter`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlets/CrossOriginFilter.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlets/CrossOriginFilter.html
|
||||
|
||||
[[cross-origin-filter-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.DebugHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/DebugHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/DebugHandler.html
|
||||
|
||||
[[debug-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.DefaultHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/DefaultHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/DefaultHandler.html
|
||||
|
||||
[[default-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlet.DefaultServlet`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlet
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlet/DefaultServlet.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlet/DefaultServlet.html
|
||||
|
||||
[[default-servlet-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlets.DoSFilter`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlets/DoSFilter.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlets/DoSFilter.html
|
||||
|
||||
[[dos-filter-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.ErrorHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/ErrorHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/ErrorHandler.html
|
||||
|
||||
[[error-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -22,9 +22,7 @@
|
|||
|
||||
* Classname: `org.eclipse.jetty.server.handler.gzip.GzipHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc:
|
||||
{JDURL}/org/eclipse/jetty/server/handler/gzip/GzipHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/gzip/GzipHandler.html
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/gzip/GzipHandler.html
|
||||
|
||||
[[gzip-filter-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlets.HeaderFilter`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlets/HeaderFilter.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlets/HeaderFilter.html
|
||||
|
||||
[[header-filter-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.IPAccessHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/IPAccessHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/IPAccessHandler.html
|
||||
|
||||
[[ipaccess-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -22,10 +22,7 @@
|
|||
|
||||
* Classname: `org.eclipse.jetty.server.handler.MovedContextHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc:
|
||||
{JDURL}/org/eclipse/jetty/server/handler/MovedContextHandler.html
|
||||
* Xref:
|
||||
{JXURL}/org/eclipse/jetty/server/handler/MovedContextHandler.html
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/MovedContextHandler.html
|
||||
|
||||
[[moved-context-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.proxy.ProxyServlet`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-proxy
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/proxy/ProxyServlet.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/proxy/ProxyServlet.html
|
||||
|
||||
[[proxy-servlet-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.servlets.QoSFilter`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-servlets
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/servlets/QoSFilter.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/servlets/QoSFilter.html
|
||||
|
||||
[[qos-filter-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.ResourceHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/ResourceHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/ResourceHandler.html
|
||||
|
||||
[[resource-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -26,7 +26,6 @@ The most common use is to rewrite request URIs, but it is capable of much more:
|
|||
* Classname: org.eclipse.jetty.rewrite.handler.RewriteHandler
|
||||
* Maven artifact: org.eclipse.jetty:jetty-rewrite
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/rewrite/handler/RewriteHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/rewrite/handler/RewriteHandler.html
|
||||
|
||||
The standard Jetty distribution bundle contains the `jetty-rewrite` link:#startup-modules[module], so all you need to do is to enable it using one of the link:#start-jar[module commands], eg:
|
||||
|
||||
|
|
@ -98,24 +97,24 @@ There are several types of rules that are written extending useful base rule cla
|
|||
|
||||
Matches against the request URI using the servlet pattern syntax.
|
||||
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/CookiePatternRule.html[CookiePatternRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/CookiePatternRule.html[CookiePatternRule]::
|
||||
Adds a cookie to the response.
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/HeaderPatternRule.html[HeaderPatternRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/HeaderPatternRule.html[HeaderPatternRule]::
|
||||
Adds/modifies a header in the response.
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/RedirectPatternRule.html[RedirectPatternRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/RedirectPatternRule.html[RedirectPatternRule]::
|
||||
Redirects the response.
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/ResponsePatternRule.html[ResponsePatternRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/ResponsePatternRule.html[ResponsePatternRule]::
|
||||
Sends the response code (status or error).
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/RewritePatternRule.html[RewritePatternRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/RewritePatternRule.html[RewritePatternRule]::
|
||||
Rewrite the URI by replacing the matched request path with a fixed string.
|
||||
|
||||
===== RegexRule
|
||||
|
||||
Matches against the request URI using regular expressions.
|
||||
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/RedirectRegexRule.html[RedirectRegexRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/RedirectRegexRule.html[RedirectRegexRule]::
|
||||
Redirect the response.
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/RewriteRegexRule.html[RewriteRegexRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/RewriteRegexRule.html[RewriteRegexRule]::
|
||||
Rewrite the URI by matching with a regular expression.
|
||||
(The replacement string may use `Template:$n` to replace the nth capture group.)
|
||||
|
||||
|
|
@ -123,16 +122,16 @@ Rewrite the URI by matching with a regular expression.
|
|||
|
||||
Match against request headers. Match either on a header name and specific value, or on the presence of a header (with any value).
|
||||
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/ForwardedSchemeHeaderRule.html[ForwardedSchemaHeaderRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/ForwardedSchemeHeaderRule.html[ForwardedSchemaHeaderRule]::
|
||||
Set the scheme on the request (defaulting to HTTPS).
|
||||
|
||||
===== Others
|
||||
|
||||
Extra rules that defy standard classification.
|
||||
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/MsieSslRule.html[MsieSslRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/MsieSslRule.html[MsieSslRule]::
|
||||
Disables the keep alive for SSL from IE5 or IE6.
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/LegacyRule.html[LegacyRule]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/LegacyRule.html[LegacyRule]::
|
||||
Implements the legacy API of RewriteHandler
|
||||
|
||||
===== RuleContainer
|
||||
|
|
@ -140,5 +139,5 @@ Implements the legacy API of RewriteHandler
|
|||
Groups rules together.
|
||||
The contained rules will only be processed if the conditions for the `RuleContainer` evaluate to true.
|
||||
|
||||
link:{JXURL}/org/eclipse/jetty/rewrite/handler/VirtualHostRuleContainer.html[VirtualHostRuleContainer]::
|
||||
link:{JDURL}/org/eclipse/jetty/rewrite/handler/VirtualHostRuleContainer.html[VirtualHostRuleContainer]::
|
||||
Groups rules that apply only to a specific virtual host or a set of virtual hosts
|
||||
|
|
|
|||
|
|
@ -23,7 +23,6 @@
|
|||
* Classname: `org.eclipse.jetty.server.handler.ShutdownHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/ShutdownHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/ShutdownHandler.html
|
||||
|
||||
[[shutdown-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -22,9 +22,7 @@
|
|||
|
||||
* Classname: `org.eclipse.jetty.server.handler.StatisticsHandler`
|
||||
* Maven Artifact: org.eclipse.jetty:jetty-server
|
||||
* Javadoc:
|
||||
{JDURL}/org/eclipse/jetty/server/handler/StatisticsHandler.html
|
||||
* Xref: {JXURL}/org/eclipse/jetty/server/handler/StatisticsHandler.html
|
||||
* Javadoc: {JDURL}/org/eclipse/jetty/server/handler/StatisticsHandler.html
|
||||
|
||||
[[statistics-handler-usage]]
|
||||
==== Usage
|
||||
|
|
|
|||
|
|
@ -39,4 +39,4 @@ Create a file called `scratch.xml` in the `${jetty.base}/webapps` directory and
|
|||
----
|
||||
|
||||
This is a very basic setup for serving static files.
|
||||
For advanced static file serving, use the link:{JXURL}/org/eclipse/jetty/servlet/DefaultServlet.html[DefaultServlet].
|
||||
For advanced static file serving, use the link:{JDURL}/org/eclipse/jetty/servlet/DefaultServlet.html[DefaultServlet].
|
||||
|
|
|
|||
|
|
@ -87,7 +87,7 @@ One or more handlers do all request handling in Jetty.
|
|||
Some handlers select other specific handlers (for example, a `ContextHandlerCollection` uses the context path to select a `ContextHandler`); others use application logic to generate a response (for example, the `ServletHandler` passes the request to an application Servlet), while others do tasks unrelated to generating the response (for example, `RequestLogHandler` or `StatisticsHandler`).
|
||||
|
||||
Later sections describe how you can combine handlers like aspects.
|
||||
You can see some of the handlers available in Jetty in the link:{JXURL}/org/eclipse/jetty/server/handler/package-summary.html[org.eclipse.jetty.server.handler] package.
|
||||
You can see some of the handlers available in Jetty in the link:{JDURL}/org/eclipse/jetty/server/handler/package-summary.html[org.eclipse.jetty.server.handler] package.
|
||||
|
||||
===== Handler Collections and Wrappers
|
||||
|
||||
|
|
@ -112,7 +112,7 @@ Much of the standard Servlet container in Jetty is implemented with `HandlerWrap
|
|||
However, because of the nature of the servlet specification, this chaining cannot be a pure nesting of handlers as the outer handlers sometimes need information that the inner handlers process.
|
||||
For example, when a `ContextHandler` calls some application listeners to inform them of a request entering the context, it must already know which servlet the `ServletHandler` will dispatch the request to so that the `servletPath` method returns the correct value.
|
||||
|
||||
The `HandlerWrapper` is specialized to the link:{JXURL}/org/eclipse/jetty/server/handler/ScopedHandler.html[`ScopedHandler`] abstract class, which supports a daisy chain of scopes.
|
||||
The `HandlerWrapper` is specialized to the link:{JDURL}/org/eclipse/jetty/server/handler/ScopedHandler.html[`ScopedHandler`] abstract class, which supports a daisy chain of scopes.
|
||||
For example if a `ServletHandler` is nested within a `ContextHandler`, the order and nesting of execution of methods is:
|
||||
|
||||
....
|
||||
|
|
@ -128,7 +128,7 @@ Thus when the `ContextHandler` handles the request, it does so within the scope
|
|||
|
||||
===== Resource Handler
|
||||
|
||||
The link:{JXURL}/org/eclipse/jetty/embedded/FileServer.html[FileServer example] shows how you can use a `ResourceHandler` to serve static content from the current working directory:
|
||||
The link:{JDURL}/org/eclipse/jetty/embedded/FileServer.html[FileServer example] shows how you can use a `ResourceHandler` to serve static content from the current working directory:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
----
|
||||
|
|
@ -144,7 +144,7 @@ However, often when embedding Jetty it is desirable to explicitly instantiate an
|
|||
|
||||
===== One Connector
|
||||
|
||||
The following example, link:{JXURL}/org/eclipse/jetty/embedded/OneConnector.html[OneConnector.java],
|
||||
The following example, link:{JDURL}/org/eclipse/jetty/embedded/OneConnector.html[OneConnector.java],
|
||||
instantiates, configures, and adds a single HTTP connector instance to the server:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
|
|
@ -152,24 +152,24 @@ instantiates, configures, and adds a single HTTP connector instance to the serve
|
|||
include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/OneConnector.java[]
|
||||
----
|
||||
|
||||
In this example the connector handles the HTTP protocol, as that is the default for the link:{JXURL}/org/eclipse/jetty/server/ServerConnector.html[`ServerConnector`] class.
|
||||
In this example the connector handles the HTTP protocol, as that is the default for the link:{JDURL}/org/eclipse/jetty/server/ServerConnector.html[`ServerConnector`] class.
|
||||
|
||||
===== Many Connectors
|
||||
|
||||
When configuring multiple connectors (for example, HTTP and HTTPS), it may be desirable to share configuration of common parameters for HTTP.
|
||||
To achieve this you need to explicitly configure the `ServerConnector` class with `ConnectionFactory` instances, and provide them with common HTTP configuration.
|
||||
|
||||
The link:{JXURL}/org/eclipse/jetty/embedded/ManyConnectors.html[ManyConnectors example], configures a server with two `ServerConnector` instances: the http connector has a link:{JXURL}/org/eclipse/jetty/server/HttpConnectionFactory.html[`HTTPConnectionFactory`] instance; the https connector has a `SslConnectionFactory` chained to a `HttpConnectionFactory`.
|
||||
Both `HttpConnectionFactory` are configured based on the same link:{JXURL}/org/eclipse/jetty/server/HttpConfiguration.html[`HttpConfiguration`] instance, however the HTTPS factory uses a wrapped configuration so that a link:{JXURL}/org/eclipse/jetty/server/SecureRequestCustomizer.html[`SecureRequestCustomizer`] can be added.
|
||||
The link:{JDURL}/org/eclipse/jetty/embedded/ManyConnectors.html[ManyConnectors example], configures a server with two `ServerConnector` instances: the http connector has a link:{JDURL}/org/eclipse/jetty/server/HttpConnectionFactory.html[`HTTPConnectionFactory`] instance; the https connector has a `SslConnectionFactory` chained to a `HttpConnectionFactory`.
|
||||
Both `HttpConnectionFactory` are configured based on the same link:{JDURL}/org/eclipse/jetty/server/HttpConfiguration.html[`HttpConfiguration`] instance, however the HTTPS factory uses a wrapped configuration so that a link:{JDURL}/org/eclipse/jetty/server/SecureRequestCustomizer.html[`SecureRequestCustomizer`] can be added.
|
||||
|
||||
==== Embedding Servlets
|
||||
|
||||
http://en.wikipedia.org/wiki/Java_Servlet[Servlets] are the standard way to provide application logic that handles HTTP requests.
|
||||
Servlets are similar to a Jetty Handler except that the request object is not mutable and thus cannot be modified.
|
||||
Servlets are handled in Jetty by a link:{JXURL}/org/eclipse/jetty/embedded/MinimalServlets.html[`ServletHandler`].
|
||||
Servlets are handled in Jetty by a link:{JDURL}/org/eclipse/jetty/embedded/MinimalServlets.html[`ServletHandler`].
|
||||
It uses standard path mappings to match a Servlet to a request; sets the requests `servletPath` and `pathInfo`; passes the request to the servlet, possibly via Filters to produce a response.
|
||||
|
||||
The link:{JXURL}/org/eclipse/jetty/embedded/MinimalServlets.html[MinimalServlets example] creates a `ServletHandler` instance and configures a single HelloServlet:
|
||||
The link:{JDURL}/org/eclipse/jetty/embedded/MinimalServlets.html[MinimalServlets example] creates a `ServletHandler` instance and configures a single HelloServlet:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
----
|
||||
|
|
@ -178,7 +178,7 @@ include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/Min
|
|||
|
||||
==== Embedding Contexts
|
||||
|
||||
A link:{JXURL}/org/eclipse/jetty/embedded/OneContext.html[`ContextHandler`] is a `ScopedHandler` that responds only to requests that have a URI prefix that matches the configured context path.
|
||||
A link:{JDURL}/org/eclipse/jetty/embedded/OneContext.html[`ContextHandler`] is a `ScopedHandler` that responds only to requests that have a URI prefix that matches the configured context path.
|
||||
Requests that match the context path have their path methods updated accordingly and the contexts scope is available, which optionally may include:
|
||||
|
||||
* A `Classloader` that is set as the Thread context `classloader` while request handling is in scope.
|
||||
|
|
@ -187,7 +187,7 @@ Requests that match the context path have their path methods updated accordingly
|
|||
* A base Resource which is used as the document root for static resource requests via the http://docs.oracle.com/javaee/6/api/javax/servlet/ServletContext.html[`ServletContext`] API.
|
||||
* A set of virtual host names.
|
||||
|
||||
The following link:{JXURL}/org/eclipse/jetty/embedded/OneContext.html[OneContext example] shows a context being established that wraps the link:{JXURL}/org/eclipse/jetty/embedded/HelloHandler.html[HelloHandler]:
|
||||
The following link:{JDURL}/org/eclipse/jetty/embedded/OneContext.html[OneContext example] shows a context being established that wraps the link:{JDURL}/org/eclipse/jetty/embedded/HelloHandler.html[HelloHandler]:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
----
|
||||
|
|
@ -195,7 +195,7 @@ include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/One
|
|||
----
|
||||
|
||||
When many contexts are present, you can embed a `ContextHandlerCollection` to efficiently examine a request URI to then select the matching `ContextHandler`(s) for the request.
|
||||
The link:{JXURL}/org/eclipse/jetty/embedded/ManyContexts.html[ManyContexts example] shows how many such contexts you can configure:
|
||||
The link:{JDURL}/org/eclipse/jetty/embedded/ManyContexts.html[ManyContexts example] shows how many such contexts you can configure:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
----
|
||||
|
|
@ -204,8 +204,8 @@ include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/Man
|
|||
|
||||
==== Embedding ServletContexts
|
||||
|
||||
A link:{JXURL}/org/eclipse/jetty/servlet/ServletContextHandler.html[`ServletContextHandler`] is a specialization of `ContextHandler` with support for standard sessions and Servlets.
|
||||
The following link:{JXURL}/org/eclipse/jetty/embedded/OneServletContext.html[OneServletContext example] instantiates a link:{JXURL}/org/eclipse/jetty/servlet/DefaultServlet.html[`DefaultServlet`] to server static content from /tmp/ and a `DumpServlet` that creates a session and dumps basic details about the request:
|
||||
A link:{JDURL}/org/eclipse/jetty/servlet/ServletContextHandler.html[`ServletContextHandler`] is a specialization of `ContextHandler` with support for standard sessions and Servlets.
|
||||
The following link:{JDURL}/org/eclipse/jetty/embedded/OneServletContext.html[OneServletContext example] instantiates a link:{JDURL}/org/eclipse/jetty/servlet/DefaultServlet.html[`DefaultServlet`] to server static content from /tmp/ and a `DumpServlet` that creates a session and dumps basic details about the request:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
----
|
||||
|
|
@ -214,8 +214,8 @@ include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/One
|
|||
|
||||
==== Embedding Web Applications
|
||||
|
||||
A link:{JXURL}/org/eclipse/jetty/webapp/WebAppContext.html[`WebAppContext`] is an extension of a `ServletContextHandler` that uses the http://en.wikipedia.org/wiki/WAR_%28Sun_file_format%29[standard layout] and web.xml to configure the servlets, filters and other features from a web.xml and/or annotations.
|
||||
The following link:{JXURL}/org/eclipse/jetty/embedded/OneWebApp.html[OneWebApp example] configures the Jetty test webapp.
|
||||
A link:{JDURL}/org/eclipse/jetty/webapp/WebAppContext.html[`WebAppContext`] is an extension of a `ServletContextHandler` that uses the http://en.wikipedia.org/wiki/WAR_%28Sun_file_format%29[standard layout] and web.xml to configure the servlets, filters and other features from a web.xml and/or annotations.
|
||||
The following link:{JDURL}/org/eclipse/jetty/embedded/OneWebApp.html[OneWebApp example] configures the Jetty test webapp.
|
||||
Web applications can use resources the container provides, and in this case a `LoginService` is needed and also configured:
|
||||
|
||||
[source, java, subs="{sub-order}"]
|
||||
|
|
@ -227,7 +227,7 @@ include::{SRCDIR}/examples/embedded/src/main/java/org/eclipse/jetty/embedded/One
|
|||
|
||||
The typical way to configure an instance of the Jetty server is via `jetty.xml` and associated configuration files.
|
||||
However the Jetty XML configuration format is just a simple rendering of what you can do in code; it is very simple to write embedded code that does precisely what the jetty.xml configuration does.
|
||||
The link:{JXURL}/org/eclipse/jetty/embedded/LikeJettyXml.html[LikeJettyXml example] following renders in code the behavior obtained from the configuration files:
|
||||
The link:{JDURL}/org/eclipse/jetty/embedded/LikeJettyXml.html[LikeJettyXml example] following renders in code the behavior obtained from the configuration files:
|
||||
|
||||
* link:{GITBROWSEURL}/jetty-server/src/main/config/etc/jetty.xml[jetty.xml]
|
||||
* link:{GITBROWSEURL}/jetty-jmx/src/main/config/etc/jetty-jmx.xml[jetty-jmx.xml]
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@
|
|||
|
||||
The Handler is the Jetty component that deals with received requests.
|
||||
|
||||
Many users of Jetty never need to write a Jetty Handler, but instead use the link:{JXURL}/org/eclipse/jetty/servlet/package-summary.html[Servlet API.]
|
||||
Many users of Jetty never need to write a Jetty Handler, but instead use the link:{JDURL}/org/eclipse/jetty/servlet/package-summary.html[Servlet API.]
|
||||
You can reuse the existing Jetty handlers for context, security, sessions and servlets without the need for extension.
|
||||
However, some users might have special requirements or footprint concerns that prohibit the use of the full servlet API.
|
||||
For them implementing a Jetty handler is a straight forward way to provide dynamic web content with a minimum of fuss.
|
||||
|
|
@ -171,4 +171,4 @@ This is typically used to pass a request to a link:{JDURL}/org/eclipse/jetty/ser
|
|||
[[more-about-handlers]]
|
||||
==== More About Handlers
|
||||
|
||||
See the link:{JXURL}/[latest Jetty Source XRef] and the link:{JDURL}/[latest Jetty JavaDoc] for detailed information on each Jetty handler.
|
||||
See the link:{JDURL}/[latest Jetty JavaDoc] for detailed information on each Jetty handler.
|
||||
|
|
|
|||
|
|
@ -64,7 +64,7 @@ The demo-base/webapps directory contains the following deployable and auxiliary
|
|||
`test-spec.xml`::
|
||||
A context configuration file that configures `test-spec.war`.
|
||||
Additional configuration includes setting up some objects in the naming space that can be referenced by annotations.
|
||||
`xref-proxy.war`::
|
||||
A demonstration web application that uses a transparent proxy to serve the Jetty source link:{JXURL}/[xref] from the http://www.eclipse.org/jetty[Eclipse Jetty website].
|
||||
`javadoc-proxy.war`::
|
||||
A demonstration web application that uses a transparent proxy to serve the Jetty source link:{JDURL}/[Javadoc] from the http://www.eclipse.org/jetty[Eclipse Jetty website].
|
||||
`example-moved.xml`::
|
||||
A demonstration context configuration file that shows how to use the link:#moved-context-handler[`MovedContextHandler`] to redirect from one path to another.
|
||||
|
|
|
|||
|
|
@ -55,27 +55,43 @@ Within the standard Jetty distribution there is the `demo-base` directory, which
|
|||
> cd $JETTY_HOME/demo-base/
|
||||
> java -jar $JETTY_HOME/start.jar
|
||||
|
||||
2015-06-04 10:55:24.161:INFO::main: Logging initialized @308ms
|
||||
2015-06-04 10:55:24.431:WARN::main: demo test-realm is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:24.434:INFO:oejs.Server:main: jetty-9.3.0.v20150601
|
||||
2015-06-04 10:55:24.457:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/webapps/] at interval 1
|
||||
2015-06-04 10:55:24.826:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@c038203{/,file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/webapps/ROOT/,AVAILABLE}{/ROOT}
|
||||
2015-06-04 10:55:24.929:WARN::main: test-jaas webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:24.978:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@46238e3f{/test-jaas,file:///tmp/jetty-0.0.0.0-8080-test-jaas.war-_test-jaas-any-9105214562680121772.dir/webapp/,AVAILABLE}{/test-jaas.war}
|
||||
2015-06-04 10:55:25.162:WARN::main: async-rest webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:25.208:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@6b67034{/async-rest,[file:///tmp/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-1023939491558622183.dir/webapp/, jar:file:///tmp/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-1023939491558622183.dir/webapp/WEB-INF/lib/example-async-rest-jar-9.3.0.v20150601.jar!/META-INF/resources],AVAILABLE}{/async-rest.war}
|
||||
2015-06-04 10:55:25.311:WARN::main: test-jndi webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:25.386:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@8b96fde{/test-jndi,file:///tmp/jetty-0.0.0.0-8080-test-jndi.war-_test-jndi-any-1692053319754270133.dir/webapp/,AVAILABLE}{/test-jndi.war}
|
||||
2015-06-04 10:55:25.508:WARN::main: test-spec webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:25.594:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@69930714{/test-spec,[file:///tmp/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-5518740932795802823.dir/webapp/, jar:file:///tmp/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-5518740932795802823.dir/webapp/WEB-INF/lib/test-web-fragment-9.3.0.v20150601.jar!/META-INF/resources],AVAILABLE}{/test-spec.war}
|
||||
2015-06-04 10:55:25.781:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@3eb7fc54{/proxy,file:///tmp/jetty-0.0.0.0-8080-xref-proxy.war-_xref-proxy-any-3068657547009829038.dir/webapp/,AVAILABLE}{/xref-proxy.war}
|
||||
2015-06-04 10:55:25.786:INFO:oejsh.ContextHandler:main: Started o.e.j.s.h.MovedContextHandler@59662a0b{/oldContextPath,null,AVAILABLE}
|
||||
2015-06-04 10:55:25.951:WARN::main: test webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2015-06-04 10:55:26.248:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@4f83df68{/test,file:///tmp/jetty-0.0.0.0-8080-test.war-_test-any-5238659347611323540.dir/webapp/,AVAILABLE}{/test.war}
|
||||
2015-06-04 10:55:26.255:INFO:oejs.ServerConnector:main: Started ServerConnector@5a9c4ad9{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}
|
||||
2015-06-04 10:55:26.259:INFO:oejus.SslContextFactory:main: x509={jetty.eclipse.org=jetty} wild={} alias=null for SslContextFactory@23941fb4(file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/etc/keystore,file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/etc/keystore)
|
||||
2015-06-04 10:55:26.269:INFO:oejs.ServerConnector:main: Started ServerConnector@5d908d47{SSL,[ssl, http/1.1]}{0.0.0.0:8443}
|
||||
2015-06-04 10:55:26.270:INFO:oejs.Server:main: Started @2417ms
|
||||
2017-08-16 16:55:15.571:INFO::main: Logging initialized @521ms to org.eclipse.jetty.util.log.StdErrLog
|
||||
2017-08-16 16:55:15.907:WARN::main: demo test-realm is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:15.910:INFO:oejs.Server:main: jetty-9.4.7-SNAPSHOT
|
||||
2017-08-16 16:55:15.931:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/webapps/] at interval 1
|
||||
2017-08-16 16:55:16.151:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=50ms
|
||||
2017-08-16 16:55:16.369:INFO:oejs.session:main: DefaultSessionIdManager workerName=node0
|
||||
2017-08-16 16:55:16.369:INFO:oejs.session:main: No SessionScavenger set, using defaults
|
||||
2017-08-16 16:55:16.370:INFO:oejs.session:main: Scavenging every 660000ms
|
||||
2017-08-16 16:55:16.416:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@7113b13f{/,file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/webapps/ROOT/,AVAILABLE}{/ROOT}
|
||||
2017-08-16 16:55:16.625:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=82ms
|
||||
2017-08-16 16:55:16.631:WARN::main: test webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:16.751:INFO:oejsh.ManagedAttributeListener:main: update PushFilter null->org.eclipse.jetty.servlets.PushCacheFilter@1a677343 on o.e.j.w.WebAppContext@2d7275fc{/test,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test.war-_test-any-7157753932050220016.dir/webapp/,STARTING}{/test.war}
|
||||
2017-08-16 16:55:16.757:INFO:oejsh.ManagedAttributeListener:main: update QoSFilter null->org.eclipse.jetty.servlets.QoSFilter@79079097 on o.e.j.w.WebAppContext@2d7275fc{/test,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test.war-_test-any-7157753932050220016.dir/webapp/,STARTING}{/test.war}
|
||||
2017-08-16 16:55:16.760:WARN:oeju.DeprecationWarning:main: Using @Deprecated Class org.eclipse.jetty.servlets.MultiPartFilter
|
||||
2017-08-16 16:55:16.809:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@2d7275fc{/test,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test.war-_test-any-7157753932050220016.dir/webapp/,AVAILABLE}{/test.war}
|
||||
2017-08-16 16:55:16.816:INFO:oejsh.ContextHandler:main: Started o.e.j.s.h.MovedContextHandler@7c9d8e2{/oldContextPath,null,AVAILABLE}
|
||||
2017-08-16 16:55:16.854:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=23ms
|
||||
2017-08-16 16:55:16.891:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@69453e37{/doc,file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/webapps/doc/,AVAILABLE}{/doc}
|
||||
2017-08-16 16:55:16.942:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=25ms
|
||||
2017-08-16 16:55:16.945:WARN::main: test-jaas webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:16.983:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@4e3958e7{/test-jaas,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test-jaas.war-_test-jaas-any-6953571893682159674.dir/webapp/,AVAILABLE}{/test-jaas.war}
|
||||
2017-08-16 16:55:17.106:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=21ms
|
||||
2017-08-16 16:55:17.109:WARN::main: test-jndi webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:17.192:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@1d8bd0de{/test-jndi,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test-jndi.war-_test-jndi-any-1246461885510956986.dir/webapp/,AVAILABLE}{/test-jndi.war}
|
||||
2017-08-16 16:55:17.307:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=53ms
|
||||
2017-08-16 16:55:17.310:WARN::main: test-spec webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:17.388:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@51dcb805{/test-spec,[file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-3750193079644252256.dir/webapp/, jar:file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-3750193079644252256.dir/webapp/WEB-INF/lib/test-web-fragment-9.4.7-SNAPSHOT.jar!/META-INF/resources],AVAILABLE}{/test-spec.war}
|
||||
2017-08-16 16:55:17.490:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=53ms
|
||||
2017-08-16 16:55:17.493:WARN::main: async-rest webapp is deployed. DO NOT USE IN PRODUCTION!
|
||||
2017-08-16 16:55:17.516:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@1de76cc7{/async-rest,[file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-8972552397332323832.dir/webapp/, jar:file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-8972552397332323832.dir/webapp/WEB-INF/lib/example-async-rest-jar-9.4.7-SNAPSHOT.jar!/META-INF/resources],AVAILABLE}{/async-rest.war}
|
||||
2017-08-16 16:55:17.643:INFO:oeja.AnnotationConfiguration:main: Scanning elapsed time=83ms
|
||||
2017-08-16 16:55:17.921:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@242b836{/proxy,file:///private/var/folders/h6/yb_lbnnn11g0y1jjlvqg631h0000gn/T/jetty-0.0.0.0-8080-javadoc-proxy.war-_javadoc-proxy-any-4521643038409884891.dir/webapp/,AVAILABLE}{/javadoc-proxy.war}
|
||||
2017-08-16 16:55:17.936:INFO:oejs.AbstractConnector:main: Started ServerConnector@6f15d60e{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}
|
||||
2017-08-16 16:55:17.944:INFO:oejus.SslContextFactory:main: x509=X509@58e1d9d(jetty,h=[jetty.eclipse.org],w=[]) for SslContextFactory@446a1e84(file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/etc/keystore,file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/etc/keystore)
|
||||
2017-08-16 16:55:17.944:INFO:oejus.SslContextFactory:main: x509=X509@4f0f2942(mykey,h=[],w=[]) for SslContextFactory@446a1e84(file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/etc/keystore,file:///tmp/jetty-distribution-9.4.7-SNAPSHOT/demo-base/etc/keystore)
|
||||
2017-08-16 16:55:18.071:INFO:oejs.AbstractConnector:main: Started ServerConnector@41488b16{SSL,[ssl, http/1.1]}{0.0.0.0:8443}
|
||||
2017-08-16 16:55:18.072:INFO:oejs.Server:main: Started @3022ms
|
||||
----
|
||||
|
||||
You can visit this demo server by pointing a browser at link:http://localhost:8080[], which will now show a welcome page and several demo/test web applications.
|
||||
|
|
|
|||
|
|
@ -8,32 +8,14 @@
|
|||
|
||||
<display-name>Transparent Proxy WebApp</display-name>
|
||||
|
||||
<servlet>
|
||||
<servlet-name>XrefTransparentProxy</servlet-name>
|
||||
<servlet-class>org.eclipse.jetty.proxy.ProxyServlet$Transparent</servlet-class>
|
||||
<init-param>
|
||||
<param-name>proxyTo</param-name><param-value>http://download.eclipse.org/jetty/stable-9</param-value>
|
||||
</init-param>
|
||||
<init-param>
|
||||
<param-name>hostHeader</param-name><param-value>download.eclipse.org</param-value>
|
||||
</init-param>
|
||||
<load-on-startup>1</load-on-startup>
|
||||
<async-supported>true</async-supported>
|
||||
</servlet>
|
||||
|
||||
<servlet-mapping>
|
||||
<servlet-name>XrefTransparentProxy</servlet-name>
|
||||
<url-pattern>/xref/*</url-pattern>
|
||||
</servlet-mapping>
|
||||
|
||||
<servlet>
|
||||
<servlet-name>JavadocTransparentProxy</servlet-name>
|
||||
<servlet-class>org.eclipse.jetty.proxy.ProxyServlet$Transparent</servlet-class>
|
||||
<init-param>
|
||||
<param-name>proxyTo</param-name><param-value>http://download.eclipse.org/jetty/stable-9</param-value>
|
||||
<param-name>proxyTo</param-name><param-value>http://www.eclipse.org/jetty/javadoc/</param-value>
|
||||
</init-param>
|
||||
<init-param>
|
||||
<param-name>hostHeader</param-name><param-value>download.eclipse.org</param-value>
|
||||
<param-name>hostHeader</param-name><param-value>eclipse.org</param-value>
|
||||
</init-param>
|
||||
<load-on-startup>1</load-on-startup>
|
||||
<async-supported>true</async-supported>
|
||||
|
|
@ -41,7 +23,7 @@
|
|||
|
||||
<servlet-mapping>
|
||||
<servlet-name>JavadocTransparentProxy</servlet-name>
|
||||
<url-pattern>/apidocs/*</url-pattern>
|
||||
<url-pattern>/current/*</url-pattern>
|
||||
</servlet-mapping>
|
||||
|
||||
</web-app>
|
||||
|
|
|
|||
Loading…
Reference in New Issue