Hub JS Package

Hub JS Package

  • Users
  • Buckets
  • Threads
  • Textile Docs

›ReadTransaction

Client

  • Client.withUserAuth() method
  • Client.withKeyInfo() method
  • Client.getToken() method
  • Client.getTokenChallenge() method
  • Client.newDB() method
  • Client.open() method
  • Client.deleteDB() method
  • Client.getDBInfo() method
  • Client.joinFromInfo() method
  • Client.newDBFromAddr() method
  • Client.listen() method
  • Client.listDBs() method
  • Client.newCollection() method
  • Client.newCollectionFromObject() method
  • Client.deleteCollection() method
  • Client.updateCollection() method
  • Client.getCollectionIndexes() method
  • Client.getCollectionInfo() method
  • Client.listCollections() method
  • Client.create() method
  • Client.save() method
  • Client.delete() method
  • Client.find() method
  • Client.findByID() method
  • Client.has() method
  • Client.readTransaction() method
  • Client.writeTransaction() method

WriteTransaction

  • WriteTransaction class
  • WriteTransaction.create() method
  • WriteTransaction.delete() method
  • WriteTransaction.find() method
  • WriteTransaction.findByID() method
  • WriteTransaction.has() method
  • WriteTransaction.save() method
  • WriteTransaction.start() method
  • WriteTransaction.discard() method

ReadTransaction

  • ReadTransaction class
  • ReadTransaction.find() method
  • ReadTransaction.findByID() method
  • ReadTransaction.has() method
  • ReadTransaction.start() method

Types

  • Action enum
  • DBInfo interface
  • Filter interface
  • Query class
  • Update interface
  • Where variable

@textile/hub > ReadTransaction

ReadTransaction class

ReadTransaction performs a read-only bulk transaction on the underlying store.

Signature:

export declare class ReadTransaction extends Transaction<ReadTransactionRequest, ReadTransactionReply> 

Extends: Transaction<ReadTransactionRequest, ReadTransactionReply>

Example

Create a new entry and check for it within a transaction

import {Client, ThreadID} from '@textile/hub'

interface Astronaut {
  name: string
  missions: number
  _id: string
}

async function createAndCheck (client: Client, threadID: ThreadID) {
  const buzz: Astronaut = {
    name: 'Buzz',
    missions: 2,
    _id: '',
  }

  const ids = await client.create(threadID, 'astronauts', [buzz])
  // Create and start transaction
  const t = client.readTransaction(threadID, 'astronauts')
  await t.start()
  const has = await t.has(ids)
  console.log(has) // true
  await t.end() // Finish
}

Constructors

ConstructorModifiersDescription
(constructor)(context, client, threadID, modelName)Constructs a new instance of the ReadTransaction class

Properties

PropertyModifiersTypeDescription
clientgrpc.Client<ReadTransactionRequest, ReadTransactionReply>
contextContextInterface
modelNamestring
threadIDThreadID

Methods

MethodModifiersDescription
find(query)find queries the store for entities matching the given query parameters. See Query for options.
findByID(ID)findByID queries the store for the id of an instance.
has(IDs)has checks whether a given instance exists in the given store.
start()start begins the transaction. All operations between start and end will be applied as a single transaction upon a call to end.
← WriteTransaction.discard() methodReadTransaction.find() method →
  • ReadTransaction class
  • Example
  • Constructors
  • Properties
  • Methods
Hub JS Package
Docs
Getting StartedThreadDBBuckets
Resources
All DocumentationProject SlackBlog
More
GitHubStar
Follow @textileio