This class represents a change event that occurs on a filesystem. The path, type and sequence number of event
can be queried from this class.
For example if a file called "drew.dft" was newly created this class would provide the following values:
getPath() returns "/SDCard/tmp/drew.dft"
getUSN() returns 23 (denoting this is the 23rd change event to the file system since the device was reset)
getEvent() returns FILE_ADDED
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Since:
JDE 4.2.0
Field Summary
static int
FILE_ADDED
File Added Event type; occurs when a file is added to the system.
static int
FILE_CHANGED
File Changed Event type; occurs when a file is modified (written to or truncated).
static int
FILE_DELETED
File Delete Event type; occurs when a file is remove from the system.
static int
FILE_RENAMED
File Renamed Event type; occurs when a file is renamed.
Method Summary
int
getEvent()
Returns the type of event which this event corresponds to.
File Added Event type; occurs when a file is added to the system.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
FILE_CHANGED
public static final int FILE_CHANGED
File Changed Event type; occurs when a file is modified (written to or truncated).
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
FILE_DELETED
public static final int FILE_DELETED
File Delete Event type; occurs when a file is remove from the system.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
FILE_RENAMED
public static final int FILE_RENAMED
File Renamed Event type; occurs when a file is renamed.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail
getEvent
public int getEvent()
Returns the type of event which this event corresponds to.
Returns:
An enumerated integer of value FILE_ADDED, FILE_DELETED, FILE_CHANGED or FILE_RENAMED.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Returns the associated path this event corresponds to before the event occurred. NOTE: The returned string does
not contain the "file://" protocol specifier and an escaped ASCII format as defined by RFC 2396.
Returns:
A String representing the path that a modification occurred on.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Returns the associated path that this event corresponds to. NOTE: The returned string does
not contain the "file://" protocol specifier and an escaped ASCII format as defined by RFC 2396.
Returns:
A String representing the path that a modification occurred on.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
getUSN
public long getUSN()
Returns the USN (Update Sequence Number) for this event; this event is an increasing number since the
device was reset.
Returns:
The USN for this event.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.