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.

   grails create-app exporter
   

3. Change into the application's directory. Install the xfire plugin.

   grails install-plugin xfire
   

4. Create a MathService

   grails create-service MathService
   

   grails-app/services/MathService.groovy

   class MathService {
       boolean transactional = false
       static expose = ["xfire"]
   
       double add(double arg0, double arg1){
           println "add($arg0, $arg1)" // good old println() for quick debugging
           return arg0 + arg1
       }
   }
   

5. Start the application

   grails run-app
   

Now we're ready to build the Griffon application

1. Create a new Griffon application. We'll pick MathClient as the name

   griffon create-app mathClient
   

2. Install the wsclient plugin

   griffon install-plugin wsclient
   

3. Fix the view script to look like this
   griffon-app/views/MathClientView.groovy

   application(title: 'Wsclient Plugin Example',
     pack: true,
     locationByPlatform: true,
     iconImage: imageIcon('/griffon-icon-48x48.png').image,
     iconImages: [imageIcon('/griffon-icon-48x48.png').image,
                  imageIcon('/griffon-icon-32x32.png').image,
                  imageIcon('/griffon-icon-16x16.png').image]) {
       gridLayout(cols: 2, rows: 4)
       label("Num1:")
       textField(columns: 20, text: bind(target: model, targetProperty: "num1"))
       label("Num2:")
       textField(columns: 20, text: bind(target: model, targetProperty: "num2"))
       label("Result:")
       label(text: bind{model.result})
       button("Calculate", enabled: bind{model.enabled}, actionPerformed: controller.calculate)
   }
   

4. Let's add required properties to the model
   griffon-app/models/MathClientModel.groovy

   import groovy.beans.Bindable
   
   class MathClientModel {
      @Bindable String num1
      @Bindable String num2
      @Bindable String result
      @Bindable boolean enabled = true
   }
   

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

   class MathClientController {
       def model
   
       def calculate = { evt = null ->
           double a = model.num1.toDouble()
           double b = model.num2.toDouble()
           model.enabled = false
           doOutside {
               try {
                   def result = withWs(wsdl: "http://localhost:8080/exporter/services/math?wsdl") {
                       add(a, b)
                   }
                   doLater { model.result = result.toString() }
               } finally {
                   model.enabled = true
               }
           }
       }
   }
   

6. Start the application

   griffon run-app
   

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

griffon.wsclient.injectInto = ["controller", "service"]