| <?xml version="1.0"?> |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| --> |
| <document> |
| <properties> |
| <title>Fulcrum Jetty Service</title> |
| <author email="siegfried.goeschl@it20one.at">Siegfried Goeschl</author> |
| </properties> |
| <body> |
| <section name="Overview"> |
| <p> |
| The Fulcrum Jetty Service allows embedding a Jetty HTTP server to serve |
| HTTP request. The main focus is to add HTTP support to an existing |
| non-web application, e.g. for exposing web services. The tests also |
| exercise JSPs and JAAS integration to make sure that everything is properly wired. |
| </p> |
| </section> |
| <section name="How to Test Manually"> |
| <p> |
| To make sure that Jetty is properly integrated run the following command line |
| </p> |
| <source><![CDATA[ |
| mvn -Pstandalone test |
| ]]></source> |
| <p> |
| This will start the embedded Jetty and allows manual testing using |
| <a href="http://localhost:9080/test/">http://localhost:9080/test/</a>. |
| </p> |
| </section> |
| <section name="JSP Support"> |
| <p> |
| The fulcrum-jetty library ships with optional JSP support because |
| <ul> |
| <li>most people plainly don't need it and it adds a lot of baggage</li> |
| <li>for supporting JDK 1.4 and 1.5 different libraries are required</li> |
| </ul> |
| </p> |
| <subsection name="JSP 2.1 Support for JDK 1.5"> |
| <p> |
| These dependencies are required for running JSP 2.1 on JDK 1.5 |
| </p> |
| <source><![CDATA[ |
| <!-- JSP 2.1 dependencies for JDK 1.5 --> |
| <dependency> |
| <groupId>org.mortbay.jetty</groupId> |
| <artifactId>jsp-2.1</artifactId> |
| <version>${jetty.version}</version> |
| </dependency> |
| ]]></source> |
| </subsection> |
| </section> |
| </body> |
| </document> |