本篇博客主要介绍一下jar文件的基本作用和maven的基本使用。
jar包
什么是jar包?
jar是Java ARchive的缩写,是一种基本zip格式的文件格式。目标是将java生成的类文件、资源文件、管理文件等按照特定的结构打包成一个独立的文件,方便程序的发布或网络的下载。
cmd环境下打jar包
首先,我们创建出目录结构/com/sss,然后在sss目录下我们新建一个Test.java文件,写入下列代码:
package com.sss;
public class Test {
public static void main(String[] args) {
System.out.println("你好,世界!");
}
public static void sayHello(String target) {
System.out.println("Hello " + target + "!");
}
}
然后,我们编译Test.java,生成Test.class文件。
javac Test.java -encoding utf-8
最后,我们来打jar包。
jar cvf Test.jar com\sss\Test.class
我们解压一下Test.jar,观察一下它的目录结构:
程序中如何使用jar包中的类
我们创建一个新的文件夹use_jar,然后将Test.jar拷贝到该文件夹下,然后创建一个Main.java,代码如下:
import com.sss.Test;
public class Main {
public static void main(String[] args) {
Test.sayHello("jar包");
}
}
然后,我们来编译该程序。
javac Main.java -encoding utf-8
为什么会出这个错呢?
这是因为我们的类放在jar包中,javac编译器无法找到这个类文件,所以我们需要通过指定classpath的方式,告诉编译器去哪里找到com.sss.Test类。
javac Main.java -encoding utf-8 -classpath ./Test.jar
可以看到,当我们手动指定该去哪找对应的类的时候,javac能够找到该类,就编译成功了。
下面,我们来运行一下:
java Main
可以看到运行时有异常抛出,这个原因和前面的原因是类似的,不过这次是JVM找不到类,所以我们可以同样使用classpath的方式来告诉JVM,com.sss.Test类的路径。
java -classpath "Test.jar;./" Main
将jar包转变为可执行程序入口
前面我们解压了jar包,看到了里面的目录结构,我们发现里面生成了一个MANIFEST.MF文件,这个文件的作用是什么呢?
我们可以简单的理解:将Test.class当成是送给朋友的礼品,Test.jar就是一个包装好的礼盒。那么MANIFEST.MF可以理解为礼品清单,里面说明了朋友应该如何使用我们的礼品。
我们打开MANIFEST.MF文件来看一下:
里面简单描述了我们jar包的版本和创建工具。
格式是按照下面的形式给出,其中支持哪些标签,需要时查询相关资料即可。
标签:值
这里我们需要了解一下Main-Class标签,这个标签的含义是指定我们打包好的jar包中,哪个类是我们程序的入口类,换句话说,我们直接运行jar包时,JVM启动哪个类中的main方法。
下面我们来创建一个可以直接执行的jar包。
新建一个Manifest.txt,写入一下内容:
Main-Class: com.sss.Test
注意:一定要在最后跟一个空行。
然后,我们在cmd环境下执行下述指令。
jar cvfm Runnable.jar Manifest.txt com\sss\Test.class
最后,我们运行带有Main-Class的jar包,在cmd下执行下列命令:
java -jar Runnable.jar
IDEA中如何打jar包和使用jar包
IDEA中打jar包流程:
- 首先,我们新建一个模块,然后写一个类:
- 我们点击导航栏的File,选中其中的Project Structure。
- 然后点击Artifacts,点击加号,选择JAR,选择From modules with dependencies…
- 选择我们要打成jar包的模块。
- 最后可以选择是否设置Main Class,这里我们设置成Test.class,点击OK
- 最后我们在Build中点击Build Artifacts…,Action选中build即可。
- 生成jar包的路径可以在Project Structure中查看,也可以修改。
- 最后,我们看一下jar包所在的位置。
- 我们来执行一下这个jar包。
IDEA中使用jar包流程:
- 首先,创建一个目录lib,然后将要使用的jar包拷贝到该目录下。
- 右键项目,点击Open modules Settings
- 点击Modules,选择对应的模块,点击Dependencies,点击右边的加号,选择第一个JARs or directories…
- 然后选中刚才拷贝过来的jar包,点击Apply即可。
下面看一下使用代码:
import com.sss.Test;
public class Main {
public static void main(String[] args) {
Test.sayHello("IDEA中jar包的使用");
}
}
maven
介绍maven之前,我们先来讨论一下前面通过jar包的方式构建项目的缺点:
- 需要自行下载jar文件;
- 需要手动将jar文件拷贝到项目目录中;
- 需要更改很多的IDEA配置;
- 如果别人的jar包依赖了其他类库,需要递归上述过程。
上述过程过于繁琐,maven的主要功能就是帮我们自动完成上述过程。Apache Maven是一种用于软件项目管理工具,基于Project Object Model(POM),用来管理项目的构建,汇报及文档生成等功能。
使用IDEA创建一个maven项目
- 点击新建项目,点击maven,点击next。
- 输入GroupId和ArtifactId,一般GroupId代表的是机构名称,ArtifactId描述这个项目的名字,给出合适的名字即可。
- 选择项目路径,输入项目名称,点击完成。
- 进入项目后点击Enable Auto-import,至此maven项目创建完成。
我们来看一下项目的目录结构:
- 代码一般在src/main/java;
- src/main/resources下一般是用于同时部署的一些资源文件,例如:图片、音频、视频等;
- src/test/java一般用来放一些测试代码;
- pom.xml为maven最重要的文件,是maven的配置描述文件。
maven的配置文件:pom.xml
pom.xml文件后缀名表示这个文件是用XML格式进行组织。
什么是XML文件呢?简单的去理解,是一种类似与HTML格式的文件,全称Extensible Markup Language,Java语言中经常会用XML用来做配置管理。
具体标签:POM中的标签
下面我们看一下pom.xml中的简单内容:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<!-- 上面的内容完全不用管,使用自动生成的就行,用于一些校验规则的指定 -->
<!-- 指定POM的版本,不需要动 -->
<modelVersion>4.0.0</modelVersion>
<!-- 项目描述信息,新建项目时我们填入的内容 -->
<groupId>com.sss</groupId>
<artifactId>maven_test</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 一般把我们需要的内容附加在下面 -->
<!-- 可以配置一些参数 -->
<properties>
<encoding>UTF-8</encoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
</project>
依赖管理
介绍依赖管理之前,我们先来了解一下maven仓库:
maven仓库是一个类似手机上App Store的东西,上面会有全世界的人上传的各种第三方的jar包供我们使用,当我们的项目需要用到其中的内容时,可以像手机安装App一样方便的进行查找和安装。
我们可以在下面两个网站中搜索我们需要的第三方jar包:
maven仓库
maven仓库
安装更简单,我们只需将下方红框内的内容拷贝一下,然后黏贴到dependencies标签内即可,maven会帮我们自动完成下载。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.sss</groupId>
<artifactId>maven_test</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<encoding>UTF-8</encoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
</dependencies>
</project>
如果需要手动下载,我们可以在pom.xml中右键,选择maven,点击reimport。
构建生命周期
通常,我们理解的工程创建,可以被区分成不同的生命周期(LifeCycle)和阶段(Phase)。
其中maven把各个阶段都做了各自的映射。
- clean(清理):将target目录删除掉;
- compile(编译):将java代码和资源文件夹编译/复制到target/classes;
- test(测试):先执行compile,还会编译测试代码和测试资源,然后执行单元测试代码;
- package(打包):先执行test(可以通过配置不执行test),然后打包;
- install(安装):先执行package,再将打包的文件安装到本地仓库;
- deploy(部署/发布):先执行install,然后提交到公司仓库中,供其他人员使用。
我们可以点击package进行打包,成功后,项目的target文件夹下会生成maven_test-1.0-SNAPSHOT.jar包。
但是这个jar包是不带Main-Class的jar包,即无法直接运行。