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 is dynamically generated by the Application Server.
You can find the "FlickrClient" sample discussed here in <AS_HOME>/samples/FlickrClient.
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 directory.
For example, cd <AS_HOME>\samples\FlickrClient
3. From there, type ant.
The build dynamically generates a stub using the WSDL 2.0 description and opens the Client.
1. You need to provide an API key obtained from Flickr in order to continue. 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
2. The application can be configured using the configure menu using the following properties:
3. Each main tab in the application corresponds to a category of methods specified in the Flickr API. For example, the "people" tab corresponds to the people category while the "PhotoSetsComments" tab corresponds to the photosets.comments category
4. Each sub tab in the appilication corresponds to a single method specified in the Flickr API under the main category. For example, the "FindByEmail" tab corresponds to the flickr.people.findByEmail method defined under the "people" category while the "PhotoSetsComments" tab corresponds to the "photosets.comments" category.
Many methods in Flickr require the user to be logged in. Therefore, when such a method is accessed, the application shows you the following dialog box.
If you click "Yes," the application will authenticate you using the Flickr Authentication API. If you are not currently logged into flickr, you will be asked to do so first. The application will fire your default browser so that you can grant permission to the application. It always requests only the permission needed to fulfill a particular request. Therefore if the application does not have sufficient permission when another operation is attempted, it may require you to grant permission again.
There are three levels of permission.
The WSDL for the FlickrClient can be found here: <AS_HOME>/samples/FlickrClient/wsdl