syj-minicode

a project about minicode

License	The ApacheSoftware License, Version 2.0
GroupId	cn.org.zhixiang
ArtifactId	syj-minicode
Last Version	0.0.4
Release Date	Oct 23, 2018
Type	jar
Description	syj-minicode a project about minicode
Source Code Management	https://github.com/2388386839/syj-minicode.git

Download syj-minicode

Filename	Size
syj-minicode-0.0.4.pom
syj-minicode-0.0.4.jar	21 KB
syj-minicode-0.0.4-sources.jar	14 KB
syj-minicode-0.0.4-javadoc.jar	142 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/cn.org.zhixiang/syj-minicode/ -->
<dependency>
    <groupId>cn.org.zhixiang</groupId>
    <artifactId>syj-minicode</artifactId>
    <version>0.0.4</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/cn.org.zhixiang/syj-minicode/
implementation 'cn.org.zhixiang:syj-minicode:0.0.4'

Gradle Kotlin

// https://jarcasting.com/artifacts/cn.org.zhixiang/syj-minicode/
implementation ("cn.org.zhixiang:syj-minicode:0.0.4")

Apache Buildr

'cn.org.zhixiang:syj-minicode:jar:0.0.4'

Apache Ivy

<dependency org="cn.org.zhixiang" name="syj-minicode" rev="0.0.4">
  <artifact name="syj-minicode" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='cn.org.zhixiang', module='syj-minicode', version='0.0.4')
)

Scala SBT

libraryDependencies += "cn.org.zhixiang" % "syj-minicode" % "0.0.4"

Leiningen

[cn.org.zhixiang/syj-minicode "0.0.4"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.github.pagehelper : pagehelper-spring-boot-starter	jar	1.2.5

provided (7)

Group / Artifact	Type	Version
org.springframework : spring-context	jar	5.0.4.RELEASE
org.springframework : spring-web	jar	5.0.4.RELEASE
org.springframework : spring-webmvc	jar	5.0.4.RELEASE
org.mybatis.spring.boot : mybatis-spring-boot-starter	jar	1.3.0
org.mybatis : mybatis	jar	3.4.2
org.springframework.boot : spring-boot-starter-aop	jar	2.0.0.RELEASE
javax.servlet : javax.servlet-api	jar	3.1.0

Project Modules

There are no modules declared in this project.

syj-minicode

项目介绍

此项目把Java后端最常用的代码全都抽象出来，一经使用即可减少开发者80%的工作量，使大家把所有的精力解放到业务代码中。

为什么选择syj-minicode

1. 你是否懒得写普通的增删改查方法?
2. 你是否不喜欢代码生成插件的重复代码？
3. 你是否渴望一个没有冗余代码的项目？
4. 你是否渴望一行代码都不用写就能完成一个简单的模块？

如何不写代码就完成一个简单的模块

当一些单表的增删改查时你只需要告诉前端来调用这几个接口就行了

下方出现的entityName为当前操作的对象名称或者数据库表名称（注意命名规范要符合驼峰命名法，例如：UserOrder或者user_order都可以） 删除接口为物理删除，逻辑删除请使用update接口

1. 根据主键查询对象

     @RequestMapping(value = "/syj-api/{entityName}/{id}", method = RequestMethod.GET)

2. 分页查询

   @RequestMapping(value = "/syj-api/{entityName}/page", method = RequestMethod.POST)
   @RequestBody： GridPageRequest

   这里的GridPageRequest为分页查询的条件，看一下它的组成元素

      /**
      * 查询关键字Map
      */
      private Map<String, String> searchMap;
      /**
      * 模糊查询关键字Map
      */
      private Map<String, String> likeSearchMap;
      /**
      * 排序关键字Map
      */
      private Map<String, String> orderMap;
      /**
      * 分组关键字数组
      */
      private String[] groupArray;
      /**
      * 第几页
      */
      private Integer pageNum;
      /**
       * 查几条
       */
      private Integer pageSize;
      /**
        * 大于等于查询关键字Map
        */
       private Map<String, String> largeSearchMap;
       /**
        * 小于等于查询关键字Map
        */
       private Map<String, String> smallSearchMap;
       /**
        * 不等于查询关键字Map
        */
       private Map<String, String> notEquleSearchMap;

   前端查询时只需要按照查询条件组装GridPageRequest对象就可以了
3. 插入

   @RequestMapping(value = "/syj-api/{entityName}/insert", method = RequestMethod.POST)
   @RequestBody： Object（待插入对象）

4. 根据主键进行更新

   @RequestMapping(value = "/syj-api/{entityName}/update", method = RequestMethod.PUT)
   @RequestBody： Object（待更新对象）

5. 根据主键进行删除

   @RequestMapping(value = "/syj-api/{entityName}/{id}", method = RequestMethod.DELETE)

6. 批量删除

   @RequestMapping(value = "/syj-api/{entityName}/deleteByIds", method = RequestMethod.DELETE)
   @RequestBody： List<String> ids（待删除主键列表）

扩展接口

1. 因为默认情况下单个对象查询、修改、删除所依据的主键的字段名使用的都是"id",但是很可能有的项目使用的是userId、orderId、roleId等主键，如果你的项目符合这个条件注入下方这个bean。

              @Bean
              public IdField idField() {
                  Map<String,String> map=new ConcurrentHashMap<>();
                  map.put("user","userId");
                  map.put("order","orderId");
                  map.put("role","roleId");
                  IdField idField=new IdField();
                  idField.setMap(map);
                  return idField;
              } 

2. 有的项目在进行插入和更新时会加入创建人和修改人等信息，查询时可能会忽略某些字段不想让某些字段传递给前端，如果有此需求请按照如下方式调用
   1. 插入扩展 创建一个名为InsertExtend的bean并实现DefaultExtend接口

   @Component
   public class InsertExtend implements ExtendInterface{
       @Override
       public Map<String, String> exectue() {
           Map<String, String> map=new HashMap<>();
           map.put("createTime", System.currentTimeMillis());
           map.put("createBy", "创建人id");
           map.put("createUserName", "创建人名称");
           return map;
       }
   }

   2. 更新扩展 创建一个名为UpdateExtend的bean并实现DefaultExtend接口

       @Component
       public class UpdateExtend implements ExtendInterface{
           @Override
           public Map<String, String> exectue() {
               Map<String, String> map=new HashMap<>();
               map.put("updateTime", System.currentTimeMillis());
               map.put("updateBy", "修改人id");
               map.put("updateUserName", "修改人名称");
               return map;
           }
       }

   3. 查询扩展 创建一个名为SelectExtend的bean并实现DefaultExtend接口

          @Component
          public class SelectExtend implements ExtendInterface{
              @Override
              public Map<String, String> exectue() {
                  Map<String, String> map=new HashMap<>();
                  map.put("user", "id, user_name as userName, pass as passWord");
                  map.put("merchant_user", "create_user as createUser, update_by as updateUser");
                  return map;
              }
          }

还有没有更灵活的使用方式？

上方使用方式其实是直接抽象到了controller层，解决一般的需要是没问题的，但是我们是有业务逻辑的，那么存在业务逻辑的情况下如何使用呢？ 你可以在处理完业务逻辑后在service中调用

1. 初始化

   private BaseService getUserBaseService(){
           return ServiceBeanFactory.getBean("User");
       }

2. 根据id查询

   Map<String,Object> userMap=getUserBaseService().selectOneById("115");
   User user=(User) BeanMapUtil.mapToBean(map,User.class);

3. 根据条件查询列表（相信你已经知道了gridPageRequest对象如何组装）

   List<Map<String, Object>> userMaps=getUserBaseService().selectBySelective(gridPageRequest);
   for (Map<String, Object> map:userMaps){
       User user=(User) BeanMapUtil.mapToBean(map,User.class);    
   }

4. 插入

   getUserBaseService().insertSelective(user);

5. 更新

   getUserBaseService().updateByIdSelective(user);

6. 删除

   getUserBaseService().deleteById("115");

7. 批量删除

   List<String> list=new ArrayList<>();
   list.add("115");
   list.add("116");
   list.add("117");
   getUserBaseService().deleteByIds(list);

8. 自定义查询sql

   getUserBaseService().selectBySelective("select * from user");
   

Quick Start

相信看了上方的介绍你已经迫不及待的想要使用了，那么使用起来简单么？看一下你就知道。

1. 引入syj-minicode

   <dependency>
       <groupId>cn.org.zhixiang</groupId>
       <artifactId>syj-minicode</artifactId>
       <version>请使用以maven中央仓库的最新版本为准</version>
    </dependency>

2. 注册syj-minicode

   因为并不是所有的项目都会使用SpringBoot,所以在注册这一步我们分为两种情况

   1. SpringBoot或SpringCloud项目 你需要在启动类上增加一个注解

      @EnableSyjMiniCode

   2. Spring

      你需要提供一个可以被Spring管理的配置类。比如说：

      @Import(EnableSyjMiniCodeConfiguration.class)
      @Configuration
      public class SyjMiniCodeConfig {
      }
      

更多

1. 如果将syj-minicode用于项目的请在此链接留下足迹，便于宣传。开源登记
2. 如果有需要新功能的同志可以在此链接留下足迹，帮助syj-minicode更加完善。新需求

作者信息

1. 个人网站
2. GitHub

版本信息

1. 0.0.1

   syj-minicode上线

2. 0.0.2

1. 增加普通查询时有使用大于小于不等于的查询条件
2. 增加自定义查询sql接口

3. 0.0.3

1. 解决部分项目引入不能启动的问题
2. 引入pagehelper分页插件

4. 0.0.4

1. 新增查询扩展接口

扫码关注公众号即可领取2000GJava学习资源

Versions

Version
0.0.4 Oct 23, 2018
0.0.3 Oct 19, 2018
0.0.2 Oct 18, 2018
0.0.1 Oct 15, 2018