【开发笔记】Maven 初始化 Java 专案

不知道哪款整合开发工具是各位偏好用来编写 JAVA 程式码的主力选择。如果同时开发 Android App 的时候，通常 Android Studio 会是我的首选。相反在没有 Android Studio 的情况，剩下的 Eclipse 总让人想到就觉得肚子疼...

虽然是老牌工具

Eclipse 真是历史久远的整合开发环境，虽然有很多小技巧可以改善整个人机介面互动上的反应速度。但是笔者几年下来的主观使用感受，相较于其他的开发工具，Eclipse 在卡顿，编译时间，设置难度上，都算是相当不友好，学习曲线较陡的开发工具。

只是想写几行程式码

总会有这样的时候，只是想新建一个专案，写上个几行程式码。然后很快的编辑，编译，输出终端结果。除了安装耗时，肥大臃肿的开发工具。有没有其他更便捷快速的选择呢？其实是有的，几个步骤就能达成。

安装 Java

在这里是以安装 Java 11 为例子，如果是 macOS 环境下，使用 brew 会简单一些。指令 brew search java 会列出可以安装的套件。这里选择了 java11。

brew update
brew search java
brew install java11

如果是 ubuntu 环境下，安装默认的 JRE 最简单

apt install default-jre

安装 Maven

接下来是安装 Maven。Maven 是用来作为专案管理及自动构建新专案的工具。一样建议 macOS 环境使用 brew。

brew search maven
brew install maven

而 ubuntu 环境使用 apt 来安装。

apt update
apt install maven

透过 Maven 新增一个专案

JRE 和 Maven 专案工具备齐，就可以立即开始了。指令很简单如下：

mvn archetype:generate -DgroupId=com.coldyam.mq -DartifactId=mq-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

通常只需要自订 groupId 和 artifactId 就可以了。

groupId 影响程式码路径。
artifactId 决定档案夹名称。

编译套件

编译上也很简单

mvn package

不过各位可能会发现 JRE 版本需要指定 JDK 7 以后的编译错误如下：

...
Source option 5 is no longer supported. Use 7 or later.
Target option 5 is no longer supported. Use 7 or later.
...

这时候需要修改 pom.xml 加上 <build>...</build> 如下

  <build> 
    <plugins>   
      <plugin>
        <artifactId>maven-compiler-plugin</artifactId>   
        <version>3.3</version>
        <configuration>   
          <source>11</source>
          <target>11</target>
        </configuration>   
      </plugin>
    </plugins> 
  </build>

执行 jar

编译成功后，会在 target 目录下看到生成的 jar。这时候，还需要针对路径做一些配置才能正确执行 jar。

jar tvf target/mq-project-1.0-SNAPSHOT.jar 
java -cp target/mq-project-1.0-SNAPSHOT.jar com.coldyam.mq.App

编译引入依赖执行的程式库

不过这样子的执行实在很没有效率，也不是普遍期待的输出形式。因此，更理想的编译方式，应该要把依赖执行的程式库一起也包括进来，类似静态编译，让 jar 可以单独执行。

所需要针对 pom.xml 再进行一点修改，加上 <build>...</build> 两则 plugin 设置。

  <build>
    <plugins>
      <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <source>11</source>
          <target>11</target>
        </configuration>
      </plugin>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <configuration>
          <appendAssemblyId>false</appendAssemblyId>
          <archive>
            <manifest>
              <mainClass>com.coldyam.mq.App</mainClass>
            </manifest>
          </archive>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
        </configuration>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>

然后编译的指令稍微修改如下：

mvn clean compile assembly:single

如此一来，target 中的 jar 就可以立即执行了。

java -jar target/mq-project-1.0-SNAPSHOT.jar