遵从惯例我的第一章就是hello world。咱们通过Hello World来打开这个世界的大门。这里我们使用Spring Boot来做我们的基础框架。Spring Boot提供了很多生产级的特性。

基础框架:Spring Boot

构建工具：Maven

IED：IntelliJ IDEA

运行效果

浏览器中运行结果：

image

命令行中运行结果：

image

在REST Client Postman中运行效果:

image

在今后的演示中也可能会穿插使用。

服务搭建

接下来我们来一步一步搭建这个服务。

首先访问http://start.spring.io/来获取项目的初始化框架。使用该页面可以很方便的生成一个可运行的工程；选择结果如下图所示。

我们建立的是一个Maven工程，基于的是java 语言，使用的是Spring Boot 的最新版本2.0.0

Group:你的项目组名称；

artifact:你的子项目名称；

image

点击 Switch to the full version. 会显示出更多信息，

name:也是你的子项目名称，跟artifact的区别是他真的是一个名称，artifact是你工程里面包的结构,而且影响生成的可执行文件的名称，一般这两个属性使用同一值；

description:项目的描述信息；

package Name:项目包，跟 artifact 会联动不需要手动更改；

packageing:打包的方式，不需要更改，是用内嵌式服务器是之后的趋势。而且跟方便运行及其调试；

java version:8 目前的主流稳定版本。虽然java9 已经发布，但是使用8是一个更好的选择，服务端最重要的是稳定；

因为我们只是要做一个提供"Hello world" 提示语的服务。我们只需要选择一个Web的选项。

image

点击 Generate Project 下载我们的工程。

代码编写

我们有了上面的工程现在我们需要将工程导入到我们的开发工具中，我使用的是IntelliJ IDEA 的社区版本。打开后点击Import Project来导入我们的工程，直接全部点击下一步。

image

之后我们建立项目的包结构，增加com.tong467.helloword.web.controller,com.tong467.helloword.entity.

之后增加class 。IndexController ，ResMsg<T>;

具体结构如下

image

IndexController

package com.tong467.hellowrold.web.controller;

import com.tong467.hellowrold.entity.ResMsg;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class IndexController {

    @RequestMapping("")
    public ResMsg index() {
        ResMsg<String> regMsg = new ResMsg<>();
        regMsg.setData("Hello World");
        return regMsg;
    }
}

你可以简单理解为他是你服务具体地址一的一个映射关系的实现；用户在访问你的服务http://127.0.0.1:8080跟目录是请求将被转发至index这个方法。

ResMsg

package com.tong467.hellowrold.entity;

public class ResMsg<T> {

    private int code;
    private String msg;
    private T data;

    public ResMsg(){
        code = 0;
        msg = "成功";
    }
    
    public int getCode() {
        return code;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

这是我定义的一个通用的返回值类。对用于请求返回值的一个抽象；code 标识我接口对于这个请求的处理结果，msg用于我对于这个请求的描述信息，一般只有code 不为0时有意义，为一个提示性信息。
HelloWroldApplication

package com.tong467.hellowrold;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class HelloWroldApplication {

    public static void main(String[] args) {
        SpringApplication.run(HelloWroldApplication.class, args);
    }
}

这个类是我们下载好就有的类我们不需要做任何改动。

image.png

点击红框内的绿色按钮就可以在IDE中运行我们的程序。
当启动完成，就可以去浏览器，或者命令行，或者REST client 中查看我们的运行效果。

发布方式

当然上述描述的是在IDE中的运行，当你真正想交付使用的时候肯定不可能是在IDE中运行的。要生成一个可发布的程序我们需要借用maven。进入到我们的项目根目录

image.png

运行 mvn package 命令；
当出现 BUILD SUCCESS 说明我们执行成功了。进入target文件夹你就会发现你的可执行文件了hello-wrold-0.0.1-SNAPSHOT.jar这就是一个只要有java 环境就可运行的程序了。
如果你想启动这个程序，使用 java -jar hello-wrold-0.0.1-SNAPSHOT.jar 当他启动成功，你可以在次使用你的 浏览器，或者命令行，或者REST client去查看运行效果；