org.miniclient.impl

Class AbstractApiUserClient

java.lang.Object

org.miniclient.impl.AbstractApiUserClient

All Implemented Interfaces:

ApiClient, ApiUserClient, CrudMethodFilter, MethodFilter, FlexibleResourceClient, FlexibleUserClient, FlexibleWebClient, ResourceClient, ResourceUserClient, UserClient, WebClient

Direct Known Subclasses:

DefaultApiUserClient

public abstract class AbstractApiUserClient
extends Object
implements ApiUserClient, FlexibleResourceClient, FlexibleUserClient

Constructor Summary

Constructors

Constructor and Description
AbstractApiUserClient(ApiServiceClient apiServiceClient)
AbstractApiUserClient(ApiServiceClient apiServiceClient, UserCredential userCredential)
AbstractApiUserClient(String resourceBaseUrl)
AbstractApiUserClient(String resourceBaseUrl, UserCredential userCredential)

Method Summary

Methods

Modifier and Type	Method and Description
Object	create(Object inputData) Creates a new instance of the given resource, as defined by the inputData.
Object	create(Object inputData, String id) Creates a new instance of the given resource, as defined by the inputData and id.
int	delete(Map<String,Object> params) Deletes the resource instances specified by the params.
boolean	delete(String id) Deletes the resource instance specified by id.
Object	get(String id) Returns the resource specified by the id.
protected ApiServiceClient	getApiServiceClient()
AuthRefreshPolicy	getAuthRefreshPolicy()
AutoRedirectPolicy	getAutoRedirectPolicy()
CacheControlPolicy	getCacheControlPolicy()
ClientCachePolicy	getClientCachePolicy()
protected FlexibleResourceClient	getFlexibleApiServiceClient()
RequestRetryPolicy	getRequestRetryPolicy()
String	getResourceBaseUrl() Return the ResourceBaseUrl of this "resource".
AuthRefreshPolicy	getRestServiceAuthRefreshPolicy()
AutoRedirectPolicy	getRestServiceAutoRedirectPolicy()
ClientCachePolicy	getRestServiceClientCachePolicy()
RequestRetryPolicy	getRestServiceRequestRetryPolicy()
UserCredential	getUserCredential() Returns the UserCredential associated with this UserClient.
protected void	init()
boolean	isAccessAllowed()
boolean	isMethodSupported(String methodName)
List<String>	keys(Map<String,Object> params) Returns the list of keys of the resources filtered by the params.
List<Object>	list(Map<String,Object> params) Returns the list of objects/resources specified by the params.
protected ApiUserClientMaker	makeApiUserClientMaker()
protected ApiServiceClient	makeServiceClient(String resourceBaseUrl)
Object	modify(Object partialData, String id) Note: Partial update/PATCH support...
void	setAuthRefreshPolicy(AuthRefreshPolicy authRefreshPolicy)
void	setAutoRedirectPolicy(AutoRedirectPolicy autoRedirectPolicy)
void	setCacheControlPolicy(CacheControlPolicy cacheControlPolicy)
void	setClientCachePolicy(ClientCachePolicy clientCachePolicy)
void	setRequestRetryPolicy(RequestRetryPolicy requestRetryPolicy)
void	setRestServiceAuthRefreshPolicy(AuthRefreshPolicy authRefreshPolicy)
void	setRestServiceAutoRedirectPolicy(AutoRedirectPolicy autoRedirectPolicy)
void	setRestServiceClientCachePolicy(ClientCachePolicy clientCachePolicy)
void	setRestServiceRequestRetryPolicy(RequestRetryPolicy requestRetryPolicy)
void	setUserCredential(UserCredential userCredential)
String	toString()
Object	update(Object inputData, String id) Updates the resource instance, as defined by the inputData and id.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractApiUserClient

public AbstractApiUserClient(String resourceBaseUrl)

AbstractApiUserClient

public AbstractApiUserClient(String resourceBaseUrl,
                     UserCredential userCredential)

AbstractApiUserClient

public AbstractApiUserClient(ApiServiceClient apiServiceClient)

AbstractApiUserClient

public AbstractApiUserClient(ApiServiceClient apiServiceClient,
                     UserCredential userCredential)

Method Detail

init

protected void init()

getApiServiceClient

protected ApiServiceClient getApiServiceClient()

getFlexibleApiServiceClient

protected FlexibleResourceClient getFlexibleApiServiceClient()

makeApiUserClientMaker

protected ApiUserClientMaker makeApiUserClientMaker()

makeServiceClient

protected ApiServiceClient makeServiceClient(String resourceBaseUrl)

isMethodSupported

public boolean isMethodSupported(String methodName)

Specified by:

isMethodSupported in interface MethodFilter

getUserCredential

public UserCredential getUserCredential()

Description copied from interface: UserClient

Returns the UserCredential associated with this UserClient.

Specified by:

getUserCredential in interface UserClient

Returns:

UserCredential

setUserCredential

public void setUserCredential(UserCredential userCredential)

Specified by:

setUserCredential in interface FlexibleUserClient

isAccessAllowed

public boolean isAccessAllowed()

getResourceBaseUrl

public String getResourceBaseUrl()

Description copied from interface: ResourceClient

Return the ResourceBaseUrl of this "resource".

Specified by:

getResourceBaseUrl in interface ResourceClient

Returns:

ResourceBaseUrl

getRestServiceAuthRefreshPolicy

public AuthRefreshPolicy getRestServiceAuthRefreshPolicy()

setRestServiceAuthRefreshPolicy

public void setRestServiceAuthRefreshPolicy(AuthRefreshPolicy authRefreshPolicy)

getRestServiceRequestRetryPolicy

public RequestRetryPolicy getRestServiceRequestRetryPolicy()

setRestServiceRequestRetryPolicy

public void setRestServiceRequestRetryPolicy(RequestRetryPolicy requestRetryPolicy)

getRestServiceClientCachePolicy

public ClientCachePolicy getRestServiceClientCachePolicy()

setRestServiceClientCachePolicy

public void setRestServiceClientCachePolicy(ClientCachePolicy clientCachePolicy)

getRestServiceAutoRedirectPolicy

public AutoRedirectPolicy getRestServiceAutoRedirectPolicy()

setRestServiceAutoRedirectPolicy

public void setRestServiceAutoRedirectPolicy(AutoRedirectPolicy autoRedirectPolicy)

getAuthRefreshPolicy

public AuthRefreshPolicy getAuthRefreshPolicy()

Specified by:

getAuthRefreshPolicy in interface WebClient

setAuthRefreshPolicy

public void setAuthRefreshPolicy(AuthRefreshPolicy authRefreshPolicy)

Specified by:

setAuthRefreshPolicy in interface FlexibleWebClient

getRequestRetryPolicy

public RequestRetryPolicy getRequestRetryPolicy()

Specified by:

getRequestRetryPolicy in interface WebClient

setRequestRetryPolicy

public void setRequestRetryPolicy(RequestRetryPolicy requestRetryPolicy)

Specified by:

setRequestRetryPolicy in interface FlexibleWebClient

getClientCachePolicy

public ClientCachePolicy getClientCachePolicy()

Specified by:

getClientCachePolicy in interface WebClient

setClientCachePolicy

public void setClientCachePolicy(ClientCachePolicy clientCachePolicy)

Specified by:

setClientCachePolicy in interface FlexibleWebClient

getCacheControlPolicy

public CacheControlPolicy getCacheControlPolicy()

Specified by:

getCacheControlPolicy in interface WebClient

setCacheControlPolicy

public void setCacheControlPolicy(CacheControlPolicy cacheControlPolicy)

Specified by:

setCacheControlPolicy in interface FlexibleWebClient

getAutoRedirectPolicy

public AutoRedirectPolicy getAutoRedirectPolicy()

Specified by:

getAutoRedirectPolicy in interface WebClient

setAutoRedirectPolicy

public void setAutoRedirectPolicy(AutoRedirectPolicy autoRedirectPolicy)

Specified by:

setAutoRedirectPolicy in interface FlexibleWebClient

get

public Object get(String id)
           throws RestApiException,
                  IOException

Description copied from interface: ApiUserClient

Returns the resource specified by the id.

Specified by:

get in interface ApiUserClient

Parameters:

id - Unique id of the resource.

Returns:

The resource/object.

Throws:

RestApiException

IOException

list

public List<Object> list(Map<String,Object> params)
                  throws RestApiException,
                         IOException

Description copied from interface: ApiUserClient

Returns the list of objects/resources specified by the params.

Specified by:

list in interface ApiUserClient

Parameters:

params - Selection filter.

Returns:

The list of resource instances.

Throws:

RestApiException

IOException

keys

public List<String> keys(Map<String,Object> params)
                  throws RestApiException,
                         IOException

Description copied from interface: ApiUserClient

Returns the list of keys of the resources filtered by the params.

Specified by:

keys in interface ApiUserClient

Parameters:

params - Selection filter.

Returns:

The list of keys/ids of the resources selected by the params.

Throws:

RestApiException

IOException

create

public Object create(Object inputData)
              throws RestApiException,
                     IOException

Description copied from interface: ApiUserClient

Creates a new instance of the given resource, as defined by the inputData.

Specified by:

create in interface ApiUserClient

Parameters:

inputData - A representation of the resource instance to be created.

Returns:

The newly created resource object.

Throws:

RestApiException

IOException

create

public Object create(Object inputData,
            String id)
              throws RestApiException,
                     IOException

Description copied from interface: ApiUserClient

Creates a new instance of the given resource, as defined by the inputData and id.

Specified by:

create in interface ApiUserClient

Parameters:

inputData - A representation of the resource instance to be created.

id - The unique resource id.

Returns:

The newly created resource object.

Throws:

RestApiException

IOException

update

public Object update(Object inputData,
            String id)
              throws RestApiException,
                     IOException

Description copied from interface: ApiUserClient

Updates the resource instance, as defined by the inputData and id.

Specified by:

update in interface ApiUserClient

Parameters:

inputData - A new resource instance.

id - The resource id.

Returns:

The updated resource object.

Throws:

RestApiException

IOException

modify

public Object modify(Object partialData,
            String id)
              throws RestApiException,
                     IOException

Description copied from interface: ApiUserClient

Note: Partial update/PATCH support... Not all Web services support PATCH. (Not fully implemented yet....) Updates the resource instance, as defined by the partialtData and id.

Specified by:

modify in interface ApiUserClient

Parameters:

partialData - A "partial" representation of the new resource instance.

id - The resource id.

Returns:

The modified resource object. (TBD: Are we returning the partial object? Or, the full object?)

Throws:

RestApiException

IOException

delete

public boolean delete(String id)
               throws RestApiException,
                      IOException

Description copied from interface: ApiUserClient

Deletes the resource instance specified by id.

Specified by:

delete in interface ApiUserClient

Parameters:

id - The resource id.

Returns:

true if the operation is successful.

Throws:

RestApiException

IOException

delete

public int delete(Map<String,Object> params)
           throws RestApiException,
                  IOException

Description copied from interface: ApiUserClient

Deletes the resource instances specified by the params. (Not fully implemented yet....)

Specified by:

delete in interface ApiUserClient

Returns:

The number of resource objects successfully deleted. (TBD: Is it possible to do that in general? Just return boolean?)

Throws:

RestApiException

IOException

toString

public String toString()

Overrides:

toString in class Object