Java打包工具是Java開發工具中比較常用的一種，程式碼重新打包工具jarjar可以幫助你將其它用到的java庫打包並嵌入到你自己的專案jar包中。這樣做的原因有:

當你釋出專案的時候，把用到的庫打包進現有專案jar包，可以讓釋出的這個jar包不比依賴於其它專案的jar包;

當你所用到的java庫升級了以後，它所新發布的jar包可能和你現存的專案不匹配，為了保持專案的程式碼穩定性，你可以把編寫程式碼時所用到的依賴jar包，全部打包進現在的專案jar包，以避免出現這個問題。

jarjar可以通過Ant任務的方式使用，也可以單獨地在命令列下使用。打包程式碼時，如果你要重新命名某些依賴包的名字的時候，jarjar會呼叫位元組碼轉換(通過ASM)來更新程式碼，並自動做好其他工作。

以Ant任務的形式使用jarjar

我們現存的Ant任務裡可以用jar任務來打包程式碼，比如:

<target name="jar" depends="compile">
    <jar jarfile="dist/example.jar">
        <fileset dir="build/main"/>
    </jar>
</target>

為了使用jarjar工具，我們建立一個叫jarjar的任務，由於JarJarTask是Ant標準任務Jar的子類，所以如果你不需要使用jarjar的特有功能的話，完全可以像這樣呼叫jarjar工具:

就像標準的”jar”任務一樣，可以通過”zipfileset”元素來包含其它jar包。但是僅僅包含其它jar包並不能讓你遠離“jar包陷阱”,因為你所依賴的jar包中的類名還是沒有改變，仍然有可能和其它版本的jar包裡的類名相同，產生衝突。

為了重新命名類名，JarJarTask引入了一個新元素”rule”。”rule”包含了”pattern”屬性，你可以通過這個屬性，使用萬用字元來選擇哪些類需要重新命名，通過”result”屬性可以設定如何給選中的類重新命名。

在本例中我們希望引入一個叫jaxen.jar的庫。並將所有以”org.jaxen”開頭的類重新命名以”org.example.jaxen”開頭:

<target name="jar" depends="compile">
    <taskdef name="jarjar" classname="com.tonicsystems.jarjar.JarJarTask"
        classpath="lib/jarjar.jar"/>
    <jarjar jarfile="dist/example.jar">
        <fileset dir="build/main"/>
        <zipfileset src="lib/jaxen.jar"/>
        <rule pattern="org.jaxen.**" result="org.example.@1"/>
    </jarjar>
</target>

萬用字元**表示匹配迴圈所有的子包，如果你只希望匹配一個子包的話，可以使用*。

@1表示第一個**所匹配到的內容，一次類推，@2表示從左到右第二個所匹配到的*或**。@0是特殊的標誌，它代表整個匹配到的類的全名。

命令列下單獨使用jarjar

java -jar jarjar.jar [help]

列印幫助資訊。

java -jar jarjar.jar strings

列印類路徑classpath下的字串資訊，如果類中有debug資訊的話，會打印出所在行的行號。

比如java -jar jarjar.jar strings servlet-api.jar會列印:

...
javax.servlet.http.HttpServletRequest
"BASIC"
"FORM"
"CLIENT_CERT"
"DIGEST"
javax.servlet.http.HttpUtils
"javax.servlet.http.LocalStrings"
88: "javax.servlet.http.LocalStrings"
339: "://"
341: "http"
341: "https"
145: "&"
238: "err.io.short_read"
254: "8859_1"
...

java -jar jarjar.jar find []

打印出類路徑下java類對類路徑下類的依賴，如果省略了，那麼用代替。只能取class或者jar，前者代表列印各個類之間的依賴情況，後者會列印包對包之間的依賴。

java -jar jarjar.jar process

將按照檔案所指定的方法轉換到裡，中原有的類將被刪除。

檔案的寫法下面將會提到。

類路徑Classpath的格式

類路徑classpath是用逗號或分號(具體是那種分隔符依賴作業系統)隔開的一組目錄，jar包或者zip包。詳細說明請看classpath的java doc。也可以使用萬用字元的方式來書寫classpath：http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6268383。

Rules規則檔案格式

Rules規則檔案是實際上一種文字檔案，每一行代表一條規則Rule，行首和行末的空格會被忽略掉，有三種不同樣式的Rule寫法:

rule <pattern> <result>
zap <pattern>
keep <pattern>

第一個是用來設定jarjar如何重新命名類檔案的。所有類，只要它引用到了需要改變名字的類，其相關內容就會被自動同步改變，保證不會出現引用錯誤。如果一個類匹配了不同的rule，只有第一個匹配的rule會生效。 和的設定同上面講過的Ant中一樣。

zap規則中 所匹配的類將會不加入生成的新jar包。