Hello, Mule!

Prerequisites

準備

• You must have the JDK 5 or later installed on the computer where you will install Mule.
• 你的電腦上必須安裝了JDK5 或者更高版本的JDK。
  

Download and Install Mule

下載和安裝Mule

1. In your browser, go to the Mule download page.
2. 打開瀏覽器，跳轉至 Mule download page.
   
3. Use the .zip button for Windows and the .tar.gz button for Linux/UNIX. On Linux/UNIX, if wget ships by default on your distribution, or if you have installed wget, you can also enter the following command in a terminal window to download Mule:

   wget http://dist.codehaus.org/mule/distributions/mule-standalone-3.2.0.tar.gz).

4.  windows下載 .zip Linux/UNIX 下載 .tar.gz，如果安裝了wget 也可以再命令行輸入下面的命令安裝Mule；

   wget http://dist.codehaus.org/mule/distributions/mule-standalone-3.2.0.tar.gz).

5. Extract the files from it into the directory you want to use as your Mule home directory.

   Do not install Mule in a directory path that contains spaces!

   On Linux/UNIX, in a terminal window switch to your installation directory, and enter the following command:

   tar -xvzf mule-standalone-3.2.0.tar.gz

6. 注意安裝目錄中不能出現空格 。在Linux/UNIX中 打開命令行輸入下面的命令安裝

   tar -xvzf mule-standalone-3.2.0.tar.gz

If you're upgrading from Mule ESB 2.2, read this: Previous versions of Mule ESB required setting an environment variable called MULE_HOME to run Mule. As of Mule 3.1, the MULE_HOME variable is no longer required. Make sure to remove this setting from your environment before running Mule 3.2. This is also true of a previously set MULE_BASE variable. 如果是從Mule ESB 2.2升級的，注意這段：3.x之前版本的Mule ESB需要設置環境變量MULE_HOME去運行Mule。但從3.1開始MULE_HOME已經不再需要了。在運行3.2版本的Mule前確認已經移除了MULE_HOME的環境變量

Install Eclipse and Mule IDE

To begin developing a Mule application, install the Mule IDE.

1. If you do not have Eclipse version 3.4 or later, download the latest version of Eclipse fromhttp://www.eclipse.org/downloads/ and install it. MuleSoft recommends the Eclipse Java EE Developers package, but you can also install the Java Developers package.
2. Start Eclipse, and set up a workspace for your installation of Mule. (Important: Make sure your workspace does not have a space in the directory path or the Mule application you develop will not run.)

For Eclipse version 3.5/3.6/3.7 (Galileo/Helios/Indigo) follow these steps to install Mule IDE:

1. In the workbench view, click Help > Install New Software.
2. Click the Add button next to the Work with text box, enter http://dist.muleforge.org/mule-ide/updates-2.1.x/ for the location, and pressEnter. The Mule IDE now appears in your list of available software.
3. Select the Mule IDE check box and click Next. Eclipse will process for a moment. When Eclipse is finished processing, clickNext again.
4. Review the Mule IDE license, select the option to accept the license, and then clickFinish.
5. Click Yes to restart Eclipse.

If you are using Eclipse version 3.4 (Ganymede), read this:

1. In the workbench view, choose Help > Software Updates.
2. On the Available Software tab, click Add Site.
3. Specify http://dist.muleforge.org/mule-ide/updates-2.1.x/ for the location and clickOK. It now appears in your list of available software.
4. Expand the list until you see the Mule IDE. Choose Mule IDE and clickInstall.
5. Click Next, read and accept the license agreement terms, and clickFinish.
6. Choose to run the installation in the background.
7. When prompted, restart Eclipse.

Configure the Mule Distribution

To execute Mule properly, you must specify in the IDE the location of your Mule distribution.

1. In the Eclipse workbench, choose Window > Preferences. (On Mac OS X, chooseEclipse > Preferences.)
2. Choose Mule, and then click Add. 
3. Specify your Mule home directory. Then click OK.
4. Select the Mule distribution's check box, click Apply, then clickOK.

Create a Mule Application

1. Choose File > New > Project, expand the Mule folder and selectMule Project, and then click Next.
2. Enter a name for the project, ensuring that there is no space in the project name. If you want to put the project in a location other than the default workspace, clear theUse default location check box and specify a new file location.
3. Click Finish so the Mule IDE will generate your project. The project just created is added to the Package Explorer pane. The Mule libraries from the distribution you selected are contained in the project.
4. Create a conf directory in your Mule project.
5. Create a new file in the conf directory called "mule-config.xml."
6. Add the following configuration to mule-config.xml:

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:script="http://www.mulesoft.org/schema/mule/scripting"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="
      http://www.mulesoft.org/schema/mule/scripting http://www.mulesoft.org/schema/mule/scripting/3.2/mule-scripting.xsd
      http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/3.2/mule.xsd" >

    <simple-service name="hello" address="http://localhost:8080/hello">
        <script:component>
            <script:script engine="groovy">
                <script:text>return "Hello World"</script:text>
            </script:script>
        </script:component>
    </simple-service>
</mule>

Note that what you have just done is create a Mule application, which is XML-driven. When you create a configuration, you are creating an application.

Run the Application

1. In the Package Explorer, expand the conf directory, and right-click themule-config.xml configuration file.
2. Choose Run As > Mule Server.

A new run configuration is created automatically and the server is started. To trigger the Hello service, connect tohttp://localhost:8080/hello in your browser. The server should respond back with the text "Hello World."

That's it! You have a complete Mule development environment up and running and have created your first application.

Next Steps

• Run the example launcher for the included examples to learn more about how to program Mule.
• You can now modify the configuration file, or create a new configuration file as described in theMule IDE User Guide.
• If you want to use Maven for a task such as using the Maven archetypes for creating transports and modules, seeSetting Up Eclipse for Use with Maven for complete instructions.