org.opencms.db

接口 I_CmsSubscriptionDriver

所有已知实现类:

CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver, CmsSubscriptionDriver

public interface I_CmsSubscriptionDriver

The interface for drivers handling subscriptions and user tracking.

从以下版本开始:

8.0.0

字段概要

字段

限定符和类型	字段和说明
static int	DRIVER_TYPE_ID The type ID to identify subscription driver implementations.

方法概要

方法

限定符和类型	方法和说明
void	deleteVisits(CmsDbContext dbc, java.lang.String poolName, CmsVisitEntryFilter filter) Deletes visit entries matching the given filter.
long	getDateLastVisitedBy(CmsDbContext dbc, java.lang.String poolName, CmsUser user, CmsResource resource) Returns the date when the resource was last visited by the user.
CmsSqlManager	getSqlManager() Returns the SQL manager of this driver, if possible.
CmsSqlManager	initSqlManager(java.lang.String classname) Initializes the SQL manager for this driver.
void	markResourceAsVisitedBy(CmsDbContext dbc, java.lang.String poolName, CmsResource resource, CmsUser user) Mark the given resource as visited by the user.
java.util.List<CmsResource>	readAllSubscribedResources(CmsDbContext dbc, java.lang.String poolName, CmsPrincipal principal) Returns all resources subscribed by the given user or group.
java.util.List<CmsResource>	readResourcesVisitedBy(CmsDbContext dbc, java.lang.String poolName, CmsVisitedByFilter filter) Returns the resources that were visited by a user set in the filter.
java.util.List<I_CmsHistoryResource>	readSubscribedDeletedResources(CmsDbContext dbc, java.lang.String poolName, CmsUser user, java.util.List<CmsGroup> groups, CmsResource parent, boolean includeSubFolders, long deletedFrom) Returns the subscribed history resources that were deleted.
java.util.List<CmsResource>	readSubscribedResources(CmsDbContext dbc, java.lang.String poolName, CmsSubscriptionFilter filter) Returns the resources that were subscribed by a user or group set in the filter.
void	setSubscribedResourceAsDeleted(CmsDbContext dbc, java.lang.String poolName, CmsResource resource) Marks a subscribed resource as deleted.
void	subscribeResourceFor(CmsDbContext dbc, java.lang.String poolName, CmsPrincipal principal, CmsResource resource) Subscribes the user or group to the resource.
void	unsubscribeAllDeletedResources(CmsDbContext dbc, java.lang.String poolName, long deletedTo) Unsubscribes all deleted resources that were deleted before the specified time stamp.
void	unsubscribeAllResourcesFor(CmsDbContext dbc, java.lang.String poolName, CmsPrincipal principal) Unsubscribes the principal from all resources.
void	unsubscribeResourceFor(CmsDbContext dbc, java.lang.String poolName, CmsPrincipal principal, CmsResource resource) Unsubscribes the principal from the resource.
void	unsubscribeResourceForAll(CmsDbContext dbc, java.lang.String poolName, CmsResource resource) Unsubscribes all groups and users from the resource.

字段详细资料

DRIVER_TYPE_ID

static final int DRIVER_TYPE_ID

The type ID to identify subscription driver implementations.

另请参阅:

常量字段值

方法详细资料

deleteVisits

void deleteVisits(CmsDbContext dbc,
                java.lang.String poolName,
                CmsVisitEntryFilter filter)
                  throws CmsDataAccessException

Deletes visit entries matching the given filter.

参数:

dbc - the database context

poolName - the name of the database pool to use, if null, the default pool is used

filter - the log entry filter

抛出:

CmsDataAccessException - if something goes wrong

getDateLastVisitedBy

long getDateLastVisitedBy(CmsDbContext dbc,
                        java.lang.String poolName,
                        CmsUser user,
                        CmsResource resource)
                          throws CmsException

Returns the date when the resource was last visited by the user.

参数:

dbc - the database context

poolName - the name of the database pool to use

user - the user to check the date

resource - the resource to check the date

返回:

the date when the resource was last visited by the user

抛出:

CmsException - if something goes wrong

getSqlManager

CmsSqlManager getSqlManager()

Returns the SQL manager of this driver, if possible.

返回:

an SQL manager

initSqlManager

CmsSqlManager initSqlManager(java.lang.String classname)

Initializes the SQL manager for this driver.

To obtain JDBC connections from different pools, further {online|offline|history} pool Urls have to be specified.

参数:

classname - the classname of the SQL manager

返回:

the SQL manager for this driver

markResourceAsVisitedBy

void markResourceAsVisitedBy(CmsDbContext dbc,
                           java.lang.String poolName,
                           CmsResource resource,
                           CmsUser user)
                             throws CmsDataAccessException

Mark the given resource as visited by the user.

参数:

dbc - the database context

poolName - the name of the database pool to use

resource - the resource to mark as visited

user - the user that visited the resource

抛出:

CmsDataAccessException - if something goes wrong

readAllSubscribedResources

java.util.List<CmsResource> readAllSubscribedResources(CmsDbContext dbc,
                                                     java.lang.String poolName,
                                                     CmsPrincipal principal)
                                                       throws CmsDataAccessException

Returns all resources subscribed by the given user or group.

参数:

dbc - the database context

poolName - the name of the database pool to use

principal - the principal to read the subscribed resources

返回:

all resources subscribed by the given user or group

抛出:

CmsDataAccessException - if something goes wrong

readResourcesVisitedBy

java.util.List<CmsResource> readResourcesVisitedBy(CmsDbContext dbc,
                                                 java.lang.String poolName,
                                                 CmsVisitedByFilter filter)
                                                   throws CmsDataAccessException

Returns the resources that were visited by a user set in the filter.

参数:

dbc - the database context

poolName - the name of the database pool to use

filter - the filter that is used to get the visited resources

返回:

the resources that were visited by a user set in the filter

抛出:

CmsDataAccessException - if something goes wrong

readSubscribedDeletedResources

java.util.List<I_CmsHistoryResource> readSubscribedDeletedResources(CmsDbContext dbc,
                                                                  java.lang.String poolName,
                                                                  CmsUser user,
                                                                  java.util.List<CmsGroup> groups,
                                                                  CmsResource parent,
                                                                  boolean includeSubFolders,
                                                                  long deletedFrom)
                                                                    throws CmsDataAccessException

Returns the subscribed history resources that were deleted.

参数:

dbc - the database context

poolName - the name of the database pool to use

user - the user that subscribed to the resource

groups - the groups to check subscribed resources for

parent - the parent resource (folder) of the deleted resources, if null all deleted resources will be returned

includeSubFolders - indicates if the sub folders of the specified folder path should be considered, too

deletedFrom - the time stamp from which the resources should have been deleted

返回:

the subscribed history resources that were deleted

抛出:

CmsDataAccessException - if something goes wrong

readSubscribedResources

java.util.List<CmsResource> readSubscribedResources(CmsDbContext dbc,
                                                  java.lang.String poolName,
                                                  CmsSubscriptionFilter filter)
                                                    throws CmsDataAccessException

Returns the resources that were subscribed by a user or group set in the filter.

参数:

dbc - the database context

poolName - the name of the database pool to use

filter - the filter that is used to get the subscribed resources

返回:

the resources that were subscribed by a user or group set in the filter

抛出:

CmsDataAccessException - if something goes wrong

setSubscribedResourceAsDeleted

void setSubscribedResourceAsDeleted(CmsDbContext dbc,
                                  java.lang.String poolName,
                                  CmsResource resource)
                                    throws CmsDataAccessException

Marks a subscribed resource as deleted.

参数:

dbc - the database context

poolName - the name of the database pool to use

resource - the subscribed resource to mark as deleted

抛出:

CmsDataAccessException - if something goes wrong

subscribeResourceFor

void subscribeResourceFor(CmsDbContext dbc,
                        java.lang.String poolName,
                        CmsPrincipal principal,
                        CmsResource resource)
                          throws CmsDataAccessException

Subscribes the user or group to the resource.

参数:

dbc - the database context

poolName - the name of the database pool to use

principal - the principal that subscribes to the resource

resource - the resource to subscribe to

抛出:

CmsDataAccessException - if something goes wrong

unsubscribeAllDeletedResources

void unsubscribeAllDeletedResources(CmsDbContext dbc,
                                  java.lang.String poolName,
                                  long deletedTo)
                                    throws CmsDataAccessException

Unsubscribes all deleted resources that were deleted before the specified time stamp.

参数:

dbc - the database context

poolName - the name of the database pool to use

deletedTo - the time stamp to which the resources have been deleted

抛出:

CmsDataAccessException - if something goes wrong

unsubscribeAllResourcesFor

void unsubscribeAllResourcesFor(CmsDbContext dbc,
                              java.lang.String poolName,
                              CmsPrincipal principal)
                                throws CmsDataAccessException

Unsubscribes the principal from all resources.

参数:

dbc - the database context

poolName - the name of the database pool to use

principal - the principal that unsubscribes from all resources

抛出:

CmsDataAccessException - if something goes wrong

unsubscribeResourceFor

void unsubscribeResourceFor(CmsDbContext dbc,
                          java.lang.String poolName,
                          CmsPrincipal principal,
                          CmsResource resource)
                            throws CmsDataAccessException

Unsubscribes the principal from the resource.

参数:

dbc - the database context

poolName - the name of the database pool to use

principal - the principal that unsubscribes from the resource

resource - the resource to unsubscribe from

抛出:

CmsDataAccessException - if something goes wrong

unsubscribeResourceForAll

void unsubscribeResourceForAll(CmsDbContext dbc,
                             java.lang.String poolName,
                             CmsResource resource)
                               throws CmsDataAccessException

Unsubscribes all groups and users from the resource.

参数:

dbc - the database context

poolName - the name of the database pool to use

resource - the resource to unsubscribe all groups and users from

抛出:

CmsDataAccessException - if something goes wrong