The easiest way to get started with testing an application on SwitchYard is to take one of the distribution's Quickstart examples and run it. All of the example applications in our Quickstarts repository are included in quickstarts/ directory of your installation.
The Quickstarts provided in the distribution are source only i.e. they are not pre-built. Building them is very easy. You just need to make sure you have Maven 3 configured on your system and then simply execute mvn clean install in the root of the quickstarts folder.
For the purpose of testing your SwitchYard distribution and simply getting something running quickly, the following quickstart applications are a good jumping off point:
- bean-service : implementing a service using a CDI bean and exposing that over a SOAP gateway
- bpm-service : using BPMN 2 to provide and consume SwitchYard services
- camel-service : basic routing example using XML and Java DSL Camel routes
- camel-jms-binding : demonstrates how a Camel component can be used as a SwitchYard gateway
- demos/orders : web application which invokes a SwitchYard service from a JSF
These quickstarts are just a small sample of the available example applications. Check out the other apps for examples of other features in SwitchYard.
Running the Quickstarts in Eclipse
The SwitchYard quickstarts can also be easily run in Eclipse.
To do this, you have to first modify the default Eclipse configuration to avoid XML cosmetic errors:
- Configure XML Validation to Avoid Cosmetic Errors
- Navigate to: Window->Preferences->XML->XML Files->Validation
- Uncheck "Honour all XML schema locations"
To import a SwitchYard quickstart into Eclipse:
- Import a SwitchYard Quickstart
- Navigate to: File->Import->Maven->Existing Maven Projects
- Select the quickstart that you want to import from the SwitchYard Quickstart directory (e.g., /local/opt/switchyard/jboss-eap-6.4/quickstarts/bean-service)
Once the quickstart is imported, you then deploy it to a SwitchYard enabled server and execute the quickstart's client class as a JUnit test.
For more information on installing and using SwitchYard tooling in Eclipse, see: https://docs.jboss.org/author/display/SWITCHYARD/Eclipse