org.opencms.file.collectors

类 CmsChangedResourceCollector

java.lang.Object

org.opencms.file.collectors.A_CmsResourceCollector

org.opencms.file.collectors.CmsChangedResourceCollector

所有已实现的接口:

java.lang.Comparable<I_CmsResourceCollector>, I_CmsResourceCollector

public class CmsChangedResourceCollector
extends A_CmsResourceCollector

A resource collector that collects resources changed in a given time frame and supports flexible sorting based on resource dates.

从以下版本开始:

8.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	PARAM_KEY_COUNT The collector parameter key for the maximum number of resources to return.
static java.lang.String	PARAM_KEY_DATEFROM The collector parameter key for the date from which a resource should be changed.
static java.lang.String	PARAM_KEY_DATETO The collector parameter key for the date to which a resource should be changed.
static java.lang.String	PARAM_KEY_EXCLUDETYPE The collector parameter key for the name of the resource type to exclude from the result.
static java.lang.String	PARAM_KEY_RESOURCE The collector parameter key for the resource, i.e. the parent folder from which the subscribed or visited resources should be read from.
static java.lang.String	PARAM_KEY_SORTBY The collector parameter key for the sort attribute that should be used to sort the result.

从类继承的字段 org.opencms.file.collectors.A_CmsResourceCollector

m_order, SEPARATOR_TEMPLATEFILE

构造器概要

构造器

构造器和说明
CmsChangedResourceCollector()

方法概要

方法

限定符和类型	方法和说明
protected java.util.List<CmsResource>	allChangedInFolderDate(CmsObject cms, java.lang.String param, boolean tree, boolean asc) Returns a List of all changed resources in the folder pointed to by the parameter sorted by the date attributes specified in the parameter.
java.util.List<java.lang.String>	getCollectorNames() Returns a list of all collector names (Strings) this collector implementation supports.
java.lang.String	getCreateLink(CmsObject cms, java.lang.String collectorName, java.lang.String param) Returns the link that must be executed when a user clicks on the direct edit "new" button on a list created by the named collector.
java.lang.String	getCreateParam(CmsObject cms, java.lang.String collectorName, java.lang.String param) Returns the parameter that must be passed to the I_CmsResourceCollector.getCreateLink(CmsObject, String, String) method.
java.util.List<CmsResource>	getResults(CmsObject cms, java.lang.String collectorName, java.lang.String param) Returns a list of CmsResource Objects that are gathered in the VFS using the named collector.

从类继承的方法 org.opencms.file.collectors.A_CmsResourceCollector

checkParams, compareTo, createResourceForCollector, equals, getCreateInFolder, getCreateInFolder, getCreateLink, getCreateParam, getCreateTypeId, getDefaultCollectorName, getDefaultCollectorParam, getOrder, getResults, hashCode, setDefaultCollectorName, setDefaultCollectorParam, setOrder, shrinkToFit

从类继承的方法 java.lang.Object

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

字段详细资料

PARAM_KEY_COUNT

public static final java.lang.String PARAM_KEY_COUNT

The collector parameter key for the maximum number of resources to return.

另请参阅:

常量字段值

PARAM_KEY_DATEFROM

public static final java.lang.String PARAM_KEY_DATEFROM

The collector parameter key for the date from which a resource should be changed.

另请参阅:

常量字段值

PARAM_KEY_DATETO

public static final java.lang.String PARAM_KEY_DATETO

The collector parameter key for the date to which a resource should be changed.

另请参阅:

常量字段值

PARAM_KEY_EXCLUDETYPE

public static final java.lang.String PARAM_KEY_EXCLUDETYPE

The collector parameter key for the name of the resource type to exclude from the result.

另请参阅:

常量字段值

PARAM_KEY_RESOURCE

public static final java.lang.String PARAM_KEY_RESOURCE

The collector parameter key for the resource, i.e. the parent folder from which the subscribed or visited resources should be read from.

另请参阅:

常量字段值

PARAM_KEY_SORTBY

public static final java.lang.String PARAM_KEY_SORTBY

The collector parameter key for the sort attribute that should be used to sort the result.

另请参阅:

常量字段值

构造器详细资料

CmsChangedResourceCollector

public CmsChangedResourceCollector()

方法详细资料

getCollectorNames

public java.util.List<java.lang.String> getCollectorNames()

从接口复制的说明: I_CmsResourceCollector

Returns a list of all collector names (Strings) this collector implementation supports.

返回:

a list of all collector names this collector implementation supports

另请参阅:

I_CmsResourceCollector.getCollectorNames()

getCreateLink

public java.lang.String getCreateLink(CmsObject cms,
                             java.lang.String collectorName,
                             java.lang.String param)

从接口复制的说明: I_CmsResourceCollector

Returns the link that must be executed when a user clicks on the direct edit "new" button on a list created by the named collector.

If this method returns null, it indicated that the selected collector implementation does not support a "create link", and so no "new" button will should shown on lists generated with this collector.

参数:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter

返回:

the link to execute after a "new" button was clicked

另请参阅:

I_CmsResourceCollector.getCreateLink(org.opencms.file.CmsObject, java.lang.String, java.lang.String)

getCreateParam

public java.lang.String getCreateParam(CmsObject cms,
                              java.lang.String collectorName,
                              java.lang.String param)

从接口复制的说明: I_CmsResourceCollector

Returns the parameter that must be passed to the I_CmsResourceCollector.getCreateLink(CmsObject, String, String) method.

If this method returns null, it indicates that the selected collector implementation does not support a "create link", and so no "new" button will should shown on lists generated with this collector.

参数:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter from the current page context

返回:

the parameter that will be passed to the I_CmsResourceCollector.getCreateLink(CmsObject, String, String) method, or null

另请参阅:

I_CmsResourceCollector.getCreateParam(org.opencms.file.CmsObject, java.lang.String, java.lang.String)

getResults

public java.util.List<CmsResource> getResults(CmsObject cms,
                                     java.lang.String collectorName,
                                     java.lang.String param)
                                       throws CmsDataAccessException,
                                              CmsException

从接口复制的说明: I_CmsResourceCollector

Returns a list of CmsResource Objects that are gathered in the VFS using the named collector.

参数:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter

返回:

a list of CmsXmlContent objects

抛出:

CmsDataAccessException - if the parameter attribute of the corresponding collector tag is invalid

CmsException - if something goes wrong

另请参阅:

I_CmsResourceCollector.getResults(org.opencms.file.CmsObject, java.lang.String, java.lang.String)

allChangedInFolderDate

protected java.util.List<CmsResource> allChangedInFolderDate(CmsObject cms,
                                                 java.lang.String param,
                                                 boolean tree,
                                                 boolean asc)
                                                      throws CmsException

Returns a List of all changed resources in the folder pointed to by the parameter sorted by the date attributes specified in the parameter.

参数:

cms - the current CmsObject

param - must contain an extended collector parameter set as described by CmsExtendedCollectorData

tree - if true, look in folder and all child folders, if false, look only in given folder

asc - if true, the sort is ascending (old dates first), otherwise it is descending (new dates first)

返回:

a List of all resources in the folder pointed to by the parameter sorted by the selected dates

抛出:

CmsException - if something goes wrong