Description

The Wsclient plugin adds a remoting client capable of communicating via SOAP. It is compatible with Grails' Xfire plugin 0.8.1.

Installation

The current version of griffon-wsclient-plugin is 0.5
To install just issue the following command

Usage

The plugin will inject the following dynamic methods:

• withWs(Map params, Closure stmts) - executes stmts issuing SOAP calls to a remote server.
• withWs(Map params, CallableWithArgs<T> stmts) - executes stmts issuing SOAP calls to a remote server.

Where params may contain

These methods are also accessible to any component through the singleton griffon.plugins.wsclient.WsclientConnector. You can inject these methods to non-artifacts via metaclasses. Simply grab hold of a particular metaclass and call WsclientConnector.enhance(metaClassInstance).

Examples

This example relies on Grails as the service provider. Follow these steps to configure the service on the Grails side:

1. Download a copy of Grails and install it.
2. Create a new Grails application. We'll pick 'exporter' as the application name.
3. Change into the application's directory. Install the xfire plugin.
4. Create a MathService
   grails-app/services/MathService.groovy
5. Start the application

Now we're ready to build the Griffon application

1. Create a new Griffon application. We'll pick MathClient as the name
2. Install the wsclient plugin
3. Fix the view script to look like this
   griffon-app/views/MathClientView.groovy
4. Let's add required properties to the model
   griffon-app/models/MathClientModel.groovy
5. Now for the controller code. Notice that there is minimal error handling in place. If the user types something that is not a number the client will surely break, but the code is sufficient for now.
   griffon-app/controllers/MathClientController.groovy
6. Start the application

All dynamic methods will create a new client when invoked unless you define an id: attribute. When this attribute is supplied the client will be stored as a property on the instance's metaClass. You will be able to access it via regular property access or using the id: again.

Configuration

Dynamic method injection

Dynamic methods will be added to controllers by default. You can change this setting by adding a configuration flag in Config.groovy

History