Java EE 7和Angular JS来构建一个非常简单的应用
今天这篇文章将会向你介绍如何使用Java EE 7和Angular JS来构建一个非常简单的应用。在此之前，先给大家讲一个故事。
我必须承认，我从来都不是一个Javascript的超级粉丝，但我始终记得我第一使用它的情景。我不太记得确切的年份，不过大概是90年代的中期。我的一个页面里有3个frame（是的，frame！记得这个东西吗？那个时候非常流行的），而我想做的是在点击了第3个frame上的一个链接时，能够重新加载前两个frame。那个时候，Javascript是用来在页面上做一些花哨的东西的。不是所有的浏览器都支持，有些浏览器甚至需要你手动打开。时至今日，这个情景已经有了显著变化，Javascript成为一门全栈的开发语言。你甚至可以仅仅用Javascript就能开发出一个完整的应用。但对于我来说，有时我还是会回想到90年代的情形，很难给予Javascript足够的信任，所以这是我为了更好的了解Javascript所做出的尝试。
为什么用Java EE 7？
好吧，我喜欢Java，并且新的Java EE版本非常好用，配合Wildfly或Glassfish使得它简洁而且运行快速。Java EE7的规范可以满足你所有需求，是Java编程中的标准。
为什么用Angular JS？
这里我大概是追随了Angular JS的热潮。因为我在Javascript方面没有太多的经验，不太了解各类的JS库，所以这里只是采纳了一些朋友的建议。而且我也注意到了在最近一次Devoxx大会上对于Angular得到了广泛的接纳，关于Angular的演讲的每一个房间都爆满。所以我想用它尝试一下，也给我自己一个认识的机会。
关于应用
这个应用是一个简单的包含分页的列表，以及一个REST服务用于提供列表中的数据。每当我开始一个新的企业级应用的时候，这通常是我们开始编码时所做的第一件事：创建一张表，存入一些数据，然后列出一些随机数据，所以我认为这个应用是非常合适的。
配置
代码（终于到代码部分了！）
后端-Java EE 7
从后端开始，让我们定义一个简单的Entity类（为了简洁省略了部分代码）：
Persion.java
@Entity
public class Person {
@Id
private Long id;
private String name;
private String description;
}如果你不是很熟悉Java EE的JPA规范，这里就稍作解释。这段代码使用了@Entity注解，从而使一个对象类连接到数据库中同名的表，并产生映射关系，注解@Id用于定义表中的主键。
接下来是persistence.xml文件：
persistence.xml
<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.1"
xmlns="http://xmlns.jcp.org/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">
<persistence-unit name="myPU" transaction-type="JTA">
<properties>
<property name="javax.persistence.schema-generation.database.action" value="drop-and-create"/>
<property name="javax.persistence.schema-generation.create-source" value="script"/>
<property name="javax.persistence.schema-generation.drop-source" value="script"/>
<property name="javax.persistence.schema-generation.create-script-source" value="sql/create.sql"/>
<property name="javax.persistence.schema-generation.drop-script-source" value="sql/drop.sql"/>
<property name="javax.persistence.sql-load-script-source" value="sql/load.sql"/>
</properties>
</persistence-unit>
</persistence>这里有我最喜欢的Java EE 7中的两个特性：现在，你可以使用javax.persistence.schema-generation.*属性来标准化的调用sql。并且，如果你不提供一个数据源的话，它就会绑定到一个默认的数据源。所以在这个例子中，它将会使用内部的Wildfly H2的数据源。
最后，为了提供列表数据，我们需要查询数据库并以REST服务的形式暴露出来：
PersonResource.java
@Stateless
@ApplicationPath("/resources")
@Path("persons")
public class PersonResource extends Application {
@PersistenceContext
private EntityManager entityManager;
private Integer countPersons() {
Query query = entityManager.createQuery("SELECT COUNT(p.id) FROM Person p");
return ((Long) query.getSingleResult()).intValue();
}
@SuppressWarnings("unchecked")
private List<Person> findPersons(int startPosition, int maxResults, String sortFields, String sortDirections) {
Query query = entityManager.createQuery("SELECT p FROM Person p ORDER BY " + sortFields + " " + sortDirections);
query.setFirstResult(startPosition);
query.setMaxResults(maxResults);
return query.getResultList();
}
public PaginatedListWrapper<Person> findPersons(PaginatedListWrapper<Person> wrapper) {
wrapper.setTotalResults(countPersons());
int start = (wrapper.getCurrentPage() - 1) * wrapper.getPageSize();
wrapper.setList(findPersons(start,
wrapper.getPageSize(),
wrapper.getSortFields(),
wrapper.getSortDirections()));
return wrapper;
}
@GET
@Produces(MediaType.APPLICATION_JSON)
public PaginatedListWrapper<Person> listPersons(@DefaultValue("1")
@QueryParam("page")
Integer page,
@DefaultValue("id")
@QueryParam("sortFields")
String sortFields,
@DefaultValue("asc")
@QueryParam("sortDirections")
String sortDirections) {
PaginatedListWrapper<Person> paginatedListWrapper = new PaginatedListWrapper<>();
paginatedListWrapper.setCurrentPage(page);
paginatedListWrapper.setSortFields(sortFields);
paginatedListWrapper.setSortDirections(sortDirections);
paginatedListWrapper.setPageSize(5);
return findPersons(paginatedListWrapper);
}
}这里的代码非常像普通的Java POJP，但是使用了Java EE的注解来增强行为。@ApplicationPath("/resources")和@Path("persons")会通过yourdomain/resources/personsurl来暴露REST服务，@GET标志了这个逻辑通过http的GET方法调用，@Produces(MediaType.APPLICATION_JSON)把REST响应格式化为JSON格式。仅仅用少量注解就能完成这些操作是很酷的。
为了更容易的获得分页列表所需的数据，我还创建了下面这个包装类：
PaginatedListWrapper.java
public class PaginatedListWrapper<T> {
private Integer currentPage;
private Integer pageSize;
private Integer totalResults;
private String sortFields;
private String sortDirections;
private List<T> list;
}现在，后端的事情我们已经完成了。
UI-Angular JS
我们使用Angular JS来展示数据。Angular遵循了MVC模式，通过添加一些自定义的标签属性来绑定数据和Javascript中出现的变量，从而扩展了传统的HTML。那么， 让我们来看看我们的html页面：
index.html
<!DOCTYPE html>
<!-- Declares the root element that allows behaviour to be modified through Angular custom HTML tags. -->
<html ng-app="persons">
<head>
<title></title>
<script src="lib/angular.min.js"></script>
<script src="lib/jquery-1.9.1.js"></script>
<script src="lib/ui-bootstrap-0.10.0.min.js"></script>
<script src="lib/ng-grid.min.js"></script>
<script src="script/person.js"></script>
<link rel="stylesheet" type="text/css" href="lib/bootstrap.min.css"/>
<link rel="stylesheet" type="text/css" href="lib/ng-grid.min.css"/>
<link rel="stylesheet" type="text/css" href="css/style.css"/>
</head>
<body>
<br>
<div class="grid">
<!-- Specify a JavaScript controller script that binds Javascript variables to the HTML.-->
<div ng-controller="personsList">
<!-- Binds the grid component to be displayed. -->
<div class="gridStyle" ng-grid="gridOptions"></div>
<!-- Bind the pagination component to be displayed. -->
<pagination direction-links="true" boundary-links="true"
total-items="persons.totalResults" page="persons.currentPage" items-per-page="persons.pageSize"
on-select-page="refreshGrid(page)">
</pagination>
</div>
</div>
</body>
</html>除了Javascript和CSS声明之外，这里只有很少的代码。让人印象深刻的是，Angular还拥有非常广泛的即插即用的组件，所以，我使用了ng-grid来展示数据，用UI Bootstrap提供分页功能。ng-grid其实同样包含了分页的组件，但是我更喜欢UI Bootstrap提供的组件。
这里还缺少了一个文件——一个js文件来是实现功能：
persion.js
var app = angular.module('persons', ['ngGrid', 'ui.bootstrap']);
// Create a controller with name personsList to bind to the html page.
app.controller('personsList', function ($scope, $http) {
// Makes the REST request to get the data to populate the grid.
$scope.refreshGrid = function (page) {
$http({
url: 'resources/persons',
method: 'GET',
params: {
page: page,
sortFields: $scope.sortInfo.fields[0],
sortDirections: $scope.sortInfo.directions[0]
}
}).success(function (data) {
$scope.persons = data;
});
};
// Do something when the grid is sorted.
// The grid throws the ngGridEventSorted that gets picked up here and assigns the sortInfo to the scope.
// This will allow to watch the sortInfo in the scope for changed and refresh the grid.
$scope.$on('ngGridEventSorted', function (event, sortInfo) {
$scope.sortInfo = sortInfo;
});
// Watch the sortInfo variable. If changes are detected than we need to refresh the grid.
// This also works for the first page access, since we assign the initial sorting in the initialize section.
$scope.$watch('sortInfo', function () {
$scope.refreshGrid($scope.persons.currentPage);
}, true);
// Initialize required information: sorting, the first page to show and the grid options.
$scope.sortInfo = {fields: ['id'], directions: ['asc']};
$scope.persons = {currentPage : 1};
$scope.gridOptions = {
data: 'persons.list',
useExternalSorting: true,
sortInfo: $scope.sortInfo
};
});这个Javascript代码非常简洁，整体性很好。请注意每部分是如何加入到应用的控制器中的，这让你能够分开关注业务逻辑的多个部分。为了实现所需的功能，我们仅仅需要添加少量的方法，包括通过调用REST服务来刷新列表，以及监控表格中的数据来刷新视图。这是最终的结果：
下一步
这个系列的下一篇文章中，我打算：
- 实现拦截
- 实现详细视图
- 实现下一个/上一个浏览导航
- 在云上部署
- 管理Javascript依赖
资源
你可以从我的github库中clone一个完整的拷贝，然后部署到Wildfly上，关于如何部署，也可以在上面找到指导，同样，它也应该能在Glassfish上运行。Java EE – Angular JS Source
更新
同时，我还根据管理Javascript依赖一文来更新了我的源码，请通过 release 1.0来下载源码，同样可以clone这个repo，并使用git checkout 1.0命令来下载release 1.0版本的源码。
原文链接： javacodegeeks 翻译： ImportNew.com - xiafei
译文链接： http://www.importnew.com/13195.html