|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface URLFileSystemListener
The URLFileSystemListener
interface allows clients to
track changes to file URL's in a root URL directory. The
URLFileSystemEvent
describes the event that occurred,
the URL which was involved, and the root URL directories containing
that URL.
Events are typically delivered on the same thread which caused the event to be generated. As this is not guaranteed to be the UI thread, listener clients should avoid manipulating UI in their implementations, as well as avoid any lengthy processing.
When a listener is registered for a given root URL, the
URLFileSystem
will cause that root URL to be tracked
by any underlying virtual file system that might be installed for
the given URL protocol. Clients need to be aware that such VFS
implementations may activate a native directory watcher to track
changes in the root URL. These native directory watchers may cause
the directory to be marked as "in use", preventing their deletion.
Since multiple threads in the application may be doing I/O operations
concurrently against the URLFileSystem
, a given
listener instance may receive notifications on multiple threads
simultaneously. Consequently, the listener implementation is
required to be thread-safe and re-entrant.
While unlikely, it is possible that listener instances may receive stray notifications for a given root URL that was previously registered if the listener de-registration and event notification are very closely spaced in time.
Method Summary | |
---|---|
void |
notifyEvent(URLFileSystemEvent event)
Notify the listener that an URL event has occurred in a tracked directory root URL. |
Method Detail |
---|
void notifyEvent(URLFileSystemEvent event)
FILE_ADDED
),
the URL that was affected, and what the directory root URL it
occurred in.
event
- the event providing more details as to what event
occurred
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |