Skip to content
This repository

INTSAMPLES-29 #2

Merged
merged 8 commits into from over 2 years ago

2 participants

Gunnar Hillert Mark Fisher
This page is out of date. Refresh to see the latest.
71  README.md
Source Rendered
... ...
@@ -0,0 +1,71 @@
  1
+Spring Integration Samples
  2
+==========================
  3
+
  4
+# Introduction
  5
+
  6
+Welcome to the Spring Integration Samples. To simplify your experience, Spring Integration Samples were split into 4 distinct categories:
  7
+
  8
+* Basic
  9
+* Intermediate
  10
+* Advanced
  11
+* Applications
  12
+
  13
+ Inside of each category you'll find a 'README.md' which will contain a more detailed description of that category's specifics. Each sample also comes with its own 'readme.txt' file explaining details.
  14
+
  15
+*Happy Integration!*
  16
+
  17
+# Categories
  18
+
  19
+Below is a short description of each category.
  20
+
  21
+## Basic
  22
+
  23
+This is a good place to get started. The samples here are technically motivated and demonstrate the bare minimum with regard to configuration and code to help you to get introduced to the basic concepts, API and configuration of Spring Integration. For example, if you are looking for an answer on how to wire a **Service Activator**  to a **Channel** or how to apply a **Gateway** to your message exchange or how to get started with using the **MAIL** or **XML** module, this would be the right place to find a relevant sample. The bottom line is that this is a good starting point.
  24
+
  25
+* **control-bus** - demonstrates the functionality of the **Control Bus**
  26
+* **feed** - demonstrates the functionality of the **Feed Adapter** (RSS/ATOM)
  27
+* **file** - demonstrates aspects of the various File Adapters (e.g. **File Inbound/Outbound Channel Adapters**, file **polling**)
  28
+* **ftp** - demonstrates the **FTP support** available with Spring Integration
  29
+* **helloworld** - very simple starting example illustrating a basic message flow (using **Channel**, **ServiceActivator**, **QueueChannel**)
  30
+* **http** - demonstrates request/reply communication when using a pair of **HTTP Inbound/Outbound gateways**
  31
+* **jms** - demonstrates **JMS** support available with Spring Integration
  32
+* **jmx** - demonstrates **JMX** support using a **JMX Attribute Polling Channel** and **JMX Operation Invoking Channel Adapter**
  33
+* **mail** - example showing **IMAP** and **POP3** support
  34
+* **oddeven** - Example combining the functionality of **Inbound Channel Adapter**, **Filter**, **Router** and **Poller**
  35
+* **quote** - Example demoing core EIP support using **Channel Adapter (Inbound and Stdout)**, **Poller** with Interval Trigers, **Service Activator**
  36
+* **sftp** - demonstrating SFTP support using **SFTP Inbound / Outbound Channel Adapters**
  37
+* **tcp-client-server** - demonstrates socket communication using **TcpOutboundGateway**, **TcpInboundGateway** and also uses a **Gateway** and a **Service Activator**
  38
+* **testing-examples** - A series of test cases that show techniques to **test** Spring Integration applications.
  39
+* **twitter** - Illustrates Twitter support using the **Twitter Inbound Channel Adapter**, **Twitter Inbound Search Channel Adapter**, **Twitter Outbound Channel Adapter**
  40
+* **ws-inbound-gateway** - Example showing basic functionality of the **Web Service Gateway**
  41
+* **ws-outbound-gateway** - Shows outbound web services support using the **Web Service Outbound Gateway**, **Content Enricher**, Composed Message Processor (**Chain**)
  42
+* **xml** - Example demonstrates various aspects of the **Xml** support using an **XPath Splitter**, **XPath Router**, **XSLT Transformer** as well as **XPath Expression** support
  43
+* **xmpp** - Show the support for [**XMPP**](http://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (formerly known as Jabber) using e.g. GoogleTalk
  44
+
  45
+## Intermediate
  46
+
  47
+This category targets developers who are already more familiar with the Spring Integration framework (past getting started), but need some more guidance while resolving more advanced technical problems that you have to deal with when switching to a Messaging architecture. For example, if you are looking for an answer on how to handle errors in various scenarios, or how to properly configure an **Aggregator** for the situations where some messages might not ever arrive for aggregation, or any other issue that goes beyond a basic understanding and configuration of a particular component to address "what else you can do?" types of problems, this would be the right place to find relevant examples.
  48
+
  49
+* **async-gateway** - Example shows usage of an **Asynchronous Gateway**
  50
+* **errorhandling** - Demonstrates basic **Error Handling** capabilities of Spring Integration
  51
+* **file-processing** - Sample demonstrates how to wire a message flow to process files either sequentially (maintain the order) or concurrently (no order).
  52
+* **multipart-http** - Demonstrates the sending of HTTP multipart requests using Spring's **RestTemplate** and a Spring Integration **Http Outbound Gateway**
  53
+* **travel** - More sophisticated example showing the retrieval of weather (SOAP Web Service) and traffic (HTTP Service) reports using real services
  54
+
  55
+## Advanced
  56
+
  57
+This category targets advanced developers who are quite familiar with Spring Integration but are looking to address a specific custom need by extending the Spring Integration public API. For example, if you are looking for samples showing how to implement a custom **Channel** or **Consumer** (event-based or polling-based), or you are trying to figure out what is the most appropriate way to implement a custom **BeanParser** on top of the Spring Integration BeanParser hierarchy when implementing a custom namespace, this would be the right place to look. Here you can also find samples that will help you with adapter development. Spring Integration comes with an extensive library of adapters that allow you to connect remote systems with the Spring Integration messaging framework. However you might have a need to integrate with a system for which the core framework does not provide an adapter, so you have to implement your own. This category would include samples showing you how to implement various adapters.
  58
+
  59
+* **advanced-testing-examples** - Example test cases that show advanced techniques to test Spring Integration applications
  60
+
  61
+## Applications
  62
+
  63
+This category targets developers and architects who have a good understanding of Message-Driven architecture and Enterprise Integration Patterns, and have an above average understanding of Spring and Spring integration and who are looking for samples that address a particular business problem. In other words, the emphasis of samples in this category is '**business use cases**' and how they can be solved via a Messaging architecture and Spring Integration in particular. For example, if you are interested to see how a Loan Broker process or Travel Agent process could be implemented and automated via Spring Integration, this would be the right place to find these types of samples.
  64
+
  65
+* **cafe** - Emulates a simple operation of a coffee shop combining various Spring Integration adapters (Including **Router** and **Splitter**) see [Appendix A of the reference documentation](http://static.springsource.org/spring-integration/docs/latest-ga/reference/html/samples.html) for more details
  66
+* **loan-broker** - Simulates a simple banking application (Uses **Gateway**, **Chain**, **Header Enricher**, **Recipient List Router**, **Aggregator**) see [Appendix A of the reference documentation](http://static.springsource.org/spring-integration/docs/latest-ga/reference/html/samples.html) for more details
  67
+* **loanshark** This extension to the loan broker sample shows how to exchange messages between Spring Integration applications (and other technologies) using **UDP**.
  68
+
  69
+#Resources
  70
+
  71
+For more information, please visit the Spring Integration website at: [http://www.springsource.org/spring-integration](http://www.springsource.org/spring-integration)
8  advanced/README.md
Source Rendered
... ...
@@ -0,0 +1,8 @@
  1
+Advanced Samples
  2
+================
  3
+
  4
+This category targets advanced developers who are well familiar with the [Spring Integration](http://www.springsource.org/spring-integration) framework but are looking to extend it to address a specific custom need by extending from Spring Integration's public API. 
  5
+
  6
+For example; if you are looking for samples showing you how to implement a custom **Channel** or **Consumer** (event-based or polling-based), or if you trying to figure out what is the most appropriate way to implement a custom **BeanParser** on top of the Spring Integration BeanParser hierarchy when implementing custom namespaces, this would be the right place to look.
  7
+
  8
+Here you can also find samples that will help you with adapter development. Spring Integration comes with an extensive library of adapters that allow you to connect remote systems with Spring Integration messaging framework. However you might have a need to integrate with systems for which the core framework does not provide an adapter and consequently you may have to implement your own adapter. This category would include samples showing you how to implement various adapters.
13  advanced/readme.txt
... ...
@@ -1,13 +0,0 @@
1  
-
2  
-									$$ ADVANCED Samples $$
3  
-
4  
-This category targets advanced developers who are well familiar with Spring Integration framework but looking to 
5  
-extend it to address a specific custom need by extending from Spring Integration public API. 
6  
-For example; if you are looking for samples showing you how to implement a custom Channel or 
7  
-Consumer (event-based or polling-based), or you trying to figure out what is the most appropriate way to implement 
8  
-custom BeanParser on top of Spring Integration�BeanParser�hierarchy when implementing custom name space, 
9  
-this would be the right place to look.
10  
-Here you can also find samples that will help you with adapter development. Spring Integration comes with an extensive 
11  
-library of adapters that allow you to connect remote systems with Spring Integration messaging framework. 
12  
-However you might have a need to integrate with system for which the core framework does not provide an adapter. 
13  
-So you have to implement your own. This category would include samples showing you how to implement various adapters.
5  applications/README.md
Source Rendered
... ...
@@ -0,0 +1,5 @@
  1
+Applications Samples
  2
+====================
  3
+
  4
+This category targets developers and architects who have a good understanding of the Messaging architecture, EIP and above average understanding of Spring and Spring integration and are looking for samples that address a particular business problem. In other word the emphasis of samples in this category is 'business use cases' and how it could be solved via Messaging architecture and Spring Integration in particular. For example; If you are interested to see how a Loan Broker process or Travel Agent process could be implemented and automated via Spring Integration this would be the right place to find these types of samples.
  5
+
9  applications/readme.txt
... ...
@@ -1,9 +0,0 @@
1  
-
2  
-								$$ APPLICATIONS Samples $$
3  
-
4  
-This category targets developers and architects who have a good understanding of the Messaging architecture, 
5  
-EIP and above average understanding of Spring and Spring integration and are looking for samples that 
6  
-address a particular business problem. In other word the emphasis of samples in this category is 'business use cases' 
7  
-and how it could be solved via Messaging architecture and Spring Integration in particular. 
8  
-For example; If you are interested to see how a Loan Broker process or Travel Agent process could be implemented and 
9  
-automated via Spring Integration this would be the right place to find these types of samples.
6  basic/README.md
Source Rendered
... ...
@@ -0,0 +1,6 @@
  1
+Basic Samples
  2
+=============
  3
+
  4
+This is a good place to get started. The samples here are technically motivated and demonstrate the bare minimum with regard to configuration and code to help you to get introduced to the basic concepts, API and configuration of [Spring Integration](http://www.springsource.org/spring-integration) and how they relate to [Enterprise Integration Patterns](http://www.eaipatterns.com/) (EIP). 
  5
+
  6
+For example; if your are looking for an answer on how to wire a **Service Activator** to a **Channel** or how to apply a **Gateway** to your message exchange or how to get started with using the **Mail** or **XML** module etc., this would be the right place to find a good sample. 
10  basic/readme.txt
... ...
@@ -1,10 +0,0 @@
1  
-
2  
-								$$ BASIC Samples $$
3  
-
4  
-This is a good place to get started. The samples here are technically motivated and demonstrate 
5  
-the bare minimum with regard to configuration and code to help you to get introduced to the basic 
6  
-concepts, API and configuration of Spring Integration and how they relate to Enterprise Integration Patterns (EIP). 
7  
-
8  
-For example; if your are looking for an answer on how to wire service-activator to a channel or how to 
9  
-apply Gateway to your message exchange or how to get started with using MAIL or XML module etc., 
10  
-this would be the right place to find a good sample. This category of samples is this is a good place to start.
6  intermediate/README.md
Source Rendered
... ...
@@ -0,0 +1,6 @@
  1
+Intermediate Samples
  2
+====================
  3
+
  4
+This category targets developers who are already familiar with the [Spring Integration](http://www.springsource.org/spring-integration) framework (past getting started), but need some more guidance while resolving more advanced technical problems that they have to deal with once having switched to a Messaging architecture. 
  5
+
  6
+For example; If you are looking for an answer on how to handle errors in various scenarios or how to properly configure the **Aggregator** for the situations where some messages might not ever arrive for aggregation etc., and any other issue that goes beyond a basic understanding and configuration of a particular component and addresses "what else you can do with it" type of problem, this would be the right place to find these type of samples.
11  intermediate/readme.txt
... ...
@@ -1,11 +0,0 @@
1  
-
2  
-								$$ INTERMEDIATE Samples $$
3  
-
4  
-This category targets developers who are already familiar with Spring Integration framework (past getting started), 
5  
-but need some more guidance while resolving Êmore advanced technical problems that you have to deal with 
6  
-once switch to a Messaging architecture. 
7  
-For example; If you are looking for an answer on how to handle errors in various 
8  
-scenarios or how to properly configure Aggregator for the situations where some messages might not ever arrive 
9  
-for aggregation etc,. and any other issue that goes beyond a basic understanding and configuration of a 
10  
-particular component and addresses "what else you can do with it" type of problem this would be the right place 
11  
-to find these type of samples.
45  readme.txt
... ...
@@ -1,45 +0,0 @@
1  
-                    ===============================================================
2  
-					$$$	      Welcome to the Spring Integration Samples			$$$
3  
-					===============================================================
4  
-					
5  
-To simplify your experience, Spring Integration Samples were split into 4 distinct categories.  
6  
-Inside of each category you'll find a 'readme.txt' which will contain a more detailed description 
7  
-of that category's specifics. Each sample also comes with its own 'readme.txt' file explaining details.
8  
-
9  
-Below is a short description of each category.
10  
-
11  
-BASIC
12  
-	This is a good place to get started. The samples here are technically motivated and demonstrate the bare 
13  
-	minimum with regard to configuration and code to help you to get introduced to the basic concepts, API and 
14  
-	configuration of Spring Integration. For example if you are looking for an answer on how to wire service-activator 
15  
-	to a channel or how to apply Gateway to your message exchange or how to get started with using MAIL or XML the module, 
16  
-	this would be the right place to find a relevant sample. The bottom line is that this is a good starting point.
17  
-
18  
-INTERMEDIATE
19  
-	This category targets developers who are already familiar with the Spring Integration framework (past getting started), 
20  
-	but need some more guidance while resolving more advanced technical problems that you have to deal with when switching
21  
-	to a Messaging architecture. For example, if you are looking for an answer on how to handle errors in various 
22  
-	scenarios, or how to properly configure an Aggregator for the situations where some messages might not ever arrive 
23  
-	for aggregation, or any other issue that goes beyond a basic understanding and configuration of a particular component
24  
-	to address "what else you can do?" types of problems, this would be the right place to find relevant samples.
25  
-
26  
-ADVANCED
27  
-	This category targets advanced developers who are quite familiar with the Spring Integration framework but looking to
28  
-	address a specific custom need by extending from the Spring Integration public API. For example, if you are looking for
29  
-	samples showing you how to implement a custom Channel or Consumer (event-based or polling-based), or you are trying to
30  
-	figure out what is the most appropriate way to implement a custom BeanParser on top of the Spring Integration BeanParser
31  
-	hierarchy when implementing a custom namespace, this would be the right place to look. Here you can also find samples
32  
-	that will help you with adapter development. Spring Integration comes with an extensive library of adapters that allow
33  
-	you to connect remote systems with the Spring Integration messaging framework. However you might have a need to integrate
34  
-	with a system for which the core framework does not provide an adapter, so you have to implement your own. This category
35  
-	would include samples showing you how to implement various adapters.
36  
-
37  
-APPLICATIONS
38  
-	This category targets developers and architects who have a good understanding of Message-driven architecture and
39  
-	Enterprise Integration Patterns, and an above average understanding of Spring and Spring integration and who are looking
40  
-	for samples that address a particular business problem. In other words, the emphasis of samples in this category is
41  
-	'business use cases' and how they can be solved via a Messaging architecture and Spring Integration in particular. 
42  
-	For example, if you are interested to see how a Loan Broker process or Travel Agent process could be implemented and 
43  
-	automated via Spring Integration, this would be the right place to find these types of samples.
44  
-
45  
-										$$ Happy Integration! $$
Commit_comment_tip

Tip: You can add notes to lines in a file. Hover to the left of a line to make a note

Something went wrong with that request. Please try again.