Space Details Key: MULE2USER Name: Mule 2.x User Guide Description: Mule Users Guide for the 2.x release line Creator (Creation Date): ross (Jan 30, 2008) Last Modifier (Mod. Date): tcarlson (Apr 15, 2008) Available Pages • Configuring a Mule Instance • Escape URI Credentials • Home • 3.x Features • Using JSON • Configuring Encoding • Hot Deploying Mule Applications • Deploying Mule as a Service to Tomcat • Starting Mule with the Configuration • About Mule Configuration • About Configuration Builders • Configuring Properties • Mule High Availability • Storing Objects in the Registry • About Transports • Available Transports • BPM Transport • CXF Transport • Building a CXF Web Service • CXF Transport Configuration Reference • Enabling WS-Addressing • Enabling WS-Security • Supported Web Service Standards • Using a Web Service Client as an Outbound Endpoint • Using a Web Service Client Directly • Using HTTP GET Requests • Using MTOM • EJB Transport • Email Transport • File Transport • FTP Transport • HTTPS Transport • HTTP Transport • IMAPS Transport Document generated by Confluence on Feb 07, 2010 23:59 Page 1 • IMAP Transport • JDBC Transport • JDBC Transport Configuration Reference • JDBC Transport Examples • JDBC Transport Performance Benchmark Results • Jetty Transport • Jetty SSL Transport • JMS Transport • Tibco EMS Integration • JBoss Jms Integration • Fiorano Integration • OpenJms Integration • SwiftMQ Integration • Sun JMS Grid Integration • SonicMQ Integration • SeeBeyond JMS Server Integration • Open MQ Integration • ActiveMQ Integration • WebLogic JMS Integration • Mule MSMQ Transport • Mule WMQ Transport • Multicast Transport • POP3S Transport • POP3 Transport • Quartz Transport • RMI Transport • Servlet Transport • SMTPS Transport • SMTP Transport • SOAP Transport • SSL Transport • STDIO Transport • TCP Transport • UDP Transport • VM Transport • WSDL Connectors • XMPP Transport • Bootstrapping the Registry • Choosing the Right Topology • Configuration Overview • Configuration Reference • Asynchronous Reply Router Configuration Reference Document generated by Confluence on Feb 07, 2010 23:59 Page 2 • Catch-all Strategy Configuration Reference • Component Configuration Reference • Endpoint Configuration Reference • Exception Strategy Configuration Reference • Filters Configuration Reference • Global Settings Configuration Reference • Inbound Router Configuration Reference • Model Configuration Reference • Notifications Configuration Reference • Outbound Router Configuration Reference • Properties Configuration Reference • Security Manager Configuration Reference • Service Configuration Reference • Transactions Configuration Reference • Configuring Endpoints • Mule Endpoint URIs • Configuring a Transport • Configuring Retry Policies • Configuring Logging • Configuring Queues • Configuring Security • Component Authorization Using Acegi • Component Authorization Using Spring Security • Configuring the Acegi Security Manager • Configuring the Spring Security Manager • Encryption Strategies • SAML Module • Setting up LDAP Provider for Acegi • Setting up LDAP Provider for Spring Security • Upgrading from Acegi to Spring Security • Controlling the Infrastructure with the Service Registry • Creating a Custom XML Namespace • Creating Custom Routers • Creating Transports • Transport Archetype • Transport Service Descriptors • Deployment Scenarios • Deploying Mule to WebLogic • Deploying Mule to WebSphere • Embedding Mule in a Java Application or Webapp • JBoss Integration • Mule as MBean Document generated by Confluence on Feb 07, 2010 23:59 Page 3 • Developing Service Components • Entry Point Resolver Configuration Reference • Error Handling • Functional Testing • Installing a Standalone Mule Instance • Installing Upgrades and Hot Fixes • Internationalizing Strings • Introduction to Extending Mule • Introduction to Testing Mule • Models • Mule Agents • JMX Management • Mule Server Notifications • Profiling Mule • Resource Adapter • Suggested Reading • Third-party Software in Mule • Transaction Management • Tuning Performance • Unit Testing • Using Filters • Using IDEs • Using the Mule Management Console • Installing the Management Console with an External Database • Management Console Agent Settings • Using Mule Modules • Acegi Module • JAAS Module • JBoss Transaction Manager • Scripting Module • Spring Extras Module • SXC Module • XML Module • DomToXml Transformer • JXPath Extractor Transformer • XmlObject Transformers • XmlToXMLStreamReader Transformer • XPath Extractor Transformer • XSLT Transformer • Using Mule with Spring • Sending and Receiving Mule Events in Spring • Spring Application Contexts Document generated by Confluence on Feb 07, 2010 23:59 Page 4 • Using Spring Beans as Service Components • Using the Mule Client • Using the Mule RESTpack • Architecting RESTful HTTP applications • Making Sense of REST • Using Transformers • Creating Custom Transformers • Transformers Configuration Reference • XmlPrettyPrinter Transformer • Using Web Services • Axis • Axis SOAP Styles • Axis SOAP Transports • Axis Transport • Axis Web Services and Mule • Configuring Axis • Proxying Web Services • Using .NET Web Services with Mule • Web Service Wrapper • Working with Services • Configuring Components • Configuring Java Components • Using Interceptors • Configuring the Service • MEPs • Mule Messaging Styles • Using Message Routers • Inbound Routers • Outbound Routers • Asynchronous Reply Routers • Catch-all Strategies • Component Bindings • About the XML Configuration File • Example Archetype • Jaas Security • JavaRebel Integration • Module Archetype • PGP Security • Project Archetype • Streaming • Using Expressions • Creating Expression Evaluators • Expressions Configuration Reference Document generated by Confluence on Feb 07, 2010 23:59 Page 5 Configuring a Mule Instance This page last changed on Jun 30, 2009 by jwheeler. Configuring a Mule Instance A Mule configuration file can become an elaborate tree of elements, however, the basic things to configure at the top level are: • Connectors - Non-default configuration of any transports used • Endpoints - Global definition of endpoints is encouraged to clearly describe where your integration channels are • Transformers - Transformers may be defined globally and later referenced from your services • Filters - Filters may be defined globally and later referenced from your services • Models - One or more models that logically group together your services • Services - One or more services that wrap your components and configure routers, endpoints, transformers, and filters specifically for that service Following is an example of a simple Mule configuration file: <mule xmlns="http://www.mulesource.org/schema/mule/core/2.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:vm="http://www.mulesource.org/schema/mule/vm/2.2" xsi:schemaLocation=" http://www.mulesource.org/schema/mule/core/2.2 http://www.mulesource.org/schema/mule/core/2.2/ mule.xsd http://www.mulesource.org/schema/mule/vm/2.2 http://www.mulesource.org/schema/mule/vm/2.2/ mule-vm.xsd"> <vm:connector name="vmConnector" queueEvents="true" queueTimeout="5000"/> <vm:endpoint name="CustomerRequests" path="customer.requests"/> <vm:endpoint name="CustomerResponses" path="customer.responses"/> <custom-transformer name="ThisToThat" class="com.acme.transformer.ThisToThat"/> <model name="main"> <service name="myBasicService"> <inbound> <inbound-endpoint ref="CustomerRequests"/> </inbound> <component class="com.acme.service.BasicService"/> <outbound> <pass-through-router> <outbound-endpoint ref="CustomerResponses" transformer-refs="ThisToThat"/> </pass-through-router> </outbound> </service> Document generated by Confluence on Feb 07, 2010 23:59 Page 6 </model> </mule> Advanced Configuration Other, more advanced things you may configure at this level: • Agents - Agents are typically used for cross-cutting concerns such as logging or management • Notifications - Be notified upon certain lifecycle events • Security Manager - Authenticates requests based on one or more security providers • Transaction Management - Mule transactions are configured on inbound endpoints, where an endpoint can be configured to start a new transaction or join an existing one. • Global Configuration Options - Miscellaneous global settings • Global Properties - Placeholder values Document generated by Confluence on Feb 07, 2010 23:59 Page 7 Escape URI Credentials This page last changed on Nov 26, 2008 by jackie.wheeler. Escape Your Credentials If you use a URI-style endpoint and you include the user name and password, escape any characters that are illegal for URIs, such as the @ character. For example, if the user name is [email protected], you should enter it as user%40myco.com. Document generated by Confluence on Feb 07, 2010 23:59 Page 8 Home This page last changed on Dec 17, 2009 by jwheeler. Welcome to the documentation for Mule ESB. Some of the documentation on this site is under construction for the current release. If you have any feedback on the content, or would like to sign up to become a site contributor or editor, please contact us. 3.x snapshots are now available! For a list of features in progress for 3.x, click here. Getting Started Using Transports (Click the arrow to expand the topics from the • About Transports Getting Started guide, including an introduction • Available Transports to Mule, steps to get started, and migration • Configuring a Transport information.) Mule Deployment Click here to expand... Architecture • Introduction