CmsResourceFilter

java.lang.Object
- org.opencms.file.CmsResourceFilter

```
public final class CmsResourceFilter
extends java.lang.Object
```
Provides filters for resource result sets obtained from requests to the OpenCms VFS.
Using the constant filters provided by this class you can control "special" behaviour of access to the VFS. For example, in the "Offline" project there can be deleted files, by using this filter you can control if deleted files should be included in a result set or not.

从以下版本开始:

6.0.0

字段概要

字段
限定符和类型	字段和说明
`static CmsResourceFilter`	`ALL` Filter to display all resources.
`static CmsResourceFilter`	`ALL_MODIFIED` Filter to display all modified (new/changed/deleted) resources.
`static CmsResourceFilter`	`DEFAULT` Default filter to display resources for the online project.
`static CmsResourceFilter`	`DEFAULT_FILES` Default filter to display files for the online project.
`static CmsResourceFilter`	`DEFAULT_FOLDERS` Default filter to display folders for the online project.
`static CmsResourceFilter`	`DEFAULT_ONLY_VISIBLE` Default filter to display resources for the online project.
`static CmsResourceFilter`	`IGNORE_EXPIRATION` Filter to display resources ignoring the release and expiration dates.
`static CmsResourceFilter`	`ONLY_VISIBLE` Filter to display only visible resources.
`static CmsResourceFilter`	`ONLY_VISIBLE_NO_DELETED` Filter to display only visible and not deleted resources.

方法概要

方法
限定符和类型	方法和说明
`CmsResourceFilter`	`addExcludeFlags(int flags)` Returns an extended filter in order to avoid the given flags in the filtered resources.
`CmsResourceFilter`	`addExcludeState(CmsResourceState state)` Returns an extended filter in order to avoid the given type in the filtered resources.
`CmsResourceFilter`	`addExcludeTimerange()` Returns an extended filter to guarantee all filtered resources ignoring the time range (released and not expired) window.
`CmsResourceFilter`	`addExcludeType(int type)` Returns an extended filter in order to avoid the given type in the filtered resources.
`CmsResourceFilter`	`addRequireExpireAfter(long time)` Returns an extended filter to restrict the results to resources that expire in the given timerange.
`CmsResourceFilter`	`addRequireExpireBefore(long time)` Returns an extended filter to restrict the results to resources that expire in the given timerange.
`CmsResourceFilter`	`addRequireFile()` Returns an extended filter that requires all returned resources to be files.
`CmsResourceFilter`	`addRequireFlags(int flags)` Returns an extended filter to guarantee a distinct resource flags of the filtered resources.
`CmsResourceFilter`	`addRequireFolder()` Returns an extended filter that requires all returned resources to be folders.
`CmsResourceFilter`	`addRequireLastModifiedAfter(long time)` Returns an extended filter to restrict the results to resources modified in the given timerange.
`CmsResourceFilter`	`addRequireLastModifiedBefore(long time)` Returns an extended filter to restrict the results to resources modified in the given timerange.
`CmsResourceFilter`	`addRequireReleaseAfter(long time)` Returns an extended filter to restrict the results to resources that are released in the given timerange.
`CmsResourceFilter`	`addRequireReleaseBefore(long time)` Returns an extended filter to restrict the results to resources that are released in the given timerange.
`CmsResourceFilter`	`addRequireState(CmsResourceState state)` Returns an extended filter to guarantee a distinct resource state of the filtered resources.
`CmsResourceFilter`	`addRequireTimerange()` Returns an extended filter to guarantee all filtered resources are valid (released and not expired).
`CmsResourceFilter`	`addRequireType(int type)` Returns an extended filter to guarantee a distinct resource type of the filtered resources.
`CmsResourceFilter`	`addRequireVisible()` Returns an extended filter to guarantee all filtered resources are visible.
`java.lang.Object`	`clone()`
`boolean`	`excludeFlags()` return if the stored flags should be excluded while filtering resources.
`boolean`	`excludeState()` return if the stored state should be excluded while filtering resources.
`boolean`	`excludeType()` Returns if the stored type should be excluded while filtering resources.
`java.lang.String`	`getCacheId()` Returns the unique cache id for this filter.
`long`	`getExpireAfter()` Returns the start of the expire time range for this filter.
`long`	`getExpireBefore()` Returns the end of the expire time range for this filter.
`int`	`getFlags()` Returns the flags for this filter.
`long`	`getModifiedAfter()` Returns the start of the modification time range for this filter.
`long`	`getModifiedBefore()` Returns the end of the modification time range for this filter.
`java.lang.Boolean`	`getOnlyFolders()` Returns the state of the "only folders" flag.
`long`	`getReleaseAfter()` Returns the start of the release time range for this filter.
`long`	`getReleaseBefore()` Returns the end of the release time range for this filter.
`CmsResourceState`	`getState()` Returns the state for this filter.
`int`	`getType()` Returns the type for this filter.
`boolean`	`includeDeleted()` Check if deleted resources should be filtered.
`boolean`	`isValid(CmsRequestContext context, CmsResource resource)` Validates if a CmsResource fits to all filer settings.
`boolean`	`requireFlags()` Returns if the stored flags is required while filtering resources.
`boolean`	`requireState()` Returns if the stored state is required while filtering resources.
`boolean`	`requireTimerange()` Returns if the release timerange of the resource should be required.
`boolean`	`requireType()` Returns if the stored type is required while filtering resources.
`static CmsResourceFilter`	`requireType(int type)` Returns a new CmsResourceFilter requiring the given type.
`boolean`	`requireVisible()` Returns if the visible permission should be required for resources.
`java.lang.String`	`toString()` Returns the name of the filter, if it is one of the filters used as a constant of this class and a default message otherwise.

从类继承的方法 java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - ALL
```
public static final CmsResourceFilter ALL
```
    Filter to display all resources.
    This filter uses the following rules:
    - Includes: Resources marked as deleted.
    - Includes: Resources outside the 'time window' set with release and expiration date.
    - Includes: Resources marked as 'invisible' using permissions.
  - ALL_MODIFIED
```
public static final CmsResourceFilter ALL_MODIFIED
```
    Filter to display all modified (new/changed/deleted) resources.
  - DEFAULT
```
public static final CmsResourceFilter DEFAULT
```
    Default filter to display resources for the online project.
    This filter uses the following rules:
    - Excludes: Resources marked as deleted.
    - Excludes: Resources outside the 'time window' set with release and expiration date.
    - Includes: Resources marked as 'invisible' using permissions.
  - DEFAULT_FILES
```
public static final CmsResourceFilter DEFAULT_FILES
```
    Default filter to display files for the online project.
  - DEFAULT_FOLDERS
```
public static final CmsResourceFilter DEFAULT_FOLDERS
```
    Default filter to display folders for the online project.
  - DEFAULT_ONLY_VISIBLE
```
public static final CmsResourceFilter DEFAULT_ONLY_VISIBLE
```
    Default filter to display resources for the online project.
    This filter uses the following rules:
    - Excludes: Resources marked as deleted.
    - Excludes: Resources outside the 'time window' set with release and expiration date.
    - Excludes: Resources marked as 'invisible' using permissions.
  - IGNORE_EXPIRATION
```
public static final CmsResourceFilter IGNORE_EXPIRATION
```
    Filter to display resources ignoring the release and expiration dates.
    This filter uses the following rules:
    - Excludes: Resources marked as deleted.
    - Includes: Resources outside the 'time window' set with release and expiration date.
    - Includes: Resources marked as 'invisible' using permissions.
  - ONLY_VISIBLE
```
public static final CmsResourceFilter ONLY_VISIBLE
```
    Filter to display only visible resources.
    This filter used the following rules:
    - Includes: Resources marked as deleted.
    - Includes: Resources outside the 'time window' set with release and expiration date.
    - Excludes: Resources marked as 'invisible' using permissions.
  - ONLY_VISIBLE_NO_DELETED
```
public static final CmsResourceFilter ONLY_VISIBLE_NO_DELETED
```
    Filter to display only visible and not deleted resources.
    This filter used the following rules:
    - Excludes: Resources marked as deleted.
    - Includes: Resources outside the 'time window' set with release and expiration date.
    - Excludes: Resources marked as 'invisible' using permissions.
- 方法详细资料
  - requireType
```
public static CmsResourceFilter requireType(int type)
```
    Returns a new CmsResourceFilter requiring the given type.
    
    参数:
    type - the required resource type
    
    返回:
    a filter requiring the given type
  - addExcludeFlags
```
public CmsResourceFilter addExcludeFlags(int flags)
```
    Returns an extended filter in order to avoid the given flags in the filtered resources.
    
    参数:
    flags - the resource flags to exclude
    
    返回:
    a filter excluding the given resource flags
  - addExcludeState
```
public CmsResourceFilter addExcludeState(CmsResourceState state)
```
    Returns an extended filter in order to avoid the given type in the filtered resources.
    
    参数:
    state - the resource state to exclude
    
    返回:
    a filter excluding the given resource state
  - addExcludeTimerange
```
public CmsResourceFilter addExcludeTimerange()
```
    Returns an extended filter to guarantee all filtered resources ignoring the time range (released and not expired) window.
    This is the reverse of addRequireTimerange().
    
    返回:
    a filter excluding invalid resources
  - addExcludeType
```
public CmsResourceFilter addExcludeType(int type)
```
    Returns an extended filter in order to avoid the given type in the filtered resources.
    
    参数:
    type - the resource type to exclude
    
    返回:
    a filter excluding the given resource type
  - addRequireExpireAfter
```
public CmsResourceFilter addRequireExpireAfter(long time)
```
    Returns an extended filter to restrict the results to resources that expire in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources that expire in the given timerange
  - addRequireExpireBefore
```
public CmsResourceFilter addRequireExpireBefore(long time)
```
    Returns an extended filter to restrict the results to resources that expire in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources that expire in the given timerange
  - addRequireFile
```
public CmsResourceFilter addRequireFile()
```
    Returns an extended filter that requires all returned resources to be files.
    
    返回:
    an extended filter that requires all returned resources to be files
  - addRequireFlags
```
public CmsResourceFilter addRequireFlags(int flags)
```
    Returns an extended filter to guarantee a distinct resource flags of the filtered resources.
    
    参数:
    flags - the required resource flags
    
    返回:
    a filter requiring the given resource flags
  - addRequireFolder
```
public CmsResourceFilter addRequireFolder()
```
    Returns an extended filter that requires all returned resources to be folders.
    
    返回:
    an extended filter that requires all returned resources to be folders
  - addRequireLastModifiedAfter
```
public CmsResourceFilter addRequireLastModifiedAfter(long time)
```
    Returns an extended filter to restrict the results to resources modified in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources modified in the given timerange
  - addRequireLastModifiedBefore
```
public CmsResourceFilter addRequireLastModifiedBefore(long time)
```
    Returns an extended filter to restrict the results to resources modified in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources modified in the given timerange
  - addRequireReleaseAfter
```
public CmsResourceFilter addRequireReleaseAfter(long time)
```
    Returns an extended filter to restrict the results to resources that are released in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources that are released in the given timerange
  - addRequireReleaseBefore
```
public CmsResourceFilter addRequireReleaseBefore(long time)
```
    Returns an extended filter to restrict the results to resources that are released in the given timerange.
    
    参数:
    time - the required time
    
    返回:
    a filter to restrict the results to resources that are released in the given timerange
  - addRequireState
```
public CmsResourceFilter addRequireState(CmsResourceState state)
```
    Returns an extended filter to guarantee a distinct resource state of the filtered resources.
    
    参数:
    state - the required resource state
    
    返回:
    a filter requiring the given resource state
  - addRequireTimerange
```
public CmsResourceFilter addRequireTimerange()
```
    Returns an extended filter to guarantee all filtered resources are valid (released and not expired).
    
    返回:
    a filter excluding invalid resources
  - addRequireType
```
public CmsResourceFilter addRequireType(int type)
```
    Returns an extended filter to guarantee a distinct resource type of the filtered resources.
    If -1 is given as type, the filter will not be extended to require a resource type
    
    参数:
    type - the required resource type
    
    返回:
    a filter requiring the given resource type
  - addRequireVisible
```
public CmsResourceFilter addRequireVisible()
```
    Returns an extended filter to guarantee all filtered resources are visible.
    
    返回:
    a filter excluding invisible resources
  - clone
```
public java.lang.Object clone()
```
    覆盖:
    
    clone 在类中 java.lang.Object
    
    另请参阅:
    Object.clone()
  - excludeFlags
```
public boolean excludeFlags()
```
    return if the stored flags should be excluded while filtering resources.
    
    返回:
    if the flags should be excluded
  - excludeState
```
public boolean excludeState()
```
    return if the stored state should be excluded while filtering resources.
    
    返回:
    if the state should be excluded
  - excludeType
```
public boolean excludeType()
```
    Returns if the stored type should be excluded while filtering resources.
    
    返回:
    if the type should be excluded
  - getCacheId
```
public java.lang.String getCacheId()
```
    Returns the unique cache id for this filter.
    
    返回:
    the unique cache id for this filter
  - getExpireAfter
```
public long getExpireAfter()
```
    Returns the start of the expire time range for this filter.
    
    返回:
    start of the expire time range for this filter
  - getExpireBefore
```
public long getExpireBefore()
```
    Returns the end of the expire time range for this filter.
    
    返回:
    the end of the expire time range for this filter
  - getFlags
```
public int getFlags()
```
    Returns the flags for this filter.
    
    返回:
    the flags for this filter
  - getModifiedAfter
```
public long getModifiedAfter()
```
    Returns the start of the modification time range for this filter.
    
    返回:
    start of the modification time range for this filter
  - getModifiedBefore
```
public long getModifiedBefore()
```
    Returns the end of the modification time range for this filter.
    
    返回:
    the end of the modification time range for this filter
  - getOnlyFolders
```
public java.lang.Boolean getOnlyFolders()
```
    Returns the state of the "only folders" flag.
    If the result is null, then this flag is not set.
    
    返回:
    the state of the "only folders" flag
  - getReleaseAfter
```
public long getReleaseAfter()
```
    Returns the start of the release time range for this filter.
    
    返回:
    start of the release time range for this filter
  - getReleaseBefore
```
public long getReleaseBefore()
```
    Returns the end of the release time range for this filter.
    
    返回:
    the end of the release time range for this filter
  - getState
```
public CmsResourceState getState()
```
    Returns the state for this filter.
    
    返回:
    the state for this filter
  - getType
```
public int getType()
```
    Returns the type for this filter.
    
    返回:
    the type for this filter
  - includeDeleted
```
public boolean includeDeleted()
```
    Check if deleted resources should be filtered.
    
    返回:
    true if deleted resources should be included, false otherwise
  - isValid
```
public boolean isValid(CmsRequestContext context,
              CmsResource resource)
```
    Validates if a CmsResource fits to all filer settings.
    Please note that the "visible permission" setting of the filter is NOT checked in this method since the permission information is not part of the resource. The visible permission information in the filter will be used in the permission checks
    
    参数:
    context - the current request context
    resource - the resource to be validated
    
    返回:
    true if the resource passes all validations, false otherwise
  - requireFlags
```
public boolean requireFlags()
```
    Returns if the stored flags is required while filtering resources.
    
    返回:
    if the flags is required
  - requireState
```
public boolean requireState()
```
    Returns if the stored state is required while filtering resources.
    
    返回:
    if the state is required
  - requireTimerange
```
public boolean requireTimerange()
```
    Returns if the release timerange of the resource should be required.
    
    返回:
    true if the release timerange of the resource should be required
  - requireType
```
public boolean requireType()
```
    Returns if the stored type is required while filtering resources.
    
    返回:
    true if the type is required
  - requireVisible
```
public boolean requireVisible()
```
    Returns if the visible permission should be required for resources.
    
    返回:
    true if the visible permission is required, false if the visible permission is ignored
  - toString
```
public java.lang.String toString()
```
    Returns the name of the filter, if it is one of the filters used as a constant of this class and a default message otherwise.
    
    覆盖:
    
    toString 在类中 java.lang.Object
    
    返回:
    the name of the filter

类 CmsResourceFilter

字段概要

方法概要

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

字段详细资料

ALL

ALL_MODIFIED

DEFAULT

DEFAULT_FILES

DEFAULT_FOLDERS

DEFAULT_ONLY_VISIBLE

IGNORE_EXPIRATION

ONLY_VISIBLE

ONLY_VISIBLE_NO_DELETED

方法详细资料

requireType

addExcludeFlags

addExcludeState

addExcludeTimerange

addExcludeType

addRequireExpireAfter

addRequireExpireBefore

addRequireFile

addRequireFlags

addRequireFolder

addRequireLastModifiedAfter

addRequireLastModifiedBefore

addRequireReleaseAfter

addRequireReleaseBefore

addRequireState

addRequireTimerange

addRequireType

addRequireVisible

clone

excludeFlags

excludeState

excludeType

getCacheId

getExpireAfter

getExpireBefore

getFlags

getModifiedAfter

getModifiedBefore

getOnlyFolders

getReleaseAfter

getReleaseBefore

getState

getType

includeDeleted

isValid

requireFlags

requireState

requireTimerange

requireType

requireVisible

toString