开源框架：JFinal框架

傷城~ 2022-06-06 04:11 378阅读 0赞

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

JFinal 有如下主要特点：  
  MVC 架构，设计精巧，使用简单  
  遵循 COC 原则，零配置，无 xml  
  独创 Db + Record 模式，灵活便利  
  ActiveRecord 支持，使数据库开发极致快速  
  自动加载修改后的 java 文件，开发过程中无需重启 web server  
  AOP 支持，拦截器配置灵活，功能强大  
  Plugin 体系结构，扩展性强  
  多视图支持，支持 FreeMarker、JSP、Velocity  
  强大的 Validator 后端校验功能  
  功能齐全，拥有 struts2 绝大部分核心功能  
  体积小仅 218K，且无第三方依赖

官方推荐用Eclipse IDE for Java EE Developers 做为开发环境，但我个人用惯了myecllipse+tomact

Eclipse IDE for Java EE Developers 中

1、创建 Dynamic Web Project

2、修改 Default Output Folder，推荐输入 WebRoot\\WEB-INF\\classes

![18004917-83d6f0a6ca294e399078425bd2e82d9e.png][]

特别注意：此处的  Default out folder 必须要与  WebRoot\\WEB-INF\\classes  目录  
完全一致才可以使用  JFinal  集成的  Jetty  来启动项目。

3、修改 Content directory，推荐输入 WebRoot

![18005141-15480cb165724f0299269b5a07900418.png][]

注 意 ： 此 处 也 可 以 使 用 默 认 值 WebContent ，   但 上 一 步 中 的  
WebRoot\\WEB-INF\\classes 则需要改成 WebContent\\WEB-INF\\classes 才能对应上。

4、去官网下载最新的jar包(我这是JFinal-lib-1.4)

![18005421-09677ae1f4004a688e70bdf7c050fd9e.png][]

把jetty-server-8.1.8.jar 和JFinal-bin-1.4.jar放到项目 WEB-INF\\lib下，jetty-server-8.1.8.jar是开发时使用的运行环境，用tomact和生产环境下就不需要了

5、添加到web.xml

![复制代码][copycode.gif]

<filter>
    <filter-name>jfinal</filter-name>
    <filter-class>com.jfinal.core.JFinalFilter</filter-class>
    <init-param>
    <param-name>configClass</param-name>
    <param-value>demo.DemoConfig</param-value>
    </init-param>
    </filter>
    <filter-mapping>
    <filter-name>jfinal</filter-name>
    <url-pattern>/*</url-pattern>
    </filter-mapping>

![复制代码][copycode.gif]

6、在项目 src 目录下创建 demo 包，并在 demo 包下创建 DemoConfig 文件，   内容如下：

![复制代码][copycode.gif]

package demo; import com.jfinal.config.*; public class DemoConfig extends JFinalConfig { public void configConstant(Constants me) { me.setDevMode(true); } public void configRoute(Routes me) { me.add("/hello", HelloController.class); } public void configPlugin(Plugins me) {} public void configInterceptor(Interceptors me) {} public void configHandler(Handlers me) {} }

![复制代码][copycode.gif]

注意：DemoConfig.java 文件所在的包以及自身文件名必须与 web.xml 中的param-value 标签内的配置相一致(在本例中该配置为 demo.DemoConfig)。

在 demo 包下创建 HelloController 类文件，  内容如下：

![复制代码][copycode.gif]

package demo; import com.jfinal.core.Controller; public class HelloController extends Controller { public void index() { renderText("Hello JFinal World."); } }

![复制代码][copycode.gif]

6、右击项目名![18010136-f89176e3aa324e78bbea09dc088338f3.png][]选中com.jfinal.core.JFinal  ok  
7、浏览器输入[http://localhost/hello][http_localhost_hello]输出内容为 Hello JFinal World 证明项目框架搭建完成。

注意：在 tomcat 下开发或运行项目时，需要先删除  jetty-server-xxx.jar 这个包，否则会引起冲突。

(抄袭官网api，罪过罪过....)

jfinal真的挺简单，迅速，强大的一个框架，没有ssh的N多xml配置文件，后面做个简单的学生信息管理，配合FreeMarker

上一节介绍了jfinal框架的简单搭建，这节通过一个小例子了解jfinal的结构和特点

先上图![18232713-bb3d81d28c764bf59b39b8ac068ed070.png][]![18232734-2fd7ed6c5d3b4d9d91e0e81abc442561.png][]![18232757-63bf47ab36ab4a9b97954907b04f67c7.png][]

1、建数据库(我用的是oracle数据库，其他的相对也差不多)

![复制代码][copycode.gif]

-- Create table
    create table CLASSES ( classesid NUMBER not null, classesname VARCHAR2(20), classesaddress VARCHAR2(50) ); -- Create table
    create table STUDENT ( studentid NUMBER not null, studentname VARCHAR2(10), studentage NUMBER, studentsex VARCHAR2(2), classesid NUMBER ); alter table STUDENT add constraint FK_CLASSESID foreign key (CLASSESID) references CLASSES (CLASSESID);

![复制代码][copycode.gif]

新建项目，我用的myeclipse，先把jar包导入

![18235009-ac36baea9ea94741bad7640a4f22d47b.png][]

2、实体类  
Classes.java

![复制代码][copycode.gif]

package com.demo.model; import com.jfinal.plugin.activerecord.Model; public class Classes extends Model<Classes> { public static final Classes dao = new Classes(); }

![复制代码][copycode.gif]

Student.java

![复制代码][copycode.gif]

package com.demo.model; import com.jfinal.plugin.activerecord.Model; public class Student extends Model<Student> { public static final Student dao = new Student(); public Classes getClasses() { return Classes.dao.findById(get("classesid")); } }

![复制代码][copycode.gif]

什么这是实体类？没错！！~ ActiveRecord 是 jfinal 最核心的组成部分之一，通过 ActiveRecord 来操作数据库，将极大地减少代码量，极大地提升开发效率,配置在后面，我这里用的是Model，Model 是 ActiveRecord 中最重要的组件之一，它充当 MVC 模式中的 Model部分。  
以上代码中的 User 通过继承 Model，便立即拥有的众多方便的操作数据库的方法。在 User 中声明的 dao 静态对象是为了方便查询操作而定义的，该对象并不是必须的。 基于ActiveRecord 的 Model 无需定义属性， 无需定义 getter、 setter方法，无需 XML 配置，无需 Annotation 配置，极大降低了代码量。Model常见方法见官方API。

JFinal还有 独创 Db + Record 模式，Db 类及其配套的 Record 类， 提供了在 Model 类之外更为丰富的数据库操作功能。使用 Db 与 Record 类时，无需对数据库表进行映射，Record 相当于一个通用的 Model。Db常见方法见官方API。

3、DemoConfig.java

![复制代码][copycode.gif]

package com.demo.config; import com.demo.controller.ClassesController; import com.demo.controller.StudentController; import com.demo.model.Classes; import com.demo.model.Student; import com.jfinal.config.Constants; import com.jfinal.config.Handlers; import com.jfinal.config.Interceptors; import com.jfinal.config.JFinalConfig; import com.jfinal.config.Plugins; import com.jfinal.config.Routes; import com.jfinal.plugin.activerecord.ActiveRecordPlugin; import com.jfinal.plugin.activerecord.CaseInsensitiveContainerFactory; import com.jfinal.plugin.activerecord.dialect.OracleDialect; import com.jfinal.plugin.c3p0.C3p0Plugin; public class DemoConfig extends JFinalConfig { @Override public void configConstant(Constants me) { } @Override public void configHandler(Handlers me) { // TODO Auto-generated method stub
     } @Override public void configInterceptor(Interceptors me) { // TODO Auto-generated method stub
     } @Override public void configPlugin(Plugins me) { C3p0Plugin cp = new C3p0Plugin("jdbc:oracle:thin:@localhost:1521:orcl", "test", "test"); // 配置Oracle驱动
            cp.setDriverClass("oracle.jdbc.driver.OracleDriver"); me.add(cp); ActiveRecordPlugin arp = new ActiveRecordPlugin(cp); me.add(arp); // 配置Oracle方言
            arp.setDialect(new OracleDialect()); // 配置属性名(字段名)大小写不敏感容器工厂
            arp.setContainerFactory(new CaseInsensitiveContainerFactory()); arp.addMapping("student", "studentid", Student.class); arp.addMapping("classes", "classesid", Classes.class); } @Override public void configRoute(Routes me) { me.add("/", StudentController.class); me.add("/student", StudentController.class); me.add("/classes", ClassesController.class); } }

![复制代码][copycode.gif]

我这里是oracle数据库的配置，oracle有些特别的地方，如表列名会自动转成大写，配置个免大小写的工厂，方便开发等。这里要注意url,驱动，方言，在给个mysql数据库的配置对比下

![复制代码][copycode.gif]

public class DemoConfig extends JFinalConfig { public void configPlugin(Plugins me) { C3p0Plugin cp =  new  C3p0Plugin("jdbc:mysql://localhost/db_name", "userName", "password"); me.add(cp); ActiveRecordPlugin arp = new ActiveRecordPlugin(cp); me.add(arp); arp.addMapping("user", User.class); arp.addMapping("article", "article_id", Article.class); } }

![复制代码][copycode.gif]

4、StudentController.java

![复制代码][copycode.gif]

package com.demo.controller; import java.util.List; import com.demo.interceptor.StudentInterceptor; import com.demo.model.Student; import com.demo.validator.StudentValidator; import com.jfinal.aop.Before; import com.jfinal.core.Controller; public class StudentController extends Controller { @Before(StudentInterceptor.class) public void index() { List<Student> list = Student.dao.find("select * from student"); setAttr("studentList", list); render("/index.html"); } public void add() { render("/add.html"); } public void delete() { // 获取表单域名为studentID的值 // Student.dao.deleteById(getPara("studentID")); // 获取url请求中第一个值
     Student.dao.deleteById(getParaToInt()); forwardAction("/student"); } public void update() { Student student = getModel(Student.class); student.update(); forwardAction("/student"); } public void get() { Student student = Student.dao.findById(getParaToInt()); setAttr("student", student); render("/index2.html"); } @Before(StudentValidator.class) public void save() { Student student = getModel(Student.class); student.set("studentid", "mysequence.nextval").save(); forwardAction("/student"); } }

![复制代码][copycode.gif]

获取studentid那里有多种方法，这个要和前台传参写法一致，Controller 提供了 getPara 系列方法,官网api里很详细

jfinal用的是原生态sql语句，简单，方便，setAttr("studentList", list);把结果集放到request范围里，

jfinal也有直接获取表单里分装成对象的方法 getModel(Student.class);就是，和struts2一样，表单name对应上就可以了，非常方便

添加那里对于oracle用序列维护studentid      student.set("studentid", "mysequence.nextval").save(); jfinal有多种返回方式，也可以返回json数据，render 系列方法,官网api里很详细

5、interceptor和validator(可以不加)

StudentInterceptor.java

![复制代码][copycode.gif]

package com.demo.interceptor; import com.jfinal.aop.Interceptor; import com.jfinal.core.ActionInvocation; public class StudentInterceptor implements Interceptor { public void intercept(ActionInvocation ai) { System.out.println("Before action invoking"); ai.invoke(); System.out.println("After action invoking"); } }

![复制代码][copycode.gif]

StudentValidator.java

![复制代码][copycode.gif]

package com.demo.validator; import com.jfinal.core.Controller; import com.jfinal.validate.Validator; public class StudentValidator extends Validator { //在校验失败时才会调用
     @Override protected void handleError(Controller controller) { controller.keepPara("student.studentname");//将提交的值再传回页面以便保持原先输入的值
            controller.render("/add.html"); } @Override protected void validate(Controller controller) { //验证表单域name，返回信息key,返回信息value
            validateRequiredString("student.studentname", "studentnameMsg", "请输入学生名称!"); } }

![复制代码][copycode.gif]

6、页面

我这里用的是FreeMarker模板引擎  
index.html

![复制代码][copycode.gif]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    <html>
        <head>
            <title>index.html</title>
    
            <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
            <meta http-equiv="description" content="this is my page">
            <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    
            
    
        </head>
    
        <body>
            <a href="/student/add">添加</a>
            <table border="1">
                <tr>
                    <td> 姓名 </td>
                    <td> 年龄 </td>
                    <td> 性别 </td>
                    <td> 班级 </td>
                    <td> 操作 </td>
                </tr>
                <#list studentList as student>
                <tr>
                    <td> ${student.studentname} </td>
                    <td> ${student.studentage} </td>
                    <td> ${student.studentsex} </td>
                    <td> ${student.getClasses().classesname} </td>
                    <td>
                        <a href="/student/delete/${student.studentid}">删除</a>
                        <a href="/student/get/${student.studentid}">修改</a>
                    </td>
                </tr>
                </#list>
    
            </table>
        </body>
    </html>

![复制代码][copycode.gif]

index2.html

![复制代码][copycode.gif]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    <html>
        <head>
            <title>index2.html</title>
    
            <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
            <meta http-equiv="description" content="this is my page">
            <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    
            
    
        </head>
    
        <body>
            <form action="/student/update" method="post">
                <input type="text" name="student.studentid" value="${student.studentid}"/> 姓名： <input type="text" name="student.studentname" value="${student.studentname}"/>
                <br /> 年龄： <input type="text" name="student.studentage" value="${student.studentage}"/>
                <br /> 性别： <input type="text" name="student.studentsex" value="${student.studentsex}"/>
                <br /> 班级： <input type="text" name="student.classesid" value="${student.classesid}" />
                <br />
                <input type="submit" value="保存" />
            </form>
    
        </body>
    </html>

![复制代码][copycode.gif]

add.html

![复制代码][copycode.gif]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
    <html>
        <head>
            <title>add.html</title>
    
            <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
            <meta http-equiv="description" content="this is my page">
            <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    
            
    
        </head>
    
        <body>
            <form action="/student/save" method="post"> 姓名： <input type="text" name="student.studentname" />${studentnameMsg!}${studentnameLMsg!} <br /> 年龄： <input type="text" name="student.studentage" />
                <br /> 性别： <input type="text" name="student.studentsex" />
                <br /> 班级： <input type="text" name="student.classesid" />
                <br />
                <input type="submit" value="保存" />
            </form>
        </body>
    </html>

![复制代码][copycode.gif]

完成！ 浏览器输入[http://localhost/][http_localhost]

总结一下：

转载网址：[http://blog.csdn.net/samjustin1/article/details/52220649][http_blog.csdn.net_samjustin1_article_details_52220649]

[18004917-83d6f0a6ca294e399078425bd2e82d9e.png]: /images/20220606/a4628fbb0afc4e15b46323c4dc18929f.png
[18005141-15480cb165724f0299269b5a07900418.png]: /images/20220606/bed8d0695633424395d50ffdb4d61b20.png
[18005421-09677ae1f4004a688e70bdf7c050fd9e.png]: /images/20220606/cda4c84084424d4f8c8a281274fb6409.png
[copycode.gif]: /images/20220606/f75c312578fa4bb59441c9207df29932.png
[18010136-f89176e3aa324e78bbea09dc088338f3.png]: /images/20220606/2d2b469697f74744902abe19ffe9f382.png
[http_localhost_hello]: http://localhost/hello
[18232713-bb3d81d28c764bf59b39b8ac068ed070.png]: http://images.cnitblog.com/blog/484899/201308/18232713-bb3d81d28c764bf59b39b8ac068ed070.png
[18232734-2fd7ed6c5d3b4d9d91e0e81abc442561.png]: http://images.cnitblog.com/blog/484899/201308/18232734-2fd7ed6c5d3b4d9d91e0e81abc442561.png
[18232757-63bf47ab36ab4a9b97954907b04f67c7.png]: /images/20220606/8d000a0d42bd4207ba0ee345e34a8f63.png
[18235009-ac36baea9ea94741bad7640a4f22d47b.png]: /images/20220606/95a12f587cf8451b88bda9907bec2409.png
[http_localhost]: http://localhost/
[http_blog.csdn.net_samjustin1_article_details_52220649]: http://blog.csdn.net/samjustin1/article/details/52220649