《Mule ESB使用手册》由会员分享,可在线阅读,更多相关《Mule ESB使用手册(24页珍藏版)》请在金锄头文库上搜索。
1、Mule ESB Studio v3.3 安装使用手册1 *初级教程*如果你还没有做好准备,请到http:/www.mulesoft.org下载免费的社区版Mule ESB,按照网站上的说明启动Mule Studio,并且选择一个工作区(另外,你还可以下载30天免费试用的企业版Mule ESB)2 安装Mule Studio安装前,请确认你的机器上已经安装了1.6版本的JDK。最后请确认你的JDK环境变量配置是否正确2.1 导出将下载的文件解压到你的硬盘分区的根目录下,例如:C:1.执行找到C:MuleStudio目录,运行muleStudio.exe启动Studio2.选择工作区点击OK使用
2、默认的工作区3 使用Studio模板1.点击File菜单,选择New Mule Project2.出现New Mule Project面板后,为你的项目输入名称和一个简短的说明,如图:3.在Server Runtime选项上选择你将要使用的Mule运行时版本,如图:4.点击旁边的复选框,根据现有的模板创建项目,单击项目,选择你想要使用的模板创建项目,如图:5.点击Finish按钮,Mule Studio会创建并打开一个新的项目,完成预创建和预配置的流程6.在Mule Studio的Package Explorer栏中,右键点击mule-config.mflow文件,选择Run As Mule
3、Application7.停止运行该项目,请在Mule Studio控制台点击红色的Terminate按钮,如图:4 运行独立的例子1.到Mule ESB Standalone目录下,找到Examples目录下你想运行的例子2. 拷贝.zip文件的例子到$MULE_HOME/apps目录下,例如:运行Flight Reservation example的例子,拷贝mule-example-flight-reservation-3.3.0.zip到$MULE_HOME/apps目录下,如图:3.启动Mule,运行这个例子5 启动Mule Studio如果你在安装过程中启动了Mule Studio
4、,并且已经在运行了,请跳过本节的其余部分,直接进行:创建新项目如果当前Mule Studio没有启动,通过完成下面的步骤启动应用程序1.找到Mule Studio安装目录2.执行muleStudio.exe3.点击OK使用默认的工作区6 创建新项目1.如果你看到是各种控制组件的应用程序窗口(右下图),请直接进入第2节。相反(左下图),这是你第一次运行Studio。单击Go to Mule Studio,然后进入第2节2. 点击File New Mule Project3.在弹出的New Mule Project窗口中输入你的项目名称4. 点击描述文本框中的任意位置,然后键入与项目有关的描述,需
5、要注意的是Server Settings显示的是 Mule Server3.2.1 社区版5.点击Next所有项目都包含至少一个消息流程,由于是一个简单的项目,所以只有一个消息流程。我们将把应用程序的名称用作流程的名称,所以请在New Mule Flow面板中输入名称:“Spell Checker”,然后点击描述文本框中的任意位置。注意,Studio会自动将大写字母转换为小写,使用“_”字符替换单词之间的空格,并在结尾追加“. mflow”。结果显示在File name字段中。当你建立Spell Checker应用程序的拖放和拖放界面时,. mflow文件会一直跟踪你的工作。在Descript
6、ion中输入任意描述,点击Finish完成创建7 文件夹设置Spell Checker应用程序需要一对特殊的文件夹,方便数据的输入和输出。可以通过完成以下步骤来创建它们:1. 找到Studio菜单 File Open File 2. 然后在Open File的窗口中找到你的Studio安装目录,例如:C:MuleStudio Examples Spell Checker3. 在该目录下创建两个分别以InXML和OutXML命名的文件夹8 关于Mule流程henyouyong在我们的例子中(如下图),Web客户端发送HTTP消息的Inbound Endpoint设置为“request-respo
7、nse”的交换模式。换句话说,用户期望应用程序能够响应他们的请求。过滤器判断收到的消息是否有效,然后决定丢弃或者传递给流程中的下一个模块(将HTTP请求按照JMS规范进行转换)接着,用Java编写的一个业务逻辑组件的消息进行处理,然后生成一个回答,传递到另一个转换器,将回答从JMS转回HTTP响应,然后把响应返回给正在等待的Web客户端。9 模块部署你可以从右侧组件栏中拖拽组件到画板上,从而创建一个Mule 流程,组件栏中一共包含七个类别的组件:Endpoints、Scopes、Components、Transformers、Filters、Flow Control、和Cloud Connec
8、tors10 创建Spell Checker流程1. 在Endpoints类组件栏中找到File,单击并拖放到左侧画板中相应的位置2. 单击并拖动HTTP,也放在Endpoints组中,但要确保你把它放到File图标的右侧,因此,它会出现在用虚线表示的边框内3. 松开鼠标按钮后,会有一条箭头线从File组件指向HTTP组件4. 添加另一个File组件,将Endpoints类组件栏中的File组件拖放到HTTP组件的右侧,必须确保它也出现在用虚线表示的边框内5. 最后,拖放Ehco组件,将它放到第一个File组件和HTTP组件中间,你的画板展示了一个完整的流程,如下图:11 配置流程组件几乎所有
9、的Mule组件提供的配置选项,你都可以通过对话框设置,无需编写XML12 File入站端1. 双击流程中最左侧的File组件,会弹出一个Endpoint Properties对话框,默认显示General选项卡,需要注意的是,Mule自动识别这个文件组件为入站端点(Inbound Endpoint)。2. 在Display Name输入框中,你必须输入一个具有很强描述性的名字,比如:“Incomming data File”3. 在Path Information面板中,在Path字段输入InXML所在项目的路径,整体路径看起来像这样:C:MuleStudioExamplesSpellChec
10、kerInXML4. 点击OK,完成Incoming Endpoint的配置并返回画板13 Echo组件应用启动时,在Studio控制台输出消息的组件,无需特殊配置1. 你也可以在General选项卡的Display Name字段输入名字,在Documentation选项卡的descriptive comments字段输入一些描述信息,当你的鼠标移到该组件上面,会展示出这些信息2. 点击OK,完成Echo组件的配置并返回画板14 HTTP Endpoint这个出站端从后台检索信息(这例子中的后台是Google Spell Checker API)1. 双击HTTP组件,在General选项卡中
11、完成配置在Host字段输入 Spell Checker Server使用的端口:80在Method字段输入Google Spell Checker Server使用的方法类型:POST2. 点击OK完成配置如果你打算在公司防火墙后面运行本教程中的应用程序,需要另外配置: 双击HTTP Endpoint,点击References选项卡点击Connector Reference选项卡右边的+图标点击Proxy Settings,进行如下图配置:15 File 出站端1. 双击配置流程右边的File组件2. 在Path Information的Path字段输入OutXML所在项目的路径,整体路径看起
12、来像这样:C:MuleStudioExamplesSpellCheckerOutXML3. 在Output pattern栏中配置以下输出格式:#function:datestamp:dd-MM-yy_#function:systime.xml这会让Mule在OutXML目录下以时间戳的格式给生成数据的文件命名4. 点击OK完成配置祝贺你!你已经完成了你的第一个Mule ESB应用可选:点击控制台下方的Configuration XML选项卡切换到XML视图,你可以看到XML格式的流程信息,你可以直接修改这些XML内容,只要切回流程视图,你的修改会很快体现在视图中,在XML视图中你应该看到如下
13、内容:16 运行Spell Checker在Package Explorer栏中,鼠标右键spell_checker.mflow,在弹出的菜单中点击Run As Mule Application如果你没有保存该应用,在弹出的Save and launch对话框中点击OK,Mule会保存并自动运行该应用随后控制台会打印出Started app spell_checker等信息17 测试Spell Checker你的项目正在运行,Mule正在检查InXML目录下的XML文件,如果要启动一个流程,你需要拷贝一个XML文件到这个目录下1. 到Spell Checker 目录下(例如:C:MuleStu
14、dioExamplesSpellChecker)2. 找到spellcheck.xml文件,这个文件中包含一些拼写错误的内容:Creeating mi fiirst Mulle Studio aplication!3. 将这个文件拷贝到InXML目录下,请注意,你只需要做这一步Studio控制台会输出一些信息,最后的内容是:Writing file to.随后spellcheck.xml文件不再保留在InXML目录下一个新的文件在OutXML目录下产生这个新产生的文件名字包含我们在File出站端指定的时间戳格式,如:21-01-12_1327187012641.xml新产生的文件中包含拼写错误的单词的更正Spell Checker应用会一直运行,等待处理新的文件下面是你拷贝到InXML目录下的spellcheck.xml文件内容: Creeating mi fiirst Mulle Studio aplication!下面是Google API返回的修改建议,这部分内容保存在以时间戳格式命名的文件中,放在OutXML目录下 c o=