Master Filesystem
Friend, Private or Third Party

MasterFileSystem exports SPI for versioning support.

See:
Description

Master Filesystem

org.netbeans.modules.masterfs.providers

MasterFileSystem exports SPI for versioning support. There is expected that module that provides implementation of FileSystem that should be plugable into MasterFileSystem must implement at least FileSystemProvider. MasterFileSystem doesn't provide pure client API but has tiny API that is intended just for SPI providers (slightly disputable if it should be called API or SPI). All SPI are plugable, registred by Lookup.

What is New (see all changes)?

• Mar 20 '08 ProvidedExtensions.canWrite was added.

  ProvidedExtensions.canWrite which is called when MasterFileSystem queries the FileObject for writability.

• Jan 8 '08 Fileobject instances are not issued after external changes

  FileObject instances are not guaranteed to be issued if files, folders were not created, deleted, modified by FileSystem API and method refresh wasn't properly called. These methods were semantically changed:

  • FileObject.getFileObject
  • FileSystem.findResource
  • FileObject.getChildren

  Method FileUtil.toFileObject should still work as before.

• Jan 8 '08 Simplify MasterFS, do not delegate on other embedded FS

  Friend contract for org.netbeans.modules.vcscore broken. Following classes deleted: MountSupport, FileSystemProvider, AutoMountProvider

• Jun 15 '07 ProvidedExtensions.fileLock and ProvidedExtensions.fileUnlock was added.

  ProvidedExtensions.fileLock which is called after MasterFileSystem locks FileObject

  ProvidedExtensions.fileUnlock which is called after FileObject is unlocked.

• Feb 12 '07 ProvidedExtensions.beforeChange was added.

  ProvidedExtensions.beforeChangewhich is called by MasterFileSystem when FileObject is going to be modified by asking for OutputStream.

Use Cases

MasterFileSystem is just implementation of FileSystem. There are no special use cases. FileObjects erlier returned from URLMapper or FileUtil.fromFile provided by LocalFileSystem or CvsFileSystem will be now provided by MasterFileSystem. There will be guaranteed that there won't be more instances of FileObject addressing one java.ioFile.

Exported Interfaces

This table lists all of the module exported APIs with defined stability classifications. It is generated based on answers to questions about the architecture of the module. Read them all...

Group of java interfaces

Interface Name	In/Out	Stability	Specified in What Document?
MasterFileSystemAPI	Exported	Friend	.../masterfs/providers/package-summary.html

Implementation Details

What do other modules need to do to declare a dependency on this one, in addition to or instead of a plain module dependency?

Nothing currently. Most "clients" are really callers of FileUtil.toFileObject and so on, and thus implicitly depend on the existence of this module. In the future a provide-require token might make sense.

Read more about the implementation in the answers to architecture questions.