您是否一直想知道在哪里可以找到使用Java EE 6构建的良好端到端示例？ 我有。 您在网上找到的大多数东西都是非常基础的，不能解决现实世界中的问题。 Java EE 6教程就是这样。 所有其他内容，例如Adam Bien所发表的大多数内容，都是范围非常狭窄的示例，也并没有为您提供更完整的解决方案。

因此，我很高兴偶然发现Vineet Reynolds做的一个更复杂的例子。 它被称为“ Java EE 6 Galleria ”，您可以从bitbucket下载源代码。 Vineet是为Arquillian项目做出贡献的软件工程师。 更具体地说，他贡献了一些错误修复程序，并处理了Arquillian Core的一些功能请求，以及Arquillian的GlassFish，WebLogic和Tomcat集成。 这是我第一次遇到他的名字的地方。 跟着Arquillian的家伙和他走近一点，直接把我带到了这个例子。 非常感谢Vineet在我初次尝试使其开始运行时所提供的帮助。 如果您喜欢在Twitter @VineetReynolds上关注他。

这里是有关它的背景的简要说明，也是关于在不同设置下运行它的一系列说明，并向您介绍了一些其他细节。 这是基本介绍。

关于回廊

该项目的高级描述如下：Java EE 6-Galleria是一个演示应用程序，演示了使用域驱动设计的Java EE项目中JSF 2.0和JPA 2.0的使用。 它被编写为Java EE 6中域驱动设计的样板。应用程序的域模型不是贫乏的，它由JPA实体组成。 然后，在用作应用程序层的会话EJB中使用这些实体。 使用Mojarra和PrimeFaces在表示层中使用JSF facelets。 该项目旨在通过使用JUnit 4中编写的单元测试和集成测试来实现全面覆盖。EJB和域模型的单元测试和集成测试依赖于EJB 3.1容器API。 表示层的集成测试依赖于Arquillian项目及其Drone扩展（用于执行Selenium测试）。

使用Java EE 6的域驱动设计

在Java EE 6中，将DDD作为一种体系结构方法是可行的，这主要是由于EJB 3.x中所做的更改以及JPA的引入。 EJB 3.x和JPA规范中所做的改进使得可以在Java EE 6中使用DDD对域和应用程序层进行建模。 这里的基本思想是设计一个应用程序，以确保将持久性服务注入到应用程序层中，并用于在应用程序层建立的事务上下文内访问/持久化实体。

域层

该应用程序现在包含四个域实体-用户，组，相册和照片，它们与逻辑数据模型中的JPA实体相同。

储存库层

在逻辑数据模型的顶部，您可以找到四个存储库-UserRepository，GroupRepository，AlbumRepository和PhotoRepository。 每个用于四个域实体之一。 即使DDD要求您仅具有聚合根目录的存储库，而不是所有域实体的存储库，其设计方式仍允许应用程序层访问“相册”和“照片”域实体，而不必通过UserRepository导航“相册”和“照片”。 存储库是具有无接口视图的无状态会话Bean，并使用Adam Bien发布的通用CRUD服务模式构建。

应用层

应用程序层公开表示层要使用的服务。 它还负责事务管理，同时还充当下一层的故障屏障。 应用程序层与域存储库和域对象进行协调，以实现公开服务的预期目标。 在某种程度上，该层等效于传统应用程序中的服务层。 应用程序层通过UserService，GroupService，AlbumService和PhotoService接口公开其服务，并且还负责在协调域层中的对象之间的动作之前，从上述层验证提供的域对象。 这是通过域对象上的JSR-303约束完成的。

看起来如何

这就是如果在最新的GlassFish 3.1.2上运行该示例时的样子。 想自己设置吗？ 等待下一篇文章，或者自己尝试一下；）

下面，我们将直接使用最新的GlassFish 3.1.2，Hibernate和Derby来设置示例。

制备

让自己有一些配置的心情。 Grep最新的NetBeans 7.1 （Java EE版本已经包含所需的GlassFish 3.1.2 ）并进行安装。 我还假设您在某个地方有一个不错的Java SDK 7 （也可以完成6个工作）。 根据开发策略，您还需要Mercurial Client和Maven。 至少Maven也包含在NetBeans中，所以…我的意思是…为什么使您的生活变得比现在更艰难？ ;）

环境环境

关于环境的更多一些话。 此示例是为支持不同的环境而设置的。 从简单的“开发”环境开始，您还需要配置“测试”以及最后但并非最不重要的“生产”环境。 所有不同的环境都由Maven配置文件处理，因此您可能必须在接下来的几分钟内进行一些配置。

创建数据库实例

首先要做的就是确定将所有东西放在哪里。 这些示例使用了开箱即用的derby，因此您应该安装Java DB（JDK的一部分）或使用预先配置了NetBeans的GlassFish derby实例。 让我们在这里变得更加困难，并假设我们使用JDK随附的Java DB安装。 继续，打开CMD提示符并导航到％JAVA_HOME％文件夹，然后进一步向下db文件夹/ bin。 执行“ startNetWorkServer”脚本，并注意要启动的derby实例。 现在打开另一个CMD提示符，同时导航到db / bin文件夹并执行“ ij”脚本。 这应该带有提示“ ij>”。 现在输入以下连接字符串：

connect 'jdbc:derby://localhost:1527/GALLERIATEST;create=true';

此命令将您连接到derby实例，并创建GALLERIATEST数据库（如果尚不存在）。 Galleria示例使用了一个名为dbdeploy的方便的小工具作为数据库更改管理工具。 它使您可以对物理数据库模型进行增量更新，并在变更日志表中对其进行跟踪。 （有关更多信息，请参阅本系列后面的内容）。 您必须创建更改日志表：

CREATE TABLE changelog (change_number DECIMAL(22,0) NOT NULL,complete_dt TIMESTAMP NOT NULL,applied_by VARCHAR(100) NOT NULL,description VARCHAR(500) NOT NULL
);ALTER TABLE changelog ADD CONSTRAINT Pkchangelog PRIMARY KEY (change_number);

您只需在connect语句中更改数据库名称，即可针对所需的任何其他实例（生产等）重做这些步骤。 并且不要忘记在每个实例中创建更改日志表。

如果您不喜欢这种方法。 启动NetBeans，切换到“服务”选项卡，选择“新建连接”，并添加一个新的Java DB网络连接，其主机为：localhost，端口为：1527，数据库为：GALLERIATEST; create = true。 将用户名和密码都设置为“ APP”，然后单击“测试连接”。 选择APP作为新数据库的架构。 您完成了！

创建GlassFish域

我们正在从最新的GlassFish运行此程序。 现在要做的第一件事是创建一个新域。 导航到您的GlassFish安装目录并转到glassfish3 / bin并执行以下命令：

asadmin create-domain --portbase 10000 --nopassword test-domain

这会为您创建一个新的测试域。 现在，导航到该域文件夹（“ glassfish3 / glassfish / domains / test-domain”）并打开config / domain.xml文件。

现在，我们将创建的derby数据库作为连接池添加到您新创建的GlassFish域。 导航到<resources>元素，并在最后一个</ jdbc-connection-pool>元素下面添加以下连接池和jdbc-resource：

<jdbc-connection-pool driver-classname="" datasource-classname="org.apache.derby.jdbc.ClientDataSource40" res-type="javax.sql.DataSource" description="" name="GalleriaPool" ping="true"><property name="User" value="APP"></property><property name="DatabaseName" value="GALLERIATEST"></property><property name="RetrieveMessageText" value="true"></property><property name="Password" value="APP"></property><property name="ServerName" value="localhost"></property><property name="Ssl" value="off"></property><property name="SecurityMechanism" value="4"></property><property name="TraceFileAppend" value="false"></property><property name="TraceLevel" value="-1"></property><property name="PortNumber" value="1527"></property><property name="LoginTimeout" value="0"></property></jdbc-connection-pool><jdbc-resource pool-name="GalleriaPool" description="" jndi-name="jdbc/galleriaDS"></jdbc-resource>

现在，找到：<config name =“ server-config”>元素，并在其中寻找最后一个<resource-ref条目。 在此添加以下行：

<resource-ref ref="jdbc/galleriaDS"></resource-ref>

在我们准备启动实例之前，要做的最后一件事。 我们需要为Galleria示例添加JDBC领域。 再次，找到<config name =“ server-config”>并在其中查找</ auth-realm>。 在此下面，放置以下内容：

<auth-realm classname="com.sun.enterprise.security.auth.realm.jdbc.JDBCRealm" name="GalleriaRealm"><property name="jaas-context" value="jdbcRealm"></property><property name="encoding" value="Hex"></property><property name="password-column" value="PASSWORD"></property><property name="datasource-jndi" value="jdbc/galleriaDS"></property><property name="group-table" value="USERS_GROUPS"></property><property name="charset" value="UTF-8"></property><property name="user-table" value="USERS"></property><property name="group-name-column" value="GROUPID"></property><property name="digest-algorithm" value="SHA-512"></property><property name="user-name-column" value="USERID"></property></auth-realm>

确保不要将新领域置于default-config下。 这是行不通的。 精细。 让我们获取资源:)

获取源代码并在NetBeans中打开它

Vineet在bitbucket.org上托管了Galleria示例。 因此，您必须去那里并访问java-ee-6-galleria项目。 您可以通过三种方式将源带到本地HDD。 通过hg命令行：

hg clone https://bitbucket.org/VineetReynolds/java-ee-6-galleria

或通过网站下载（右上方的“获取资源”）或直接通过NetBeans。 对于第一个和第三个选项，您的操作系统需要一个Mercurial客户端。 我正在Windows下使用TortoiseHg 。 在执行以下操作之前，您应该已经安装了NetBeans并对其进行了配置 。 让我们在这里尝试最后一种选择。 选择“团队>克隆其他”。 输入存储库URL，并保留用户/密码为空。 单击两次“下一步”（我们不需要更改默认路径；），然后选择一个父目录以将其放入其中。单击“完成”，然后让Mercurial客户端执行工作。 完成后，要求您打开找到的项目。 该外观应类似于右侧的图片。 如果遇到连接问题，请确保相应地更新代理设置。

如果尝试构建项目，则会遇到麻烦。 它仍然缺少一些我们接下来要做的配置。

添加开发配置文件

接下来是在Galleria-ejb项目的Maven pom.xml中添加一些内容。 打开它并向下滚动到<profiles>部分。 您会找到两个（声纳和生产）。 我们将通过在开发配置文件中添加以下几行来添加开发配置文件（确保将GlassFish路径调整为您的环境）：

<profile>
<id>development</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<galleria.derby.testInstance.jdbcUrl>jdbc:derby://localhost:1527/GALLERIATEST</galleria.derby.testInstance.jdbcUrl>
<galleria.derby.testInstance.user>APP</galleria.derby.testInstance.user>
<galleria.derby.testInstance.password>APP</galleria.derby.testInstance.password>
<galleria.glassfish.testDomain.user>admin</galleria.glassfish.testDomain.user>
<galleria.glassfish.testDomain.passwordFile>D:/glassfish-3.1.2-b22/glassfish3/glassfish/domains/test-domain/config/local-password</galleria.glassfish.testDomain.passwordFile>
<galleria.glassfish.testDomain.glassfishDirectory>D:/glassfish-3.1.2-b22/glassfish3/glassfish/</galleria.glassfish.testDomain.glassfishDirectory>
<galleria.glassfish.testDomain.domainName>test-domain</galleria.glassfish.testDomain.domainName>
<galleria.glassfish.testDomain.adminPort>10048</galleria.glassfish.testDomain.adminPort>
<galleria.glassfish.testDomain.httpPort>10080</galleria.glassfish.testDomain.httpPort>
<galleria.glassfish.testDomain.httpsPort>10081</galleria.glassfish.testDomain.httpsPort>
</properties>
</profile>

好。 如您所见，这里定义了一些东西。 并且默认情况下激活配置文件。 而已。 目前。

测试ejb-Galleria项目

让我们尝试在ejb-Galleria项目中运行测试用例。 右键单击它，然后发出“ clean and build”。跟随控制台输出以查看实际发生的情况。 我们将在下一篇文章中对此做进一步调查。 今天，我们只是为了确保您以正确的方式设置所有设置。 它应该以以下内容结束：

Tests run: 49, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

那是“绿色标准” ：-)恭喜！

构建和部署项目

现在转到NetBeans“工具>选项>其他> Maven”，然后选中以下框：“跳过测试以查找与测试没有直接关系的任何构建执行”。 返回主窗口，右键单击Galleria项目，然后进行清洁并在此处构建。

Reactor Summary:Galleria ................................. SUCCESS [0.431s]
galleria-ejb ............................. SUCCESS [5.302s]
galleria-jsf ............................. SUCCESS [4.486s]
Galleria EAR ............................. SUCCESS [1.308s]
------------------------------------------------------------
BUILD SUCCESS
------------------------------------------------------------
Total time: 11.842s

精细。 现在让我们启动GlassFish域。 切换到GlassFish安装并找到glassfish3 / bin文件夹。 在此处打开命令行提示符并运行：

asadmin start-domain test-domain

您可以看到域正在启动。 现在打开浏览器并导航到http：// localhost：10048 / 。 几秒钟后，这将向您显示GlassFish服务器的管理控制台。 现在您需要安装Hibernate。 选择“更新工具”（左下方），然后切换到“可用加载项”选项卡。 选择“休眠”，然后单击“安装”（右上角）。 安装服务器后，请停止服务器，然后使用上述命令重新启动服务器。 再次打开管理控制台，然后单击“应用程序”。 单击顶部的小“部署”按钮，然后浏览至“ java-ee-6-galleria / galleria-ear / target / galleria-ear-0.0.1-SNAPSHOT.ear”。 单击“确定”（右上角）。 几秒钟后您就完成了。 现在切换到http：// localhost：10080 / Galleria / ，您将看到欢迎屏幕。 恭喜你 您在GlassFish上设置了Galleria示例！ 注册，登录并使用该应用程序！

该系列的下一部分将带您深入了解应用程序的细节。 我将介绍测试和总体概念。 我们还将在以后的文章中同时更改JPA提供程序和数据库。

是否想知道在最新的WebLogic 12c上进行安装和运行需要什么？ 继续阅读！

参考： Java EE 6示例– Galleria –第1部分和Java EE 6示例–在GlassFish 3.1.2上运行Galleria – JCG合作伙伴提供的 第2部分   Markus Eisele在Enterprise Software Development with Java博客上。