Oracle9iAS Personalization Programmer's Guide Release 2 (v9.0.2) Part Number A95245-02 |
|
This chapter describes the supporting classes for the REProxy
class. These classes are used to create instances of the objects used by the methods described in Chapter 4. You may be able to create one instance of many of these classes and use that one instance as an argument for several calls.
All methods described in this chapter are public.
The supporting classes are divided into two categories:
This chapter does not contained detailed descriptions of any of the classes. For detailed information, see the Javadoc in the OP section of the Oracle9i Application Server Documentation Library.
Ratings in OP are in "ascending order of goodness", that is, the higher the rating, the more the user prefers the item. Low rated items are items that the user does not prefer. OP algorithms use these assumptions, so it is important that ratings are in ascending order of goodness.
The following classes are in the oracle.dmt.op.re.base
package:
DataItem
Enum
FilteringSettings
Item
ItemList
TuningSettings
RecommendationContent
(one class in oracle.dmt.op.re.reapi.rt
)
To use the Enum
interfaces, you must include the following statement in your Java program:
import oracle.dmt.op.re.base.Enum;
Many of the REAPI methods reference attributes that can take on a finite number of values. The interface Enum
is used to implement the base class for these enumerated constants.
The Enum
interface has a nested EnumType
class with the following general methods:
int getId()
String toString()
String getName()
boolean isEqual(EnumType)
The following interfaces extend EnumType
:
CategoryMembership
DataSource
Filtering
InterestDimension
PersonalizationIndex
ProfileDataBalance
ProfileUsage
RecommendationAttribute
Sorting
User
CategoryMembershipType
is implemented as:
The class CategoryMembership
has the following methods:
CategoryMemberShipType getType(String name)
CategoryMemberShipType getType(int)
CategoryMembership
specifies how categories in a list of categories should be applied for filtering. For example, Enum.CategoryMembership.EXCLUDE_ITEMS
specifies that items from the categories in the category list should be excluded from the recommendations list. For details, see FilteringSettings Class later in this chapter.
CategoryMembership
takes on the following values:
Enum.CategoryMembership.EXCLUDE_ITEMS
Enum.CategoryMembership.INCLUDE_ITEMS
Enum.CategoryMembership.EXCLUDE_CATEGORIES
Enum.CategoryMembership.INCLUDE_CATEGORIES
Enum.CategoryMembership.LEVEL
Enum.CategoryMembership.SUBTREE_ITEMS
Enum.CategoryMembership.SUBTREE_CATEGORIES
Enum.CategoryMembership.ALL_ITEMS
Enum.CategoryMembership.ALL_CATEGORIES
The following statement assigns Enum.CategoryMembership.LEVEL
to the variable myEnum
:
CategoryMembershipType myEnum = Enum.CategoryMembership.LEVEL
DataSource
is implemented as:
The class DataSourceType
has the following methods:
DataSourceType
getType(String name)
DataSourceType
getType(int)
DataSource
specifies the type of data that is used when OP performs certain operations. For example, Enum.DataSource.DEMOGRAPHIC
specifies that demographic data should be used. The class DataItem Class, described later in this chapter, uses DataSource
. Note that a given method may not support all values of DataSource
. For details, see the description of the methods in Chapter 4.
DataSource
takes on the following values:
Enum.DataSource.DEMOGRAPHIC
Enum.DataSource.PURCHASING
Enum.DataSource.RATING
Enum.DataSource.NAVIGATION
Enum.DataSource.ALL
The following statement assigns Enum.DataSource.ALL
to the variable myEnum
:
DataSourceType myEnum = Enum.DataSource.ALL;
Filtering
is implemented as:
The class FilteringType
has the following methods:
FilteringType getType(String name)
FilteringType getType(int)
Filtering
is used to turn filtering on or off. See the description of the FilteringSettings Class, later in this chapter for more information.
Filtering
takes on the following values:
The following statement assigns Enum.Filtering.OFF
to the variable myEnum
:
FilteringType myEnum = Enum.Filtering.OFF;
InterestDimension
is implemented as:
The class InterestDimensionType
has the following methods:
InterestDimensionType getType(String name)
InterestDimensionType getType(int)
InterestDimension
indicates the type of interest that the user of the Web site has in a given item. NAVIGATION
indicates that the user is interested in the items. PURCHASING
indicates that the user purchased an item. RATING
indicates that the user likes the items. For more information, see the description of the RecommendationList Class and TuningSettings Class later in this chapter.
InterestDimension
takes on the following values:
The following statement assigns Enum.InterestDimension.PURCHASING
to the variable myEnum
:
InterestDimension myEnum = Enum.InterestDimension.PURCHASING;
PersonalizationIndex
is implemented as:
The class PersonalizationIndexType
has the following methods:
PersonalizationIndexType getType(String name)
PersonalizationIndexType getType(int)
PersonalizationIndex
specifies how "unusual" the recommendations returned will be. For example, LOW
specifies not unusual. For more information, see the description of the TuningSettings Class later in this chapter.
PersonalizationIndex
takes on the following values:
The following statement assigns Enum.PersonalizationIndex.LOW
to the variable myEnum
:
PersonalizationIndexType myEnum = Enum.PersonalizationIndex.LOW;
ProfileDataBalance
is implemented as:
The class ProfileDataBalanceType
has the following methods:
ProfileDataBalanceType getType(String name)
ProfileDataBalanceType getType(int)
ProfileDataBalance
specifies whether to take data from the current session or from history or to balance data between data from the current session and history when making recommendations. For more information, see the description of the TuningSettings Class later in this chapter.
ProfileDataBalance
takes on the following values:
The following statement assigns Enum.ProfileDataBalance.BALANCED
to the variable myEnum
:
ProfileDataBalanceType myEnum = Enum.ProfileDataBalance.BALANCED;
ProfileUsage
is implemented as:
The class ProfileUsageType
has the following methods:
ProfileUsageType getType(String name)
ProfileUsageType getType(int)
ProfileUsage
specifies whether the recommendation list can include or exclude items in a customer's profile. For more information, see the description of TuningSettings Class later in this chapter.
ProfileUsage
takes on the following values:
The following statement assigns Enum.ProfileUsage.INCLUDE
to the variable myEnum
:
ProfileUsageType myEnum = Enum.ProfileUsage.INCLUDE;
RecommendationAttribute
is implemented as:
The class RecommendationAttributeType
has the following methods:
RecommendationAttributeType getType(String name)
RecommendationAttributeType getType(int)
RecommendationAttribute
indicates the attribute to be included in the returned content; possible choices are type, ID, and prediction. For more information, see the descriptions of the ContentItem Class and RecommendationContent Class later in this chapter.
RecommendationAttribute
takes on the following values:
Enum.RecommendationAttribute.TYPE
Enum.RecommendationAttribute.ID
Enum.RecommendationAttribute.PREDICTION
The following statement assigns Enum.RecommendationAttribute.URL
to the variable myEnum
:
RecommendationAttributeType myEnum = Enum.RecommendationAttribute.TYPE;
Sorting
is implemented as:
The class SortingType
has the following methods:
SortingType getType(String name)
SortingType getType(int)
Sorting
indicates whether sorting is done (none implies no sorting), and, if sorting is done, how it is done (ascending or descending). For more information, see the discussions of the ContentItem Class and RecommendationContent Class later in this chapter.
Sorting
takes on the following values:
The following statement assigns Enum.Sorting.NONE
to the variable myEnum
:
SortingType myEnum = Enum.Sorting.NONE;
User
is implemented as:
The class UserType
has the following methods:
UserType getType(String name)
UserType getType(int)
UserType is either customer, a registered user of the calling Web site, or visitor, an unregistered user. For more information see the description of the IdentificationData Class later in this chapter.
UserType
takes on the following values:
The following statement assigns Enum.User.CUSTOMER
to the variable myEnum
:
UserTypeType myEnum = Enum.User.CUSTOMER;
The other supporting classes are
ContentItem
DataItem
FilteringSettings
IdentificationData
Item
ItemDetailData
Recommendation
RecommendationContent
RecommendationList
TuningSettings
These classes are described briefly in this document. For detailed descriptions, see the Javadoc for OP.
This class encapsulates the information that should be included in the object returned by a recommendation request. It describes the attributes to be included in the recommendation list returned by a call as well as specifying whether the list should be sorted according to one of the attributes. RecommendationContent Class, described later in this chapter, is any array of items of type ContentItem
; the description of RecommendationContent Class explains how sorting order works when multiple orders are specified.
This class contains the following methods:
This class is a subclass of class Item
. It encapsulates data about an item. This object is used as an argument in the data collection methods addItem()
and addItems()
.
There are two kinds of methods provided with this class:
This classe is used to specify the items to include or exclude when generating recommendations.
Release 2 of OP supports category filtering only.
There are three kinds of methods provided with this class:
FilteringSettings
setItemFiltering(int taxonomyID)
setItemFiltering(int taxonomyID, long[] categoryList)
setItemExclusion(int taxonomyID, long[] categoryList])
setItemSubTreeFiltering(int taxonomyID, long[] categoryList])
setCategoryExclusion(int taxonomyID, long[] categoryList])
setCategorySubTreeFiltering(int taxonomyID, long[] categoryList])
setCategoryLevelFiltering(int taxonomyID, long[] categoryList])
setCategoryFiltering(int taxonomyID)
setCategoryFiltering(int taxonomyID, long[] categoryList)
Not all filtering settings can be used will all methods. In particular, the following filtering setting cannot be used with the cross-sell methods:
setCategoryLevelFiltering
setCategorySubtreeFiltering
setCategoryExclusion
setCategoryFiltering(int)
setCategoryFiltering(int, long[])
Identifies the user and/or the session.
There are two kinds of methods provided with this class:
The calling Web application should assign a userID
to all users, both customers (registered users) and visitors. IDs for customers must be unique. If IDs for visitors are not unique, OP will not be able to make recommendations that are specific to a given visitor; instead the same recommendations would be made for all visitors who had the given ID.
This class is used to represent items that can be recommended and for which data can be collected. An item is uniquely represented by the combination of type
and ID
. Item ID
s must be unique within a given type
, but different type
s can have the same ID
s.
There are three kinds of methods provided with this class:
Item
instance
This class is created internally by OP as part of the result of recommendation request. The calling Web application will have to examine the attributes to determine what attributes and values they contain. See the description of Recommendation Class later in this chapter for more details.
There are three methods:
This class encapsulates information about a single recommended item. The information about the item is stored in the attributes
array.
There are two methods:
This class specifies the type of information that a recommendation request should return.
There are two kinds of methods provided with this class:
RecommendationContent
instances depending on how sorting is to be done
If multiple instances of the array are to be sorted, the sorting order follows the array index order. That is, the result is sorted according to the attribute in the first array entry marked to be sorted, followed by the attribute in the second entry marked to be sorted, etc.
A recommendation list is the collection of recommendations for a specific InterestDimension
. RecommendationList
is the class returned by all REAPI methods that return recommendations.
The methods in this class permit the calling Web application to determine the interest dimension type, to determine the actual number of recommendations returned, and to get the individual recommendations.
This class specifies settings to be applied when computing a recommendation. An instance of this class is passed to all recommendation requests.
There are three kinds of methods provided with this class:
TuningSettings
instance
The following methods set attribute values:
setDataSourceType()
setInterestDimension()
setPersonalizationIndex()
setProfileDataBalance()
setProfileUsage()
The following methods return attribute values:
getDataSourceType()
getInterestDimension()
getPersonalizationIndex()
getProfileDataBalance()
getProfileUsage()
|
Copyright © 2001, 2002 Oracle Corporation. All Rights Reserved. |
|