[hornetq-commits] JBoss hornetq SVN: r9362 - trunk/docs/user-manual/zh.
do-not-reply at jboss.org
do-not-reply at jboss.org
Mon Jun 28 02:56:26 EDT 2010
Author: gaohoward
Date: 2010-06-28 02:56:26 -0400 (Mon, 28 Jun 2010)
New Revision: 9362
Modified:
trunk/docs/user-manual/zh/appserver-integration.xml
trunk/docs/user-manual/zh/interoperability.xml
trunk/docs/user-manual/zh/jms-bridge.xml
Log:
chinese doc sync
Modified: trunk/docs/user-manual/zh/appserver-integration.xml
===================================================================
--- trunk/docs/user-manual/zh/appserver-integration.xml 2010-06-24 12:43:07 UTC (rev 9361)
+++ trunk/docs/user-manual/zh/appserver-integration.xml 2010-06-28 06:56:26 UTC (rev 9362)
@@ -23,6 +23,10 @@
有关JCA适配器集成的说明来操作。</para>
<para>JCA适配器的作用是控制消息流入到消息Bean（MDB），并控制消息从各种JEE模块中发出（如EJB和Servlet）。</para>
<para>本章讲述这些JEE模块配置HornetQ的基本信息。</para>
+ <section>
+ <title>应用服务器集成所依赖的模块</title>
+ <para></para>
+ </section>
<section>
<title>配置消息Bean</title>
<para>使用HornetQ向MDB传递消息，需要在文件<literal>ra.xml</literal>中配置JCA适配器。该文件在
@@ -249,6 +253,26 @@
都可以使用JMS的JCA适配器来发送消息。</para>
</section>
<section>
+ <title>MDB与接收池的大小</title>
+ <para>包括JBoss在内的绝大多数应用服务器允许用户定义一个池中的MDB数量。在JBoss中这个参数名是<literal>MaxPoolSize</literal>，它在文件
+ ejb3-interceptors-aop.xml中配置。这个参数不影响实际创建的会话／接收者的数量。资源适配器不知道MDB的具体实现。所以即使你设置MDB池在大小
+ 为1，仍然会有15个会话／接收者被创建（默认值）。如果你想改变会话／接收者创建的数量，你可以通过设置资源适配器的参数
+ <literal>maxSession</literal>实现。也可以通过设置MDB的激活配置参数来完成：</para>
+ <programlisting>@MessageDriven(name = "MDBMessageSendTxExample",
+ activationConfig =
+ {
+ @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue"),
+ @ActivationConfigProperty(propertyName = "destination", propertyValue = "queue/testQueue"),
+ @ActivationConfigProperty(propertyName = "maxSession", propertyValue = "1")
+ })
+ at TransactionManagement(value= TransactionManagementType.CONTAINER)
+ at TransactionAttribute(value= TransactionAttributeType.REQUIRED)
+ at ResourceAdapter("hornetq-ra.rar")
+public class MyMDB implements MessageListener
+{ ....}
+ </programlisting>
+ </section>
+ <section>
<title>配置JCA适配器</title>
<para>通过JCA适配器可以将HornetQ集成到JEE兼容的模块中，如MDB和EJB。它的配置决定了这些模块如何接收和发送消息。</para>
<para>HornetQ的JCA适配器是通过<literal>jms-ra.rar</literal>部署的。它的配置文件中其中的
@@ -747,9 +771,34 @@
</section>
<section>
<title>配置适配器访问单独的HornetQ服务器</title>
- <para>在有的情况下，消息服务器与应用服务器运行在不同的机器上。</para>
- <para>这时你需要同时配置内部和外部适配器。</para>
- <para>为了使MDB能接收远程HornetQ服务器的消息，你需要配置ra.xml文件。这个文件的位置是<literal>deploy/hornet-ra.rar/META-INF</literal>。你需要配置一个netty连接器（不是invm连接器）及其传输参数。下面是一个配置的例子：</para>
+ <para>在有的情况下，消息服务器与应用服务器运行在不同的机器上。这时客户端只需要安装HornetQ的客户端的库文件。本节给出了具体的配置和所需要的jar文件。</para>
+ <section>
+ <para>你需要配置两个配置文件。一个是MDB所用的内部适配器，另一个是可以创建外部连接的外部适配器。</para>
+ <section>
+ <title>配置内部适配器</title>
+ <para>首先在<literal>deploy</literal>目录下创建一个以.rar为结尾的文件夹。
+ 在这里我们将其命名为<literal>hornetq-ra.rar</literal>。主注意这一点很重要，因为MDB和外部配置都需要引用
+ 该文件夹的名字。
+ </literal>
+ </para>
+ <note>
+ <para>在JBoss中该文件夹的默认名为<literal>jms-ra.rar</literal>。你可以直接使用这个名字。但是你可能需要避免
+ 与其它的通用适配器相冲突。
+ </para>
+ </note>
+ <para>在文件夹
+ <literal>hornetq-ra.rar</literal>
+ 下创建名为
+ <literal>META-INF</literal>
+ 的文件夹，然后在些文件夹内创建一个
+ <literal>ra.xml</literal>配置文件。在HornetQ发布包中
+ 有一个<literal>ra.xml</literal>模板文件供你使用。
+ </para>
+ <para>要配置MDB接收远程HornetQ服务器的消息，你需要修改<literal>deploy/hornet-ra.rar/META-INF</literal>下面的
+ <literal>ra.xml</literal>文件，将传输层改为netty连接器（不要使用invm连接器）及其相应的参数。下面
+ 是一个配置的例子：
+ </para>
+
<programlisting>
<resourceadapter-class>org.hornetq.ra.HornetQResourceAdapter</resourceadapter-class>
<config-property>
@@ -766,8 +815,15 @@
</config-property>
</programlisting>
<para>上面的配置中，适配器连接到一个运行在本机上端口为5446的服务器。</para>
- <para>同时你还需要配置外部的连接，也连接到这个服务器。这需要配置<literal>deploy/hornetq.sar</literal>
- 下的jms-ds.xml文件，或者创建一个新的配置文件，文件名必须以-ds.xml结尾。</para>
+ </section>
+
+ <section>
+ <title>配置外部适配器</title>
+ <para>你还需要创建一个<literal>hornetq-ds.xml</literal>文件来配置外部连接。该文件需要放置在<literal>deploy</literal>
+ 下的任意一个文件夹中。在一相标准的安装中这个文件夹是<literal>horneq</literal> 或者 <literal>hornetq.sar</literal>。
+ 当然你可以选择其它文件夹。该文件的名字只要是以<literal>-ds.xml</literal>即可。在HornetQ的发布包中包含有一个模板文件，
+ 它的名字是<literal>jms-ds.xml</literal>，位置就在config文件夹下。
+ </para>
<para>下面是一个配置的例子。</para>
<programlisting>
<tx-connection-factory>
@@ -782,7 +838,50 @@
</tx-connection-factory>
</programlisting>
<para>这个配置同样是连接到运行在本机上的端口为5446的HornetQ服务器。JEE模块可以通过JNDI查找
- <literal>java:/RemoteJmsXA</literal>来使用外部的服务了。</para>
+ <literal>java:/RemoteJmsXA</literal>（由<literal>jndi-name</literal>参数定义）。如上节所述，
+ 资源适配器根据文件夹下的配置来创建外部连接。</para>
+ <section>
+ <title>依赖的jar文件</title>
+ <para>下面列出了HornetQ所需要的第三方jar文件</para>
+ <table frame="topbot" border="2">
+ <title>Jar文件</title>
+ <tgroup cols="3">
+ <colspec colname="c1" colnum="1"/>
+ <colspec colname="c2" colnum="2"/>
+ <colspec colname="c3" colnum="3"/>
+ <thead>
+ <row>
+ <entry>Jar文件名</entry>
+ <entry>说明</entry>
+ <entry>位置</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>hornetq-ra.jar</entry>
+ <entry>HornetQ资源适配器文件</entry>
+ <entry>deploy/hornetq-ra.rar或相应的位置</entry>
+ </row>
+ <row>
+ <entry>hornetq-core-client.jar</entry>
+ <entry>HornetQ核心客户类库</entry>
+ <entry>在JBoss的default/lib下或者是$JBOSS_HOME/common/lib下。 </entry>
+ </row>
+ <row>
+ <entry>hornetq-jms-client.jar</entry>
+ <entry>HornetQ的JMS类</entry>
+ <entry>同上</entry>
+ </row>
+ <row>
+ <entry>netty.jar</entry>
+ <entry>Netty类库</entry>
+ <entry>同上</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ </section>
</section>
</section>
<section>
Modified: trunk/docs/user-manual/zh/interoperability.xml
===================================================================
--- trunk/docs/user-manual/zh/interoperability.xml 2010-06-24 12:43:07 UTC (rev 9361)
+++ trunk/docs/user-manual/zh/interoperability.xml 2010-06-28 06:56:26 UTC (rev 9362)
@@ -87,12 +87,12 @@
<para>Stomp基本上是一个基于文本的协议。为了使用更简单，我们的Stomp实现通过检查<literal>content-length</literal>的值
来决定如何将一个Stomp消息映射成一个JMS消息或核心消息。
</para>
- <para>如果在Stomp消息中有<literal>content-length</literal>头，它将被映射为一个JMS的
+ <para>如果在Stomp消息中<emphasis>没有</emphasis><literal>content-length</literal>头，它将被映射为一个JMS的
<emphasis>TextMessage</emphasis>，或者是一个核心消息，其消息体的缓存是一个SimpleString。</para>
- <para>如果Stomp消息中没有<literal>content-length</literal>，则它被映射为一个JMS的
+ <para>如果Stomp消息中<emphasis>有</emphasis><literal>content-length</literal>，则它被映射为一个JMS的
<emphasis>BytesMessage</emphasis>，或者是一个核心消息，其消息体缓存中是一个字节数组byte[]。</para>
<para>从一个JMS消息或核心消息映射为Stomp消息时遵从同样的逻辑。一个Stomp客户端可以通过检查
- <literal>content-length</literal>来决定消息体的类型（UTF－8字符串或字节）。</para>
+ <literal>content-length</literal>来决定消息体的类型（字符串或字节）。</para>
</section>
</section>
<section id="stomp.websockets">
Modified: trunk/docs/user-manual/zh/jms-bridge.xml
===================================================================
--- trunk/docs/user-manual/zh/jms-bridge.xml 2010-06-24 12:43:07 UTC (rev 9361)
+++ trunk/docs/user-manual/zh/jms-bridge.xml 2010-06-28 06:56:26 UTC (rev 9362)
@@ -162,6 +162,14 @@
<key>java.naming.factory.url.pkgs</key>
<value>org.jboss.naming:org.jnp.interfaces"</value>
</entry>
+ <entry>
+ <key>jnp.timeout</key>
+ <value>5000</value>
+ </entry>
+ <entry>
+ <key>jnp.sotimeout</key>
+ <value>5000</value>
+ </entry>
</map>
</constructor>
</bean>
@@ -348,6 +356,22 @@
不错的选择。</para>
</note>
</section>
+ <section>
+ <title>JMS bridge中的超时问题</title>
+ <para>有时候目标服务器或源服务器会连接不上，这里桥就会尝试重新连接。重新连接的次数由<literal>Max Retries</literal>
+ 参数决定，两次重新连接的时间间隔由<literal>Failure Retry Interval</literal>定义。</para>
+ <para>在重新尝试时会进行JNDI的查找。HornetQ的JNDI使用的是JBoss的实现，如果在JNDI查找过程中网络出现故障，
+ 查找的操作可能挂起。为了避免这种情况的发生，我们可以为JNDI设置适当的超时。这是通过定义初始上下文的
+ <literal>jnp.timeout</literal>参数和<literal>jnp.sotimeout</literal>参数来
+ 实现的。第一个参数定义了初始连接的超时，第二个参数定义的是套接字的读取超时。</para>
+ <note>
+ <para>一旦JNDI连接成功，所有调用都是通过RMI完成。如果你想要控制RMI连接的超时，你需要定义相应的系统变量。
+ JBoss使用Sun的RMI实现，它的控制参数可以在<ulink
+ url="http://java.sun.com/j2se/1.5.0/docs/guide/rmi/sunrmiproperties.html">这里</ulink>找到。
+ 默认的连接超时是10秒，默认的读超时是18秒。</para>
+ </note>
+ <para>如果你使用自己的实现来查找JMS资源，你需要注意超时问题。</para>
+ </section>
<section>
<title>例子</title>
<para>参见<xref linkend="examples.javaee.jms-bridge"/>。这个例子展示了如何在JBoss应用服务器中配置并使用
More information about the hornetq-commits
mailing list