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

Interface PolicyService

All Superinterfaces:

JAXRSService

@Path(value="policies")
public interface PolicyService
extends JAXRSService

REST operations for policies.

Field Summary

Fields inherited from interface org.apache.syncope.common.rest.api.service.JAXRSService

PARAM_ANYTYPE_KIND, PARAM_CONNID_PAGED_RESULTS_COOKIE, PARAM_DETAILS, PARAM_ENTITY_KEY, PARAM_FIQL, PARAM_MAX, PARAM_NOTIFICATION, PARAM_ORDERBY, PARAM_PAGE, PARAM_RESOURCE, PARAM_SIZE

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	create(PolicyType type, PolicyTO policyTO) Create a new policy.
void	delete(PolicyType type, String key) Delete policy matching the given key.
<T extends PolicyTO> List<T>	list(PolicyType type) Returns a list of policies of the matching type.
<T extends PolicyTO> T	read(PolicyType type, String key) Returns the policy matching the given key.
void	update(PolicyType type, PolicyTO policyTO) Updates policy matching the given key.

Method Detail

read

@GET
 @Path(value="{type}/{key}")
 @Produces(value={"application/json","application/yaml","application/xml"})
<T extends PolicyTO> T read(@NotNull @PathParam(value="type")
                                                                                                                                          PolicyType type,
                                                                                                                                          @NotNull @PathParam(value="key")
                                                                                                                                          String key)

Returns the policy matching the given key.

Type Parameters:

T - response type (extending PolicyTO)

Parameters:

type - policy type

key - key of requested policy

Returns:

policy with matching id

list

@GET
 @Path(value="{type}")
 @Produces(value={"application/json","application/yaml","application/xml"})
<T extends PolicyTO> List<T> list(@NotNull @PathParam(value="type")
                                                                                                                                          PolicyType type)

Returns a list of policies of the matching type.

Type Parameters:

T - response type (extending PolicyTO)

Parameters:

type - Type selector for requested policies

Returns:

list of policies with matching type

create

@POST
 @Path(value="{type}")
 @Consumes(value={"application/json","application/yaml","application/xml"})
 @Produces(value={"application/json","application/yaml","application/xml"})
javax.ws.rs.core.Response create(@NotNull @PathParam(value="type")
                                                                                                                                                                                                                      PolicyType type,
                                                                                                                                                                                                                      @NotNull
                                                                                                                                                                                                                      PolicyTO policyTO)

Create a new policy.

Parameters:

type - policy type

policyTO - Policy to be created (needs to match type)

Returns:

Response object featuring Location header of created policy

update

@PUT
 @Path(value="{type}/{key}")
 @Consumes(value={"application/json","application/yaml","application/xml"})
 @Produces(value={"application/json","application/yaml","application/xml"})
void update(@NotNull @PathParam(value="type")
                                                                                                                                                                                                      PolicyType type,
                                                                                                                                                                                                      @NotNull
                                                                                                                                                                                                      PolicyTO policyTO)

Updates policy matching the given key.

Parameters:

type - policy type

policyTO - Policy to replace existing policy

delete

@DELETE
 @Path(value="{type}/{key}")
 @Produces(value={"application/json","application/yaml","application/xml"})
void delete(@NotNull @PathParam(value="type")
                                                                                                                             PolicyType type,
                                                                                                                             @NotNull @PathParam(value="key")
                                                                                                                             String key)

Delete policy matching the given key.

Parameters:

type - policy type

key - key of policy to be deleted