activemq-artemis/docs/quickstart-guide/zh/examples.xml

<?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="examples">
   <title>运行ActiveMQ例子</title>
   <para>在ActiveMQ的<literal>examples</literal>目录下有两组例子，它们是：</para>
   <itemizedlist>
      <listitem>
         <para>JMS例子 - 这些例子展示的是使用JMS发送与接收消息的功能。</para>
      </listitem>
      <listitem>
         <para>Java EE 例子 - 这些例子展示的是与应用服务器的集成，例如MDB，EJB，Servlet等。</para>
      </listitem>
   </itemizedlist>
   <section id="examples.jms">
      <title>JMS例子</title>
      <para>所有JMS都有统一的格式。每个例子都有自己的目录，它的内容包括：</para>
      <itemizedlist>
         <listitem>
            <para><literal>build.xml</literal></para>
            <para>ant的build文件，用来运行例子。</para>
         </listitem>
         <listitem>
            <para><literal>src</literal> 目录</para>
            <para>例子的代码。</para>
         </listitem>
         <listitem>
            <para><literal>server0</literal>配置目录</para>
            <para>它包含了运行服务器所需要的配置文件。有的集群的例子可能有多个这样的目录，如<literal>server0</literal>, 
                  <literal>server1</literal>等。</para>
         </listitem>
      </itemizedlist>
      <para>在运行每个例子时，都要先启动一个或多个单独的服务器。当例子运行完毕，再将它们停止。</para>
      <para>做为演示我们这里运行queue例子。其它的例子可以参见用户手册。</para>
      <para>首先打开一个命令行窗口（shell），进入到ActiveMQ的 <literal
            >examples/jms/queue</literal>目录。</para>
      <para>敲入命令<literal>./build.sh</literal> (或者在Windows上<literal>build.bat</literal>），你
         将看到如下的输出：</para>
      <programlisting>Buildfile: build.xml

run:

init:

compile:
     [echo] src.example.dir=/home/andy/projects/activemq/trunk/examples/jms/queue/src
    [javac] Compiling 5 source files to /home/andy/projects/activemq/trunk/examples/jms/queue
/build/classes

runExample:
     [java] 10:41:04,149 INFO  @main [JMSExample] activemq.example.runServer is true
     [java] 10:41:04,149 INFO  @main [JMSExample] starting server with config 'server0'
 logServerOutput true
     [java] 10:41:04,149 INFO  @main [JMSExample] and vm args: -Xms512M,-Xmx512M,-XX:+U
seParallelGC,-XX:+AggressiveOpts,-XX:+UseFastAccessorMethods,-Djava.util.logging.config.
file=/home/andy/projects/activemq/trunk/examples/jms/common/../../../src/config/stand-alone/no
n-clustered/logging.properties
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 INFO  @main [Journal
StorageManager] AIO journal selected
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 WARN  @main [Journal
StorageManager] AIO wasn't located on this platform, it will fall back to using pure Jav
a NIO. If your platform is Linux, install LibAIO to enable the AIO journal
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:08,437 WARN  @main [Securit
yStoreImpl] It has been detected that the cluster admin password which is used to replic
ate management operation from one node to the other has not had its password changed fro
m the installation default. Please see the ActiveMQ user guide for instructions o
n how to do this.
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO  @main [ActiveMQCo
nnectionFactory] read only is false
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO  @main [ActiveMQCo
nnectionFactory] read only is false
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,941 INFO  @main [ActiveMQCo
nnectionFactory] read only is false
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN  @main [JMSServ
erManagerImpl] Binding for java:/ConnectionFactory already exists
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:10,991 WARN  @main [JMSServ
erManagerImpl] Binding for java:/XAConnectionFactory already exists
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO  @main [Messagi
ngServerImpl] ActiveMQ Server version 2.0.0.BETA5 (buzz-buzz, 107) started
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:10:41:11,241 INFO  @main [ActiveMQBoot
strapServer] ActiveMQ server started
     [java] org.apache.activemq.jms.example.SpawnedJMSServer out:STARTED::
     [java] 10:41:11,276 INFO  @main [JMSExample] using server0/client-jndi.properties f
or jndi
     [java] Sent message: This is a text message
     [java] Received message: This is a text message
     [java] 
     [java] #####################
     [java] ###    SUCCESS!   ###
     [java] #####################

BUILD SUCCESSFUL
Total time: 13 seconds
</programlisting>
      <para>恭喜！你已经成功地运行了你的第一个ActiveMQ例子。试着运行其它的例子。</para>
   </section>
   <section id="examples.messaging">
      <title>Java EE例子</title>
      <para>Java EE的例子需要首先运行一个JEE应用服务器。这些例子包括MDB，Servlet，EJB等等。你首先要安装JBoss应用服务
         器。参见前面的章节进行安装。</para>
      <para>这里我们将用MDB例子来说明。有关其它例子的详细信息参见用户手册。首先确认JBoss应用服务器已经启动。</para>
      <para>如同其它Java EE例子一样，MDB需要部署到应用服务器。第一，将<literal>JBOSS_HOME</literal>环境变量
         指向你的应用服务器安装目录。如在Linux下：</para>
      <programlisting>export JBOSS_HOME=/home/jbossas5.1/build/output/jboss-5.1.0.GA</programlisting>
      <para>然后就可以进行部署了。在<literal>examples/javaee/mdb</literal>目录下运行：</para>
      <programlisting>./build.sh deploy</programlisting>
      <para>它将创建一个“messaging"的AS配置，并用它来启动AS服务器。</para>
      <para>在命令行窗口你会看到如下的输出：</para>
      <programlisting>Buildfile: build.xml

validate-jboss:

deploy:

deploy-resources:
     [copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
     /server/default-with-activemq/deploy/activemq.sar
     [copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
     /server/default-with-activemq/deploy/activemq.sar

init:

compile:

jar:
      [jar] Building jar: /home/andy/projects/activemq/trunk/examples/javaee/mdb/build/mdb-exa
      mple.jar

ear:
      [jar] Building jar: /home/andy/projects/activemq/trunk/examples/javaee/mdb/build/mdb-exa
      mple.ear

deploy-ear:
     [copy] Copying 1 file to /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA

     .......


     [exec] 16:01:04,607 INFO  [JBossASKernel] 	Class:javax.jms.MessageListener
     [exec] 16:01:04,607 INFO  [JBossASKernel] Added bean(jboss.j2ee:ear=mdb-example.ear,
     jar=mdb-example.jar,name=MessageMDBExample,service=EJB3) to KernelDeployment of: 
     mdb-example.jar
     [exec] 16:01:04,702 INFO  [EJBContainer] STARTED EJB: org.apache.activemq.javaee.example.server
     .MDBExample ejbName: MessageMDBExample
     [exec] 16:01:09,496 INFO  [TomcatDeployment] deploy, ctxPath=/mdb-example
     [exec] 16:01:09,812 WARNING [config] Unable to process deployment descriptor for cont
     ext '/mdb-example'
     [exec] 16:01:09,812 INFO  [config] Initializing Mojarra (1.2_12-b01-FCS) for context 
     '/mdb-example'
     [exec] 16:01:09,958 INFO  [Http11Protocol] Starting Coyote HTTP/1.1 on http-127.0.0.1-
     8080
     [exec] 16:01:09,990 INFO  [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009
     [exec] 16:01:10,001 INFO  [ServerImpl] JBoss (Microcontainer) [5.1.0.GA (build: SVNTag
     =JBoss_5_1_0_GA date=200905151005)] Started in 6m:21s:797ms

</programlisting>
      <para>现在我们可以运行例子了。在<literal>mdb</literal>目录下运行下列命令：</para>
      <programlisting>./build.sh</programlisting>
      <para>你将看到如下输出：</para>
      <programlisting>Buildfile: build.xml

run:

init:

compile:

runExample:
     [java] Sent message: This is a text message

BUILD SUCCESSFUL
Total time: 7 seconds</programlisting>
      <para>在JBoss应用服务器端你还会看到如下的输出：</para>
      <programlisting>16:27:54,703 INFO  [STDOUT] message This is a text message received</programlisting>
      <para>然后在<literal>mdb</literal>目录下运行下面的命令可以将这个例子卸载。</para>
      <programlisting>./build.sh undeploy</programlisting>
      <para>你将会看到如下的输出：</para>
      <programlisting>Buildfile: build.xml

validate-jboss:

undeploy:

undeploy-misc:
   [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
   /server/default-with-activemq/deploy/mdb-example.ear
   [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
   /server/default-with-activemq/deploy/activemq.sar/activemq-queues.xml
   [delete] Deleting: /home/andy/projects/jbossas5.1/build/output/jboss-5.1.0.GA
   /server/default-with-activemq/deploy/activemq.sar/activemq-jms.xml

BUILD SUCCESSFUL
Total time: 1 second
</programlisting>
      <para>你还会在窗口输出中看到MDB的应用最終被删除了，如：</para>
      <programlisting>16:36:45,277 INFO  [EJBContainer] STOPPED EJB: org.jboss.javaee.example.server.MDBExample 
         ejbName: MessageMDBExample
</programlisting>
      <para>恭喜！你已经成功地部署并运行了一个Java EE的例子。</para>
   </section>
</chapter>