MuleStudio用户手册.docx
- 文档编号:30337441
- 上传时间:2023-08-13
- 格式:DOCX
- 页数:102
- 大小:5.15MB
MuleStudio用户手册.docx
《MuleStudio用户手册.docx》由会员分享,可在线阅读,更多相关《MuleStudio用户手册.docx(102页珍藏版)》请在冰豆网上搜索。
MuleStudio用户手册
MuleStudio用户手册
VerBeta
MuleSoft(翻译:
eFutureInc.)
2011-07-26
1.开始使用MuleStudio
1)介绍
欢迎阅读MuleStudio入门手册!
本手册将引领你下载并启动MuleStudio,然后创建和执行简单的例子。
阅读这个手册后,你将学会:
安装MuleStudio;
学会快速创建、编辑和运行MuleESB流程。
2)MuleStudio是什么
MuleStudio是一个功能强大、用户界面友好的基于Eclipse的开发工具。
你不需要深入了解Mule的XML配置语法,就可以在几分钟内轻松的创建、编辑、测试MuleESB流程。
对于非Mule开发人员或者Mule新手开发人员,MuleStudio其中一个最大的好处是用图形化的方式创建MuleESB流程;
对于有经验的Mule开发人员也可以得益于MuleStudio这个功能强大的工具,通过MuleStudio可以在图形界面和XML编辑界面中来回切换编辑,而且通过对图形界面生成的XML配置文件能够更好的理解MuleESB的配置。
当前MuleStudio有什么限制
MuleStudio的目标是支持MuleESB的全部功能。
在初始发布版本已经可以支持大部分的功能,其他功能还在开发中。
对于剩余功能的开发,MuleStudio有一个发布的路线图。
尽管当前有些连接器暂时未支持,开发人员仍然可以通过手工编辑XML配置文件的方式实现。
MuleStudio将支持Mule什么版本
MuleStudio将会支持以后的Mule社区版和Mule企业版。
MuleStudio的流程编排功能只有在版本以后才能支持。
MuleStudio支持最新的流程编排功能,服务功能暂时未能支持。
3)安装MuleStudio
这个章节说明如何下载和安装MuleStudio,包括:
Windows,LinuxandMacOSX各个版本。
请看下面的说明:
安装前提:
确认你的机器已经安装JavaJDK以后的版本,并配置正确。
开始安装:
从以下页面下载MuleStudio:
MuleStudioDownloadPage;
文件下载后,请解压文件;
执行MuleStudio主程序:
Linux环境
在执行mulestudio前,请确认文件是否有执行权限。
如果没有,请执行以下命令:
chmodu+xmuleStudio
对于32-bit和64-bitLinux:
muleStudio主程序放在目录:
/MuleStudio
在控制台执行:
./muleStudio或者在Linux图形界面双击muleStudio图标运行。
MacOSX环境
对于32-bit和64-bitMacOSX:
请执行位于目录“/MuleStudio”的。
Windows环境
对于32-bit和64-bitWindows:
请执行位于目录“/MuleStudio”的。
4)创建首个Mule项目
本章节将教会你在开始使用MuleStudio前,设置Eclipse工作区间并创建Mule项目。
启动MuleStudio主程序后,会弹出设置工作区的窗口。
你可以设置工作区的目录为:
/Users/muleStudio/workspace,如下图所示:
选择工作区目录后,将会出现一个欢迎页面。
通过这个欢迎页面,你可以创建新的Mule项目、基于例子模板创建新的Mule项目、查看入门手册或者学习Mule3更多的信息。
在欢迎页面选择新建Mule项目(NewMuleProject)选项,将会弹出新建Mule项目向导。
在新建Mule项目向导中,你可以新建Mule项目或者基于例子模板创建新的Mule项目。
创建一个新的Mule项目
为了创建一个新的Mule项目,请在向导中输入如下信息:
输入新项目的名称,在本例子中输入:
OrderProcessing;
输入描述信息(可选录入);
选择默认的Mule运行版本(ServerRuntime);
点击“next”按钮;
在下一个向导窗口,你需要创建新的流程或者以后再创建流程:
默认选择“Selecttocreateanewmessageflowintheproject”;.
输入流程名称(Name),对于文件名称(FileName),系统将自动生成;
描述信息可选录入,最后点击“finish”按钮;
现在开始你可以正式的开始使用MuleStudio!
下面截图就是MuleStudio的开发环境:
界面参考:
序号
描述
1
项目结构树
2
src/main/resources存储可视流程定义文件.mflow
3
scr/Main/app包含Mule流程配置.xml文件
4
工具箱,包含:
Endpoints,components,transformers,filtersrouters,scopesandcloudconnectors,可以拖放生成流程图
5
画布,包含页面:
7,8,9
6
缩略图
7
图形界面的信息流程编辑器
8
全局元素编辑视图
9
流程配置XML编辑视图
10
问题输出窗口
5)创建一个信息流程
本章节将介绍如何开始创建信息流程。
打开src/main/resources文件夹,点击默认已经生成的信息流,在工具箱中拖放元素到图形编辑视图。
创建新的信息流程,可以在选择项目后,鼠标右键(或者菜单File->New->MuleMessageFlow),将会弹出输入信息流程名字的窗口,点击“finish”按钮,系统将会自动创建新的信息流程。
什么是流程
Mule流程是编排服务的新方法。
流程可以把很多功能和组件非常柔性的集成在一起。
要详细了解流程工作原理,可以参考:
UsingFlowsforServiceOrchestration
为了编排信息流程,MuleStudio提供了云连接器、组件、端点、路由器、活动范围和转换器等多种元素。
6)创建订单处理例子
本章节将介绍如何从零开始创建简单的信息流程。
这个订单处理例子到底要做什么
这个简单的例子是接收XML格式的订单作为输入,并分发到不同的城市,例如:
Atlanta,SanFrancisco和other。
文件端点将作为起点,然后数据将通过选择分支传送到不同的输出文件夹:
ATL,SFO和Other。
创建订单处理例子流程步骤:
首先请下载订单数据:
OrdersData.这个zip文件包含了我们需要创建和运行这个例子的所有文件。
在这个zip文件中包含目录Input和里面的xml文件:
and,另外还包括目录结构的output目录。
解压这个文件到目录/Users/MuleStudio。
如果你决定使用其他目录,那么你需要改变例子的配置指向新的目录。
从工具箱拖放端点、组件和路由器到画布
首先从工具箱中选择文件端点(fileendpoint)拖放到画布中,然后拖放显示组件(echocomponent)放到文件端点后面,界面截图如下:
然后从工具难拖放“选择分支(Choice)”元素紧接在Echo组件后面,界面如下:
添加选择分支(Choice)元素后,界面如下所示:
从工具箱拖放文件端点(fileendpoint)放到Choice的虚线框内,重复添加另外两个文件端点(fileendpoint)放到Choice的虚线框内。
最后界面如下:
配置端点、组件、路由和文件输出
1.配置DataCenter文件输入端点
.双击第一个文件端点(fileendpoint);
.在目录中输入文件目录,例如:
/Users/muleStudio/OrdersData/Input;
.名称中输入:
DataCenter;
.点击“OK”按钮。
2.配置数据显示(Echo)组件
.双击Echo组件;
输入名字:
TransformData;
.点击“OK”按钮。
3.配置文件输出端点
.双击流程末端第一个文件端点(fileendpoint),端点参数设置窗口将会显示;
.在名字(Name)参数中输入:
Atlanta;
.在输出目录(path)中设置输出的文件目录,本例子为:
Users/muleStudio/OrdersData/Output/ATL
.点击“OK”按钮。
.双击流程末端第二个文件端点(fileendpoint),端点参数设置窗口将会显示;
.在名字(Name)参数中输入:
SanFrancisco;
.在输出目录(path)中设置输出的文件目录,本例子为:
Users/muleStudio/OrdersData/Output/SFO
.点击“OK”按钮;
.双击流程末端第三个文件端点(fileendpoint),端点参数设置窗口将会显示;
.在名字(Name)参数中输入:
Other;
.在输出目录(path)中设置输出的文件目录,本例子为:
Users/muleStudio/OrdersData/Output/Other
.点击“OK”按钮;
4.配置订单选择分支(Choice)路由器
.双击选择分支(Choice),Choice属性设置窗口将会显示;
.在名字(Name)参数中输入:
OrderRouter;
.双击Route中的第一个端点:
“Atlanta”端点,Route属性窗口将会显示;
.在计算引擎(Evaluator)中下拉选择:
xpath;.
.输入xpath表达式(expression):
/shiporder/shipto/city="Atlanta";
.点击“OK”按钮;
.你将看到“Atlanta”端点的路由已经设置成功;
.双击Route中的第二个端点:
“SanFrancisco”端点,Route属性窗口将会显示;
.在计算引擎(Evaluator)中下拉选择:
xpath;
.输入xpath表达式(expression):
/shiporder/shipto/city="SanFrancisco";
.点击“OK”按钮;
.你将看到“SanFrancisco”端点的路由已经设置成功;
.双击Route中的第三个端点:
“Other”端点,Route属性窗口将会显示;
.在计算引擎(Evaluator)中下拉选择:
xpath;
.输入xpath表达式(expression):
/shiporder/shipto/city;
.点击“OK”按钮;
.你将看到“Atlanta、SanFrancisco、Other”3个端点的路由全部设置成功,如下图所示:
下图是全部设置完成的信息流程图:
7)保存项目
保存项目:
选择菜单File->Save
备注:
如果你保存项目,而忘记配置流程参数,MuleStudio将会提示问题建议。
例如:
如果你忘记配置文件端点,问题视图将会支持文件端点没有设定输入目录。
8)运行例子
1.鼠标右键点击订单处理流程;
2.选择Runas->MuleApplication.
3.如果你还没有保存项目,保存和运行窗口将会显示。
点击“OK”按钮。
4.例子运行成功,如下图控制台所示,输入文件按照设定的流程规则分发到对应的输出目录:
5.下面我们检查以下运行效果:
输入目录“Input”在运行处理后,订单将会全部删除;
输出子目录ATL、SFO、Other将根据设定的目标城市规则分发到对应的订单XML文件,如下图所示:
9)停止运行例子
如果要停止正在运行的例子,请点击“Terminate”按钮,如下图所示:
10)基于例子模板创建新Mule项目
当打开MuleStudio,在欢迎页面,选择“NewMuleprojectbasedonatemplate”:
输入项目名称,默认的Mule运行版本(ServerRuntime),选择“Createprojectbasedonanexistingtemplate”,选择一个模板,例如:
OrderDiscounter,最后选择“next”按钮。
点击“finish”。
MuleStudio将根据选择的模板生成默认的Mule项目:
2.MuleStudio基本概念
本章节解析MuleStudio的基本概念、如何组织、部件清单等等。
1)理解MuleStudio的不同部件
MuleStudio基于Eclipse技术,包含3个主要部件:
项目结构树、工具箱和画布。
包结构树
项目结构树包含整个项目的目录结构。
创建Mule项目后,你将看到Mule项目的名称和如下的文件和目录结构:
路径
描述
src/main/java
存放自定义的Java类
src/main/resources
存放流程图
src/test/resources
存放自定义的Java测试类
application
存放Mule部署属性文件
src
Main/app包含流程的xml文件;Main/test包含流程测试相关文件
项目metadata文件。
你可以编辑里面的名字、描述和服务器运行时版本等信息
JRESystemLibrary
Javaruntimelibraries.
MuleRuntime
Muleruntimelibraries.
下图是MuleStudio中的项目结构树截图:
工具箱
工具箱包含端点、组件、转换器、云连接器等,可以把组件拖放到画布中创建流程。
下面是工具箱的截图:
画布
画布是一个图形编辑器,通过在上面拖放可以实现流程的编制。
如下图所示:
在编辑器中,你可以创建一个或者多个流程。
使用全局元素面板,你可以配置全局Mule元素。
选择XML配置面板,Mule将会以代码方式显示XML配置文件。
MuleStudio中的其他功能
MuleStudio左下角会自动显示流程的缩略图:
2)理解MuleStudio中的流程
流程由信息源和后续一系列信息处理器组成。
你可以使用单个或者组合的信息源。
在MuleStudio里面,你可以从工具箱中拖放端点到画布构成流程。
端点可以是FTP,File,HTTP,或JMS等等。
如果你在一个存在的端点后面添加新端点,MuleStudio自动把新的端点设置为输出端点。
下面是流程生成的规则:
所有流程开始于端点
接着,按顺序添加组件、端点、转换器、过滤器、流程控制、路由器或者云连接器等
关于流程的详细信息,请参考 UsingFlows.
3.MuleStudio工具箱
工具箱包含建立流程所需的全部元素,通过拖放可以放到画布中。
请看下面的清单:
1)端点(Endpoints)
图标
名称
说明
AJAXEndpoint
在浏览器与Mule直接采用AJAX异步发送和接收信息.
FTPEndpoint
从FTP服务器读取文件.
FileEndpoint
从文件系统读取文件.
GenericEndpoint
通用端点,使用Mule表达式和指定的路径动态定义端点.
HTTPEndpoint
处理HTTP请求或者响应.
JDBCEndpoint
JDBC数据库连接
JMSEndpoint
从JMS队列发送或者接收信息.
QuartzEndpoint
Quartz定时触发事件
SFTPEndpoint
从SFTP服务器读、写文件.
SMTPEndpoint
从SMTP邮件服务器读取信息.
VMEndpoint
内存队列,允许你使用相同的配置集成不同的流程或者服务.
2)组件(Components)
图标
名称
说明
Component
调用Java组件.
Echo
在控制台中显示信息负载.
Logger
根据配置的日志级别,使用表达式判断记录日志.
REST
使用Jersey框架生成REST服务.
SOAP
使用CXF框架生成Webservice服务.
3)转换器(Transformers)
图标
名称
说明
CustomTransformer
委托Java类实现数据转换.
Object-to-XmlTransformer
使用XStream框架转换Java对象为XML/JSON格式.
ScriptTransformer
使用脚本转换负载.
TransformerRef
引用全局的转换器.
XSLTTransformer
使用XSLT转换XML.
Xml-to-ObjectTransformer
使用XStream转换XML/JSON为JavaBean.
4)过滤器(Filters)
图标
名称
说明
CustomFilter
用户实现的过滤器.
ExceptionFilter
匹配异常的过滤器.
ExpressionFilter
计算表达式过滤器.
MessagePropertyFilter
信息属性匹配过滤器.
PayloadFilter
检查负载对象类类型(ClassType)过滤器.
FilterRef
引用全局定义的过滤器.
RegEXFilter
正则表达式过滤器.
WildcardFilter
字符信息通配符过滤器.
5)流程控制(FlowControls)
图标
名称
说明
Splitter
通过表达式拆分负载.
6)路由器[分支条件](Routers)
图标
名称
说明
All
发送信息给后续全部节点.
Choice
条件表达式比较路由器.
7)活动范围(Scopes)
图标
名称
说明
Async
异步执行块内元素.
MessageEnricher
浓缩器,对来源信息进行充实
8)云连接器(CloudConnectors)
图标
名称
说明
Salesforce
Salesforce的云连接器.
Twitter的云连接器.
4.端点(EndPoints)
一般来说,端点用来发送和接收数据,负责连接外部资源并发送信息。
端点可以是输入端点也可以是输出端点。
输入端点通过关联的连接器接收信息,每个连接器负责输入节点的实现。
输出端点通过关联的连接器接收信息,每个连接器负责输出节点的实现。
MuleStudio支持如下几种端点:
AJAX,FTP,File,Generic,HTTP,QUARTZ,JDBC,JMS,SFTP,SMTP,VM,相关的详细配置如下:
1)文件传输协议(FTP)端点
FTP端点实现FTP连接。
主机(Host)和端口(Port)这两个参数是必须的。
其他参数(比如:
二进制模式[BinaryMode]或者被动模式[PassiveMode])是可选的。
配置FTP输入参数
拖放FTP端点到画布,双击FTP图标,将会弹出属性配置窗口,如下所示:
FTP端点输入参数属性配置如下:
参数名称
必须
有缺省值
参数描述
1.ConnectorRef
否
否
与此端点关联的连接器名称,如果指定了超过1个连接器,必须指定
2.Path
否
否
指定在远程服务器读取文件的目录
3.User
否
否
FTP服务器的登录用户名
4.Password
否
否
FTP服务器的登录密码
5.Host
是
否
FTP服务器IP或者域名
6.Port
是
是
FTP服务器端口,缺省是21
7.BinaryMode
否
是
是否使用二禁止传输类型,默认是true
8.PassiveMode
否
是
是否使用被动模式(被动模式主要是要通过防火墙),默认是true
9.PollingFrequency
否
否
刷新目录文件信息的频率(单位:
毫秒),缺省值是:
1000(ms)
配置FTP输出参数
FTP输出参数的配置与输入参数配置类似,唯一的不同是输出模式代替了刷新目录信息频率。
你必须指定Host和Port两个参数,其他参数可选。
双击FTP图标,将会弹出属性配置窗口,如下所示:
FTP端点输出参数属性配置如下:
与输入参数类型,需要额外指定以下参数值:
参数名称
必须
有缺省值
参数描述
OutputPattern
否
是
“输出模式”用来指定输出文件名的命名规则。
#[DATE]:
#[function:
datestamp]
#[DATE:
yy-MM-dd]:
#[function:
datestamp-yy-MM-dd]
#[SYSTIME]:
#[function:
systime]
#[UUID]:
#[function:
uuid]
#[ORIGINALNAME]:
#[header:
originalFilename]
#[COUNT]:
#[function:
count]-Notethatthisisaglobalcounter.
#[
#[header:
2)文件端点(FileEndpoint)
文件端点:
从文件系统中读、写文件。
配置文件端点输入参数
文件输入端点从文件系统中读取文件,同时可以配置是否备份文件到指定的目录。
拖放文件端点到画布,双击文件端点图标,将会弹出属性配置窗口,如下所示:
文件端点输入参数属性配置如下:
参数名称
必须
有缺省值
参数描述
1.ConnectorRef
否
否
与此端点关联的连接器名称,如果指定了超过1个连接器,必须指定
2.InputPathDirectory
是
否
指定输入文件的目录
3.MovetoDirectory
否
否
在处理文件前,移动文件到指定目录(备份)
4.MovetoPattern
否
否
移动(备份)文件的文件名命名规则
5.PollingFrequency
否
是
刷新对应目录文件信息的频率(单位:
毫秒)。
缺省值:
1000(ms)
6.FileAge
否
是
文件处理完成等待的的最小时间(单位:
毫秒),用于大文件的操作。
缺省值:
500(ms)
7.Comparator
否
是
指定输入文件名排序的比较器,例如使用比较器:
""。
比较器类必须实现接口
8.ReverseOrder
否
否
是否按照比较器的结果进行倒排
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- MuleStudio 用户手册
![提示](https://static.bdocx.com/images/bang_tan.gif)