com.cloudera.oryx.app.serving.als

Class Because

java.lang.Object

com.cloudera.oryx.api.serving.OryxResource

com.cloudera.oryx.app.serving.AbstractOryxResource

com.cloudera.oryx.app.serving.als.Because

@Singleton
 @Path(value="/because")
public final class Because
extends AbstractOryxResource

Responds to a GET request to /because/[userID]/[itemID](?howMany=n)(&offset=o).

Results are items that the user has interacted with that best explain why a given item was recommended. Outputs contain item and score pairs, where the score is an opaque value where higher values mean more relevant to recommendation.

If the user is not known to the model, a Response.Status.NOT_FOUND response is generated. If the user has no known items associated, the response has no elements.

howMany and offset behavior, and output, are as in Recommend.

Field Summary

Fields inherited from class com.cloudera.oryx.api.serving.OryxResource

INPUT_PRODUCER_KEY, MODEL_MANAGER_KEY

Constructor Summary

Constructors

Constructor and Description
Because()

Method Summary

Modifier and Type	Method and Description
List<IDValue>	get(String userID, String itemID, int howMany, int offset)

Methods inherited from class com.cloudera.oryx.app.serving.AbstractOryxResource

check, check, checkExists, checkNotReadOnly, getServingModel, isReadOnly, maybeBuffer, maybeBuffer, maybeDecompress, parseMultipart, sendInput

Methods inherited from class com.cloudera.oryx.api.serving.OryxResource

getInputProducer, getServingModelManager, init

Methods inherited from class java.lang.Object

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

Constructor Detail

Because

public Because()

Method Detail

get

@GET
 @Path(value="{userID}/{itemID}")
 @Produces(value={"text/plain","text/csv","application/json"})
public List<IDValue> get(@PathParam(value="userID")
                                                                                                                               String userID,
                                                                                                                               @PathParam(value="itemID")
                                                                                                                               String itemID,
                                                                                                                               @DefaultValue(value="10") @QueryParam(value="howMany")
                                                                                                                               int howMany,
                                                                                                                               @DefaultValue(value="0") @QueryParam(value="offset")
                                                                                                                               int offset)
                                                                                                                        throws OryxServingException

Throws:

OryxServingException