JFinal教程2

1. JFinal簡介

JFinal 是基于 Java 語言的極速 WEB + ORM 框架，其核心設計目標是開發迅速、代碼量少、學習簡單、功能強大、輕量級、易擴展、Restful。在擁有Java語言所有優勢的同時再擁有ruby、python、php等動態語言的開發效率！為您節約更多時間，去陪戀人、家人和朋友 :)

JFinal 官方網站：http://www.jfinal.com

JFinal有如下主要特點：

MVC架構，設計精巧，使用簡單
遵循COC原則，零配置，無xml
獨創Db + Record模式，靈活便利
ActiveRecord支持，使數據庫開發極致快速
自動加載修改后的java文件，開發過程中無需重啟web server
AOP支持，攔截器配置靈活，功能強大
Plugin體系結構，擴展性強
多視圖支持，支持FreeMarker、JSP、Velocity
強大的Validator后端校驗功能
功能齊全，擁有struts2的絕大部分功能
體積小僅218K，且無第三方依賴

截至筆者撰寫此文時，JFinal已經發布到了1.6版本。

2. 小白的第一個JFinal程序

為了使小白能夠完全的按步驟創建第一個JFinal應用并運行，筆者將以Java界最流行的Eclipse平臺為例，搭建出所有基礎教程中喜歡的Hello world應用。

2.1. Eclipse平臺搭建

2.1.1. 下載Eclipse

搭建Web應用，首選Eclipse JEE版本，請到圖所示的地址下載相應版本。

至于JDK的安裝，這里就不再說明了，本文面向的是JFinal小白，而不是李太白^_^。

解壓并運行Eclipse，你將看到下面的畫面：

如果彈出下面的畫面（多在內存小或Windows XP中出現），則需要修改eclipse.ini中的參數：

修改如下參數即可，如果還是不行，請查詢百度：.

-startup

plugins/org.eclipse.equinox.launcher_1.3.0.v20130327-1440.jar

--launcher.library

plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.200.v20140116-2212

-product

org.eclipse.epp.package.jee.product

--launcher.defaultAction

openFile

--launcher.XXMaxPermSize

256M -- 改為192或更小

-showsplash

org.eclipse.platform

--launcher.XXMaxPermSize

256m -- 優先修改此參數，改為192或更小

--launcher.defaultAction

openFile

--launcher.appendVmargs

-vmargs

-Dosgi.requiredJavaVersion=1.6

-Xms40m

-Xmx512m

2.1.2. 配置Tomcat

雖然JFinal自帶的Demo運行在Jetty下，但本文還是選擇以Tomcat為Web容器做說明，已經知道如何設置Tomcat的小白可跳過此節。

運行Tomcat，打開菜單Windows-->Perferences，在彈出的窗口中按下圖選擇：

選擇習慣使用的Tomcat V6：

沒必要追求最新版本，在線安裝Eclipse推薦的Tomcat 6.0.37版本即可：

彈出License說明，直接點Finish即可：

下載完成后會讓你指定Tomcat存放的文件夾：

再次回到設置頁面，點Finish：

至此，Tomcat搭建完成：

2.2. 創建Web應用

2.2.1. 新建Dynamic Web工程

在創建工程之前，先打開菜單Windows-->Perferences，在彈出的窗口中修改默認字符集：

在Eclipse的工具欄上可直接創建Dynamic Web工程：

彈出新建窗口，輸入新工程名MyJFinalApp，直接點Finish：

至此，Dynamic Web工程創建完成：

在工程的屬性中可以看到，Web應用相關的Library已經默認包含：

2.2.2. 下載JFinal

既然基于JFinal框架，沒有理由不下載JFinal相關Jar包。打開JFinal官方網站http://www.jfinal.com/，下載相關內容：

下載jfinal-1.6-bin-with-src.jar是為了使小白在使用中可方便地查看并分析源碼，下載jfinal-1.6_demo_for_jsp.zip是因為有部分必要的Jar包在Demo中可以找到，而且，第一個Demo將采用JSP頁面。

將下載好的jfinal-1.6-bin-with-src.jar直接Copy到工程的下圖位置：

2.3. 配置及編碼

這一章節比較重要，介紹如何配置及編碼，完成第一個JFinal應用。

2.3.1. 創建MyAppConfig.java

首先創建MyJFinal的配置類MyAppConfig.java：

在方法中添加如下代碼：

@Override

public void configConstant(Constants me) {

me.setDevMode(true);

me.setEncoding("utf-8");

me.setViewType(ViewType.JSP);

}

@Override

public void configHandler(Handlers me) {

me.add(new ContextPathHandler("basePath"));

}

2.3.2. 修改web.xml

既然MyAppConfig.java是入口，那么，在Tomcat這個容器中，就需要配置這個入口，使得Tomcat啟動的同時加載這個入口類。

打開web.xml，追加內容：

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://java.sun.com/xml/ns/javaee"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"

id="WebApp_ID" version="2.5">

<display-name>MyJFinalApp</display-name>

<welcome-file-list>

<welcome-file>index.html</welcome-file>

<welcome-file>index.htm</welcome-file>

<welcome-file>index.jsp</welcome-file>

<welcome-file>default.html</welcome-file>

<welcome-file>default.htm</welcome-file>

<welcome-file>default.jsp</welcome-file>

</welcome-file-list>

<filter-name>jfinal</filter-name>

<filter-class>com.jfinal.core.JFinalFilter</filter-class>

<init-param>

<param-name>configClass</param-name>

<param-value>cn.myapp.config.MyAppConfig</param-value>

</init-param>

</filter>

<filter-mapping>

<filter-name>jfinal</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

</web-app>

2.3.3. 創建JSP頁面文件

在創建JSP頁面之前先修改一下JSP文件的默認字符集。如下圖所示，打開菜單Windows-->Perferences，在彈出的窗口中修改默認字符集為utf-8即可：

通過右建，在WebContent中new一個新的jsp文件：

文件名為index.jsp，并放入WebContent中：

完成后可看到首先要打開的index.jsp已經有默認內容了，并且字符集為utf-8：

<%@ page language="java" contentType="text/html; charset=UTF-8"

pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<title>Insert title here</title>

</head>

<body>

</body>

</html>

并在JSP文件的<body>標簽中追加如下代碼：

<body>

請輸入您的名字：

</form>

</body>

同樣的步驟，再創建一個hello.jsp，并在<body>標簽中追加如下代碼：

<body>

<p>${sayHello}</p><p><a href="${basePath}/"></a></p>

</body>

2.3.4. 創建Controller類

創建IndexController.java用于響應頁面請求，如下圖：

并添加代碼：

public class IndexController extends Controller {

public void index(){

this.render("/index.jsp");

}

public void sayHello(){

String userName = this.getAttr("userName");

String sayHello = "Hello " + userName + "，welcome to JFinal world.";

this.setAttr("sayHello", sayHello);

this.render("/hello.jsp");

}

2.3.5. 注冊Controller路由

JSP頁面和Controller都準備完成后，就需要在MyAppConfig.java中將兩者關聯起來，JFinal里稱之為Route（路由），下面是MyAppConfig類中追加的路由代碼：

@Override

public void configRoute(Routes me) {

me.add("/", IndexController.class);

}

2.4. 發布、運行與調試

2.4.1. 發布

上面所有工作完成后，則需要將App發布到Tomcat。在Eclipse IDE的底部，找到Servers，并點擊下圖中標記的區域創建Tomcat實例（前面的Tomcat配置只是配置Eclipse中的Tomcat插件，這里需要建立Tomcat實例。實例可配置多個，但端口不能沖突）：

在彈出的對話框中做如下配置：

將MyJFinalApp加入到新建的Tomcat實例后點Finish：

2.4.2. 運行

選擇新建的Tomcat實例，并以Debug方式啟動：

啟動正常的話，可在控制臺下看到啟動信息：

打開瀏覽器，并輸入URL：http://localhost:8080/MyJFinalApp/，應該可看到如下畫面：

小白們，感動吧，終于將JFinal環境搭建起來了。

在輸入框中輸入“小白”，點擊確定，出現下面的畫面：

2.4.3. 調試

很明顯，頁面中出現了錯誤，紅框中標識的內容是null，而不是期待的“小白”。

再看看控制臺的輸出：

在頁面中輸入的字串正確地傳給了后臺IndexController.sayHello()方法，那么，為什么沒有顯示出來呢？請小白在IndexController.sayHello()中追加斷點：

然后再次打開URL：http://localhost:8080/MyJFinalApp/，在輸入框中輸入“小白”，點擊確定。這時，Eclipse進入調試模式。通過調試查看userName取得的值為null：

仔細分析發生錯誤的這行代碼，或直接查看此方法的源碼，原來，getArrt("userName")方法取到的是HttpServletRequest中的屬性，而不是請求參數。應該改成從取參數的getPara("userName")方法：

public void sayHello(){

String userName = this.getPara("userName");

。。。。。。

又一次打開UR：http://localhost:8080/MyJFinalApp/，在輸入框中輸入“小白”，點擊確定，終于出現了令人期待的結果：

2.5. 為小白解惑

實際上，除去Eclipse和Tomcat的準備以外，配置及編碼那塊在熟練的人手里只需要10分鐘左右，當之無愧的極速WEB開發。當然，前面只是使用到了JFinal的WEB框架，ORM框架在后面的教程中會介紹到。

這一章節，將粗略地講解一下JFinal的WEB部分是如何搭載在Tomcat容器中，啟動并響應用戶操作的過程。

另外，推薦小白們看完此章節后研究下張劍峰同學寫的《JFinal技術架構淺析》一文。

2.5.1. JFinal啟動

前面，小白們創建MyAppConfig.java，同時修改web.xml。這就為啟動JFinal做好了準備，下面我們就來分析下Tomcat啟動的同時是怎么初始化MyJFinalApp的。

先來看web.xml：

<filter-name>jfinal</filter-name>

<filter-class>com.jfinal.core.JFinalFilter</filter-class>

<init-param>

<param-name>configClass</param-name>

<param-value>cn.myapp.config.MyAppConfig</param-value>

</init-param>

</filter>

<filter-mapping>

<filter-name>jfinal</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

xml中首先聲明了<filter>，它是JFinalFilter，同時定義了<init-param>，指向應用程序的配置類MyAppConfig.java。

在<filter-mapping>中，定義了<url-pattern>為“/*”，也就是說，此Web應用所有的URL都將將由JFinalFilter這個過濾器來處理。

Tomcat啟動過程：

過程中，對于JFinal開發人員來說，最有用操作就是“調用MyAppConfig各方法”，也就是執行了如下代碼：

@Override

public void configConstant(Constants me) {

me.setDevMode(true);

me.setEncoding("utf-8");

me.setViewType(ViewType.JSP);

}

@Override

public void configHandler(Handlers me) {

me.add(new ContextPathHandler("basePath"));

}

@Override

public void configRoute(Routes me) {

me.add("/", IndexController.class);

}

各方法的作用請參考《JFinal-手冊-1.5.pdf》，此處不再復述手冊可從官網http://www.jfinal.com/下載。

2.5.2. 響應用戶操作

應用中，創建了兩個JSP頁面，分別是“index.jsp”和“hello.jsp”，在瀏覽器中訪問http://localhost:8080/MyJFinalApp/時明顯打開了index.jsp頁面。經歷過SSH或SpringMVC的小白應該會很奇怪，明明沒有像SpringMVC那樣用注解聲明Controller，也沒有在注解方法對應的URL，而JFinal卻正確地打開了index.jsp。

首先請看MyAppConfig.configRoute()方法中的URL路由代碼：

me.add("/", IndexController.class);

這句代碼實際上已經配置了URL與Controller之間的對應關系，第一個參數"/"就是指的根。當用戶訪問根URL時，依據約定JFinal會將其路由到IndexController.index()方法。

那么，在訪問http://localhost:8080/MyJFinalApp/時，JFinal如何知道訪問的是"/"(根)呢？

首先請小白雙擊Tomcat配置項：

在彈出的Tomcat實例屬性窗口中找到Ports選項：

這里說明Tomcat實例使用的是8080端口，也就是通過http://localhost:8080可訪問此Tomcat。

然后請小白打開部署的Tomcat實例的server.xml：

在server.xml底部，我們可以發現MyJFinalApp的配置：

請看path參數，它的值為"/MyJFinalApp"（一定要和前面Context root配置一樣），說明此應用部署到Tomcat的后使用的根URL為“http://localhost:8080”+ “/MyJFinalApp” = “http://localhost:8080/MyJFinalApp”。

提示：修改reloadable的值為false，在調試狀態，修改MyJFinalApp的代碼時Tomcat不會頻繁重新加載應用，節省開發調試時間。

通過上面，我們已經知道，通過訪問http://localhost:8080/MyJFinalApp/，JFinal會將其路由到IndexController.index()方法，為什么是index()方法？其實這是一個約定，具體的約定請參考《JFinal-手冊-1.5.pdf》。

那么它是如何打開index.jsp文件的呢？我們來查看index()方法的代碼：

public class IndexController extends Controller {

public void index(){

this.render("/index.jsp");

}

。。。。。。

只有一句代碼，作用是渲染\WebContent\index.jsp這個文件后返回給瀏覽器。小白們又糊涂了，為什么不return一個字串來指定渲染頁面呀?這里就是JFinal設計者的聰明之處了，渲染頁面可能不止常見的JSP、FREE_MARKER、VELOCITY等幾種類型，隨著技術的發展，模板頁面類型會層出不窮。JFinal中，只需要擴展Render就可輕松支持，贊呀^_^。

打開index.jsp后，用戶在頁面中輸入名字，然后點擊確定，這里調用的是如下action代碼：

請輸入您的名字：

</form>

action的值為"${basePath}/sayHello"，那么${basePath}是什么東東呢？有點JSP基礎的人都知道，basePath必須設置到HttpServletRequest中才能在頁面中使用。那么又是什么時候設置進去的呢？請注意前面創建MyAppConfig.java中的一段代碼：

@Override

public void configHandler(Handlers me) {

me.add(new ContextPathHandler("basePath"));

}

在這里配置了一個ContextPathHandler，構造參數是"basePath"，難道它們有聯系！沒錯，小白們可直接查看此Handler的源碼就可以發現，一行代碼已經做必須的事情：

public void handle(String target, HttpServletRequest request, HttpServletResponse response, boolean[] isHandled) {

request.setAttribute(contextPathName, request.getContextPath());

nextHandler.handle(target, request, response, isHandled);

}

ContextPathHandler就只做了這么一件事情，就是在每次（注意是每次）請求時將Context Path（此應用中的值為"/MyJFinalApp"）設置到HttpServletRequest的屬性"basePath"中，這樣，頁面就可以使用了。

為了證實這一點，可在瀏覽器中打開index.jsp返回的html源碼：

此頁面中，點擊確定，就將用戶輸入的”userName”，通過Post方式調用http://localhost:8080/MyJFinalApp/sayHello地址。最終，調用的是IndexController.sayHello()方法。

JFinal是怎么知道調用的是此方法呢？其實很簡單，在JFinal的路由規則中，首先會去匹配地址”/sayHello”。顯然是找不到的，因為在MyAppConfig.configRoute()方法中根本就沒有配置與”/sayHello”對應的Controller。所以JFinal會截掉最后一個”/”后的內容再次匹配，”/sayHello”截取掉后就成了”/”，也就匹配到了IndexController。根據約定，被截取的內容”sayHello”應該是方法名，所以，也順序定位到了IndexController.sayHello()方法。

小白們，明白了吧，JFianl的路由約定拋棄掉了繁瑣的注解，這就是一種簡潔美。這種設計在JFianl中處處都存在，隨著對JFinal了解的加深，大家會慢慢體會到約定大于配置不單單是一句口號。

有部分人也提出了質疑：注解能規范編碼，一目了然……等等。但如果回過頭來想，注解實際上也就是一種顯示的約定而已，而JFianl將其當成了隱式約定。使用注解功能更強了點嗎？答案是沒有，SSH和SpringMVC的這類注解與JFinal的實際提供的路由在功能上沒有任何區別，沒有脫離Servlet的范疇。

文章來源：http://my.oschina.net/u/1175852/blog/288511

posted @ 2016-06-27 11:15 培杰閱讀(450) 評論(0) 收藏舉報

刷新頁面返回頂部

Jack

JFinal教程2

1. JFinal簡介

2. 小白的第一個JFinal程序

2.1. Eclipse平臺搭建

2.1.1. 下載Eclipse

2.1.2. 配置Tomcat

2.2. 創建Web應用

2.2.1. 新建Dynamic Web工程

2.2.2. 下載JFinal

2.3. 配置及編碼

2.3.1. 創建MyAppConfig.java

2.3.2. 修改web.xml

2.3.3. 創建JSP頁面文件

2.3.4. 創建Controller類

2.3.5. 注冊Controller路由

2.4. 發布、運行與調試

2.4.1. 發布

2.4.2. 運行

2.4.3. 調試

2.5. 為小白解惑

2.5.1. JFinal啟動

2.5.2. 響應用戶操作

公告