com.unboundid.scim2.client

Interface ScimInterface

All Known Implementing Classes:

ScimService

public interface ScimInterface

Interface providing a way to create, retrieve, update and delete SCIM resources.

Method Summary

Modifier and Type	Method and Description
<T extends ScimResource> T	create(String endpoint, T resource) Create the provided new SCIM resource at the service provider.
void	delete(String endpoint, String id) Delete a SCIM resource at the service provider.
<T extends ScimResource> void	delete(T resource) Delete a SCIM resource at the service provider.
ResourceTypeResource	getResourceType(String name) Retrieve a known resource type supported by the service provider.
ListResponse<ResourceTypeResource>	getResourceTypes() Retrieve the resource types supported by the service provider.
SchemaResource	getSchema(String id) Retrieve a known schema supported by the service provider.
ListResponse<SchemaResource>	getSchemas() Retrieve the schemas supported by the service provider.
ServiceProviderConfigResource	getServiceProviderConfig() Retrieve the service provider configuration.
<T extends ScimResource> T	modify(String endpoint, String id, PatchRequest patchRequest, Class<T> clazz) Modify a SCIM resource by updating one or more attributes using a sequence of operations to "add", "remove", or "replace" values.
<T extends ScimResource> T	modify(T resource, PatchRequest patchRequest) Modify a SCIM resource by updating one or more attributes using a sequence of operations to "add", "remove", or "replace" values.
<T extends ScimResource> T	replace(T resource) Modify a SCIM resource by replacing the resource's attributes at the service provider.
<T extends ScimResource> T	retrieve(String endpoint, String id, Class<T> cls) Retrieve a known SCIM resource from the service provider.
<T extends ScimResource> T	retrieve(T resource) Retrieve a known SCIM resource from the service provider.
<T extends ScimResource> ListResponse<T>	search(String endpoint, String filter, Class<T> clazz) Search for SCIM resources matching the SCIM filter provided.

Method Detail

getServiceProviderConfig

ServiceProviderConfigResource getServiceProviderConfig()
                                                throws ScimException

Retrieve the service provider configuration.

Returns:

the service provider configuration.

Throws:

ScimException - if an error occurs.

getResourceTypes

ListResponse<ResourceTypeResource> getResourceTypes()
                                             throws ScimException

Retrieve the resource types supported by the service provider.

Returns:

The list of resource types supported by the service provider.

Throws:

ScimException - if an error occurs.

getResourceType

ResourceTypeResource getResourceType(String name)
                              throws ScimException

Retrieve a known resource type supported by the service provider.

Parameters:

name - The name of the resource type.

Returns:

The resource type with the provided name.

Throws:

ScimException - if an error occurs.

getSchemas

ListResponse<SchemaResource> getSchemas()
                                 throws ScimException

Retrieve the schemas supported by the service provider.

Returns:

The list of schemas supported by the service provider.

Throws:

ScimException - if an error occurs.

getSchema

SchemaResource getSchema(String id)
                  throws ScimException

Retrieve a known schema supported by the service provider.

Parameters:

id - The schema URN.

Returns:

The resource type with the provided URN.

Throws:

ScimException - if an error occurs.

create

<T extends ScimResource> T create(String endpoint,
                                  T resource)
                           throws ScimException

Create the provided new SCIM resource at the service provider.

Type Parameters:

T - The Java type of the resource.

Parameters:

endpoint - The resource endpoint such as: "Users" or "Groups" as defined by the associated resource type.

resource - The new resource to create.

Returns:

The successfully create SCIM resource.

Throws:

ScimException - if an error occurs.

retrieve

<T extends ScimResource> T retrieve(String endpoint,
                                    String id,
                                    Class<T> cls)
                             throws ScimException

Retrieve a known SCIM resource from the service provider.

Type Parameters:

T - The Java type of the resource.

Parameters:

endpoint - The resource endpoint such as: "Users" or "Groups" as defined by the associated resource type.

id - The resource identifier (for example the value of the "id" attribute).

cls - The Java class object used to determine the type to return.

Returns:

The successfully retrieved SCIM resource.

Throws:

ScimException - if an error occurs.

retrieve

<T extends ScimResource> T retrieve(T resource)
                             throws ScimException

Retrieve a known SCIM resource from the service provider. If the service provider supports resource versioning and the resource has not been modified, the provided resource will be returned.

Type Parameters:

T - The Java type of the resource.

Parameters:

resource - The resource to retrieve.

Returns:

The successfully retrieved SCIM resource.

Throws:

ScimException - if an error occurs.

replace

<T extends ScimResource> T replace(T resource)
                            throws ScimException

Modify a SCIM resource by replacing the resource's attributes at the service provider. If the service provider supports resource versioning, the resource will only be modified if it has not been modified since it was retrieved.

Type Parameters:

T - The Java type of the resource.

Parameters:

resource - The previously retrieved and revised resource.

Returns:

The successfully replaced SCIM resource.

Throws:

ScimException - if an error occurs.

modify

<T extends ScimResource> T modify(String endpoint,
                                  String id,
                                  PatchRequest patchRequest,
                                  Class<T> clazz)
                           throws ScimException

Modify a SCIM resource by updating one or more attributes using a sequence of operations to "add", "remove", or "replace" values. The service provider configuration maybe used to discover service provider support for PATCH.

Type Parameters:

T - The Java type of the resource.

Parameters:

endpoint - The resource endpoint such as: "Users" or "Groups" as defined by the associated resource type.

id - The resource identifier (for example the value of the "id" attribute).

patchRequest - the patch request to use for the update.

clazz - the class of the SCIM resource.

Returns:

The modified resource.

Throws:

ScimException - if an error occurs.

modify

<T extends ScimResource> T modify(T resource,
                                  PatchRequest patchRequest)
                           throws ScimException

Modify a SCIM resource by updating one or more attributes using a sequence of operations to "add", "remove", or "replace" values. The service provider configuration maybe used to discover service provider support for PATCH.

Type Parameters:

T - The Java type of the resource.

Parameters:

resource - The resource to modify.

patchRequest - the patch request to use for the update.

Returns:

The modified resource.

Throws:

ScimException - if an error occurs.

delete

void delete(String endpoint,
            String id)
     throws ScimException

Delete a SCIM resource at the service provider.

Parameters:

endpoint - The resource endpoint such as: "Users" or "Groups" as defined by the associated resource type.

id - The resource identifier (for example the value of the "id" attribute).

Throws:

ScimException - if an error occurs.

delete

<T extends ScimResource> void delete(T resource)
                              throws ScimException

Delete a SCIM resource at the service provider.

Type Parameters:

T - The Java type of the resource.

Parameters:

resource - The resource to delete.

Throws:

ScimException - if an error occurs.

search

<T extends ScimResource> ListResponse<T> search(String endpoint,
                                                String filter,
                                                Class<T> clazz)
                                         throws ScimException

Search for SCIM resources matching the SCIM filter provided.

Type Parameters:

T - The SCIM resource type to return a list of.

Parameters:

endpoint - a SCIM resource type endpoint.

filter - a SCIM filter string.

clazz - the class representing the type of the SCIM resource.

Returns:

a List of ScimResource objects matching the provided filter.

Throws:

ScimException - if an error occurs.