项目Github地址:https://github.com/zxuqian/Learning-Java-EE-2016
由于Eclipse在Mac下的表现并不好,严重影响效率,所以在添加JPA模块之前,先教大家如何把项目迁移到IntelliJ IDEA下。IntelliJ是一个非常强大的Java IDE,提供流畅的操作界面和智能的项目编译和运行管理,所谓intelligent。因为项目是按Maven的结构构造,所以即使换掉IDE也不用对项目做发动,只是需要删除一些Eclipse专用的文件而已。所以如果你用Windows或者想继续使用Eclipse的话,可以跳过本节。
另外由于在迁移之前,新的项目已经开发一半,所以会看到几个新项目,稍后会对其进行介绍。
迁移到IntelliJ
打开IntelliJ,在首页中选择 Import Project。
选择 Import project from external model 然后选择Maven 并点击 next.
选择 search for project recursively, 因为我们的项目是模块化,pom.xml在子文件夹下,所以我们需要递归查找子目录。再勾选 import Maven projects automatically。点击 next.
勾选搜索出来的项目: com.zxuqian:notebookRoot:0.0.1-SNAPSHOT, 此为所有Maven模块的根模块,用来统一管理依赖。稍后详细介绍。
选择 JDK 并点击 next。
给项目命名并选择项目文件存储目录,这里保持默认。点击Finish。
现在进入到IntelliJ主界面,会发现项目下存在Eclipse相关配置文件: .settings, build, .classpath, .project。这些可直接安全删除。
优化项目结构
Maven是一个强大的依赖管理和项目构建工具,并且pom.xml文件可以继承,以方便管理依赖的版本和定义通用的属性。
首先,创建一个新的maven模块,给定group id为com.zxuqian, artifact id为 notebookRoot, 版本为:0.0.1-SNAPSHOT。 此为其他所有模块的根模块,所以在此模块执行 maven clean 或 install 为所有子模块执行相同的操作。Pom.xml文件如下所示:
4.0.0
com.zxuqian
notebookRoot
0.0.1-SNAPSHOT
pom
org.wildfly.bom
wildfly-javaee7
import
pom
10.1.0.Final
../notebook
../notebookDomain
../notebookEAR
更新JSF模块
由于更新了项目结构,上次创建的JSF模块需要做一些改动,新的pom.xml文件:
4.0.0
com.zxuqian
notebook
war
com.zxuqian
notebookRoot
0.0.1-SNAPSHOT
../notebookRoot/pom.xml
maven-compiler-plugin
3.5.1
1.8
maven-war-plugin
3.0.0
WebContent
org.jboss.spec.javax.faces
jboss-jsf-api_2.2_spec
provided
注意
安装 MySQL 数据库
请参考MySQL官方网站如何安装: https://dev.mysql.com/doc/refman/5.7/en/osx-installation-pkg.html
基本只需下载一个安装包,双击运行。这里用的版本为MySQL 5.7。
创建JDBC Resource
首先下载mysql jdbc 连接驱动: https://dev.mysql.com/downloads/connector/j/
解压缩下载的文件,其中 mysql-connector-java-5.1.40-bin.jar 即为驱动。
首次启动Wildfly之前需要添加用户才能登录管理界面,在命令行中运行:
/Users/zxuqian/development/tools/wildfly-10.1.0.Final/bin/add-user.sh
根据提示创建管理用户。
从命令行中启动Wildfly:
/Users/zxuqian/development/tools/wildfly-10.1.0.Final/bin/standalone.sh
登录到管理界面: http://localhost:9990
在欢迎界面点击Deploy an Application旁边的 start。我们需要先把MySQL的jdbc驱动部署到Wildfly。在随后出现的页面中,点击 Add 。
选择Upload a new deployment。点击Next。
选择解压得到的jar文件。点击Next。
保持默认,点击Finish。
回到首页,点击Create a datasource旁边的start链接。在随后出现的页面中选择 Subsystems -> Datasources -> Non-XA。点击右边的 Add。
选择MySQL datasource. 点击Next。
指定一个Datasource名称和JNDI名称。 JNDI 名称十分重要,会在JPA连接到JDBC Resource的时候用到。点击Next。
选择Detected driver并选择第一个检测出来的驱动。点击next。
定义连接 URL。这里我创建的数据库名称为notebook,在配置URL之前,先在mysql中使用“create database notebook”命令创建此数据库。指定MySQL用户名和密码之后,点击next。
查看配置概要,如果正确点击finish。
可通过下图的方式测试是否连接成功:
如果成功连接到数据库,会弹出下图提示框:
创建JPA module
从IntelliJ中创建一个Maven 模块。使用下图所示的groupId, artifactId, 并选择择之前所创建的notebookRoot做为父项目: com.zxuqian:notebookRoot:0.0.1-SNAPSHOT
创建完成后,修改pom.xml文件内容:
4.0.0
com.zxuqian
notebookDomain
jar
com.zxuqian
notebookRoot
0.0.1-SNAPSHOT
../notebookRoot/pom.xml
maven-compiler-plugin
3.5.1
1.8
org.hibernate.javax.persistence
hibernate-jpa-2.1-api
provided
此模块打包为Jar项目,为Java EE所要求的JPA模块打包结构。
因为wildfly运行环境提供JPA实现,所以这里JPA依赖的scope为provided,仅在编译时提供。
创建一个 Entity
Entity是Java对象和数据库表建立关系的桥梁,使用JPA注解来配置如何生成对应的数据库表。首先创建一个class,类名为User,并填入如下代码:
package com.zxuqian.notebook.domain;
import java.io.Serializable;
import java.util.Date;
import javax.persistence.*;
/**
* Entity implementation class for Entity: User
*
*/
@Entity
public class User implements Serializable {
private static final long serialVersionUID = 1L;
@Id
@GeneratedValue(strategy=GenerationType.IDENTITY)
private long id;
private String username;
private String password;
private Date dateOfBirth;
private String email;
private String phone;
public User() {
super();
}
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Date getDateOfBirth() {
return dateOfBirth;
}
public void setDateOfBirth(Date dateOfBirth) {
this.dateOfBirth = dateOfBirth;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public String getPhone() {
return phone;
}
public void setPhone(String phone) {
this.phone = phone;
}
}
此类为POJO(simple plain old java bean),意思为此类提供一组属性,并提供用这些属性初始化对象的构造方法,以及访问和设置这些属性的getter和setter方法。Entity需要实现Serializable接口以便JPA把对象序列化到数据库和从数据库中反序列化出来。
@Entity注解表明此类为Entity,默认使用类名作为表名。
@Id注解声明此成员变量为数据库中的主键,使用IDENTITY生成策略,即JPA负责生成ID的数值。
在src/META-INF 目录, 创建名为 persistence.xml 的文件,填入如下内容:
java:/MySqlDS
此文件为JPA的配置文件。
创建EAR 模块
因为JSF模块和JPA模块为独立的两个项目,所以我们需要把它们打包成一个EAR包部署到wildfly服务器中。它包含的JSF和JPA模块会自动被wildfly识别并部署。创建此项目(groupId和artifacitId请参考下方pom文件),并在pom.xml中填入下方代码:
4.0.0
com.zxuqian
notebookEAR
0.0.1-SNAPSHOT
ear
maven-ear-plugin
2.10
EarContent
7
lib
com.zxuqian
notebook
/notebook
org.wildfly.plugins
wildfly-maven-plugin
1.2.0.Alpha2
/Users/zxuqian/development/tools/wildfly-10.1.0.Final
com.zxuqian
notebook
0.0.1-SNAPSHOT
war
com.zxuqian
notebookDomain
0.0.1-SNAPSHOT
这里使用了 wildfly-plugin 插件,可以方便的启动、关闭服务器,部署,卸载项目。在
运行应用
在IntelliJ中,点击View – Tool Windows – Maven Projects 来显示Maven视图:
双击notebookRoot的install来构建项目。双击notebookEAR下的wildfly:run来启动服务器并部署项目。如果需要重新部署项目,只需双击执行wildfly:redeploy即可。
验证数据库是否创建成功,请连接到MySQL数据库,并查看notebook数据库中是否存在User表。使用describe + 表名可显示表结构:
use notebook;
describe user;
如果看到如下结果即表示创建成功。