哪里有jboss的文档啊

[zone2000]

说来真是弱智，找了两天愣是没找到一份比较好的关于jboss配置使用的文档,我现在只不过想配置一个连接池，上网找了半天，都是一些jboss2.X版本的配置，感觉2.X好老了一样，那些方法在3.2.1上我都用不了。而且在jboss的网站上也没看到文档的链接，jboss自带的一份文档好像是jboss的一些什么api(*&^,

[Sundery]

www.jboss.org

耐心找找，肯定有的~

[Sundery]

转帖：JBOSS3.0.4配置及使用初步


前言
JBOSS推出3.0.4版本其实已经很久很久啦，可是呢，网上关于它的介绍就少得可怜，而且仅有的几篇介绍都并不完全正确，很多甚至是直接拷贝jboss2.4.4的相关内容。那些抄袭者没有想到，从jboss2.4.4到jboss3.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.zip和jboss-3.0.4_tomcat-4.1.12.zip。后者是jboss和tomcat整合到一起的版本，这里主要介绍前者，既单独的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地址等等类似的信息。1099是jnp协议监听名字服务的缺省端口，RMI的缺省端口也是一样的。在JNDI中，我们需要用到此端口。

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

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

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();

}

}

}

[Sundery]

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

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

在META-INF下，我们需要有两个文件ejb-jar.xml和jboss-service.xml。ejb-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的部署十分重要的。

有了这些目录和文件，就可以将其打包了。在examples和META-INF同级目录中，运行命令：

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

执行完毕，我们就有了一个myfirst.jar包，里面包括了目录examples和META-INF以及在相应目录下的class和xml文件。

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

EJB在jboss3.0.4中的部署
只要写好了ejb-jar.xml和jboss-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()



证明我们的EJB在jboss3.0.4下成功运行！！