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