coolfiry

發(fā)布Java應(yīng)用程序時(shí)你會(huì)感到困難？好在Java提供了一系列打包和發(fā)布工具，可以顯著的簡(jiǎn)化發(fā)布過(guò)程
　　
　　該文章提供了打包Java code的幾種方法，我們將會(huì)探討Java manifest 文件，給出用于管理JAR文件所依賴(lài)文件、估計(jì)跨平臺(tái)發(fā)布所需的CLasspath的合適方法.我也會(huì)解釋如何使用manifest包版本特性來(lái)確認(rèn)包的兼容性...
　　
　　什么是JAR文件？
　　
　　在開(kāi)發(fā)過(guò)程中，我們可以直接使用Java class文件來(lái)運(yùn)行程序，但這并不是一個(gè)好方式，好在Java 提供了 JAR(Java Archive)文件來(lái)提供發(fā)布和運(yùn)行。
　　
　　jar 文件實(shí)際上是class 文件的ZIP壓縮存檔，這種格式被廣泛使用，因此易與使用，有很多中工具可以操作這種格式的文件。也正是因?yàn)檫@個(gè)原因，jar文件本身并不能表達(dá)所包含應(yīng)用程序的標(biāo)簽信息。
　　
　　Manifest 因此得以出現(xiàn)
　　
　 　為了要提供存檔的標(biāo)簽信息，jar 文件指定了一個(gè)特定目錄來(lái)存放標(biāo)簽信息：META-INF 目錄，其中我們來(lái)關(guān)注該目錄中的MANIFEST.MF文件，他就是JAR的manifest文件，他包含了JAR文件的內(nèi)容描述，并在運(yùn)行時(shí)向JVM提 供應(yīng)用程序的信息，大多數(shù)JAR文件含有一個(gè)默認(rèn)生成的manifest 文件,執(zhí)行JAR命令或使用zip工具，都可以產(chǎn)生它
　　
　　如果是由jar命令產(chǎn)生的 manifest 文件，形如:
　　Manifest-Version: 1.0
　　Created-By:1.4.0-beta
　　(Sun Microsystems Inc.)
　　
　 　這些信息沒(méi)甚么用,僅僅告訴我們使用的是1.0的manifest文件,第一行定義manifest的格式，第二行說(shuō)明使用 SUN 的JDK1.4的jar工具生成該文件，如果manifest文件是由其他 （如ant） 創(chuàng)建的，那將會(huì)出現(xiàn) “Created-By: Ant 1.2” 之類(lèi)的內(nèi)容，如果你是自己創(chuàng)建manifest文件，你可以加入自己的一些相關(guān)信息.
　　
　　基礎(chǔ)格式
　　
　　manifest 文件的格式 是很簡(jiǎn)單的，每一行都是 名－值 對(duì)應(yīng)的:屬性名開(kāi)頭，接著是 ":" ，然后是屬性值，每行最多72個(gè)字符，如果需要增加，你可以在下一行續(xù)行，續(xù)行以空格開(kāi)頭，以空格開(kāi)頭的行都會(huì)被視為前一行的續(xù)行。
　　
　　所有在開(kāi)頭的屬性都是全局的，你也可以定義特定class 或package的屬性，稍后將介紹這種
　　
　　把manifest文件插入JAR文件
　　
　　使用 m 選項(xiàng)，把指定文件名的manifest文件 傳入，例如
　　jar cvfm myapplication.jar myapplication.mf -C classdir
　　
　　如果你使用ant來(lái)創(chuàng)建時(shí)，在ant 的build.xml 加入如下條目
　　<target name="jar">
　　<jar jarfile ="myapplication.jar"
　　manifest="myapplication.mf">
　　<fileset dir="classdir"
　　includes="**/*.class"/>
　　</jar>
　　</target>
　　
　　運(yùn)行Java程序
　　
　　現(xiàn)在我們來(lái)體驗(yàn)一下manifest文件的作用，如果現(xiàn)在我們有一個(gè)Java 應(yīng)用程序打包在myapplication.jar中， main class為 com.example.myapp.MyAppMain ，那么我們可以用以下的命令來(lái)運(yùn)行
　　java -classpath myapplication.jar com.example.myapp.MyAppMain
　　
　　這顯然太麻煩了，現(xiàn)在我們來(lái)創(chuàng)建自己的manifest文件，如下：
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Main-Class: com.example.myapp.MyAppMain
　　
　　這樣我們就可以使用如下的命令來(lái)運(yùn)行程序了：（明顯簡(jiǎn)單多了，也不會(huì)造成無(wú)謂的拼寫(xiě)錯(cuò)誤）
　　java -jar myapplication.jar
　　
　　管理JAR的依賴(lài)資源
　　
　 　很少Java應(yīng)用會(huì)僅僅只有一個(gè)jar文件，一般還需要 其他類(lèi)庫(kù)。比如我的應(yīng)用程序用到了Sun 的 Javamail classes ，在classpath中我需要包含activation.jar 和 mail.jar,這樣在運(yùn)行程序時(shí),相比上面的例子,我們要增加一些:
　　java -classpath mail.jar:activation.jar -jar myapplication.jar
　　
　　在不同的操作系統(tǒng)中,jar包間的分隔符也不一樣，在UNIX用“：”，在window中使用 “；”，這樣也不方便
　　
　　同樣，我們改寫(xiě)我們的manifest文件，如下
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Main-Class: com.example.myapp.MyAppMain
　　Class-Path: mail.jar activation.jar
　　
　　（加入了Class-Path: mail.jar activation.jar，用空格分隔兩個(gè)jar包）
　　
　　這樣我們?nèi)匀豢梢允褂煤蜕侠邢嗤拿顏?lái)執(zhí)行該程序：
　　java -jar myapplication.jar
　　
　 　Class-Path屬性中包含了用空格分隔的jar文件，在這些jar文件名中要對(duì)特定的字符使用逃逸符，比如空格，要表示成"%20"，在路徑的表 示中，都采用“/”來(lái)分隔目錄，無(wú)論是在什么操作系統(tǒng)中，(即使在window中)，而且這里用的是相對(duì)路徑（相對(duì)于本身的JAR文件）：
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Main-Class: com.example.myapp.MyAppMain
　　Class-Path: ext/mail.jar ext/activation.jar
　　Multiple Main Classes（多主類(lèi)）
　　
　 　還有一種Multiple Main Classes情況，如果你的應(yīng)用程序可能有命令行版本 和GUI版本，或者一些不同的應(yīng)用卻共享很多相同的代碼，這時(shí)你可能有多個(gè)Main Class，我們建議你采取這樣的策略：把共享的類(lèi)打成lib包，然后把不同的應(yīng)用打成不同的包，分別標(biāo)志主類(lèi)：如下
　　Manifest for myapplicationlib.jar:
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Class-Path: mail.jar activation.jar
　　Manifest for myappconsole.jar:
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Class-Path: myapplicationlib.jar
　　Main-Class: com.example.myapp.MyAppMain
　　Manifest for myappadmin.jar:
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Class-Path: myapplicationlib.jar
　　Main-Class: com.example.myapp.MyAdminTool
　　在myappconsole.jar 和 myappadmin.jar的manifest文件中分別注明各自的 Main Class
　　Package Versioning
　　
　　完成發(fā)布后，如果使用者想了解 ，哪些代碼是誰(shuí)的？目前是什么版本？使用什么版本的類(lèi)庫(kù)？解決的方法很多 ，manifest提供了一個(gè)較好的方法，你可以在manifest文件中描述每一個(gè)包的信息。
　　
　 　Java 秉承了實(shí)現(xiàn)說(shuō)明與描述分離的原則，package 的描述 定義了package 是什么，實(shí)現(xiàn)說(shuō)明 定義了誰(shuí)提供了描述的實(shí)現(xiàn)，描述和實(shí)現(xiàn)包含 名、版本號(hào)和提供者。要得到這些信息，可以查看JVM的系統(tǒng)屬性（使用 java.lang.System.getProperty() ）
　　
　　在manifest文件中，我可以為每個(gè)package定義描述和實(shí)現(xiàn)版本，聲明名字，并加入描述屬性和實(shí)現(xiàn)屬性，這些屬性是
　　
　　Specification-Title
　　Specification-Version
　　Specification-Vendor
　　Implementation-Title
　　Implementation-Version
　　Implementation-Vendor
　　
　　當(dāng)要提供一個(gè)類(lèi)庫(kù)或編程接口時(shí)，描述信息顯得是很重要，見(jiàn)以下范例：
　　
　　Manifest-Version: 1.0
　　Created-By: JDJ example
　　Class-Path: mail.jar activation.jar
　　Name: com/example/myapp/
　　Specification-Title: MyApp
　　Specification-Version: 2.4
　　Specification-Vendor: example.com
　　Implementation-Title: com.example.myapp
　　Implementation-Version: 2002-03-05-A
　　Implementation-Vendor: example.com
　　
　　Package Version 查詢(xún)
　　
　　在manifest文件中加入package描述后，就可以使用Java提供的java.lang.Package class進(jìn)行Package 的信息查詢(xún)，這里列舉3個(gè)最基本的獲取package object的方法
　　
　　1.Package.getPackages():返回系統(tǒng)中所有定義的package列表
　　
　　2.Package.getPackage(String packagename):按名返回package
　　
　　3.Class.getPackage():返回給定class所在的package
　　
　　使用者這方法就可以動(dòng)態(tài)的獲取package信息.
　　
　　需要注意的是如果給定的package中沒(méi)有class被加載,則也無(wú)法獲得package 對(duì)象
　　
　　Manifest 技巧
　　
　　總是以Manifest-Version屬性開(kāi)頭
　　
　　每行最長(zhǎng)72個(gè)字符，如果超過(guò)的化，采用續(xù)行
　　
　　確認(rèn)每行都以回車(chē)結(jié)束，否則改行將會(huì)被忽略
　　
　　如果Class-Path 中的存在路徑，使用"/"分隔目錄，與平臺(tái)無(wú)關(guān)
　　
　　使用空行分隔主屬性和package屬性
　　
　　使用"/"而不是"."來(lái)分隔package 和class ,比如 com/example/myapp/
　　
　　class 要以.class結(jié)尾，package 要以 / 結(jié)尾