Vert.x 之 HelloWorld

本文將會創建一個基本的HTTP服務器，並監聽8080端口，對於任何發往該服務器以及端口的請求，服務器會返回一個Hello World字符串。

首先新建一個Maven項目，一個基本的Maven項目目錄結構以下所示：

├── pom.xml
├── src
│   ├── main
│   │   ├── java
│   │   └── resources
│   └── test
│       └── java

 

隨後在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">
    <modelVersion>4.0.0</modelVersion>

    <groupId>io.example</groupId>
    <artifactId>vertx-example</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <vertx.version>3.4.2</vertx.version>
        <main.class>io.example.Main</main.class>
    </properties>

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-core</artifactId>
            <version>${vertx.version}</version>
        </dependency>
    </dependencies>

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

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>2.4.2</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>${main.class}</Main-Class>
                                    </manifestEntries>
                                </transformer>
                            </transformers>
                            <artifactSet />
                            <outputFile>${project.build.directory}/${project.artifactId}-${project.version}-prod.jar</outputFile>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

 

跟其它Maven項目同樣，咱們首先定義了項目的GroupId，ArtifactId以及版本號，隨後咱們定義了兩個屬性，分別是：vertx.version，也就是Vert.x的版本號，此處咱們使用最新的Vert.x版本，也就是3.4.2；以及main.class，也就是咱們要使用的包含有main函數的主類。以後咱們引入了兩個Maven插件，分別是maven-compiler-plugin和maven-shade-plugin，前者用來將.java的源文件編譯成.class的字節碼文件，後者可將編譯後的.class字節碼文件打包成可執行的jar文件，俗稱fat-jar。

而後咱們在src/main/java/io/example目錄下新建兩個java文件，分別是Main.java和MyFirstVerticle.java，代碼以下：

Main.java

package io.example;

import io.vertx.core.Vertx;

/**
 * Created by chengen on 26/04/2017.
 */
public class Main {
    public static void main(String[] args){
        Vertx vertx = Vertx.vertx();

        vertx.deployVerticle(MyFirstVerticle.class.getName());
    }
}

 

MyFirstVerticle.java

package io.example;

import io.vertx.core.AbstractVerticle;

/**
 * Created by chengen on 26/04/2017.
 */
public class MyFirstVerticle extends AbstractVerticle {
    public void start() {
        vertx.createHttpServer().requestHandler(req -> {
            req.response()
                    .putHeader("content-type", "text/plain")
                    .end("Hello World!");
        }).listen(8080);
    }
}

 

而後用Maven的mvn package命令打包，隨後在src的同級目錄下會出現target目錄，進入以後，會出現vert-example-1.0-SNAPSHOT.jar和vert-example-1.0-SNAPSHOT-prod.jar兩個jar文件，後者是可執行文件，在有圖形界面的操做系統中，您可雙擊執行，或者用如下命令：java -jar vert-example-1.0-SNAPSHOT-prod.jar執行。

隨後打開瀏覽器，在瀏覽器的地址欄中輸入：http://localhost:8080/ 即可看到熟悉的Hello World!啦。

啓動器

咱們也能夠使用Launcher來替代Main類，這也是官方推薦的方式，在pom.xml中加入main.verticle屬性，並將該屬性值設置爲maven-shade-plugin插件的manifestEntries的Main-Verticle對應的值，最後修改main.class爲io.vertx.core.Launcher，修改後的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">
    <modelVersion>4.0.0</modelVersion>

    <groupId>io.example</groupId>
    <artifactId>vertx-example</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <vertx.version>3.4.2</vertx.version>
        <main.class>io.vertx.core.Launcher</main.class>
        <main.verticle>io.example.MainVerticle</main.verticle>
    </properties>

    <dependencies>
        <dependency>
            <groupId>io.vertx</groupId>
            <artifactId>vertx-core</artifactId>
            <version>${vertx.version}</version>
        </dependency>
    </dependencies>

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

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>2.4.2</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>${main.class}</Main-Class>
                                        <Main-Verticle>${main.verticle}</Main-Verticle>
                                    </manifestEntries>
                                </transformer>
                            </transformers>
                            <artifactSet />
                            <outputFile>${project.build.directory}/${project.artifactId}-${project.version}-prod.jar</outputFile>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

 

而後在src/main/java/io/example目錄下新增MainVerticle.java文件，代碼以下：

package io.example;

import io.vertx.core.AbstractVerticle;

/**
 * Created by chengen on 26/04/2017.
 */
public class MainVerticle extends AbstractVerticle {
    public void start() {
        vertx.deployVerticle(MyFirstVerticle.class.getName());
    }
}

 

而後從新打包後執行，即可再次看到Hello World!。

請注意：從新打包以前，您可能須要清除以前編譯後留下的文件，用mvn clean package命令打包。