1.1 概要

1、文档说明

       社区文档频道将提供全面、权威、最新的开发文档，文档内容将随着项目发展、用户反饭不断进化、更新，建议以在线的形式查阅，保障始终获取到的信息是最新最权威的，文档将在后续更新。

项目后端基于jfinal，前端基于layui，为了更好使用JFinal-layui项目，需要掌握这两个框架的基础知识：

JFinal文档：https://jfinal.com/doc

layui文档：https://layui.dev/

2、常见问题

1、如果是修改了项目的com.qinhailin为其他的名称，package不再是com开头，如：cn.xxxx，那么需要设置一下路由扫描器的packageName：

master-开源版修改：

        /**
	 * 配置JFinal路由映射
	 */
	@Override
	public void configRoute(Routes me) {
		// 配置ControllerBind注解路由
		AutoBindRoutes autoBindRoutes = new AutoBindRoutes();
		autoBindRoutes.includeAllJarsInLib(true);
		//修改了项目主要的包名，就要设置这里
		autoBindRoutes.setPackageName("cn");
		autoBindRoutes.setBaseViewPath(WebContant.baseViewPath);
		me.add(autoBindRoutes);
	}

2、注解路由的controller类要以controller结尾。

pro-专业版修改：路由扫描和model扫描修改，默认是扫描com.qinhailin目录下的类

v2.4之后的版本可以直接在配置文件config-dev.txt添加配置项：scanPackageName=cn.xxxx ，然后再修改第3点即可

1、com.qinhailin.common.config.MainConfig.java:

 /**
	 * 配置JFinal路由映射
	 */
	@Override
	public void configRoute(Routes me) {
		me.scan("cn.xxxx");
		me.setBaseViewPath(WebContant.baseViewPath);
	}

2、com.qinhailin.common.model._MappingKit.java的扫描目录：

        /**
	 * 注解配置model
	 * @param arp
	 * @author qinhailin
	 * @date 2020-08-18
	 */
	public static void annotationTable(ActiveRecordPlugin arp){
		TableScanner tableScanner=new TableScanner("cn.xxxx",arp);
		tableScanner.scan();
	}

3、报表的数据源配置类修改：WEB-INF/applicationContext.xml

<!-- 配置内置数据源 -->
<bean id="mainDataSource" class="com.qinhailin.common.ureport.Ureport2BuildinDatasource"></bean>

修改了主包名之后，切记还要修改启动脚本的启动类入口：jfinal.bat，jfinal.sh

rem 启动入口类,该脚本文件用于别的项目时要改这里
set MAIN_CLASS=com.qinhailin.common.config.MainConfig