README.android
1URL: http://www.eclipse.org/jetty/
2Version: 8.1.15.v20140411
3License: Apache 2 or Eclipse 1.0 (see NOTICE file for information on licensing for dependencies)
4
5Description
6-------------------
7Jetty is a lightweight, servlet container implementation in Java.
8
9The pom.xml_saved file is included as a reference for bringing down the complete, original source
10code and dependencies using maven. Note, the file structure generated with pom.xml_saved will
11not match the current file structure, as noted in the Local Modifcations section. Furthermore, not
12all of the original sources are compatible with the android runtime. Incompatible source files are
13listed in the Android.mk file under "NON_ANDROID_SRC".
14
15Local Modifcations
16-------------------
17The complete original source code was downloaded using pom.xml_saved. The pom file creates a separate
18directory for each jetty package. the src directory of the relevant packages were merged into a single
19src directory. The relevant packages which were merged into the single src directory are:
20-jetty-client
21-jetty-continuation
22-jetty-http
23-jetty-io
24-jetty-security
25-jetty-server
26-jetty-servlet
27-jetty-servlets
28-jetty-util
29-jetty-webapp
30-jetty-websocket
31-jetty-xml
32
33All other packages were discarded. Prebuilt dependencies (SLF4J, the servlet api and jetty utils)
34were copied from the maven repository into the lib directory. pom files and sha1 files are included
35with the prebuilt dependencies for reference.
36
37The eclipse files were created manually. The .classpath file includes the prebuilt dependencies in the
38lib directory and excludes the sources files that are not compatible with the android runtime (see
39"NON_ANDROID_SRC" in the Android.mk file). the .project file was copied from one of the .project
40files created by maven.
41
42Updating this Project
43-------------------
44To update this project, the updated packages should be fetched from maven and their src directories should
45be merged with the local src directory. Any new or updated prebuilt dependencies should be copied into
46the lib directory. The Android.mk file (.classpath file for eclipse) should be updated accordingly. It
47may be necessary to add more files to "NON_ANDROID_SRC" in the Android.mk file (the excluding element
48in .classpath for eclipse).
49