Vert.x 入门教程通过maven shade plugin插件打包发布

引言

    上一篇文章eclipse vertx入门教程我们主要初步的了解了下eclipse vert.x是什么有什么用。当然一个程序编写完成后最终还是需要打包发布的，vert.x框架也一样。这里将讲解一种通过maven shade plugin插件打包发布的方法。

一.Vert.x打包环境准备

• eclipse （当然也可以是你常用的IED例如idea等）
• jdk1.8+
• maven 3+

二.创建一个常规的maven项目

项目结构图




项目中创建了一个简单的vertx程序，代码如下:

package net.xqlee.project.demo.vertx;

import io.vertx.core.AbstractVerticle;

/**
 * 
 * @author xqlee
 *
 */
public class TestVerticle extends AbstractVerticle {
	@Override
	public void start() {
		// 创建一个简单的HTTP服务
		vertx.createHttpServer().requestHandler(req -> req.response().end("Hello World!")).listen(8080);
	}
}

可以看到上面的这个程序真的很简单。就是编写了任何访问8080端口的都将返回一个Hello World的字符。

接下来就是maven项目的依赖文件pom.xml文件。这里主要引入了vertx-core版本为最新的vertx版本3.5.0

pom.xml文件:

<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>net.xqlee.project.demo</groupId>
	<artifactId>demo-verx-package</artifactId>

	<dependencies>
		<dependency>
			<groupId>io.vertx</groupId>
			<artifactId>vertx-core</artifactId>
			<version>3.5.0</version>
		</dependency>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.12</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>io.vertx</groupId>
			<artifactId>vertx-unit</artifactId>
			<version>3.5.0</version>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>3.1</version>
				<configuration>
					<source>1.8</source>
					<target>1.8</target>
				</configuration>
			</plugin>
		</plugins>
	</build>
	<!-- 指定jdk -->
	<profiles>
		<profile>
			<id>jdk18</id>
			<activation>
				<activeByDefault>true</activeByDefault>
				<jdk>1.8</jdk>
			</activation>
			<properties>
				<maven.compiler.source>1.8</maven.compiler.source>
				<maven.compiler.target>1.8</maven.compiler.target>
				<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
			</properties>
		</profile>
	</profiles>
	<version>1.0</version>
</project>

三.使用maven shade插件打包vert.x项目

首先在pom.xml文件中的
build>plugins添加以下代码片段,引入maven的maven-shade-plugin插件

<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-shade-plugin</artifactId>
	<version>3.1.0</version>
	<executions>
		<execution>
			<phase>package</phase>
			<goals>
				<goal>shade</goal>
			</goals>
			<configuration>
				<transformers>
					<transformer
						implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
						<manifestEntries>
							<Main-Class>io.vertx.core.Starter</Main-Class>
							<Main-Verticle>net.xqlee.project.demo.vertx.TestVerticle</Main-Verticle><!-- 
								配置自己的主Verticle -->
						</manifestEntries>
					</transformer>
				</transformers>
				<artifactSet />
				<outputFile>${project.build.directory}/${project.artifactId}-${project.version}-fat.jar</outputFile>
			</configuration>
		</execution>
	</executions>
</plugin>

这里需要你自己配置的就是一个Main-Verticle路径，我这里就配置了测试的Verticle

运行eclipse的maven install

刷新项目查看target目录：




查看上面的截图我们可以看到比平时打包多了一个fat的jar包。这就是打的一个可运行的jar包。通过jdk1.8+的环境可以在仍和地方进行运行。接下来我们将这个包复制出来放到d:盘.

打开Windows系统的cmd窗口切换至D盘执行命令:

java -jar demo-verx-package-1.0-fat.jar

可以看到已经成功部署了Verticle，打开浏览器输入地址:http://localhost:8080验证以下:




可以看到确实已经启动完成。

结尾

到这里vert.x通过maven插件maven-shade-plugin打包项目的教程到这里就结束了。后续将发布其他打包运行环境方式。欢迎关注。