JFinal 入门

时间  2019-11-20
标签 jfinal 入门 栏目 Java开源 繁體版
原文   原文链接

1. 建立MyAppConfig.java

首先建立MyJFinal的配置类MyAppConfig.java：html

在方法中添加以下代码：java

@Overrideweb

public void configConstant(Constants me) {浏览器

me.setDevMode(true);架构

me.setEncoding("utf-8");app

me.setViewType(ViewType.JSP);框架

}eclipse

 

@Overridejsp

public void configHandler(Handlers me) {ide

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

}

 

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>

<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>

 

 

3. 建立JSP页面文件

在建立JSP页面以前先修改一下JSP文件的默认字符集。以下图所示，打开菜单Windows-->Perferences，在弹出的窗口中修改默认字符集为utf-8便可：

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

<body>

<form action="${basePath}/sayHello" method="post">

请输入您的名字：

<input type="text" name="userName" />

<input type="submit" value="肯定"/>

</form>

</body>

 

 

一样的步骤，再建立一个hello.jsp，并在<body>标签中追加以下代码：

<body>

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

</body>

 

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");

}

}

 

5. 注册Controller路由

JSP页面和Controller都准备完成后，就须要在MyAppConfig.java中将二者关联起来，JFinal里称之为Route（路由），下面是MyAppConfig类中追加的路由代码：

@Override

public void configRoute(Routes me) {

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

}

 

2. 发布、运行与调试

2.1. 发布

打开浏览器，并输入URL：http://localhost:8080/MyJFinalApp/，应该可看到以下画面：

JFinal教程1——小白的第一个JFinal程序 

 

小白们，感动吧，终于将JFinal环境搭建起来了。

在输入框中输入“小白”，点击肯定，出现下面的画面：

JFinal教程1——小白的第一个JFinal程序 

 

 调试

很明显，页面中出现了错误，红框中标识的内容是null，而不是期待的“小白”。

再看看控制台的输出：

JFinal教程1——小白的第一个JFinal程序 

在页面中输入的字串正确地传给了后台IndexController.sayHello()方法，那么，为何没有显示出来呢？请小白在IndexController.sayHello()中追加断点：

JFinal教程1——小白的第一个JFinal程序 

 

而后再次打开URL：http://localhost:8080/MyJFinalApp/，在输入框中输入“小白”，点击肯定。这时，Eclipse进入调试模式。经过调试查看userName取得的值为null：

JFinal教程1——小白的第一个JFinal程序 

 

仔细分析发生错误的这行代码，或直接查看此方法的源码，原来，getArrt("userName")方法取到的是HttpServletRequest中的属性，而不是请求参数。应该改为从取参数的getPara("userName")方法：

public void sayHello(){

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

。。。。。。

 

又一次打开UR：http://localhost:8080/MyJFinalApp/，在输入框中输入“小白”，点击肯定，终于出现了使人期待的结果：

JFinal教程1——小白的第一个JFinal程序 

 

为小白解惑

实际上，除去Eclipse和Tomcat的准备之外，配置及编码那块在熟练的人手里只须要10分钟左右，当之无愧的极速WEB开发。固然，前面只是使用到了JFinal的WEB框架，ORM框架在后面的教程中会介绍到。

这一章节，将粗略地讲解一下JFinal的WEB部分是如何搭载在Tomcat容器中，启动并响应用户操做的过程。

另外，推荐小白们看完此章节后研究下张剑峰同窗写的《JFinal技术架构浅析》一文。

 

JFinal启动

前面，小白们建立MyAppConfig.java，同时修改web.xml。这就为启动JFinal作好了准备，下面咱们就来分析下Tomcat启动的同时是怎么初始化MyJFinalApp的。

先来看web.xml：

<filter>

<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教程1——小白的第一个JFinal程序 

过程当中，对于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/下载。

响应用户操做

应用中，建立了两个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配置项：

JFinal教程1——小白的第一个JFinal程序 

在弹出的Tomcat实例属性窗口中找到Ports选项：

JFinal教程1——小白的第一个JFinal程序 

这里说明Tomcat实例使用的是8080端口，也就是经过http://localhost:8080可访问此Tomcat。

 

而后请小白打开部署的Tomcat实例的server.xml：

JFinal教程1——小白的第一个JFinal程序 

在server.xml底部，咱们能够发现MyJFinalApp的配置：

<Context docBase="MyJFinalApp" path="/MyJFinalApp" reloadable="true" source="org.eclipse.jst.jee.server: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" method="post">

请输入您的名字：

<input type="text" name="userName" />

<input type="submit" value="肯定"/>

</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源码：

JFinal教程1——小白的第一个JFinal程序 

此页面中，点击肯定，就将用户输入的”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/261235

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程