Eclipse + Jboss AS 7.1 创建 EJB3.0之JPA工程（下）

8. 创建 Session Bean 和 Bean Interface

---

• 右击ejbModule -> New -> Session Bean (EJB 3.x)

  

• 输入包名com.ibytecode.businesslogic

• 输入类名ProjectBean
• 选择状态为Stateless
• 选择Remote Business Interface并输入com.ibytecode.business.IProject
• business interface将会在另一个包（com.ibytecode.business）中生成

• 点击Finish

  

9. 编写 Bean 和 Interface

---

• 打开“Bean Interface”并且复制下面的代码
• Interface 可以是 @Remote或者@Local。这里，我们选择@Remote （Remote 与 Local 的区别）


  package com.ibytecode.business;
  import java.util.List;
  import javax.ejb.Remote;
  
  import com.ibytecode.entities.Project;
  
  @Remote
  public interface IProject {
      void saveProject(Project project);
      Project findProject(Project project);
      List<Project> retrieveAllProjects();
  }

• 打开 Bean 并复制下面的代码
• Bean 类型可以是 @Stateful 或 @Statess，这里使用@Statess （Stateful 与 Statess 的区别）
  

  package com.ibytecode.businesslogic;
  
  import java.util.List;
  import javax.ejb.Stateless;
  import javax.persistence.EntityManager;
  import javax.persistence.PersistenceContext;
  import javax.persistence.Query;
  
  import com.ibytecode.business.IProject;
  import com.ibytecode.entities.Project;
  
  @Stateless
  public class ProjectBean implements IProject {
  
      @PersistenceContext(unitName = "JPADB")
      private EntityManager entityManager;
      
      public ProjectBean() {   }
  
      @Override
      public void saveProject(Project project) {
          entityManager.persist(project);
      }
  
      @Override
      public Project findProject(Project project) {
          Project p = entityManager.find(Project.class, project.getPnumber());
          return p;
      }
  
      @Override
      public List<Project> retrieveAllProjects() {
          
          String q = "SELECT p from " + Project.class.getName() + " p";
          Query query = entityManager.createQuery(q);
          List<Project> projects = query.getResultList();
          return projects;
      }
  }

  　　
• 下一步，我们将配置数据源

10. Persistence.xml

---

server是如何知道，EntityManager API 应该在哪个数据库 save / update / query 实体对象？（因为在Jboss 中配置的数据源可能有多个，我们这里就要指定standalone.xml 中配置的某个 'datasource jndi-name'）
“persistence.xml”文件可以完整且灵活的配置 EntityManager
“persistence.xml”是 JPA 中一个标准的配置文件，应该被放置在META-INF目录下。在该文件中应该定义一个persistence unit节点并设置一个唯一的name属性，该name属性将被EntityManager使用。
右击META-INF -> New -> Other -> XML -> XML file，输入文件名persistence.xml，并粘贴如下内容：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
    <persistence-unit name="JPADB">
    <jta-data-source>java:/MySQLDS</jta-data-source>
        <properties>
            <property name="showSql" value="true"/>
            <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect" />
        </properties>
    </persistence-unit>
</persistence>

在JBoss AS中，默认的JPA provider是Hibernate，jta-data-source指向此持久元映射到的数据库的JNDI名称。java:/MySQLDS指向MySQL DB数据源。我们将在下一步设置这个数据源。

11. 在JBoss AS 7中配置MySQL数据源

---

1.1. 下载 MySQL connector

---

点此链接下载，解压得到MySQL Connector J JAR.

11.2. 向AS 7中添加Module

---

AS 7 通过module体系来实现类的独立加载，我们需要创建一个新的包含 “MySQL Connector J JAR”文件的模块.
在你的 AS 7 的根目录下，按照modules/com/mysql/main的层次建立文件夹，然后复制“MySQL Connector J JAR”文件到main文件中。
然后在XML文件中定义此模块，新建module.xml并粘贴下面的代码：

<?xml version="1.0" encoding="UTF-8"?>

<module xmlns="urn:jboss:module:1.0" name="com.mysql">
  <resources>
    <resource-root path="mysql-connector-java-5.1.18-bin.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
  </dependencies>
</module>

注意：
这个新的模块目录包含了以下内容：

- module.xml
- mysql-connector-java-5.1.18-bin.jar

JAR文件的名称根据实际进行修改

JAR的版本高于（包括）5.5.30会在后面出现问题

11.3. 创建驱动引用

---

现在，我们需要在main应运服务器的配置文件（standalone.xml，路径：JBossAS_Home/standalone/configuration）中建立对module的引用。
找到<drivers>元素，并添加新的驱动：

<drivers>
    <driver name="mysqlDriver" module="com.mysql">
        <xa-datasource-class>
            com.mysql.jdbc.Driver
        </xa-datasource-class>
    </driver>
</drivers>

11.4. 向驱动添加数据源

---

打开应运服务器配置文件“standalone.xml”，找到<datasources>元素并添加新的数据源：

<datasource jndi-name="java:/MySQLDS" 
    pool-name="MySQLDS" enabled="true" use-java-coMD2ntext="true">
    <connection-url>
        jdbc:mysql://localhost:3306/YOUR-DATABASE-NAME
    </connection-url>
    <driver>mysqlDriver</driver>
    <security>
        <user-name>YOUR-MYSQL-USERNAME</user-name>
        <password>YOUR-MYSQL-PASSWORD</password>
    </security>
</datasource>

注意：

再上面的代码中，使用你的 database 名称，MySQL的 username 和 password.

在<datasources>元素中，jndi-name=”java:/MySQLDS”应该和“persistence.xml”中的java:/MySQLDS匹配.

<driver>mysqlDriver</driver>应该和“persistence.xml”中的<drivers><driver name=”mysqlDriver” …>…</driver></drivers>匹配

现在，我们尝试启动 JBOSS ，如果出现以下异常：

 ERROR [org.jboss.as.controller.management-operation] (ServerService Thread Pool -- 29) JBAS014612: Operation ("add") failed - address: ([
    ("subsystem" => "datasources"),
    ("jdbc-driver" => "mysqlDriver")

　　..........

解决方法：

1. 5.1.30 版本的 mysql-connector-java-x.x.xx-bin.jar

2. 在 standalone.xml 的 <datasources> 下的 <drivers> 下添加:

　　<driver-class>com.mysql.jdbc.Driver</driver-class>

12. 部署 EJB JPA project

---

在server上部署“FirstJPAProject”工程有两种方法：

1. 右键 EJB project -> "Run As" -> "Run On Server". 选择 "JBoss 7.1 Runtime Server", 点击 "Finish".
2. 在 "Servers" 视图中右键 "JBoss 7.1 Runtime Server" -> "Add and Remove…" ->选择EJB JAR文件 -> "Add" -> "Finish".

你也可以从Jboss的管理后台部署EJB组件：

　　1. 右键 EJB project -> "Export" . 选择 "EJB Jar file", 输入保存路径，点击 "Finish".

　　2. 进入 Jboss 后台: "1ocalhost:8080"，选择"Administration Console"

　　3."Manage Deployments" -->"Add Content"，选择"jar"文件，完成，并将状态设置为"Enable"。

13. 启动/重启 服务器

---

右键 “JBoss 7.1 Runtime Server” 点击 “start”，如果JNDI 映射和和部署都是正确的，你将在控制台看到下面一句话：

Deployed "FirstJPAProject.jar"

14. 创建 Client

---

• 接下来的这一步我们将写一个远程的 Java client application (with main()) 访问和调用部署在服务器上的 Bean
• Client 使用 JNDI 技术查找 Bean 的代理服务器并调用其方法。

14.1. 创建 JNDI InitialContext

---

通过 InitialContext 获得 Context

• 所有的命名服务操作都是在“javax.naming.Context”的接口的实现者上进行的。因此，和命名服务器开始交互的起点是：通过提供给服务器启动服务所需的明确的属性来获得上下文。在我们的示例中，就是Jboss应用服务器。（原文是“All naming service operations are performed on some implementation of the javax.naming.Context interface. Therefore, the starting point of interacting with the naming service is to obtain a Context by providing the properties specific to the server implementation being used. In our case it is, JBoss Application Server.）（点此了解 javax.Naming 软件包）
• 为了产生一个 javax.naming.InitialContext，我们需要用 properties 从环境中初始化它。JNDI 通过下面两个来源来校验property的值
  • 使用 InitialContext 的带参构造方法，取决于所提供的环境
  • 在 classpath 中的 jndi.properties 源文件

注意：这里我们将使用第一种方法

对于 JBoss AS 7，我们需要设置“Context.URL_PKG_PREFIXES”属性为“org.jboss.ejb.client.naming” 来得到 InitialContext 。

下面的工具类可以产生 JBoss AS 上的 InitialContext，并且可以被所有的 application 重用。否则，在所有的 client 中都要复制代码。

• 右键 ejbModule -> New -> Class
• 输入包名 com.ibytecode.clientutility
• 输入类名 JNDILookupClass
• 点击 Finish

复制下面的代码：

package com.ibytecode.clientutility;

import java.util.Properties;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;

public class JNDILookupClass {

    private static Context initialContext;

    private static final String PKG_INTERFACES = "org.jboss.ejb.client.naming";

    public static Context getInitialContext() throws NamingException {
        if (initialContext == null) {
            Properties properties = new Properties();
            properties.put(Context.URL_PKG_PREFIXES, PKG_INTERFACES);

            initialContext = new InitialContext(properties);
        }
        return initialContext;
    }
}

14.2. 创建 client class

---

• 右键 ejbModule -> New -> Class
• 输入包名 com.ibytecode.client
• 输入类名 EJBApplicationClient
• 勾选 main() 方法选项
• 点击 Finish

复制下面的代码：

package com.ibytecode.client;

import java.util.List;

import javax.naming.Context;
import javax.naming.NamingException;

import com.ibytecode.business.IProject;
import com.ibytecode.businesslogic.ProjectBean;
import com.ibytecode.clientutility.JNDILookupClass;
import com.ibytecode.entities.Project;

public class EJBApplicationClient {
    
    public static void main(String[] args) {
        IProject bean = doLookup();
        
        Project p1 = new Project();
        p1.setPname("Banking App");
        p1.setPlocation("Town City");
        p1.setDeptNo(1);
        
        Project p2 = new Project();
        p2.setPname("Office Automation");
        p2.setPlocation("Downtown");
        p2.setDeptNo(2);

        // 4. Call business logic
        //Saving new Projects
        bean.saveProject(p1);
        bean.saveProject(p2);
        
        //Find a Project
        p1.setPnumber(1);
        Project p3 = bean.findProject(p1);
        System.out.println(p3);
        
        //Retrieve all projects
       System.out.println("List of Projects:");
        List<Project> projects = bean.retrieveAllProjects();
        for(Project project : projects)
            System.out.println(project);
        
        
    }

    private static IProject doLookup() {
        Context context = null;
        IProject bean = null;
        try {
            // 1. Obtaining Context
            context = JNDILookupClass.getInitialContext();
            // 2. Generate JNDI Lookup name
            String lookupName = getLookupName();
            // 3. Lookup and cast
            bean = (IProject) context.lookup(lookupName);

        } catch (NamingException e) {
            e.printStackTrace();
        }
        return bean;
    }

    private static String getLookupName() {
        /*The app name is the EAR name of the deployed EJB without .ear 
        suffix. Since we haven't deployed the application as a .ear, the app 
        name for us will be an empty string */
        String appName = "";

        /* The module name is the JAR name of the deployed EJB without the 
        .jar suffix.*/
        String moduleName = "FirstJPAProject";

        /* AS7 allows each deployment to have an (optional) distinct name. 
        This can be an empty string if distinct name is not specified.*/
        String distinctName = "";

        // The EJB bean implementation class name
        String beanName = ProjectBean.class.getSimpleName();

        // Fully qualified remote interface name
        final String interfaceName = IProject.class.getName();

        // Create a look up string name
        String name = "ejb:" + appName + "/" + moduleName + "/" + 
                distinctName     + "/" + beanName + "!" + interfaceName;
        return name;
    }
}

14.3. 配置 EJB 客户端上下文属性

---

一个 EJB 客户端上下文包含了执行远程 EJB 调用的上下文环境信息。他是一个 JBoss AS 特有的 API。一个 EJB 客户端上下文可以和多个 EJB 接收者关联在一起，每个 EJB 接收者可以处理多个 EJB 调用
每个 EJB 接收者都知道它可以操作的 EJB 集合，每个 EJB 接收者都知道使用哪个 server 目标来处理对 Bean 的调用。server 的IP地址和远程服务端口应该在放置在客户端 classpath 的 properties file 中明确给出。然后这个 properties file (EJB client context) 会被 JNDI 的实现类内部使用，去执行在 Bean 代理服务器上的调用。

在应用程序的 classpath 中创建一个“jboss-ejb-client.properties” 文件，我们可以把它放在应用程序的 ejbModule 文件夹下，该文件中包含以下属性：

    remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED=false
    remote.connections=default
    remote.connection.default.host=localhost
    remote.connection.default.port = 4447
    remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS=false
　remote.connection.default.username =YOUR_JBOSS_COSOLE_USERNAME
　remote.connection.default.password =YOUR_JBOSS_COSOLE_PASSWORD

14.4. 给 client 添加所需的 JAR 文件来运行客户端程序

---

• 在Run菜单或Run图标中打开`Run Configurations…

  

• 在左面板中Java Application的下面选择客户端应用程序(EJBApplicationClient)，然后打开classpath标签。（如果你没有看见你的客户端应用程序，先运行一遍它。）选择User Entries然后点击“Add External JARs”。
  

• 添加下面的 JAR 文件(jboss 7不需要)

JAR 名称	位置
jboss-transaction-api_1.1_spec-1.0.0.Final.jar	AS7_HOME/modules/javax/transaction/api/main/
jboss-ejb-api_3.1_spec-1.0.1.Final.jar	AS7_HOME/modules/javax/ejb/api/main/
jboss-ejb-client-1.0.0.Beta10.jar	AS7_HOME/modules/org/jboss/ejb-client/main/
jboss-marshalling-1.3.0.GA.jar	AS7_HOME/modules/org/jboss/marshalling/main/
xnio-api-3.0.0.CR5.jar	AS7_HOME/modules/org/jboss/xnio/main/
jboss-remoting-3.2.0.CR6.jar	AS7_HOME/modules/org/jboss/remoting3/main/
jboss-logging-3.1.0.Beta3.jar	AS7_HOME/modules/org/jboss/logging/main/
xnio-nio-3.0.0.CR5.jar	AS7_HOME/modules/org/jboss/xnio/nio/main/
jboss-sasl-1.0.0.Beta9.jar	AS7_HOME/modules/org/jboss/sasl/main/
jboss-marshalling-river-1.3.0.GA.jar	AS7_HOME/modules/org/jboss/marshalling/river/main/

你也可以通过”Build path”（右键 EJB Project->Properties，在左边选择Java Build Path，然后中间的标签栏选择“Libraries”，最后在右边选择“ Add External JARs”）

如果你使用的是 JBoss Application Server (AS) 7.1.0 Final 版本，只需要添加一个客户端 JAR 文件(jboss-client-7.1.0.Final.jar)即可，它位于“AS7_HOME/bin/client”目录下

此示例工程的目录结构如下图所示：

14.5. 运行客户端程序

---