若依学习日志03-二次开发-新建业务模块

一、开发准备

1. 环境确认

确保已经正确搭建若依开发环境，包括 JDK（建议 1.8 及以上）、Maven、Node.js、Vue CLI 等。同时，若依项目能够正常启动和访问。

2. 项目结构熟悉

再次熟悉若依项目的整体结构，特别是与业务开发相关的目录，例如：

• ruoyi-admin：后端管理模块，包含控制器、服务层、实体类等。
• ruoyi-ui：前端项目，基于 Vue.js 构建，包含页面组件、API 接口封装等。

二、后端业务模块开发

1. 数据库设计

假设我们要创建一个 “商品管理” 业务模块，首先设计数据库表。在数据库中创建 tb_product 表，表结构如下：

sql

CREATE TABLE `tb_product` (
    `product_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '商品 ID',
    `product_name` varchar(200) NOT NULL COMMENT '商品名称',
    `price` decimal(10, 2) NOT NULL COMMENT '商品价格',
    `stock` int(11) NOT NULL COMMENT '商品库存',
    `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    PRIMARY KEY (`product_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品表';

2. 实体类创建

在 ruoyi-admin/src/main/java/com/ruoyi/system/domain 目录下创建 SysProduct 实体类，对应数据库中的 tb_product 表。

java

package com.ruoyi.system.domain;

import com.ruoyi.common.core.domain.BaseEntity;
import lombok.Data;

@Data
public class SysProduct extends BaseEntity {
    private Long productId;
    private String productName;
    private Double price;
    private Integer stock;
}

3. Mapper 接口与 XML 文件

• Mapper 接口：在 ruoyi-admin/src/main/java/com/ruoyi/system/mapper 目录下创建 SysProductMapper 接口。

java

package com.ruoyi.system.mapper;

import com.ruoyi.system.domain.SysProduct;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface SysProductMapper {
    List<SysProduct> selectProductList(SysProduct product);
    int insertProduct(SysProduct product);
    int updateProduct(SysProduct product);
    int deleteProductById(Long productId);
}

• XML 文件：在 ruoyi-admin/src/main/resources/mapper/system 目录下创建 SysProductMapper.xml 文件，实现具体的 SQL 操作。

xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ruoyi.system.mapper.SysProductMapper">
    <select id="selectProductList" resultType="com.ruoyi.system.domain.SysProduct">
        SELECT * FROM tb_product
        <where>