README.md · forcking/SoJpt Boot

# [SoJpt Boot](http://www.sojpt.com/)

#### 介绍

![sojpt-logo](https://images.gitee.com/uploads/images/2019/0413/225742_5630cd4e_415067.png)

#### 官方网站: www.sojpt.com

在[**Spring Boot**](http://www.sojpt.com/)框架下使用Jfinal特性极速开发

可以在**Spring Boot**中向使用Jfinal一样使用Enjoy, Aop, controller的一系列方法(如: getFile(), renderFile....),以及ActiveRecord, 只有Jfinal的路由被去掉,其他Jfinal特性可以原生使用

**SoJpt-Boot-2.3-3.8 changelog**

1.加入事务注解,@Tx(value="configName", level=2)
        value 数据源名称 ,默认为当前数据源
        level 数据库事务等级配置, 默认为ActiveRecord配置的事务等级
    2.优化代码,可使用  sojpt-boot-spring-boot-starter 自动配置
        <dependency>
          <groupId>com.sojpt</groupId>
          <artifactId>sojpt-boot-spring-boot-starter</artifactId>
          <version>2.2-3.8</version>
        </dependency>
    
**SoJpt-Boot-2.2-3.8 changelog**

1.修复 jfinal handler 配置失效问题, 发布2.2-3.8, 建议升级新版

**SoJpt-Boot-2.1-3.8 changelog**

1.修复 配置 server.servlet.context-path 时配置报空指针的异常。

2.修复 使用Validator时 不能返回请求的bug

**SoJpt-Boot-2.0-3.8 changelog**

1. 配置方式，还原Jfinal原生配置,继承SoJptBootConfig即可。
2. 解决undertow并发环境下报异常的问题
3. 加入Aop、configConstant配置、configPlugin配置、configInterceptor全局拦截器配置、configHandler、configEngine、afterJFinalStart等一系列Jfinal原生配置模式。
4. 取消Tx注解、使用原生@Before(Tx.class)即可
5. 取消Jfinal原生包的引入，直接引入sojpt-boot依赖即可
6. 取消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的极速开发特性，有更多的时间去配恋人或家人。

#### 安装教程

1. 在Spring Boot 2.0以上项目中 加入maven坐标
```xml
    <dependency>
      <groupId>com.gitee.sohnny</groupId>
      <artifactId>sojpt-boot</artifactId>
      <version>2.2-3.8</version>
    </dependency>
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>druid</artifactId>
      <version>1.1.16</version>
    </dependency>
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjweaver</artifactId>
    </dependency>
```
2. 添加 SoJptBootConfig 配置类
```java
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;
	}

}

```

3. 在 application.properties 配置文件中添加如下
```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
```
3. 在spring启动类中添加注解 @ComponentScan("com.sojpt"), 如下:
```java
@ComponentScan("com.sojpt") //添加你定义的包名称
@SpringBootApplication
public class SoJptSpringbootApplication {

public static void main(String[] args) {
		SpringApplication.run(SoJptSpringbootApplication.class, args);
	}

}
```
#### 使用说明

1. 案例一 返回json
```java
@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);
    }
    
}
```
2. 案例二 文件下载
```java
@RestController
public class HelloPageController extends Controller {
    
    @Clear
    @RequestMapping("/file")
    public void index() {
		
		setAttr("msg", "123123");
		renderFile(new File("d://test.txt"));
    }
    
}
```
3. 案例三 返回页面
```java
@Controller
public class HelloPageController extends Controller {

@Before(LoginInterceptor.class)
    @RequestMapping("/page/jfinal")
    public void index() {
		
		setAttr("msg", "123123");

render("/view/index.html") //放在resources目录下
    }
    
}
```

#### 参与贡献

## [www.sojpt.com](http://www.sojpt.com/)

### 💖💖 If you find this project helpful, maybe you can buy me a coffee. 💖💖

forcking/SoJpt Boot

简介

发行版

贡献者

近期动态

forcking/SoJpt Boot .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

forcking/SoJpt Boot