# hm-tools-mapper-plus

**Repository Path**: hm-tools/hm-tools-mapper-plus

## Basic Information

- **Project Name**: hm-tools-mapper-plus
- **Description**: 通用mapper工具扩展
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2018-11-15
- **Last Updated**: 2022-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hm-tools-mapper-plus
[![Maven Central](https://img.shields.io/maven-central/v/top.hmtools/hm-tools-mapper-plus.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22top.hmtools%22%20AND%20a:%22hm-tools-mapper-plus%22)
[![996.icu](https://img.shields.io/badge/link-996.icu-red.svg)](https://996.icu)
[![LICENSE](https://img.shields.io/badge/license-Anti%20996-blue.svg)](https://github.com/996icu/996.ICU/blob/master/LICENSE)
#### 项目介绍
通用mapper工具扩展，依赖的内核工具：[MyBatis 通用 Mapper4](https://gitee.com/free/Mapper)

#### 软件架构
1. 依赖[MyBatis 通用 Mapper4](https://gitee.com/free/Mapper)
2. freemarker


#### 安装教程

1. 引用本jar包
```
  	<dependency>
  		<groupId>top.hmtools</groupId>
  		<artifactId>hm-tools-mapper-plus</artifactId>
  		<version>0.0.1-SNAPSHOT</version>
  	</dependency>
```
2. 参照[MyBatis 通用 Mapper4](https://gitee.com/free/Mapper)安装说明整合。
3. 基础mapper设置使用top.hmtools.mapper.plus.mysql.IMysqlMapperPlus<T>即可

#### 使用说明

1. 参照[MyBatis 通用 Mapper4](https://gitee.com/free/Mapper)使用说明。
3. 基础mapper设置使用top.hmtools.mapper.plus.mysql.IMysqlMapperPlus<T>即可。***注意：目前仅整合了MySQL数据库***

#### 特性
1. 扩展了批量写入数据
2. 扩展了根据指定主键名称修改数据，含是否忽略空属性，具有防由于入参为空而造成误修改数据能力
3. 扩展了根据指定主键名称即主键值集合批量物理删除对应数据，具有防由于入参为空而造成误删除数据能力
4. 扩展了根据指定主键名称即主键值集合获取对应的数据集合

#### 如何使用本组件的快照版本

1. 在自己的私服建立一个快照代理仓库即可。https://oss.sonatype.org/content/repositories/snapshots/
![如何使用快照版本](/images/howToUseSnapshot.jpg)

2. 将建好的参考纳入公共库
![如何使用快照版本](/images/howToUseSnapshot-2.jpg)