# JFinal

**Repository Path**: cnoldtree/jfinal

## Basic Information

- **Project Name**: JFinal
- **Description**: JFinal 是基于 Java 语言的极速 WEB + ORM 框架，其核心设计目标是开发迅速、代码量少、学习简单、功能强大、轻量级、易扩展、Restful。在拥有Java语言所有优势的同时再拥有ruby、python、php等动态语言的开发效率！为您节约更多时间，去陪恋人、家人和朋友 :)
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://jfinal.com/user/1
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3616
- **Created**: 2026-05-26
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## JAVA 极速WEB+ORM框架 JFinal
[中文](README.md) [English](README_en.md)

JFinal 是基于 Java 语言的极速 WEB + ORM 框架，其核心设计目标是开发迅速、代码量少、学习简单、功能强大、轻量级、易扩展、Restful。在拥有Java语言所有优势的同时再拥有 ruby、python 等动态语言的开发效率！为您节约更多时间，去陪恋人、家人和朋友 ;)

#### JFinal有如下主要特点
- MVC 架构，设计精巧，使用简单
- 遵循 COC 原则，支持零配置，无 XML
- 独创 Db + Record 模式，灵活便利
- ActiveRecord 支持，使数据库开发极致快速
- 极简、强大、高性能模板引擎 Enjoy，十分钟内掌握 90% 用法
- 自动加载修改后的 Java 文件，开发过程中无需重启服务
- AOP支持，拦截器配置灵活，功能强大
- Plugin 体系结构，扩展性强
- 多视图支持，支持 Enjoy、FreeMarker、JSP
- 强大的 Validator 后端校验功能
- 功能齐全，拥有传统 SSH 框架的绝大部分核心功能
- 体积小仅 832 KB，并且无第三方依赖

**JFinal 极速开发微信公众号欢迎你的加入: JFinal**

## Maven 坐标

```xml
<dependency>
    <groupId>com.jfinal</groupId>
    <artifactId>jfinal</artifactId>
    <version>6.0.0</version>
</dependency>
```

## JDK 版本要求

- **最低支持**: JDK 8
- **推荐使用**: JDK 17 LTS
- **完全兼容**: JDK 21 LTS

## JDK 17+ 必需的 JVM 参数

```bash
java --add-opens java.base/java.lang=ALL-UNNAMED \
     --add-opens java.base/java.lang.reflect=ALL-UNNAMED \
     --add-opens java.base/java.util=ALL-UNNAMED \
     -jar your-app.jar
```

## 推荐配置

```java
public void configConstant(Constants me) {
    me.setDevMode(true);
    me.setProxyFactory(new JavassistProxyFactory());  // 使用 Javassist 代理
    me.setJsonFactory(new JacksonFactory());          // 使用 Jackson JSON（已移除 fastjson）
    me.setLogFactory(new Slf4jLogFactory());          // 使用 Slf4j 日志
}
```

## 核心更新说明

### 6.0.0 版本重大变更

| 变更类型 | 说明 |
|---------|------|
| **JSON 处理** | 移除 fastjson 依赖，全面迁移到 Jackson |
| **日期类型** | 使用 `java.time.LocalDateTime` / `LocalDate`，替代 `java.util.Date` |
| **JDK 版本** | 推荐使用 JDK 17 LTS，兼容 JDK 8/11/21 |
| **安全升级** | 升级 Jackson 到 2.16.1，修复反序列化漏洞 |
| **安全加固** | HttpKit 默认启用 SSL 证书校验；ActionHandler 生产环境不在日志输出 Query String；ErrorRender 生产环境隐藏版本号；HashKit 切换为 SecureRandom |
| **性能优化** | 优化类型转换、参数获取器等核心模块性能 |

## 以下是JFinal实现Blog管理的示例：

**1. 控制器(支持 Enjoy、JSP、JSON等等以及自定义视图渲染)**

```java
@Before(BlogInterceptor.class)
public class BlogController extends Controller {

    @Inject
    BlogService service;

    public void index() {
        set("blogPage", service.paginate(getInt(0, 1), 10));
        render("blog.html");
    }

    public void add() {
    }

    @Before(BlogValidator.class)
    public void save() {
        getModel(Blog.class).save();
        redirect("/blog");
    }

    public void edit() {
        set("blog", service.findById(getInt()));
    }

    @Before(BlogValidator.class)
    public void update() {
        getModel(Blog.class).update();
        redirect("/blog");
    }

    public void delete() {
        service.deleteById(getInt());
        redirect("/blog");
    }
}
```

**2.Service所有业务与sql全部放在Service层**

```java
public class BlogService {

    private Blog dao = new Blog().dao();
    
    public Page<Blog> paginate(int pageNumber, int pageSize) {
        return dao.paginate(pageNumber, pageSize, "select *", "from blog order by id asc");
    }
    
    public Blog findById(int id) {
        return dao.findById(id);
    }
    
    public void deleteById(int id) {
        dao.deleteById(id);
    }
}
```

**3.Model(无xml、无annotaion、无attribute)**

```java
public class Blog extends Model<Blog> {
    
}
```

**4.Validator(API引导式校验，比xml校验方便N倍，有代码检查不易出错)**

```java
public class BlogValidator extends Validator {
    protected void validate(Controller controller) {
        validateRequiredString("blog.title", "titleMsg", "请输入Blog标题!");
        validateRequiredString("blog.content", "contentMsg", "请输入Blog内容!");
    }

    protected void handleError(Controller controller) {
        controller.keepModel(Blog.class);
    }
}
```

**5.拦截器(在此demo中仅为示例，本demo不需要此拦截器)**

```java
public class BlogInterceptor implements Interceptor {
    public void intercept(Invocation inv) {
        System.out.println("Before invoking " + inv.getActionKey());
        inv.invoke();
        System.out.println("After invoking " + inv.getActionKey());
    }
}
```

## 更多支持
- JFinal 官方网站  [https://jfinal.com](https://jfinal.com/) 
- 扫码关注官方微信公众号，第一时间尊享最新动向  

![JFinal](https://jfinal.com/assets/img/jfinal_weixin_service_qr_code_150.jpg) 

## 构建命令

```bash
mvn test                           # 运行所有测试
mvn package -DskipTests            # 不执行测试，但编译测试代码
mvn package -Dmaven.test.skip=true # 完全不编译、不执行测试
mvn clean package                  # 清理并打包
mvn clean package -DskipTests      # 清理并打包（跳过测试）
```

## 文档资源

| 文档 | 说明 |
|------|------|
| `USAGE_GUIDE.md` | 使用指南 |
| `SOURCE_GUIDE.md` | 源码阅读指南 |
| `TEST_BASIS.md` | 测试依据文档 |
| `TEST_CASES.md` | 测试用例方案 |
| `JFINAL_FRAMEWORK_DOC.md` | 框架架构文档 |
| `PERFORMANCE_REPORT.md` | 性能测试报告 |