// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= 使用 Maven 创建企业应用程序
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: 使用 Maven 创建企业应用程序 - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, 使用 Maven 创建企业应用程序

本教程说明了如何使用 NetBeans IDE 和 Maven 原型创建简单的企业应用程序。本教程还提供了一些有关使用 IDE 创建和构建 Maven 应用程序的说明和提示。

在本教程中，将创建一个企业应用程序，该应用程序将打包为 EAR 档案并部署到 GlassFish Server Open Source Edition 3。在新建项目向导中，将使用 Maven 企业应用程序原型创建应用程序。该应用程序包含一个 EJB 项目，其中包含实体的持久性实体类、消息驱动 Bean 和会话 Bean Facade。该应用程序还包含一个 Web 项目，其中包含两个 Servlet。

*教程练习*

* <<intro,在 IDE 中使用 Maven>>
* <<Exercise_1,创建 Maven 企业应用程序项目>>
* <<Exercise_2,对 EJB 模块进行编码>>
* <<Exercise_2a,创建持久性单元>>
* <<Exercise_2b,创建实体类>>
* <<Exercise_2c,创建消息驱动 Bean>>
* <<Exercise_2d,创建会话 Facade>>
* <<Exercise_3,对 Web 模块进行编码>>
* <<Exercise_3a,创建 ListNews Servlet>>
* <<Exercise_3b,创建 PostMessage Servlet>>
* <<Exercise_4,使用 Maven 构建应用程序>>
* <<Exercise_4a,处理项目依赖关系>>
* <<Exercise_4b,使用依赖关系构建>>
* <<Exercise_5,部署并运行应用程序>>
* <<Exercise_5a,从 IDE 中部署>>
* <<Exercise_5b,从 GlassFish Server 管理控制台中部署>>
* <<Exercise_7,下载解决方案项目>>

*要学习本教程，您需要具备以下软件和资源。*

|===
|软件或资源 |要求的版本 

|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |7.2、7.3、7.4、8.0、Java EE 版本 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java 开发工具包 (JDK)+] |版本 7 或 8 

|GlassFish Server Open Source Edition |4.x 
|===

*先决条件*

本文档假定您具备以下技术的一些基本知识或编程经验：

* Java 编程
* NetBeans IDE

在开始本教程之前，您可以先阅读下面这些文档。

* link:http://wiki.netbeans.org/MavenBestPractices[+NetBeans IDE 中的 Apache Maven 最佳做法+]
* link:http://books.sonatype.com/mvnref-book/reference/introduction.html[+Chapter 1. Introducing Apache Maven+]（第 1 章. Apache Maven 简介，来自 link:http://books.sonatype.com/mvnref-book/reference/index.html[+Maven: The Complete Reference+]（Maven：完整参考））

您可以下载link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252FMavenEnterpriseApp.zip[+已完成项目的 zip 档案文件+]。


== 在 IDE 中使用 Maven

NetBeans IDE 中完全集成了 Maven 支持。开发使用 Maven 框架的项目几乎与在 Ant 中开发项目完全相同。不过，Maven 构建项目和使用依赖关系的方式有一些区别。如果是第一次创建 Maven 应用程序，以下提示可帮助您避免某些问题。

*检查 Maven 设置*

如果这是您首次创建 Maven 项目，则需要在 "Options"（选项）窗口中检查 Maven 配置设置。Maven 与 IDE 捆绑在一起，并随同 IDE 一起安装。

1. 在 IDE 中打开“选项”窗口（“工具”>“选项”；在 Mac 上为 "NetBeans" >“首选项”）。
2. 在“选项”窗口中选择 "Java" 类别，然后单击 "Maven" 标签。

您可以使用与 IDE 捆绑在一起的 Maven 版本，也可以指定 Maven 在本地的安装位置（要求为 2.0.9 或更高版本）。


[start=3]
. 选择 "OK"（确定）以关闭 "Options"（选项）窗口。

NOTE: 在 IDE 中启用 Java 后，会自动启用 Maven 支持。您将需要启用 Java EE 插件（如果尚未启用）。

*更新 Maven 资源库*

本地和远程 Maven 资源库可用于代码完成以及构建项目。应更新 Maven 远程资源库索引，以确保在开发项目时可方便地使用所需的任何工件。可以在 "Options"（选项）窗口的 "Maven" 标签中配置 IDE 检查更新的频率。您可以执行即时更新检查，并在“服务”窗口中浏览本地和远程 Maven 资源库。

1. 选择“窗口”>“服务”以打开“服务”窗口。
2. 在“服务”窗口中展开“Maven 资源库”节点。
3. 展开资源库节点以查看工件。
4. 右键单击资源库节点并在弹出式菜单中选择“更新索引”。

在单击 "Update Indexes"（更新索引）时，IDE 将检查并下载每个 Maven 远程资源库的最新索引。索引表示位于资源库中的工件的当前状态，并用于提供对可用于应用程序的工件的引用。默认情况下，在明确需要工件之前，IDE 不会从资源库中下载该工件。

在 "Services"（服务）窗口中右键单击 "Maven Repositories"（Maven 资源库）并选择 "Find"（查找）可搜索工件。

[NOTE]
====
* 索引非常大，因此可能需要一些时间才能全部更新。
* 如果您使用的是 NetBeans IDE 7.1 或更早版本，您将需要选择 "Window"（窗口）> "Other"（其他）> "Maven Repository Browser"（Maven 资源库浏览器），并在 "Maven Repository Browser"（Maven 资源库浏览器）窗口顶部单击 "Update Indexes"（更新索引）(image:images/maven-refreshrepo.png[title=""Update Indexes"（更新索引）按钮"])。
====

有关在 NetBeans IDE 中使用 Maven 的更多详细信息，请参见link:https://netbeans.org/kb/docs/java/maven-hib-java-se.html[+使用 Hibernate 创建 Maven Swing 应用程序+]教程中的link:https://netbeans.org/kb/docs/java/maven-hib-java-se.html#02[+配置 Maven+] 部分以及 link:http://wiki.netbeans.org/MavenBestPractices[+NetBeans IDE 中的 Apache Maven 最佳做法+]。


== 创建 Maven 企业应用程序项目

本练习的目标是使用与 IDE 捆绑在一起的 Maven 企业应用程序原型创建企业应用程序项目。该企业应用程序原型还会创建 EJB 项目和 Web 应用程序项目。

IDE 在新建项目向导中包含几个 Maven 原型，以帮助您快速创建常见类型的 NetBeans 项目，如企业应用程序项目 (EAR)、Web 应用程序项目 (WAR) 和 EJB 模块项目 (JAR)。该向导还允许使用注册的远程资源库中的原型创建项目。

1. 从主菜单中选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键；在 Mac 上为 ⌘-Shift-N 组合键）。
2. 从 "Maven" 类别中选择 "Enterprise Application"（企业应用程序）。单击 "Next"（下一步）。

image::images/maven-newproject1.png[title="新建项目向导中的 "Maven Enterprise Application"（Maven 企业应用程序）项目类型"]


[start=3]
. 键入 *MavenEnterpriseApp* 作为项目名称并设置项目位置。

[start=4]
. （可选）修改工件详细信息。单击 "Next"（下一步）。 

image::images/maven-newproject2.png[title="新建项目向导中的 "Maven Project"（Maven 项目）详细信息"]


[start=5]
. 选择 GlassFish Server 作为服务器。

[start=6]
. 将 "Java EE Version"（Java EE 版本）设置为 "Java EE 6" 或 "Java EE 7"。

[start=7]
. 选中 "Create EJB Module"（创建 EJB 模块）和 "Create Web App Module"（创建 Web 应用程序模块）。单击 "Finish"（完成）。

单击 "Finish"（完成），此时 IDE 将使用 Maven 企业应用程序原型创建以下项目。

* *EJB*。(MavenEnterpriseApp-ejb) EJB 项目通常包含应用程序业务逻辑的源代码。EJB 项目将打包为 EJB JAR 档案。
* *Web 应用程序*。(MavenEnterpriseApp-web) Web 应用程序项目通常包含应用程序的表示层，例如 JSF 和 JSP 页以及 Servlet。Web 应用程序项目可能还包含业务逻辑源代码。Web 应用程序项目将打包为 WAR 档案。
* *汇编*。(MavenEnterpriseApp) 汇编项目用于汇编 EJB 和 WAR 档案中的 EAR 档案。Assembly 项目不包含任何源代码。
* *企业应用程序*。(MavenEnterpriseApp-ear) 企业应用程序项目不包含任何源代码。企业应用程序仅包含 POM 文件 ( ``pom.xml`` ) 以及企业应用程序中包含的模块的详细信息。

image::images/maven-projectswindow2.png[title="显示已生成项目的 "Projects"（项目）窗口"]

在创建企业应用程序项目后，如果有任何依赖关系不可用，则将标记该企业应用程序项目。如果展开 MavenEnterpriseApp-ear 项目的 "Dependencies"（依赖关系）节点，则可以看到是否缺少任何所需的库或所需的库不在类路径中。企业应用程序项目依赖于在编译 EJB 项目和 Web 项目后打包和提供的 JAR 和 WAR。您可以看到， ``MavenEnterpriseApp-ejb``  和  ``MavenEnterpriseApp-web``  作为依赖关系列出。

在某些情况下，您会在状态栏中看到 "Maven" 图标，您可以单击该图标以运行初期构建，并解决缺少依赖关系的问题。

image::images/priming-build.png[title="使用状态栏中的 Maven 图标可以运行初期构建"] 


== 对 EJB 项目进行编码

EJB 项目包含应用程序的业务逻辑。在此应用程序中，GlassFish 容器将使用 Java 事务 API (JTA) 管理事务。在本教程中，将在 EJB 项目中创建一个实体类及其消息驱动 Bean 和会话 Facade。


=== 创建持久性单元

在本练习中，将在 EJB 项目中创建一个持久性单元。持久性单元指定数据库连接详细信息以及如何管理事务。对于此应用程序，将在新建持久性单元向导中指定 JTA，因为您希望由 GlassFish Server 管理事务。

要创建持久性单元，请执行以下步骤。

1. 右键单击 EJB 项目节点，然后从弹出式菜单中选择 "New"（新建）＞ "Other"（其他）打开新建文件向导。
2. 从 "Persistence"（持久性）类别中选择 "Persistence Unit"（持久性单元）。单击 "Next"（下一步）。
3. 在 "New Persistence Unit"（新建持久性单元）对话框中，选择 EclipseLink 作为持久性提供器。
4. 选择数据源（例如，如果要使用 JavaDB，则选择  ``jdbc/sample`` ）。

在安装 IDE 和 GlassFish Server 时， ``jdbc/sample``  的数据源将与 IDE 资源包捆绑在一起；但如果要使用不同的数据库，则可以指定不同的数据源。

您可以保留其他默认选项（持久性单元名称、EclipseLink 持久性提供器）。


[start=5]
. 确保选中 "Use Java Transaction APIs"（使用 Java 事务 API），并且将 "Table Generation Strategy"（表生成策略）设置为 "Create"（创建），以便在部署应用程序时创建基于实体类的表。单击 "Finish"（完成）。

image::images/maven-persistenceunit.png[title="新建持久性单元向导"]

单击 "Finish"（完成），此时 IDE 将创建 XML 文件  ``persistence.xml``  并在编辑器中打开该文件。在 "Projects"（项目）窗口中，您可以看到在  ``"Other Sources"（其他源）> "src/main/resources" > "META-INF"``  目录中创建了该文件。该文件包含连接到数据库以及如何管理事务的详细信息。如果在编辑器中单击 "Source"（源）标签，则可以查看与持久性单元相关的以下详细信息。


[source,xml]
----

...
<persistence-unit name="com.mycompany_MavenEnterpriseApp-ejb_ejb_1.0-SNAPSHOTPU" transaction-type="JTA">
    <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    <jta-data-source>jdbc/sample</jta-data-source>
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <properties>
      <property name="eclipselink.ddl-generation" value="create-tables"/>
    </properties>
</persistence-unit>
            
----

您可以看到将  ``JTA``  指定为事务类型，并且应用程序使用注册的数据源  ``jdbc/sample`` 。


=== 创建实体类

在本练习中，将在 EJB 项目中创建一个实体类以表示永久保存到数据库中的对象。要创建 NewsEntity 实体类，请执行以下步骤。

1. 右键单击 "Projects"（项目）窗口中的 EJB 模块，然后选择 "New"（新建）＞ "Other"（其他）打开新建文件向导。
2. 从 "Persistence"（持久性）类别中，选择 "Entity Class"（实体类）。单击 "Next"（下一步）。
3. 键入 *NewsEntity* 作为类名。
4. 键入 *ejb* 作为包名，并将 "Primary Key Type"（主键类型）保留为 Long。单击 "Finish"（完成）。

单击 "Finish"（完成），此时将在源代码编辑器中打开实体类  ``NewsEntity.java`` 。在源代码编辑器中，执行以下步骤以添加一些字段。

1. 将以下字段声明添加到类中。

[source,java]
----

private String title;
private String body;
----

[start=2]
. 在源代码编辑器的类定义之间右键单击，然后选择 "Insert Code"（插入代码）（Alt-Insert 组合键；在 Mac 上为 Ctrl-I 组合键）> "Getter and Setter"（Getter 和 Setter）。

[start=3]
. 在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，选择  ``body``  和  ``title``  字段。单击 "Generate"（生成）。

[start=4]
. 保存对该类所做的更改。


=== 创建消息驱动 Bean

在本练习中，将在 EJB 项目中创建一个消息驱动 Bean。消息驱动 Bean 是一个可异步交换消息的企业 Bean。NewsApp 应用程序使用消息驱动 Bean 接收并处理 Web 模块中的 Servlet 发送到队列的消息。

要在应用程序中使用消息驱动 Bean，需要在服务器中注册该 Bean 使用的连接器资源。在部署到 GlassFish Server 时，您可以直接通过管理控制台在服务器上创建资源，也可以在部署时在  ``glassfish-resources.xml``  描述符文件中指定详细信息以创建资源。将应用程序部署到服务器时，服务器将根据描述符文件注册资源。在 IDE 中使用新建文件向导创建消息驱动 Bean 时，IDE 将在描述符文件中为您生成元素。

对于 Maven 项目， ``glassfish-resources.xml``  文件位于 "Files"（文件）窗口的项目节点下方的  ``src/main/setup``  目录中。

1. 右键单击 "Projects"（项目）窗口中的 EJB 模块，然后选择 "New"（新建）＞ "Other"（其他）打开新建文件向导。
2. 从 "Enterprise JavaBeans" 类别中，选择 "Message-Driven Bean"（消息驱动 Bean）。单击 "Next"（下一步）。
3. 键入 *NewMessage* 作为 EJB 名称。
4. 从 "Package"（包）下拉列表中选择 *ejb*。
5. 单击 "Project Destination"（项目目标）字段旁边的 "Add"（添加）按钮，以打开 "Add Message Destination"（添加消息目标）对话框。
6. 在 "Add Message Destination"（添加消息目标）对话框中，键入 *jms/NewMessage* 并选择 "Queue"（队列）作为目标类型。单击 "OK"（确定）。

image::images/maven-messagedestination.png[title=""Add Message Destination"（添加消息目标）对话框"]


[start=7]
. 确认项目目标正确无误。单击 "Next"（下一步）。

image::images/maven-newmdb.png[title="新建消息驱动 Bean 向导"]


[start=8]
. 接受 "Activation Config Properties"（激活配置属性）中的默认设置。单击 "Finish"（完成）。

单击 "Finish"（完成），此时 IDE 将生成 Bean 类，并添加以下标注（将该类标识为消息驱动 Bean）和配置属性。


[source,java]
----

@MessageDriven(mappedName = "jms/NewMessage", activationConfig =  {
        @ActivationConfigProperty(propertyName = "acknowledgeMode", propertyValue = "Auto-acknowledge"),
        @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue")
    })
public class NewMessage implements MessageListener {

    public NewMessage() {
    }

    @Override
    public void onMessage(Message message) {
    }
}
----

[start=9]
. 在类中添加以下带标注的字段，以将  ``MessageDrivenContext``  资源注入到类中。

[source,java]
----

public class NewMessage implements MessageListener {

*@Resource
private MessageDrivenContext mdc;*

----

[start=10]
. 添加以下带标注的字段（以粗体显示），以将实体管理器引入到类中。

[source,java]
----

public class NewMessage implements MessageListener {

@Resource
private MessageDrivenContext mdc;
*@PersistenceContext(unitName="com.mycompany_MavenEnterpriseApp-ejb_ejb_1.0-SNAPSHOTPU")
private EntityManager em;*
                   
----

 ``@PersistenceContext``  标注通过声明持久性单元来指定上下文。 ``unitName``  值是持久性单元的名称。


[start=11]
. 添加以下  ``save``  方法（以粗体显示）。

[source,java]
----

public NewMessage() {
}

@Override
public void onMessage(Message message) {
}

*private void save(Object object) {
    em.persist(object);
}*
----

[start=12]
. 在  ``onMessage``  方法主体中，添加以下内容（以粗体显示）以修改该方法：

[source,java]
----

public void onMessage(Message message) {
     *ObjectMessage msg = null;
     try {
          if (message instanceof ObjectMessage) {
          msg = (ObjectMessage) message;
              NewsEntity e = (NewsEntity) msg.getObject();
              save(e);
          }
     } catch (JMSException e) {
          e.printStackTrace();
          mdc.setRollbackOnly();
     } catch (Throwable te) {
          te.printStackTrace();
     }*
}
----

[start=13]
. 修复 import 语句（Ctrl-Shift-I 组合键；在 Mac 上为 ⌘-Shift-I 组合键）并保存所做的更改。

NOTE: 在生成 import 语句时，您需要确保导入 * ``jms`` * 和 * ``javax.annotation.Resource`` *。

有关消息驱动 Bean 的更多详细信息，请参见 link:http://download.oracle.com/javaee/6/tutorial/doc/index.html[+Java EE 6 教程第 I 部分+]中的link:http://download.oracle.com/javaee/6/tutorial/doc/gipko.html[+什么是消息驱动 Bean？+]一章。


=== 创建会话 Bean

在本练习中，将使用向导为 NewsEntity 实体类创建会话 Bean Facade。向导将生成  ``create`` 、 ``edit``  和  ``find``  方法，将通过 Web 应用程序项目中的 Servlet 访问这些方法。

1. 右键单击 EJB 模块，然后选择 "New"（新建）＞ "Other"（其他）。
2. 从 "Persistence"（持久性）类别中，选择 "Session Beans for Entity Classes"（实体类的会话 Bean），然后单击 "Next"（下一步）。
3. 从可用实体类的列表中选择 *ejb.NewsEntity*，然后单击 "Add"（添加）以将该类移动到 "Selected Entity Classes"（选定的实体类）窗格中。单击 "Next"（下一步）。
4. 选择 *ejb* 作为包。单击 "Finish"（完成）。

在单击 "Finish"（完成）后，IDE 将生成两个会话 Facade 类： ``AbstractFacade.java``  和  ``NewsEntityFacade.java`` ，后者用于扩展抽象 Facade 类。抽象 Facade 类用于定义几个常用于实体类的方法。

image::images/maven-sessionwizard.png[title="实体类的会话 Bean 向导"]


== 对 Web 应用程序进行编码

在此部分，将在 Web 应用程序项目中创建两个 Servlet。


=== 创建 ListNews Servlet

在本练习中，将创建用于显示发布的消息列表的 ListNews Servlet。将使用标注注入会话 Facade，并访问  ``findAll``  方法以检索发布的消息。

1. 右键单击 Web 模块项目，然后选择 "New"（新建）> "Servlet"。
2. 键入 *ListNews* 作为类名。
3. 键入 *web* 作为包名。单击 "Finish"（完成）。

单击 "Finish"（完成），此时将在源代码编辑器中打开类  ``ListNews.java`` 。


[start=4]
. 在源代码编辑器中的类定义之间右键单击，然后选择 "Insert Code"（插入代码）（Alt-Insert 组合键；在 Mac 上为 Ctrl-I 组合键）> "Call Enterprise Bean"（调用企业 Bean）。

[start=5]
. 在 "Call Enterprise Bean"（调用企业 Bean）对话框中，展开 "MavenEnterpriseApp-ejb" 节点，然后选择 "NewsEntityFacade"。单击 "OK"（确定）。

image::images/maven-callbean.png[title=""Call Enterprise Bean"（调用企业 Bean）对话框"]

在单击 "OK"（确定）时，将使用  ``@EJB``  标注将 EJB 资源注入到 Servlet 中。


[source,java]
----

@WebServlet(name = "ListNews", urlPatterns = {"/ListNews"})
public class ListNews extends HttpServlet {
    @EJB
    private NewsEntityFacade newsEntityFacade;
----

[start=6]
. 在  ``processRequest``  方法中，将以下代码行（以粗体显示）添加到方法主体中以修改该方法：

[source,xml]
----

out.println("<h1>Servlet ListNews at " + request.getContextPath () + "</h1>");
*
List news = newsEntityFacade.findAll();
for (Iterator it = news.iterator(); it.hasNext();) {
  NewsEntity elem = (NewsEntity) it.next();
  out.println(" <b>"+elem.getTitle()+" </b><br />");
  out.println(elem.getBody()+"<br /> ");
}
out.println("<a href='PostMessage'>Add new message</a>");
*
out.println("</body>");
   
----

NOTE: 如果您使用的是早期版本的 IDE，可能需要注释掉该代码。


[start=7]
. 修复 import 语句（Ctrl-Shift-I 组合键；在 Mac 上为 ⌘-Shift-I 组合键）并保存所做的更改。

在生成 import 语句时，您希望导入  ``java.util``  库。


=== 创建 PostMessage Servlet

在本练习中，您将创建用于传递消息的 PostMessage Servlet。您将使用标注向该 Servlet 中直接注入创建的 JMS 资源，从而指定变量名称及其映射到的名称。然后，您将添加用于发送 JMS 消息的代码，以及用于在 HTML 窗体中添加消息的代码。

1. 右键单击 Web 模块项目，然后选择 "New"（新建）> "Servlet"。
2. 键入 *PostMessage* 作为类名。
3. 选择 *web* 作为包名。单击 "Finish"（完成）。

单击 "Finish"（完成），此时将在源代码编辑器中打开类  ``PostMessage.java`` 。


[start=4]
. 在源代码编辑器中，添加以下字段声明以使用标注注入  ``ConnectionFactory``  和  ``Queue``  资源。

[source,java]
----

@WebServlet(name="PostMessage", urlPatterns={"/PostMessage"})
public class PostMessage extends HttpServlet {
   *@Resource(mappedName="jms/NewMessageFactory")
   private  ConnectionFactory connectionFactory;

   @Resource(mappedName="jms/NewMessage")
   private  Queue queue;*
----

[start=5]
. 修复 import 语句以导入 * ``javax.jms`` * 库。

image::images/maven-searchdepend1.png[title=""Fix All Imports"（修复所有导入）对话框"]

NOTE: 如果 IDE 未提供  ``javax.jms``  以供选择，您可以在资源库中搜索合适的工件，方法是：在  ``private ConnectionFactory connectionFactory;``  旁边的旁注中单击建议图标，然后选择 "Search Dependency at Maven Repositories"（在 Maven 资源库中搜索依赖关系）。

image::images/maven-searchdependencies.png[title="编辑器中用于在资源库中搜索依赖关系的提示"]

使用 "Search in Maven Repositories"（在 Maven 资源库中搜索）对话框，可以找到包含  ``ConnectionFactory``  的  ``javaee-api-6.0``  工件。

image::images/maven-searchdepend2.png[title=""Search in Maven Repositories"（在 Maven 资源库中搜索）对话框"]


[start=6]
. 添加以下代码以将 JMS 消息发送到  ``processRequest``  方法。

[source,java]
----

response.setContentType("text/html;charset=UTF-8");

*// Add the following code to send the JMS message
String title=request.getParameter("title");
String body=request.getParameter("body");
if ((title!=null) &amp;&amp; (body!=null)) {
    try {
        Connection connection = connectionFactory.createConnection();
        Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
        MessageProducer messageProducer = session.createProducer(queue);

        ObjectMessage message = session.createObjectMessage();
        // here we create NewsEntity, that will be sent in JMS message
        NewsEntity e = new NewsEntity();
        e.setTitle(title);
        e.setBody(body);

        message.setObject(e);
        messageProducer.send(message);
        messageProducer.close();
        connection.close();
        response.sendRedirect("ListNews");

    } catch (JMSException ex) {
        ex.printStackTrace();
    }
}*
----

[start=7]
. 为用于添加消息的 Web 窗体添加以下代码（以粗体显示）。

[source,xml]
----

out.println("Servlet PostMessage at " + request.getContextPath() + "</h1>");

*// The following code adds the form to the web page
out.println("<form>");
out.println("Title: <input type='text' name='title'><br/>");
out.println("Message: <textarea name='body'></textarea><br/>");
out.println("<input type='submit'><br/>");
out.println("</form>");
*
out.println("</body>");
    
----

NOTE: 如果您使用的是早期版本的 IDE，可能需要注释掉该代码。


[start=8]
. 修复导入并保存更改。

image::images/maven-jms-imports.png[title=""Fix All Imports"（修复所有导入）对话框"]

NOTE: 您需要为  ``Connection`` 、 ``ConnectionFactory`` 、 ``Session``  和  ``Queue``  导入 * ``javax.jms`` * 库。


== 使用 Maven 构建应用程序

现在，已完成了应用程序编码，接下来可以使用 Maven 构建企业应用程序。在此部分，将构建项目，并将其打包到 EAR 档案中。EAR 档案包含 EJB JAR 档案和 WAR 档案。在创建 EAR 档案后，您可以将该档案部署到目标服务器上。


=== 处理项目依赖关系

在本练习中，将检查 Web 项目的 POM ( ``pom.xml`` )，并修改该 POM，以防打包时将不必要的工件包含在 WAR 中。  每个 Maven 项目包含一个  ``pom.xml``  文件，其中包含档案内容的详细信息。项目所需的任何外部库都在 POM 中作为依赖关系列出。您可以修改 POM，以指定将档案打包时需要包含或应该排除的依赖关系。

在此应用程序中，EJB JAR 和 WAR 档案将打包到 EAR 档案中。如果查看 MavenEnterpriseApp-ear 项目的  ``pom.xml`` ，则可以看到 EJB 和 WAR 已声明为依赖关系。

image::images/maven-earpom.png[title="EAR 项目的 pom.xml"]

如果在编辑器中查看 Web 项目的  ``pom.xml`` ，则可以看到 EJB 档案已声明为依赖关系，而作用域已指定为  ``provided`` 。如果工件的作用域元素值为  ``provided`` ，则打包时将不包含该工件。Web 项目要求将 EJB 档案作为依赖关系，但对于此应用程序，您不希望在打包时将 EJB 档案包含在 WAR 中，因为 EJB 档案将作为 EAR 档案的一部分使用和提供。

image::images/maven-webpom.png[title="Web 应用程序项目的 pom.xml"]

可以在编辑器中打开  ``pom.xml`` ，然后单击 "Graph"（图形）标签以查看项目依赖关系的可视表示形式。如果您使用的是 IDE 的早期版本，则可以在编辑器中右键单击  ``pom.xml`` ，然后选择 "Show Dependency Graph"（显示依赖关系图形）。可以将光标放在工件上以显示包含工件详细信息的工具提示。

image::images/maven-webpomgraph.png[title="依赖关系图"]

执行以下步骤，修改 Web 项目的 POM，以便将  ``scope``  元素添加到  ``javaee-api``  工件的依赖关系中。

1. 展开 Web 项目下方的 "Project Files"（项目文件）节点。
2. 双击  ``pom.xml`` ，该文件在编辑器中打开。
3. 确认为  ``javaee-api``  工件的  ``<scope>``  值设置了  ``provided`` 。

如果此值不是  ``provided`` ，则您需要编辑 POM 以进行以下更改：


[source,xml]
----

<dependency>
    <groupId>javax</groupId>
    <artifactId>javaee-api</artifactId>
    <version>7.0</version>
    <type>jar</type>
    *<scope>provided</scope>*
</dependency>
----

可以在 POM 编辑器中使用代码完成功能帮助编辑该文件。

image::images/maven-addscope-javaee.png[title="POM 中作用域元素的代码完成"]

通过声明提供了依赖关系，在构建 WAR 档案时，Maven 将不打包该工件。


[start=4]
. 保存所做的更改。


=== 使用依赖关系构建

Maven 构建框架包含一系列特定的阶段，每个阶段包含一个或多个目标，可以配置这些阶段以使用各种不同的 Maven 插件。"Build with Dependencies"（使用依赖关系构建）菜单项将映射到 Maven 构建生命周期的  ``install``  阶段，并配置为使用 Reactor 插件。在弹出式菜单中选择 "Build with Dependencies"（使用依赖关系构建）时，Maven 将构建应用程序和任何所需的依赖关系，并将构建工件复制到本地资源库中。

可以在项目 "Properties"（属性）对话框的 "Actions"（操作）面板中修改将 Maven 阶段和目标映射到菜单操作的方式。

要构建 EAR 档案，请执行以下步骤。

* 右键单击 MavenEnterpriseApp-ear 项目节点，然后选择 "Build with Dependencies"（使用依赖关系构建）。

在使用 Reactor 插件构建 EAR 项目时，首先将构建作为 EAR 项目的依赖关系的子项目，然后再构建 EAR 项目。"Output"（输出）窗口将显示构建顺序。

image::images/maven-reactor1.png[title="显示反应器构建顺序的 "Output"（输出）窗口"]

还会在 "Output"（输出）窗口中显示构建结果。

image::images/maven-reactor2.png[title="显示反应器构建状态的 "Output"（输出）窗口"]

在构建 EAR 项目后，您可以在 "Files"（文件）窗口中的 EAR 项目节点下方的  ``target``  目录中看到最终的 EAR 档案。

image::images/maven-earfileswindow1.png[title="显示 EAR 档案的 "Files"（文件）窗口"]

如果使用默认工件名称  ``com.mycompany`` ，则可以在 "Maven Repository Browser"（Maven 资源库浏览器）中展开 "Local Repository"（本地资源库）中的  ``com.mycompany``  以查看构建工件。

有关构建 Maven 项目的详细信息，请参见 link:http://maven.apache.org[+maven.apache.org+] 上的 link:http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html[+Maven - Introduction to the Build Lifecycle+]（Maven - 构建生命周期简介）。


== 部署并运行应用程序

本节介绍了两种将 EAR 档案部署到服务器上的方法。可通过以下方法将应用程序部署到 GlassFish Server 上：使用 IDE 中的菜单操作或 GlassFish 管理控制台中的 "Deploy"（部署）工具。


=== 从 IDE 中部署并运行应用程序

在本练习中，将使用 "Run"（运行）操作，将 EAR 档案部署到 GlassFish Server。部署应用程序之后，将在浏览器中打开该应用程序的 ListNews 页，并添加一条消息。

1. 在 "Projects"（项目）窗口中右键单击 EAR 项目节点，然后选择 "Run"（运行）。

单击 "Run"（运行）后，IDE 将在服务器上部署 EAR 档案并创建 JMS 资源。IDE 将在浏览器中打开默认的项目索引页 (link:http://localhost:8080/MavenEnterpriseApp-web/[+http://localhost:8080/MavenEnterpriseApp-web/+])。


[start=2]
. 打开浏览器，访问下列 URL 以显示 ListNews 页。

link:http://localhost:8080/MavenEnterpriseApp-web/ListNews[+http://localhost:8080/MavenEnterpriseApp-web/ListNews+]。

第一次运行项目时，数据库为空，并且没有要显示的消息。

image::images/maven-browser1.png[title="在浏览器中打开的 ListNews 页"]


[start=3]
. 单击 "Add New Message"（添加新消息）。

[start=4]
. 在 PostMessage Servlet 的窗体中键入消息。单击 "Submit Query"（提交查询）。

image::images/maven-browser2.png[title="在浏览器中打开的 PostMessage 页"]

使用 PostMessage Servlet 添加消息时，会将该消息发送到消息驱动 Bean 以写入持久性存储，并且将调用 ListNews Servlet 以显示数据库中的消息。ListNews 检索到的数据库中消息的列表通常不包含新消息，因为消息服务是异步的。

默认情况下，对于将 GlassFish Server 指定为目标服务器的 Maven 项目，将启用 "Compile on Save"（在保存时编译）和 "Deploy on Save"（在保存时部署）。例如，如果修改并保存 Servlet，则可以在浏览器中重新加载该 Servlet 并查看所做的更改，而不用重新部署应用程序。


=== 从 GlassFish 管理控制台中部署

在本练习中，将使用 GlassFish 管理控制台中的 "Deploy"（部署）工具部署 EAR 档案。

1. 在 "Services"（服务）窗口中展开 "Servers"（服务器）节点。
2. 启动 GlassFish Server。
3. 右键单击 GlassFish Server 节点，然后选择 "View Admin Console"（查看管理控制台）以在浏览器中打开 GlassFish 管理控制台。
4. 在管理控制台的左窗格中，单击 "Applications"（应用程序）节点。
5. 在管理控制台的主窗格中，单击 "Deploy"（部署）按钮。
6. 单击 "Browse"（浏览）以查找企业应用程序的 EAR 档案。

EAR 档案位于本地系统上的企业应用程序目录的  ``target``  目录中。


[start=7]
. 单击 "OK"（确定）。

在单击 "OK"（确定）时，GlassFish 部署工具将部署应用程序。

NOTE: 如果在 GlassFish 管理控制台中使用部署工具部署应用程序，则还需要手动创建应用程序所需的资源（如不存在）。


== 下载解决方案项目

您可以采用下列方法下载本教程的解决方案（作为一个项目）。

* 下载link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252FMavenEnterpriseApp.zip[+已完成项目的 zip 档案文件+]。
* 通过执行以下步骤从 NetBeans 样例检出项目源代码：
1. 从主菜单中选择 "Team"（团队开发）> "Subversion" > "Checkout"（检出）。
2. 在 "Checkout"（检出）对话框中，输入以下资源库 URL：
 ``https://svn.netbeans.org/svn/samples~samples-source-code`` 
单击 "Next"（下一步）。

[start=3]
. 单击 "Browse"（浏览）以打开 "Browse Repostiory Folders"（浏览资源库文件夹）对话框。

[start=4]
. 展开根节点并选择 *samples/javaee/MavenEnterpriseApp*。单击 "OK"（确定）。

[start=5]
. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。

[start=6]
. 单击 "Finish"（完成）。

单击 "Finish"（完成），此时 IDE 会将本地文件夹初始化为 Subversion 资源库，并检出项目源代码。


[start=7]
. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。

NOTE: 有关安装 Subversion 的更多信息，请参见 link:../ide/subversion.html[+NetBeans IDE 中的 Subversion 指南+]中有关link:../ide/subversion.html#settingUp[+设置 Subversion+] 的部分。


link:/about/contact_form.html?to=3&subject=Feedback:%20Creating%20an%20Enterprise%20Application%20Using%20Maven[+发送有关此教程的反馈意见+]


== 另请参见

有关使用 NetBeans IDE 开发 Java EE 应用程序的更多信息，请参见以下资源：

* link:javaee-intro.html[+Java EE 技术简介+]
* link:javaee-gettingstarted.html[+Java EE 应用程序入门指南+]
* link:maven-entapp-testing.html[+测试 Maven 企业应用程序+]
* link:../../trails/java-ee.html[+Java EE 和 Java Web 学习资源+]

您可以在 link:http://download.oracle.com/javaee/7/tutorial/doc/[+Java EE 7 教程+]中找到有关使用 企业 Bean 的详细信息。

要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况，请link:../../../community/lists/top.html[+加入 nbj2ee 邮件列表+]。