SpringBoot 干货教程 | 第二章:HelloWorld 初体验 SpringBoot 的简单与快捷

原创 springboot

项目构建

目前构建项目有多种方式,这里介绍三种方式,大家可以根据开发工具需要选择。

  1. 使用 Spring 官网 SPRING INITIALIZR 来构建项目,地址:http://start.spring.io/
  2. 使用 Spring 官方推出的 sts (Spring Tool Suite,Eclipse 集成工具) 工具来构建项目
  3. 使用 IntelliJ IDEA 开发工具来构建项目

使用 SPRING INITIALIZR 构建

访问 http://start.spring.io/ 网址就会看到如下界面:

界面主要部分包括:管理工具(我们选 Maven),SpringBoot 版本,包名(Group),工程名(Artifact),依赖模块,我们做一个简单的演示,在 Search for dependencies 搜索框搜选择 Web

点击 Generate Project 就会下载一个根据你输入的信息创建的项目工程架构源码的压缩包。

解压压缩包到平常开发的 workspace 目录,可以看到如下所示 Maven 工程目录:

解压完成之后,就可以通过 IntelliJ IDEA 导入工程,

  1. 菜单中选择 File–>New–>Project from Existing Sources...
  2. 选择解压后的项目文件夹,点击 OK
  3. 点击 Import project from external model 并选择 Maven,点击 Next 到底为止。
  4. 若你的环境有多个版本的 JDK,注意到选择 Java SDK 的时候请选择系统安装的 1.8 版本

使用 Spring Tool Suite 构建

Spring Tool Suite 下载地址:https://spring.io/tools/sts/all

可以选择下载单独的 STS 开发工具,也可以集成到现有的 Eclipse 环境中。

选择 Dashboard->CREATE SPRING STARTER PROJECT 进行创建项目,或者可以选择 file->new->Spring Starter Project,打开创建面板:

出现创建面板,填写项目信息:

下一步,搜选选择依赖包和版本,选择 Web 模块。

点击 Finish 完成项目创建。

使用 IntelliJ IDEA 构建

在 IDEA 启动器界面选择 Create New Project,或者在菜单选择 File->Create New Project 来创建工程。

选择 Spring Initializr,配置 Java SDK 环境为 1.8, Initializr Service URL 默认为官方的地址。点击 Next 继续下一步操作,根据界面输入选项填写对应的内容即可,如下图所示:

点击 Next 即可完成创建项目,而且创建完成后会自动导入到项目工程内就不需要再次 import 导入操作,这种方式会比较简单些,所以我们后续文章内都会采用第二种形式来创建新工程。

在下一步勾选 Web 依赖加入到我们的项目中,如下图所示:

这里需要注意一点,如果上面 Maven Packaging 选择了 war 形式,也添加了 Web 依赖并且在开发过程中使用 Application 形式启动,则需要注释掉 pom.xml 配置文件内 tomcat 依赖的 scope 属性。

项目目录结构

看看工具为我们生成新工程的目录结构,如下图所示:

可以看到目录结构有如下几个:

  1. /src/main/java/ 源代码目录
  2. /src//main/resources/ 资源文件以及配置文件目录
  3. /src/test/ 测试代码目录

标准的 Maven 工程目录。

自动生成的文件解释

SpringbootHelloworldApplication 类是 SpringBoot 的启动类,有个 main 方法,可以直接通过 run as 运行项目。

application.properties 配置文件是项目的核心配置文件。

pom.xml Maven 配置文件,因为我们采用的 Maven 管理 Jar,所以这里会自动生成一个 pom 文件。

@SpringBootApplication 注解

SpringbootHelloworldApplication 入口程序有 @SpringBootApplication 这个注解,它主要是做什么的呢?

不难看出,它声明了当前类为 SprinBoot 的入口类。一个 SprinBoot 项目内有且只能有一个这个注解存在。

package com.daimafans.springboothelloworld;

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

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

初次尝试运行项目

我们在入口程序类中右键 ->Run SpringbootHelloworldApplication,如果控制台的输出如下图所示,证明你已经成功的运行了 SpringBoot 项目。

可以看到我们的项目是通过内置的 Tomcat 容器启动的,并且端口号默认是 8080(至于如何修改端口号后续文章中更新)。

我们现在通过浏览器直接访问是得不到任何回应的,只是会有一个错误页面,如下图所示。

编写 HelloWorldController

我们首先在 /src/main/java/com/daimafans/springboothelloworld (该目录是你构建项目的包目录) 目录下创建一个叫做 controller 的 package,最后我们在 controller 包下创建一个 HelloWorldController.java 类文件,我们使用 @RestController 来声明我们新创建的 HelloWorldController 是一个访问控制器,如下图所示:

可以看到我配置了一个 @GetMapping 注解来声明 index() 方法可以通过 127.0.0.1:8080/index 访问到。@GetMapping(value = "index") 相当于 @RequestMapping(value = "index", method = RequestMethod.GET),类似的还有 @PostMapping 等注解。

接下来重新启动项目(项目中如果重启出错应该是注解配置问题),访问 index 地址:

可以看到输出了来自代码饭发来的问候:Hello Spring Boot World!

好了,本章结束。


本文收录在 SpringBoot 干货系列教程:SpringBoot 干货教程 | 第一章:教程目录大纲和前戏

教程代码下载:https://github.com/liuqianfei/springboot-course-code

如果觉得这对你有用,请随意赞赏,给与作者支持
评论 0
最新评论