Jump to: navigation, search

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:

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