root/main/trunk/gli/lib/README.txt @ 29729

Revision 29729, 3.2 KB (checked in by ak19, 5 years ago)

First part of commit fixing up GLI to work with commit of reviosion 29687. In revision 29687 web.xml got split into web.xml and servlets.xml, which the first included as an entity. GLI parses web.xml and other XML files on startup, and now requires an EntityResolver? to parse the inclusion of servlets.xml in web.xml. The use of an EntityResolver? when parsing web.xml was also required in the GS3 server application code (in GS3/src/java), and worked there. The same change however didn't work in GLI, because the xerces and xml-apis (sax) classes used by GLI were not the same as what the GS3 server code used. The contents of xercesImpl.jar and xml-apis.jar used by GS3 have now replaced what was there in the older apache.jar, the rest of the contents are the same as before because they don't seem to be tightly coupled with the xerces and xml-apis parts of the apache.jar contents, whereas these two are.

Line 
1GLI's apache.jar is a custom jar file that collects together apache libraries necessary to compile, build and run GLI. There's no documentation on the various jar files that it contains, but I've guessed by inspecting the contents.
2
3Some of the contents are from xercesImpl.jar and xml-apis.jar, which may need to be kept up to date together, since they are related and interdependent jar files.
4
5
6Commit 29729 added the contents of xml-apis.jar (sax) and xercesImpl.jar (both found in GS3/web/WEB-INF/lib else packages/tomcat/lib) into apache.jar, replacing the older xerces and xml-apis contents of apache.jar
7
8
9Overview of the contents of apache.jar and whether they got updated in the upcoming commit 29729.
10
11- javax: came with the updated version of xml-apis.jar
12- license: came with the updated version of xml-apis.jar
13
14- com: not sure where the contents came from, but they're not apache. Left them as-is.
15
16- org:
17    - w3c: replaced with w3c folder from xml-apis.jar from GS3/web/WEB-INF/lib (packages/tomcat/lib)   
18        also added /org/w3c/dom/html/HTMLDOMImplementation.class of xercesImpl.jar in here, to replace the older version
19    - xml: replaced with xml folder from xml-apis.jar from GS3/web/WEB-INF/lib (packages/tomcat/lib)
20    - saxpath: left as-is. See jaxen below.
21    - jaxen: left as-is. The latest version is 1.1.6 from jaxen.codehaus.org/releases.html, but it seems to be a separate project from apache's xerces and xml-apis and therefore not tightly connected with them. The latest version of jaxen includes saxpath, which means that jaxen and saxpath may be tightly connected to each other and require concurrent updating, even if they're not dependent on xerces and xml-apis and therefore not require concurrent updating with them.
22
23    - apache: most of the contents, being the html, wml, xerces and xml folders have been replaced by their counterparts from the current version of xercesImpl.jar used in GS3/web/WEB-INF/lib (packages/tomcat/lib)
24        - xmlcommons: replaced with org/apache/xmlcommons folder from xml-apis.jar from GS3/web/WEB-INF/lib (packages/tomcat/lib)
25        - log4j: left as-is.
26        - commons: left as-is.
27            - codec: appears to be from commons-codec,
28            - logging: appears to be from commons-logging.
29            - not sure where the 4 other subfolders of commons (beanutils, collections, digester, httpclient) are from.
30       
31
32Essentially, in commit 29729, the entire contents of GS3 web-lib's xml-apis.jar and xercesImpl.jar have been added to apache.jar after unzipping it, replacing earlier versions already present. The "javax" and "licence" toplevel folders of apache.jar are proper additions, deriving from xml-apis.jar. All other contents of apache.jar have been left as they were.
33
34
35After unzipping apache.jar, the contents were updated as described above.
36
37How to recreate the apache.jar:
38> cd gli/lib/apache
39> jar -cvf apache.jar *
40
41The apache.jar file gets generated inside gli/lib/apache, move it into gli/lib. Then commit it.
42
43Further changes to makejar.sh/bat, to mention the new javax subfolder, since it may also need to be unzipped from apache.jar along with the other contained libraries, so that xml-apis' javax too can be included in GLI.jar when this is generated, in case there is any dependence on javax in the rest of xml-apis' classes.
44
45
46
47
Note: See TracBrowser for help on using the browser.