没有合适的资源?快使用搜索试试~ 我知道了~
首页JFinal离线文档4.8.pdf
资源详情
资源评论
资源推荐

1 快速上手
1.1 Maven 基础
开发 jfinal 项目建议使用 maven,而不是使用传统手工的方式去管理 jar 包和构建项目。由于 maven 应用十分广泛,网上已经有很多 maven 方面的资源,所以本
小节只介绍 maven 使用的最基础的几个小点,了解这几个点上手使用 jfinal 已经够用。
1、下载
进入 maven 官网下载页面: http://maven.apache.org/download.cgi 点击 apache-maven-3.6.0-bin.zip 下载。建议最低下载 3.5.0 版本,高版本更加稳定。
2、安装
将 maven 解压到某个目录中,配置一下环境变量即完成安装,环境变量的配置与 JDK 的配置方式类似,配置两个环境变量即可。以下是 linux 系统下的配置示例:
1. export MAVEN_HOME=/Users/james/app/maven-3.5.2
2. export PATH=$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin
如上所示,将上述两行代码放在 /etc/profile 或者 ~/.bash_profile 文件之中即完成了 maven 的安装。注意配置完上述环境变量后使用 source /etc/profile 或 source
~/.bash_profile 命令让其生效。
windows 系统的环境变量配置参考这里:传送门 A 以及 传送门 B
最后,打开命令行输入如下命令检查 maven 是否安装成功,安装成功会显示 maven 版本号:
1. mvn -v
3、配置 eclipse 指向 maven
eclipse 本身自带一个嵌入的 maven,但嵌入的 maven 使用并不可靠,也不方便,例如在控制台无法使用 maven 的命令行进行操作。所以一定不要使用 eclipse 嵌
入的 maven。以下以简要介绍一下配置方式
打开配置主窗口,点击左侧的 Maven 下的 Installatioins 子菜单
点击上图中的 add 按钮会弹出下面的窗口:
点击上图中的 Directory 选择 maven 解压到的那个目录,勾选刚刚添加的 maven,并去掉其它两个 maven 的勾选项,只保留刚刚安装的那个勾选

最后再点击左侧的 User Settings 菜单,然后分别点击右边两个的 Browe 按钮,为其配置好两个 settings.xml 文件即可,这两个文件在 maven
安装目录的 conf 子目录之下
点击 ok 按钮完成配置
1.2 jfinal-undertow 下开发
1、创建标准的 maven 项目
eclipse 主菜单选择 new,再选择 project
在弹出的窗口中选择 Maven Project,点击 next 按钮进入下一步
在接下来的窗口中勾选 Use default Wrokspace location 点击 next 进入下一步

在接下来的窗口中的 Filter 栏输入 "webapp",选择 org.apache.maven.archetypes maven-archetype-webapp 1.0,点击 next 进入下一步
在接下来的窗口中输入 Group Id 以及 Artifact Id,点击 finish 完成项目的创建
创建创建完成后,最终的目录结构如下
注意注意 :在某些低版本的 eclipse 中,项目创建完成后,在 main 目录下面会缺少缺少 "java" 这个目录这个目录,只需要在资源管理器里面手动创建该目录即可
2、添加 jfinal-undertow 与 jfinal 依赖
打开 pom.xml 文件,在其中添加如下依赖

1. <dependency>
2. <groupId>com.jfinal</groupId>
3. <artifactId>jfinal-undertow</artifactId>
4. <version>2.0</version>
5. </dependency>
6.
7. <dependency>
8. <groupId>com.jfinal</groupId>
9. <artifactId>jfinal</artifactId>
10. <version>4.8</version>
11. </dependency>
如果需要 WebSocket 支持,再添加一个依赖,不开发 WebSocket 无需理会
1. <dependency>
2. <groupId>io.undertow</groupId>
3. <artifactId>undertow-websockets-jsr</artifactId>
4. <version>2.0.28.Final</version>
5. </dependency>
3、添加 java 文件
在项目 src/main/java 目录下创建demo包,并在 demo 包下创建 DemoConfig 文件
1. package demo;
2.
3. import com.jfinal.config.*;
4. import com.jfinal.template.Engine;
5.
6. public class DemoConfig extends JFinalConfig {
7.
8. /**
9. * 注意:用于启动的 main 方法可以在任意 java 类中创建,在此仅为方便演示
10. * 才将 main 方法放在了 DemoConfig 中
11. *
12. * 开发项目时,建议新建一个 App.java 或者 Start.java 这样的专用
13. * 启动入口类放置用于启动的 main 方法
14. */
15. public static void main(String[] args) {
16. UndertowServer.start(DemoConfig.class, 80, true);
17. }
18.
19. public void configConstant(Constants me) {
20. me.setDevMode(true);
21. }
22.
23. public void configRoute(Routes me) {
24. me.add("/hello", HelloController.class);
25. }
26.
27. public void configEngine(Engine me) {}
28. public void configPlugin(Plugins me) {}
29. public void configInterceptor(Interceptors me) {}
30. public void configHandler(Handlers me) {}
31. }
在 demo 包下创建 HelloController 类文件, 内容如下:
1. package demo;
2. import com.jfinal.core.Controller;
3.
4. public class HelloController extends Controller {
5. public void index() {
6. renderText("Hello JFinal World.");
7. }
8. }
4、启动项目
在 DemoConfig 类文件上点击鼠标右键,选择 Debug As,再选择 Java Applidation 即可运行
5、开启浏览器看效果
打开浏览器在地址栏中输入: http://localhost/hello,输出内容为Hello JFinal World证明项目框架搭建完成
完整完整 demo示例示例 可在JFinal官方网站首页右侧下载:http://www.jfinal.com

注意:jfinal-undertow 默认不支持默认不支持 JSP,强烈建议使用 jfinal 默认的模板引擎 enjoy,谁用谁爽翻。
如果一定要使用 JSP,可以参考文档 1.5 章节最后面的《JSP支持问题》:https://jfinal.com/doc/1-5,或者使用 jetty-server 作为开发环境:https://jfinal.
com/doc/1-6
1.3 jfinal-undertow 下部署
1、指定打包为类型为 jar
修改 pom.xml 文件,其中的 packaging 标签值要改成 jar
1. <packaging>jar</packaging>
强烈建议:强烈建议下载首页的 jfinal_demo_for_maven.zip,从中可以获取到本章所涉及的 pom.xml、package.xml、jfinal.sh 等配置文件
与脚本文件。可以节省大量的学习成本。
2、添加 maven-jar-plugin 插件
1. <!--
2. jar 包中的配置文件优先级高于 config 目录下的 "同名文件"
3. 因此,打包时需要排除掉 jar 包中来自 src/main/resources 目录的
4. 配置文件,否则部署时 config 目录中的同名配置文件不会生效
5. -->
6. <plugin>
7. <groupId>org.apache.maven.plugins</groupId>
8. <artifactId>maven-jar-plugin</artifactId>
9. <version>2.6</version>
10. <configuration>
11. <excludes>
12. <exclude>*.txt</exclude>
13. <exclude>*.xml</exclude>
14. <exclude>*.properties</exclude>
15. </excludes>
16. </configuration>
17. </plugin>
maven-jar-plugin 仅为了避免将配置文件打入 jar 包,如果是打成 fatjar 包则不需要添加此插件
3、添加 maven-assembly-plugin 插件
修改 pom.xml ,在其中的 plugins 标签下面添加如下 maven-assembly-plugin 插件
1. <!--
2. 使用 mvn clean package 打包
3. 更多配置可参考官司方文档:http://maven.apache.org/plugins/maven-assembly-plugin/single-mojo.html
4. -->
5. <plugin>
6. <groupId>org.apache.maven.plugins</groupId>
7. <artifactId>maven-assembly-plugin</artifactId>
8. <version>3.1.0</version>
9. <executions>
10. <execution>
11. <id>make-assembly</id>
12. <phase>package</phase>
13. <goals>
14. <goal>single</goal>
15. </goals>
16.
17. <configuration>
18. <!-- 打包生成的文件名 -->
19. <finalName>${project.artifactId}</finalName>
20. <!-- jar 等压缩文件在被打包进入 zip、tar.gz 时是否压缩,设置为 false 可加快打包速度 -->
21. <recompressZippedFiles>false</recompressZippedFiles>
22. <!-- 打包生成的文件是否要追加 release.xml 中定义的 id 值 -->
23. <appendAssemblyId>true</appendAssemblyId>
24. <!-- 指向打包描述文件 package.xml -->
25. <descriptors>
26. <descriptor>package.xml</descriptor>
27. </descriptors>
28. <!-- 打包结果输出的基础目录 -->
29. <outputDirectory>${project.build.directory}/</outputDirectory>
30. </configuration>
31. </execution>
32. </executions>
33. </plugin>
剩余87页未读,继续阅读
















KeepHealth
- 粉丝: 2
- 资源: 5
上传资源 快速赚钱
我的内容管理 收起
我的资源 快来上传第一个资源
我的收益
登录查看自己的收益我的积分 登录查看自己的积分
我的C币 登录后查看C币余额
我的收藏
我的下载
下载帮助

会员权益专享
安全验证
文档复制为VIP权益,开通VIP直接复制

评论0