Auto-refresh providers

org.eclipse.core.resources.refreshProviders

3.0

The workspace supports a mode where changes that occur in the file system are automatically detected and reconciled with the workspace in memory. By default, this is accomplished by creating a monitor that polls the file system and periodically searching for changes. The monitor factories extension point allows clients to create more efficient monitors, typically by hooking into some native file system facility for change callbacks.

<!ELEMENT extension (refreshProvider)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT refreshProvider EMPTY>

<!ATTLIST refreshProvider

name  CDATA #REQUIRED

class CDATA #REQUIRED>


Following is an example of an adapter declaration. This example declares that this plug-in will provide an adapter factory that will adapt objects of type IFile to objects of type MyFile.

   

<extension id=

"coolProvider"

point=

"org.eclipse.core.resources.refreshProviders"

>

<refreshProvider name=

"Cool Refresh Provider"

class=

"com.xyz.CoolRefreshProvider"

>

</refreshProvider>

</extension>

Refresh provider implementations must subclass the abstract type RefreshProvider in the org.eclipse.core.resources.refresh package. Refresh requests and failures should be forward to the provide IRefreshResult. Clients must also provide an implementation of IRefreshMonitor through which the workspace can request that refresh monitors be uninstalled.

The org.eclipse.core.resources.win32 fragment provides a native refresh monitor that uses win32 file system notification callbacks. The workspace also supplies a default naive polling-based monitor that can be used for file systems that do not have native refresh callbacks available.