【Spring Boot】创建你的第一个 Spring Boot 应用

Spring Boot 目前已经成为了 Java 开发领域的框架范式。本篇博客,我将带领大家一起创建一个 Spring Boot 的 Demo 应用。

1.环境配置

在开始之前,我们需要安装好编辑器 IDEA,以及配置好 Java 和 Maven 的环境。

环境/工具版本下载链接
IntelliJ IDEA 2023.3.4 2023.3.4 2023.3.4链接
jdk 1.8 1.8 1.8链接
maven 3.6.3 3.6.3 3.6.3链接

通过以下命令可以检验是否安装及配置成功。

在这里插入图片描述

🚀 具体如何安装不在本篇博文的讨论范围内,网上有很多的教程,但如果在安装过程中有问题,或者在本篇博文的实践中遇到了问题,可以在评论区给博主留言。

2.步骤详解

单击 IDEA 菜单栏中的 FileNewProject,再选择 Spring Initializr,做如下配置。

在这里插入图片描述
注意,Server URL 我们换成了 https://start.aliyun.com/,否则按照默认配置的 https://start.spring.ioJava 选不到 8

我们可以分别打开这两个网站看一下:

在这里插入图片描述

在这里插入图片描述
默认选择的 Spring Boot 版本是 2.6.13。如果要添加依赖,也可以在这个窗口进行。比如,我们选中了 Lombok,Spring Boot 就会自动添加 Lombok,并下载依赖。

在这里插入图片描述
点击 Create,一个 Spring Boot 的 Demo 应用就创建好了,是不是非常迅速!

在这里插入图片描述

🚀 另外一种创建 Spring Boot 项目(这种方式估计很少使用):打开浏览器访问网站(即上面提到的网站),在其中选择依赖、版本和配置,然后生成工具包。生成完成后下载到本地电脑,将其导入开发软件中即可使用。

注意,我们这里的 Maven 配置用的不是默认的,否则下载依赖包会很慢,可以自行在 Maven 的 settings.xml 文件中配置阿里云镜像。

在这里插入图片描述

3.项目结构分析

初始化后的项目结构如下:

在这里插入图片描述

3.1 入口类 DemoApplication

package com.example.demo;

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

@SpringBootApplication
public class DemoApplication {

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

}

3.2 控制器 PathVariableController

package com.example.demo.demos.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class PathVariableController {

    // http://127.0.0.1:8080/user/123/roles/222
    @RequestMapping(value = "/user/{userId}/roles/{roleId}", method = RequestMethod.GET)
    @ResponseBody
    public String getLogin(@PathVariable("userId") String userId, @PathVariable("roleId") String roleId) {
        return "User Id : " + userId + " Role Id : " + roleId;
    }

    // http://127.0.0.1:8080/javabeat/somewords
    @RequestMapping(value = "/javabeat/{regexp1:[a-z-]+}", method = RequestMethod.GET)
    @ResponseBody
    public String getRegExp(@PathVariable("regexp1") String regexp1) {
        return "URI Part : " + regexp1;
    }
}
  • package:代表包路径。PathVariableController 类在 com.example.demo.demos.web 包下。
  • import:代表在当前类引入其他类。以便用这个类创建对象或使用他们的方法。
  • @Controller:声明此类是一个 Spring MVC Controller 对象。
  • @RequestMapping:配置 URL 和方法之间的映射。可注解在类和方法上。注解在方法上的 @RequestMapping 路径会继承注解在类上的路径。

3.3 控制器 BasicController

package com.example.demo.demos.web;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class BasicController {

    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(@RequestParam(name = "name", defaultValue = "unknown user") String name) {
        return "Hello " + name;
    }

    // http://127.0.0.1:8080/user
    @RequestMapping("/user")
    @ResponseBody
    public User user() {
        User user = new User();
        user.setName("theonefx");
        user.setAge(666);
        return user;
    }

    // http://127.0.0.1:8080/save_user?name=newName&age=11
    @RequestMapping("/save_user")
    @ResponseBody
    public String saveUser(User u) {
        return "user will save: name=" + u.getName() + ", age=" + u.getAge();
    }

    // http://127.0.0.1:8080/html
    @RequestMapping("/html")
    public String html() {
        return "index.html";
    }

    @ModelAttribute
    public void parseUser(@RequestParam(name = "name", defaultValue = "unknown user") String name
            , @RequestParam(name = "age", defaultValue = "12") Integer age, User user) {
        user.setName("zhangsan");
        user.setAge(18);
    }
}

3.4 模型 User

package com.example.demo.demos.web;

public class User {

    private String name;

    private Integer age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }
}

4.运行

单击打开 DemoApplication 入口类,然后单击第 7 行代码处的绿色按钮,在弹出的选项中选择 Run 'DemoApplication',启动 Spring Boot 应用程序。

在这里插入图片描述

  • 访问 http://127.0.0.1:8080/user/123/roles/222(这里的 8080 是默认的端口),在网页中就可以看到以下内容:

在这里插入图片描述

  • 访问 http://127.0.0.1:8080/html,在网页中就可以看到以下内容:

在这里插入图片描述