From 7fbddda55fe804d1cd92b2d0059d5160bd3a1a07 Mon Sep 17 00:00:00 2001 From: gj <1049091121@qq.com> Date: Wed, 18 Dec 2024 21:34:48 +0800 Subject: [PATCH] =?UTF-8?q?=E8=B0=B7=E5=81=A5git=E6=B5=8B=E8=AF=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../com/yeqifu/bus/mapper/GoodsMapper.java | 44 +++++++++++++++++++ .../com/yeqifu/bus/mapper/InportMapper.java | 13 ++++++ .../com/yeqifu/bus/mapper/OutportMapper.java | 18 ++++++++ .../com/yeqifu/bus/mapper/ProviderMapper.java | 24 ++++++++++ .../com/yeqifu/bus/mapper/SalesMapper.java | 22 ++++++++++ .../yeqifu/bus/mapper/SalesbackMapper.java | 21 +++++++++ src/main/java/com/yeqifu/bus/vo/InportVo.java | 2 +- 7 files changed, 143 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java b/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java index cfc5b19..04a00de 100644 --- a/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/GoodsMapper.java @@ -58,3 +58,47 @@ public interface GoodsMapper extends BaseMapper { */ List loadAllWarning(); } + + +// GoodsMapper接口，它继承自BaseMapper，这意味着它可以复用MyBatis-Plus框架提供的基础的数据库操作方法（如常见的增删改查等操作）， +// 同时针对商品（Goods）相关的特定业务逻辑，定义了一些额外的数据库操作方法，用于与数据库进行交互，实现更贴合业务需求的持久化功能。 +// 该接口对应的实现类（通常由MyBatis-Plus框架自动生成或者开发人员手动实现）会具体负责将这些方法映射为相应的SQL语句，并执行与数据库的实际交互操作。 +// 接口文档注释中的信息“InnoDB free: 9216 kB; (`providerid`) REFER `warehouse/bus_provider`(`id`)”可能是关于数据库存储引擎以及表关联相关的一些提示信息， +// 例如表明使用的是InnoDB存储引擎且有外键关联（这里是`providerid`关联到`warehouse/bus_provider`表的`id`字段），不过具体要结合实际数据库表结构来深入理解其含义。 + + + + // 根据商品id删除商品销售信息 + // 此方法用于从数据库中删除与指定商品相关的销售信息，通过传入的参数id1（使用@Param注解将其命名为"goodsid"，方便在对应的SQL语句中引用这个参数）， + // 在数据库的商品销售相关表（具体表名要根据实际数据库设计确定）中，依据商品的唯一标识符（id）找到对应的销售记录并执行删除操作， + // 以确保数据的一致性，例如当商品被删除或者相关业务逻辑需要清理其销售记录时调用该方法。 + + + // 根据商品id删除商品销售退货信息 + // 功能与deleteSaleByGoodsId类似，不过是针对商品销售退货相关的数据进行删除操作，传入的参数id1同样被命名为"goodsid"， + // 根据这个商品id，在数据库的商品销售退货相关表中查找并删除对应的退货记录，避免冗余数据，保持业务数据的准确性，例如在处理商品退货记录清理等业务场景时使用。 + + // 根据商品id删除商品进货信息 + // 用于删除与指定商品相关的进货信息，传入的参数id（同样通过@Param注解关联到SQL语句中的"goodsid"参数）作为依据， + // 在数据库的商品进货相关表中定位到对应的进货记录并删除，比如当商品信息变更或者不再需要某些进货历史记录时，调用该方法来清理数据。 + + + // 根据商品id删除商品退货信息 + // 按照传入的商品id，在数据库的商品退货相关表（可能是出库退货等相关业务对应的表，具体依业务和数据库设计而定）中查找并删除对应的退货记录， + // 保证数据库中商品退货数据与实际业务情况相符，防止出现无效或过期的退货数据，例如在退货业务流程结束后进行数据清理时使用该方法。 + + + // 根据客户id删除商品销售 + // 该方法以传入的参数id（代表客户的唯一标识符）为依据，从数据库的商品销售相关表中，查找并删除与该客户相关的所有商品销售记录， + // 例如在客户账号注销或者业务上不再需要该客户的销售历史数据等场景下，调用此方法来清理相应的数据，维护数据库数据的有效性和整洁性。 + + + // 根据客户id删除商品销售退货信息 + // 与deleteSaleByCustomerId类似，不过是针对商品销售退货信息进行删除操作，依据传入的客户id，在数据库的商品销售退货相关表中， + // 清除该客户对应的所有销售退货记录，确保数据能准确反映当前业务状态，比如在处理客户相关数据清理、业务调整等情况下使用。 + + + // 加载所有库存预警商品 + // 此方法用于从数据库中查询并返回所有符合库存预警条件的商品信息，返回的是一个包含Goods对象的列表（List）， + // 意味着会将数据库中那些库存数量达到预警阈值或者满足其他库存预警规则（具体规则由业务逻辑和数据库查询语句确定）的商品记录查询出来， + // 方便后续在业务中进行库存预警提示、补货提醒等相关操作，让业务人员及时了解库存情况并采取相应措施。 diff --git a/src/main/java/com/yeqifu/bus/mapper/InportMapper.java b/src/main/java/com/yeqifu/bus/mapper/InportMapper.java index e4939f1..9367e42 100644 --- a/src/main/java/com/yeqifu/bus/mapper/InportMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/InportMapper.java @@ -14,3 +14,16 @@ import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface InportMapper extends BaseMapper { } +// InportMapper接口，它继承自BaseMapper，这里的BaseMapper是MyBatis-Plus框架提供的一个基础的Mapper接口， +// 通过继承它，InportMapper接口可以复用BaseMapper中已经定义好的一些通用的数据库操作方法，例如常见的增删改查操作方法（如insert、selectById、updateById、deleteById等）， +// 这些方法能够方便地与数据库进行交互，实现对Inport类型数据（通常代表进货相关的业务实体，其具体结构由Inport类定义）的基本持久化功能。 + +// 同时，这个接口也可以作为一个扩展点，开发人员可以根据具体的进货业务逻辑需求，后续在这个接口中添加更多自定义的数据库操作方法， +// 例如根据特定条件查询进货记录、关联其他表进行复杂的进货数据统计等操作方法，并且在对应的Mapper实现类（一般由MyBatis-Plus框架自动生成或者手动编写实现类）中， +// 通过编写具体的SQL语句或者利用MyBatis-Plus提供的各种查询构建器等方式，来实现这些自定义方法与数据库的交互逻辑，进而满足更为复杂和贴合业务实际的进货数据处理需求。 + + + + // 目前该接口没有自定义额外的方法，仅继承了BaseMapper的通用方法，意味着它暂时仅具备基础的针对Inport类型数据的数据库操作能力， + // 不过随着业务发展，如果有针对进货数据的特殊持久化操作需求，就可以在这里添加相应的方法定义，来完善和扩展其功能。 + diff --git a/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java b/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java index 5d56b9f..53220bb 100644 --- a/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/OutportMapper.java @@ -14,3 +14,21 @@ import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface OutportMapper extends BaseMapper { } +// OutportMapper接口，它在整个项目的数据持久化层中扮演着重要角色，主要用于处理与出货（Outport）相关的数据库操作，是连接业务逻辑层与数据库的关键纽带之一。 + +// 该接口继承自BaseMapper，BaseMapper是MyBatis-Plus框架提供的一个基础的通用Mapper接口，通过这种继承关系， +// OutportMapper接口能够自动获得BaseMapper中定义好的一系列通用的数据库操作方法，比如常见的插入（insert）、根据主键查询（selectById）、 +// 根据主键更新（updateById）以及根据主键删除（deleteById）等方法，这些方法基于MyBatis-Plus的强大功能，能够便捷地与数据库进行交互，实现对Outport类型数据（通常对应着出货业务实体， +// 其具体属性和结构由Outport类来定义）的基础持久化操作，满足了在出货业务场景下对数据进行基本的增删改查等常规需求。 + +// 除此之外，从扩展性角度来看，这个接口还具备很强的可扩展性。随着项目中出货业务的不断发展和变化，可能会出现一些针对出货数据的特殊操作需求， +// 例如按照特定条件（如时间范围、商品类别、供应商等）查询出货记录、关联其他相关表（如关联商品表获取商品详细信息、关联客户表查看出货对象等）进行复杂的出货数据统计分析， +// 或者执行一些涉及多个表的复杂的数据库事务操作（比如出货同时更新库存和财务相关数据等）等情况，开发人员就可以根据这些具体的业务需求，在这个OutportMapper接口中添加自定义的方法声明， +// 然后在对应的Mapper实现类（一般由MyBatis-Plus框架按照一定规则自动生成或者开发人员手动编写实现类）中，通过编写合适的SQL语句、运用MyBatis-Plus提供的各种查询构建器以及事务管理机制等， +// 来实现这些自定义方法与数据库之间的交互逻辑，从而进一步完善和拓展针对出货业务数据的持久化处理功能，更好地满足项目中复杂多变的出货业务操作要求。 + + + + // 当前该接口仅继承了BaseMapper，暂时未添加额外的自定义方法，这意味着目前它仅提供了那些基础的、通用的针对出货数据的数据库操作功能， + // 不过这也为后续依据实际业务发展情况来灵活扩展其功能留下了空间，方便根据出货业务的细化需求逐步完善其持久化操作能力。 + diff --git a/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java b/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java index b0f52b9..6f087d6 100644 --- a/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/ProviderMapper.java @@ -34,3 +34,27 @@ public interface ProviderMapper extends BaseMapper { } +// ProviderMapper接口，它在项目的数据持久化层负责处理与供应商（Provider）相关的数据库操作，是连接业务逻辑层和数据库的重要桥梁。 +// 该接口继承自BaseMapper，BaseMapper是MyBatis-Plus框架提供的基础通用Mapper接口，通过继承它，ProviderMapper能够复用BaseMapper中定义好的常规数据库操作方法， +// 例如常见的增删改查操作（像插入供应商记录、根据供应商ID查询供应商信息、更新供应商信息以及删除供应商记录等），满足对供应商数据的基本持久化需求。 + +// 同时，针对供应商业务逻辑中的一些特定操作场景，此接口还自定义了几个额外的方法，用于处理与供应商相关联的数据的删除操作，进一步完善了在涉及供应商相关业务时的数据持久化功能。 + + + + // 根据供应商id删除商品信息 + // 此方法用于从数据库中删除与指定供应商相关联的商品信息。通过传入的参数id（使用@Param注解将其命名为"pid"，便于在对应的SQL语句中清晰地引用该参数）， + // 在数据库的商品表（具体表名根据实际数据库设计而定）中，依据与供应商的关联关系（通常通过外键关联，比如商品表中有指向供应商表的供应商ID字段）， + // 找到该供应商所对应的商品记录并执行删除操作，以确保数据的一致性。例如，当某个供应商不再合作，需要清理与之相关的商品数据时，可调用该方法。 + + + // 根据供应商id删除商品进货信息 + // 其功能是依据传入的供应商id，从数据库的商品进货相关表（可能记录了每次进货的商品、供应商、进货时间等信息的表，具体依业务和数据库设计确定）中， + // 查找并删除与该供应商相关的所有进货记录，避免出现数据冗余或无效的进货数据关联该供应商，比如在供应商信息变更或者合作终止等情况下，用于清理对应的进货历史数据。 + + + // 根据供应商id删除商品退货信息 + // 与上述两个删除方法类似，该方法根据传入的供应商id，在数据库的商品退货相关表（比如记录商品退货的时间、数量、退货原因以及对应的供应商等信息的表）中， + // 定位到与该供应商相关的退货记录并进行删除操作，保证数据库中的退货数据能准确反映当前业务状态，防止出现过期或不必要的退货记录与该供应商关联，例如在整理退货数据或者更新供应商合作关系时使用。 + + diff --git a/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java b/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java index ef9c4c9..a9f77f6 100644 --- a/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/SalesMapper.java @@ -14,3 +14,25 @@ import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface SalesMapper extends BaseMapper { } +// SalesMapper接口，它处于项目的数据持久化层，主要负责处理与销售（Sales）业务相关的数据持久化操作，是连接业务逻辑层与数据库的重要纽带，在整个项目架构中起着关键作用。 + +// 该接口继承自BaseMapper，这里的BaseMapper是MyBatis-Plus框架提供的一个基础通用Mapper接口。通过这种继承关系， +// SalesMapper接口能够直接复用BaseMapper中已经定义好的一系列通用的数据库操作方法，像常见的插入（insert）方法，可用于向数据库中插入新的销售记录； +// 依据主键进行查询的selectById方法，方便根据销售记录的唯一标识符（通常是主键ID）从数据库中精准获取某条销售记录的详细信息； +// 基于主键更新记录的updateById方法，能对数据库中已存在的销售记录进行修改操作；还有通过主键删除记录的deleteById方法，用于删除数据库中对应的销售记录等。 +// 这些通用的数据库操作方法借助MyBatis-Plus的功能特性，能够高效地与数据库进行交互，实现对Sales类型的数据（通常代表销售业务实体，其具体的属性和结构由Sales类来定义）的基本持久化功能， +// 满足了在日常销售业务场景下对销售数据进行常规的增删改查等基础操作的需求，例如添加一笔新的销售业务记录、查看特定销售业务详情、修改销售记录中的部分信息或者删除不再需要的销售记录等情况。 + +// 从可扩展性角度来看，虽然当前SalesMapper接口暂时只是继承了BaseMapper，并没有额外自定义其他方法，但随着项目中销售业务的不断发展和变化， +// 后续极有可能会出现一些针对销售数据的特殊操作需求。例如，按照特定的条件（如销售时间范围、客户地区、商品分类等）来查询销售记录， +// 或者关联其他相关数据表（比如关联客户表获取客户的详细信息、关联商品表查看商品的具体规格等）进行更为复杂的销售数据统计分析， +// 又或者执行涉及多个表的复杂数据库事务操作（比如销售业务发生时同时更新库存表、财务相关数据表等）。一旦有这些业务需求出现，开发人员就可以根据具体的业务场景， +// 在这个SalesMapper接口中添加相应的自定义方法声明，然后在对应的Mapper实现类（一般由MyBatis-Plus框架按照相应规则自动生成或者开发人员手动编写实现类）中， +// 通过编写合适的SQL语句、运用MyBatis-Plus提供的各种查询构建器以及事务管理机制等，来实现这些自定义方法与数据库之间的交互逻辑， +// 从而进一步完善和拓展针对销售业务数据的持久化处理功能，使其能够更好地适配项目中日益复杂和多样化的销售业务操作要求。 + + + + // 现阶段该接口仅继承了BaseMapper所提供的通用数据库操作方法，尚未添加额外的自定义方法，这表明目前它主要提供的是基础的、常规的针对销售数据的数据库操作功能， + // 不过这也为后续依据销售业务的实际发展情况灵活扩展其功能留下了充足的空间，方便后续根据销售业务的细化需求逐步丰富其持久化操作能力，以更好地服务于整个项目的销售业务逻辑。 + diff --git a/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java b/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java index 2a047f9..fe86b4d 100644 --- a/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java +++ b/src/main/java/com/yeqifu/bus/mapper/SalesbackMapper.java @@ -14,3 +14,24 @@ import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface SalesbackMapper extends BaseMapper { } +// SalesbackMapper接口，它在整个项目的数据持久化层有着特定的作用，主要聚焦于处理与销售退货（Salesback）相关的数据库操作，是实现业务逻辑层与数据库之间交互的关键一环。 + +// 该接口继承自BaseMapper，BaseMapper是MyBatis-Plus框架所提供的一个基础的通用Mapper接口。借助这种继承关系， +// SalesbackMapper接口能够直接复用BaseMapper里已经定义好的一系列通用的数据库操作方法，例如常见的增删改查操作方法，像插入销售退货记录（insert方法）、 +// 根据销售退货记录的主键查询相应记录（selectById方法）、依据主键更新销售退货记录（updateById方法）以及通过主键删除销售退货记录（deleteById方法）等。 +// 这些通用方法依托MyBatis-Plus的功能机制，能够便捷地与数据库进行交互，从而实现对Salesback类型的数据（通常对应着销售退货业务实体，其具体的属性和结构由Salesback类来定义）进行基础的持久化操作， +// 满足了在销售退货业务场景下对相关数据进行常规处理的基本需求，比如简单的添加、查询、修改以及删除单条销售退货记录等操作。 + +// 从可扩展性方面来看，虽然当前这个接口暂时仅继承了BaseMapper，没有额外自定义其他方法，但随着项目中销售退货业务的不断拓展和变化， +// 后续很可能会出现一些针对销售退货数据的特殊操作需求。例如，按照特定条件（如退货时间范围、客户类别、商品种类等）来查询销售退货记录， +// 或者关联其他相关数据表（比如关联商品表获取退货商品的详细规格、关联客户表查看退货客户的更多信息等）进行更为复杂的销售退货数据统计分析， +// 亦或是执行涉及多个表的复杂数据库事务操作（比如销售退货同时更新库存、财务相关数据等情况）。当出现这些业务需求时，开发人员就可以根据具体情况， +// 在这个SalesbackMapper接口中添加自定义的方法声明，然后在对应的Mapper实现类（一般由MyBatis-Plus框架按照既定规则自动生成或者开发人员手动编写实现类）中， +// 通过编写合适的SQL语句、运用MyBatis-Plus提供的各种查询构建器以及事务管理机制等手段，来实现这些自定义方法与数据库之间的交互逻辑， +// 进而完善和拓展针对销售退货业务数据的持久化处理功能，使其能够更好地适应项目中复杂多变的销售退货业务操作要求。 + + + + // 目前该接口仅继承了BaseMapper所提供的通用方法，尚未添加额外的自定义方法，这意味着现阶段它主要提供的是基础的、通用的针对销售退货数据的数据库操作功能， + // 不过这也为后续依据业务发展情况灵活扩展其功能预留了空间，方便根据销售退货业务的细化需求逐步丰富其持久化操作能力。 + diff --git a/src/main/java/com/yeqifu/bus/vo/InportVo.java b/src/main/java/com/yeqifu/bus/vo/InportVo.java index 9280cf5..51e0112 100644 --- a/src/main/java/com/yeqifu/bus/vo/InportVo.java +++ b/src/main/java/com/yeqifu/bus/vo/InportVo.java @@ -55,4 +55,4 @@ public class InportVo extends Inport { // 它用于指定时间范围的结束时间，在查询进货数据时，结合startTime属性，可以获取在这个时间区间内（包含起始时间和结束时间对应的当天）的进货记录， // 比如查询某一个月内的进货情况，就可以分别设置相应的起始和结束日期，实现精准的时间范围筛选功能。 -} +