使用 JBoss AS 7.1 设置 EJB

1.概述

在本文中,我们将讨论如何开始使用 Enterprise JavaBeans(EJB)。我们将使用 JBoss AS 7.1.1.Final,但你可以自由使用你选择的任何服务器。

2. Bean 的 Maven 依赖项

为了使用 EJB,请确保将其最新版本添加到 pom.xml 文件的 dependencies 部分:

<dependency>
    <groupId>org.jboss.spec.javax.ejb</groupId>
    <artifactId>jboss-ejb-api_3.2_spec</artifactId>
    <version>1.0.0.Final</version>
</dependency>

确保正确添加 JBoss 依赖项,因为我们将在本教程中将 JBoss 用作应用程序服务器。在本教程的后半部分,我们将详细讨论如何为项目设置 maven 构建。

3. EJB Remote

让我们首先创建名为 HelloWorldRemote 的 Bean 接口。

public interface HelloWorldRemote {
    public String getHelloWorld();
}

现在我们将实现上面的接口并将其命名为 HelloWorldBean

@Stateless
public class HelloWorldBean implements HelloWorldRemote {

    public HelloWorldBean() {
    
    }
    
    @Override
    public String getHelloWorld(){
        return ("Hello World");
    }
}

请注意类声明顶部的 @Stateless 表示法。它表示无状态会话 bean。

4.远程 Bean 的 Maven 设置

在本节中,我们将讨论如何设置 maven 以在服务器上构建和运行应用程序。

让我们一个一个地看一下插件。

4.1。编译器插件

maven-compiler-plugin 用于编译项目的源代码。

这里我们使用了插件的 2.3.1 版本,其中源和目标 JDK 在配置下设置为 1.7。

我们已将这些设置定义为标记内的属性,并通过$ {property}引用它。

<version.compiler.plugin>2.3.1</version.compiler.plugin>
<!-- maven-compiler-plugin -->
<maven.compiler.target>1.7</maven.compiler.target>
<maven.compiler.source>1.7</maven.compiler.source>

4.2 EJB 插件

这个插件生成 Bean 文件以及相关的客户端 jar。

我们已将 ejb 版本指定为 3.2,并将 generateClient 属性设置为 true 以生成客户端。

4.3 在 JBoss 中部署

jboss-as-maven-plugin 用于在 JBoss AS 7 中部署,重新部署,取消部署或运行​​应用程序。

在此配置中,我们指定构建文件名与项目构建文件名相同,默认情况下,在我们的案例 ejb-remote-1.0-SNAPSHOT 中使用 artifactid-version 格式。

4.4 EJB 的必需 Maven 依赖项

jboss-javaee-6.0 定义了我们想要使用的 JBoss Java EE 6 API 的版本。

JBoss 分发了一整套 Java EE 6 API,包括物料清单(BOM)。

BOM 指定工件的堆栈(或集合)的版本。我们在标签中指定它,以便我们始终获得正确的工件版本。此依赖项本身的类型是包含所需依赖项的 pom。

<dependency>
    <groupId>org.jboss.spec</groupId>
    <artifactId>jboss-javaee-6.0</artifactId>
    <version>${version.org.jboss.spec.jboss.javaee.6.0}</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

4.5 注释

以下将获得注释依赖项:

<dependency>
    <groupId>org.jboss.spec.javax.annotation</groupId>
    <artifactId>jboss-annotations-api_1.1_spec</artifactId>
    <scope>provided</scope>
</dependency>

4.6 EJB 版本 3.2

在下面的代码中,我们获得了最新版本的规范:

<dependency>
    <groupId>org.jboss.spec.javax.ejb</groupId>
    <artifactId>jboss-ejb-api_3.2_spec</artifactId>
    <version>1.0.0.Final</version>
</dependency>

要在 JBoss 服务器上运行上述项目,我们需要先运行:

mvn clean install

然后我们需要通过运行以下 maven 命令将它部署到正在运行的 JBoss 服务器:

jboss-as:deploy

现在你应该看到在 jboss 服务器中部署了 jar 文件。

或者,你可以从项目中的目标文件夹中复制可用的 jar,并将其粘贴到服务器的 webapp 文件夹中。

5.设置客户端项目

在创建远程 bean 之后,我们应该通过创建客户端来测试已部署的 bean。

首先让我们讨论项目的 maven 设置。

使用了 5.1 Maven 插件

maven-compiler-plugin 用于编译项目的源代码。

我们为源类和目标类指定了 jdk 1.7 版本。

我们的客户端是一个 Java 程序,运行它我们使用 exec-maven-plugin 来帮助执行系统和 Java 程序。我们需要指定可执行文件(即 java),类路径和 java 类(com.baeldung.ejb.client.Client)。

类路径保持为空,因为插件包含基于所提供的依赖项所必需的类路径参数。

5.2 EJB3 客户端的 Maven 依赖关系

为了运行 EJB3 客户端,我们需要包含以下依赖项。

我们依赖于此应用程序的 EJB 远程业务接口来运行客户端。所以我们需要指定 ejb 客户端 jar 依赖项。值为“ejb-client”的标记用于指定此项目对 EJB 客户端 jar 的依赖性。

<dependency>
    <groupId>com.theopentutorials.ejb3</groupId>
    <artifactId>ejbmavendemo</artifactId>
    <type>ejb-client</type>
    <version>${project.version}</version>
</dependency>

依赖关系 jboss-transaction-api_1.1_specjboss-ejb-api_3.1_specjboss-ejb-clientxnio-apixnio-niojboss-remotingjboss-sasljboss-marshalling-river 具有作为运行时的范围,因为这些是运行时所需而不是在编译期间。

dependencyManagement 下的依赖关系 jboss-javaee-6.0jboss-as-ejb-client-bom 的范围为 import。这用于将来自远程 POM 的依赖关系管理信息包括到当前项目中。这些远程 POM 由 JBoss 提供,其中包含运行客户端所必需的依赖项。

5.3 JBoss EJB Client 属性

在“src / main / resources”下创建一个文件,并将其命名为 jboss-ejb-client.properties。

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

6.创建客户端类

首先,我们创建一个 ClientUtility 类:

public class ClientUtility {
    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;
    }
}

现在让我们创建一个实际的 Client 类,它将使用我们在服务器中部署的 bean:

public class Client {
    
    //The lookup method to get the EJB name
    private static HelloWorldRemote doLookup() {
        Context context = null;
        HelloWorldRemote bean = null;
        try {
            // 1. Obtaining Context
            context = ClientUtility.getInitialContext();
            // 2. Generate JNDI Lookup name
            String lookupName = getLookupName();
            // 3. Lookup and cast
            bean = (HelloWorldRemote) 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 = "ejb-remote-0.0.1-SNAPSHOT";
 
        
        // 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 = "HelloWorldBean";
 
        // Fully qualified remote interface name
        final String interfaceName = "com.baeldung.ejb.tutorial.HelloWorldRemote";
 
        // Create a look up string name
        String name = "ejb:" + appName + "/" + moduleName + "/" + distinctName
                + "/" + beanName + "!" + interfaceName;
        
        return name;
    }
}

Client 类使用 bean 并输出结果。

7.结论

所以我们创建了一个 EJB 服务器和一个使用该服务的客户端。该项目可以在任何 Application Server 上运行。