SoJpt Boot
介绍
在Spring Boot框架下使用Jfinal特性极速开发
可以在Spring Boot中向使用Jfinal一样使用Enjoy, Aop, controller的一系列方法(如: getFile(), renderFile....),以及ActiveRecord, 只有Jfinal的路由被去掉,其他Jfinal特性可以原生使用
SoJpt-Boot-2.0-3.8 changelog
-
配置方式,还原Jfinal原生配置,继承SoJptBootConfig即可。
-
解决undertow并发环境下报异常的问题
-
加入Aop、configConstant配置、configPlugin配置、configInterceptor全局拦截器配置、configHandler、configEngine、afterJFinalStart等一系列Jfinal原生配置模式。
-
取消Tx注解、使用原生@Before(Tx.class)即可
-
取消Jfinal原生包的引入,直接引入sojpt-boot依赖即可
-
取消SoJptController, 继承Jfinal的Controller即可
总之,这次2.0版本,直接引入Jfinal3.8的源代码,修改了其中几行,即实现了Spring Boot与Jfinal的混合双打,使Spring Boot环境下的开发者能够更好的体验Jfinal极速开发的特性,有更多的时间去配恋人或家人。 只要Jfinal有新版发布,SoJpt Boot会直接同步更新,因只修改几行代码,所以不用担心升级的复杂度。
软件架构
基于 JFinal 与 Spring Boot制作, 实现Spring Boot与Jfinal的混合双打,使Spring Boot下的开发者能够体验Jfinal的极速开发特性,有更多的时间去配恋人或家人。
安装教程
- 在Spring Boot 2.0以上项目中 加入maven坐标
<dependency>
<groupId>com.gitee.sohnny</groupId>
<artifactId>sojpt-boot</artifactId>
<version>2.0-3.8</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.0.5</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
</dependency>
复制代码
- 添加 SoJptBootConfig 配置类
package com.sojpt.boot;
import java.sql.Connection;
import javax.servlet.ServletException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.alibaba.druid.filter.stat.StatFilter;
import com.alibaba.druid.wall.WallFilter;
import com.jfinal.config.Constants;
import com.jfinal.config.Handlers;
import com.jfinal.config.Interceptors;
import com.jfinal.config.Plugins;
import com.jfinal.core.JFinal;
import com.jfinal.plugin.activerecord.ActiveRecordPlugin;
import com.jfinal.plugin.activerecord.dialect.MysqlDialect;
import com.jfinal.plugin.druid.DruidPlugin;
import com.jfinal.template.Engine;
import com.jfinal.template.ext.spring.JFinalViewResolver;
import com.jfinal.template.source.ClassPathSourceFactory;
import com.sojpt.model._MappingKit;
@Configuration(value = "SoJptBootConfig")
@EnableConfigurationProperties(ActiveRecordPluginProperties.class)
public class SoJptBootConfig extends SoJptConfig {
@Autowired
private ActiveRecordPluginProperties arpProperties;
/**
* 配置JFinal常量
*/
@Override
public void configConstant(Constants me) {
// 设置当前是否为开发模式
me.setDevMode(arpProperties.getIsDevMode());
// me.setError404View("/index.html");
}
/**
* 配置JFinal插件 数据库连接池 ORM 缓存等插件 自定义插件
*/
@Override
public void configPlugin(Plugins me) {
DruidPlugin dp = new DruidPlugin(arpProperties.getJdbcUrl(), arpProperties.getUsername(), arpProperties.getPassword());
dp.addFilter(new StatFilter());
dp.setDriverClass("com.mysql.cj.jdbc.Driver");
WallFilter wall = new WallFilter();
dp.addFilter(wall);
me.add(dp);
ActiveRecordPlugin arp = new ActiveRecordPlugin(dp);
arp.setTransactionLevel(Connection.TRANSACTION_READ_COMMITTED);
arp.setShowSql(arpProperties.getIsDevMode());
arp.setDialect(new MysqlDialect());
// ******** 在此添加dao层sql文件 *********//*
//arp.addSqlTemplate("sql/all_sqls.sql");
_MappingKit.mapping(arp);
// 初始化任务调度插件,参数为配置文件名
// me.add(new Cron4jPlugin(sysProp));
me.add(arp);
}
/**
* 配置全局拦截器
*/
@Override
public void configInterceptor(Interceptors me) {
// me.addGlobalActionInterceptor(new DuplicateLoginInterceptor());
}
/**
* 配置全局处理器
*/
@Override
public void configHandler(Handlers me) {
// druid 统计页面功能
//me.add(DruidKit.getDruidStatViewHandler());
//me.add(new JavaMelodyHandler("/monitoring.*", true));
}
@Override
public void beforeJFinalStop() {
}
/**
*
* 配置模板引擎
*/
@Override
public void configEngine(Engine me) {
// 这里只有选择JFinal TPL的时候才用
me.addSharedObject("RESOURCE_HOST", JFinal.me().getContextPath());
me.addSharedObject("WEB_HOST", JFinal.me().getContextPath());
// 配置共享函数模板
// me.addSharedFunction("/view/common/layout.html")
}
@Override
public void afterJFinalStart() {
System.err.println("SoJpt Boot 启动成功!");
}
/**
*
* 此内部类可选, (默认不建议开启,注释掉即可)
* 其作用就是在SpringBoot中可以直接 return"/view/index.html",
* 如果习惯render("/view/index.html")用法,可注释此方法
*
* @return
* @throws ServletException
*/
@Bean(name = "jfinalViewResolver")
public JFinalViewResolver getJFinalViewResolver() throws ServletException {
JFinalViewResolver jfr = new JFinalViewResolver();
// setDevMode 配置放在最前面
jfr.setDevMode(true);
// 使用 ClassPathSourceFactory 从 class path 与 jar 包中加载模板文件
jfr.setSourceFactory(new ClassPathSourceFactory());
jfr.setSuffix(".html");
jfr.setContentType("text/html;charset=UTF-8");
jfr.setOrder(0);
// jfr.addSharedFunction("/view/common/_layout.html");
// jfr.addSharedFunction("/view/common/_paginate.html");
// init("com.sojpt.boot.MainConfig");
return jfr;
}
}
复制代码
- 在 application.properties 配置文件中添加如下
arp.jdbc-url = jdbc:mysql://127.0.0.1/sojpt?characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false
arp.username = root
arp.password = 123456
arp.is-dev-mode= true
复制代码
- 在spring启动类中添加注解 @ComponentScan("com.sojpt"), 如下:
@ComponentScan("com.sojpt") //添加你定义的包名称
@SpringBootApplication
public class SoJptSpringbootApplication {
public static void main(String[] args) {
SpringApplication.run(SoJptSpringbootApplication.class, args);
}
}
复制代码
使用说明
- 案例一 返回json
@RestController
public class HelloController extends Controller { //不继承Controller,就是原生的Spring Boot,Jfinal的Aop也就不能用
@Before(Tx.class) //事务的用法
@RequestMapping("/list/jfinal")
public void index() {
System.out.println(getPara("id")); //获取参数示例
SqlPara sqlPara = Db.getSqlPara("admin_log.select");
Page<Record> page = Db.paginate(1, 10, sqlPara);
renderJson(page);
}
}
复制代码
- 案例二 文件下载
@RestController
public class HelloPageController extends Controller {
@Clear
@RequestMapping("/file")
public void index() {
setAttr("msg", "123123");
renderFile(new File("d://test.txt"));
}
}
复制代码
- 案例三 返回页面
@Controller
public class HelloPageController extends Controller {
@Before(LoginInterceptor.class)
@RequestMapping("/page/jfinal")
public void index() {
setAttr("msg", "123123");
render("/view/index.html") //放在resources目录下
}
}
复制代码