深入了解 Java 應用與編譯：從原始檔到命令產出 JavaDoc 文件 | JDK 結構

套件 package 非必須，而如果有，那 只能有一個、必須 在檔案最頂端（除了註解之外；其路徑使用 . 取代 / 符號

而 package 描述是相對於 Java 包的路徑 (路徑為 src/main/java 或是 src/main/kotlin 之下)

假設我的原始擋在專案中的路徑為 /src/main/java/hello/FirstJava.java，那 package 則是描述為 package hello;

● 而套件的作用如下

A. 一個 Java 檔中，可以不必有 public 類

class HelloJava {

}

class WorldJava {
    
}

B. 如果有 public 描述的類，那 Java 原始檔檔名也必須與這個 public 描述的類相同

// 檔名必須為 HelloJava.java
public class HelloJava {

}

class WorldJava {
    
}

import 關鍵字用來引入不同 package 路徑的類，並且 依照寫法會引入不同的類

A. 不同的引入方式

// 只引入 ~/hello/world/FirstImport 類
import hello.world.FirstImport;

// 引入 ~/hello/world/ 包下的所有類
import hello.world.*;

// 引入 ~/hello/ 包下的所有類
import hello.*;

B. 要注意的是 * 號只會引入該目錄下的所有類，並不包括子資料夾的類

// 只引入 ~/hello/world/FirstImport 類
import hello.world.FirstImport;

// 引入 ~/hello/ 包下的所有類，**不包括 world 資料夾內的類！**
import hello.*;

● 對編譯速度的影響？

import` 用來告訴編譯器該檔案存在套件中的哪裡，如果你能 清晰的指出套件位置，那就可以加快編譯器搜尋檔案的速度

● 引入就代表了初始化？

Nonono~ 使用 import 時，不會導致類別的初始化（不會觸發 ClassLoader 加載類）

// 主程式類別為 HelloJava

public class HelloJava {

    // 必須四個條件都符合
    public static void main(String[] args) {

    }

}

javac -verbose \
    -sourcepath `pwd` \
    -classpath ../classes \
    -d ../classes \
    Main.java 

● 編譯器先到 -classpath 指定的目錄下尋找是否有 Main.class 檔案，如果沒有再到 -sourcepath 指定的目錄下尋找 Main.java 檔

● 如果同時找到 Main.class、Main.java 檔案，那就會比較 class 檔案是否過期，如果過期就重新編譯 java 檔

● 如果只找到 Main.class 就直接用

● 如果只找到 Main.java 就將其編譯程 class 檔

● 都找不到就拋出錯誤！

停留在 src/ 目錄下，並執行以下命令就可以執行 class 檔

java -classpath ../classes/ Main

如果有多個 classpath 可以使用 ; 符號分離不同路徑

eg. java -classpath ../classes/; ../classesA/; ../classes/B; Main

● 尋找 classpath

classpath 會從最近的設定開始尋找，尋找的優先級如：命令設定的 -classpath > shell 設定的 classpath > 系統設定的 classpath

● package 設定

運行時 java 會判斷 class 檔案內的 package 值，並到對應資料夾中找 class 檔案，如果找不到則會拋出

呼叫某個包內 Class 內部的 Main，呼叫的格式 <包名*>.<類名>

package samplePackage;

public class Apple {

    public static void main(String[] args) {
        System.out.println("Hello Apple");
    }

}

編譯、執行指令如下

javac src/samplePackage/Apple.java 

# 指定到 src 目錄下找 class
# 找 samplePackage 包下的 Apple
java -classpath ./src samplePackage.Apple 

● 而 -classpath 的設定則要依照你要呼叫的類的 package ＆ 你當前的路徑去做設定

當前路徑是 /Users/Hy-KylePan/IdeaProjects/JavaTest

Class 檔案是在當前路徑下的 src/samplePackage/Apple.class

而 Apple.class 的 package 是 samplePackage，相較之下是缺少了 ./src 目錄，所以 -classpath 要設定 ./src

# 尚未編譯請先編譯
javac ../src/com/example/*.java -sourcepath ../src/ -d ../classes/

jar -cvf ./myJar.jar ../classes/com/example/*.class 

可使用 *.class 代表該目錄下的所有文件

jar -xvf ./myJar.jar

● META-INF/MANIFEST.MF 檔案

該檔案描述了 JAR 檔的資訊

Manifest-Version: 1.0
Created-By: 17.0.7 (JetBrains s.r.o.)

● 而我們前面有提到 java 命令可以指定 -jar 並找到對應的類執行，如果要達成這個條件就要稍微修改一下解開的 jar 包；步驟如下

A. 在 classes 目錄下創建 Manifest.txt 檔案

touch classes/Manifest.txt

B. 將主程式類別寫入 Manifest.txt 檔案

Main-Class: com.example.Main

要寫入 全類名！(由於當前範例就是直接在 java 目錄下，所以很單純)

● 坑：必須以換行結束！

C. 重新打包 classes 目錄下的檔案，在這邊會 用 m 來指定 MANIFEST

jar -cvfm ../deploy/specificManifest.jar \
    ./classes/Manifest.txt *.*

● 測試使用 java 並指定 jar 執行

java -jar /home/alien/IdeaProjects/java_learn/deploy/specificManifest.jar

/**
 * <p><strong>This is main class</strong></p>
 */
public class TestMain {
    /**
     * @param  args is input from user or other process.
     */
    public static void main(String[] args) {
        System.out.println("Hello world!");
    }

    /**
     * Default value is 0
     */
    private int value = 0;

    /**
     * @see #value show self param of `value`.
     * @see #setValue(int) Use this method to set value.
     */
    public void showValue() {
        System.out.println("Value: " + value);
    }

    /**
     * Set new value for instance that TestMain.
     * @param value new value.
     */
    public void setValue(int value) {
        this.value = value;
    }
}

執行以下命令生成檔案

javadoc -public -protected -private -sourcepath src/ -d ./doc com.example 

/**
 * <p><strong>This is link class</strong></p>
 */
public class TestLink {

    boolean isStart = false;

    /**
     * <ul>
     *     <li>if {@link #isStart isStart} is false, show sleeping.</li>
     *     <li>if {@link #isStart isStart} is true, show working.</li>
     * </ul>
     */
    public void showState() {
        if (isStart) {
            System.out.println("Start working.");
        } else {
            System.out.println("Sleeping.");
        }
    }

}

執行以下命令生成檔案

javadoc -public -protected -private -sourcepath src/ -d ./doc com.example 

javadoc -protected \
    -sourcepath src/ \
    -d ./doc \
    src/com/example/TestLink.java

● 如果有特別指定文件，那就 javadoc 不會自動處理別的文件

javadoc -splitindex \
    -protected \
    -sourcepath src/ \
    -d ./doc \
    com.example