JAVA jar命令（一）-jar打包class文件

jar包本質上是將所有class文件、資源文件壓縮打成一個包（也可以選擇不壓縮），可選擇在jar包中生成META-INF/MANIFEST.MF文件，MANIFEST.MF是清單文件，里面可以記錄主類、classpath等信息，供虛擬機使用。
接下來的一段時間里，我們將以以下路徑學習jar命令和清單文件的相關知識

    jar打包class文件
    帶包class文件jar打包
    清單文件的使用

在這篇文章里我們將使用簡單的java程序來熟悉jar命令的使用，因為是出於熟練使用jar的目的，下面的操作中可能會啰里啰嗦、重復使用jar命令，以下是本片文章的目錄，精簡版直接看 jar命令的選項

            一 jar命令的選項
                用法
                選項
                本節中使用到的命令
            二 只有一個class文件的可執行jar的實現
                方法一將Mainjar全部解壓修改MANIFESTMF文件后再重新打包
                方法二生成jar包的時候為其指定清單文件
                方法三為jar包指定清單文件
                方法四為jar更新文件文件是清單文件
            三 多個class的打包

一. jar命令的選項
用法：

大括號中的選項是必選的，中括號里選項是可選的，jar-file是jar文件；manifest-file是清單文件，即jar包中的META-INF/MANIFEST.MF文件

jar {ctxui}[vfmn0PMe] [jar-file] [manifest-file] [entry-point] [-C dir] files ...

    1

選項：

-c  （create）創建新檔案
-t  列出檔案目錄
-x  從檔案中提取指定的 (或所有) 文件
-u  （update)更新現有檔案
-v  在標准輸出中生成詳細輸出
-f  指定檔案文件名
-m  包含指定清單文件中的清單信息
-n  創建新檔案后執行 Pack200 規范化
-e  為捆綁到可執行 jar 文件的獨立應用程序
    指定應用程序入口點
-0  僅存儲; 不使用任何 ZIP 壓縮
-P  保留文件名中的前導 '/' (絕對路徑) 和 ".." (父目錄) 組件
-M  不創建條目的清單文件
-i  為指定的 jar 文件生成索引信息
-C  更改為指定的目錄並包含以下文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15

本節中使用到的命令

jar uf xx.jar [file … | path]是需要注意的，它在更新完jar文件后會生成新的清單文件，這一點在本篇文章的 “方法4：為jar更新文件，文件是清單文件” 中有實例說明

jar cf xx.jar [file ... | path]  將file等文件或path目錄打包成xx.jar
jar cvf xx.jar [file ... | path]  同上，顯示詳細信息
jar cmf manifest-file xx.jar [file ... | path]  將file等文件或path目錄打包到xx.jar，並制定它的清單文件
jar cMf xx.jar [file ... | path]  將file等文件或path目錄打包到xx.jar，包中不生成清單文件
jar uf xx.jar [file ... | path]  將file等文件或目錄更新到xx.jar，務必注意！！！這個更新會重新生成清單文件
jar uMf xx.jar [file ... | path]  同上，但不會生成清單文件
jar umf manifest-file xx.jar {file ... | path}  將file等文件或path目錄更新到xx.jar
jar tf xx.jar  列出xx.jar中所有文件
jar xf xx.jar  把xx.jar中所有文件提取到當前目錄
jar xf xx.jar {file ...}  把xx.jar中file等文件提取到當前目錄

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10

二. 只有一個class文件的可執行jar的實現

首先創建一個jarDemo文件夾，里面放置我們的測試類

mkdir jarDemo
cd jarDemo
touch Main.java

    1
    2
    3

在Main.java里面添加我們的hello world代碼，並javac編譯

public class Main{
    public static void main(String ... args){
        System.out.println("hello world");
    }
}

    1
    2
    3
    4
    5

javac Main.java

    1

然后將生成的Main.class打包，c選項是創建一個新的jar包，f是指定jar包的名字

jar cf Main.jar Main.class

    1

如果附加使用v選項，則會列出詳細的打包信息

jar cvf Main.jar Main.class

    1

我們可以通過t選項來查看生成的jar中的文件，輸出的內容也就是包目錄和包文件，可以看到是默認生成MANIFEST.MF文件的

jar tf Main.jar

輸出：
META-INF/
META-INF/MANIFEST.MF
Main.class

    1
    2
    3
    4
    5
    6

當然我們也可以通過M選項不生成MANIFEST.MF文件，可以看到包中只有Main.class一個文件

rm Main.jar
jar cMf Main.jar Main.class
jar tf Main.jar

輸出：
Main.class

    1
    2
    3
    4
    5
    6

雖然我們已經將Main.class打包了，並且Main.class有main(String … args)入口方法，可是這個jar還是不能執行，因為虛擬機並不知道這個包中的哪個class中是有main方法的

java -jar Main.jar

輸出：
Main.jar中沒有主清單屬性

    1
    2
    3
    4

下面還是恢復到有MANIFEST.MF文件的Main.jar包，我們要將他解壓，在MANIFEST.MF中添加主類屬性
解壓jar包的方法有很多種，我們解壓的目的是為了查看默認生成的MANIFEST.MF文件，並做修改，最后生成一個可執行的jar包，因為我們的目的是出於熟練使用jar命名，下面我們將使用多個方法實現這個目標
方法一：將Main.jar全部解壓，修改MANIFEST.MF文件后再重新打包

因為jar解壓命令只能解壓到當前目錄，這樣會造成文件混亂，我們新建一個uncompress文件夾，將Main.jar拷貝到這個文件夾后再解壓，可以看到，jar包中所有文件，x選項是提出全部或指定文件，這個例子里是提出全部文件，實際中可以用f選項提出指定文件，比如 >> jar xf Main.jar META-INF/MANIFEST.MF

mkdir uncompress
cp Main.jar uncompress
cd uncompress
jar xf Main.jar
ls -RF

輸出：
META-INF/   Main.class  Main.jar

./META-INF:
MANIFEST.MF

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11

打開META-INF/MANIFEST.MF文件，看到默認生成的清單文件很簡單，只有兩行

Manifest-Version: 1.0
Created-By: 1.8.0_101 (Oracle Corporation)

    1
    2

添加上添加上主類屬性，注意冒號后面一定要留一個空格，最后一定要多留一個換行符

Manifest-Version: 1.0
Created-By: 1.8.0_101 (Oracle Corporation)
Main-Class: Main

    1
    2
    3

然后使用再將uncompress中所有目錄、文件全部打包，注意先將原來的Main.jar刪除，最后就可以運行這個新的有主類屬性的Main.jar啦

rm Main.jar
jar cMf Main.jar .
java -jar Main.jar

輸出：
hello world

    1
    2
    3
    4
    5
    6

注意上面這個jar命令使用的M選項是不生成清單，因為原本uncompress目錄里就有，如果還是使用jar cf命令，生成的清單和上面第一次打包生成清單的是一樣的，沒有Main-Class: Main主類

rm Main.jar
jar cf Main.jar .
java -jar Main.jar

輸出：
Main.jar中沒有主清單屬性

    1
    2
    3
    4
    5
    6

方法二：生成jar包的時候為其指定清單文件

還是那個方法一的uncompress目錄，我們把META-INF下的MANIFEST.MF移到uncompress目錄下，刪除Main.jar，和META-INF目錄，讓uncompress中只有Main.class和MANIFEST.MF兩個文件，MANIFEST.MF是有主類屬性的清單文件

mv META-INF/MANIFEST .
rm Main.jar
rm -r META-INF
ls -RF

輸出：
MANIFEST.MF Main.class

    1
    2
    3
    4
    5
    6
    7

接下了指定清單文件，生成Main.jar，m選項可以指定一個清單文件

jar cmf MANIFEST.MF Main.jar Main.class
java -jar Main.jar

輸出：
hello world

    1
    2
    3
    4
    5

方法三：為jar包指定清單文件

還記得最早那個jardemo目錄里的那個清單里沒有主類的Main.jar嗎，我們為它更新有主類的清單文件
jardemo/uncompress目錄下的的MANIFEST.MF是有主類的，我們把它移到jardemo目錄下

cd desktop/jardemo
mv uncompress/MANIFEST.MF .
rm -r uncompress
ls -RF

輸出：
MANIFEST.MF Main.class  Main.jar    Main.java

    1
    2
    3
    4
    5
    6
    7

使用u選項更新jar包，使用m選項指定清單文件，輸出了一些警告信息，因為新的清單文件和Main.jar包中原來的清單信息有兩個字段是重名的

jar -umf MANIFEST.MF Main.jar

輸出：
三月 13, 2017 10:50:50 下午 java.util.jar.Attributes read
WARNING: Duplicate name in Manifest: Manifest-Version.
Ensure that the manifest does not have duplicate entries, and
that blank lines separate individual sections in both your
manifest and in the META-INF/MANIFEST.MF entry in the jar file.
三月 13, 2017 10:50:50 下午 java.util.jar.Attributes read
WARNING: Duplicate name in Manifest: Created-By.
Ensure that the manifest does not have duplicate entries, and
that blank lines separate individual sections in both your
manifest and in the META-INF/MANIFEST.MF entry in the jar file.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13

再運行這個jar

java -jar Main.jar

輸出：
hello world

    1
    2
    3
    4

方法四：為jar更新文件，文件是清單文件

使用這個方法主要是為了再次熟悉一下u選項和理解包的概念
我們在jardemo目錄里刪除有主類清單的Main.jar，再次生成最早的MANIFEST.MF中沒有主類的Main.jar

jar cf Main.jar Main.class

    1

jar包中的MANIFEST.MF里記錄了主類，而MANIFEST.MF只是jar包中的一個文件，我們將Main.jar中沒有主類的MANIFEST.MF替換為有主類的MANIFEST.MF和方法三是同樣的效果，首先要講有主類的MANIFEST.MF放在合適的路徑里面，我們之前看到jar包中的文件是放在META-INF目錄里的，使用u來更新jar，注意需要使用M來忽視清單文件

mkdir META-INF
mv MANIFEST.MF META-INF
jar uMf Main.jar META-INF/MANIFEST.MF
java -jar Main.jar

輸出：
hello world

    1
    2
    3
    4
    5
    6
    7

三. 多個class的打包

上一節中，jarDemo目錄中有Main.java和有主類信息的清單文件MANIFEST.MF，我們只保留這兩個個文件，其他全部刪掉，然后新建一個Say.java文件

ls -RF

輸出：
META-INF/   Main.java   Say.java

./META-INF:
MANIFEST.MF

    1
    2
    3
    4
    5
    6
    7

在新建的Say.java：

public class Say{
    public static void say(String str){
        System.out.println("This is " + str);
    }
}

    1
    2
    3
    4
    5

修改Main.java文件，讓它調用Say類中的Say.say(…)方法

public class Main{
    public static void main(String ... args){
        System.out.println("hello world");
        Say.say("Charles");
    }
}

    1
    2
    3
    4
    5
    6

我們編譯文件並打包，注意指定一個那個有主類屬性的MANIFEST.MF

javac *.java
jar cmf Main.jar META-INF/MANIFEST.MF Main.class Say.class
java -jar Main.jar

輸出：
hello world
This is Charles