eclipse + JBoss 5 + EJB3开发指南

### Eclipse + JBoss 5 + EJB3 开发指南 #### （1）：编写第一个无状态的SessionBean ##### 一、配置开发环境 在开始编写无状态的SessionBean之前，首先需要确保开发环境已经正确配置。以下是所需的主要组件： 1. **Eclipse**：版本3.4.2，推荐使用针对Java EE开发者的Eclipse版本。 2. **JBoss**：版本5.0.1，可以从官方网站下载：[http://www.jboss.org/jbossas/downloads/](http://www.jboss.org/jbossas/downloads/)。 3. **JDK**：版本1.6.0.14，也可以从Sun的官方网站获取：[http://java.sun.com/javase/downloads/index.jsp](http://java.sun.com/javase/downloads/index.jsp)。 接下来是配置步骤： 1. **设置JBoss的安装目录**：在Eclipse的首选项对话框中，指定JBoss的安装路径（例如`D:\jboss5`）。 2. **配置运行配置**：在Eclipse中添加JBoss的运行配置。 3. **允许远程访问**：默认情况下，JBoss只接受来自`localhost`或`127.0.0.1`的连接。为了允许其他主机访问，需要使用`-b`参数来启动JBoss，例如`run.bat -b 0.0.0.0`。这允许JBoss接收来自任意地址的连接请求。 ##### 二、开发无状态Session Bean 接下来介绍如何创建一个简单的无状态Session Bean： 1. **创建EJB项目**：在Eclipse中新建一个EJB项目，并选择无状态Session Bean作为项目的一部分。 2. **定义接口**：为Session Bean定义本地（Local）和远程（Remote）接口。这些接口用于客户端与Bean之间的通信。 3. **实现Bean类**：实现Session Bean类，并在其中定义业务逻辑。 示例代码如下： ```java // 定义本地接口 public interface HelloLocal { String sayHello(String name); } // 定义远程接口 public interface HelloRemote { String sayHello(String name); } // 实现Session Bean @Stateless public class Hello implements HelloLocal, HelloRemote { @Override public String sayHello(String name) { return "Hello, " + name; } } ``` ##### 三、编写客户端程序 为了测试无状态Session Bean的功能，需要编写一个客户端程序来调用Bean的方法： 1. **创建客户端项目**：在Eclipse中新建一个Java项目作为客户端程序。 2. **引入依赖**：确保客户端项目包含了对EJB项目的引用。 3. **编写测试代码**：使用JNDI查找Session Bean，并调用其方法。 示例代码如下： ```java import javax.naming.Context; import javax.naming.InitialContext; import java.util.Properties; public class HelloClient { public static void main(String[] args) throws Exception { Properties props = new Properties(); props.setProperty(Context.INITIAL_CONTEXT_FACTORY, "org.jnp.interfaces.NamingContextFactory"); props.setProperty(Context.URL_PKG_PREFIXES, "org.jboss.naming:org.jnp.interfaces"); props.setProperty(Context.PROVIDER_URL, "localhost:1099"); Context ctx = new InitialContext(props); HelloRemote hello = (HelloRemote) ctx.lookup("java:global/YourAppName/Hello!ejb/Hello"); System.out.println(hello.sayHello("World")); } } ``` #### （2）：编写有状态的SessionBean 有状态Session Bean与无状态Session Bean类似，但它们保存每个客户端的状态信息。创建有状态Session Bean的过程类似于无状态Session Bean，主要区别在于使用`@Stateful`注解代替`@Stateless`。 #### （3）：使用Session Bean的本地接口 在某些情况下，可能会选择使用本地接口而不是远程接口。这可以提高性能，因为本地接口调用不需要序列化对象。 #### （4）：Session Bean中的注释方法 EJB3引入了注解来简化Bean的声明周期管理。例如，`@PostConstruct`和`@PreDestroy`可用于定义Bean实例初始化和销毁时执行的方法。 #### （5）：使用配置文件发布Session Bean 除了使用注解外，还可以使用部署描述符（`ejb-jar.xml`）来配置Session Bean的行为。 #### （6）：JBoss中测试中的常用错误 在测试过程中，可能会遇到一些常见的错误。例如，当尝试从非本地主机访问EJB时，如果没有正确配置`-b`参数，可能会出现`CommunicationException`。 #### （7）：JBoss只能本地访问，不能通过IP远程访问解决办法 为了解决这个问题，需要在启动JBoss时使用`-b`参数，允许特定IP或所有IP的访问。 #### （8）：JBoss EJB3(HelloWorld)备忘记 这部分提供了一个简单的HelloWorld示例，用于演示如何从头开始构建EJB项目。 总结起来，这篇教程涵盖了从配置开发环境到编写和测试Session Bean的所有基本步骤。它不仅适用于初学者，也适合那些希望深入了解EJB3和JBoss的开发者。通过遵循这些步骤，读者可以建立起自己的EJB应用程序，并掌握使用Eclipse和JBoss进行开发的基本技能。