Package org.eclipse.handly.snapshot
Class TextFileStoreSnapshot
- java.lang.Object
-
- org.eclipse.handly.snapshot.Snapshot
-
- org.eclipse.handly.snapshot.TextFileStoreSnapshot
-
-
Constructor Summary
Constructors Constructor Description TextFileStoreSnapshot(org.eclipse.core.filesystem.IFileStore fileStore)
Constructs a new snapshot of the given text file store.TextFileStoreSnapshot(org.eclipse.core.filesystem.IFileStore fileStore, java.nio.charset.Charset charset)
Constructs a new snapshot of the given text file store using the given charset for decoding the file store's contents.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
exists()
Returns whether the file existed at the moment this snapshot was taken.java.lang.String
getContents()
A snapshot returns the same contents until it expires.org.eclipse.core.runtime.IStatus
getStatus()
Returns whether an I/O error was encountered while reading the file.protected java.lang.Boolean
predictEquality(Snapshot other)
-
-
-
Constructor Detail
-
TextFileStoreSnapshot
public TextFileStoreSnapshot(org.eclipse.core.filesystem.IFileStore fileStore)
Constructs a new snapshot of the given text file store. The snapshot may use a default charset for decoding the file store's contents if a more specific charset could not be detected for the file store.- Parameters:
fileStore
- must not benull
-
TextFileStoreSnapshot
public TextFileStoreSnapshot(org.eclipse.core.filesystem.IFileStore fileStore, java.nio.charset.Charset charset)
Constructs a new snapshot of the given text file store using the given charset for decoding the file store's contents.- Parameters:
fileStore
- must not benull
charset
- must not benull
-
-
Method Detail
-
getContents
public java.lang.String getContents()
Description copied from interface:ISnapshot
A snapshot returns the same contents until it expires. This is the contents of the underlying resource or buffer at the moment the snapshot was taken. Expired snapshots returnnull
.Protractedly holding on to the returned contents is not recommended, as it may potentially consume significant amount of space.
- Returns:
- the contents of the snapshot, or
null
if the snapshot has expired
-
getStatus
public org.eclipse.core.runtime.IStatus getStatus()
Returns whether an I/O error was encountered while reading the file.- Returns:
- an error status if an I/O error was encountered, or OK status otherwise
-
exists
public boolean exists()
Returns whether the file existed at the moment this snapshot was taken.- Returns:
true
if the file existed at the moment this snapshot was taken, andfalse
otherwise
-
predictEquality
protected java.lang.Boolean predictEquality(Snapshot other)
Description copied from class:Snapshot
Predicts whether this snapshot isequal
to the given snapshot without actually obtaining snapshotcontents
. Must returnnull
if cannot tell for sure. Any non-null result must meet the contract ofISnapshot.isEqualTo(ISnapshot)
.- Overrides:
predictEquality
in classSnapshot
- Parameters:
other
- the other snapshot (notnull
and not identical to the receiver)- Returns:
true
if the snapshots are predicted to be equal,false
if the snapshots are predicted to be unequal, andnull
if there is no prediction
-
-