『JavaWeb』maven的使用

本篇博客主要介绍一下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包，即无法直接运行。