MPRelation

mybatis-plus relations one2one one2many many2many

mprelation( AutoMapper : one2one/one2many/many2many)

not XML and not SQL (like hibernate)

对于一对一，一对多，多对一，多对多的关联查询，Mybatis-Plus 在处理时，需要编写关联查询方法及配置resultMap，并且书写SQL。

为了简化这种操作，可以自定义注解来简化。

注解工具源码及jar包地址：

https://github.com/dreamyoung/mprelation.git

https://gitee.com/dreamyoung/mprelation.git

测试项目地址(GITHUB) ：

https://github.com/dreamyoung/mprelation_demo.git

https://gitee.com/dreamyoung/mprelation_demo.git

POM引用：

com.github.dreamyoung mprelation 0.0.3.2-RELEASE

注解工具使用公优缺点：

优点：

   使用简单，通过在实体类上添加@OneToOne / @OneToMany /  @ManyToOne /  @ManyToMany  等注解即可。

   1对1、1对多、多对1、多对多映射时，可以不再写SQL及XML配置文件，免去配置冗长的<resultMap>的麻烦。

   Service层及Mapper层不需要再添加 getLinkById 、 selectLinkById   之类的方法来关联映射

   重写过的ServiceImpl各种内置的查询方法都自动关联查询，非内置方法可以调用autoMapper相关方法进行自动或手动关联

   解决关联处理的1+n问题

缺点：

   目前只针对SqlSession/Mappe形式有效（ActiveRecord形式暂未涉及修改，也没有测试）

   非事务下， 1个连接（1个SqlSession）只执行一条SQL，而自动获取每个关联属性的sql都会创建1~2个SqlSession（并执行1~2条SQL)。如果需要使用非内置方法（即除ServiceImpl外的方法）,必须配置只读事务来减少SqlSession创建。

   如果有多个延迟加载的关联属性，类上可注解@AutoLazy(false)或没有标注该注解（默认），之后通过initialize方法在事务范围内的一个SqlSession中同时加载需要的多个延迟加载的属性。

使用注意点：

   非ServiceImpl内置的业务查询，配置事务管理，减少SqlSession的创建。

   实体上可用注解@AutoLazy(true)来标注是否自动触发延迟加载（true的话则

   如果可以，不使用延迟加载（延迟加载的使用是在SqlSession关闭后执行的，需要重新创建SqlSession）。

   如果确实需要延迟加载，可使用ServiceImpl 或  AutoMapper 相关的initialize方法一次性加载所有需要的被延迟的属性(只需要创建额外的一个SqlSession）

注解使用：

一对多(多对一) ：

Company实体类中配置：

@Data

public class Company { @TableId(value = "company_id") private Long id; private String name;

//一对多
@TableField(exist = false)
@OneToMany
@JoinColumn(name="company_id",referencedColumnName = "company_id")
private Set<Man> employees;

}

Man实体类中配置：

@Data

public class Man {

@TableId(value = "man_id")
private Long id;
private String name;

//多对一
@TableField("company_id")
private Long companyId;

@TableField(exist = false)
@ManyToOne
@JoinColumn(name = "company_id", referencedColumnName = "company_id")
private Company company;

}

一对多（多对一）表结构： company: (compnay_id, name) man: (man_id, name, company_id)

一对一：

Woman实体类配置：

@Data

public class Woman {

@TableId(value = "woman_id")
private Long id;

private String name;

//一对一
@TableField("lao_gong_id")
private Long laoGongId;

@TableField(exist = false)
@OneToOne
@JoinColumn(name = "lao_gong_id", referencedColumnName = "man_id")
private Man laoGong;

}

Man实体类配置：

@Data

public class Man { @TableId(value = "man_id") private Long id; private String name;

//一对一
@TableField("lao_po_id")
private Long laoPoId;

@TableField(exist = false)
@OneToOne
@JoinColumn(name = "lao_po_id", referencedColumnName = "woman_id")
private Woman laoPo;

}

一对一表结构：（实际可以减少一方） woman: (woman_id, name, lao_gong_id) man: (man_id, name, lao_po_id)

多对多：

Course实体类配置：

@Data

public class Course { @TableId(value = "course_id") private Long id; private String name;

//多对多
@TableField(exist = false)
@ManyToMany
@JoinTable(targetMapper = StudentCourseMapper.class)
@JoinColumn(name = "course_id", referencedColumnName = "course_id")
@InverseJoinColumn(name = "child_id", referencedColumnName = "student_id")
private List<Child> students;

}

Child实体类配置：

@Data

public class Child { @TableId("child_id") private Long id; private String name;//多对多 @TableField(exist = false) @ManyToMany @JoinTable(targetMapper=StudentCourseMapper.class) @JoinColumn(name = "child_id", referencedColumnName = "student_id") @InverseJoinColumn(name = "course_id", referencedColumnName = "course_id") private List courses; }

StudenCourse中间类（多对多必须要有）：

@Data

public class StudentCourse { //可以有也可以无此ID private Long id;

@TableField("student_id")
private Long studentId;

@TableField("course_id")
private Long courseId;

}

多对多表结构：course: (course_id, name) child: (child_id, name) student_course:(id, student_id, course_id)

使用过程：

POM中引入mprelation，并配置 AutoMapper （只要是扫描被注解的实体类）

@Configuration

public class AutoMapperConfig {

@Bean
public AutoMapper autoMapper() {
    return new AutoMapper(new String[] { "demo.entity","demo.bean" }); //配置实体类所在目录（可多个,暂时不支持通过符*号配置）
}

}

在实体类中配置注解（更多的注解配置见上边注解部分，这里只只列出其中一个）

@Data

@AutoLazy //不需要手动触发加载延迟属性，当延迟属性被调用时自动创建Session进行获取。可见如果有多个延迟属性需要被使用时，会造成多次创建Session，此时可以标注为AutoLazy(false)或不标注，然后采用initialze方法手动一次性加载需要的属性

public class Man {

@TableId(value = "man_id")
private Long id;

private String name;

private Long laoPoId;

@TableField(exist = false)
@OneToOne
@JoinColumn(name = "lao_po_id", referencedColumnName = "woman_id")
private Woman laoPo;

@TableField("company_id")
private Long companyId;

@TableField(exist = false)
@ManyToOne
@JoinColumn(name = "company_id", referencedColumnName = "company_id")
private Company company;

@TableField(exist = false)
@OneToMany
@JoinColumn(name = "man_id", referencedColumnName = "lao_han_id")
@Lazy(false)
private List<Child> waWa;

@TableField(exist = false)
@OneToMany
@JoinColumn(name = "man_id", referencedColumnName = "man_id")
@Lazy(false)
private Set<Tel> tels;

}

在Service层、Mapper层的使用，见下面：以下是基于Mybatis-Plus官方示例修改而来的测试程序：

通过继承工具类重写过的IService / ServiceImpl 会自动执行关联映射, 无须再写gettLinkById之类的方法（可以使得各实现类没有任何方法）：

mapper接口：

public interface ManMapper extends BaseMapper {}

service接口：

public interface IManService extends IService {} // IService为重写过的同名接口

Service实现：

@Service public class ManServiceImpl extends ServiceImpl<ManMapper, Man> implements IManService {} // ServiceImpl为重写过的同名接口

测试调用：

public class ServiceTest { @Autowired ManService manService;

@Test
public void t_man_serviceImpl() {
    Man man = manService.getById(1); // 原Mybatis-Plus的ServiceImpl的各种查询，被重写过后，都可以自动关联,
    System.out.println(man);        
}

}

结果输出:

Man( id=1, name=程序猿小明, laoPoId=1, laoPo=Woman(id=1, name=程序猿小明老婆, laoGongId=1, laoGong=null, waWa=null), companyId=1, company=Company(id=1, name=百度, employees=null), waWa=[ Child(id=1,name=xxx1,lao_han_id=null, laoHan=null, lao_ma_id=null, laoMa=null, courses=null), Child(id=2,name=xxxx2, lao_han_id=null, laoHan=null, lao_ma_id=null, laoMa=null, courses=null)
], tels=[ Tel(id=1, tel=139xxxxxx, manId=1, laoHan=null), Tel(id=4, tel=159xxxxxx, manId=1, laoHan=null), Tel(id=2, tel=137xxxxxx, manId=1, laoHan=null) ] )

如需需要对其关联属性对象的关联属性进行自动加载，可以继续使用AutoMapper对象的mapperEntity、mapperEntityList、mapperEntitySet、mapperEntityPage来操作：

比如想获取（填充）waWas 的关联，则：

List waWas=man.getWaWas(); autoMapper.mapperEntityList(waWas);

AutoMapper类中的几个常用方法说明：

    mapperEntity(entity)                                            可以对一个实体类，实现自动关联。

   mapperEntityList(entity_list)                                可以对一个实体类List，实现自动关联。

   mapperEntitySet(entity_set)                                可以对一个实体类Set，实现自动关联。

   mapperEntityCollection(entity_list_or_set)          可以对一个实体类Set或List，实现自动关联。

   mapperEntityPage(entity_page)                          可以对一个实体类Page，实现自动关联。
   
   mapper(entity_entityListOrSet_entityPage)           统一上边的各种方法，直接对实体类，列表，分页都可以实现自动关联。


  initialize(entity/entityList/entitySet/entityPage,    OneOrMoreLazyPropertyName ...)                   

                可以对一个实体类/实体类List/实体类Set/实体类Page，在事务范围内，手动立即触发其各个被@Lazy(true)标注的关联属性。

              该方法在重写过的ServiceImpl内也存在(供Controller层调用来加载延迟关联的属性）。

AutoMapper在重写过的ServiceImpl类中已经自动注入可用(名为autoMapper)，其它情况也可以手动注入：

public class MPRTest2 { @Autowired AutoMapper autoMapper;

@Resource
private ManMapper manMapper;

@Test
public void t_man() {
    Man man = manMapper.selectById(1L);
    autoMapper.mapperEntity(man);
    System.out.println(man);
}

}

qq347139393 / mprelation Goto Github PK

mprelation's Introduction

MPRelation

mprelation's People

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent