THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
The following section details the getting started examples that demonstrate how to write a simple client that consume RESTful Web Services with the Apache Wink Client.
GET Request
TBD
| Code Block | ||||
|---|---|---|---|---|
| ||||
// create the rest client instance
1 RestClient client = new RestClient();
// create the resource instance to interact with
2 Resource resource = client.resource("http://services.com/HelloWorld");
// perform a GET on the resource. The resource will be returned as plain text
3 String response = resource.accept("text/plain").get(String.class);
|
...
Finally, the Resource#get() method is invoked in order to issue an Http GET request as appears in line 3.
Once the Http response is returned, the client invokes the relevant provider to desterilizes the response in line 3.
POST Request
TBD
| Code Block | ||||
|---|---|---|---|---|
| ||||
// create the rest client instance
1 RestClient client = new RestClient();
// create the resource instance to interact with
2 Resource resource = client.resource("http://services.co");
// issue the request
3 String response = resource.contentType("text/plain").accept("text/plain").post(String.class, "foo");
|
...
First, a new instance of a Resource is created through the RestClient. The Http POST request is then issued by specifying the request and response media types and the response entity type (String.class).
POST Atom Request
TBD
| Code Block | ||||
|---|---|---|---|---|
| ||||
// create the rest client instance
1 RestClient client = new RestClient();
// create the resource instance to interact with
2 Resource resource = client.resource("http://services.co");
3 AtomEntry request = getAtomEntry();
// issue the request
4 AtomEntry response = resource.contentType("application/atom+xml").accept("application/atom+xml").post(AtomEntry.class, request);
|
...
The Apache Wink Client provides an object model for Atom (atom feed and atom entry), and supplies out-of-the-box providers that enable sending and receiving atom feeds and entries. The example demonstrates how to issue an Http POST request that sends and receives atom entries.
Using ClientResponse
TBD
| Code Block | ||||
|---|---|---|---|---|
| ||||
// create the rest client instance
1 RestClient client = new RestClient();
// create the resource instance to interact with
2 Resource resource = client.resource("http://services.co");
// issue the request
3 ClientResponse response = resource.accept("text/plain").get();
// deserialize response
4 String responseAsString = response.getEntity(String.class);
|
...