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:

• check that you have correct proxy settings in the Eclipse
• select Help - Install New Software... in the top menu
• type in Update Site URI in the 'Work with' field
• select 'Sample Target Platform Feature' and click Next

• select 'Sample Target Platform Feature' in the 'Install Details' window and click Finish

• after the platform is installed restart Eclipse.

3.Configure Eclipse to use Swordfish target platform:

• go to Window - Preferences - Plug-in development - Target Platform and click Add
• select 'Template' in the 'New Target Defenition' and then select 'Sample Runtime Platform'. Click Next.

• create New Target Defenition and click Finish.

• select 'swordfish' in the 'Target Platform' window and set it active ('Set Active').

• apply changes (Apply) and click Ok.
• go to Run - Run Configurations...
• create new configuration: choose OSGI Framework - New. Enter the name for configuration: 'swordfish'.

4.Create example project:

• import an example project into workspace.
• check that there are no compile errors.

5.Run example project:

• go Run - Run Configurations...
• select 'swordfish' configuration to run.
• click Run. Wait untill container will start. Basicaly, when you will see: INFO: Setting the server's publish address to be /HelloWorld in log, you can proceed

6.Check if example works:

• while an example project is started (p.5) type in 'http://localhost:8080/cxf/' in browser url address field
• click on {http ://cxf.examples.servicemix.apache.org/}HelloWorldImplPort.
• you will see the WSDL document generated (also you can see WSDL using direct url: http://localhost:8080/cxf/HelloWorld?wsdl ).

Export example project JAR.

There are 2 ways to export an example jar for use in a standalone environment.

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

---

return to Swordfish Documentation Home
go to Swordfish Wiki Home