|
||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.opencms.file.CmsResource
public class CmsResource
Base class for all OpenCms VFS resources like
or CmsFile
.CmsFolder
The OpenCms VFS resource is an important object for using the OpenCms API. Basically, all entries in the OpenCms VFS are considered to be "resources". Currently, only two types of resources exists:
CmsFile
.
CmsFolder
.
isFile()
or isFolder()
to learn what kind of
subclass you have. Please note that this is usually not required, as the only real difference between a
CmsFile
and a CmsResource
is that the CmsFile
also has the contents of the file,
which you can obtain using CmsFile.getContents()
. As long as you don't need the content, you can
use the CmsResource
for everything else. This is even more true for a CmsFolder
, here you
will need the subclass only in special cases, since the signature is identical to CmsResource
.
A OpenCms VFS resource can have any number of properties attached, which are represented by a CmsProperty
.
To read the properties for a resource, use CmsObject.readPropertyObject(CmsResource, String, boolean)
or use CmsObject.readPropertyObjects(CmsResource, boolean)
to read all properties of the resource.
Nested Class Summary | |
---|---|
static class |
CmsResource.CmsResourceCopyMode
Enumeration class for resource copy modes. |
static class |
CmsResource.CmsResourceDeleteMode
Enumeration class for resource delete modes. |
static class |
CmsResource.CmsResourceUndoMode
Enumeration class for resource undo changes modes. |
Field Summary | |
---|---|
static java.util.Comparator |
COMPARE_DATE_RELEASED
A comparator for the release date of two resources. |
static java.util.Comparator |
COMPARE_ROOT_PATH
A comparator for the root path of two resources. |
static java.util.Comparator |
COMPARE_ROOT_PATH_IGNORE_CASE
A comparator for the root path of two resources ignoring case differences. |
static java.util.Comparator |
COMPARE_ROOT_PATH_IGNORE_CASE_FOLDERS_FIRST
A comparator for the root path of two resources ignoring case differences, putting folders before files. |
static CmsResource.CmsResourceCopyMode |
COPY_AS_NEW
Copy mode for copy resources as new resource. |
static CmsResource.CmsResourceCopyMode |
COPY_AS_SIBLING
Copy mode for copy resources as sibling. |
static CmsResource.CmsResourceCopyMode |
COPY_PRESERVE_SIBLING
Copy mode to preserve siblings during copy. |
static long |
DATE_EXPIRED_DEFAULT
The default expiration date of a resource, which is: never expires. |
static long |
DATE_RELEASED_DEFAULT
The default release date of a resource, which is: always released. |
static long |
DATE_RELEASED_EXPIRED_IGNORE
A special date that indicates release and expiration information are to be ignored. |
static CmsResource.CmsResourceDeleteMode |
DELETE_PRESERVE_SIBLINGS
Signals that siblings of this resource should not be deleted. |
static CmsResource.CmsResourceDeleteMode |
DELETE_REMOVE_SIBLINGS
Signals that siblings of this resource should be deleted. |
static int |
FLAG_INTERNAL
Flag to indicate that this is an internal resource, that can't be accessed directly. |
static int |
FLAG_LABELED
The resource is linked inside a site folder specified in the OpenCms configuration. |
static int |
FLAG_TEMPFILE
Flag to indicate that this is a temporary resource. |
protected long |
m_dateContent
The date of the last modification of the content of this resource. |
protected int |
m_length
The size of the content. |
static java.lang.String |
NAME_CONSTRAINTS
The name constraints when generating new resources. |
static CmsResourceState |
STATE_CHANGED
Indicates if a resource has been changed in the offline version when compared to the online version. |
static CmsResourceState |
STATE_DELETED
Indicates if a resource has been deleted in the offline version when compared to the online version. |
static CmsResourceState |
STATE_KEEP
Special state value that indicates the current state must be kept on a resource, this value must never be written to the database. |
static CmsResourceState |
STATE_NEW
Indicates if a resource is new in the offline version when compared to the online version. |
static CmsResourceState |
STATE_UNCHANGED
Indicates if a resource is unchanged in the offline version when compared to the online version. |
static long |
TOUCH_DATE_UNCHANGED
Flag for leaving a date unchanged during a touch operation. |
static CmsResource.CmsResourceUndoMode |
UNDO_CONTENT
Indicates that the undo method will only undo content changes. |
static CmsResource.CmsResourceUndoMode |
UNDO_CONTENT_RECURSIVE
Indicates that the undo method will only recursive undo content changes. |
static CmsResource.CmsResourceUndoMode |
UNDO_MOVE_CONTENT
Indicates that the undo method will undo move operations and content changes. |
static CmsResource.CmsResourceUndoMode |
UNDO_MOVE_CONTENT_RECURSIVE
Indicates that the undo method will undo move operations and recursive content changes. |
static java.lang.String |
VFS_FOLDER_SITES
The vfs path of the sites master folder. |
static java.lang.String |
VFS_FOLDER_SYSTEM
The vfs path of the system folder. |
Constructor Summary | |
---|---|
CmsResource(CmsUUID structureId,
CmsUUID resourceId,
java.lang.String rootPath,
int type,
boolean isFolder,
int flags,
CmsUUID projectId,
CmsResourceState state,
long dateCreated,
CmsUUID userCreated,
long dateLastModified,
CmsUUID userLastModified,
long dateReleased,
long dateExpired,
int linkCount,
int size,
long dateContent,
int version)
Creates a new CmsRecource object. |
Method Summary | |
---|---|
static void |
checkResourceName(java.lang.String name)
Checks if the provided resource name is a valid resource name, that is contains only valid characters. |
java.lang.Object |
clone()
Returns a clone of this Objects instance. |
int |
compareTo(java.lang.Object obj)
Uses the resource root path to compare two resources. |
boolean |
equals(java.lang.Object obj)
Two resources are considered equal in case their structure id is equal. |
long |
getDateContent()
Returns the date of the last modification of the content of this resource. |
long |
getDateCreated()
Returns the date of the creation of this resource. |
long |
getDateExpired()
Returns the expiration date this resource. |
long |
getDateLastModified()
Returns the date of the last modification of this resource. |
long |
getDateReleased()
Returns the release date this resource. |
int |
getFlags()
Returns the flags of this resource. |
static java.lang.String |
getFolderPath(java.lang.String resource)
Returns the folder path of the resource with the given name. |
int |
getLength()
Returns the length of the resource. |
java.lang.String |
getName()
Returns the name of this resource without parent folders, for example index.html . |
static java.lang.String |
getName(java.lang.String resource)
Returns the name of a resource without the path information. |
static java.lang.String |
getParentFolder(java.lang.String resource)
Returns the absolute parent folder name of a resource. |
static int |
getPathLevel(java.lang.String resource)
Returns the directory level of a resource. |
static java.lang.String |
getPathPart(java.lang.String resource,
int level)
Returns the name of a parent folder of the given resource, that is either minus levels up from the current folder, or that is plus levels down from the root folder. |
CmsUUID |
getProjectLastModified()
Returns the id of the project where the resource has been last modified. |
CmsUUID |
getResourceId()
Returns the id of the resource database entry of this resource. |
java.lang.String |
getRootPath()
Returns the name of a resource with it's full path from the root folder including the current site root, for example /sites/default/myfolder/index.html . |
int |
getSiblingCount()
Returns the number of siblings of this resource, also counting this resource. |
CmsResourceState |
getState()
Returns the change state of this resource. |
CmsUUID |
getStructureId()
Returns the id of the structure record of this resource. |
int |
getTypeId()
Returns the resource type id for this resource. |
CmsUUID |
getUserCreated()
Returns the user id of the CmsUser who created this resource. |
CmsUUID |
getUserLastModified()
Returns the user id of the CmsUser who made the last change on this resource. |
int |
getVersion()
Returns the version number of this resource. |
int |
hashCode()
|
boolean |
isExpired(long time)
Returns true if this resource is expired at the given time according to the
information stored in getDateExpired() . |
boolean |
isFile()
Returns true if the resource is a CmsFile , that is not a CmsFolder . |
boolean |
isFolder()
Returns true if the resource is a CmsFolder , that is not a CmsFile . |
static boolean |
isFolder(java.lang.String resource)
Returns true if the resource name certainly denotes a folder, that is ends with a "/". |
boolean |
isInternal()
Returns true if the resource is marked as internal. |
boolean |
isLabeled()
Returns true if the resource has to be labeled with a special icon in the explorer view. |
boolean |
isReleased(long time)
Returns true if this resource is released at the given time according to the
information stored in getDateReleased() . |
boolean |
isReleasedAndNotExpired(long time)
Returns true if this resource is valid at the given time according to the
information stored in getDateReleased() and getDateExpired() . |
boolean |
isTouched()
Returns true if this resource was touched. |
void |
setDateExpired(long time)
Sets the expiration date this resource. |
void |
setDateLastModified(long time)
Sets the date of the last modification of this resource. |
void |
setDateReleased(long time)
Sets the release date this resource. |
void |
setFlags(int flags)
Sets the flags of this resource. |
void |
setState(CmsResourceState state)
Sets the state of this resource. |
void |
setType(int type)
Sets the type of this resource. |
void |
setUserLastModified(CmsUUID resourceLastModifiedByUserId)
Sets the user id of the user who changed this resource. |
java.lang.String |
toString()
|
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final java.util.Comparator COMPARE_DATE_RELEASED
If the release date of a resource is not set, the creation date is used instead.
public static final java.util.Comparator COMPARE_ROOT_PATH
public static final java.util.Comparator COMPARE_ROOT_PATH_IGNORE_CASE
public static final java.util.Comparator COMPARE_ROOT_PATH_IGNORE_CASE_FOLDERS_FIRST
public static final CmsResource.CmsResourceCopyMode COPY_AS_NEW
public static final CmsResource.CmsResourceCopyMode COPY_AS_SIBLING
public static final CmsResource.CmsResourceCopyMode COPY_PRESERVE_SIBLING
public static final long DATE_EXPIRED_DEFAULT
public static final long DATE_RELEASED_DEFAULT
public static final long DATE_RELEASED_EXPIRED_IGNORE
public static final CmsResource.CmsResourceDeleteMode DELETE_PRESERVE_SIBLINGS
public static final CmsResource.CmsResourceDeleteMode DELETE_REMOVE_SIBLINGS
public static final int FLAG_INTERNAL
public static final int FLAG_LABELED
public static final int FLAG_TEMPFILE
public static final java.lang.String NAME_CONSTRAINTS
public static final CmsResourceState STATE_CHANGED
public static final CmsResourceState STATE_DELETED
public static final CmsResourceState STATE_KEEP
public static final CmsResourceState STATE_NEW
public static final CmsResourceState STATE_UNCHANGED
public static final long TOUCH_DATE_UNCHANGED
public static final CmsResource.CmsResourceUndoMode UNDO_CONTENT
public static final CmsResource.CmsResourceUndoMode UNDO_CONTENT_RECURSIVE
public static final CmsResource.CmsResourceUndoMode UNDO_MOVE_CONTENT
public static final CmsResource.CmsResourceUndoMode UNDO_MOVE_CONTENT_RECURSIVE
public static final java.lang.String VFS_FOLDER_SITES
public static final java.lang.String VFS_FOLDER_SYSTEM
protected long m_dateContent
protected int m_length
Constructor Detail |
---|
public CmsResource(CmsUUID structureId, CmsUUID resourceId, java.lang.String rootPath, int type, boolean isFolder, int flags, CmsUUID projectId, CmsResourceState state, long dateCreated, CmsUUID userCreated, long dateLastModified, CmsUUID userLastModified, long dateReleased, long dateExpired, int linkCount, int size, long dateContent, int version)
structureId
- the id of this resources structure recordresourceId
- the id of this resources resource recordrootPath
- the root path to the resourcetype
- the type of this resourceisFolder
- must be true if the resource is a folder, or false if it is a fileflags
- the flags of this resourceprojectId
- the project id this resource was last modified instate
- the state of this resourcedateCreated
- the creation date of this resourceuserCreated
- the id of the user who created this resourcedateLastModified
- the date of the last modification of this resourceuserLastModified
- the id of the user who did the last modification of this resourcedateReleased
- the release date of this resourcedateExpired
- the expiration date of this resourcelinkCount
- the count of all siblings of this resourcesize
- the size of the file content of this resourcedateContent
- the date of the last modification of the content of this resourceversion
- the version number of this resourceMethod Detail |
---|
public static void checkResourceName(java.lang.String name) throws CmsIllegalArgumentException
A resource name can only be composed of digits,
standard ASCII letters and the symbols defined in NAME_CONSTRAINTS
.
A resource name must also not contain only dots.
name
- the resource name to check
CmsIllegalArgumentException
- if the given resource name is not validpublic static java.lang.String getFolderPath(java.lang.String resource)
If the resource name denotes a folder (that is ends with a "/"), the complete path of the folder is returned (not the parent folder path).
This is achieved by just cutting of everything behind the last occurrence of a "/" character
in the String, no check if performed if the resource exists or not in the VFS,
only resources that end with a "/" are considered to be folders.
Example: Returns /system/def/
for the
resource /system/def/file.html
and
/system/def/
for the (folder) resource /system/def/
.
resource
- the name of a resource
public static java.lang.String getName(java.lang.String resource)
The resource name of a file is the name of the file.
The resource name of a folder is the folder name with trailing "/".
The resource name of the root folder is /
.
Example: /system/workplace/
has the resource name workplace/
.
resource
- the resource to get the name for
public static java.lang.String getParentFolder(java.lang.String resource)
The parent resource of a file is the folder of the file.
The parent resource of a folder is the parent folder.
The parent resource of the root folder is null
.
Example: /system/workplace/
has the parent /system/
.
resource
- the resource to find the parent folder for
null
for the root folderpublic static int getPathLevel(java.lang.String resource)
The root folder "/" has level 0, a folder "/foo/" would have level 1, a folfer "/foo/bar/" level 2 etc.
resource
- the resource to determine the directory level for
public static java.lang.String getPathPart(java.lang.String resource, int level)
resource
- the name of a resourcelevel
- of levels to walk up or down
public static boolean isFolder(java.lang.String resource)
resource
- the resource to check
public java.lang.Object clone()
clone
in class java.lang.Object
public int compareTo(java.lang.Object obj)
Please note a number of additional comparators for resources exists as members of this class.
compareTo
in interface java.lang.Comparable
Comparable.compareTo(java.lang.Object)
,
COMPARE_DATE_RELEASED
,
COMPARE_ROOT_PATH
,
COMPARE_ROOT_PATH_IGNORE_CASE
,
COMPARE_ROOT_PATH_IGNORE_CASE_FOLDERS_FIRST
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Object.equals(java.lang.Object)
public long getDateContent()
This applies only to resources of type CmsFile
, since a CmsFolder
has no content.
In case of a folder, -1
is always returned as content date.
Any modification of a resource, including changes to the resource properties,
will increase the "date of last modification" which is returned by getDateLastModified()
.
The "date of the content" as returned by this method only changes when the
file content as returned by CmsFile.getContents()
is changed.
public long getDateCreated()
public long getDateExpired()
If the expiration date has not been set, DATE_EXPIRED_DEFAULT
is returned.
This means: The resource does never expire.
public long getDateLastModified()
public long getDateReleased()
If the release date has not been set, DATE_RELEASED_DEFAULT
is returned.
This means: The resource has always been released.
public int getFlags()
for an explanation of the resource flags
public int getLength()
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.
public java.lang.String getName()
index.html
.
public CmsUUID getProjectLastModified()
null
public CmsUUID getResourceId()
public java.lang.String getRootPath()
/sites/default/myfolder/index.html
.
In a presentation level application usually the current site root must be
cut of from the root path. Use CmsObject.getSitePath(CmsResource)
to get the "absolute" path of a resource in the current site.
CmsObject.getSitePath(CmsResource)
,
CmsRequestContext.getSitePath(CmsResource)
,
CmsRequestContext.removeSiteRoot(String)
public int getSiblingCount()
If a resource has no sibling, the total sibling count for this resource is 1
,
if a resource has n
siblings, the sibling count is n + 1
.
public CmsResourceState getState()
This may be STATE_UNCHANGED
,
STATE_CHANGED
, STATE_NEW
or STATE_DELETED
.
public CmsUUID getStructureId()
public int getTypeId()
public CmsUUID getUserCreated()
CmsUser
who created this resource.
CmsUser
who created this resourcepublic CmsUUID getUserLastModified()
CmsUser
who made the last change on this resource.
CmsUser
who made the last changepublic int getVersion()
public int hashCode()
hashCode
in class java.lang.Object
Object.hashCode()
public boolean isExpired(long time)
true
if this resource is expired at the given time according to the
information stored in getDateExpired()
.
time
- the time to check the expiration date against
true
if this resource is expired at the given timeisReleased(long)
,
isReleasedAndNotExpired(long)
,
DATE_RELEASED_EXPIRED_IGNORE
,
getDateReleased()
,
CmsRequestContext.getRequestTime()
public boolean isFile()
true
if the resource is a CmsFile
, that is not a CmsFolder
.
public boolean isFolder()
true
if the resource is a CmsFolder
, that is not a CmsFile
.
public boolean isInternal()
true
if the resource is marked as internal.An internal resource can be read by the OpenCms API, but it can not be delivered by a direct request from an outside user.
For example if the resource /internal.xml
has been set as marked as internal, this resource can not be requested by an HTTP request,
so when a user enters http:/www.myserver.com/opencms/opencms/internal.xml
in the browser
this will generate a CmsVfsResourceNotFoundException
.
This state is stored as bit 1 in the resource flags.
true
if the resource is internalpublic boolean isLabeled()
true
if the resource has to be labeled with a special icon in the explorer view.This state is stored as bit 2 in the resource flags.
true
if the resource has to be labeled in the explorer viewpublic boolean isReleased(long time)
true
if this resource is released at the given time according to the
information stored in getDateReleased()
.
time
- the time to check the release date against
true
if this resource is released at the given timeisExpired(long)
,
isReleasedAndNotExpired(long)
,
DATE_RELEASED_EXPIRED_IGNORE
,
getDateReleased()
,
CmsRequestContext.getRequestTime()
public boolean isReleasedAndNotExpired(long time)
true
if this resource is valid at the given time according to the
information stored in getDateReleased()
and getDateExpired()
.A resource is valid if it is released and not yet expired.
time
- the time to check the release and expiration date against
true
if this resource is valid at the given timeisExpired(long)
,
isReleased(long)
,
DATE_RELEASED_EXPIRED_IGNORE
,
getDateReleased()
,
CmsRequestContext.getRequestTime()
public boolean isTouched()
true
if this resource was touched.
true
if this resource was touchedpublic void setDateExpired(long time)
time
- the expiration date to setpublic void setDateLastModified(long time)
time
- the last modification date to setpublic void setDateReleased(long time)
time
- the release date to setpublic void setFlags(int flags)
The resource flags integer is used as bit set that contains special information about the resource. The following methods internally use the resource flags:
flags
- the flags value to setpublic void setState(CmsResourceState state)
state
- the state to setpublic void setType(int type)
type
- the type to setpublic void setUserLastModified(CmsUUID resourceLastModifiedByUserId)
resourceLastModifiedByUserId
- the user id of the user who changed the resourcepublic java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
|
||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |