创建实体类

在本练习中，将使用“新建实体类”向导创建简单的持久性实体类。您还会使用该向导创建持久性单元，以定义应用程序中使用的数据源和实体管理器。将在类中添加一个字段以表示表中的数据，并为新字段生成 getter 和 setter。

实体类必须具有一个主键。在使用向导创建实体类时，IDE 将缺省生成 id 字段，并使用 @Id 标注来标注该字段以将其声明为主键。IDE 还会添加 @GeneratedValue 标注并指定主 id 字段的键生成策略。

在项目中使用 Java 持久性可以大大简化应用程序的开发，因为不需要配置部署描述符为持久性字段或属性提供对象关系映射信息。您可以使用标注直接在简单的 Java 类中定义这些属性。

实体持久性是通过 EntityManager API 来管理的。EntityManager API 用于处理持久性上下文，而每个持久性上下文是一组实体实例。开发应用程序时，您可以在类中使用标注来指定实体实例的持久性上下文实例。然后通过容器处理实体实例的生命周期。

要创建实体类，请执行以下步骤：

1. 右键单击项目节点，然后选择“新建”>“其他”。
2. 从“持久性”类别中选择“实体类”。单击“下一步”。
3. 键入 Message 作为类名。
4. 键入 entities 作为包名。
5. 单击“创建持久性单元”。

   注意：在 NetBeans IDE 6.9 中，创建持久性单元的步骤将合并到了“新建实体类”向导中。

6. 选择数据源（例如，如果要使用 JavaDB，则选择 "jdbc/sample"）。

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

   您可以保留其他缺省选项（持久性单元名称、EclipseLink 持久性提供器）。确保持久性单元将使用 Java 事务 API，并且已将“表生成策略”设置为“创建”，以便在部署应用程序时将创建基于实体类的表。

7. 在新建持久性单元向导中单击“创建”。
   
8. 在“新建实体类”向导中单击“完成”。

   在单击“完成”时，IDE 将创建实体类并在编辑器中打开该类。您可以看到 IDE 生成了 id 字段 private Long id; 并使用 @Id 和 @GeneratedValue(strategy = GenerationType.AUTO) 标注该字段。

9. 在编辑器中，将 message 字段（以粗体显示）添加到 id 字段下面。

   private Long id;
   private String message;

10. 在编辑器中单击鼠标右键，选择“插入代码 (Ctrl+I)”，然后选择“getter 和 setter”。
11. 在“生成 getter 和 setter”对话框中，选择 message 字段，然后单击“生成”。

    IDE 将为 message 字段生成 getter 和 setter 方法。

    
12. 保存所做的更改。

实体类表示数据库中的表。在运行此应用程序时，将自动创建 Message 的数据库表。该表包含 id 和 message 列。

如果在 XML 编辑器中查看持久性单元，则可以看到应用程序将使用 Java 事务 API (Java Transaction API, JTA) (transaction-type="JTA")。这指定了在持久性上下文中管理实体生命周期的责任将分配给容器。这可减少所需的代码，因为实体生命周期是由容器而不是应用程序管理的。有关使用 JTA 管理事务的更多信息，请参见 Java 事务 API 文档。

创建会话 Facade

在本练习中，将使用向导为 Message 实体创建无状态会话 Facade。EJB 3.1. 规范指出，会话 Bean 的业务接口现在是可选的。在此应用程序中，访问该 Bean 的客户端是本地客户端，您可以选择使用本地接口或无接口视图公开该 Bean。

要创建会话 Bean，请执行以下步骤：

1. 右键单击项目节点，然后选择“新建”>“其他”。
2. 从 "Java EE" 类别中选择“实体类的会话 Bean”。单击“下一步”。
3. 选择 Message 实体，然后单击“添加”。单击“下一步”。
4. 键入 boundary 作为包名。单击“完成”。

   请注意，无需为会话 Bean 创建业务接口。相反，在此应用程序中，将使用无接口视图向本地受管 Bean 公开该 Bean。

   

单击“完成”时，会创建会话 Facade 类 MessageFacade.java，并在源代码编辑器中打开该类。该 Bean 类包含业务逻辑并管理实体管理器。正如在生成的代码中所看到的一样，@Stateless 标注用于将类声明为无状态会话 Bean 组件。

注意：在 NetBeans IDE 6.9 中，向导将生成一个 AbstractFacade 类，其中包含扩展 AbstractFacade 的实体的业务逻辑和 Facade 类。

@Stateless
public class MessageFacade {
    @PersistenceContext(unitName = "SimpleEE6AppPU")
    private EntityManager em;
            

在使用向导为实体创建 Facade 时，IDE 将缺省添加 PersistenceContext annotation 标注 (@PersistenceContext(unitName = "SimpleEE6AppPU"))，以便将实体管理器资源注入会话 Bean 组件并指定持久性单元名称。在本示例中，将显式声明持久性单元的名称；但如果应用程序只有一个持久性单元，则该名称是可选的。

IDE 还会在 Facade 中生成方法以创建、编辑、删除和查找实体。实体管理器 API 定义了用于与持久性上下文交互的方法。您可以看到 IDE 生成了一些常用的缺省查询方法，可使用这些方法查找实体对象。

public List<Message> findAll() {
    CriteriaQuery cq = em.getCriteriaBuilder().createQuery();
    cq.select(cq.from(Message.class));
    return em.createQuery(cq).getResultList();
}

public List<Message> findRange(int[] range) {
    CriteriaQuery cq = em.getCriteriaBuilder().createQuery();
    cq.select(cq.from(Message.class));
    Query q = em.createQuery(cq);
    q.setMaxResults(range[1] - range[0]);
    q.setFirstResult(range[0]);
    return q.getResultList();
}

public int count() {
    CriteriaQuery cq = em.getCriteriaBuilder().createQuery();
    Root<Message> rt = cq.from(Message.class);
    cq.select(em.getCriteriaBuilder().count(rt));
    Query q = em.createQuery(cq);
    return ((Long) q.getSingleResult()).intValue();
}

findAll、findRange 和 count 方法使用条件 API 中定义的方法来创建查询。条件 API 是 JPA 2.0 规范的一部分，它包含在 Java EE 6 规范中。

创建受管 Bean

在本练习中，将创建一个用于访问会话 Facade 的简单 JSF 受管 Bean。JSF 2.0 规范（是 Java EE 6 的一部分）允许在 Bean 类中使用标注将类标识为 JSF 受管 Bean，以及指定范围和 Bean 名称。

要创建受管 Bean，请执行以下步骤：

1. 右键单击项目节点，然后选择“新建”>“其他”。
2. 从 JavaServer Faces 类别中选择“JSF 受管 Bean”。单击“下一步”。
3. 键入 MessageView 作为类名。

   在调用受管 Bean 中的方法时，将使用 Bean 名称 MessageView 作为 JSF 页 index.xhtml 中的 inputText 和 commandButton 的值。

4. 键入 my.presentation 作为包名。
5. 键入 MessageView 作为将用于受管 Bean 的名称。

   在使用向导创建受管 Bean 时，IDE 将缺省基于 Bean 类的名称为该 Bean 指定名称。

6. 将“范围”设置为 "request"。单击“完成”。

单击“完成”后，IDE 将创建 Bean 类并在编辑器中打开该类。在“项目”窗口中，将会看到以下文件。

在编辑器中，您可以看到 IDE 添加了 @ManagedBean 和 @RequestScoped 标注以及 Bean 名称。

@ManagedBean(name="MessageView")
@RequestScoped
public class MessageView {

    /** Creates a new instance of MessageView */
    public MessageView() {
    }

}

现在，将添加 @EJB 标注，以使用依赖关系注入获取对 MessageFacade 会话 Bean 的引用。还会调用在会话 Facade 中公开的 findAll 和 create 方法。在键入这些方法时，IDE 的代码完成功能可为您提供帮助。

1. 在编辑器中单击鼠标右键，然后选择“插入代码 (Ctrl+I)”以打开弹出式菜单。
2. 在弹出式菜单中选择“调用企业 Bean”。
3. 在“调用企业 Bean”对话框中选择 "MessageFacade"。单击“确定”。
   

   在单击“确定”时，IDE 将添加以下代码（以粗体显示）以注入该 Bean。

   public class MessageView {
   
       /** Creates a new instance of MessageView */
       public MessageView() {
       }
   
       // Injects the MessageFacade session bean using the @EJB annotation
       @EJB
       MessageFacade messageFacade;
   }
   

4. 添加以下代码以创建新实例。

   /** Creates a new instance of MessageView */
       public MessageView() {
          this.message = new Message();
       }

5. 在该类中添加以下代码：

       // Creates a new field
       private Message message;
   
   
       // Calls getMessage to retrieve the message
       public Message getMessage() {
          return message;
       }
   
       // Returns the total number of messages
       public int getNumberOfMessages(){
          return messageFacade.findAll().size();
       }
   
       // Saves the message and then returns the string "theend"
       public String postMessage(){
          this.messageFacade.create(message);
          return "theend";
       }
   

6. 修复导入 (Ctrl-Shift-I) 并保存更改。

可以在编辑器中使用代码完成功能帮助键入代码。

请注意，postMessage 方法将返回 "theend" 字符串。JSF 2.0 规范允许在使用 Facelets 技术的应用程序中使用隐式导航规则。在此应用程序中，没有在 faces-config.xml 中配置任何导航规则。导航处理程序将尝试在应用程序中查找合适的页面。在这种情况下，在调用 postMessage 方法时，导航处理程序将尝试查找名为 theend.xhtml 的页面。

修改索引页

在本练习中，将对 index.xhtml 页面进行简单的更改以添加一些 UI 组件。将在窗体中添加输入文本字段和按钮。

1. 在编辑器中打开 index.xhtml。
2. 修改该文件，在 <h:body> 标记之间添加以下简单窗体。

   <h:body>
       <f:view>
           <h:form>
               <h:outputLabel value="Message:"/><h:inputText value="#{MessageView.message.message}"/>
               <h:commandButton action="#{MessageView.postMessage}" value="Post Message"/>
           </h:form>
       </f:view>
   </h:body>

   在键入代码时，JSF 代码完成功能可为您提供帮助。

   
3. 保存所做的更改。

inputText 和 commandButton 组件将在命名 JSF 受管 Bean MessageView 中调用方法。postMessage 方法返回 "theend"，导航处理程序将查找名为 theend.xhtml 的页面。

创建结果页

在本练习中，将创建 JSF 页 theend.xhtml。当用户在 index.xhtml 中单击 "Post Message" 按钮并在 JSF 受管 Bean 中调用 postMessage 方法时，将显示该页面。

1. 右键单击项目节点，然后选择“新建”>“其他”。
2. 从 JavaServer Faces 类别中选择“JSF 页”。单击“下一步”。
3. 键入 theend 作为文件名。
4. 确保选择了 "Facelets" 选项。单击“完成”。
5. 在 <h:body> 标记之间键入以下内容以修改该文件。

   <h:body>
       <h:outputLabel value="Thanks! There are "/>
       <h:outputText value="#{MessageView.numberOfMessages}"/>
       <h:outputLabel value=" messages!"/>
   </h:body>

在开始键入时，IDE 自动在文件中为 JSF 元素添加 xmlns:h="http://java.sun.com/jsf/html 标记库定义。