java jfinal框架: hello world

桃扇骨 2021-09-21 14:44 513阅读 0赞

# 前言 #

官网： [https://jfinal.com/][https_jfinal.com]

源码：[https://gitee.com/jfinal/][https_gitee.com_jfinal]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70][]

这个框架的优势是： 开发迅速、代码量少、学习简单、功能强大、轻量级、易扩展、Restful。在拥有Java语言所有优势的同时再拥有ruby、python、php等动态语言的开发效率！为您节约更多时间，去陪恋人、家人和朋友。

可以看成了java里的php语言。适合个人创业者，中小企业使用。还好就是由于是国人开人的，文档都是中文，容易阅读。

这是一个开源web开发框架 ，只用于web方面，spring则是一个大而全的框架，不单单可以用在web开发，其它领域也可以使用。

# IDEA创建工程 #

由于是是web应用，必须使用旗舰版的IDEA，不能使用社区版的。

以下参考:  [https://blog.csdn.net/m0\_37456570/article/details/107563548][https_blog.csdn.net_m0_37456570_article_details_107563548]

File -->New-->Project

![20210106085907502.png][]

工程类型：Maven-->Create from archetype-->org.apache.maven.archetypes:maven-archetype-webapp

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 1][]

填写名称路径，以及项目GroupId 和ArtifactId

注意：GroupId 和ArtifactId 要点开 Aritiface Coordinates前面的三角符号才能配置，使用默认的也行，不过是一个名字罢了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 2][]

设置Maven的参数，这次先使用默认配置吧，如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 3][]

工程刚建好的时候，会自动开始使用pom导入jar包，本质上就是通过 pom.xml的描述，从网上代码仓库里下载jar包，如下：

![20210106091703836.png][]

耐心等待pom导入完毕，整个基本工程就算建立完毕啦。

首次可能会用时比较久(30分钟)，下载过一次，后面就会直接使用本地的了，就不会有这个下载的过程啦。

导入完成后的工程文件如下：

# 加入配置及代码 #

加入java目录及相关子目录(文件)，如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 4][]

这里，可能会遇到一个问题：IDEA包右键没有新建Java class 的解决方法

解决方法见附件。

这4个文件的内容:

## 1：DemoConfig.java ##

创建自定义的JFinalConfig，自己配置文件一定要集成JFinalConfig

可能会遇到问题 "无法创建类 auto-detect file type by content",  解决方法见附录。

DemoConfig.java 内容如下：

package com.hui.demo.config;
    
    import com.hui.demo.controller.HelloController;
    import com.jfinal.config.*;
    import com.jfinal.template.Engine;
    
    /**
     * @program: JFinalFreemarkerDemo
     * @description: JFinal配置中心
     * @author: LuNanTing
     * @create: 2020-07-24 15:35
     **/
    public class DemoConfig extends JFinalConfig {
    
        @Override
        public void configConstant(Constants constants) {
            //开启开发模式
            constants.setDevMode(true);
        }
    
        @Override
        public void configRoute(Routes routes) {
            routes.add("/hello", HelloController.class);
        }
    
        @Override
        public void configEngine(Engine engine) {
    
        }
    
        @Override
        public void configPlugin(Plugins plugins) {
    
        }
    
        @Override
        public void configInterceptor(Interceptors interceptors) {
    
        }
    
        @Override
        public void configHandler(Handlers handlers) {
    
        }
    }

## 2：HelloController.java ##

因为只是最基础测试搭建，一些配置文件并未配置，需要配置可以通过上边的官方文档查看和配置，

接下来创建一个基础的视图管理Controller类（需要继承jfinal包中的Controller）：

package com.hui.demo.controller;
    
    import com.jfinal.core.Controller;
    
    /**
     * @program: JFinalFreemarkerDemo
     * @description:
     * @author: LuNanTing
     * @create: 2020-07-24 15:13
     **/
    public class HelloController extends Controller {
    
        public void index(){
            renderText("Hello World! jFinal");
        }
    }

## 3：web.xml ##

这时候打开web.xml进行配置：

<!DOCTYPE web-app PUBLIC
     "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
     "http://java.sun.com/dtd/web-app_2_3.dtd" >
    
    <web-app>
      <display-name>Archetype Created Web Application</display-name>
      <filter>
        <filter-name>jfinal</filter-name>
        
        <filter-class>com.jfinal.core.JFinalFilter</filter-class>
        <init-param>
          
          <param-name>configClass</param-name>
          
          <param-value>com.hui.demo.config.DemoConfig</param-value>
        </init-param>
      </filter>
    
      <filter-mapping>
        <filter-name>jfinal</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>
    </web-app>

## 4：StartMain.java ##

最后设置一个启动类，类似于SpringBoot内置Tomcat那样，需要一个main方法：

package com.hui.demo;
    
    import com.jfinal.core.JFinal;
    
    /**
     * @program: JFinalFreemarkerDemo
     * @description: 启动类
     * @author: LuNanTing
     * @create: 2020-07-24 15:40
     **/
    public class StartMain {
    
        public static void main(String[] args) {
            JFinal.start("src/main/webapp",8081,"/", 5);
        }
    }

## 5.添加依赖 ##

pom.xml 文件：

最新的jfinal框架官方推荐使用 jfinal-undertow，而不是jetty，这个helloworld工程就暂时沿用旧的做法吧，新工程就不要这样写了。

注意：要先装Jetty Server，否则会有红色高亮警告，详请见附录。

这里特别注意一下：如果是使用 IDEA 开发，scope 仍然得设置成为 compile，否则提示缺少 jar 包，在打包的时候记得要改回 provided，避免打进一些不需要的 jar 包

<dependency>
          <groupId>com.jfinal</groupId>
          <artifactId>jetty-server</artifactId>
          <version>2019.3</version>
          <scope>compile</scope>
        </dependency>

# 运行 #

点击绿三角，即可运行。

![20210106154736844.png][]

点击运行。

## 问题1，可能会出现了以下问题： ##

Exception in thread "main" java.lang.NoClassDefFoundError: com/jfinal/core/JFinal

![20210106162305269.png][]

解决方法：

添加依赖：

<dependency>
          <groupId>com.jfinal</groupId>
          <artifactId>jetty-server</artifactId>
          <version>2018.11</version>
          <scope>compile</scope>
        </dependency>

但是红色的，

![20210107085549494.png][]

这是因为 Jetty Server没有安装。安装方法见附录。

## 问题2：IncompatibleClassChangeError 错误 ##

![20210108000407394.png][]

原因： 是因为加了两个或两个以上版本的库，比如我这里的问题是加了两个版本的 jfinal库，删掉一个低版本的就好。

下图是删掉多余库之后的截图。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 5][]

运行成功后的提示信息是这样的：

![20210108001004970.png][]

在浏览器就输入地址，就可以访问啦，如下：

![2021010800104884.png][]

# 附录1：关于IDEA包右键没有新建Java class 的解决方法 #

参考： [https://blog.csdn.net/weixin\_43874433/article/details/104762253][https_blog.csdn.net_weixin_43874433_article_details_104762253]

现象为：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 6][]

解决方法：右键-->New-->Mark Directory as --> Sources Root

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 7][]

# 附录2: 问题：无法创建类 auto-detect file type by content #

会提示无法创建类，即使强行创建一个 DemoConfig.java 文件, IDEA也不会识别成 \*.java文件。

![20210106151234954.png][]

原因:  你添加了一个特定样子的文件类型，IDE记住了，导致你这个文件都是按模板指定的文件类型。

解决方法：办法就是，打开设置，找到File Types(可以通过左上边的搜索快速找打，然后，找到签名添加的auto-detect file type by content类型，你会发下在右下边有你添加的文件安静的躺在那，快快把他删除了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 8][]

# 附录3:  Jetty Server 安装与使用 #

最新的jfinal框架官方推荐使用 jfinal-undertow，而不是jetty，这个helloworld工程就暂时沿用旧的做法吧，新工程就不要这样写了。

Jetty更轻量级。这是相对Tomcat而言的。功能类似，Tomcat和Jetty都是一种Servlet引擎。

还有一点不同的是，Jetty是一种嵌入式服务器，Tomcat要单独运行，但Jetty可以直接集成到代码里。安装方法也相对简单，通过maven就行。如下图所示，

Project Structure --> Libraries --> "+"号 --> 输入"com.jfinal" --> 点击输入框右侧的搜索图标，就会显示好几个版本。

选中一个版本，添加到库里即可。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 9][]

然后就会出现一个提示框，等待其完成即可。

![20210107230944898.png][]

添加成功后，就可以看到Libraries里多了一个选项：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 10][]

接着在pom.xml文件里添加依赖：

<dependency>
          <groupId>com.jfinal</groupId>
          <artifactId>jetty-server</artifactId>
          <version>2019.3</version>
          <scope>compile</scope>
        </dependency>

groupId, artifactId,version 必须和上一步下载的一模一样，否则，会有红色高亮提示。

![20210107085549494.png][]

## 扩展： ##

如果缺少其它库，也可以同样的方便把库添加进来，比如：

![2021010723185287.png][]

解决方法：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 11][]

下载完这个库后，颜色就正常了：

![20210107232647371.png][]

# 附录4:  jfinal-undertow 简介 #

jfinal-undertow 功能和 tomcat、jetty 类似，可以相互替代。和jetty一样，是嵌入式服务器。是jfinal全家桶之一。优势是轻量快速和热部署。

[https_jfinal.com]: https://jfinal.com/
[https_gitee.com_jfinal]: https://gitee.com/jfinal/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70]: /images/20210920/6575c40219c7435caef2a8cf58022fda.png
[https_blog.csdn.net_m0_37456570_article_details_107563548]: https://blog.csdn.net/m0_37456570/article/details/107563548
[20210106085907502.png]: /images/20210920/e94aea06bcb4471987848511212407c1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 1]: /images/20210920/0579580a16374d15af9e727d96cba4be.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 2]: /images/20210920/43163aff82414da0a8818dbc0fa84b4d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 3]: /images/20210920/87e70f8e4bdf41b690f2d77319bc5bef.png
[20210106091703836.png]: /images/20210920/c5ae743ae1d84baca9f84a9a344ca05f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 4]: /images/20210920/8c57625c7eb546ebb53da333cc9e4ef1.png
[20210106154736844.png]: /images/20210920/36b2076328d4465888060fd74694c0fa.png
[20210106162305269.png]: /images/20210920/6318c03d09eb4512942a2d8b2f2281b5.png
[20210107085549494.png]: /images/20210920/86e23dcb3cc6452b9cbf61b4bcd4ae67.png
[20210108000407394.png]: /images/20210920/df771661ec6c4f82b306bc10b75ae46b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 5]: /images/20210920/93cf2b77f0f9460ead460534d2c972d4.png
[20210108001004970.png]: /images/20210920/397e3cae88014dce9c66244d8dc04d6b.png
[2021010800104884.png]: /images/20210920/ff31932676114562a80b5b612df1db25.png
[https_blog.csdn.net_weixin_43874433_article_details_104762253]: https://blog.csdn.net/weixin_43874433/article/details/104762253
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 6]: /images/20210920/07259274d49345b2a943b27b539e6e7f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 7]: /images/20210920/2038a69ce9194960a85954c5fc3ae873.png
[20210106151234954.png]: /images/20210920/4044e924ad55441fa493aa2b19e7a6dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 8]: /images/20210920/c44ac7a7d56b406fb51e4941d34814cd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 9]: /images/20210920/4943696f66bc4afe9145ec38d38c25b7.png
[20210107230944898.png]: /images/20210920/b978472e3def451f964ea336cb023751.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 10]: /images/20210920/ab190737009f471dba9ea96845362ca3.png
[2021010723185287.png]: /images/20210920/4b4802a1f2544f239f03ca076f18f31f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3podW9odWkzMDczMTc2ODQ_size_16_color_FFFFFF_t_70 11]: /images/20210920/1f848d516a3542f5a134979a21acb07f.png
[20210107232647371.png]: /images/20210920/d7b76bf22e3a453593b07bae8846d6e2.png