使用 Springboot 编写 Helloworld 应用

在 Windows 平台安装 Springboot 应用开发环境

Springboot 框架是当前 Java 语言中最流行的微服务开发框架,本篇文章采用的操作系统是 Win10, Java 版本是 JDK8,编辑器使用 IDEA 专业版。

在 Win10 下安装 JDK8

首先下载 JDK,点击 JDK8 下载链接,我选择的版本是:jdk-8u152-windows-x64.exe,下载完成后依次点击安装,以下是我安装的路径:

1
2
3
D:\Program Files\Java
jdk1.8.0_152
jre1.8.0_152

接下来配置下 JDK 环境变量,依次选择:“我的电脑” > “鼠标右键” > “属性” > “高级系统设置”,进入环境变量设置页面。

在“系统变量”栏中点击“新增”,变量名为:JAVA_HOME,变量值为:D:\Program Files\Java\jdk1.8.0_152;

接着继续点击“新增”按钮,变量名为:CLASSPATH,变量值为:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;

在系统变量栏选择“Path”,然后点击“编辑”,在弹出的“编辑环境变量”对话框中点击“新增”按钮,然后输入:%JAVA_PATH%\bin,最后再点击“确认”按钮。

安装配置完成了,检验下是否安装安装成功了:按下键盘 Win + R 组合键,在弹出的对话框输入栏中输入命令:cmd,在 cmd 命令行窗口中输入命令:java -version,查看 Java 版本号:

1
2
3
4
C:\Users\Administrator>java -version
java version "1.8.0_152"
Java(TM) SE Runtime Environment (build 1.8.0_152-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.152-b16, mixed mode)

安装成功了。

在 Win10 下安装 IDEA 专业版

首先下载软件包,进入官网,选择 “Ultimate”专业版下载,下载完成后也是按照提示一步一步按照即可。由于专业版是收费版本,如果资金允许还是支持下正版吧,如果想破解的话也很简单,点击获取 IDEA 注册码,然后就可以很方便的破解了。

创建 Springboot 应用

安装 gradle

首先下载软件包,进入官网,然后找到 windows 版本的软件包,下载安装即可,最后再配置下环境变量;

即可,最后进入 cmd 窗口验证是否安装、配置成功:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
C:\Users\Administrator>gradle -v

------------------------------------------------------------
Gradle 5.4
------------------------------------------------------------

Build time: 2019-04-16 02:44:16 UTC
Revision: a4f3f91a30d4e36d82cc7592c4a0726df52aba0d

Kotlin: 1.3.21
Groovy: 2.5.4
Ant: Apache Ant(TM) version 1.9.13 compiled on July 10 2018
JVM: 1.8.0_152 (Oracle Corporation 25.152-b16)
OS: Windows 10 10.0 amd64

安装成功。

使用 IDEA 创建 Springboot 应用

打开 IDEA,选择创建新工程,在弹出的“New Project”对话框中的左侧导航栏中选择“Spring Initializr”,右上方的“Project SDK”选择 java1.8,如下图所示:

然后点击“next”按钮,这里我们使用 gradle 作为工程的依赖管理工具,跟 maven 相比 gradle 会显得简洁不少。具体填写信息如下图所示:

接着点击“next”按钮,因为我们打算编写 Web 应用,所以这里的依赖选择 Web:

然后继续点击“next”按钮,即可完成工程的创建。

在弹出的“Import Module from Gradle”对话框中直接点击“Ok”即可:

基于 gradle 的 springboot 工程简要说明

在新创建的工程中,当打开 buid.gradle 文件时发现右上方有提示询问你要不要安装 gradle wrapper,这里我们选择安装它,gradle wrapper 简单理解就是如果安装了它尽管当前系统没有安装 gradle 一样可以使用 gradlew 命令作为依赖管理,所以很方便。

当 gradle wrapper 安装完成后,你会发现工程目录下多出了 gradlew 和 gradlew.bat 两个文件,这两个文件就是对 gradle 的二次封装,一个可以在 Linux 平台使用(gradlew)一个在 Windows 平台使用(尽管没有安装 gradler 也可以使用)。

接下来简要说说 build.gradle 文件,这个文件就相当于 maven 工程的 pom.xml 文件,是对整个工程依赖包的说明,我对这个文件补充一些注释并给仓库添加了国内源,这样在拉取依赖包的时候速度会快很多。具体如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
plugins {
id 'org.springframework.boot' version '2.1.4.RELEASE'
id 'java'
}

// 使用spring boot的自动依赖管理
apply plugin: 'io.spring.dependency-management'

group = 'com.chenliangtang'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '1.8'

repositories {
// 优先使用国内源
maven {url 'http://maven.aliyun.com/nexus/content/groups/public/'}
mavenCentral()
}

// 依赖列表
dependencies {
implementation 'org.springframework.boot:spring-boot-starter-web'
testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

编写 hello world

springboot 有它的代码规范,整个代码都放在 src 目录下,其中 main 目录是放真正的业务代码, test 目录放的是测试代码,如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
src/
├── main
│   ├── java
│   │   └── com
│   │   └── chenliangtang
│   │   └── hellospringboot
│   │   └── HellospringbootApplication.java
│   └── resources
│   ├── application.properties
│   ├── static
│   └── templates
└── test
└── java
└── com
└── chenliangtang
└── hellospringboot
└── HellospringbootApplicationTests.java

在 com.chenliangtang.hellospringboot 目录下创建 controller 目录,该目录下放置的是前端控制代码,然后新增代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
package com.chenliangtang.hellospringboot.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class HelloworldController {
@GetMapping("/")
@ResponseBody
public String Home() {
return "HelloWorld.";
}
}

上述代码逻辑很简单,就是定义了一个接口为 / 的 get 请求,返回内容为 HelloWorld。

OK,接下来运行下程序。运行方式可以是 GUI 的点击方式,也可以是命令行,GUI 方式如下图所示双击 bootRun 即可:

也可在 Terminal 栏下输入命令运行,如下图所示:

在客户端(我在 Linux 上用 curl 命令,也可以用浏览器访问)上访问:

1
2
# curl 192.168.43.244:8080/
HelloWorld.

到此完成!