Repository: activemq-6
Updated Branches:
  refs/heads/master 5996d697c -> b0b19cb4f


http://git-wip-us.apache.org/repos/asf/activemq-6/blob/d18c42b0/docs/user-manual/zh/using-jms.xml
----------------------------------------------------------------------
diff --git a/docs/user-manual/zh/using-jms.xml 
b/docs/user-manual/zh/using-jms.xml
deleted file mode 100644
index ad5f598..0000000
--- a/docs/user-manual/zh/using-jms.xml
+++ /dev/null
@@ -1,273 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- 
============================================================================= 
-->
-<!-- Copyright © 2009 Red Hat, Inc. and others.                               
     -->
-<!--                                                                           
    -->
-<!-- The text of and illustrations in this document are licensed by Red Hat 
under  -->
-<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license 
("CC-BY-SA"). -->
-<!--                                                                           
    -->
-<!-- An explanation of CC-BY-SA is available at                                
    -->
-<!--                                                                           
    -->
-<!--            http://creativecommons.org/licenses/by-sa/3.0/.                
    -->
-<!--                                                                           
    -->
-<!-- In accordance with CC-BY-SA, if you distribute this document or an 
adaptation -->
-<!-- of it, you must provide the URL for the original version.                 
    -->
-<!--                                                                           
    -->
-<!-- Red Hat, as the licensor of this document, waives the right to enforce,   
    -->
-<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent    
    -->
-<!-- permitted by applicable law.                                              
    -->
-<!-- 
============================================================================= 
-->
-<chapter id="using-jms">
-    <title>使用JMS</title>
-    <para>很多用户喜欢使JMS,因此ActiveMQ提供了JMS服务。</para>
-    <para>JMS是一个普遍使用APIæ 
‡å‡†ï¼Œç»å¤§å¤šæ•°çš„消息系统都提供JMS接口。如果你
对JMS还不熟悉,建议你先参考一下
-          Sun的<ulink 
url="http://java.sun.com/products/jms/tutorial/1_3_1-fcs/doc/jms_tutorialTOC.html";>
-            JMS 教程</ulink>。</para>
-    
<para>ActiveMQ还提供了许多的JMS的示例程序(examples)。比如简单的JMS
 Queue和Topic的示例,就很适合初学者做为了
-          解ActiveMQ JMS的起点。<xref 
linkend="examples"/>对这些示例作了详细的说明。</para>
-    <para>下面我们将带领读者一步步地é…
ç½®ActiveMQ的JMS服务,并创建一个简单的JMS程序。我们还将展示如何在没有JNDI的æƒ
…况下
-          来使用ActiveMQ中的JMS。</para>
-    <section>
-        <title>一个简单的订购系统</title>
-        <para>本章
我们将用一个简单的订购系统做为一个例子。尽管它十分简单,但是它能够很好地向大家展示JMS的设置和使用。</para>
-        <para>本例中有一个名为 
<literal>OrderQueue</literal>JMS队列,还将有一个 
<literal>MessageProducer</literal> 
-              
用来向队列发送订购消息。发送到队列的消息由一个 
<literal>MessageConsumer</literal> 来接收。</para>
-        <para>我们所用的队列是<literal>持久
(durable)</literal>的队列,也就是说这个队列不受服务器故
障的影响。当服务器
-              发生故
障重新启动后,这个队列仍然存在。我们需要把这个队列事å…
ˆéƒ¨ç½²å¥½ã€‚办法就是将队列写到JMS的配置文件中。当服务启动
-              时将配置文件中的队列自动部署好。</para>
-    </section>
-    <section id="using-jms.server.configuration">
-        <title>JMS服务的配置</title>
-        <para><literal>activemq-jms.xml</literal>文件包
含了需要创建与部署的JMS Queue,Topic和ConnectionFactory
-            的实例。该文件必
须要指定在classpath中。从这个文件中部署好的对象都可以用JNDI来找到。</para>
-        <para>JMS客户端可以利用JMS 
ConnectionFactory对象来创建与服务器的连接。ConnectionFactory中有å
…³äºŽæœåŠ¡å™¨åœ°å€çš„
-              
信息以及各种参数。通常使用这些参数的默认值即可。</para>
-        
<para>这里我们将要在服务器端部署一个JMS队列和一个JMS 
ConnectionFactory (连接工厂)。当然完å…
¨å¯ä»¥éƒ¨ç½²å¤šä¸ªJMS对象。
-              下面给出了具体的配置内容:</para>
-        <programlisting>
-&lt;configuration xmlns="urn:activemq"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
-    xsi:schemaLocation="urn:activemq ../schemas/activemq-jms.xsd "&gt;
-    
-    &lt;connection-factory name="ConnectionFactory"&gt;
-        &lt;connectors>
-           &lt;connector-ref connector-name="netty"/&gt;
-        &lt;/connectors>
-        &lt;entries&gt;
-            &lt;entry name="ConnectionFactory"/&gt;           
-        &lt;/entries&gt;
-    &lt;/connection-factory&gt;
-    
-    &lt;queue name="OrderQueue"&gt;
-        &lt;entry name="queues/OrderQueue"/&gt;
-    &lt;/queue&gt;
-    
-&lt;/configuration&gt; 
-        </programlisting>
-        <para>在本文件中我们部署了一个名为 
<literal>ConnectionFactory</literal> 的一个连接工厂,并且将å…
¶ç»‘定到
-              
JNDI中。如果需要可以将一个连接工厂绑定为多个名称。只需要将绑定的名字åŠ
 å…¥åˆ° <literal>entry</literal> 
-              中即可。</para>
-        <note>
-            <para>在JMS ConnectionFactory的配置中引用了一个名为 
<literal>netty</literal>的<literal>connector</literal>。
-                它实际上指向的是ActiveMQæ 
¸å¿ƒä¸­éƒ¨ç½²çš„一个连接器(connector)。它的配置在ActiveMQ的æ 
¸å¿ƒé…ç½®æ–‡ä»¶
-                 <literal>activemq-configuration.xml</literal> 
中。它定义了采用何种传输与服务器连接。</para>
-        </note>
-    </section>
-    <section id="using-jms.configure.factory.types">
-        <title>连接工厂的类型</title>
-        <para>在JMS API文档中有几
种不同类型的连接工厂供用户使用。ActiveMQ为用户提供了é…
ç½®è¿žæŽ¥å·¥åŽ‚类型的参数。用户可以通过
-              é…
ç½®è¿žæŽ¥å·¥åŽ‚的”signature"属性和"xa"参数来得到想要的类型。“singature"属性是字符串类型,它有三个可选值:
-              
<emphasis>generic</emphasis>、<emphasis>queue</emphasis>和<emphasis>topic</emphasis>;
 
-              
<literal>xa</literal>是一个布尔型参数。下表给出了不同类型连接工厂对应的é
…ç½®å€¼ï¼š</para>
-        <table frame="topbot" id="using-jms.table.configure.factory.types">
-                <title>连接工厂类型的配置</title>
-                <tgroup cols="3">
-                    <colspec colname="signature" colnum="1"/>
-                    <colspec colname="xa" colnum="2"/>
-                    <colspec colname="cftype" colnum="3"/>
-                    <thead>
-                        <row>
-                            <entry>signature</entry>
-                            <entry>xa</entry>
-                            <entry>连接工厂的类型</entry>
-                        </row>
-                    </thead>
-                    <tbody>
-                        <row>
-                            <entry>generic (默认)</entry>
-                            <entry>false (默认)</entry>
-                            <entry>javax.jms.ConnectionFactory</entry>
-                        </row>
-                        <row>
-                            <entry>generic</entry>
-                            <entry>true</entry>
-                            <entry>javax.jms.XAConnectionFactory</entry>
-                        </row>
-                        <row>
-                            <entry>queue</entry>
-                            <entry>false</entry>
-                            <entry>javax.jms.QueueConnectionFactory</entry>
-                        </row>
-                        <row>
-                            <entry>queue</entry>
-                            <entry>true</entry>
-                            <entry>javax.jms.XAQueueConnectionFactory</entry>
-                        </row>
-                        <row>
-                            <entry>topic</entry>
-                            <entry>false</entry>
-                            <entry>javax.jms.TopicConnectionFactory</entry>
-                        </row>
-                        <row>
-                            <entry>topic</entry>
-                            <entry>true</entry>
-                            <entry>javax.jms.XATopicConnectionFactory</entry>
-                        </row>
-                    </tbody>
-                </tgroup>
-            </table>
-            <para>下面的例子é…
ç½®äº†ä¸€ä¸ªXAQueueConnectionFactory:</para>
-        <programlisting>
-&lt;configuration xmlns="urn:activemq"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
-    xsi:schemaLocation="urn:activemq ../schemas/activemq-jms.xsd "&gt;
-    
-    &lt;connection-factory name="ConnectionFactory" signature="queue"&gt;
-        &lt;xa>true&lt;/xa>
-        &lt;connectors>
-           &lt;connector-ref connector-name="netty"/&gt;
-        &lt;/connectors>
-        &lt;entries&gt;
-            &lt;entry name="ConnectionFactory"/&gt;           
-        &lt;/entries&gt;
-    &lt;/connection-factory&gt;
-&lt;/configuration&gt; 
-        </programlisting>
-    </section>
-    <section>
-        <title>JNDI的配置</title>
-        
<para>当客户端使用JNDI时需要定义一些JNDI的参数。这些参数主要用来确定JNDI服务的地址。这些参数通常保存在
-            一个名为 <literal>jndi.properties</literal> 
的文件中。这个文件需要在客户端的classpath中。或者你
-            可以在创建JNDI的InitialContext时将这些参数传
进去。想了解全面的JNDI知识,可以参见 <ulink
-                url="http://java.sun.com/products/jndi/tutorial/TOC.html";>Sun 
JNDI 教程</ulink>
-            。</para>
-        <para>要与JBoss的JNDI Server进行通迅
,需要指定以下的JNDI参数:</para>
-        <programlisting>
-java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
-java.naming.provider.url=jnp://myhost:1099
-java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces               
         
-        </programlisting>
-        <para>其中的 <literal>myhost</literal> 是 JNDI 
server的主机名或IP地址。 1099是端口号,根据不同的配置,
-            端口号也可能不同。</para>
-        <para>在默认的单独方式(standalone)é…
ç½®ä¸­ï¼ŒJNDI服务端口等参数定义在<literal>activemq-beans.xml</literal>
-              文件中的 <literal>JNDIServer</literal> 
bean下,如:</para>
-        <programlisting>
-&lt;bean name="JNDIServer" class="org.jnp.server.Main"&gt;
-    &lt;property name="namingInfo"&gt;
-        &lt;inject bean="Naming"/&gt;
-    &lt;/property&gt;
-    &lt;property name="port"&gt;1099&lt;/property&gt;
-    &lt;property name="bindAddress"&gt;localhost&lt;/property&gt;
-    &lt;property name="rmiPort"&gt;1098&lt;/property&gt;
-    &lt;property name="rmiBindAddress"&gt;localhost&lt;/property&gt;
-&lt;/bean&gt;                        
-        </programlisting>
-        <note>
-            <para>如果你
的JNDI服务器与客户端不在同一台机器上,一定不要忘记将bindAddress改成相应的地址,
-                  千万不能用<literal>localhost</literal>!</para>
-        </note>
-        <note>
-            
<para><emphasis>只有当ActiveMQ作为独立服务器运行时</emphasis>
-                  才可以配置JNDIServer 
bean。当ActiveMQ运行于JBoss应用服务器中时,由于JBOSS服务器已经提供了
-                  JNDI服务,所以就不需要再进行配置了。</para>
-        </note>
-    </section>
-    <section>
-        <title>程序代码</title>
-        <para>下面给出的例子中的代码:</para>
-        <para>首先我们创建一个JNDI的Initial Context:</para>
-        <programlisting>InitialContext ic = new 
InitialContext();</programlisting>
-        <para>下面我们查找 connection factory:</para>
-        <programlisting>ConnectionFactory cf = 
(ConnectionFactory)ic.lookup("/ConnectionFactory");</programlisting>
-        <para>然后查找 Queue:</para>
-        <programlisting>Queue orderQueue = 
(Queue)ic.lookup("/queues/OrderQueue");</programlisting>
-        <para>接下来用拿到的ConnectionFactory建立JMS连接:</para>
-        <programlisting>Connection connection = 
cf.createConnection();</programlisting>
-        <para>再创建一个非事务的、AUTO_ACKNOWLEDGE方式的JMS 
Session:</para>
-        <programlisting>Session session = connection.createSession(false, 
Session.AUTO_ACKNOWLEDGE);</programlisting>
-        <para>创建一个 MessageProducer 
以向队列发送订单消息:</para>
-        <programlisting>MessageProducer producer = 
session.createProducer(orderQueue);</programlisting>
-        <para>创建一个 MessageConsumer 
以从队列中接收订单消息:</para>
-        <programlisting>MessageConsumer consumer = 
session.createConsumer(orderQueue);</programlisting>
-        <para>要启动连接,以使消息能传递给接收者:</para>
-        <programlisting>connection.start();</programlisting>
-        <para>发送一个简单的TextMessage:</para>
-        <programlisting>TextMessage message = session.createTextMessage("This 
is an order");
-producer.send(message);</programlisting>
-        <para>之后接收这个消息:</para>
-        <programlisting>TextMessage receivedMessage = 
(TextMessage)consumer.receive();
-System.out.println("Got order: " + receivedMessage.getText());
-        </programlisting>
-        <para>看起来就是这么简单。 在ActiveMQ有发布包
中有很多各种各样的JMS例子供用户参考。</para>
-        <warning>
-            
<para>请注意,JMS的连接(connection)、会话(session)、生产者
(producer)和消费者(consumer)
-                  对象是可以<emphasis>重用</emphasis>的。</para>
-            
<para>如果每发送或接收一个消息都要重新创建这些JMS对象,是不符合设计模式的要求的。这æ
 ·åšä¼šé€ æˆåº”用程序
-                  的性能很差。这方面的内容在<xref 
linkend="perf-tuning"/>中将会进一步的讨论。</para>
-        </warning>
-    </section>
-    <section>
-        <title>不使用JNDI而直接创建JMS的对象</title>
-        <para>尽管采用JNDI对 JMS 
的各种<emphasis>管理对象(Administered
-                Objects)</emphasis> (即JMS Queue, Topic and 
ConnectionFactory)是很常用的方法,但在有些
-            情况时JNDI不可用,或者你
不需要用JNDI时,如何还能正常使用JMS呢?</para>
-        <para>ActiveMQ允许你
不通过JNDI也能使用JMS。ActiveMQ支持直接创建JMS的各种对象而æ—
 éœ€JNDI的存在。</para>
-        <para>在<xref linkend="examples"/>中包括有这样的例子供读者
参考。</para>
-        
<para>下面我们就将上述那个简单的例子重写,以抛开对JNDI的依赖:</para>
-        
<para>我们通过ActiveMQJMSClient类来方便地创建JMS的ConnectionFactory。注意这里要提供各种连接参数和定义
-              所用的传输方式。有å…
³è¿žæŽ¥å™¨ï¼ˆconnector)的信息参见<xref linkend="configuring-transports"
-            />。</para>
-        <programlisting>              
-TransportConfiguration transportConfiguration = 
-                     new 
TransportConfiguration(NettyConnectorFactory.class.getName());                
-ConnectionFactory cf = 
ActiveMQJMSClient.createConnectionFactory(transportConfiguration);
-        </programlisting>
-        <para>同样利用ActiveMQJMSClient类创建JMS Queue对象:</para>
-        <programlisting>Queue orderQueue = 
ActiveMQJMSClient.createQueue("OrderQueue");</programlisting>
-        <para>然后用连接工厂创建 JMS 连接:</para>
-        <programlisting>Connection connection = 
cf.createConnection();</programlisting>
-        <para>还有非事务的\AUTO_ACKNOWLEDGE方式的 JMS 
会话(session):</para>
-        <programlisting>Session session = connection.createSession(false, 
Session.AUTO_ACKNOWLEDGE);</programlisting>
-        <para>以及用于发送消息的MessageProducer:</para>
-        <programlisting>MessageProducer producer = 
session.createProducer(orderQueue);</programlisting>
-        <para>和接收消息的 MessageConsumer:</para>
-        <programlisting>MessageConsumer consumer = 
session.createConsumer(orderQueue);</programlisting>
-        <para>启动连接:</para>
-        <programlisting>connection.start();</programlisting>
-        <para>创建一个简单的 TextMessage 并将å…
¶å‘送到队列:</para>
-        <programlisting>TextMessage message = session.createTextMessage("This 
is an order");
-producer.send(message);</programlisting>
-        <para>接收消息:</para>
-        <programlisting>TextMessage receivedMessage = 
(TextMessage)consumer.receive();
-System.out.println("Got order: " + receivedMessage.getText());
-        </programlisting>
-    </section>
-    <section id="using-jms.clientid">
-        <title>Client ID的设置</title>
-        <para>在建立持久的订阅
(subscription)时,JMS客户需要有一个客户ID (client 
id)。我们可以通过配置
-            connection factory来定义它。(其中的 
<literal>client-id</literal>项)。这样所有通过这个
-            connection factory来创建的连接都å…
·æœ‰è¿™ä¸ªå®¢æˆ·ID。</para>
-    </section>
-    <section id="using-jms.dupsokbatchsize">
-        <title>设置DUPS_OK的Batch Size </title>
-        
<para>如果JMS的通知模式为<literal>DUPS_OK</literal>,我们可以é…
ç½®æŽ¥æ”¶è€…(consumer)以使得它以批为单位
-            发送通知,而不是一个一个地发通知。这æ 
·åšå¯ä»¥èŠ‚省很多带宽,效率高。配置的方法是设置connection 
factory下
-            
的<literal>dups-ok-batch-size</literal>项。单位是字节(byte)。默认值是1024
 * 1024 bytes = 1 MiB。</para>
-    </section>
-    <section id="using-jms.txbatchsize">
-        <title>设置事务(Transaction)的Batch Size</title>
-        <para>当在一个事务内接收消息时,可能通过é…
ç½®ä½¿æŽ¥æ”¶è€…
采用批量的方式发送通知,而不是一个一个的发送。这æ 
·ä¹Ÿå¯ä»¥èŠ‚省带宽。
-            配置方法是设置connection factory下的<literal
-                >transaction-batch-size</literal>项。 
单位是字节(byte)。默认值是1024 *
-            1024。</para>
-    </section>
-</chapter>

http://git-wip-us.apache.org/repos/asf/activemq-6/blob/d18c42b0/docs/user-manual/zh/using-server.xml
----------------------------------------------------------------------
diff --git a/docs/user-manual/zh/using-server.xml 
b/docs/user-manual/zh/using-server.xml
deleted file mode 100644
index 5354e48..0000000
--- a/docs/user-manual/zh/using-server.xml
+++ /dev/null
@@ -1,312 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- 
============================================================================= 
-->
-<!-- Copyright © 2009 Red Hat, Inc. and others.                               
     -->
-<!--                                                                           
    -->
-<!-- The text of and illustrations in this document are licensed by Red Hat 
under  -->
-<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license 
("CC-BY-SA"). -->
-<!--                                                                           
    -->
-<!-- An explanation of CC-BY-SA is available at                                
    -->
-<!--                                                                           
    -->
-<!--            http://creativecommons.org/licenses/by-sa/3.0/.                
    -->
-<!--                                                                           
    -->
-<!-- In accordance with CC-BY-SA, if you distribute this document or an 
adaptation -->
-<!-- of it, you must provide the URL for the original version.                 
    -->
-<!--                                                                           
    -->
-<!-- Red Hat, as the licensor of this document, waives the right to enforce,   
    -->
-<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent    
    -->
-<!-- permitted by applicable law.                                              
    -->
-<!-- 
============================================================================= 
-->
-<chapter id="using-server">
-    <title>使用ActiveMQ服务</title>
-    <para>本章将介绍如何使用ActiveMQ服务。</para>
-    <para>其中的内容包
括服务器的位置,如何启动和停止ActiveMQ服务器。本章
还将解释ActiveMQ的目录结构,其中的文件及其用途。</para>
-    <para>本章中所提到的ActiveMQ服务器是指ActiveMQ默认é…
ç½®çš„独立服务器,包含JMS服务和JNDI服务。</para>
-    <para>对于运行于JBoss应用服务器中的ActiveMQ,å…
¶åŸºæœ¬ç»“构是一样的,只是有一些小的差别。</para>
-    <section>
-        <title>服务的启动和停止</title>
-        <para>在ActiveMQ的安装
目录下<literal>bin</literal>子目录中包
含有一个unit/linux脚本run.sh和对应的Windows批处理文件run.bat。</para>
-        <para>如果你
是在Unix/Linux环境,在bin目录下运行<literal>./run.sh</literal>。</para>
-        <para>如果是在Windows环境,则在bin目录下运行 
<literal>run.bat</literal>。</para>
-        
<para>这个脚本文件会设置classpath以及各种JVM参数,并启动JBoss
 Microcontainer。JBoss Microcontainer是一个轻量级的容器。
-              它被用来部署ActiveMQ的POJO对象。</para>
-        <para>要停止服务,运行å…
¶ä¸­çš„相应脚本:在Unix/Linux环境下,运行 
<literal>stop.sh</literal>。
-              在Windows环境,运行 <literal>run.bat</literal>。</para>
-        <para>注意ActiveMQ需要在Java 
6及以上版本才能正常运行。</para>
-        
<para>启动和停止脚本在默认条件下读取<literal>config/stand-alone/non-clustered</literal>目录下的é
…ç½®æ–‡ä»¶ã€‚
-              如果要指向å…
¶ä»–目录,可以在命令行实现,例如: <literal>./run.sh 
../config/stand-alone/clustered</literal>。
-              这一方法同样适用于Windows批处理文件。</para>
-    </section>
-    <section>
-        <title>服务器端JVM参数的设置</title>
-        
<para>在启动脚本<literal>run.sh</literal>和<literal>run.bat</literal>中设置了一些JVM参数,
-              这些参数主要是调整Java 
6的运行环境及拉圾回收的策略。我们建议采用并行拉圾回收的方法。
-              这种方法可以将拉圾回收所造
成的延时进行平均分é…
ï¼Œæœ‰æ•ˆå‡å°‘由于拉圾回收引起的长时间暂停的情况。</para>
-        <para>默认条件下ActiveMQ需要最大1GB的内
存空间。通过<literal>-Xms</literal>和<literal>-Xmx</literal>可以调整Java程序å†
…存的使用。</para>
-        <para>你可以向启动脚本中添加å…
¶å®ƒçš„参数或修改已有的参数,已满足你的需要。</para>
-    </section>
-    <section>
-        <title>服务器端的classpath</title>
-        <para>ActiveMQ在其classpath中寻找配置文件。</para>
-        
<para>classpath被定义在<literal>run.sh</literal>和<literal>run.bat</literal>脚本中。在ActiveMQ的发布中,启动脚本将非集群的é
…ç½®æ–‡ä»¶ç›®å½•åŠ è¿›äº†classpath中。该目录包括了一组é…
ç½®æ–‡ä»¶ï¼Œå¯ä»¥è®©ActiveMQ以基本的非集群方式运行。它的å…
·ä½“位置是在ActiveMQ发布根目录下 config/stand-along/non-clustered/ 
子目录。</para>
-        <para>在ActiveMQ的发布包中包括了一组标准的é…
ç½®ç›®å½•ï¼Œå®ƒä»¬æ˜¯ï¼š</para>
-        <itemizedlist>
-            <listitem>
-                <para>非集群方式的独立服务器配置</para>
-            </listitem>
-            <listitem>
-                <para>集群方式的独立服务器配置</para>
-            </listitem>
-            <listitem>
-                <para>非集群方式运行于JBoss应用服务器</para>
-            </listitem>
-            <listitem>
-                <para>集群方式运行于JBoss应用服务器</para>
-            </listitem>
-        </itemizedlist>
-        <para>当然你可以创建自己定义的é…
ç½®æ–‡ä»¶ç›®å½•ã€‚要注意的是将你的目录加
到classpath中以便ActiveMQ能正确找到并加载。</para>
-    </section>
-    <section id="using-server.library.path">
-        <title>Library Path</title>
-        <para>如果要在Linux上使用异步IO的日志(<link 
linkend="aio-journal">Asynchronous IO Journal</link>),
-              ä½ 
需要在java选项中指定<literal>java.library.path</literal>。<literal>run.sh</literal>脚本可以自动完成这一步。</para>
-        
<para>如果没有指定<literal>java.library.path</literal>,JVM将使用<literal>LD_LIBRARY_PATH</literal>环境变量。</para>
-    </section>
-    <section>
-        <title>系统变量</title>
-        <para>ActiveMQ命令行可以接受系统变量来é…
ç½®æ—¥å¿—(logging)。有关logging配置的具体信息参见<xref 
linkend="logging"/>。</para>
-    </section>
-    <section id="using-server.configuration">
-        <title>配置文件</title>
-        <para>配置文件的路径定义在 <literal>run.sh</literal> 和 
<literal>run.bat</literal> 脚本中的classpath里。该路径下可以包
含以下文件:</para>
-        <itemizedlist>
-            <listitem>
-                <para><literal>activemq-beans.xml</literal> 
(如果是运行在JBoss应用服务器内,则为 <literal
-                        >activemq-jboss-beans.xml</literal>)。这是JBoss 
Microcontainer的bean配置文件。其中定义了ActiveMQ的
-                    各种bean,以及它们之间的依赖å…
³ç³»ã€‚ActiveMQ的bean都是一些POJO。是JBoss 
Microcontainer保证了这些bean的正确装载和运行。</para>
-            </listitem>
-            <listitem>
-                
<para><literal>activemq-configuration.xml</literal>。这个是ActiveMQ的主要的é
…ç½®æ–‡ä»¶ã€‚
-                    其中的所有参数在<xref 
linkend="configuration-index"/>中给出了解释. 在 <xref
-                        linkend="usingserver.mainconfig"/> 也有更多的相å…
³ä¿¡æ¯ã€‚</para>
-            </listitem>
-            <listitem>
-                
<para><literal>activemq-queues.xml</literal>。这个文件里包
含了预定义的queue以及它们的配置,包括安全设置。
-                    这是一个可选的文件,里面所有的内
容都可以放在 <literal>activemq-configuration.xml</literal>文件中。
-                    在默认的é…
ç½®æ–‡ä»¶ç›®å½•ä¸‹å¹¶æ²¡æœ‰è¿™ä¸ªæ–‡ä»¶ã€‚ActiveMQ之所以提供这个文件是为了用户便于管理他们的queue。在classpath中
-                    允许包含多个 <literal>activemq-queues.xml</literal> 
文件。所有的这些文件都会被加载。</para>
-            </listitem>
-            <listitem>
-                
<para><literal>activemq-users.xml</literal>。用户信息文件。ActiveMQ本身实现了一个基本的
-                    安全管理器(security 
manager),它从这个文件内读取用户的安å…
¨ä¿¡æ¯ï¼Œå¦‚用户名,密码和角色。
-                    想了解更多关于安全的信息,参见 <xref 
linkend="security"/>。</para>
-            </listitem>
-            <listitem>
-                <para><literal>activemq-jms.xml</literal>。这个文件包
含有JMS对象。ActiveMQ的默认配置中包含有JMS服务,
-                    它从这个文件中读取JMS 
Queue,Topic和ConnectionFactory并将它们部署到JNDI服务中。如果你
不使用JMS,
-                    或者你不需要部署这些JMS对象,那么你
就不需要这个文件。有关JMS的使用详见<xref linkend="using-jms"
-                    />。</para>
-            </listitem>
-            <listitem>
-                <para><literal>logging.properties</literal> 
这个文件用于配置logging
-                    handlers。详见 <xref linkend="logging"/>。</para>
-            </listitem>
-            <listitem>
-                <para><literal>log4j.xml</literal>。 这是 Log4j handler的é…
ç½®æ–‡ä»¶ã€‚</para>
-            </listitem>
-        </itemizedlist>
-        <note>
-            
<para>如果在<literal>activemq-configuration.xml</literal>文件中将<literal>file-deployment-enabled</literal>
 参数
-                  定义为false,则ActiveMQ将不会加载其它的é…
ç½®æ–‡ä»¶ã€‚这个参数的默认值是true。</para>
-        </note>
-        <para>所有配置文件中的参数都可以用系统变量来定义å…
¶å€¼ã€‚以下用一个connector的配置来说明:</para>
-        <programlisting>&lt;connector name="netty">
-         
&lt;factory-class>org.apache.activemq.integration.transports.netty.NettyConnectorFactory
-           &lt;/factory-class>
-         &lt;param key="host"  
value="${activemq.remoting.netty.host:localhost}" type="String"/>
-         &lt;param key="port"  value="${activemq.remoting.netty.port:5445}" 
type="Integer"/>
-&lt;/connector></programlisting>
-        <para>在上面的配置中我们定义了两个系统变量 <literal
-                >activemq.remoting.netty.host</literal> 和 <literal
-                
>activemq.remoting.netty.port</literal>。它们的值会被相应的系统变量的值(如果定义了的话)所替代。
-                
如果没有定义这些系统变量,它们的默认值将分别为 localhost 
及 5445。也可以不给出默认值,但如果这样就
-                <emphasis>必
须</emphasis>要定义相应的系统变量。</para>
-    </section>
-    <section id="server.microcontainer.configuration">
-        <title>JBoss Microcontainer Beans 文件</title>
-        <para>ActiveMQ的POJO对象是由<ulink 
url="http://www.jboss.org/jbossmc/";> JBoss Microcontainer
-            </ulink>进行加载和运行的。JBoss 
Microcontainer是一个轻量级的加载工具。</para>
-        <note>
-            <para>如果是在JBoss应用服务器内运行,ActiveMQ同æ 
·éœ€è¦ä¸€ä¸ªbean的配置文件来将å…
¶éƒ¨ç½²åˆ°JBoss中。但是这与单独运行时的配置文件略有不同。
-                这是因为应用服务器内
已经部署了一些服务,如安å…
¨æœåŠ¡ç­‰ã€‚所以在ActiveMQ中这些服务就不需要再部署了。</para>
-        </note>
-        <para>让我们看一个ActiveMQ作为单独服务器时的一个é…
ç½®æ–‡ä»¶ä¾‹å­ï¼š</para>
-        <para>
-            <programlisting>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-
-&lt;deployment xmlns="urn:jboss:bean-deployer:2.0"&gt;
-
-&lt;bean name="Naming" class="org.jnp.server.NamingBeanImpl"/&gt;
-
-&lt;!-- JNDI server. Disable this if you don't want JNDI --&gt;
-&lt;bean name="JNDIServer" class="org.jnp.server.Main"&gt;
-   &lt;property name="namingInfo"&gt;
-      &lt;inject bean="Naming"/&gt;
-   &lt;/property&gt;
-   &lt;property name="port"&gt;1099&lt;/property&gt;
-   &lt;property name="bindAddress"&gt;localhost&lt;/property&gt;
-   &lt;property name="rmiPort"&gt;1098&lt;/property&gt;
-   &lt;property name="rmiBindAddress"&gt;localhost&lt;/property&gt;
-&lt;/bean&gt;
-
-&lt;!-- MBean server --&gt;
-&lt;bean name="MBeanServer" class="javax.management.MBeanServer"&gt;
-   &lt;constructor factoryClass="java.lang.management.ManagementFactory"
-      factoryMethod="getPlatformMBeanServer"/&gt;
-&lt;/bean&gt; 
-
-&lt;!-- The core configuration --&gt;
-&lt;bean name="Configuration" 
class="org.apache.activemq.core.config.impl.FileConfiguration"&gt;
-&lt;/bean&gt;
-
-&lt;!-- The security manager --&gt;
-&lt;bean name="ActiveMQSecurityManager" 
-      
class="org.apache.activemq.spi.core.security.ActiveMQSecurityManagerImpl"&gt;
-   &lt;start ignored="true"/&gt;
-   &lt;stop ignored="true"/&gt;
-&lt;/bean&gt;
-
-&lt;!-- The core server --&gt;
-&lt;bean name="ActiveMQServer" 
class="org.apache.activemq.core.server.impl.ActiveMQServerImpl"&gt;
-   &lt;start ignored="true"/&gt;
-   &lt;stop ignored="true"/&gt;  
-   &lt;constructor&gt;
-      &lt;parameter&gt;
-         &lt;inject bean="Configuration"/&gt;
-      &lt;/parameter&gt;
-      &lt;parameter&gt;
-         &lt;inject bean="MBeanServer"/&gt;
-      &lt;/parameter&gt;
-      &lt;parameter&gt;
-         &lt;inject bean="ActiveMQSecurityManager"/&gt;
-      &lt;/parameter&gt;        
-   &lt;/constructor&gt;         
-&lt;/bean&gt;
-
-&lt;!-- The JMS server --&gt;
-&lt;bean name="JMSServerManager" 
-      class="org.apache.activemq.jms.server.impl.JMSServerManagerImpl"&gt;
-   &lt;constructor&gt;         
-      &lt;parameter&gt;
-         &lt;inject bean="ActiveMQServer"/&gt;
-      &lt;/parameter&gt;         
-   &lt;/constructor&gt;
-&lt;/bean&gt;
-
-&lt;/deployment&gt;</programlisting>
-        </para>
-        <para>我们从上可以看出ActiveMQ的单独服务器(以及æ 
¸å¿ƒæœåŠ¡å™¨ï¼‰åŒ…括了一些POJO对象:</para>
-        <itemizedlist>
-            <listitem>
-                <para>JNDIServer</para>
-                <para>很多客户端需要JNDI来获取JMS的对象,因
此我们提供了一个JNDI服务来满足它们。如果不需要JNDI,可以在é
…ç½®
-                      文件中将它们注释掉。</para>
-            </listitem>
-            <listitem>
-                <para>MBeanServer</para>
-                
<para>这个对象提供了JMX管理接口。它是一个MBean服务器,可管理的对象可以注册到这个服务器上。
-                      通常这就是一个JVM内
部的默认的平台MBean服务器。如果不需要些服务,可以在é…
ç½®æ–‡ä»¶ä¸­å°†å…¶æ³¨é‡Šæˆ–删除。</para>
-            </listitem>
-            <listitem>
-                <para>Configuration</para>
-                
<para>这是ActiveMQ的Configuration对象。默认时它是一个FileConfiguration对象。它可以从文件系统中读取
-                    配置信息。有些情况下(如嵌入式ActiveMQ)你
可以将它定义为其它对象,以便用其它方法获得é…
ç½®ä¿¡æ¯ã€‚</para>
-            </listitem>
-            <listitem>
-                <para>Security Manager. 可配置的安å…
¨ç®¡ç†å™¨ã€‚默认的安全管理器使用 
<literal>activemq-users.xml</literal> 文件中的配置信息。
-                    它也可以配置为一个JAAS的安å…
¨ç®¡ç†å™¨ã€‚当ActiveMQ运行于JBoss应用服务器中时,它还可以é…
ç½®ä¸ºJBoss的安全管理器,以达到更紧密的集成。
-                    如果不需要安全管理,你也可以将它删
除。</para>
-            </listitem>
-            <listitem>
-                <para>ActiveMQServer</para>
-                <para>这是ActiveMQ的核心服务对象,几乎所有的æ 
¸å¿ƒåŠŸèƒ½éƒ½åœ¨è¿™é‡Œã€‚</para>
-            </listitem>
-            <listitem id="bean-jmsservermanager">
-                <para>JMSServerManager</para>
-                
<para>这个对象将<literal>activemq-jms.xml</literal>文件中定义的JMS的对象进行部署,比如JMS
 Queues, Topics
-                      
以及ConnectionFactory。它还提供一套简单的管理接口以方便地对这些JMS对象进行管理。通常它只是将工作代理给
-                      核心服务器。如果你
不需要在服务器端进行JMS对象的部署与管理,可以将它从é…
ç½®ä¸­åŽ»æŽ‰ã€‚</para>
-            </listitem>
-        </itemizedlist>
-    </section>
-    <section id="server.microkernel.configuration">
-        <title>JBoss AS4 MBean 服务</title>
-        <note>
-            <para>本节只讨论在JBoss AS 4上配置ActiveMQ。其与JBoss 
Microcontainer的配置很相似。</para>
-        </note>
-        <para>
-            <programlisting>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;server&gt;
-
-   &lt;mbean 
code="org.apache.activemq.service.ActiveMQFileConfigurationService"
-      name="org.apache.activemq:service=ActiveMQFileConfigurationService"&gt;
-   &lt;/mbean&gt;
-
-   &lt;mbean code="org.apache.activemq.service.JBossASSecurityManagerService"
-      name="org.apache.activemq:service=JBossASSecurityManagerService"&gt;
-   &lt;/mbean&gt;
-
-   &lt;mbean code="org.apache.activemq.service.ActiveMQStarterService"
-      name="org.apache.activemq:service=ActiveMQStarterService"&gt;
-      &lt;!--let's let the JMS Server start us--&gt;
-         &lt;attribute name="Start"&gt;false&lt;/attribute&gt;
-
-      &lt;depends optional-attribute-name="SecurityManagerService"
-         
proxy-type="attribute"&gt;org.apache.activemq:service=JBossASSecurityManagerService&lt;/depends&gt;
-      &lt;depends optional-attribute-name="ConfigurationService"
-         
proxy-type="attribute"&gt;org.apache.activemq:service=ActiveMQFileConfigurationService&lt;/depends&gt;
-   &lt;/mbean&gt;
-
-   &lt;mbean code="org.apache.activemq.service.ActiveMQJMSStarterService"
-      name="org.apache.activemq:service=ActiveMQJMSStarterService"&gt;
-      &lt;depends optional-attribute-name="ActiveMQServer"
-         
proxy-type="attribute"&gt;org.apache.activemq:service=ActiveMQStarterService&lt;/depends&gt;
-   &lt;/mbean&gt;
-   
-&lt;/server&gt;
-            </programlisting>
-        </para>
-        <para>这个jboss-service.xml包
含在activemq-server.sar文件中,它用来配置AS4中嵌å…
¥è¿è¡Œçš„ActiveMQ。
-              在这个配置文件中我们启动了以下几
个服务:</para>
-        <itemizedlist>
-            <listitem>
-                <para>ActiveMQFileConfigurationService</para>
-                <para>这个MBean服务的任务是管理 
<literal>FileConfiguration POJO</literal>的生命周期。</para>
-            </listitem>
-            <listitem>
-                <para>JBossASSecurityManagerService</para>
-                <para>这个MBean服务管理着 
<literal>JBossASSecurityManager</literal> POJO的生命周期。</para>
-            </listitem>
-            <listitem>
-                <para>ActiveMQStarterService</para>
-                
<para>这个MBean服务管理着<literal>ActiveMQServer</literal> 
POJO。它依赖于 JBossASSecurityManagerService 和
-                      ActiveMQFileConfigurationService 这两个MBean。</para>
-            </listitem>
-            <listitem>
-                <para>ActiveMQJMSStarterService</para>
-                <para>这个MBean服务管理着 
<literal>JMSServerManagerImpl</literal> 
POJO对象。如果不需要JMS,可以去掉这个服务。</para>
-            </listitem>
-            <listitem>
-                <para>JMSServerManager</para>
-                <para>用于启动JMSServerManager。</para>
-            </listitem>
-        </itemizedlist>
-    </section>
-    <section id="usingserver.mainconfig">
-        <title>主配置文件</title>
-        <para>ActiveMQ 核心服务的配置保存在 
<literal>activemq-configuration.xml</literal>文件中。
-         FileConfiguration bean 
读取这个文件来对消息服务器进行配置。</para>
-        <para>ActiveMQ有很多的配置参数。采用默认的é…
ç½®åœ¨ç»å¤§å¤šæ•°æƒ…
况下可以很好的运行。事实上每一个参数都有默认的处理,å›
 æ­¤ä¸€ä¸ªåªåŒ…含有一个空
-              的<literal>configuration</literal>的é…
ç½®æ–‡ä»¶æ˜¯ä¸€ä¸ªæœ‰æ•ˆçš„文件。对各个参数的解释贯穿于本手册。ä½
 è¿˜å¯å‚参照
-               <link linkend="configuration-index">这里</link>来查找你
想看的参数。</para>
-    </section>
-</chapter>

http://git-wip-us.apache.org/repos/asf/activemq-6/blob/d18c42b0/docs/user-manual/zh/wildcard-routing.xml
----------------------------------------------------------------------
diff --git a/docs/user-manual/zh/wildcard-routing.xml 
b/docs/user-manual/zh/wildcard-routing.xml
deleted file mode 100644
index 91868fe..0000000
--- a/docs/user-manual/zh/wildcard-routing.xml
+++ /dev/null
@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<!-- 
============================================================================= 
-->
-<!-- Copyright © 2009 Red Hat, Inc. and others.                               
     -->
-<!--                                                                           
    -->
-<!-- The text of and illustrations in this document are licensed by Red Hat 
under  -->
-<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license 
("CC-BY-SA"). -->
-<!--                                                                           
    -->
-<!-- An explanation of CC-BY-SA is available at                                
    -->
-<!--                                                                           
    -->
-<!--            http://creativecommons.org/licenses/by-sa/3.0/.                
    -->
-<!--                                                                           
    -->
-<!-- In accordance with CC-BY-SA, if you distribute this document or an 
adaptation -->
-<!-- of it, you must provide the URL for the original version.                 
    -->
-<!--                                                                           
    -->
-<!-- Red Hat, as the licensor of this document, waives the right to enforce,   
    -->
-<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent    
    -->
-<!-- permitted by applicable law.                                              
    -->
-<!-- 
============================================================================= 
-->
-
-<chapter id="wildcard-routing">
-    <title>使用通配符实现消息路由</title>
-    <para>ActiveMQ支持使用带通配符的地址对消息路由。</para>
-    
<para>例如,当创建一个队列时使用了地址<literal>queue.news.#</literal>,那么它就能接收
-          所有和这个地址通配符相é…
çš„每一个地址的消息。这样的地址如 <literal
-            >queue.news.europe</literal> 或 <literal>queue.news.usa</literal> 
或 <literal
-            >queue.news.usa.sport</literal>等。这样一个消息接收者
可以接收<literal>一组</literal>相关
-          的地址的消息,而不是只能指定一个å…
·ä½“的地址。</para>
-    <note>
-        <para>用JMS的术语来说,这个功能就是å…
è®¸åˆ›å»ºâ€œè¯é¢˜ç»„”(topic hierarchy)。</para>
-    </note>
-    
<para>要使用本功能需要将<literal>wild-card-routing-enabled</literal>属性设置为<literal>true</literal>。
-        这个属性在 <literal>activemq-configuration.xml</literal> 
文件中。默认值是<literal>true</literal>。</para>
-    <para>关于通配符的语法参见<xref
-            linkend="wildcard-syntax" /> 章及 <xref
-            linkend="topic-hierarchy-example" />。</para>
-</chapter>

http://git-wip-us.apache.org/repos/asf/activemq-6/blob/d18c42b0/docs/user-manual/zh/wildcard-syntax.xml
----------------------------------------------------------------------
diff --git a/docs/user-manual/zh/wildcard-syntax.xml 
b/docs/user-manual/zh/wildcard-syntax.xml
deleted file mode 100644
index 4d6feb4..0000000
--- a/docs/user-manual/zh/wildcard-syntax.xml
+++ /dev/null
@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<!-- 
============================================================================= 
-->
-<!-- Copyright © 2009 Red Hat, Inc. and others.                               
     -->
-<!--                                                                           
    -->
-<!-- The text of and illustrations in this document are licensed by Red Hat 
under  -->
-<!-- a Creative Commons Attribution–Share Alike 3.0 Unported license 
("CC-BY-SA"). -->
-<!--                                                                           
    -->
-<!-- An explanation of CC-BY-SA is available at                                
    -->
-<!--                                                                           
    -->
-<!--            http://creativecommons.org/licenses/by-sa/3.0/.                
    -->
-<!--                                                                           
    -->
-<!-- In accordance with CC-BY-SA, if you distribute this document or an 
adaptation -->
-<!-- of it, you must provide the URL for the original version.                 
    -->
-<!--                                                                           
    -->
-<!-- Red Hat, as the licensor of this document, waives the right to enforce,   
    -->
-<!-- and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent    
    -->
-<!-- permitted by applicable law.                                              
    -->
-<!-- 
============================================================================= 
-->
-
-<chapter id="wildcard-syntax">
-    <title>了解 ActiveMQ 通配符的语法</title>
-    <para>ActiveMQ使用了一种专门的通配符语法来配置安å…
¨ã€åœ°å€åŠæŽ¥æ”¶è€…(consumer)的创建。</para>
-    <para>这种语法与 <ulink 
url="http://www.amqp.org";>AMQP</ulink>所用的语法相似。</para>
-    <para>一个ActiveMQ的通配符表达式是由一些由“<literal
-            >.</literal>”分隔的单词组成。</para>
-    
<para>特殊字符“<literal>#</literal>”和“<literal>*</literal>”在表达式中可作为一个单词,它们代表
-        特殊的意义。</para>
-    
<para>字符“<literal>#</literal>”表示“零或多个单词的任意排列”。</para>
-    <para>字符“<literal>*</literal>”表示“一个单词”。</para>
-    <para>因此,通配符表达式“news.europe.#”可以匹é…
â€œnews.europe”、“news.europe.sport”、
-        
“news.europe.politics”以及“news.europe.politics.regional”,但是与“news.usa”、
-        “news.usa.sport” 及 “entertainment”不相匹配。</para>
-    <para>通配符“news.*”与“news.europe”匹é…
ï¼Œä½†ä¸ä¸Žâ€œnews.europe.sport”匹配。</para>
-    <para>通é…
ç¬¦â€œnews.*.sport”与“news.europe.sport”及“news.usa.sport”匹é…
ï¼Œä½†ä¸Ž
-        “news.europe.politics”不匹配。</para>
-</chapter>

Reply via email to