Skip Headers

Oracle9iAS Personalization Programmer's Guide
Release 2 (v9.0.2)

Part Number A95245-02
HomeSolution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

7
RE Batch API Supporting Classes

This chapter describes the supporting classes for the REProxyBatch class. These classes are used to create instances of the objects used by the methods described in Chapter 8. You may be able to create one instance of many of these classes and use that one instance as an argument for several calls.


Note:

Except for Location, these supporting classes are the same as the ones that are used by REAPI. (Not all REAPI classes are used by the RE Batch API.)


Before you issue any of the recommendation methods described in Chapter 8, you must generate appropriate "FilteringSettings Class", TuningSettings Class, and Location Class instances.

All methods described in this chapter are public.

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.

The supporting classes are divided into two categories:

Ratings in OP

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.

Location of RE Batch API Classes

The following frequently used classes are in the oracle.dmt.re.base subdirectory:

For example, to use the Enum interfaces, you must include the following statement in your Java program:

   import oracle.dmt.op.re.base.Enum;

EnumType Interfaces for RE Batch API

Many of the RE Batch API methods reference attributes that can take on a finite number of values. The interface Enum is used to implement the base class for these "enumerations."

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 Interface

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 category should be excluded from the category list. For details, see "FilteringSettings Class" later in this chapter.

CategoryMembership takes on the following values:

The following statement assigns Enum.CategoryMembership.LEVEL to the variable myEnum:

   CategoryMembershipType myEnum = Enum.CategoryMembership.LEVEL;

DataSource Interface

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. The method 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 method in the Javadoc included with OP.

DataSource takes on the following values:

The following statement assigns Enum.DataSource.ALL to the variable myEnum:

   DataSourceType myEnum = Enum.DataSource.ALL;

InterestDimension Interface

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 would like to purchase the items. RATING indicates that the user likes the items. For more information, see the description of "TuningSettings Class" later in this chapter.

InterestDimension takes on the following values:

The following statement assigns Enum.InterestDimension.PURCHASING to the variable myEnum:

   InterestDimensionType myEnum = Enum.InterestDimension.PURCHASING;

PersonalizationIndex Interface

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 "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 Interface

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 "TuningSettings Class" later in this chapter.

ProfileDataBalance takes on the following values:

The following statement assigns Enum.ProfileDataBalance.HISTORY to the variable myEnum:

   ProfileDataBalanceType myEnum = Enum.ProfileDataBalance.HISTORY;

ProfileUsage Interface

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;

Sorting Interface

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 discussion of the DataItem 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;

Other RE Batch API Supporting Classes

The other supporting classes are

DataItem Class

This class is a subclass of class Item. It encapsulates data about an item.

There are two kinds of methods provided with this class:

The following methods return attribute values:

FilteringSettings Class

This class 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:

Not all filtering settings can be used will all methods. In particular, the following filtering setting cannot be used with the cross-sell methods :

Item Class

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 IDs must be unique within a given type, but different types can have the same IDs.

There are two kinds of methods provided with this class:

Location Class

This class specifies the location of the input table or the location of the table containing the results of an REProxyBatch method. The schema for the table depends on the call made. See the descriptions of the individual methods in the Javadoc for details.

There are three kinds of methods provided with this class:

TuningSettings Class

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:

The following methods set attribute values:

The following methods return attribute values:


Go to previous page Go to next page
Oracle
Copyright © 2001, 2002 Oracle Corporation.

All Rights Reserved.
HomeSolution Area
Go To Table Of Contents
Contents
Go To Index
Index