基于SpringBoot开发一个Restful服务,实现增删改查功能

本人花费半年的时间总结的《Java面试指南》已拿腾讯等大厂offer,已开源在github ,欢迎star!

本文GitHub https://github.com/OUYANGSIHAI/JavaInterview 已收录,这是我花了6个月总结的一线大厂Java面试总结,本人已拿大厂offer,欢迎star

原文链接:blog.ouyangsihai.cn >> 基于SpringBoot开发一个Restful服务,实现增删改查功能

点击上方“Java知音”,选择“置顶公众号”

技术文章第一时间送达!

作者:虚无境 cnblogs.com/xuwujing/p/8260935.html

阅****读

1. 

****2. ****

3. 

****4. ****

前言

在去年的时候,在各种渠道中略微的了解了SpringBoot,在开发web项目的时候是如何的方便、快捷。但是当时并没有认真的去学习下,毕竟感觉自己在Struts和SpringMVC都用得不太熟练。不过在看了很多关于SpringBoot的介绍之后,并没有想象中的那么难,于是开始准备学习SpringBoot。

在闲暇之余的时候,看了下SpringBoot实战以及一些大神关于SpringBoot的博客之后,开始写起了我的第一个SpringBoot的项目。在能够对SpringBoot进行一些简单的开发Restful风格接口实现CRUD功能之后,于是便有了本篇博文。

SpringBoot介绍

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

一个主程序启动springBoot


@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
        groupIdorg.springframework.boot/groupId
        artifactIdspring-boot-starter-parent/artifactId
        version1.5.9.RELEASE/version
        relativePath/ 
    /parent

     properties
        project.build.sourceEncodingUTF-8/project.build.sourceEncoding
        java.version1.7/java.version

        mybatis-spring-boot1.2.0/mybatis-spring-boot
        mysql-connector5.1.39/mysql-connector

    /properties


    dependencies
        dependency
            groupIdorg.springframework.boot/groupId
            artifactIdspring-boot-starter-web/artifactId
        /dependency
        dependency
            groupIdorg.springframework.boot/groupId
            artifactIdspring-boot-starter-thymeleaf/artifactId
        /dependency
        dependency
            groupIdorg.springframework.boot/groupId
            artifactIdspring-boot-starter-data-jpa/artifactId
        /dependency


        dependency
            groupIdorg.springframework.boot/groupId
            artifactIdspring-boot-devtools/artifactId
            optionaltrue/optional
        /dependency

        dependency
            groupIdorg.springframework.boot/groupId
            artifactIdspring-boot-starter-test/artifactId
            scopetest/scope
        /dependency


          !-- Spring Boot Mybatis 依赖 --
        dependency
            groupIdorg.mybatis.spring.boot/groupId
            artifactIdmybatis-spring-boot-starter/artifactId
            version${mybatis-spring-boot}/version
        /dependency

        !-- MySQL 连接驱动依赖 --
        dependency
            groupIdmysql/groupId
            artifactIdmysql-connector-java/artifactId
            version${mysql-connector}/version
        /dependency

    /dependencies

    build
        plugins
        !--运用SpringBoot 插件  使用spring-boot-devtools模块的应用,当classpath中的文件有改变时,会自动重启! --
            plugin
                groupIdorg.springframework.boot/groupId
                artifactIdspring-boot-maven-plugin/artifactId
                configuration
                    forktrue/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 - 应用配置文件,应用启动会自动读取配置

基于SpringBoot开发一个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


## Mybatis 配置
# 配置为 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(){
     }
//   getter和 setter 略 
}

3.2 Dao层编写

在以前的Dao层这块,hibernate和mybatis 都可以使用注解或者使用mapper配置文件。在这里我们使用spring的JPA来完成基本的增删改查。

说明:

一般有两种方式实现与数据库实现CRUD:

  • 第一种是xml的mapper配置。
  • 第二种是使用注解,@Insert、@Select、@Update、@Delete 这些来完成。本篇使用的是第二种。
  • 第二种是使用注解,@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")     
        ListUser findAll();
    
    
    }
    

    说明:

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

    Insert、Select、Update、Delete:对应数据库的增、查、改、删。

    3.3 Service 业务逻辑层

    这块和hibernate、mybatis的基本一样。

    代码如下:

    接口

    
    import com.pancm.bean.User;
    
    /**
     * 
    * Title: UserService
    * Description:用户接口 
    * Version:1.0.0  
    * @author pancm
     */
    public interface UserService {
    
        /**
         * 新增用户
         * @param user
         * @return
         */
        boolean addUser(User user);
    
        /**
         * 修改用户
         * @param user
         * @return
         */
        boolean updateUser(User user);
    
    
        /**
         * 删除用户
         * @param id
         * @return
         */
        boolean deleteUser(int id);
    
         /**
         * 根据用户名字查询用户信息
         * @param userName
         */
        User findUserByName(String userName);
    
    
    
        /**
         * 查询所有
         * @return
         */
        ListUser 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;
    
    /**
     * 
    * Title: UserServiceImpl
    * Description:
    * 用户操作实现类 
    * Version:1.0.0  
    * @author pancm
     */
    @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 ListUser findAll() {
            return userDao.findAll();
        }
    }
    

    3.4 Controller 控制层

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

    说明:

  • RestController:默认类中的方法都会以json的格式返回。
  • RequestMapping: 接口路径配置。
  • method : 请求格式。
  • RequestParam: 请求参数。
  • RequestMapping: 接口路径配置。

    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;
    
    
    /**
     * 
    * Title: UserRestController
    * Description: 
    * 用户数据操作接口
    * Version:1.0.0  
    * @author pancm
     */
    @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 ListUser findByUserAge() {
            System.out.println("开始查询所有数据...");
            return userService.findAll();
        }
    }
    

    3.5 Application 主程序

    SpringApplication 则是用于从main方法启动Spring应用的类。
    默认,它会执行以下步骤:

  • 创建一个合适的ApplicationContext实例 (取决于classpath)。
  • 注册一个CommandLinePropertySource,以便将命令行参数作为Spring properties。
  • 刷新application context,加载所有单例beans。
  • 激活所有CommandLineRunner beans。
  • 注册一个CommandLinePropertySource,以便将命令行参数作为Spring properties。

    激活所有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;
    /**
     * 
    * Title: Application
    * Description:
    * springBoot 主程序 
    * Version:1.0.0  
    * @author pancm
    * @date 2018年1月5日
     */
    
    @SpringBootApplication
    @MapperScan("com.pancm.dao")
    public class Application {
        public static void main(String[] args) {
            // 启动嵌入式的 Tomcat 并初始化 Spring 环境及其各 Spring 组件
            SpringApplication.run(Application.class, args);
            System.out.println("程序正在运行...");
        }
    }
    

    四、代码测试

    代码编写完之后,我们进行代码的测试。

    启动Application 之后,使用postman工具进行接口的测试。

    postman的使用教程可以看这篇博客:

    http://www.panchengming.com/2017/04/24/pancm12/

    测试结果如下:

    基于SpringBoot开发一个Restful服务,实现增删改查功能 基于SpringBoot开发一个Restful服务,实现增删改查功能

    这里只使用了一个get和post测试,实际方法都测试过了,但是感觉没必要贴图了。

    项目放到github上面去了:

    https://github.com/xuwujing/springBoot

    看完本文有收获?请转发分享给更多人

    基于SpringBoot开发一个Restful服务,实现增删改查功能

    原文始发于微信公众号(Java知音):

    本人花费半年的时间总结的《Java面试指南》已拿腾讯等大厂offer,已开源在github ,欢迎star!

    本文GitHub https://github.com/OUYANGSIHAI/JavaInterview 已收录,这是我花了6个月总结的一线大厂Java面试总结,本人已拿大厂offer,欢迎star

    原文链接:blog.ouyangsihai.cn >> 基于SpringBoot开发一个Restful服务,实现增删改查功能


     上一篇
    Springboot + Vue + shiro 实现前后端分离、权限控制 Springboot + Vue + shiro 实现前后端分离、权限控制
    题外话:欢迎将公众号设置为星标,技术文章第一时间看到。我们将一如既往精选技术好文,提供有价值的阅读。如有读者想要投稿,可以在公众号任意文章下留言,技术博主奖励丰厚。 推荐阅****读 1.  ****2. **** 3.  ****4. *
    下一篇 
    Springboot如何优雅的解决ajax+自定义headers的跨域请求 Springboot如何优雅的解决ajax+自定义headers的跨域请求
    点击上方“Java知音”,选择“置顶公众号” 技术文章第一时间送达! 1、什么是跨域由于浏览器同源策略(同源策略,它是由Netscape提出的一个著名的安全策略。现在所有支持JavaScript 的浏览器都会使用这个策略。所谓同源是指,域名