使用 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_spec
,jboss-ejb-api_3.1_spec
,jboss-ejb-client
,xnio-api
,xnio-nio
,jboss-remoting
,jboss-sasl
,jboss-marshalling-river
具有作为运行时的范围,因为这些是运行时所需而不是在编译期间。
dependencyManagement 下的依赖关系 jboss-javaee-6.0 和 jboss-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 上运行。