org.apache.unomi.rest.endpoints

Class ScoringServiceEndPoint

java.lang.Object

org.apache.unomi.rest.endpoints.ScoringServiceEndPoint

@Produces(value="application/json")
 @Consumes(value="application/json")
 @Path(value="/scoring")
public class ScoringServiceEndPoint
extends Object

A JAX-RS endpoint to manage Scorings

Constructor Summary

Constructors

Constructor and Description
ScoringServiceEndPoint()

Method Summary

Modifier and Type	Method and Description
void	createScoringDefinition(String scope, String scoringId, String scoringName, String scoringDescription) Creates a scoring with the specified scope, identifier, name and description from form-encoded data.
Scoring	getScoringDefinition(String scoringId) Retrieves the scoring identified by the specified identifier.
DependentMetadata	getScoringDependentMetadata(String scoringId) Retrieves the list of Segment and Scoring metadata depending on the specified scoring.
List<Metadata>	getScoringMetadatas(int offset, int size, String sortBy) Retrieves the set of all scoring metadata.
PartialList<Metadata>	getScoringMetadatas(Query query) Retrieves the set of scoring metadata for scorings matching the specified query.
DependentMetadata	removeScoringDefinition(String scoringId, boolean validate) Removes the scoring definition identified by the specified identifier.
void	resetQueries() Deprecated. As of version 1.1.0-incubating, not needed anymore
void	setScoringDefinition(Scoring scoring) Persists the specified scoring in the context server.
void	setSegmentService(SegmentService segmentService)

Methods inherited from class java.lang.Object

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

Constructor Detail

ScoringServiceEndPoint

public ScoringServiceEndPoint()

Method Detail

setSegmentService

public void setSegmentService(SegmentService segmentService)

getScoringMetadatas

@GET
 @Path(value="/")
public List<Metadata> getScoringMetadatas(@QueryParam(value="offset") @DefaultValue(value="0")
                                                                 int offset,
                                                                 @QueryParam(value="size") @DefaultValue(value="50")
                                                                 int size,
                                                                 @QueryParam(value="sort")
                                                                 String sortBy)

Retrieves the set of all scoring metadata.

Parameters:

offset - zero or a positive integer specifying the position of the first element in the total ordered collection of matching elements

size - a positive integer specifying how many matching elements should be retrieved or -1 if all of them should be retrieved

sortBy - an optional (null if no sorting is required) String of comma (,) separated property names on which ordering should be performed, ordering elements according to the property order in the String, considering each in turn and moving on to the next one in case of equality of all preceding ones. Each property name is optionally followed by a column (:) and an order specifier: asc or desc.

Returns:

the set of all scoring metadata

getScoringMetadatas

@POST
 @Path(value="/query")
public PartialList<Metadata> getScoringMetadatas(Query query)

Retrieves the set of scoring metadata for scorings matching the specified query.

Parameters:

query - the query the scorings must match for their metadata to be retrieved

Returns:

the set of scoring metadata for scorings matching the specified query

getScoringDefinition

@GET
 @Path(value="/{scoringID}")
public Scoring getScoringDefinition(@PathParam(value="scoringID")
                                                                      String scoringId)

Retrieves the scoring identified by the specified identifier.

Parameters:

scoringId - the identifier of the scoring to be retrieved

Returns:

the scoring identified by the specified identifier or null if no such scoring exists

setScoringDefinition

@POST
 @Path(value="/")
public void setScoringDefinition(Scoring scoring)

Persists the specified scoring in the context server.

Parameters:

scoring - the scoring to be persisted

createScoringDefinition

@PUT
 @Path(value="/{scope}/{scoringID}")
 @Consumes(value="application/x-www-form-urlencoded")
public void createScoringDefinition(@PathParam(value="scope")
                                                                                                                                    String scope,
                                                                                                                                    @PathParam(value="scoringID")
                                                                                                                                    String scoringId,
                                                                                                                                    @FormParam(value="scoringName")
                                                                                                                                    String scoringName,
                                                                                                                                    @FormParam(value="scoringDescription")
                                                                                                                                    String scoringDescription)

Creates a scoring with the specified scope, identifier, name and description from form-encoded data.

Parameters:

scope - the scope for the new scoring

scoringId - the identifier for the new scoring

scoringName - the name of the new scoring

scoringDescription - the description of the new scoring

See Also:

Item's description for a discussion of scope

removeScoringDefinition

@DELETE
 @Path(value="/{scoringID}")
public DependentMetadata removeScoringDefinition(@PathParam(value="scoringID")
                                                                                      String scoringId,
                                                                                      @QueryParam(value="validate")
                                                                                      boolean validate)

Removes the scoring definition identified by the specified identifier. We can specify that we want the operation to be validated beforehand so that we can know if any other segment that might use the segment we're trying to delete as a condition might be impacted. If validate is set to false, no validation is performed. If set to true, we will first check if any segment or scoring depends on the scoring we're trying to delete and if so we will not delete the scoring but rather return the list of the metadata of the impacted items. If no dependents are found, then we properly delete the scoring.

Parameters:

scoringId - the identifier of the scoring we want to delete

validate - whether or not to perform validation

Returns:

a list of impacted items metadata if any or an empty list if none were found or validation was skipped

getScoringDependentMetadata

@GET
 @Path(value="/{scoringID}/impacted")
public DependentMetadata getScoringDependentMetadata(@PathParam(value="scoringID")
                                                                                                String scoringId)

Retrieves the list of Segment and Scoring metadata depending on the specified scoring. A segment or scoring is depending on a segment if it includes a scoringCondition with a test on this scoring.

Parameters:

scoringId - the segment identifier

Returns:

a list of Segment/Scoring Metadata depending on the specified scoring

resetQueries

@Deprecated
 @GET
 @Path(value="/resetQueries")
public void resetQueries()

Deprecated. As of version 1.1.0-incubating, not needed anymore

TODO: remove