# java简单工具

**Repository Path**: MacXiang/Utils

## Basic Information

- **Project Name**: java简单工具
- **Description**: 文本等格式化,http带参数的请求分析文件mime.微信支付登录等;
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-13
- **Last Updated**: 2025-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 公共

### 介绍

    Utils是一个快餐java后端项目工具库.里面集成了mysql数据库连接、webHTTP服务、常用的一些方法.
    简化了一些配置,减少pom.xml的一些引用依赖;基本上一个小项目用到本项目透传的依赖就差不多了,尽可能做到即开即用;

### 软件架构

    旨在快速创建后端，摈弃繁琐的依赖；常用依赖都有，并简化很多请求方式，这里没有使用MP等三方工具来连接数据库，而是自行实现了mysql数据到自定义entity，并且查询方式也做了修改。

### 安装教程

    1.  git clone https://gitee.com/MacXiang/utils.git
    2.  mvn clean install;
    3.  在你的项目pom.xm引入生成包的依赖.例如

```xml
    <dependency>
      <groupId>io.gitee.macxiang</groupId>
      <artifactId>utils</artifactId>
      <version>0.0.4</version>
    </dependency>
```

### 更新记录
    0.0.4   2020-06-17  新增数据时,当字段属性为exist=false,select=true时,将不不要的字段加入;
                        修改:DataBase.save为SQL事务 READ COMMITTED;
            2020-06-16  修改:Sql规则,允许children单独存在;修复bug: update语句;修复bug: 
    0.0.3   2020-06-14  修复bug;新增WhereResult方法(select/join 的callback方法,方便链式操作,而不必在WhereResult实体进行修改);
    0.0.2   2020-05-07  修复bug
    0.0.1   2020-05-07  初始版本

### 使用说明

```yml
mac:
  sql:
    addr: localhost           # 数据库地址
    port: 3306                # 数据库端口
    database: canlian         # 数据库表名
    username: root            # 数据库用户名
    password: 123654          # 数据库密码
    maxcount: 100             # 最大连接数
    ...                       # 以及一些其他
  controller:
    regex: .*\.(\w+)Service"; #接口替换规则;原始文本为Entity的类名
    replacement: $1; #用作替换的文本
    fristLower: false; #接口首字母小写
    prefix: /api; #自动接口的前缀uri
```

    2. 在main入口函数加入注解@io.gitee.macxiang.annotation.EntityScan(basePackages={定义的数据库实体类路径例如: com.xxx.xxx.entity}); 可以有多个路径,项目启动后,将会自动扫描这个路径下的.java文件;首次启动时,会自动添加服务类文件,其命名规则如上配置
    3. 至于servi的使用方法,可以点开源码BaseService,里面都有完整说明,这里不一一举例了;
    4. 至于自动控制器对应servic方法,需要在项目启动完成后,再对其初始化,建议使用注解@EventListener(ApplicationReadyEvent.class) 注解你的某个方法,在这里面运行utils.controller.init方法进行初始化.具体使用请看说明;
    5. utils下有非常多的方法,这里没法一个个的列出来,点开源码凑合看吧;
    6. 有一个WeChat类,这是微信相关的登录,支付,转账等功能的一个类.想要配置他,建议使用自定义的一个服务类,继承这个类.然后运行init方法进行配置;

#### 关于 git 方面的备忘

    链接第三方仓库命令 git submodule add -f https://gitee.com/MacXiang/public.git public
    链接完后,需要运行命令,以加载三方库所引入的其他仓库
          git submodule update --init --recursive
    如果本地已经有了public,可以使用cmd命令,此命令是将本地的一个目录硬链接到当前目录,节省硬盘开销;
          mklink /d /h /j public d:\code\public
    发布至maven仓库 mvn clean deploy -P release -q

### 参与贡献

    1.  Fork 本仓库
    2.  新建 Feat_xxx 分支
    3.  提交代码
    4.  新建 Pull Request

### 闲聊

    之所以会在service下生成一个Auto.java,其主要目的是用来做IDE的提示用的,本来想做一个类似lombok的方式来着,结果辛辛苦苦将功能实现了,但也仅仅是功能实现了,却没有ide提示的功能,只能是运行时不报错而已.ide提示需要插件支持;懒得再去搞插件了,于是就想了个这么个偏门方法; 如果哪位大佬能有好方法麻烦也指点一下;