MuleStudio中文手册
目录
1.开始使用Mule Studio (4)
1)介绍 (4)
2)Mule Studio是什么? (4)
3)安装Mule Studio (4)
4)创建首个Mule项目 (6)
5)创建一个信息流程 (10)
6)创建订单处理例子 (10)
7)保存项目 (18)
8)运行例子 (18)
9)停止运行例子 (20)
10)基于例子模板创建新Mule项目 (20)
2.Mule Studio基本概念 (23)
1)理解Mule Studio的不同部件 (23)
2)理解Mule Studio中的流程 (25)
3.Mule Studio工具箱 (25)
1)端点(Endpoints) (25)
2)组件(Components) (26)
3)转换器(Transformers) (26)
4)过滤器(Filters) (27)
5)流程控制(Flow Controls) (27)
6)路由器[分支条件](Routers) (28)
7)活动范围(Scopes) (28)
8)云连接器(Cloud Connectors) (28)
4.端点(EndPoints) (28)
1)文件传输协议(FTP)端点 (28)
2)文件端点(File Endpoint) (31)
3)通用端点(Generic Endpoint) (33)
4)HTTP端点 (35)
5)Java消息服务端点[Java Message Service(JMS)Endpoint] (38)
6)VM端点 (40)
5.组件(Components) (40)
1)Java组件(Component) (40)
2)显示组件(Echo Component) (41)
3)日志组件(Logger) (42)
4)REST组件(REST) (42)
5)SOAP组件(SOAP) (43)
6.转换器(Transformers) (44)
1)自定义转换器(Custom Transformer) (45)
2)Object-to-XML/JSON转发器(Object-to-XML) (45)
3)脚本转换器(Script Transformer) (47)
4)转换器引用(Transformer Ref) (48)
5)XSLT转换器(XSLT Transformer) (49)
6)Xml-To-Object转换器(Xml/Json-To-Object) (50)
7.过滤器(Filters) (52)
1)自定义过滤器(Custom Filter) (52)
2)异常过滤器(Exception Filter) (53)
3)表达式过滤器(Expression Filter) (53)
4)信息属性过滤器(Message Property Filter) (54)
5)负载过滤器(Payload Filter) (55)
6)全局过滤器引用(Filter Ref) (55)
7)正则表达式过滤器(RegEx Filter) (56)
8)匹配符过滤器(Wildcard Filter) (57)
8.流程控制(Flow Control) (57)
1)拆分器(Splitter) (57)
9.路由器[分支条件](Routers) (58)
1)全部分支(All router) (58)
2)选择分支(Choice Router) (60)
10.活动范围(Scopes) (63)
1)异步处理块(Async) (63)
11.云连接器(Cloud Connectors) (63)
1)Salesforce云连接器 (63)
2)Twitter云连接器 (66)
12.全局配置 (67)
1)创建全局元素 (67)
2)全局配置元素清单 (68)
3)配置云连接器 (68)
13.导入现有项目到Mule Studio (71)
1)导入整个项目 (71)
2)导入单个配置文件 (72)
14.从Mule Studio导出项目 (74)
1)从Mule Stodio导出项目到Mule iON云平台 (74)
2)导出Mule项目为发布文件 (77)
15.Mule Studio例子 (78)
1)基于例子模板创建Mule项目 (78)
2)理解Echo例子 (80)
3)理解Order Discounter例子 (80)
4)理解Order Fulfillment例子 (81)
1.开始使用Mule Studio
1)介绍
欢迎阅读Mule Studio入门手册！本手册将引领你下载并启动Mule Studio，然后创建和执行简单的例子。阅读这个手册后，你将学会：
?安装Mule Studio；
?学会快速创建、编辑和运行Mule ESB流程。
2)Mule Studio是什么?
Mule Studio是一个功能强大、用户界面友好的基于Eclipse的开发工具。你不需要深入了解Mule的XML配置语法，就可以在几分钟内轻松的创建、编辑、测试Mule ESB流程。
?对于非Mule开发人员或者Mule新手开发人员，Mule Studio其中一个最大的好处是用图形化的方式创建Mule ESB 流程；
?对于有经验的Mule开发人员也可以得益于Mule Studio这个功能强大的工具，通过Mule Studio可以在图形界面和XML编辑界面中来回切换编辑，而且通过对图形界面生成的XML配置文件能够更好的理解Mule ESB的配置。
当前Mule Studio有什么限制？
Mule Studio的目标是支持Mule ESB的全部功能。在初始发布版本已经可以支持大部分的功能，其他功能还在开发中。对于剩余功能的开发，Mule Studio有一个发布的路线图。尽管当前有些连接器暂时未支持，开发人员仍然可以通过手工编辑XML配置文件的方式实现。
Mule Studio将支持Mule什么版本？
Mule Studio将会支持3.1.1以后的Mule社区版和Mule企业版。Mule Studio的流程编排功能只有在3.X版本以后才能支持。Mule Studio支持最新的流程编排功能，服务功能暂时未能支持。
3)安装Mule Studio
这个章节说明如何下载和安装Mule Studio，包括：Windows,Linux and Mac OS X各个版本。请看下面的说明：
安装前提:
?确认你的机器已经安装Java JDK1.6以后的版本，并配置正确。
开始安装:
?从以下页面下载Mule Studio:Mule Studio Download Page；
?文件下载后，请解压文件；
?执行Mule Studio主程序：
Linux环境
在执行mulestudio前，请确认文件是否有执行权限。如果没有，请执行以下命令：chmod u+x muleStudio
?对于32-bit和64-bit Linux:
muleStudio主程序放在目录:/MuleStudio
在控制台执行：./muleStudio或者在Linux图形界面双击muleStudio图标运行。
Mac OS X环境
?对于32-bit和64-bit Mac OS X:
请执行位于目录“/MuleStudio”的muleStudio.app。
Windows环境
?对于32-bit和64-bit Windows:
请执行位于目录“/MuleStudio”的muleStudio.exe。
4)创建首个Mule项目
本章节将教会你在开始使用Mule Studio前，设置Eclipse工作区间并创建Mule项目。启动Mule Studio主程序后，会弹出设置工作区的窗口。你可以设置工作区的目录为:/Users/muleStudio/workspace，如下图所示：
?选择工作区目录后，将会出现一个欢迎页面。通过这个欢迎页面，你可以创建新的Mule项目、基于例子模板创建新的Mule项目、查看入门手册或者学习Mule3更多的信息。
?在欢迎页面选择新建Mule项目（New Mule Project）选项，将会弹出新建Mule项目向导。
?在新建Mule项目向导中，你可以新建Mule项目或者基于例子模板创建新的Mule项目。
创建一个新的Mule项目
为了创建一个新的Mule项目，请在向导中输入如下信息：
?输入新项目的名称，在本例子中输入：OrderProcessing；?输入描述信息（可选录入）；
?选择默认的Mule运行版本(Server Runtime)；
?点击“next”按钮；
在下一个向导窗口，你需要创建新的流程或者以后再创建流程：
?默认选择“Select to create a new message flow in the project”；.
?输入流程名称(Name)，对于文件名称（File Name），系统将自动生成；
?描述信息可选录入，最后点击“finish”按钮；
现在开始你可以正式的开始使用Mule Studio!下面截图就是Mule Studio的开发环境：
8全局元素编辑视图
9流程配置XML编辑视图
10问题输出窗口
5)创建一个信息流程
本章节将介绍如何开始创建信息流程。
打开src/main/resources文件夹，点击默认已经生成的信息流，在工具箱中拖放元素到图形编辑视图。
创建新的信息流程，可以在选择项目后，鼠标右键（或者菜单File->New->Mule Message Flow），将会弹出输入信息流程名字的窗口，点击“finish”按钮，系统将会自动创建新的信息流程。
什么是流程?
Mule流程是编排服务的新方法。流程可以把很多功能和组件非常柔性的集成在一起。要详细了解流程工作原理，可以参考：Using Flows for Service Orchestration
为了编排信息流程，Mule Studio提供了云连接器、组件、端点、路由器、活动范围和转换器等多种元素。
6)创建订单处理例子
本章节将介绍如何从零开始创建简单的信息流程。
这个订单处理例子到底要做什么？
这个简单的例子是接收XML格式的订单作为输入，并分发到不同的城市，例如：Atlanta,San Francisco和other。文件端点将作为起点，然后数据将通过选择分支传送到不同的输出文件夹：ATL,SFO和Other。
创建订单处理例子流程步骤：
首先请下载订单数据：OrdersData.这个zip文件包含了我们需要创建和运行这个例子的所有文件。在这个zip文件中包含目录Input和里面的xml文件：atlanta.xml,sanfrancisco.xml and other.xml，另外还包括目录结构的output目录。解压这个文件到目录/Users/MuleStudio。如果你决定使用其他目录，那么你需要改变例子的配置指向新的目录。
从工具箱拖放端点、组件和路由器到画布
首先从工具箱中选择文件端点（file endpoint）拖放到画布中，然后拖放显示组件(echo component)放到文件端点后面，界面截图如下：
然后从工具难拖放“选择分支(Choice)”元素紧接在Echo组件后面，界面如下：
添加选择分支(Choice)元素后，界面如下所示：
虚线框内。最后界面如下：
配置端点、组件、路由和文件输出1.配置Data Center 文件输入端点
1.1.双击第一个文件端点(file endpoint)；
1.2.在目录中输入文件目录，例如：/Users/muleStudio/OrdersData/Input ；1.3.名称中输入：Data Center ；1.4.点击“OK ”按钮。
2.配置数据显示(Echo)组件
2.1.双击Echo 组件；
2.2输入名字：Transform Data ；2.
3.点击“OK ”按钮。
3.配置文件输出端点
3.1.双击流程末端第一个文件端点(file endpoint)，端点参数设置窗口将会显示；
3.2.在名字(Name)参数中输入：Atlanta；
3.3.在输出目录（path）中设置输出的文件目录，本例子为：Users/muleStudio/OrdersData/Output/ATL 3.
4.点击“OK”按钮。
3.5.双击流程末端第二个文件端点(file endpoint)，端点参数设置窗口将会显示；
3.6.在名字(Name)参数中输入：San Francisco；
3.7.在输出目录（path）中设置输出的文件目录，本例子为：Users/muleStudio/OrdersData/Output/SFO 3.8.点击“OK”按钮；
3.9.双击流程末端第三个文件端点(file endpoint)，端点参数设置窗口将会显示；
3.10.在名字(Name)参数中输入：Other；
3.11.在输出目录（path）中设置输出的文件目录，本例子为：Users/muleStudio/OrdersData/Output/Other
3.12.点击“OK”按钮；
4.配置订单选择分支（Choice）路由器
4.1.双击选择分支(Choice)，Choice属性设置窗口将会显示；
4.2.在名字(Name)参数中输入：Order Router；
4.3.双击Route中的第一个端点：“Atlanta”端点，Route属性窗口将会显示；
4.4.在计算引擎(Evaluator)中下拉选择：xpath；.
4.5.输入xpath表达式(expression)：/shiporder/shipto/city="Atlanta"；
4.6.点击“OK”按钮；
4.7.你将看到“Atlanta”端点的路由已经设置成功；
4.8.双击Route中的第二个端点：“San Francisco”端点，Route属性窗口将会显示；
4.9.在计算引擎(Evaluator)中下拉选择：xpath；
4.10.输入xpath表达式(expression)：/shiporder/shipto/city="San Francisco"；
4.11.点击“OK”按钮；
4.12.你将看到“San Francisco”端点的路由已经设置成功；
4.13.双击Route中的第三个端点：“Other”端点，Route属性窗口将会显示；
4.9.在计算引擎(Evaluator)中下拉选择：xpath；
4.10.输入xpath表达式(expression)：/shiporder/shipto/city；
4.11.点击“OK”按钮；
4.12.你将看到“Atlanta、San Francisco、Other”3个端点的路由全部设置成功，如下图所示：
下图是全部设置完成的信息流程图：
7)保存项目
保存项目：选择菜单File->Save
备注：如果你保存项目，而忘记配置流程参数，Mule Studio将会提示问题建议。例如：如果你忘记配置文件端点，问题视图将会支持文件端点没有设定输入目录。
8)运行例子
1.鼠标右键点击订单处理流程(OrderProcessing.mflow)；
2.选择Run as->Mule Application.
3.如果你还没有保存项目，保存和运行窗口将会显示。点击“OK”按钮。
4.例子运行成功，如下图控制台所示，输入文件按照设定的流程规则分发到对应的输出目录：
5.下面我们检查以下运行效果：
?输入目录“Input”在运行处理后，订单将会全部删除；
?输出子目录ATL、SFO、Other将根据设定的目标城市规则分发到对应的订单XML文件，如下图所示：
如果要停止正在运行的例子，请点击“Terminate”按钮，如下图所示：