activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From clebertsuco...@apache.org
Subject [01/11] activemq-6 git commit: ACTIVEMQ6-49 Remove the obsolete chinese doc
Date Mon, 01 Dec 2014 17:43:59 GMT
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>


Mime
View raw message