本文为原创,如需转载,请注明作者和出处,谢谢!
本系列教程使用的软件版本如下:
Eclipse:3.4.2, Eclipse IDE for Java EE Developers
JBoss :5.0.1,http://www.jboss.org/jbossas/downloads/
JDK:1.6.0.14,http://java.sun.com/javase/downloads/index.jsp
在本文中将编写一个简单的无状态SessionBean。在发布EJB时,一般需要将EJB程序以jar文件的形式进行发布。这些jar文件将被放在<JBoss安装目录>/server/default/deploy目录中。如果在Eclipse中开发EJB程序,需要进行一些配置。首选需要在首选项(Preferences)对话框中设置JBoss的安装目录(如D:/jboss5)。然后在运行配置对话框中添加jboss的运行项。在jboss4.2及以后的版本中,默认情况下jboss只接收来自localhost或127.0.0.1的请求,也就是只接收本地的访问。为了使jboss接收来自其他地址的请求,在启动jboss时需要使用-b命令行参数进行设置。如下面的启动命令所示:
run.bat -b 200.200.200.123
run.bat -b 0.0.0.0
上面的第一行命令表示jboss可以接收来自200.200.200.123的请求。第二条命令表示jboss可以接收来自任意地址的请求。如果不设置-b参数,以非本机方式访问EJB时,JBoss会抛出如下异常:
Exception in thread "main" javax.naming.CommunicationException: Could not obtain connection to any of these urls: 192.168.17.105:1099 and discovery failed with error: javax.naming.CommunicationException: Receive timed out [Root exception is java.net.SocketTimeoutException: Receive timed out] [Root exception is javax.naming.CommunicationException: Failed to connect to server /192.168.17.105:1099 [Root exception is javax.naming.ServiceUnavailableException: Failed to connect to server /192.168.17.105:1099 [Root exception is java.net.ConnectException: Connection refused: connect]]]
at org.jnp.interfaces.NamingContext.checkRef(NamingContext.java:1725)
at org.jnp.interfaces.NamingContext.lookup(NamingContext.java:689)
at org.jnp.interfaces.NamingContext.lookup(NamingContext.java:682)
at javax.naming.InitialContext.lookup(InitialContext.java:392)
at test.Client.main(Client.java:29)
... ...
一、配置开发环境
在eclipse中进行开发,也需要设置-b命令行参数。在运行配置对话框中可以按着图1的方式设置-b命令行参数。
图1
二、开发无状态Session Bean
在Eclipse中开发EJB程序首先需要建立一个EJB Project(工程名为MyEJB)。然后建立一个接口(远程接口)和一个Session Bean。远程接口的代码如下:
package service;
import java.util.List;
import javax.ejb.Remote;
import entity.Greeting;
@Remote
public interface Greeter
{
public String greet(String message);
public List<Greeting> getAllGreetings();
}
在上面的代码中使用了@Remote注释将Greeter接口定义为远程接口,也就是在其他的客户端机器上可以通过该接口来访问本地的Session Bean。在Greeter接口中还使用了一个Greeting类,该类的代码如下:
package entity;
import java.io.Serializable;
public class Greeting implements Serializable
{
private int id;
private String name;
public int getId()
{
return id;
}
public void setId(int id)
{
this.id = id;
}
public String getName()
{
return name;
}
public void setName(String name)
{
this.name = name;
}
}
要注意的是,由于Greeting类在实例将被传输到客户端,因此,该类需要实现java.io.Serializable接口。
下面来编写Session Bean,代码如下:
package service;
import java.util.ArrayList;
import java.util.List;
import javax.ejb.Stateless;
import entity.Greeting;
@Stateless
public class GreeterBean implements Greeter
{
@Override
public List<Greeting> getAllGreetings()
{
List<Greeting> greetings = new ArrayList<Greeting>();
Greeting greeting = new Greeting();
greeting.setId(12);
greeting.setName("bill gates");
greetings.add(greeting);
greeting = new Greeting();
greeting.setId(334);
greeting.setName("李宁");
greetings.add(greeting);
return greetings;
}
@Override
public String greet(String message)
{
return "您好 " + message;
}
}
在上面的代码中使用了@Stateless注释将GreeterBean类定义为无状态的Session Bean。如果JBoss正处于启动状态,并保存上面写的类和接口,Eclipse会自动将上面的代码编译,并生成jar文件,发布到jboss的deploy目录中。该jar文件的目录结构如下:
MyEJB.jar
entity/Greeting.class
service/Greeter.class
service/GreeterBean.class
META-INF/MANIFEST.MF
META-INF/jboss.xml
其中META-INF目录中的两个文件是Eclipse在建立EJB工程时自动生成的,我们不用去管它。读者也可以手工去编译上面的接口和类,并使用jar命令生成jar文件。
三、编写客户端程序
由于本文使用了远程接口来访问Session Bean,因此,在访问时需要指定EJB所有的机器的IP地址。
package test;
import java.util.Properties;
import javax.naming.Context;
import javax.naming.InitialContext;
import service.Greeter;
public class Client
{
public static void main(String[] args) throws Exception
{
Properties prop = new Properties();
// 设置相关的属性值
prop.setProperty(Context.PROVIDER_URL, "192.168.17.105:1099");
prop.setProperty(Context.INITIAL_CONTEXT_FACTORY, "org.jnp.interfaces.NamingContextFactory");
InitialContext ctx = new InitialContext(prop);
// 开始调用Greeter接口的方法
Greeter greeter = (Greeter) ctx.lookup("GreeterBean/remote");
System.out.println(greeter.greet("李宁"));
System.out.println(greeter.getAllGreetings().get(0).getName());
}
}
在上面的代码中,使用了Context.PROVIDER_URL设置了服务端的IP和端口号。
上面积代码的运行结果如:
您好 李宁
bill gates
除了在程序中设置属性值外,也可以通过jndi.properties文件进行设置。该文件应放在Eclipse工程的src目录中。该文件的内容如下:
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.provider.url=192.168.17.105:1099
如果使用jndi.properties文件,就不需要在客户端程序中设置相应的属性值了,因此,可以使用如下的代码来调用Session Bean:
package test;
import javax.naming.Context;
import javax.naming.InitialContext;
import service.Greeter;
public class Client
{
public static void main(String[] args) throws Exception
{
// 不需要在程序中设置相应的属性值
InitialContext ctx = new InitialContext();
// 开始调用Greeter接口的方法
Greeter greeter = (Greeter) ctx.lookup("GreeterBean/remote");
System.out.println(greeter.greet("李宁"));
System.out.println(greeter.getAllGreetings().get(0).getName());
}
}
注意:在编写客户端程序时,需要引用<JBoss安装目录>/client目录中的所有jar文件。
下一篇:eclipse + JBoss 5 + EJB3开发指南(2):编写有状态的SessionBean
国内最棒的Google Android技术社区(eoeandroid),欢迎访问!
《银河系列原创教程》发布
《Java Web开发速学宝典》出版,欢迎定购