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" and the build.gradle file under nonAndroidSrc.
14
15Local Modifcations
16-------------------
17The complete original source code was downloaded using pom.xml_saved. The pom file creates a
18separate directory for each jetty package. the src directory of the relevant packages were merged
19into a single src directory. The relevant packages which were merged into the single src directory
20are:
21
22-jetty-client
23-jetty-continuation
24-jetty-http
25-jetty-io
26-jetty-security
27-jetty-server
28-jetty-servlet
29-jetty-servlets
30-jetty-util
31-jetty-webapp
32-jetty-websocket
33-jetty-xml
34
35All other packages were discarded. Prebuilt dependencies (SLF4J, the servlet api and jetty utils)
36were copied from the maven repository into the lib directory. pom files and sha1 files are included
37with the prebuilt dependencies for reference.
38
39The eclipse files were created manually. The .classpath file includes the prebuilt dependencies in
40the lib directory and excludes the source files that are not compatible with the android runtime
41(see "NON_ANDROID_SRC" in the Android.mk file or nonAndroidSrc in the build.gradle file). The
42.project file was copied from one of the .project files created by maven.
43
44Updating this Project
45-------------------
46To update this project, the updated packages should be fetched from maven and their src directories
47should be merged with the local src directory. Any new or updated prebuilt dependencies should be
48copied into the lib directory. The Android.mk file (.classpath file for eclipse) should be updated
49accordingly. It may be necessary to add more files to "NON_ANDROID_SRC" in the Android.mk file and
50nonAndroidSrc in the build.gradle file (the excluding element in .classpath for eclipse).
51