[csu540-f05-rpf] Working example of executable jars with subdirectories

[Robert Futrelle]

In the jars page, at:

http://www.ccs.neu.edu/home/futrelle/teaching/csu540f2005/assignments/jars.html

I've added a link to the archive item for the note below,
the one I just sent. Such links to mailing list archive items can
be handy. You can use them too.

  - RPF


>Self-contained notes by R P Futrelle on jarring, 9/17/05.
>The numbered lines are command line
>commands and what they returned.
>(Done on my Mac, *not* checked on Solaris, sorry.)
>
>There are three points to note:
>A. The java source is in a package.
>B. An executable jar is made for that class in the package.
>C. A second jar is made that contains a Readme and also
>    the original jar (nested jars, if you like).
>
>Slightly edited trace of the command line,
>in the directory FullProject --
>
>  1 FullProject: cat Readme.txt
>  2
>  3 RPFutrelle 9/17/05
>  4 There are TWO jars.
>  5 One is made from the folder mypackage
>  6 and references a MainClass: mypackage.HelloInPackage
>  7 The other is made from the enclosing FullProject folder.
>  8 None of this organization is made to be exemplary.
>  9 It is only done to illustrate some of the various things
>10 that can be done.
>11
>12 FullProject: ls -R
>13 Readme.txt   full.mf     mypackage/     run.mf
>14
>15 ./mypackage:
>16 HelloInPackage.class  HelloInPackage.java
>17
>18 FullProject: jar cmf run.mf run.jar mypackage/
>19
>20 FullProject: ls
>21 Readme.txt  full.mf     mypackage/  run.jar     run.mf
>22
>23 FullProject: jar tf run.jar
>24 META-INF/
>25 META-INF/MANIFEST.MF
>26 mypackage/
>27 mypackage/.DS_Store
>28 mypackage/HelloInPackage.class
>29 mypackage/HelloInPackage.java
>30
>31 FullProject: java -jar run.jar
>32 Hello from mypackage.HelloInPackage
>33
>34 FullProject: ls
>35 Readme.txt  full.mf     mypackage/  run.jar     run.mf
>36
>37 FullProject: jar cmf full.mf full.jar run.jar Readme.txt
>38
>39 FullProject: jar tf full.jar
>40 META-INF/
>41 META-INF/MANIFEST.MF
>42 run.jar
>43 Readme.txt
>44
>
>COMMENTS ON THE ABOVE:
>
>Line 12 shows the full contents, including in the mypackage folder
>The class HelloInPackage starts with the line:
>package mypackage;
>so it's in the mypackage package and properly, in a folder of
>the same name.
>
>Line 18 shows the jarring to produce a runnable jar, run.jar,
>using  manifest file run.mf:
>
>Manifest-Version: 1.0
>Created-By: 1.5.0_02 (Apple Computer, Inc.) and RPF
>Main-Class: mypackage.HelloInPackage
>
>Line 23 shows the contents of run.jar
>Line 31 shows that the run.jar is executable, in spite
>of the subdirectory involved, mypackage/
>
>Line 37 creates another jar, full.jar which has as its contents
>only the run.jar and the Readmet.txt.
>Its manifest file, full.mf, is vanilla:
>
>Manifest-Version: 1.0
>Created-By: 1.5.0_02 (Apple Computer, Inc.) and RPF
>
>Line 39 asks for the contents of the new full.jar,
>which is as expected (Lines 40-43)
>
>For completeness, here's the source of HelloInPackage.java:
>
>-------------------------
>package mypackage;
>
>/**
>  * Can be used in executable jar w. MainClass mypackage.HelloInPackage.
>  * For class CSU540, Computer Graphics, Fall 2005
>  * Northeastern U., Boston, MA
>  * @author R P Futrelle
>  * @version 1 9/17/2005
>  */
>
>  public class HelloInPackage {
>	public static void main(String[] args){
>		 System.out.println("Hello from mypackage.HelloInPackage");
>	 }
>  }
>-------------------------
>
>Note on spelling: Google says "jaring" is slightly preferred over "jarring"
>which I have used.  English pronunciation suggests that "jaring" would
>rhyme with "scaring" (scare) but "scarring" would be pronounced as in scar.
>So I'll go with the 'proper' English for now. Check answers.com if
>you're curious.  I have a nice answers.com plugin such that I can highlight
>any word in almost any app and some command keys will pop up the answers.com
>window for that word  - nice.
>
>
>_______________________________________________
>csu540-f05-rpf mailing list
>csu540-f05-rpf at lists.ccs.neu.edu
>https://lists.ccs.neu.edu/bin/listinfo/csu540-f05-rpf