1.1 Eclipse下开发

  1. **javadoc** 文档地址：[https://apidoc.gitee.com/jfinal/jfinal](https://apidoc.gitee.com/jfinal/jfinal)
  5. 推荐使用Eclipse Mars这个版本，下载地址为：[https://www.eclipse.org/mars/](https://www.eclipse.org/mars/)

1、创建Dynamic Web Project

1.png

2、填入项目基本信息

2.png

注意上图中：Target runtime 一定要选择<None>

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

3.png

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

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

4.png

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

5、放入JFinal库文件

  1. 将 jfinal-xxx.jar与jetty-server-8.1.8.jar拷贝至项目WEB-INF\lib下即可。注意：jetty-server-8.1.8.jar是开发时使用的运行环境，生产环境不需要此文件。

所需要的 jar 包可以在 jfinal.com 首页下载 jfinal-version-all.zip 文件，该文件中包含了所需的常用 jar 包，以及 jar 包使用说明。

6、修改web.xml

  1. 将如下内容添加至web.xml
  1. <filter>
  2.     <filter-name>jfinal</filter-name>
  3.     <filter-class>com.jfinal.core.JFinalFilter</filter-class>
  4.     <init-param>
  5.        <param-name>configClass</param-name>
  6.        <param-value>demo.DemoConfig</param-value>
  7.     </init-param>
  8. </filter>
  9. <filter-mapping>
  10.     <filter-name>jfinal</filter-name>
  11.     <url-pattern>/*</url-pattern>
  12. </filter-mapping>

7、添加java文件

  1. 在项目src目录下创建demo包，并在demo包下创建DemoConfig文件， 内容如下：
  1. package demo;
  2. import com.jfinal.config.*;
  3. public class DemoConfig extends JFinalConfig {
  4.     public void configConstant(Constants me) {
  5.        me.setDevMode(true);
  6.     }
  7.     public void configRoute(Routes me) {
  8.        me.add("/hello", HelloController.class);
  9.     }
  10.     public void configEngine(Engine me) {}
  11.     public void configPlugin(Plugins me) {}
  12.     public void configInterceptor(Interceptors me) {}
  13.     public void configHandler(Handlers me) {}
  14. }
  1. 注意：DemoConfig.java文件所在的包以及自身文件名必须与web.xml中的param-value标签内的配置相一致(在本例中该配置为demo.DemoConfig)。
  3.  在demo包下创建HelloController类文件， 内容如下：
  1. package demo;
  2. import com.jfinal.core.Controller;
  3. public class HelloController extends Controller {
  4.     public void index() {
  5.        renderText("Hello JFinal World.");
  6.     }
  7. }

8、启动项目

  1. 创建启动项如下图所示：

5.jpg

  1. 鼠标右键点击Java Application并选择New菜单项，新建Java Application启动项，如下图所示：

6.jpg

  1. 在右侧窗口中的Main class输入框中填入: com.jfinal.core.JFinal并点击Debug按钮启动项目，如下图所示：

7.jpg

  1. 上面的启动配置也可以使用一个任意的main方法代替。在任意一个类文件中添加一个main启动集成的jetty如下图所示：
  1. public static void main(String[] args) {
  2.     // eclipse 下的启动方式
  3.     JFinal.start("src/main/webapp", 80, "/", 5);
  4.  
  5.     // IDEA 下的启动方式
  6.     // JFinal.start("src/main/webapp", 80, "/");
  7. }
  1.  上面代码中的四个参数与前面介绍中的一样，注意根据自己的项目结构进行更改。上面的第一个参数”src/main/webapp” 适用于标准的maven项目，如果是非maven的老式java web 项目，第一个参数通常是”WebRoot”或”WebContent”。

9、开启浏览器看效果

  1. 打开浏览器在地址栏中输入: [http://localhost/hello](http://localhost/hello)，输出内容为Hello JFinal World证明项目框架搭建完成。如需完整demo示例可在JFinal官方网站下载：[http://www.jfinal.com](http://www.jfinal.com)
  3. 注意：在tomcat下开发或运行项目时，需要先删除 jetty-server-xxx.jar这个包，否则会引起冲突。Tomcat启动项目不能使用上面介绍的启动方式，因为上面的启动方式需要用到 jetty-server-xxx.jar。

1.2 Maven下开发 >

原文: http://www.jfinal.com/doc/1-1