CSDN博客

img acute

JBOSS3.0.4配置及使用初步

发表于2003/3/5 9:07:00  960人阅读

分类: 原创

JBOSS3.0.4配置及使用初步

2003年2月28日星期五

前言

       JBOSS推出3.0.4版本其实已经很久很久啦,可是呢,网上关于它的介绍就少得可怜,而且仅有的几篇介绍都并不完全正确,很多甚至是直接拷贝jboss2.4.4的相关内容。那些抄袭者没有想到,从jboss2.4.4jboss3.0.4之间有很大的飞跃,甚至目录结构也不相同了,相关配置更不用多说,他们那些拷贝来的作品根本不能正确指导人们学习jboss

       为了学习jboss,我想大多数人可能都要从http://www.jboss.org那里下载其本身的文档,如3.x版本就有文档JBoss.3.0QuickStart.Draft3.pdf来进行入门指导。但是令人万万没有想到的是,JBoss.3.0QuickStart.Draft3.pdf文档中甚至也有错误的地方,完全按照它的指引,大家将会走弯路的。

       因此,结合我最近学习jboss3.0.4的经验,根据实际应用情况,总结出jboss3.0.4配置及使用初步文档,供大家参考和讨论。

前提

       首先,你必须安装了JDK,版本为1.3以上,我使用的是1.4版本。并在CLASSPATH中设置JAVA_HOME环境变量为JDK安装目录。确保在你的机器上可以运行JAVA程序。

安装及运行jboss3.0.4

       jboss自己的网站http://www.jboss.org下载jboss3.0.4,有jboss-3.0.4.zipjboss-3.0.4_tomcat-4.1.12.zip。后者是jbosstomcat整合到一起的版本,这里主要介绍前者,既单独的jboss3.0.4

       jboss的运行很简单。将jboss-3.0.4.zip解压到本地硬盘的一个目录中。会有以下几个目录生成:

bin

放置jboss启动和停止的可执行脚本文件

docs

放置jboss的例子、测试脚本和各种脚本配置文件的DTD

lib

放置jboss所需要的部分jar包文件

client

放置EJB客户端运行时所需要的jar

server

放置各启动类型的服务器端EJB配置所需要的文件等。

Jboss3.0.4有三种启动类型,分别为all, default, minimal。如在windows平台下启动jboss,可直接启动bin目录下的run.bat既可。此时默认为以default形式启动,如需其它启动方式,则需要参数设置,如想以all模式启动,则运行run.bat –c all命令。至于三种启动模式的区别,无非就是启动的服务多少不同,具体请参照JBoss.3.0QuickStart.Draft3.pdf文档。该文档也有设置jboss启动为windows服务的一段,也可以参照,不过我按照它的做法尝试了一下,发现居然jboss的服务会占据90%以上的CPU资源(当时我用的是赛扬233,脸红中……)。

       正如大家所看到的,jboss启动就这么简单,而且也不需要按照自己的机器额外进行其他配置。到这一步,大家都很爽吧。OK,让我们继续

查看JBOSS端口

这本来不应单独成为一章,但是,网上各资料和JBoss.3.0QuickStart.Draft3.pdf 中都在这一部分对使用者进行了误导,我想在这里我有必要进行澄清。

启动jboss后,我们可以查看8080端口,在浏览器地址栏中键入http://localhost:8080,我们会发现一个错误页面,内容为“HTTP ERROR: 404 / Not Found  RequestURI=/”这是正常的,因为你根本就没有页面可以显示。

在按照网上资料和JBoss.3.0QuickStart.Draft3.pdf的要求查看8082端口时,我们就会发现,根本和资料中讲述不一致了。JBoss.3.0QuickStart.Draft3.pdf中的原文是这样的:“To check if JBoss is running please open a browser and enter http://localhost:8082 which will list all JBoss components running.”但是,我们将会出现一个错误页面!并不是象它所说的会列出所有运行的JBOSS组件。经过查找,发现其实应该是http://localhost:8080/jmx-console 。此点一定注意,否则会打击初学者学习jboss的兴趣的。我们通过这个页面进行对JBOSS的各服务的配置和管理。

我们再查看http://localhost:8083 会出现一个没有错误的空白页,正常,应该是这样。

我们再查看http://localhost:1099 会出现一大堆乱字符,当然,里面包含了你的IP地址等等类似的信息。1099jnp协议监听名字服务的缺省端口,RMI的缺省端口也是一样的。在JNDI中,我们需要用到此端口。

OK,基本端口信息就这些。

EJB文件的编写

       EJB的结构不是我们讨论的内容,下面只是列出它的程序代码,是一个无状态的sessionBean。在这里我用的是ejb2.1JAR

Remote接口文件:Example.java

package examples;

import javax.ejb.EJBObject;

public interface Example extends EJBObject {

       public String example() throws java.rmi.RemoteException;

}

Home接口文件:ExampleHome.java

package examples;

import javax.ejb.EJBHome;

public interface ExampleHome extends EJBHome {

       Example create() throws java.rmi.RemoteException,javax.ejb.CreateException;

}

Local接口文件:ExampleLocal.java

package examples;

import javax.ejb.EJBLocalObject;

public interface ExampleLocal extends EJBLocalObject {

       public String example();

}

LocalHome接口文件:ExampleLocalHome.java

package examples;

import javax.ejb.EJBLocalHome;

public interface ExampleLocalHome extends EJBLocalHome {

       ExampleLocal create() throws javax.ejb.CreateException;

}

Bean文件:ExampleBean.java

package examples;

import java.rmi.RemoteException;

import javax.ejb.EJBException;

import javax.ejb.SessionBean;

import javax.ejb.SessionContext;

public class ExampleBean implements SessionBean {

       public ExampleBean() {

              super();

       }

       public void setSessionContext(SessionContext arg0)

              throws EJBException, RemoteException {

                     System.out.println("setSessionContext");

       }

       public void ejbCreate()

       {

              System.out.println("ejbCreate");

       }

       public void ejbRemove() throws EJBException, RemoteException {

              System.out.println("ejbRemove");

       }

       public void ejbActivate() throws EJBException, RemoteException {

              System.out.println("ejbActivate");

       }

       public void ejbPassivate() throws EJBException, RemoteException {

              System.out.println("ejbPassivate");

       }

       public String example()

       {

              System.out.println("example()");

              return "Just a simple example!";

       }

}

客户端调用程序文件:ExampleClient.java

package examples;

import javax.naming.*;

import javax.rmi.PortableRemoteObject;

import java.util.Properties;

public class ExampleClient {

       public ExampleClient() {

              super();

       }

       public static void main(String[] args){

              try{

              Properties props =new Properties();

              props.put(Context.INITIAL_CONTEXT_FACTORY,"org.jnp.interfaces.NamingContextFactory");

              props.put(Context.PROVIDER_URL,"172.16.1.4:1099");

              Context ctx = new InitialContext(props);

              System.out.println("start ejb client test");

              Object obj=ctx.lookup("Example");

              ExampleHome home = (ExampleHome)PortableRemoteObject.narrow(obj,ExampleHome.class);

              Example example = home.create();

              System.out.println(example.example());

              example.remove();

              }catch(Exception e)

              {

                     e.printStackTrace();

              }

       }

}

EJB打包

       我们需要将以上文件编译的CLASS文件打成一个JAR包,部署到JBOSS中,才能调用ExampleClient执行测试。此jar包可以是任何名字,这里把它命名为myfirst.jar

       按照以上文件的包路径,在正常编译后会形成一examples目录,下面存放各class文件。在和examples同级目录中,还需建立一META-INF目录,里面将放置部署EJB所需要的各种配置文件。

       META-INF下,我们需要有两个文件ejb-jar.xmljboss-service.xmlejb-jar.xml文件里将包括EJB的各种关键信息,而jboss-service.xml则包括EJB部署在JNDI上的一些关键信息。一般网上资料介绍中只会介绍ejb-jar.xml文件,但对于JNDI部署就几乎没有,有的也是从jboss2.4.4那边继承过来的,名称为jboss.xml,但是在jboss3.0.4中,它不会承认这个名字的,只认得jboss-service.xml

       ejb-jar.xml文件内容如下:

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

<ejb-jar>

       <description>Your first EJB application </description>

       <display-name>JUST A TEST</display-name>

       <enterprise-beans>

              <session>

                     <ejb-name>Example</ejb-name>

                     <home>examples.ExampleHome</home>

                     <remote>examples.Example</remote>

                     <local-home>examples.ExampleLocalHome</local-home>

                     <local>examples.ExampleLocal</local>

                     <ejb-class>examples.ExampleBean</ejb-class>

                     <session-type>Stateless</session-type>

                     <transaction-type>Container</transaction-type>

              </session>

       </enterprise-beans>

</ejb-jar>

里面列出了EJB的名称以及各接口和BEAN的类路径和类名。

Jboss-service.xml内容如下:

<?xml version="1.0" encoding="ISO-8859-1"?>

<jboss>

       <enterprise-beans>

              <session>

                     <ejb-name>Example</ejb-name>

                     <jndi-name>Example</jndi-name>

              </session>

              <secure>true</secure>

       </enterprise-beans>

       <resource-managers/>

</jboss>

里面列出了EJB的名字和JNDI中该EJB的位置名称,这对于多个EJB的部署十分重要的。

有了这些目录和文件,就可以将其打包了。在examplesMETA-INF同级目录中,运行命令:

jar cvf myfirst.jar examples/*.class META-INF/*.xml

执行完毕,我们就有了一个myfirst.jar包,里面包括了目录examplesMETA-INF以及在相应目录下的classxml文件。

至此,我们已经形成了一个可以在不同EJB容器下执行的EJB JAR包了,下面要讲述的是在jboss3.0.4中如何具体部署我们的myfirst.jar

EJBjboss3.0.4中的部署

       只要写好了ejb-jar.xmljboss-service.xml,在jboss3.0.4中部署EJB是很简单的了。

       不同的启动jboss模式,就将该jar文件放入对应的目录中。例如:我们用run –c all命令启动,则就将myfirst.jar放入server目录下的all/deploy目录下,则此时,运行中的JBOSS会自动识别并根据jar中的META-INF/*.xml自动部署它。

       EJB的部署就完成了。

EJB的运行

       我们运行ExampleClient来检验我们EJB程序。

       在编译ExampleClient.java时, CLASSPATH需要引入jboss目录client下的jar文件,才能编译成功并正常运行。

       运行ExampleClient,在客户端会出现:

    start ejb client test

Just a simple example!

而在服务端,则会出现类似如下语句:

13:35:31,250 INFO  [STDOUT] setSessionContext

13:35:31,250 INFO  [STDOUT] ejbCreate

13:35:31,250 INFO  [STDOUT] example()

 

证明我们的EJBjboss3.0.4下成功运行!!

 

 

 

0 0

相关博文

我的热门文章

img
取 消
img