Java企业项目开发指南

### Java企业项目开发指南 #### 1. 服务定位器与数据库连接修改 在Java企业项目中，为了更方便地获取数据库连接，我们可以使用服务定位器。首先，在bean中添加一个私有的服务定位器成员变量和几个查找方法： ```java private com.pronetbeans.examples.ejb.PnbServiceLocator serviceLocator; private com.pronetbeans.examples.ejb.PnbServiceLocator getServiceLocator() { if (serviceLocator == null) { serviceLocator = new com.pronetbeans.examples.ejb.PnbServiceLocator(); } return serviceLocator; } private DataSource getJdbcPNBDataSource() throws NamingException { return (DataSource) getServiceLocator().getDataSource("java:comp/env/jdbc/PNBDataSource"); } ``` 然后，修改`OrderMessage.onMessage`方法中获取数据库连接的代码，将： ```java conn = jdbcPNBDataSource.getConnection(); ``` 修改为： ```java conn = getJdbcPNBDataSource().getConnection(); ``` 这样修改后，代码会先获取服务定位器`PnbServiceLocator`，再通过它获取指定的数据源。其他需要数据库访问的bean也可以使用同一个服务定位器类。 #### 2. 创建企业应用客户端项目 企业应用客户端项目是将Web应用和EJB模块编译后作为Java EE应用部署的项目。它可以将各种企业应用组件打包在一起，包含配置文件、资源和源代码，并部署到应用服务器上。其主要优点是可以使用企业应用特有的服务器资源，如安全角色、组等。 ##### 2.1 从新创建项目 在NetBeans中创建新的企业应用客户端项目，可按以下步骤操作： 1. 从主菜单中选择`File ➤ New Project`。 2. 在`New Project`窗口中，从左侧的类别中选择`Enterprise`，从右侧的项目类型列表中选择`Enterprise Application Client`，然后点击`Next`按钮。 3. 在`Name and Location`窗口中，输入项目名称和位置。 4. 如果`Projects`窗口中有打开的企业应用项目，`Add to Enterprise Application`下拉列表将可用，你可以选择一个可用的企业应用项目与客户端项目关联。 5. 在相应字段中指定服务器和Java EE版本（本章示例使用Sun Java System Application Server和Java EE 5）。 6. 指定包结构和主类的名称。 7. 由于选择了Java EE 5，确保选中`Use JDK 1.5 and Set Source Level to 1.5`复选框。 8. 选择是否将该项目设置为NetBeans中的主项目。 9. 点击`Finish`完成向导。 项目生成后会显示在`Projects`窗口中，主类会在源编辑器中打开。 ##### 2.2 从现有源创建项目 也可以从现有源创建企业应用客户端项目，步骤如下： 1. 从主菜单中选择`File ➤ New Project`。 2. 在`New Project`窗口中，从左侧的类别中选择`Enterprise`，从右侧的项目类型列表中选择`Enterprise Application Client with Existing Sources`，然后点击`Next`按钮。 3. 填写`Name and Location`窗口，然后点击`Next`按钮。 4. 在`Existing Sources`窗口中，指定配置文件文件夹的路径。可以使用`Configuration Files Folder`字段旁边的`Browse`按钮浏览现有源代码目录，选择正确的位置。 5. 在`Libraries Folder`字段中，选择包含现有项目JAR文件的目录。 6. 对于`Source Package Folders`字段，可以使用`Add Folder`按钮选择项目结构下的`src/java`目录。 7. 对于`Test Package Folders`字段，可以使用`Add Folder`按钮指定项目结构中的测试目录。 8. 设置好目录路径和文件夹的值后，点击`Finish`按钮。 现有项目代码将被导入并添加到新项目中，新项目将在NetBeans中打开并显示在`Projects`窗口中。 #### 3. 验证企业项目 NetBeans的验证工具可以验证Java EE模块的正确性。它会分析部署描述符中声明的依赖关系，确定是否存在可能导致应用部署后失败的问题。 要验证企业项目，可在`Projects`窗口中右键单击项目名称，选择`Verify Project`。输出窗口将显示一系列操作，如编译和构建项目模块。验证工具会在窗口中打开并显示项目验证结果。 如果尝试验证新的企业应用项目或EJB模块项目，可能会收到失败通知。验证工具中会出现一个状态为“Error”的项目，包含测试描述和结果。如果在网格中选择该行项目，详细结果将显示在窗口底部。错误信息表明项目无效，因为它至少不包含一个会话、实体或消息驱动bean。 验证工具顶部有几个显示选项。默认设置`All Results`会显示所有状态为`Pass`、`Not Applicable`、`Error`等的项目。另外两个选项允许你只显示错误或错误和警告。 #### 4. 持久化操作 在EJB 3.0规范之前，在企业应用中使用Java持久化技术较为复杂和重量级。Java社区尝试使用Hibernate等轻量级框架来缓解这些问题。当EJB 3.0规范最终确定时，Java持久化API（JPA）也随之定义。 JPA定义了一种使用轻量级持久化对象的机制，这些对象可以在数据库中进行检索、插入、更新或删除操作。使用JPA的一个最大好处是不需要EJB模块或企业项目。由于JPA使用Java 5注解来定义对象关系映射属性，因此可以在任何Java项目中使用它。 NetBeans为Java 5注解和JPA提供了全面支持，还提供了几个非常有用的向导来创建持久化类。你可以创建一个代表数据库表数据的实体类，也可以使用NetBeans生成一组在应用中使用持久化实体类的网页。 ##### 4.1 创建持久化单元 持久化单元定义了使用JPA的应用如何保存其数据。它定义了数据源、事务类型和持久化提供程序（基本上是一个驱动库）。可以使用NetBeans在几乎任何类型的Java项目中创建新的持久化单元。 创建新的持久化单元的步骤如下： 1. 在`Projects`窗口中右键单击项目，选择`New ➤ File/Folder`。 2. 在`New File`窗口中，从类别列表中选择`Persistence`，从文件类型列表中选择`Persistence Unit`，然后点击`Next`按钮。 3. 在`Provider and Database`窗口中，指定持久化单元的名称。默认情况下，`Persistence Unit Name`字段会显示一个建议值，即在项目名称后面加上`PU`。 4. 选择一个持久化提供程序。`Persistence Provider`下拉列表显示了各种提供程序，默认选择`TopLink`提供程序，但你可以选择其他列出的提供程序或定义一个新的提供程序。 5. 指定要使用的数据源。`Data Source`下拉列表允许你选择之前在NetBeans中定义的数据源供持久化单元使用。你也可以通过选择`New Data Source`来创建一个新的数据源。出现的`Create Data Source`对话框会提示你输入新数据源的名称并选择一个现有的数据库连接。 6. 如果选中`Use Java Transaction APIs`复选框，数据源需要支持Java事务API。 7. `Table Generation Strategy`选择项指定与实体类关联的表是创建、删除并创建还是根本不创建。 8. 点击`Finish`按钮创建持久化单元。 `persistence.xml`文件会在`Projects`窗口的`Configuration Files`节点下创建，并在`persistence.xml`可视化编辑器中打开。 ##### 4.2 理解persistence.xml文件 `persistence.xml`文件包含了你在创建持久化单元时在新文件向导中指定的持久化配置数据。`persistence.xml`可视化编辑器允许你修改`persistence.xml`文件中的字段，而无需手动编辑XML内容。 可视化编辑器允许你选择与新持久化单元向导的`Provider and Database`窗口中出现的许多相同字段。你可以修改持久化单元的名称、更改持久化提供程序并选择不同的数据源。你还可以更改`Use Java Transaction APIs`和`Table Generation Strategy`字段的选择。 可视化编辑器下半部分有一个名为`Include All Entity Classes in “AppName” Module`的复选框。如果选中此选项，项目中的所有实体类都将包含在持久化单元中。如果未选中，则必须使用其下方的`Include Entity Classes`字段指定特定的实体类。 编辑器窗口顶部持久化单元名称旁边的减号图标表示一个类似代码折叠的部分折叠功能。点击减号图标，持久化单元的整个部分将被隐藏，图标会变成加号图标。点击加号图标，持久化单元字段将再次显示。 编辑器右上角有`Add`和`Remove`按钮。`Remove`按钮允许你从`persistence.xml`文件中删除持久化单元定义。`Add`按钮允许你创建一个新的持久化单元并添加到`persistence.xml`文件中。你