org.apache.syncope.client.lib

Class SyncopeClient

java.lang.Object

org.apache.syncope.client.lib.SyncopeClient

public class SyncopeClient
extends Object

Entry point for client access to all REST services exposed by Syncope core; obtain instances via SyncopeClientFactoryBean.

Constructor Summary

Constructors

Constructor and Description
SyncopeClient(javax.ws.rs.core.MediaType mediaType, RestClientFactoryBean restClientFactory, RestClientExceptionMapper exceptionMapper, String username, String password, boolean useCompression)

Method Summary

Modifier and Type	Method and Description
static org.apache.syncope.common.lib.search.AnyObjectFiqlSearchConditionBuilder	getAnyObjectSearchConditionBuilder(String type) Returns a new instance of AnyObjectFiqlSearchConditionBuilder, for assisted building of FIQL queries.
static org.apache.syncope.common.lib.search.GroupFiqlSearchConditionBuilder	getGroupSearchConditionBuilder() Returns a new instance of GroupFiqlSearchConditionBuilder, for assisted building of FIQL queries.
<T> javax.ws.rs.core.EntityTag	getLatestEntityTag(T service) Fetches ETag header value from latest service run (if available).
static org.apache.syncope.common.lib.search.OrderByClauseBuilder	getOrderByClauseBuilder() Returns a new instance of OrderByClauseBuilder, for assisted building of orderby clauses.
<T> T	getService(Class<T> serviceClass) Creates an instance of the given service class, with configured content type and authentication.
static org.apache.syncope.common.lib.search.UserFiqlSearchConditionBuilder	getUserSearchConditionBuilder() Returns a new instance of UserFiqlSearchConditionBuilder, for assisted building of FIQL queries.
<T> T	header(Class<T> serviceClass, String key, Object... values) Creates an instance of the given service class and sets the given header.
<T> T	header(T service, String key, Object... values) Sets the given header on the give service instance.
<T> T	ifMatch(Class<T> serviceClass, javax.ws.rs.core.EntityTag etag) Creates an instance of the given service class, with If-Match header set.
<T> T	ifMatch(T service, javax.ws.rs.core.EntityTag etag) Sets the If-Match header on the given service instance.
<T> T	ifNoneMatch(Class<T> serviceClass, javax.ws.rs.core.EntityTag etag) Creates an instance of the given service class, with If-None-Match header set.
<T> T	ifNoneMatch(T service, javax.ws.rs.core.EntityTag etag) Sets the If-None-Match header on the given service instance.
<T> T	nullPriorityAsync(Class<T> serviceClass, boolean nullPriorityAsync) Asks for asynchronous propagation towards external resources with null priority.
<T> T	prefer(Class<T> serviceClass, Preference preference) Creates an instance of the given service class, with Prefer header set.
<T> T	prefer(T service, Preference preference) Sets the Prefer header on the give service instance.
org.apache.commons.lang3.tuple.Pair<Map<String,Set<String>>,org.apache.syncope.common.lib.to.UserTO>	self()

Methods inherited from class java.lang.Object

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

Constructor Detail

SyncopeClient

public SyncopeClient(javax.ws.rs.core.MediaType mediaType,
                     RestClientFactoryBean restClientFactory,
                     RestClientExceptionMapper exceptionMapper,
                     String username,
                     String password,
                     boolean useCompression)

Method Detail

getUserSearchConditionBuilder

public static org.apache.syncope.common.lib.search.UserFiqlSearchConditionBuilder getUserSearchConditionBuilder()

Returns a new instance of UserFiqlSearchConditionBuilder, for assisted building of FIQL queries.

Returns:

default instance of UserFiqlSearchConditionBuilder

getGroupSearchConditionBuilder

public static org.apache.syncope.common.lib.search.GroupFiqlSearchConditionBuilder getGroupSearchConditionBuilder()

Returns a new instance of GroupFiqlSearchConditionBuilder, for assisted building of FIQL queries.

Returns:

default instance of GroupFiqlSearchConditionBuilder

getAnyObjectSearchConditionBuilder

public static org.apache.syncope.common.lib.search.AnyObjectFiqlSearchConditionBuilder getAnyObjectSearchConditionBuilder(String type)

Returns a new instance of AnyObjectFiqlSearchConditionBuilder, for assisted building of FIQL queries.

Parameters:

type - any type

Returns:

default instance of AnyObjectFiqlSearchConditionBuilder

getOrderByClauseBuilder

public static org.apache.syncope.common.lib.search.OrderByClauseBuilder getOrderByClauseBuilder()

Returns a new instance of OrderByClauseBuilder, for assisted building of orderby clauses.

Returns:

default instance of OrderByClauseBuilder

getService

public <T> T getService(Class<T> serviceClass)

Creates an instance of the given service class, with configured content type and authentication.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

Returns:

service instance of the given reference class

self

public org.apache.commons.lang3.tuple.Pair<Map<String,Set<String>>,org.apache.syncope.common.lib.to.UserTO> self()

header

public <T> T header(T service,
                    String key,
                    Object... values)

Sets the given header on the give service instance.

Type Parameters:

T - any service class

Parameters:

service - service class instance

key - HTTP header key

values - HTTP header values

Returns:

given service instance, with given header set

header

public <T> T header(Class<T> serviceClass,
                    String key,
                    Object... values)

Creates an instance of the given service class and sets the given header.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

key - HTTP header key

values - HTTP header values

Returns:

service instance of the given reference class, with given header set

prefer

public <T> T prefer(T service,
                    Preference preference)

Sets the Prefer header on the give service instance.

Type Parameters:

T - any service class

Parameters:

service - service class instance

preference - preference to be set via Prefer header

Returns:

given service instance, with Prefer header set

prefer

public <T> T prefer(Class<T> serviceClass,
                    Preference preference)

Creates an instance of the given service class, with Prefer header set.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

preference - preference to be set via Prefer header

Returns:

service instance of the given reference class, with Prefer header set

nullPriorityAsync

public <T> T nullPriorityAsync(Class<T> serviceClass,
                               boolean nullPriorityAsync)

Asks for asynchronous propagation towards external resources with null priority.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

nullPriorityAsync - whether asynchronous propagation towards external resources with null priority is requested

Returns:

service instance of the given reference class, with related header set

ifMatch

public <T> T ifMatch(T service,
                     javax.ws.rs.core.EntityTag etag)

Sets the If-Match header on the given service instance.

Type Parameters:

T - any service class

Parameters:

service - service class instance

etag - ETag value

Returns:

given service instance, with If-Match set

ifMatch

public <T> T ifMatch(Class<T> serviceClass,
                     javax.ws.rs.core.EntityTag etag)

Creates an instance of the given service class, with If-Match header set.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

etag - ETag value

Returns:

given service instance, with If-Match set

ifNoneMatch

public <T> T ifNoneMatch(T service,
                         javax.ws.rs.core.EntityTag etag)

Sets the If-None-Match header on the given service instance.

Type Parameters:

T - any service class

Parameters:

service - service class instance

etag - ETag value

Returns:

given service instance, with If-None-Match set

ifNoneMatch

public <T> T ifNoneMatch(Class<T> serviceClass,
                         javax.ws.rs.core.EntityTag etag)

Creates an instance of the given service class, with If-None-Match header set.

Type Parameters:

T - any service class

Parameters:

serviceClass - service class reference

etag - ETag value

Returns:

given service instance, with If-None-Match set

getLatestEntityTag

public <T> javax.ws.rs.core.EntityTag getLatestEntityTag(T service)

Fetches ETag header value from latest service run (if available).

Type Parameters:

T - any service class

Parameters:

service - service class instance

Returns:

ETag header value from latest service run (if available)