org.opencms.file.collectors
Class CmsPriorityResourceCollector

java.lang.Object
  org.opencms.file.collectors.A_CmsResourceCollector
      org.opencms.file.collectors.CmsPriorityResourceCollector

All Implemented Interfaces:

Comparable, I_CmsResourceCollector

public class CmsPriorityResourceCollector

extends A_CmsResourceCollector

A collector to fetch sorted XML contents in a folder or subtree based on their priority and date or title values.

The date or title information has to be stored as property for each resource.

Since:

6.0.0

Version:

$Revision: 1.13 $

Author:

Andreas Zahner

Field Summary

static int	PRIORITY_STANDARD The standard priority value if no value was set on resource.
static String	PROPERTY_PRIORITY The name of the priority property to read.

Fields inherited from class org.opencms.file.collectors.A_CmsResourceCollector

m_order

Constructor Summary

CmsPriorityResourceCollector()

Method Summary

protected List	allInFolderPriorityDate(CmsObject cms, String param, boolean tree, boolean asc) Returns a list of all resource in a specified folder sorted by priority, then date ascending or descending.
protected List	allInFolderPriorityTitle(CmsObject cms, String param, boolean tree) Returns a list of all resource in a specified folder sorted by priority descending, then Title ascending.
List	getCollectorNames() Returns a list of all collector names (Strings) this collector implementation supports.
String	getCreateLink(CmsObject cms, String collectorName, 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.
String	getCreateParam(CmsObject cms, String collectorName, String param) Returns the parameter that must be passed to the getCreateLink(CmsObject, String, String) method.
List	getResults(CmsObject cms, String collectorName, String param) Returns a list of CmsResource Objects that are gathered in the VFS using the named collector.

Methods inherited from class org.opencms.file.collectors.A_CmsResourceCollector

compareTo, equals, getCreateInFolder, getOrder, hashCode, setOrder, shrinkToFit

Methods inherited from class java.lang.Object

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

Field Detail

PRIORITY_STANDARD

public static final int PRIORITY_STANDARD

The standard priority value if no value was set on resource.

See Also:

Constant Field Values

PROPERTY_PRIORITY

public static final String PROPERTY_PRIORITY

The name of the priority property to read.

See Also:

Constant Field Values

Constructor Detail

CmsPriorityResourceCollector

public CmsPriorityResourceCollector()

Method Detail

getCollectorNames

public List getCollectorNames()

Description copied from interface: I_CmsResourceCollector

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

Returns:

a list of all collector names this collector implementation supports

See Also:

I_CmsResourceCollector.getCollectorNames()

getCreateLink

public String getCreateLink(CmsObject cms,
                            String collectorName,
                            String param)
                     throws CmsException

Description copied from interface: 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.

Parameters:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter

Returns:

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

Throws:

CmsException - if something goes wrong

See Also:

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

getCreateParam

public String getCreateParam(CmsObject cms,
                             String collectorName,
                             String param)
                      throws CmsDataAccessException

Description copied from interface: 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.

Parameters:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter from the current page context

Returns:

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

Throws:

CmsDataAccessException - if the param attrib of the corresponding collector tag is invalid

See Also:

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

getResults

public List getResults(CmsObject cms,
                       String collectorName,
                       String param)
                throws CmsException,
                       CmsDataAccessException

Description copied from interface: I_CmsResourceCollector

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

Parameters:

cms - the current CmsObject

collectorName - the name of the collector to use

param - an optional collector parameter

Returns:

a list of CmsXmlContent objects

Throws:

CmsDataAccessException - if the param attrib of the corresponding collector tag is invalid

CmsException - if something goes wrong

See Also:

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

allInFolderPriorityDate

protected List allInFolderPriorityDate(CmsObject cms,
                                       String param,
                                       boolean tree,
                                       boolean asc)
                                throws CmsException

Returns a list of all resource in a specified folder sorted by priority, then date ascending or descending.

Parameters:

cms - the current OpenCms user context

param - the folder name to use

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

asc - if true, the date sort order is ascending, otherwise descending

Returns:

all resources in the folder matching the given criteria

Throws:

CmsException - if something goes wrong

allInFolderPriorityTitle

protected List allInFolderPriorityTitle(CmsObject cms,
                                        String param,
                                        boolean tree)
                                 throws CmsException

Returns a list of all resource in a specified folder sorted by priority descending, then Title ascending.

Parameters:

cms - the current OpenCms user context

param - the folder name to use

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

Returns:

all resources in the folder matching the given criteria

Throws:

CmsException - if something goes wrong