Package org.opencms.file
Interface I_CmsResource
- All Known Subinterfaces:
I_CmsHistoryResource
- All Known Implementing Classes:
CmsFile
,CmsFolder
,CmsHistoryFile
,CmsHistoryFolder
,CmsJspResourceWrapper
,CmsResource
,CmsSearchResource
public interface I_CmsResource
Common ancestor interface for
CmsFile
and CmsFolder
as well as for CmsHistoryFile
and CmsHistoryFolder
.- Since:
- 8.0.0
-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic enum
Enumeration for all attributes of a resource. -
Field Summary
Modifier and TypeFieldDescriptionstatic final Comparator<I_CmsResource>
A comparator for the date last modified of two resources.static final Comparator<I_CmsResource>
A comparator for the release date of two resources.static final Comparator<I_CmsResource>
A comparator for the root path of two resources.static final Comparator<I_CmsResource>
A comparator for the root path of two resources ignoring case differences.static final Comparator<I_CmsResource>
A comparator for the root path of two resources ignoring case differences, putting folders before files. -
Method Summary
Modifier and TypeMethodDescriptionlong
Returns the date of the last modification of the content of this resource.long
Returns the date of the creation of this resource.long
Returns the expiration date this resource.long
Returns the date of the last modification of this resource.long
Returns the release date this resource.int
getFlags()
Returns the flags of this resource.int
Returns the content length of this resource.getName()
Returns the file name of this resource without parent folders, for exampleindex.html
.Returns the id of theCmsProject
where this resource has been last modified.Returns the id of the database content record of this resource.Returns the name of this resource with it's full path from the top level root folder, for example/sites/default/myfolder/index.html
.int
Returns the number of siblings of this resource, also counting this resource.getState()
Returns the state of this resource.Returns the id of the database structure record of this resource.int
Returns the resource type id for this resource.Returns the id of theCmsUser
who created this resource.Returns the id of theCmsUser
who made the last modification on this resource.int
Returns the current version number of this resource.boolean
isExpired
(long time) Returnstrue
if this resource is expired at the given time according to the information stored ingetDateExpired()
.boolean
isFile()
Returnstrue
if the resource is a file, i.e.boolean
isFolder()
Returnstrue
if the resource is a folder, i.e.boolean
Checks if the resource is internal.boolean
Checks if the link has to be labeled with a special icon in the explorer view.boolean
isReleased
(long time) Returnstrue
if this resource is released at the given time according to the information stored ingetDateReleased()
.boolean
isReleasedAndNotExpired
(long time) Returnstrue
if this resource is valid at the given time according to the information stored ingetDateReleased()
andgetDateExpired()
.boolean
Returns true if this resource was touched.
-
Field Details
-
COMPARE_DATE_LAST_MODIFIED
A comparator for the date last modified of two resources. -
COMPARE_DATE_RELEASED
A comparator for the release date of two resources.If the release date of a resource is not set, the creation date is used instead.
-
COMPARE_ROOT_PATH
A comparator for the root path of two resources. -
COMPARE_ROOT_PATH_IGNORE_CASE
A comparator for the root path of two resources ignoring case differences. -
COMPARE_ROOT_PATH_IGNORE_CASE_FOLDERS_FIRST
A comparator for the root path of two resources ignoring case differences, putting folders before files.
-
-
Method Details
-
getDateContent
long getDateContent()Returns the date of the last modification of the content of this resource.- Returns:
- the date of the last modification of the content of this resource
-
getDateCreated
long getDateCreated()Returns the date of the creation of this resource.- Returns:
- the date of the creation of this resource
-
getDateExpired
long getDateExpired()Returns the expiration date this resource.- Returns:
- the expiration date of this resource
-
getDateLastModified
long getDateLastModified()Returns the date of the last modification of this resource.- Returns:
- the date of the last modification of this resource
-
getDateReleased
long getDateReleased()Returns the release date this resource.- Returns:
- the release date of this resource
-
getFlags
int getFlags()Returns the flags of this resource.- Returns:
- the flags of this resource
-
getLength
int getLength()Returns the content length of this resource.If the resource is a file, then this is the byte size of the file content. If the resource is a folder, then the size is always -1.
- Returns:
- the content length of this resource
-
getName
Returns the file name of this resource without parent folders, for exampleindex.html
.- Returns:
- the file name of this resource without parent folders
-
getProjectLastModified
Returns the id of theCmsProject
where this resource has been last modified.- Returns:
- the id of the
CmsProject
where this resource has been last modified, ornull
-
getResourceId
Returns the id of the database content record of this resource.- Returns:
- the id of the database content record of this resource
-
getRootPath
Returns the name of this resource with it's full path from the top level root folder, for example/sites/default/myfolder/index.html
.- Returns:
- name of this resource with it's full path from the top level root folder
-
getSiblingCount
int getSiblingCount()Returns the number of siblings of this resource, also counting this resource.If a resource has no sibling, the total sibling count for this resource is
1
, if a resource hasn
siblings, the sibling count isn + 1
.- Returns:
- the number of siblings of this resource, also counting this resource
-
getState
Returns the state of this resource.- Returns:
- the state of this resource
-
getStructureId
Returns the id of the database structure record of this resource.- Returns:
- the id of the database structure record of this resource
-
getTypeId
int getTypeId()Returns the resource type id for this resource.- Returns:
- the resource type id of this resource
-
getUserCreated
Returns the id of theCmsUser
who created this resource.- Returns:
- the id of the
CmsUser
who created this resource
-
getUserLastModified
Returns the id of theCmsUser
who made the last modification on this resource.- Returns:
- the id of the
CmsUser
who made the last modification on this resource
-
getVersion
int getVersion()Returns the current version number of this resource.- Returns:
- the current version number of this resource
-
isExpired
Returnstrue
if this resource is expired at the given time according to the information stored ingetDateExpired()
.- Parameters:
time
- the time to check the expiration date against- Returns:
true
if this resource is expired at the given time- See Also:
-
isFile
boolean isFile()Returnstrue
if the resource is a file, i.e. can have no sub-resources.- Returns:
- true if this resource is a file, false otherwise
-
isFolder
boolean isFolder()Returnstrue
if the resource is a folder, i.e. can have sub-resources.- Returns:
- true if this resource is a folder, false otherwise
-
isInternal
boolean isInternal()Checks if the resource is internal.This state is stored as bit 1 in the resource flags.
- Returns:
- true if the resource is internal, otherwise false
-
isLabeled
boolean isLabeled()Checks if the link has to be labeled with a special icon in the explorer view.This state is stored as bit 2 in the resource flags.
- Returns:
- true if a link to the resource has to be labeled, otherwise false
-
isReleased
Returnstrue
if this resource is released at the given time according to the information stored ingetDateReleased()
.- Parameters:
time
- the time to check the release date against- Returns:
true
if this resource is released at the given time- See Also:
-
isReleasedAndNotExpired
Returnstrue
if this resource is valid at the given time according to the information stored ingetDateReleased()
andgetDateExpired()
.A resource is valid if it is released and not yet expired.
- Parameters:
time
- the time to check the release and expiration date against- Returns:
true
if this resource is valid at the given time- See Also:
-
isTouched
boolean isTouched()Returns true if this resource was touched.- Returns:
- boolean true if this resource was touched
-