Class TextFileBufferSnapshot

  • All Implemented Interfaces:
    ISnapshot

    public final class TextFileBufferSnapshot
    extends Snapshot
    A snapshot of an ITextFileBuffer. Thread-safe.
    • Constructor Summary

      Constructors 
      Constructor Description
      TextFileBufferSnapshot​(org.eclipse.core.filebuffers.ITextFileBuffer buffer, org.eclipse.core.filebuffers.ITextFileBufferManager bufferManager)
      Constructs a new snapshot of the given text file buffer.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getContents()
      A snapshot returns the same contents until it expires.
      protected java.lang.Boolean predictEquality​(Snapshot other)
      Predicts whether this snapshot is equal to the given snapshot without actually obtaining snapshot contents.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • TextFileBufferSnapshot

        public TextFileBufferSnapshot​(org.eclipse.core.filebuffers.ITextFileBuffer buffer,
                                      org.eclipse.core.filebuffers.ITextFileBufferManager bufferManager)
        Constructs a new snapshot of the given text file buffer.
        Parameters:
        buffer - a buffer connected through the given buffer manager - must not be null and must be connected at least during the execution of this constructor
        bufferManager - must not be null
    • 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 return null.

        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
      • predictEquality

        protected java.lang.Boolean predictEquality​(Snapshot other)
        Description copied from class: Snapshot
        Predicts whether this snapshot is equal to the given snapshot without actually obtaining snapshot contents. Must return null if cannot tell for sure. Any non-null result must meet the contract of ISnapshot.isEqualTo(ISnapshot).
        Overrides:
        predictEquality in class Snapshot
        Parameters:
        other - the other snapshot (not null 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, and null if there is no prediction