org.openestate.is24.restapi

Class GIS.CountryService

java.lang.Object

org.openestate.is24.restapi.GIS.CountryService

Enclosing class:

GIS

public static final class GIS.CountryService
extends Object

Low level methods for the Country Webservice.

The Country Webservice is used in the Geo Information Service API to get informations about available countries.

Since:

0.3

Author:

Andreas Rudolph

See Also:

Geo Information Service API

Method Summary

Methods

Modifier and Type	Method and Description
static Country	get(AbstractClient client, long is24ContinentId, long is24CountryId) Call the GET method of the Country Webservice.
static Countries	getAll(AbstractClient client, long is24ContinentId) Call the GETall method of the Country Webservice.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

get

public static Country get(AbstractClient client,
          long is24ContinentId,
          long is24CountryId)
                   throws IOException,
                          oauth.signpost.exception.OAuthException,
                          JAXBException,
                          RequestFailedException

Call the GET method of the Country Webservice.

This method returns a specific country.

Parameters:

client - AbstractClient, that is used to communicate with the Webservice

is24ContinentId - ID of the continent to lookup, that was returned by GIS.ContinentService

is24CountryId - ID of the country to lookup, that was returned by getAll(org.openestate.is24.restapi.AbstractClient, long)

Returns:

requested country

Throws:

IOException - if communication with the Webservice failed

oauth.signpost.exception.OAuthException - if authorization failed

JAXBException - if XML reading / writing failed

RequestFailedException - if the Webservice did not respond with a success message

See Also:

Geo Information Service API

getAll

public static Countries getAll(AbstractClient client,
               long is24ContinentId)
                        throws IOException,
                               oauth.signpost.exception.OAuthException,
                               JAXBException,
                               RequestFailedException

Call the GETall method of the Country Webservice.

This method returns the list of available countries for a continent.

Parameters:

client - AbstractClient, that is used to communicate with the Webservice

is24ContinentId - ID of the continent to lookup, that was returned by GIS.ContinentService

Returns:

list of countries

Throws:

IOException - if communication with the Webservice failed

oauth.signpost.exception.OAuthException - if authorization failed

JAXBException - if XML reading / writing failed

RequestFailedException - if the Webservice did not respond with a success message

See Also:

Geo Information Service API