Table Of ContentSECOND EDITION
David Dossot
John D’Emic
Victor Romero
M A N N I N G FOREWORD BY Ross Mason
Mule in Action
Second Edition
Mule in Action
SECOND EDITION
DAVID DOSSOT
JOHN D’EMIC
VICTOR ROMERO
MANNING
SHELTER ISLAND
For online information and ordering of this and other Manning books, please visit
www.manning.com. The publisher offers discounts on this book when ordered in quantity.
For more information, please contact
Special Sales Department
Manning Publications Co.
20 Baldwin Road
PO Box 261
Shelter Island, NY 11964
Email: [email protected]
©2014 by Manning Publications Co. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in
any form or by means electronic, mechanical, photocopying, or otherwise, without prior written
permission of the publisher.
Many of the designations used by manufacturers and sellers to distinguish their products are
claimed as trademarks. Where those designations appear in the book, and Manning
Publications was aware of a trademark claim, the designations have been printed in initial caps
or all caps.
Recognizing the importance of preserving what has been written, it is Manning’s policy to have
the books we publish printed on acid-free paper, and we exert our best efforts to that end.
Recognizing also our responsibility to conserve the resources of our planet, Manning books
are printed on paper that is at least 15 percent recycled and processed without the use of
elemental chlorine.
Manning Publications Co. Development editors: Jeff Bleiel, Nermina Miller
20 Baldwin Road Copyeditor: Melinda Rankin
PO Box 261 Proofreaders: Katie Tennant, Andy Carroll
Shelter Island, NY 11964 Typesetter: Dottie Marsico
Cover designer: Marija Tudor
ISBN 9781617290824
Printed in the United States of America
brief contents
PART 1 CORE MULE..................................................................1
1 ■ Discovering Mule 3
2 ■ Processing messages with Mule 27
3 ■ Working with connectors 50
4 ■ Transforming data with Mule 87
5 ■ Routing data with Mule 113
6 ■ Working with components and patterns 139
PART 2 RUNNING MULE........................................................173
7 ■ Integration architecture with Mule 175
8 ■ Deploying Mule 189
9 ■ Exception handling and transaction management with Mule 217
10 ■ Securing Mule 250
11 ■ Tuning Mule 264
PART 3 TRAVELING FURTHER WITH MULE..............................285
12 ■ Developing with Mule 287
13 ■ Writing custom cloud connectors and processors 334
14 ■ Augmenting Mule with orthogonal technologies 358
v
contents
foreword xv
preface xvii
acknowledgments xix
about this book xxi
about the authors xxiv
about the cover illustration xxv
PART 1 CORE MULE......................................................1
1 Discovering Mule 3
1.1 Enterprise Integration Patterns and service-oriented
architecture 4
1.2 The Mule project 6
1.3 Competition 7
1.4 Mule: a quick tutorial 8
Installing Mule Studio 9 ■ Designing the flow 13
1.5 Running, testing, and deploying the application 17
Running the application 17 ■ Testing the flow 21 ■ Working
with the XML configuration 22 ■ Deploying to the Mule
standalone server 23
1.6 Summary 26
vii
viii CONTENTS
2 Processing messages with Mule 27
2.1 Going with the flow 28
The response phase 30 ■ Subflows 31 ■ Private flows 34
2.2 Interacting with messages 35
Message sources 36 ■ Message processors 36 ■ Message
exchange patterns 37 ■ Endpoint URIs 39
2.3 Exploring the Mule message 40
Message properties 42 ■ Understanding property scopes 42
Using message attachments 45
2.4 Speaking the Mule Expression Language 46
Using expressions 47
2.5 Summary 49
3 Working with connectors 50
3.1 Understanding connectors 51
Configuring connectors with XML 52 ■ Configuring
connectors with Mule Studio 53
3.2 Using the file transport 56
3.3 Using the HTTP transport 58
Sending and receiving data using HTTP 58 ■ Using web
services with Mule 61
3.4 Using the JMS transport 67
Sending JMS messages with the JMS outbound endpoint 68
Receiving JMS messages with the JMS inbound endpoint 69
Using selector filters on JMS endpoints 70 ■ Using JMS
synchronously 70
3.5 Using email 71
Receiving email with the IMAP transport 71 ■ Sending mail
using the SMTP transport 73
3.6 Using the FTP transport 75
Receiving files with inbound FTP endpoints 76 ■ Sending files
with outbound FTP endpoints 77
3.7 Using databases 77
Using a JDBC inbound endpoint to perform queries 78 ■ Using a
JDBC outbound endpoint to perform insertions 79 ■ NoSQL with
MongoDB 80
CONTENTS ix
3.8 Using the VM transport 82
Introducing reliability with the VM transport 83
3.9 Using the Twitter cloud connector 85
Twitter 85
3.10 Summary 86
4 Transforming data with Mule 87
4.1 Working with transformers 88
4.2 Configuring transformers 89
4.3 Using core transformers 91
Dealing with bytes 92 ■ Compressing data 94
Modifying properties, flow variables, and session
variables 95 ■ Transforming with expressions 97
Enriching messages 98 ■ Automagic transformation 99
4.4 Using XML transformers 100
XPath and Mule 101 ■ Transforming format with XSL 102
XML object marshaling 104
4.5 Transforming JSON with Mule 105
Querying JSON with MEL 106 ■ JSON object marshaling with
Mule 107
4.6 Scripting transformers 109
4.7 Summary 112
5 Routing data with Mule 113
5.1 Deciding how to route a message 115
Using the choice router 115
5.2 Using filters 118
Filtering by payload type and header 119 ■ Filtering text and
XML 120 ■ Filtering with expressions 122 ■ Logical
filtering 124 ■ Ensuring atomic delivery with the idempotent
filter 125 ■ Using the message filter 127
5.3 Routing to multiple recipients 128
Dispatching messages with the all router 128 ■ Scatter/gather IO
with the all router 129 ■ Going async with the async
processor 130
5.4 Routing and processing groups of messages 131
Splitting up messages 132 ■ Aggregating messages 133
Routing collections 134
