To help make project creation easier for those that are not using eclipse, and also for those using eclipse but like standard maven formatted projects, we have created a maven archetype for the Turmeric SOA project.
The archetype is currently available in the snapshot repository, and it’s archetype catalog entry can be found here.
The archetype will generate a multi module project, that contains the basics for creating a turmeric service. It will include both an Interface Project and a Service Implementation project. All code will be generated according to the maven standard directory structure layout.
To run the archetype simply enter:
mvn archetype:generate -DarchetypeCatalog=http://www.ebayopensource.org/nexus/content/repositories/snapshots/archetype-catalog.xml
Next select the number corresponding to the archetype you want to use:
Choose archetype: 1: http://www.ebayopensource.org/nexus/content/repositories/snapshots/archetype-catalog.xml -> turmeric-simple-legacy-service-archetype (A maven archetype for creating a simple turmeric service) 2: http://www.ebayopensource.org/nexus/content/repositories/snapshots/archetype-catalog.xml -> turmeric-simple-service-archetype (-) Choose a number: :
There are a couple of property values that need to be filled in.
- lowerCaseServiceName = this is the name of your service in lower case. It is used in setting up the namespace paths and also for package names.
- serviceName = a camel case service name (i.e. TestService)
- targetNamespace = the target namespace for the service. This is populated in the WSDL and any XSD files that are produced.
- turmeric-runtime-version = the runtime version of turmeric to use. Currently 1.0.0-Beta-RC1
After providing the entries, either through the interactive generation, or via command line overrides, the project will be generated.
In the next posting well take a look at how to add the archetype catalog to Eclipse if you are using m2Eclipse 0.12 or greater.