JFinal开发环境配置
一、安装 Maven
Maven是一个项目构建和管理的工具,提供了帮助管理 构建、文档、报告、依赖、scms、发布、分发的方法。可以方便的编译代码、进行依赖管理、管理二进制库等等。
Maven的好处在于可以将项目过程规范化、自动化、高效化以及强大的可扩展,利用 Maven自身及其插件还可以获得代码检查报告、单元测试覆盖率、实现持续集成等等。
1. 下载 Maven
2. 将下载后的压缩文件解压到任意目录,这里选择解压到 D:\Program Files目录下,并配置其环境变量(参考配置 JDK的环境变量)
配置 Maven环境变量前,先确认 “JAVA_HOME”这个环境变量是对应于JDK的安装目录。
配置 Maven的系统变量。
验证配置是否正确。
修改默认仓库路径。到 D:\Program Files\apache-maven-3.3.9\conf目录下打开 settings.xml文件,修改默认的仓库路径。
二、安装 IDEA
1. 下载 IDEA14或者 IDEA15
2. 鼠标双击安装程序开始安装
3. 安装完成后打开IDEA,并完成激活
License server address:
http://idea.lanyus.com/
备用的License server address:
http://0.idea.lanyus.com
http://1.idea.lanyus.com
http://2.idea.lanyus.com
三、创建一个 JavaWeb工程项目
1. 新建项目
点击 IDEA菜单栏左上角的 “File” 选项,在出现的下拉列表中选择第一项 “New”,在 “New” 选项的右边再选择 “Project” 选项打开 “New Project” 对话框。
设置 GroupId和 ArtifactId。
设置 Maven的安装目录、settings.xml的文件位置和本地仓库的位置等信息。
设置项目名称。
项目创建完成。
2. 在 pom.xml文件中添加 jar包依赖
pom.xml文件说明:
project:pom.xml文件中的顶层元素;
modelVersion:指明 POM使用的对象模型的版本。这个值很少改动。
groupId:指明创建项目的组织或者小组的唯一标识。GroupId是项目的关键标识,典型的,此标识以组织的完全限定名来定义。比如,org.apache.maven.plugins是所有Maven插件项目指定的 groupId。
artifactId:指明此项目产生的主要产品的基本名称。项目的主要产品通常为一个 JAR文件。第二,象源代码包通常使用 artifactId作为最后名称的一部分。典型的产品名称使用这个格式:
- . (比如:myapp-1.0.jar)。 version:项目产品的版本号。Maven帮助你管理版本,可以经常看到 SNAPSHOT这个版本,表明项目处于开发阶段。
name:项目的显示名称,通常用于 maven产生的文档中。
url:指定项目站点,通常用于 maven产生的文档中。
description:描述此项目,通常用于 maven产生的文档中。
要添加依赖我们要先到 maven仓库里面去查询。
首先我们要添加一些基本的依赖关系如:
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
3. 配置项目
打开 “Project Structure”。
配置 “Project”。
配置 “Modules”。
配置 “Libraries”。
添加外部依赖的jar包。有时候将一些本地已存在的 jar包添加到了 src/main/webapp/WEB-INF/lib(该目录要手动创建)这个目录里,那么可以在这里设置将这些 jar包导进项目中而不需要通过在pom.xml中去添加这些jar包的依赖关系来导入。
选中存放 jar包的文件夹。
配置 “Facets”。
配置 “Artifacts”。
3. 配置Tomcat
打开配置。
添加新Tomcat Server配置。
启动 Tomcat。
正确启动后会默认显示index.jsp页面的内容
四、简单搭建 JFinal框架(搭建 JFianl框架之前请先学习 JFinal官方手册)
JFinal官网:http://www.jfinal.com/
详细语法说明请参考 JFinal官方手册:http://download.jfinal.com/upload/2.2/jfinal-2.2-manual.pdf
1. 搭建 JFinal项目步骤+说明
- 一个 JFinal项目一般至少包括三个部分:配置(com.hithinksoft.config)、实体类(com.hithinksoft.model)、控制器(com.hithinksoft.controller)。
- 在com.hithinksoft.config包中创建一个名为MyConfig(类名自定义)的类,它要继承 com.jfinal.config.JFinalConfig,并且要实现JFinalConfig中的五个抽象方法。这个类是必需的,它会对整个 web项目进行配置。
- com.hithinksoft.model包下的实体类都要继承 com.jfinal.plugin.activerecord.Model。
- com.hithinksoft.controller包下的控制器都要继承 com.jfinal.core.Controller。
- 下面编写一个示例:
- 定义两个实体类: com.hithinksoft.model.User.java和 com.hithinksoft.model.Blog.java;
- 定义两个控制器: com.hithinksoft.controller.UserController.java和 com.hithinksoft.controller.BlogController.java。
- 定义页面:在 src\main\webapp\WEB-INF\pages\blogs下面定义四个页面,blogs.jsp、 blog.jsp、publish.jsp和 update.jsp。blogs.jsp页面时展示所有博客信息的,而 blog.jsp页面是展示某一条博客的详细信息的,publish.jsp页面是用来发布博客的,update.jsp页面是用来更改博客的;在 src\main\webapp\WEB-INF\pages\users下定义一个 login.jsp页面和 一个 register.jsp页面来进行登录和注册。
具体目录结构图:
2. 添加依赖
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.16</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.0.8</version>
</dependency>
<dependency>
<groupId>c3p0</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.1.2</version>
</dependency>
<dependency>
<groupId>com.mchange</groupId>
<artifactId>mchange-commons-java</artifactId>
<version>0.2.12</version>
</dependency>
<dependency>
<groupId>com.jfinal</groupId>
<artifactId>jfinal</artifactId>
<version>2.2</version>
</dependency>
3. 配置 web.xml文件
在 web.xml中添加一下代码
<filter>
<filter-name>jfinalFilter</filter-name>
<filter-class>com.jfinal.core.JFinalFilter</filter-class>
<init-param>
<param-name>configClass</param-name>
<param-value>com.hithinksoft.config.MyConfig</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>jfinalFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
上面
4. 创建 com.hithinksoft.config.MyConfig类,继承 com.jfinal.config.JFinalConfig并实现其中的方法
package com.hithinksoft.config;
import com.jfinal.config.*;
public class MyConfig extends JFinalConfig {
@Override
public void configConstant(Constants constants) {
}
@Override
public void configRoute(Routes routes) {
}
@Override
public void configPlugin(Plugins plugins) {
}
@Override
public void configInterceptor(Interceptors interceptors) {
}
@Override
public void configHandler(Handlers handlers) {
}
}
5. 验证项目的搭建是否成功
添加以下内容进行验证:
- 在 MyConfig类的 configRoute方法中添加一个路由,例如:routes.add("/", HelloController.class) (也可以是别的Controller类)。
- 在 HelloController.java中添加一个 index方法(方法名称自定义),在 index方法里面添加一条 renderJsp("index.jsp")跳转语句。
- 在 src\main\webapp\WEB-INF\目录下的 index.jsp页面中随便添加一些内容。
- 启动Tomcat服务器,如果浏览器输入了 index.jsp页面的内容,则说明 JFinal项目的搭建成功。
6. MyConfig类的具体内容
public class MyConfig extends JFinalConfig {
private static String VIEWURL = "/WEB-INF/pages/";
@Override
public void configConstant(Constants constants) {
/*开发模式常量devMode设置为true,这样程序运行时会打印一些调试信息等*/
constants.setDevMode(true);
/*设置编码格式为UTF-8*/
constants.setEncoding("UTF-8");
/**
* 设置视图类型为JSP
* 如果页面中使用了FreeMarker,则应该写成:
* constants.setViewType(ViewType.FREE_MARKER);
* */
constants.setViewType(ViewType.JSP);
}
@Override
public void configRoute(Routes routes) {
routes.add("/", HelloController.class);
/**
* 当在浏览器中访问 “http://localhost:8080/blog/users/login”时,
* 会映射到 UserController.java中的 login()方法。
* 第三个参数 MyConfig.VIEWURL是个常量,它的值是: "/WEB-INF/pages/",
* 它表示Controller返回的视图的相对路径,
* 它的作用是:当调用了 UserController中的 login()方法的renderJsp("users/login.jsp")语句时,
* 代码会将“/WEB-INF/pages/”与renderJsp中的参数 “users/login.jsp”拼接起来得到的
* 路径作为即将打开的页面的路径。也就是说当在浏览器地址栏中输入了
* “http://localhost:8080/blog/users/login”之后,浏览器会访问到
* “/WEB-INF/pages/users/login.jsp”这个页面
*/
routes.add("/users", UserController.class, MyConfig.VIEWURL);
routes.add("/blogs", BlogController.class, MyConfig.VIEWURL);
}
@Override
public void configPlugin(Plugins plugins) {
/**
* 通过 Prokit工具类加载db.txt文件,db.txt是自己创建的文件,里面填写了一些连接数据库时
* 必要的参数相似的也可以将其他一些配置信息(如configConstant()方法中的的devMode、视图
* 类型等等)放到一个文件中,然后通过这种方法来获取其中的参数。
* */
PropKit.use("db.txt");
/*从db.txt文件中获取以下四个属性值作为C3p0Plugin的参数来创建一个C3p0Plugin对象*/
C3p0Plugin cp = new C3p0Plugin(PropKit.get("jdbcUrl"),
PropKit.get("user"),
PropKit.get("password").trim(),
PropKit.get("driverClass"));
/*将C3p0Plugin这个插件初始化完成后添加到工程项目中*/
plugins.add(cp);
/**
* C3p0Plugin是数据源,通过这个数据源创建一个ActiveRecordPlugin对象
* ActiveRecordPlugin是ActiveRecord的支持插件,ActiveRecord中定义了:
* addMapping(String tableName, Class<? extends Model> modelClass)方法
* 该方法建立了数据库表名到Model的映射关系,这样就可以通过调用提供的 API去操作数据库了
*/
ActiveRecordPlugin arp = new ActiveRecordPlugin(cp);
plugins.add(arp);
arp.addMapping("user", User.class);
arp.addMapping("blog", Blog.class);
}
@Override
public void configInterceptor(Interceptors interceptors) {
}
@Override
public void configHandler(Handlers handlers) {
}
7. 用户登录
webapp/WEB-INF/pages/blogs/login.jsp
<form method="post" action="/blog/users/loginUser"
style="width:200px;margin:100px auto;">
帐号:<input type="text" name="user.username"/><br/><br/>
密码:<input type="password" name="user.password"/><br/><br/>
<input type="submit" value="登录"/>
</form>
填写正确信息并点击“登录”按钮后,代码会根据 “/blog/users/loginUser”映射到 UserController里面的 loginUser()方法里面继续执行。
com.hithinksoft.controller.UserController.java
public void loginUser() {
User user = getModel(User.class);
String username = user.getStr("username");
String password = user.getStr("password");
/*验证登录的账户和密码是否匹配,如果匹配就获取该 User对象*/
user = user.validate(username, password);
if (user != null) {
setSessionAttr("user", user);
redirect("/blogs/blogs");
} else {
redirect("/users/login.jsp");
}
}
getModel用来接收页面表单域传递过来的model对象,表单域的名称以“modelName.attrName”方式命名,如帐号中 name属性的命令方式为 “user.username”,密码中 name属性的命名方式为 “user.password”。上述代码中的 getModel(User.class)表示接收页面表单域传递过来的 User实体对象,它里面保存有在页面填写的账户和密码。
redirect("/blogs/blogs")方法的作用是跳转页面的,相当于在浏览器地址栏中输入了 “localhost:8080/blog/blogs/blogs”,代码会进入 com.hithinksoft.controller.BlogController中的 blogs()方法(注:redirect方法参数中的第一个“/”就代表根路径“localhost:8080/blog/”)。
com.hithinksoft.controller.BlogController
public void blogs() {
//查询所有的博客
List<Blog> blogs = Blog.blogRepository.find("select * from blog");
//将查询到的博客保存进 request作用域中,这样就可以在前端页面中获取到这些博客
setAttr("blogs", blogs);
renderJsp("blogs/blogs.jsp");
}
上述代码最后是跳转到 “src/main/webapp/WEB-INF/pages/blogs/blogs.jsp”页面。
renderJsp是 render系列方法中的一种,它的作用就是渲染不同类型的视图并返回给客户端,简单地说就是按某种视图类型在浏览器中打开一个已经存在的页面。它与前面的 redirect的区别是 redirect是用来跳转请求的,redirect的请求结果是请求服务器来打开一个页面,而 render系列方法就是打开一个页面。这跟 Servlet中的请求分发和重定向类似。
8. 浏览博客
com.hithinksoft.controller.BlogController
public void blog() {
Integer blogId = getParaToInt(0);
Blog blog = Blog.blogRepository.findById(blogId);
setAttr("blog", blog);
renderJsp("blogs/blog.jsp");
}
跳转页面
webapp/WEB-INF/pages/blogs/blog.jsp
<div style="width:600px;margin:50px auto;border:1px solid #A9A9A9;padding:10px 20px;">
<div style="padding:10px 0px 40px;border-bottom:1px solid #A9A9A9;text-align: center;position:relative;">
<div>${blog.title}</div>
<span style="position:absolute;right:40px;bottom:10px;">作者: ${blog.getUser().username}</span>
</div>
<div style="padding:10px 0px;">
${blog.content}
</div>
</div>
9. 发布博客
webapp/WEB-INF/pages/blogs/publish.jsp
<form method="post" action="/blog/blogs/publishBlog/${user.id}" style="width:600px;margin:50px auto;border:1px solid #A9A9A9;padding:10px 20px;">
标题:
<input type="text" name="blog.title" value="${blog.title}"
style="width: 600px;padding: 4px;"/><br/><br/>
内容:
<textarea name="blog.content" style="width:600px;padding:4px;height:400px;">
${blog.content}
</textarea>
<input type="submit" value="发布"/>
</form>
上述代码也是个表单,所以它的表单元素的 name属性值得写法与 login.jsp页面的写法一样都是 “modelName.attrName”。当点击 “发布”按钮时代码会根据 action中的 “/blog/blogs/publishBlog/${user.id}”映射到 BlogController类中的 publishBlog方法,action最后面的 “/${user.id}”是要传递的参数(具体语法参考 JFinal官方文档),这个 user就是在登录后调用 setSessionAttr("user", user)方法保存到 session作用域中的 user。
com.hithinksoft.controller.BlogController
public void publishBlog() {
//获取 action传递过来的参数
Integer userId = getParaToInt(0);
Blog blog = getModel(Blog.class);
blog.set("user_id", userId);
//将发布的博客持久化到数据库中
blog.save();
redirect("/blogs/blogs");
}
10. 修改已发布的博客
webapp/WEB-INF/pages/blogs/update.jsp
<form method="post" action="/blog/blogs/updateBlog/${blog.id}"
style="width:600px;margin:50px auto;border:1px solid #A9A9A9;padding:10px 20px;">
标题:
<input type="text" name="blog.title" value="${blog.title}"
style="width: 600px;padding: 4px;"/><br/><br/>
内容:
<textarea name="blog.content" style="width: 600px;padding: 4px;height: 400px;">
${blog.content}
</textarea>
<input type="submit" value="修改"/>
</form>
点击 “修改”按钮进入 BlogController中的 updateBlog方法,并且用被修改的博客的id作为参数。
com.hithinksoft.controller.BlogController
public void updateBlog() {
Integer blogId = getParaToInt(0);
Blog blog = getModel(Blog.class);
blog.set("id", blogId);
blog.update();
redirect("/blogs/blogs");
}
11. 删除已发布的博客
com.hithinksoft.controller.BlogController
public void delete() {
Integer blogId = getParaToInt(0);
Blog.blogRepository.deleteById(blogId);
redirect("/blogs/blogs");
}
五、IDEA的常用快捷键
Alt+回车 导入包,自动修正
Ctrl+N 查找类
Ctrl+Shift+N 查找文件
Ctrl+Alt+L 格式化代码
Ctrl+Alt+O 优化导入的类和包
Alt+Insert 生成代码(如get,set方法,构造函数等)
Ctrl+E或者Alt+Shift+C 最近更改的代码
Ctrl+R 替换文本
Ctrl+F 查找文本
Ctrl+Shift+Space 自动补全代码
Ctrl+空格 代码提示
Ctrl+Alt+Space 类名或接口名提示
Ctrl+P 方法参数提示
Ctrl+Shift+Alt+N 查找类中的方法或变量
Alt+Shift+C 对比最近修改的代码
Shift+F6 重构-重命名
Ctrl+Shift+先上键
Ctrl+X 删除行
Ctrl+D 复制行
Ctrl+/ 或 Ctrl+Shift+/ 注释(// 或者/*...*/ )
Ctrl+J 自动代码
Ctrl+E 最近打开的文件
Ctrl+H 显示类结构图
Ctrl+Q 显示注释文档
Alt+F1 查找代码所在位置
Alt+1 快速打开或隐藏工程面板
Ctrl+Alt+ left/right 返回至上次浏览的位置
Alt+ left/right 切换代码视图
Alt+ Up/Down 在方法间快速移动定位
Ctrl+Shift+Up/Down 代码向上/下移动。
F2 或Shift+F2 高亮错误或警告快速定位
代码标签输入完成后,按Tab,生成代码。
选中文本,按Ctrl+Shift+F7 ,高亮显示所有该文本,按Esc高亮消失。
Ctrl+W 选中代码,连续按会有其他效果
选中文本,按Alt+F3 ,逐个往下查找相同文本,并高亮显示。
Ctrl+Up/Down 光标跳转到第一行或最后一行下
Ctrl+B 快速打开光标处的类或方法