Merge remote-tracking branch 'origin/dev' into satoken

疯狂的狮子li

2021-12-27 dd37247e65374dd4ef7e8e8b9212d8f29023e301

 ruoyi-common/src/main/java/com/ruoyi/common/core/mybatisplus/core/IServicePlus.java

@@ -1,7 +1,7 @@
package com.ruoyi.common.core.mybatisplus.core;

import cn.hutool.core.bean.copier.CopyOptions;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.common.core.page.PagePlus;
@@ -15,45 +15,36 @@
/**
 * 自定义 Service 接口, 实现 数据库实体与 vo 对象转换返回
 *
 * @param <T> 数据实体类
 * @param <V> vo类
 * @author Lion Li
 * @since 2021-05-13
 */
public interface IServicePlus<T, K> extends IService<T> {
public interface IServicePlus<T, V> extends IService<T> {

   /**
    * @param id          主键id
    * @param copyOptions copy条件
    * @return K对象
    * @return V对象
    */
   K getVoById(Serializable id, CopyOptions copyOptions);

   default K getVoById(Serializable id) {
      return getVoById(id, new CopyOptions());
   }
   V getVoById(Serializable id);

   /**
    * @param convertor 自定义转换器
    */
   default K getVoById(Serializable id, Function<T, K> convertor) {
   default V getVoById(Serializable id, Function<T, V> convertor) {
      return convertor.apply(getById(id));
   }

   /**
    * @param idList      id列表
    * @param copyOptions copy条件
    * @return K对象
    * @return V对象
    */
   List<K> listVoByIds(Collection<? extends Serializable> idList, CopyOptions copyOptions);

   default List<K> listVoByIds(Collection<? extends Serializable> idList) {
      return listVoByIds(idList, new CopyOptions());
   }
   List<V> listVoByIds(Collection<? extends Serializable> idList);

   /**
    * @param convertor 自定义转换器
    */
   default List<K> listVoByIds(Collection<? extends Serializable> idList,
                        Function<Collection<T>, List<K>> convertor) {
   default List<V> listVoByIds(Collection<? extends Serializable> idList,
                        Function<Collection<T>, List<V>> convertor) {
      List<T> list = getBaseMapper().selectBatchIds(idList);
      if (list == null) {
         return null;
@@ -63,20 +54,15 @@

   /**
    * @param columnMap   表字段 map 对象
    * @param copyOptions copy条件
    * @return K对象
    * @return V对象
    */
   List<K> listVoByMap(Map<String, Object> columnMap, CopyOptions copyOptions);

   default List<K> listVoByMap(Map<String, Object> columnMap) {
      return listVoByMap(columnMap, new CopyOptions());
   }
   List<V> listVoByMap(Map<String, Object> columnMap);

   /**
    * @param convertor 自定义转换器
    */
   default List<K> listVoByMap(Map<String, Object> columnMap,
                        Function<Collection<T>, List<K>> convertor) {
   default List<V> listVoByMap(Map<String, Object> columnMap,
                        Function<Collection<T>, List<V>> convertor) {
      List<T> list = getBaseMapper().selectByMap(columnMap);
      if (list == null) {
         return null;
@@ -86,37 +72,27 @@

   /**
    * @param queryWrapper 查询条件
    * @param copyOptions  copy条件
    * @return K对象
    * @return V对象
    */
   K getVoOne(Wrapper<T> queryWrapper, CopyOptions copyOptions);

   default K getVoOne(Wrapper<T> queryWrapper) {
      return getVoOne(queryWrapper, new CopyOptions());
   }
   V getVoOne(Wrapper<T> queryWrapper);

   /**
    * @param convertor 自定义转换器
    */
   default K getVoOne(Wrapper<T> queryWrapper, Function<T, K> convertor) {
   default V getVoOne(Wrapper<T> queryWrapper, Function<T, V> convertor) {
      return convertor.apply(getOne(queryWrapper, true));
   }

   /**
    * @param queryWrapper 查询条件
    * @param copyOptions  copy条件
    * @return K对象
    * @return V对象
    */
   List<K> listVo(Wrapper<T> queryWrapper, CopyOptions copyOptions);

   default List<K> listVo(Wrapper<T> queryWrapper) {
      return listVo(queryWrapper, new CopyOptions());
   }
   List<V> listVo(Wrapper<T> queryWrapper);

   /**
    * @param convertor 自定义转换器
    */
   default List<K> listVo(Wrapper<T> queryWrapper, Function<Collection<T>, List<K>> convertor) {
   default List<V> listVo(Wrapper<T> queryWrapper, Function<Collection<T>, List<V>> convertor) {
      List<T> list = getBaseMapper().selectList(queryWrapper);
      if (list == null) {
         return null;
@@ -124,46 +100,51 @@
      return convertor.apply(list);
   }

   default List<K> listVo() {
   default List<V> listVo() {
      return listVo(Wrappers.emptyWrapper());
   }

   /**
    * @param convertor 自定义转换器
    */
   default List<K> listVo(Function<Collection<T>, List<K>> convertor) {
   default List<V> listVo(Function<Collection<T>, List<V>> convertor) {
      return listVo(Wrappers.emptyWrapper(), convertor);
   }

   /**
    * @param page         分页对象
    * @param queryWrapper 查询条件
    * @param copyOptions  copy条件
    * @return K对象
    * @return V对象
     * @deprecated 3.6.0 移除 请使用 {@link ServicePlusImpl#pageVo(IPage, Wrapper)}
    */
   PagePlus<T, K> pageVo(PagePlus<T, K> page, Wrapper<T> queryWrapper, CopyOptions copyOptions);
    @Deprecated
   PagePlus<T, V> pageVo(PagePlus<T, V> page, Wrapper<T> queryWrapper);

   default PagePlus<T, K> pageVo(PagePlus<T, K> page, Wrapper<T> queryWrapper) {
      return pageVo(page, queryWrapper, new CopyOptions());
   }

   /**
    * @param convertor 自定义转换器
    */
   default PagePlus<T, K> pageVo(PagePlus<T, K> page, Wrapper<T> queryWrapper,
                          Function<Collection<T>, List<K>> convertor) {
      PagePlus<T, K> result = getBaseMapper().selectPage(page, queryWrapper);
    /**
     * @param convertor 自定义转换器
     * @deprecated 3.6.0 移除 请使用 {@link ServicePlusImpl#pageVo(IPage, Wrapper)}
     */
    @Deprecated
   default PagePlus<T, V> pageVo(PagePlus<T, V> page, Wrapper<T> queryWrapper,
                          Function<Collection<T>, List<V>> convertor) {
      PagePlus<T, V> result = getBaseMapper().selectPage(page, queryWrapper);
      return result.setRecordsVo(convertor.apply(result.getRecords()));
   }

   default PagePlus<T, K> pageVo(PagePlus<T, K> page) {
    /**
     * @deprecated 3.6.0 移除 请使用 {@link ServicePlusImpl#pageVo(IPage, Wrapper)}
     */
    @Deprecated
   default PagePlus<T, V> pageVo(PagePlus<T, V> page) {
      return pageVo(page, Wrappers.emptyWrapper());
   }

   /**
    * @param convertor 自定义转换器
     * @deprecated 3.6.0 移除 请使用 {@link ServicePlusImpl#pageVo(IPage, Wrapper)}
    */
   default PagePlus<T, K> pageVo(PagePlus<T, K> page, Function<Collection<T>, List<K>> convertor) {
    @Deprecated
   default PagePlus<T, V> pageVo(PagePlus<T, V> page, Function<Collection<T>, List<V>> convertor) {
      return pageVo(page, Wrappers.emptyWrapper(), convertor);
   }