Newb: Need help with rest binding

[moraleslos]

Hi all,

I'm a total newb with SY and am following the rest-binding example for the quickstart but I'm not sure how everything works out.  I would like to create a simple service in SY that, when invoked by some outside source, calls an external REST service.

So say I have this external REST service I would like to use:  http://host.com/rest/services/GeocodeServer/findCity?x=____&y=_____

Now in SY, I want to create essentially a facade that will receive the x and y coordinates, invoke the above external REST service with the passed-in coordinates, and then return a result which is essentially a POJO that has city information.  The SY service looks something like this:

Town findTownInformation(String x, String y)

Where Town is just a POJO containing basic properties.

Now looking at the example I need to create a service, it's implementation, and a reference to the external Web Service.  So far this is how my example SY.xml looks like:

<?xml version="1.0" encoding="UTF-8"?>

<switchyard xmlns="urn:switchyard-config:switchyard:1.0" xmlns:bean="urn:switchyard-component-bean:config:1.0" xmlns:sca="http://docs.oasis-open.org/ns/opencsa/sca/200912" name="switchyard-rest-example" targetNamespace="urn:com.example.switchyard:switchyard-rest-example:0.0.1-SNAPSHOT">

  <sca:composite name="switchyard-rest-example" targetNamespace="urn:com.example.switchyard:switchyard-rest-example:0.0.1-SNAPSHOT">

    <sca:component name="InvokeRestServiceBean">

      <bean:implementation.bean class="com.example.switchyard.switchyard_rest_example.InvokeRestServiceBean"/>

      <sca:service name="InvokeRestService">

        <sca:interface.java interface="com.example.switchyard.switchyard_rest_example.InvokeRestService"/>

      </sca:service>

      <sca:reference name="InvokeRestServiceReference">

        <sca:interface.java interface="com.example.switchyard.switchyard_rest_example.InvokeRestServiceReference"/>

      </sca:reference>

    </sca:component>

  </sca:composite>

</switchyard>

I'm totally stuck at this point.  Any help would be appreciated.  TIA.

[rcernich]

You need to "promote" your reference, then add a REST binding to the promoted reference.  The binding is where you will configure the details for invoking the external service.

Hope that helps,

Rob

[moraleslos]

I'm not sure how to "promote" the reference in SY.  I can't seem to edit the xml file directly in Eclipse and am afraid if I edit outside and did something wrong, it will screw up my project.

I created a "reference" interface which mimics my service interface but has JAX-RS annotations.  I'm not sure if I even need to do this since all I want is for my service to invoke the external REST uri. 

Again I'm a total newb and I can't find any good documentation on how to do this using the SY editor so maybe a step-by-step description would go a long way for me.

TIA

[rcernich]

I'd recommend using the visual editor.  If you hover over the reference (purple arrow) on your component, a context pad should show up which has a button for promoting the reference.  Or, you could drop the reference tool (from the tool palette; a purple arrow) onto the canvas, then link that to the reference on the component.  You can then drag the REST binding tool onto the composite reference and configure the binding.

If you look at the reference-binding quickstart, you'll notice it has a reference within a component and a reference within the composite.  The composite reference is what you need to create.

I'd also recommend reviewing the overview in the user's guide, which describes the basic elements that make up a SwitchYard application.  https://docs.jboss.org/author/display/SWITCHYARD/User+Guide

In addition to that, you may want to import the reference-binding quickstart into your workspace so that you can view the configuration within the editor.  This will show you how the component reference is wired to the composite reference and how the rest binding is configured on the composite reference.

[moraleslos]

Ok I was able to promote the service.  It turned from a red arrow on my Bean to a big fat green arrow protruding on the right side of the composite.  Now I'm looking for the rest binding tool under "Bindings" but don't see anything for rest (see attached pic)

[rcernich]

It looks like you're using a pretty old version of the tools.  Which version are you using?

[moraleslos]

I don't recall since I was following a tutorial posted on a blog on JBoss.  But I attached a screenshot which may help:

if you're talking about SY tools, its 00.5.0.v20120713-1659-H145-Final.  I'm using Eclipse Indigo (seems like this is the only version that works)

[rcernich]

The latest version of the tools can be found here:  http://download.jboss.org/jbosstools/updates/integration/juno/soa-tooling/switchyard/1.0.0/

If you have problems installing, You can install from one of the following update sites (which include 1.0.0.Alpha1 of SwitchYard tooling), then upgrade to the latest build using the site above (recommended).  Depending on which version of Eclipse you are using:

Juno: http://download.jboss.org/jbosstools/updates/integration/juno/integration-stack/aggregate/4.0.1/

Kepler: http://download.jboss.org/jbosstools/updates/integration/kepler/integration-stack/aggregate/4.1.0/

These tools are only compatible with 1.x versions of SwitchYard.

Hope that helps,

Rob

[moraleslos]

Ok,

I'll just upgrade my environment first since it seems I'm using some old stuff.  I'll let you know.  Thanks for your help thus far and I'll update this thread.