FHS-Framework 简介

fhs-framwork是一个集成了国内外诸多优秀开源项目的快速开发平台，除了在常规快速开发平台提供用户，角色，权限，菜单，字典，操作日志，代码生成器等功能的基础上，还在以下方面为您的快速开发做出了努力。

1. 项目基础框架搭建期

开箱即用:依赖redis和mysql,导入数基础的脚本后,修改下配置文件,即可使用。

2. DB接入方面

- 减少手写sql

fhs 使用了Mybatis Jpa+Mybatis Plus 框架来帮大家自动生成常见sql，Mybatis Jpa是fhs-opensource下的一款基于Mybatis的JPA的实现，为了补足复杂sql的生成，又对Mybatis Jpa 又对Mybatis Plus做了兼容，可以使用Mybatis Plus的注解来实现sql自动生成，有了Mybatis Jpa+Mybatis Plus 实现80%的单表查询无需写一行sql的效果

- 数据源路由

通过简单的配置即可实现分库，分表，读写分离操作。

- 声明式事物

add，update，del，save 开头的service方法，会默认开启事物，自定义部分请使用注解。

- 数据权限控制

通过简单的配置即可实现组合或者单一数据权限控制

3. 日常业务方面

- 大量的base类使用

通过继承即可完成大部分CRUD操作。

- 提供常见的工具类

日期，日志，反射，网络，校验，文件等等。

- 其他

统一验证框架处理器，统一异常处理器，控制器返回数据json字段过滤器，xss,csrf拦截器等等

4. 翻译服务

翻译服务用于根据表中存放的id来翻译出对应的文字来给做客户做显示使用，翻译服务使用进程缓存，当缓存有更新的时候会自动重新加载(支持分布式)，有着很高的效率，可减少表关联sql的书写。

首先在pojo中添加注解

      @Trans(type="wordbook",key="sex")
	  private Integer sex;  // type代表翻译类型是什么,上面写的是字典,key是sex 如果字典中配置了0-男 1 -女 如果这里的value是0 那么给前端就可以输出为男

自定义表加入到翻译服务demo:

//给这个组织机构翻译起个别名叫做org  需要翻译的字段是 org pojo的name字段   使用redis作为缓存   默认的别名是org
//实际组织机构在生成json的时候默认会为 orgName 而不是name 
@AutoTrans(namespace = BaseTransConstant.ORG, fields = "name", useRedis = true, defaultAlias = "org")
public class UcenterMsOrganizationServiceImpl extends BaseServiceImpl<UcenterMsOrganizationVO, UcenterMsOrganizationDO> implements UcenterMsOrganizationService {

更多玩法请看gitee wiki.

5. 更好用的操作日志

几乎所有的项目中都提供了操作日志,操作日志对开发人员比较友好,对客户来说并不友好,比如奇奇怪怪的字段名客户看不懂,第二一些字典纸比如isDelte:0 客户也看不懂,为了解决这些问题,我们可以根据swagger注解将英文字段名变为了中文字段名(没有配置swagger注解就还会保留英文字段名),并且接入了翻译服务,中间部分字段,比如外键,比如字典都能看到其中文意思, 比如上面的 isDelete 我们会在transMap 这个map中包含一个key: 是否删除:否.客户能很容易看懂日志内容.

除了上述内容外,我们记录了数据的历史版本json,这样很容易能找到某个值是谁将其由A改为B的,张三修改这条数据修改了哪些内容(同上个版本比较字段值得出).

有了操作日志,我们还可以做数据分析,分析哪些人经常使用哪个模块,哪个模块的访问量最大等等.

5. 前端封装

- 给Easyui,Jquery Validform，My97做了整容手术

Easyui是一款颜值稍低但是功能强大上手容易开发效率极高的UI框架，为了让其能不被大家抛弃，继续让他发光发热，我们为其定制了一套BootStrap皮肤,效果堪比Layui。

- 使用Beetl标签技术对常见的表单控件做了封装

后台程序员有句俗话叫做后端10分钟，前端2小时。前端是很多人不愿意碰触的，于是有了很多公司一个项目要招聘2波人，后端专门写后端，前端专门写前段，但是命名一个人就能搞定的事情，非得要2个人？使用fhs的标签，所有的控件做到了统一化，不需要自己写js去初始化，去做校验，去赋值，只要使用了标签，标签中初始化，布局html，赋值，获取值，校验的js就都包含了，很大程度上降低了前端的学习和使用成本。

实例:

<%
include("/page/tags/form_include.html"){}
%>
<form id="addUpdateForm" method="post">
   <#HideFormTag  name='fatherMenuId' title='菜单名称' value='${parameter.parentId}' required='true'/>
   <div class="fitem">
      <#InputFormTag  name='menuName' title='菜单名称' required='true' />
      <#InputFormTag  name='namespace' title='Namespace' required='true' />
   </div>
   <#BigInputFormTag  name='menuUrl' title='链接地址' required='true' />
   <div class="fitem">
      <#WordBookFormTag  name='isEnable' title='状态' code='is_enable' required='true' />
      <#WordBookFormTag  name='menuState' title='是否隐藏' code='yesOrNo' required='true' />
   </div>
   <div class="fitem">
    <#SelectFormTag  name='serverNameId' title='所在服务' url='${basePath}/ms/sett_ms_menu_server/findList' required='true' valueField= 'id'
      textField= 'serverName' />
    <#InputFormTag  name='orderIndex' title='菜单序号' required='true' dataType="n"/>
   </div>
   <#BigInputFormTag  name='image' placeholder="请将logo放到basics/images/menu下这里只写文件名" title='logo'  />
   <div class="fitem">
      <#SelectFormTag  name='systemId' title='子系统' url='${basePath}/ms/sett_ms_system/findList' required='true' valueField= 'id'
      textField= 'name' />
      <#WordBookFormTag  name='menuType' title='菜单类型' code='menu_type' required='true' />
   </div>
</form>

<script>
    $(function () {
         $('#isEnable').combobox('setValue',1);
         $('#menuState').combobox('setValue',0);
    })

   function saveAfterSuccessHandler(){
      document.getElementById('left').contentWindow.reloadData();
       document.getElementById('rightFrame').contentWindow.reload();
   }
</script>
<%
 layout("/page/tags/add_update_tag.html",{'nameSpace':'sysMenu','idField':'menuId'}){}
%>

- 一款帮你写代码的引擎-PAGEX

使用市面上的代码生成器，你做一个CRUD的需要多久呢？如果加上Excel导出，校验，列点击排序这些功能呢？如果要加数据权限，分库，支持多租户呢？要写多少后台代码，写多少sql，写多少js和html？使用pagex，你只需要定义一个JS，你需要的java类框架在运行期(非生成到硬盘上噢)直接给你编译为class扔到classLoader了，Html JS SQL 后台接口按照指定的路径请求引擎也帮你自动生成，而你无需担心JS被暴露，因为JS支持被PAGEX引擎加载当做配置文件用的，既然是配置文件为何选择JS呢？第一：JAVA有JS引擎，可以执行JS代码；第二：JS中有JSON格式，做配置比XML和YML方便，比Properties强大；第三：很多CRUD我们需要自己写一些JS方法，来控制一些插件的隐藏显示以及一些前端业务，把他们写到JS文件中总比写到XML中强很多倍吧。

PAGEX可以通过简单的配置自动生成CRUD代码，可实现导入，字段排序，数据权限，租户权限，字典翻译，表关联，各类表单插件一行json配置等功能，更让人惊喜的是，pagex的js可以通过Idea 的EasyCode插件自动生成，然后稍作改动就可以使用了。

下面是使用PAGEX引擎的一个我们项目中月租户管理的demo

    var modelConfig= {title:'月租户类型',pkey:'id',type:'uuid',orderBy:'update_time Desc',
        namespace:"parking_lease_type",table:'t_park_lease_type',trans:true,db:"park"};
    
    var listPage={
        listFieldSett:function(){
    	  return [
    		  {name:'lease_name',title:'类型名称',width:'20%',align:'center'},
              {name:'park_id',title:'停车场名称',width:'20%',isJoin:true,namespace:'parking',showField:'transMap.parkName',align:'center'},//自动表关联
              {name:'is_disable',title:'是否禁用',width:'10%',formart:'formatRowColor',align:'center',trans:'book',key:'is_disable',showField:'transMap.is_disableName'},//字典翻译
              {name:'create_user',title:'创建人',width:'8%',align:'center',trans:'user',showField:'transMap.create_userUserName'},//用户翻译
              {name:'create_time',title:'创建时间',width:'10%',align:'center'},
              {name:'update_user',title:'更新人',width:'8%',align:'center',trans:'user',showField:'transMap.create_userUserName'},
              {name:'update_time',title:'更新时间',width:'10%',align:'center'},
              {name:'is_sync',title:'是否已下发',width:'5%',align:'center',trans:'book',key:'yesOrNo',showField:'transMap.is_syncName'},//字典翻译
      ]},
      isColumnButton:function(){
    	  return  false;
      },
      filters:function(){
          return [
              {name:'park_id',type:'select',url:'${path.basePath}/ms/x/parking/findListData',
                  valuefield:'id',textfield:'parkName',title:'停车场'},//下拉插件
              {name:'lease_name',type:'input',title:'出入口名称',filterType:'like'},
    	  ];      
      }, 
      buttons:function(){
          return [
              //自定义按钮数组
          ];
      },
      disableButtons:function(){
    	    return [];//禁用掉默认提供的按钮 默认提供了增删改查 + 导出
      },
      otherFunctions:function(){
          return {}//其他的自定义方法
      }
    };
    
    var add={ 
    	formFields:function(){//表单内容
    	     return [
                 {name:'park_id',type:'select',url:'${path.basePath}/ms/x/parking/findListData',
                     valuefield:'id',textfield:'parkName',title:'停车场',required:true,},//一个下拉
                 {name:'lease_name',title:'名称',required:true,type:'input'},//一个input
                 {name:'is_disable',title:'是否禁用',type:'switch',dft:false},//一个开关滑块
                 {name:'is_sync',title:'是否下发',type:'hide'},//一个隐藏域
    		 ];
    	},
        otherFunctions:function(){
          return {
    	     ready:function(){
    	    },
    	    loadSuccess:function(info){//加载后台数据成功的事件
    
    	    },
    	    onSave:function(){//保存前执行方法
                $('#isSync').val(0);
    	    },
    		saveSucess:function(){//保存成功执行方法
    	    },
    		saveError:function(){//保存失败执行的方法
    		    
    	    },
    	  }		
       }
    }