非spring的java项目打包(maven+原生)

一、maven打jar包

1.1 没有第三方依赖的jar

java -jar maven项目打包提示.jar中没有主清单属性


    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <addClasspath>true</addClasspath>
                            <mainClass>com.leon.Main</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>

1.2 有第三方依赖的jar

参考:最高赞
How can I create an executable/runnable JAR with dependencies using Maven?

1. 把第三方依赖与自己的代码打成一个jar

<build>
  <plugins>
    <plugin>
      <artifactId>maven-assembly-plugin</artifactId>
      <configuration>
        <archive>
          <manifest>
            <mainClass>fully.qualified.MainClass</mainClass>
          </manifest>
        </archive>
        <descriptorRefs>
          <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
      </configuration>
      <executions>
        <execution>
          <id>make-assembly</id> <!-- this is used for inheritance merges -->
          <phase>package</phase> <!-- bind to the packaging phase -->
          <goals>
            <goal>single</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

2 把第三方依赖放入其他目录,自己的代码单独形成jar

需要两个plugin结合使用
注意

  1. outputDirectory,就是生成的可运行的jar的依赖的目录
  2. maven-jar-plugin的classpathPrefix,作用是生产的可运行jar的MANIFEST.MF里面的Class-Path
  3. 这个方法,并不用我手动copy lib到项目里面,maven会自己从仓库里面copy
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>copy-dependencies</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/lib</outputDirectory>
                <overWriteReleases>false</overWriteReleases>
                <overWriteSnapshots>false</overWriteSnapshots>
                <overWriteIfNewer>true</overWriteIfNewer>
            </configuration>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <configuration>
        <archive>
            <manifest>
                <addClasspath>true</addClasspath>
                <classpathPrefix>lib/</classpathPrefix>
                <mainClass>theMainClass</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

二、java命令打jar包

0、代码目录结构

projectDir\
└—— src\com\leon\xxx.java…
└—— lib\xxx.jar
└—— META-INF\MANIFEST.MF
└—— target\classes

  • 4个目录的结构都不是死的,都可以改变,但是以上的结构比较符合一般的项目结构
  • lib下放三方依赖
  • META-INF,一般是hyphen而不是underline,别记错写错。MANIFEST.MF可以写成txt,只要在参数里指定就好

1、javac编译成classes

javac -encoding UTF-8 -classpath .\lib\commons-lang3-3.7.jar -d .\target\classes src\com\leon\Main.java
option参数说明
-encoding UTF-8java文件中文编码
-d .\target\classes将打包的class文件输出到指定目录
-classpath .\lib\xxx.jar简写-cp
指定依赖的第三方jar
目录以【.\】开头或者省略【.\】似乎没关系,并不会导致固定死目录(包含本地目录比如D盘)
source file参数
src\…java应该能简写成目录,有时间再验证

2、验证classes的正确性

java -cp target\classes;lib\commons-lang3-3.7.jar com.leon.Main abc
  1. java运行class,首先需要指定自定义的classes的位置,-cp target\classes
  2. java命令的class参数要写【package的路径+class名字】,com.leon.Main
    如下
    这个路径,没有包含目录src,src仅仅是一个目录,它不在java文件的package命令里面
package com.leon;
	public class Main {
	}
  1. 注意 -cp命令没有以【.\】开头

可能的错误

  • java.lang.NoClassDefFoundError: xxx第三方引用
    -cp参数要指定第三方包,lib\commons-lang3-3.7.jar,多个第三方jar以semicolon分割

3、jar打包

95%内容参考自oracle的官方文档,Packaging Programs in JAR Files

jar的命令格式以jdk的帮助讲解,如下

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

jar命令是打包,命令类似linux tar

{}参数(只能选一个)

参数说明
c打包成成为jar
基本不用
x解压jar
t显示jar中的内容
u更新jar
x或i没试过

[]参数

重要参数说明
m指定MANIFEST文件
f打包的jar的名字,这个参数不传会output will go to a stdout(什么人或者为啥要go to stdout?)
e可以指定class的入口。
C去掉指定的目录层级。看实例。
不重要参数
v打包时,显示详细的信息
0不压缩。不压缩的jar据oracle网站说运行更快,压缩体积更小
Mjar内不要MANIFEST,为啥不要?
注意:

m与f参数的顺序与[jar-file] [manifest-file]顺序是必须对应的。

正确jar命令

jar cvfm Main.jar META-INF\MANIFEST.MF com\leon\Main.class -C target\classes .

MANIFEST.MF

  • 自定义的MF文件,每行都是键值对的形式,以colon分割
    These lines show that a manifest’s entries take the form of “header: value” pairs.
  • 自定义的MF文件可以写成txt,也可以.MF,文件名也可以任意,但是需要通过【m 参数+[manifest-file]】
  • 自定义的MF文件最后一行不会被写入到jar包中的MANIFEST.MF中,所以自定义的MF文件最后一行必须是空行
    来源:
    Modifying a Manifest FileWarning: The text file from which you are creating the manifest must end with a new line or carriage return. The last line will not be parsed properly if it does not end with a new line or carriage return.
  • MF文件需要以UTF-8编码
Main-Class

这个是程序入口点

Main-Class: com.leon.Main

Class-Path

格式 Class-Path: jar1-name jar2-name directory-name/jar3-name

Class-Path: lib\commons-lang3-3.7.jar

  1. 在某个回答上看,不能以\开头(linux是/)。没验证
  2. jar包之间以空格分割
  3. 我看别人打包有以【.】开头的,如下,是为了把当前文件夹也包括进去?
Class-Path: . xxx1.jar xxx2.jar

jar打包正确之后,java -jar却报错“找不到或无法加载主类 xxx”

很可能是jar包中目录错误

jar包的正确结构

xxx.jar
└—— com\leon\xxx.class…
└—— META-INF\MANIFEST.MF

jar包的错误结构

xxx.jar
└—— target\classes\com\leon\xxx.class…
└—— META-INF\MANIFEST.MF

解决办法一 切换目录法

cd进入classes中package目录的上一层,以示例来说,就是target\classes
然后,jar命令打包————目的就是要去掉jar中的target\classes这两层不必要的目录
然后,把jar放入到合适的位置运行java -jar(与第三方依赖的相对正确的位置)

解决办法二 -C参数(推荐)
jar cvfm Main.jar META-INF\MANIFEST.MF com\leon\Main.class -C target\classes .

-C 参数的含义就是要“剥去”jar包中的某些目录层级
注意

  1. com\leon\Main.class是位于target\classes中的(这里与src目录无关)
  2. -C参数最后有一个【空格+.
    参考,could not find or load main class with a jar file,中作者Log2的回答,他解释的非常清楚,两种解决办法都有提到。

可能的错误

  • 提示 xxx.jar中没有主清单属性,打开jar
    以下命令会在jar中生成默认MF,位置在xxx.jar\META-INF\MANIFEST.MF,但是里面没有Main-Class
    需要用-m或-e参数指定
    jar -cvf Main.jar .\classes\com\leon\Main.class
    
  • 有m选项,也自定义了MANIFEST.MF,但是jar中的MANIFEST.MF还是没有Main-Class
    看看是不是MF文件只写了一行,没有在后面跟一个空行
  • 报错 java.io.IOException: invalid header field
    前面oracle文档说了,“header: value” pairs,所以,这个报错与MF格式有关
  • 26
    点赞
  • 16
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值