Swordfish Documentation: Swordfish tooling (eclipse target platform)

Main goal is show how Swordfish developer can:

• install Swordfish target platform.
• create/deploy/run jax-ws services in the Eclipse environment using Swordfish target platform.

Here is step-by-step description.

1. General prerequisites:
   • Eclipse Galileo
   • Update Site url: http ://<host>/target.platform
   • Example project: cxf-osgi. This is modified cxf example to be PDE project.
2. Install Swordfish target platform:
   • ensure you have correct proxy settings in the Eclipse
   • go Help - Install New Software...
   • in the 'Work with' file Update Site url
   • choose 'Sample Target Platform Feature' and click Next
   • in the 'Install Details' window choose 'Sample Target Platform Feature' and click Finish.
   • Platform should be installed. Restart Eclipse.
3. Configure Eclipse to use Swordfish target platform:
   • go Window - Preferences - Plug-in development - Target Platform and click Add
   • in the 'New Target Defenition' choose 'Template' and select 'Sample Runtime Platform'. Click Next.
   • create New Target Defenition: click Finish.
   • in the 'Target Platform' window select 'swordfish' and set it active: 'Set Active'.
   • apply changes: Apply. And click Ok.
   • go Run - Run Configurations...
   • create new configuration: choose OSGI Framework - New. Set name for configuration: 'swordfish'.
4. Create example project:
   • import example project into workspace.
   • ensure there are no compile errors.
5. Run example project:
   • go Run - Run Configurations...
   • choose 'swordfish' configuration to run.
   • click Run. Wait untill container will start. Basicaly when in log you will see: INFO: Setting the server's publish address to be /HelloWorld you can do next steps
6. Check if example works:
   • ensure example project started (p.5)
   • in browser type http://localhost:8080/cxf/
   • You will see: {http ://cxf.examples.servicemix.apache.org/}HelloWorldImplPort - click on it.
   • You will see generated WSDL document (also you can see WSDL using direct url: http://localhost:8080/cxf/HelloWorld?wsdl ).

Export example project JAR.

You can export example jar to use it in the standalone environment.

There are 2 ways to do it. We recommend use first one.

1. Deployable plug-ins and fragments
   • select project
   • File - Export - Plug-in Development - Deployable plug-ins and fragments, click Next
   • set Directory to export. Click Finish.
   • check created jar file.
2. JAR file.
   • select project, File - Export - JAR file, click Next
   • Select resources to export - mark only: src/main/java and META-INF
   • Select the export destination: set file name and path. click Next twice.
   • in the JAR Manifest Specification: select 'Use existing manifest from workspace'. Set /cxf-osgi/META-INF/MANIFEST.MF. Click Finish.
   • check created jar file.