java -cp & java jar的区别

java -cp 和 -classpath 一样，是指定类运行所依赖其他类的路径，通常是类库，jar包之类，需要全路径到jar包，window上分号“;”

语法：java -cp classpath packname.MainClassName

说明：java -cp 运行命令用于指定 Java 程序运行时所需的 classpath 路径，多个路径之间用分号（Windows）或冒号（Unix/Linux）分隔；MainClassName 是包含 main 方法的 Java 类的全限定类名，它的执行将作为 Java 程序的入口点。使用时根据实际情况指定不同的 classpath 路径和 MainClassName 全限定类名。

示例1：java -cp .;test.jar test.core.Core 

示例2：java -cp test.jar test.core.Core 

表达式支持通配符，例如：
java -cp .;c:\classes01\test.jar;c:\classes02\*.jar  test.core.Core 

示例：
vi Core.java
package test.core;

public class Core {
    public static void main(String args[]) {
        System.out.printf("Hello world!");
    }
}

执行jar
java -cp test.jar test.core.Core

如果 MainClass 类包含在名为 test.jar 的 jar 包中，则可以使用以下命令来运行它：
java -jar test.jar

java -jar test.jar

执行该命令时，会用到目录META-INF\MANIFEST.MF文件，在该文件中，有一个叫Main-Class的参数，它说明了java -jar命令执行的类。


用maven导出的包中，如果没有在pom文件中将依赖包打进去，是没有依赖包。
1.打包时指定了主类，可以直接用java -jar xxx.jar。
2.打包是没有指定主类，可以用java -cp xxx.jar 主类名称（绝对路径）。
3.要引用其他的jar包，可以用java -classpath $CLASSPATH:xxxx.jar 主类名称（绝对路径）。其中 -classpath 指定需要引入的类。


下面基于pom和META-INF\MANIFEST.MF两个文件的配置，进行了三种情况的测试：
pom.xml的build配置：
    <build>
        <!--<finalName>test-1.0-SNAPSHOT</finalName>-->
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <archive>
                        <manifest>
                        <mainClass>test.core.Core</mainClass>
                        </manifest>
                    </archive>
                    <descriptorRefs>
                        <descriptorRef>jar-with-dependencies</descriptorRef>
                    </descriptorRefs>
                </configuration>
                <!--下面是为了使用 mvn package命令，如果不加则使用mvn assembly-->
                <executions>
                    <execution>
                        <id>make-assemble</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>




META-INF\MANIFEST.MF的内容：
Manifest-Version: 1.0
Main-Class: test.core.Core
 

Java 的 jar 文件中的 META-INF 目录说明：
这个目录下会有一些文件，其中必有一个 MANIFEST.MF，这个文件描述了该Jar文件的很多信息：
Manifest-Version：用来定义 manifest 文件的版本，例如：Manifest-Version: 1.0。
Created-By: 声明该文件的生成者，一般该属性是由jar命令行工具生成的，例如：Maven JAR Plugin 3.3.0。
Signature-Version: 定义jar文件的签名版本。
Class-Path: 应用程序或者类装载器使用该值来构建内部的类搜索路径。
Main-Class: 应用程序属性，用来定义jar文件的入口类，该类必须是一个可执行的类，一旦定义了该属性即可通过 java -jar Test.jar 来运行该 jar 文件。例如： Main-Class: com.xxx.fk.Test 注意回车换行。
其他扩展信息这里就不介绍了。

查看一个jar文件的内容（文件列表）命令：
jar tf demo-1.0-SNAPSHOT.jar 

提取一个jar文件的内容（解压释放文件）命令：
jar xf demo-1.0-SNAPSHOT.jar 

1.pom中build指定mainClass 但是 META-INF\MANIFEST.MF文件中没有指定Main-Class: test.core.Core
java -jar test-jar-with-dependencies.jar //执行成功
java -cp test-jar-with-dependencies.jar  test.core.Core  //执行失败，提示jar中没有主清单属性


2.pom中build没有指定mainClass 但是 META-INF\MANIFEST.MF文件中指定了Main-Class: test.core.Core
java -jar test-jar-with-dependencies.jar //执行失败，提示jar中没有主清单属性
java -cp test-jar-with-dependencies.jar  test.core.Core  //执行成功


3.pom中build指定mainClass && META-INF\MANIFEST.MF文件中增加了Main-Class: test.core.Core
java -cp test-jar-with-dependencies.jar  test.core.Core  //执行成功
java -jar test-jar-with-dependencies.jar  //执行成功

另外：

java -jar test-jar-with-dependencies.jar

如果有依赖的lib需要加载，则执行：
java -Xbootclasspath/a:dep.jar -jar test-jar-with-dependencies.jar

注意：-classpath 没有用，如果执行：java -classpath dep.jar -jar test-jar-with-dependencies.jar 无效。原因是使用 classpath 指定的 jar 是由 AppClassloader 来加载，java 命令加了-jar 参数之后，AppClassloader 就只关注 -jar 指定的 jar 文件范围内的 class 了，classpath 参数失效。
可以使用下面参数指定依赖jar的加载：
-Xbootclasspath/a: 在系统class加载后加载。通常用这个。
-Xbootclasspath/p: 在系统class加载前加载，容易和系统类冲突。

====================================

# jar 执行脚本示例：

vi test.sh

#!/bin/bash

# shell script for test excuting

classMainDef=com.xxx.qftools.dbconnector.Main
classMain=$classMainDef

echo "***********************************************************"
if [ $# == 1 ]; then
  classMain=$1
else
  echo "classMain input is null, will used default classMain."
  echo "to special mainClass, use like this eg: $0 com.xxx.qftools.dbconnector.Main"
fi
echo "classMain: $classMain"
echo "***********************************************************"

# -jar : jar build 打包时如果已经指定了 <mainClass>...</mainClass> 则直接使用 -jar，无需再指定 mainClass，使用jar中定义的mainClass
# java -Xbootclasspath/a:lib/gbase-connector-java-9.5.0.1-build1-bin.jar  -Xbootclasspath/a:lib/mysql-connector-java-5.1.35-bin.jar  -jar dbconnector-1.0-SNAPSHOT-shaded-with-dependencies.jar

# -cp : jar build 打包时如果未指定 <mainClass>...</mainClass> 则使用 -cp，执行的时候要指定 mainClass
java -Xbootclasspath/a:lib/gbase-connector-java-9.5.0.1-build1-bin.jar  -Xbootclasspath/a:lib/mysql-connector-java-5.1.35-bin.jar  -cp dbconnector-1.0-SNAPSHOT-shaded-with-dependencies.jar $classMain