org.eclipse.core.resources
Interface IStorage

All Superinterfaces:

IAdaptable

All Known Subinterfaces:

IFile, IFileState

public interface IStorage

extends IAdaptable

A storage object represents a set of bytes which can be accessed. These may be in the form of an IFile or IFileState or any other object supplied by user code. The main role of an IStorage is to provide a uniform API for access to, and presentation of, its content.

Storage objects implement the IAdaptable interface; extensions are managed by the platform's adapter manager.

Clients may implement this interface.

Method Summary

InputStream	getContents() Returns an open input stream on the contents of this storage.
IPath	getFullPath() Returns the full path of this storage.
String	getName() Returns the name of this storage.
boolean	isReadOnly() Returns whether this storage is read-only.

Methods inherited from interface org.eclipse.core.runtime.IAdaptable

getAdapter

Method Detail

getContents

public InputStream getContents()
                        throws CoreException

Returns an open input stream on the contents of this storage. The caller is responsible for closing the stream when finished.

Returns:

an input stream containing the contents of this storage

Throws:

CoreException - if the contents of this storage could not be accessed. See any refinements for more information.

getFullPath

public IPath getFullPath()

Returns the full path of this storage. The returned value depends on the implementor/extender. A storage need not have a path.

Returns:

the path related to the data represented by this storage or null if none.

getName

public String getName()

Returns the name of this storage. The name of a storage is synonymous with the last segment of its full path though if the storage does not have a path, it may still have a name.

Returns:

the name of the data represented by this storage, or null if this storage has no name

See Also:

getFullPath()

isReadOnly

public boolean isReadOnly()

Returns whether this storage is read-only.

Returns:

true if this storage is read-only