io.sirix.api.NodeReadOnlyTrx Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of sirix-core Show documentation

SirixDB is a hybrid on-disk and in-memory document oriented, versioned database system. It has a lightweight buffer manager, stores everything in a huge persistent and durable tree and allows efficient reconstruction of every revision. Furthermore, SirixDB implements change tracking, diffing and supports time travel queries.

There is a newer version: 0.11.0

Show newest version

package io.sirix.api;

import io.sirix.access.User;
import io.sirix.access.trx.node.CommitCredentials;
import io.sirix.api.xml.XmlNodeReadOnlyTrx;
import io.sirix.node.NodeKind;
import io.sirix.node.SirixDeweyID;
import io.sirix.exception.SirixException;
import io.brackit.query.atomic.QNm;

import java.time.Instant;
import java.util.Optional;

public interface NodeReadOnlyTrx extends AutoCloseable {

  /**
   * Get the transaction-ID of transaction.
   *
   * @return ID of the transaction
   */
  long getId();

  /**
   * Get the revision number of this transaction.
   *
   * @return immutable revision number of this transaction
   */
  int getRevisionNumber();

  /**
   * UNIX-style timestamp of the commit of the revision.
   *
   * @return instant, representing the milliseconds from unix epoch.
   */
  Instant getRevisionTimestamp();

  /**
   * Getting the maximum nodekey available in this revision.
   *
   * @return the maximum nodekey
   */
  long getMaxNodeKey();

  /**
   * Close shared read transaction and immediately release all resources.
   * 
   * This is an idempotent operation and does nothing if the transaction is already closed.
   *
   * @throws SirixException if can't close {@link XmlNodeReadOnlyTrx}
   */
  @Override
  void close();

  /**
   * Get the node key of the currently selected node.
   *
   * @return node key of the currently selected node
   */
  long getNodeKey();

  /**
   * Get the {@link ResourceSession} this instance is bound to.
   *
   * @return the resource manager this transaction is bound to
   */
  ResourceSession getResourceSession();

  /**
   * Get the commit credentials.
   *
   * @return the commit credentials
   */
  CommitCredentials getCommitCredentials();

  /**
   * Move to a specific node.
   *
   * @param key the nodeKey of the node to move to
   * @return this transaction instance
   */
  boolean moveTo(long key);

  /**
   * Get the underlying page transaction.
   *
   * @return the underlying page transaction
   */
  PageReadOnlyTrx getPageTrx();

  /**
   * Get the path node key of the current node.
   *
   * @return the path node key
   */
  long getPathNodeKey();

  /**
   * Get key for given name. This is used for efficient name testing.
   *
   * @param name name, i.e., local part, URI, or prefix
   * @return internal key assigned to given name
   */
  int keyForName(String name);

  /**
   * Get name for key. This is used for efficient key testing.
   *
   * @param key key, i.e., local part key, URI key, or prefix key.
   * @return String containing name for given key
   */
  String nameForKey(int key);

  /**
   * Get the number of descendants of the current node.
   *
   * @return the number of descendants of the current node
   */
  long getDescendantCount();

  /**
   * Get the number of children of the current node.
   *
   * @return the number of children of the current node
   */
  long getChildCount();

  /**
   * Get the kind of path of the current node (only supported for path summary transactions).
   *
   * @return the kind of path of the current node
   */
  NodeKind getPathKind();

  /**
   * Determines if the current node is the document root node or not.
   *
   * @return {@code true}, if the current node is the document root node, {@code false} otherwise
   */
  boolean isDocumentRoot();

  /**
   * Determines if the state of the transaction has been changed to {@code closed}.
   *
   * @return {@code true}, if the transaction has been closed, {@code false} otherwise
   */
  boolean isClosed();

  /**
   * Get the name of the current node or {@code null}.
   *
   * @return the name of the current node or {@code null} if the node has no name
   */
  QNm getName();

  /**
   * Determines if the current node has children or not.
   *
   * @return {@code true}, if the current node has children, {@code false} otherwise
   */
  boolean hasChildren();

  /**
   * Get the hash code of the node.
   *
   * @return the hash code
   */
  long getHash();

  /**
   * Get the value of the current node or {@code null}.
   *
   * @return the value of the current node or {@code null} if the node has no value
   */
  String getValue();

  /**
   * Get the user who committed the revision, if available.
   *
   * @return the user who committed the revision, if available
   */
  Optional getUser();

  /**
   * Determines if DeweyIDs should be store or not.
   *
   * @return {@code true}, if DeweyIDs should be stored, {@code false} if not
   */
  boolean storeDeweyIDs();

  /**
   * Get the DeweyID of the node, the transactional cursor currently points to.
   *
   * @return the DeweyID of the current node
   */
  SirixDeweyID getDeweyID();

  /**
   * Get the revision number of the previous revision of the node, the transactional cursor currently points to.
   * @return the revision number of the previous revision of the current node
   */
  int getPreviousRevisionNumber();
}