基于 Spring Boot 实现 Restful 风格接口,实现增删改查功能

2年前 (2022) 程序员胖胖胖虎阿
312 0 0

点击上方 Java后端选择 设为星标

优质文章,及时送达


Spring Boot介绍

Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置。
简单的来说就是,只需几个jar和一些简单的配置,就可以快速开发项目。
假如我就想简单的开发一个对外的接口,那么只需要以下代码就可以了。

一个主程序启动Spring Boot

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

控制层

@RestController
public class HelloWorldController {
    @RequestMapping("/hello")
    public String index() {
        return "Hello World";
    }
 }

成功启动主程序之后,编写控制层,然后在浏览器输入 http://localhost:8080//hello    便可以查看信息。

感觉使用SpringBoot开发程序是不是非常的简单呢!
用SpringBoot实战的话来说:

这里没有配置,没有web.xml,没有构建说明,甚至没有应用服务器,但这就是整个应用程序了。SpringBoot会搞定执行应用程序所需的各种后勤工作,你只要搞定应用程序的代码就好。

基于SpringBoot开发一个Restful服务

一、开发准备

1.1 数据库和表

首先,我们需要在MySql中创建一个数据库和一张表
数据库的名称为 springboot,表名称为 t_user
脚本如下:

CREATE DATABASE `springboot`;

USE `springboot`;

DROP TABLE IF EXISTS `t_user`;

CREATE TABLE `t_user` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `name` varchar(10) DEFAULT NULL COMMENT '姓名',
  `age` int(2) DEFAULT NULL COMMENT '年龄',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8;

1.2  maven相关依赖

因为我们使用Maven创建的,所以需要添加SpringBoot的相关架包。
这里Maven的配置如下:
springBoot最核心的jar
spring-boot-starter :核心模块,包括自动配置支持、日志和YAML;

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.9.RELEASE</version>
    <relativePath/> 
  </parent>

     <properties>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <java.version>1.7</java.version>
    
        <mybatis-spring-boot>1.2.0</mybatis-spring-boot>
        <mysql-connector>5.1.39</mysql-connector>
    
  </properties>


    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        
       
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
    
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
    
    
      
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>${mybatis-spring-boot}</version>
        </dependency>
 
        
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql-connector}</version>
        </dependency>

  </dependencies>
  
  <build>
    <plugins>
    
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
                  <fork>true</fork>
              </configuration>
      </plugin>
    </plugins>
  </build>

二、工程说明

成功创建好数据库以及下载好相应架包之后。
我们来正式开发SpringBoot项目。

2.1工程结构图:

首先确定工程结构,这里我就简单的说明下了。

com.pancm.web - Controller 层
com.pancm.dao - 数据操作层 DAO
com.pancm.bean - 实体类
com.pancm.service - 业务逻辑层
Application - 应用启动类
application.properties - 应用配置文件,应用启动会自动读取配置

基于 Spring Boot 实现 Restful 风格接口,实现增删改查功能

2.2 自定义配置文件

一般我们需要一些自定义的配置,例如配置jdbc的连接配置,在这里我们可以用 application.properties  进行配置。数据源实际的配置以各位的为准。

#
spring.datasource.url=jdbc:mysql://localhost:3306/springBoot?useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver


#

# 配置为 com.pancm.bean 指向实体类包路径。
mybatis.typeAliasesPackage=com.pancm.bean
# 配置为 classpath 路径下 mapper 包下,* 代表会扫描所有 xml 文件。
mybatis.mapperLocations=classpath\:mapper/*.xml

三、代码编写

在创建好相关工程目录之后,我们开始来编写相应的代码。

3.1 实体类编写

由于我们这里只是用于测试,只在数据库中创建了一张t_user表,所以这里我们就只创建一个User实体类,里面的字段对应t_user表的字段。

示例代码如下:

public class User {
   
   private int id;
   
   private String name;
   
   private int age;
   
   public User(){
   }
   public class User {
   
   private int id;
   
   private String name;
   
   private int age;
   
   public User(){
   }

}

3.2  Dao层编写

在以前的Dao层这块,hibernate和mybatis 都可以使用注解或者使用mapper配置文件。在这里我们使用spring的JPA来完成基本的增删改查。
说明:
一般有两种方式实现与数据库实现CRUD:
第一种是xml的mapper配置。
第二种是使用注解,@Insert、@Select、@Update、@Delete 这些来完成。本篇使用的是第二种。

import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Result;
import org.apache.ibatis.annotations.Results;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;
import org.springframework.data.repository.query.Param;
import com.pancm.bean.User;

@Mapper
public interface UserDao {
  
  
   @Insert("insert into t_user(id,name,age) values (#{id},#{name},#{age})")
    void addUser(User user);
   
   
   @Update("update t_user set name=#{name},age=#{age} where id=#{id}")
    void updateUser(User user);

   
   @Delete("delete from t_user where id=#{id}")
   void deleteUser(int id);
  
    
    @Select("SELECT id,name,age FROM t_user where name=#{userName}")
    User findByName(@Param("userName") String userName);
   
   
    @Select("SELECT id,name,age FROM t_user")
    List<User> findAll();
    
     
}

说明:

  • mapper : 在接口上添加了这个注解表示这个接口是基于注解实现的CRUD。
  • Results: 返回的map结果集,property 表示User类的字段,column 表示对应数据库的字段。
  • Param:sql条件的字段。
  • Insert、Select、Update、Delete:对应数据库的增、查、改、删。

3.3 Service 业务逻辑层

这块和hibernate、mybatis的基本一样。
代码如下:

接口
import com.pancm.bean.User;

public interface UserService {
  
  boolean addUser(User user);
  
  boolean updateUser(User user);
  
  boolean deleteUser(int id);

  User findUserByName(String userName);
    
  List<User> findAll();
}
实现类
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import com.pancm.bean.User;
import com.pancm.dao.UserDao;
import com.pancm.service.UserService;


@Service
public class UserServiceImpl implements UserService {
  @Autowired
    private UserDao userDao;
  
  
  @Override
  public boolean addUser(User user) {
    boolean flag=false;
    try{
      userDao.addUser(user);
      flag=true;
    }catch(Exception e){
      e.printStackTrace();
    }
    return flag;
  }

  @Override
  public boolean updateUser(User user) {
    boolean flag=false;
    try{
      userDao.updateUser(user);
      flag=true;
    }catch(Exception e){
      e.printStackTrace();
    }
    return flag;
  }

  @Override
  public boolean deleteUser(int id) {
    boolean flag=false;
    try{
      userDao.deleteUser(id);
      flag=true;
    }catch(Exception e){
      e.printStackTrace();
    }
    return flag;
  }

  @Override
  public User findUserByName(String userName) {
    return userDao.findByName(userName);
  }


  @Override
  public List<User> findAll() {
    return userDao.findAll();
  }
}


3.4 Controller 控制层

控制层这块和springMVC很像,但是相比而言要简洁不少。
说明:

  • RestController:默认类中的方法都会以json的格式返回。
  • RequestMapping: 接口路径配置。
  • method : 请求格式。
  • RequestParam: 请求参数。
具体实现如下:
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import com.pancm.bean.User;
import com.pancm.service.UserService;



@RestController
@RequestMapping(value = "/api/user")
public class UserRestController {
  @Autowired
    private UserService userService;
 
  @RequestMapping(value = "/user", method = RequestMethod.POST)
    public boolean addUser( User user) {
      System.out.println("开始新增...");
        return userService.addUser(user);
    }
    
  @RequestMapping(value = "/user", method = RequestMethod.PUT)
    public boolean updateUser( User user) {
      System.out.println("开始更新...");
        return userService.updateUser(user);
    }
  
  @RequestMapping(value = "/user", method = RequestMethod.DELETE)
    public boolean delete(@RequestParam(value = "userName", required = true) int userId) {
      System.out.println("开始删除...");
        return userService.deleteUser(userId);
    }
  
    
    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public User findByUserName(@RequestParam(value = "userName", required = true) String userName) {
      System.out.println("开始查询...");
        return userService.findUserByName(userName);
    }
    
    
    @RequestMapping(value = "/userAll", method = RequestMethod.GET)
    public List<User> findByUserAge() {
      System.out.println("开始查询所有数据...");
        return userService.findAll();
    }
}

3.5  Application 主程序

SpringApplication 则是用于从main方法启动Spring应用的类。
默认,它会执行以下步骤:
1.创建一个合适的ApplicationContext实例 (取决于classpath)。
2.注册一个CommandLinePropertySource,以便将命令行参数作为Spring properties。
3.刷新application context,加载所有单例beans。
4.激活所有CommandLineRunner beans。
直接使用main启动该类,SpringBoot便自动化配置了。
ps:即使是现在我依旧觉得这个实在是太厉害了。

该类的一些注解说明。:
SpringBootApplication:开启组件扫描和自动配置。
MapperScan: mapper 接口类扫描包配置

代码如下:
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;


@SpringBootApplication
@MapperScan("com.pancm.dao")
public class Application {
  public static void main(String[] args) {
    
    SpringApplication.run(Application.class, args);
    System.out.println("程序正在运行...");
  }
}


四、代码测试

代码编写完之后,我们进行代码的测试。
启动Application 之后,使用postman工具进行接口的测试。
postman的使用教程可以看我的博客: http://www.panchengming.com/2017/04/24/pancm12/

测试结果如下:

基于 Spring Boot 实现 Restful 风格接口,实现增删改查功能

基于 Spring Boot 实现 Restful 风格接口,实现增删改查功能

这里只使用了一个get和post测试,实际方法都测试过了,但是感觉没必要贴图了。
项目我放到github上面去了:
https://github.com/xuwujing/springBoot

如果觉得不错,希望顺便给个star。
到此,本文结束,谢谢阅读。

作者:虚无境
博客园出处:http://www.cnblogs.com/xuwujing
CSDN出处:http://blog.csdn.net/qazwsxpcm    
个人博客出处:http://www.panchengming.com

 


-END-
如果看到这里,说明你喜欢这篇文章,请转发、点赞
。同时标星(置顶)本公众号可以第一时间接受到博文推送。

1. 干掉 try catch !
2. MySQL 如何优化 CPU 消耗
3. Spring Boot实现前后端分离
4. 去掉烦人的 !=null

基于 Spring Boot 实现 Restful 风格接口,实现增删改查功能

本文分享自微信公众号 - Java后端(web_resource)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

相关文章

暂无评论

暂无评论...