springboot极简教程007-工程建议

关注

原创最新推荐文章于 2026-07-07 13:31:39 发布 294 阅读 AI 写同款· GEO 优化 ›

SpringBoot笔记汇总【动力节点SpringBoot全套教程完整版】前言动力节点的springboot笔记汇总，公开免费。 Spring Boot教程学习地址动力节点springboot视频教程-专为springboot初学者打造的教程_哔哩哔哩_bilibili你的三连就是录制视频的动力！一定不要忘记收藏、点赞、投币哦~本套视频基于SpringBoot2.4版本讲解。教程从细节入手，每个事例先讲解pom.xml中的重要依赖，其次application配置文件，最后是代码实现。让你知其所以，逐步让掌握SpringBoot框架的自动配置，starter起步依赖等阅读详情

组织结构

实体类

建议把实体类统一放在某个包下，包名建议取名：

model（模型，也就是MCV模式中的M，Django也是取的该值）
entity（Java有些封装的函数参数就是用的这个，也比较推荐）
bean（java中的bean就是模型层的类，意即model）
pojo（Plain Ordinary Java Object的缩写;不含业务逻辑的java简单对象;完全POJO的系统也称为轻量级系统(lightweight);是相对于EJB而提出的概念。）

实体操作类

用来提供数据库操作接口：

JPA中带Repository后缀，如UserRepository
MyBatis中带Mapper后缀，如UserMapper

对于通用的操作接口，也可以让实体操作类统一继承一个自己封装的中间层（封装一些常用的接口函数）：

JPA的做法是继承JpaRepository
MyBatis的做法是Mapper、MySqlMapper

例如使用MyBatis时，可以提供一个封装后的通用类CommonMapper：

import tk.mybatis.mapper.common.Mapper;
import tk.mybatis.mapper.common.MySqlMapper;

import java.util.List;
import java.util.Map;

//FIXME 特别注意，该接口不能被扫描到，否则会出错
public interface CommonMapper<T> extends Mapper<T>, MySqlMapper<T> {
    List<T> queryList(Map<String, Object> map);
}
 
public interface CourseMapper extends CommonMapper<Course> {
}

意味着实体操作类承诺提供一个queryList的接口

服务接口

一开始很不理解这种模式，原本业务逻辑层可以直接使用实体操作类就完成的事情，硬是弄出许多个类（算上实体类，实体操作类，服务接口，服务实现一共四个了），但是后来发现这种方式还是有好处的，慢慢习惯就好。

服务接口相当于是提供了一个缓冲地带，隔离了业务逻辑层直接与实体操作类的接触，使得后期调整操作接口或者优化会比较方便。

graph LR
A(实体类)-->B(实体操作类)
B-->C(服务接口 缓冲隔离)
C-->D(业务控制层)

服务接口主要用于暴露给逻辑控制层的，等于告诉逻辑控制层：**我有这些接口可以使用，可以在业务中尽情使用。**实际应用发现，业务层需要的接口可能无非就是那几个，如果每次创建服务都去写一遍接口，有点重复，那么怎么办呢？

好办，把重复使用的那些接口封装出去，提到一个基类接口中管理，我们把这个基类服务接口叫做BaseService，例如最基本的增删改查这几个接口很多业务都需要，就把这些接口复用起来，让基类来统一实现和管理，接口如下：

import org.springframework.stereotype.Service;

import java.util.List;

/**
 * 通用接口
 */
@Service
public interface BaseService<T> {

    T selectByKey(Object key);

    int save(T entity);

    int delete(Object key);

    int update(T entity);

    //TODO 其他...
}

import com.example.dao.model.Course;
import com.example.util.Page;

import java.util.List;
import java.util.Map;


public interface CourseService extends BaseService<Course> {
    int deleteByIds(String[] ids);
    int deleteByIds(Long[] ids);
    List<Course> queryList(Map<String, Object> params);
    List<Course> queryList(Page<?> page);
}

其实现代码BaseServiceImpl如下：


import org.springframework.beans.factory.annotation.Autowired;
import tk.mybatis.mapper.common.Mapper;

import java.util.List;

/**
 * 通用Service
 *
 * @param <T>
 */
public abstract class BaseServiceImpl<T> implements BaseService<T> {

    @Autowired
    protected Mapper<T> mapper;

    public Mapper<T> getMapper() {
        return mapper;
    }

    @Override
    public T selectByKey(Object key) {
        //说明：根据主键字段进行查询，方法参数必须包含完整的主键属性，查询条件使用等号
        return mapper.selectByPrimaryKey(key);
    }

    @Override
    public int save(T entity) {
        //说明：保存一个实体，null的属性也会保存，不会使用数据库默认值
        return mapper.insert(entity);
    }

    @Override
    public int delete(Object key) {
        //说明：根据主键字段进行删除，方法参数必须包含完整的主键属性
        return mapper.deleteByPrimaryKey(key);
    }

    @Override
    public int update(T entity) {
        //根据主键更新属性不为null的值
        return mapper.updateByPrimaryKeySelective(entity);
    }
}

以后再为实体操作类封装服务接口时，可以这么做：继承BaseService，例如CourseService：

import com.example.dao.model.Course;
import com.example.util.Page;

import java.util.List;
import java.util.Map;


public interface CourseService extends BaseService<Course> {
    int deleteByIds(String[] ids);
    int deleteByIds(Long[] ids);
    List<Course> queryList(Map<String, Object> params);
    List<Course> queryList(Page<?> page);
}

该服务承诺：**除了提供增删改查基础接口功能之外，还提供了批量删除、分页查询的接口，**而且是多种参数形式的接口，比较灵活。

然后再创建一个服务接口的实现类CourseServiceImpl：


import com.example.dao.mapper.CourseMapper;
import com.example.dao.model.Course;
import com.example.util.Page;
import com.github.pagehelper.PageHelper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.Arrays;
import java.util.List;
import java.util.Map;

/**
 */
@Service
public class CourseServiceImpl extends BaseServiceImpl<Course> implements CourseService {

    @Autowired
    CourseMapper courseMapper;

    @Override
    public int deleteByIds(String[] ids) {
        return this.courseMapper.deleteByIds(ids);
    }

    @Override
    public int deleteByIds(Long[] ids) {
        String[] string_ids = new String[ids.length];

        for (int i = 0; i < ids.length; i++) {
            string_ids[i] = String.valueOf(ids[i]);
        }
        return this.courseMapper.deleteByIds(string_ids);
    }

    @Override
    public List<Course> queryList(Map<String,Object> params) {
        PageHelper.startPage(Integer.parseInt(params.get("page").toString()), Integer.parseInt(params.get("rows").toString()));
        return this.courseMapper.queryList(params);
    }

    @Override
    public List<Course> queryList(Page<?> page) {
        return courseMapper.queryList(page.getCondition());
    }
}