SpringBoot学习（二）--构建RESTFUL API并用JdbcTemplate进行存储

RESTFUL API

首先，REST是所有Web应用都应该遵守的架构设计指导原则。面向资源是REST最明显的特征，对于同一个资源的一组不同的操作。在这里我们是对一个User对象进行操作。增删改查。REST要求，必须通过统一的接口来对资源执行各种操作。对于每个资源只能执行一组有限的操作。（7个HTTP方法：GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS）
REST总是使用http协议。有下列几个常用操作。
GET（SELECT）：从服务器取出资源（一项或多项）。
POST（CREATE）：在服务器新建一个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。
DELETE（DELETE）：从服务器删除资源。

---

构造User对象(/domain)

public class User {
    private Long id;
    private String name;
    private Integer age;

    public Integer getAge() {
        return age;
    }

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

    public String getName() {

        return name;
    }

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

    public Long getId() {

        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }
}

实现对User对象的操作接口（/web)

import com.kaihong.springboot.domain.User;
import com.kaihong.springboot.domain.UserDao;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;


@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    UserDao userDao;//对user进行增删改查的dao



    @RequestMapping(value="/", method = RequestMethod.GET)
    public String getUsersSum(){
        //处理“/users/"的GET请求。获取现在数据库中的总的user数量
        return userDao.getAllUsers().toString();
    }

    @RequestMapping(value="/", method = RequestMethod.POST)
    public String postUser(@ModelAttribute User user){
        // 处理"/users/"的POST请求，用来创建User
        userDao.create(user.getName(),user.getAge());
        return "success";
    }

    @RequestMapping(value="/{id}", method = RequestMethod.GET)
    public User getUser(@PathVariable Long id){
        //处理"/users/id"的GET请求，用来通过id获取User对象
        return userDao.getUserById(id);
    }

    @RequestMapping(value="/{id}", method = RequestMethod.PUT)
    public String putUser(@PathVariable Long id, @ModelAttribute User user){
        // 处理"/users/{id}"的PUT请求，用来更新User信息
        userDao.updateById(id, user);
        return "success";
    }

    @RequestMapping(value="/{id}", method = RequestMethod.DELETE)
    public String deleteUser(@PathVariable Long id){
        //处理"/users/id"的DELETE请求，用来根据id删除User
        userDao.deleteAllUsers();
        return "success";
    }
}

为了连接数据库，需要添加依赖如下

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.21</version>
</dependency>

在application.properties中配置数据库的信息,数据库的名称，用户名密码要更改。

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

Spring的JdbcTemplate是自动配置的，你可以直接使用@Autowired来注入到你自己的bean中来使用。

1. 定义包含有插入、删除、查询的抽象接口UserDao(/domain)

package com.kaihong.springboot.domain;


public interface UserDao {

    void create(String name, Integer age);

    void deleteByName(String name);

    Integer getAllUsers();

    void deleteAllUsers();

    User getUserById(Long id);

    void updateById(Long id, User u);
}

通过JdbcTemplate实现UserService中定义的数据访问操作

package com.kaihong.springboot.domain;


import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Repository;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service("userDao")
public class UserDaoImpl implements UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Override
    public void create(String name, Integer age) {
        jdbcTemplate.update("insert into USER(NAME, AGE) values(?,?)",name,age);
    }

    @Override
    public void deleteByName(String name) {
        jdbcTemplate.update("delete from USER where name=?", name);
    }

    @Override
    public Integer getAllUsers() {
        return jdbcTemplate.queryForObject("select count(1) from USER",Integer.class);
    }


    @Override
    public void deleteAllUsers() {
        jdbcTemplate.update("delete from USER");
    }

    @Override
    public User getUserById(Long id){
        User u=new User();
        String name=jdbcTemplate.queryForObject("select name from USER where id=?",
                String.class, new Object[]{id});
        Integer age=jdbcTemplate.queryForObject("select age from USER where id=?",
                Integer.class, new Object[]{id});
        u.setAge(age);
        u.setId(id);
        u.setName(name);
        return u;
    }

    @Override
    public void updateById(Long id, User u){
        jdbcTemplate.update("update USER set name=?, age=? where id=?",u.getName(),u.getAge(),id);
    }
}

jdbcTemplate的操作简单。直接用@Autowired注解就可以注入。

---

测试

刚开始是使用JUnit进行测试。但是正确处理http请求后从test跳转到UserController时userDao总是注入失败，空指针异常，查了很久都不知道怎么解决。网上大多是非Controller下注入失败的例子，可能是Junit不熟，之后再回来解决。
Caused by: java.lang.NullPointerException
at com.kaihong.springboot.controller.UserController.getUsersSum(UserController.java:21)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:497)
at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:205)
at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:133)
at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:97)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:827)
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:738)
at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:85)
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:967)
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:901)
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:970)
… 38 more

最后使用Postman进行测试，不会注入失败。Postman官网下载即可。

这是post请求发送内容的例子。
最后测试成功。

---

一些注解

@Autowired：@Autowired是一种函数，可以对成员变量、方法和构造函数进行标注，来完成自动装配的工作，@Autowired标注可以放在成员变量上，也可以放在成员变量的set方法上。在这里我就直接用来导入一整个Dao。
@Autowired是根据类型进行自动装配的，如果需要按名称进行装配，则需要配合@Qualifier使用。比如接口Persion有两个实现类，Student和Teacher。为了确定实例化时是哪个就需要

@Autowired
@Qualifier("student")
private Persion persion;

这样实例化的就是Student.在上面的例子中因为UserDao只有一个实现类，所以可以不需要。另外要注意的是这里的Qualifier要配合Service使用，见下。

@Service：@Service表示告诉Spring创建这个类的实例。一个接口有多个实现类时，需要在增加名字，如@Service(“student”)，@Service(“teacher”).这样就能跟@Qualifier配合使用了。