Description

The REST plugin enables the usage of HTTPBuilder on a Griffon application.

Installation

The current version of griffon-rest-plugin is 0.7.1
To install just issue the following command

Usage

The plugin will inject the following dynamic methods:

• withHttp(Map params, Closure stmts) - executes stmts using a HTTPBuilder
• withAsyncHttp(Map params, Closure stmts) - executes stmts using an AsyncHTTPBuilder
• withRest(Map params, Closure stmts) - executes stmts using a RESTClient

Where params may contain

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

Examples

Taken from HttpBuilder's Simplified GET Request

Note Notice that you can call HTTPBuilder's methods inside stmts, the current HTTPBuilder is set as the closure's delegate. The same holds true for the other dynamic methods.

AsyncHTTPBuilder

All dynamic methods will create a new http 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.

Here's an example of a non-griffon artifact making a REST call to Flickr

Finally, it's possible to call any of RestConnector's method from Java passing a CallableWithArgs instance instead of a Closure, like this

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

Proxy settings

You can apply proxy settings by calling setProxy(String host, int port, String scheme) on the client/builders at any time. You can also take advantage of the proxy: shortcut

This shortcut has the following defaults

• port: = 80
• scheme: = http

Meaning most of the times you'd only need to define a value for host:

History