# fhs-framework
**Repository Path**: sysadm/fhs-framework
## Basic Information
- **Project Name**: fhs-framework
- **Description**: Fhs-Framework是一个基于Springboot+Springcloud + Mybatis Plus + sa-token+ vue + elementui 的快速开发平台(低代码开发平台)，本框架永远免费，永久全开源
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: v3.x
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 209
- **Created**: 2022-03-10
- **Last Updated**: 2022-12-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
FHS-Framwork是一个集成了国内外诸多优秀开源项目的快速开发平台，除了在常规快速开发平台提供 用户，角色，权限，菜单，字典，审计日志，代码生成器 还拥有可以让您更少写SQL和前端代码的翻译服务以及PAGEX服务。
FHS-Framwork官方交流群：976278956
+
-----------------------------------------------------------------------------------------------
# 体验地址(求star)
http://82.157.62.164/login admin 123456
# 预览图
# 3. 技术栈
# 4. 和其他框架差异化特性
## - 翻译组件
翻译组件可以只通过注解把你表里的id转换为名称，把你的字典码转换为字典注释(比如0转换为男1转换为女)，详情见：https://gitee.com/fhs-opensource/easy_trans
## - All in One模式 开发 微服务模式部署
微服务开发对于电脑内存要求比较高，调试个东西要启动好多个微服务还要启动网关，调用链路复杂的点一下不知道调用到谁那里去了，要解决还要自己机器跑nacos，fhs 首创，all in one 模式开发，微服务模式部署，在开发环境直接把所有的模块集成到一个springBoot项目启动，部署的时候又使用微服务+网关模式部署 参考：fhs_app/fhs_app_all_in_one 和 fhs_app/fhs_app_basics的做法 即可实现。
## - 更简单的微服务调用
传统微服务玩法是第一我定义一个fegin api接口，然后写一个controller ，在写一个service实现 需要三个步骤，fhs 集成了easy cloud，只需要在service层给对应的方法上加@CloudMethod 即可完成接口暴露，哪个微服务用到直接 Autowired service接口即可。详情：https://gitee.com/fhs-opensource/easy_cloud
## - 更好用的校验框架
集成了validate-springboot-starter，在兼容hibernate Validator和javax validation的同时，支持了更多自定义玩法。
内置常用验证规则：比如手机号验证，正则验证，ip,邮箱，长度，范围，数字，小数，中国车牌号，身份证，长度， url, 图书ISBN编号,文件后缀,文件大小 等常用验证规则
## - JSON驱动的VUE 列表和表单组件
avue今年又获得了GVP，证明了越来越多的前端程序员开始接受JSON驱动来写VUE 页面，fhs 也将组件封装为JSON驱动的组件，比如简单的CRUD，就可以这么写：
```html
```
## - Mybatis Plus查询增强
Mybatis的wrapper是我见过特别好的查询api设计，但是条件稍微多一点就写的很长，我们通过APT技术(类似lombok对po进行编译时增强)，对PO进行增强，使用PO来替代原生Wrapper构造，和activeRecord配合起来简直不要太美。上demo:
```java
//有po定义如下：
@Data
@Wrapperable //增强注解 类似lombok的@data 注解
@TableName("user")
public class User {
@TableId("user_id")
private Integer userId;
@TableField("name")
private String name;
@TableField("age")
private Integer age;
@TableField("sex")
private String sex;
}
@GetMapping("/one")
public User one() {
return User.newOBJ().nameLike("小").one();
}
@GetMapping("/oneField")
public User oneField() {
//这里只查id和name2个字段
return User.newOBJ().nameLike("小").one(new String[]{User.USERID, User.NAME});
}
@GetMapping("/list")
public List list() {
return User.newOBJ().ageBetween(10, 25).list();
}
@GetMapping("/listField")
public List listField() {
return User.newOBJ().ageBetween(10, 20).list(new String[]{User.USERID, User.NAME});
}
@GetMapping("/delete")
public int delete() {
return User.newOBJ().ageBetween(50, 80).delete();
}
@GetMapping("/count")
public Long count() {
return User.newOBJ().ageBetween(10,26).count();
}
@GetMapping("/update")
public int update() {
User user = User.newOBJ();
user.setAge(19);
//把小明的年龄改为19
return user.nameEQ("小明").update();
}
```
如果想单独使用此插件，也可访问我们的mp_Ext开源项目：https://gitee.com/fhs-opensource/fhs_mp
### class和提示已经支持自动生成的方法有：
bean2Wrapper,list,list(String[] fields),one,one(String[] fileds),count,delete,update,newOBJ
### 已经支持的wrapper相关操作方法有：
eq,neq,ge,gt,le,lt,like,notLike,likeLeft,likeRight,in,notIn,between,orderByAsc,orderByDesc,isNull,notNull
### 千万注意：
本功能和lombok一样需要搭配idea插件使用，不然class虽然增强了但是idea 无法识别这些方法报错，但是不影响运行，我们提供了配套的idea插件 ： https://gitee.com/fhs-opensource/fhs_mp/tree/master/idea_plugin
要求idea版本为 2021.2.2 以及 以上。
并且idea加入以下配置：setting-Build,Execution,Deployment-Compiler Shared build process VM 的value设置为 option -Djps.track.ap.dependencies=false
# 使用说明
1 新出炉的文档 https://gitee.com/fhs-opensource/fhs-framework/wikis/pages?sort_id=2052774&doc_id=333929
2 word格式的文档 在sql&docs目录
3 quik start
A 准备好redis和mysql
B 创建数据库，导入sql&docs 下的fhs-demo.sql （如果遇到部分sql执行失败，请手动执行）
C 修改fhs_app/fhs_app_all_in_one/src/main/resources/application.yml redis(2处，jetcache和spring的redis)和mysql配置
C 启动fhs_app/fhs_app_all_in_one/src/main/java/com/fhs/app/SingleApplication.java
如果遇到下载不了的jar，请使用中央仓库官方地址：https://repo1.maven.org/maven2/ 阿里云的easycloud core 好像down不下来，或者手动下载下来放到本地仓库目录中。
4 视频:
https://www.bilibili.com/video/BV1DK4y1s7AL/ 基础介绍和翻译服务使用
https://www.bilibili.com/video/BV1eh411o7Td/ 新项目使用fhs
https://www.bilibili.com/video/BV115411Y7NR/ 代码生成器使用1
https://www.bilibili.com/video/BV1vK4y1s7hT/ 代码生成器使用2
https://www.bilibili.com/video/BV1sf4y1R7dH/ base类中的方法介绍以及activeRecord模式适用
# 写到最后
目前国内有很多快速开发平台，每个也有每个不同的特色，FHS不一定是最好的，但是我们愿意做百花齐放的快开平台的一朵鲜花，和很多脑子一热写个快开平台或者打算以此盈利不同，FHS 是长久维护的，也是全开源的，希望路过的同学给个Star 抱拳拉！