Package org.apache.syncope.common.keymaster.rest.api.service

Interface DomainService

All Superinterfaces:

Serializable

All Known Implementing Classes:

DomainServiceImpl

@Path("domains")
public interface DomainService
extends Serializable

REST operations for Self Keymaster's domains.

Method Summary

Modifier and Type	Method	Description
void	adjustPoolSize(@NotNull String key, int poolMaxActive, int poolMinIdle)	Adjusts the connection pool to the domain database.
void	changeAdminPassword(@NotNull String key, String password, CipherAlgorithm cipherAlgorithm)	Change admin's password for the given domain.
javax.ws.rs.core.Response	create(Domain domain)	Creates a new domain.
void	delete(@NotNull String key)	Deletes the domain matching the provided key.
List<Domain>	list()	Returns the list of defined domains.
Domain	read(@NotNull String key)	Returns the domain matching the given key.

Method Detail

list

@GET
@Produces("application/json")
List<Domain> list()

Returns the list of defined domains.

Returns:

list of defined domains

read

@GET
@Path("{key}")
@Produces("application/json")
Domain read(@NotNull @PathParam("key")
            @NotNull String key)

Returns the domain matching the given key.

Parameters:

key - key of the domain to be read

Returns:

domain matching the given key

create

@POST
@Consumes("application/json")
@Produces("application/json")
javax.ws.rs.core.Response create(Domain domain)

Creates a new domain.

Parameters:

domain - domain to be created

Returns:

Response object featuring Location header of created domain

changeAdminPassword

@POST
@Path("{key}/changeAdminPassword")
@Produces("application/json")
void changeAdminPassword(@NotNull @PathParam("key")
                         @NotNull String key,
                         @QueryParam("password")
                         String password,
                         @QueryParam("cipherAlgorithm")
                         CipherAlgorithm cipherAlgorithm)

Change admin's password for the given domain.

Parameters:

key - key of domain to be updated

password - encoded password value

cipherAlgorithm - password cipher algorithm

adjustPoolSize

@POST
@Path("{key}/adjustPoolSize")
@Produces("application/json")
void adjustPoolSize(@NotNull @PathParam("key")
                    @NotNull String key,
                    @QueryParam("poolMaxActive")
                    int poolMaxActive,
                    @QueryParam("poolMinIdle")
                    int poolMinIdle)

Adjusts the connection pool to the domain database.

Parameters:

key - key of domain to be updated

poolMaxActive - database pool max size

poolMinIdle - database pool max size

delete

@DELETE
@Path("{key}")
@Produces("application/json")
void delete(@NotNull @PathParam("key")
            @NotNull String key)

Deletes the domain matching the provided key.

Parameters:

key - key of domain to be deleted