深入Spring Boot (六)：使用SpringMVC框架创建Web应用

《深入Spring Boot (一)：快速入门》中示例代码使用SpringMVC编写了一个简单的Web应用，本篇将继续使用SpringMVC框架编写复杂的Web服务。本篇主要包含以下3部分内容：

1. 推荐包结构；

2. 代码实践；

3. 代码解析。

1.推荐包结构

在进行SpringMVC框架整合之前，先来了解一下Spring Boot官方推荐的包结构最佳实践。Spring Boot推荐将Application启动类放在根包下，例如包层级划分如com.example.controller、com.example.service、com.example.dao等，com.example则是根包，Application启动类推荐放在com.example包下，具体如下图所示。

这样做的好处是使用@SpringBootApplication注解标注Application类的时可以省略指定scanBasePackages属性，并且应用启动时默认只扫描Application类所在的包及其子包。

2.代码实践

以银行信息的Web服务为例，编写处理多种请求的银行信息服务。

首先，新建Gradle项目并添加spring-boot-starter-web模块，具体代码如下：

plugins {

    id 'java'

}

group 'spring-boot'

version '1.0-SNAPSHOT'

sourceCompatibility = 1.8

repositories {

    jcenter()

}

dependencies {

    compile("org.springframework.boot:spring-boot-starter-web:2.0.0.RELEASE")

    testCompile("org.springframework.boot:spring-boot-starter-test:2.0.0.RELEASE")

}

编写应用启动类Application.java，具体代码如下：

@SpringBootApplication

public class Application {

    public static void main(String[] args) {

        SpringApplication.run(Application.class, args);

    }

}

编写银行实体类Bank.java，具体代码如下：

public class Bank implements Serializable{

    private Long id;

    private String bankName;

    private String bankCode;

    //省略getter和setter

}

编写银行信息Web服务接口类BankController.java，具体代码如下：

@RestController

@RequestMapping("/banks")

public class BankController {

    //根据id查询银行信息

    @RequestMapping(value = "/{id}", method = RequestMethod.GET)

    public Bank getBank(@PathVariable Long id) {

        return Bank.newBuilder()

                .withId(id)

                .withBankName("中国工商银行")

                .withBankCode("ICBC")

                .build();

    }

    //查询全部银行信息

    @RequestMapping(value = "/list", method = RequestMethod.GET)

    public List<Bank> getAllBanks() {

        Bank icbc = Bank.newBuilder()

                .withId(100L)

                .withBankName("中国工商银行")

                .withBankCode("ICBC")

                .build();

        Bank cmb = Bank.newBuilder()

                .withId(101L)

                .withBankName("中国招商银行")

                .withBankCode("CMB")

                .build();

        return new ArrayList<Bank>() {

            {

                add(icbc);

                add(cmb);

            }

        };

    }

    //新建一条银行信息

    @RequestMapping(value = "/create", method = RequestMethod.POST)

    public String create(@ModelAttribute Bank bank) {

        //省略校验及保存操作

        return "SUCCESS";

    }

    //根据id删除一条银行信息

    @RequestMapping(value = "/del/{id}", method = RequestMethod.DELETE)

    public String delete(@PathVariable Long id) {

        //省略删除操作

        return "SUCCESS";

    }

    //修改一条银行信息

    @RequestMapping(value = "/put/{bankId}", method = RequestMethod.PUT)

    public String update(@PathVariable Long bankId, @ModelAttribute Bank bank) {

        //省略查询、更新操作

        return "SUCCESS";

    }

}

运行Application类的main方法就可以提供银行信息Web服务了，可以使用postman工具发送请求验证。

3.代码解析

BankController中使用到了@RestController、@RequestMapping、@PathVariable和@ModelAttribute注解，这些都是SpringMVC框架的spring-web包中的注解。

• @RestController：它是Spring4.0新增的注解，具有@Controller注解和@ResponseBody注解的功能，使用@ResponseBody注解标注后，默认返回的数据格式是json；

• @RequestMapping：标注在类和方法上，用于将web请求映射到请求处理类和类中的方法上；

• @PathVariable：标注在方法参数上，用于将请求中的URI模板变量值绑定到标注的参数上，需要配合@RequestMapping注解一起使用；

• @ModelAttribute：标注在方法或方法参数上，用于将请求参数绑定到指定模型上，需要配合@RequestMapping注解一起使用；

代码中除了上述这些配置并不需要其它配置了，因为Spring Boot提供了Spring MVC的自动配置功能，这些自动的配置是根据项目依赖的jar自动开启的，其实是@EnableAutoConfiguration注解的功劳，具体如何实现自动配置的，在

Spring Boot虽说提供了自动默认配置，但有时可能需要改变某些默认配置，后续篇幅将深入介绍如何修改这些默认配置。

END 

如果觉得有收获，记得关注、点赞、转发。