Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

This sample demonstrates the WSO2 Application Server's ability to generate code for a WSDL 2.0 description and its ability to invoke a real world application RESTfully. The WSDL  describes the REST API (http://www.flickr.com/services/api/) of Flickr via HTTPBinding (http://www.w3.org/TR/2007/REC-wsdl20-adjuncts-20070626/#http-binding)  of WSDL 2.0. The Client provided in the sample uses a stub which that is dynamically generated by the Application Server.You can find the "FlickrClient" sample discussed here

Building the sample

The  FlickrClient sample is located in <AS_HOME>/samples/FlickrClient.

Building and Running the Sample

To build the samples you need Apache Ant build tool.

The steps are as follows:

1. Install and run the WSO2 Application Server. Refer to the   Installation Guide for instructions.

2. In a command prompt, switch to the FlickrClient FlickrClient directory.

For example, in Wndows, cd <AS_HOME>\samples\FlickrClient3. From there, type ant .more information, see Building Axis2 Samples.

The build dynamically generates a stub using the WSDL 2.0 description and opens the Client.

Interacting with Flickr

...

  1. To contibue you need to provide an API key obtained from Flickr

...

  1. . The API key will be used for subsequent invocations of the Flickr API. If you do not have have an API key, you can apply for one from http://www.flickr.com/services/api/keys/apply

...

  1. The application can be configured using the configure menu using the following properties:
    • Host - Can be used to change the host address, the requests are sent to (Useful if you want to track the wire messages. e.g., tcp monitor).
    • Port - Can be used to change the port, the requests are sent to (Useful if you want to track the wire messages. e.g., tcp monitor).
    • API KEY - Used to change the API KEY provided.
    • Secret - Used to change the shared secret provided.

    Image Modified

...

  1. Each main tab in the application corresponds to a category of methods specified in the Flickr API.
    For example, the

...

  1. people

...

  1. tab corresponds to the people category while the

...

  1. PhotoSetsComments

...

  1.  tab corresponds to the photosets.comments category.

...

  1. Each sub tab in the

...

  1. application, corresponds to a single method specified in the Flickr API under the main category. For example, the

...

  1. FindByEmail

...

  1. tab corresponds to the flickr.people.findByEmail method defined under the

...

  1. people

...

  1. category; while the

...

  1. PhotoSetsComments

...

  1.  tab corresponds to the

...

  1. photosets.comments

...

  1. category.

Flickr Authorization

Many methods on Flickr require the user to be logged in. When such a method is accessed, the application shows a dialog box stating that authorization is required to proceed.

If you click the "Yes" button in the dialog box, the application will authorize using the relevant Flickr API. If you are not currently logged into Flickr, you will be asked to do so first. It always requests only the permission needed to fulfill a particular request. If the application does not have sufficient permission when another operation is attempted, it may require you to grant permission again.

...

The WSDL for the FlickrClient can be found here: <AS_HOME>/samples/FlickrClient/wsdl