Molecule0.22.4 < Back

Packages

package root
Documentation/API for the Molecule library - a meta DSL for the Datomic database.
Manual | scalamolecule.org | Github | Forum
Definition Classes
root

Molecule library - a Scala meta-DSL for the Datomic database.

See api package for various api imports to start using Molecule.

Sub-packages

api		Molecule API.
ast		Internal Molecule ASTs.
boilerplate		Internal interfaces for auto-generated DSL boilerplate code.
composition		Builder methods to compose molecules.
exceptions		Exceptions thrown by Molecule.
expression		Attribute expressions and operations.
facade		Molecule facades to Datomic.
factory		Implicit macro methods `m` to instantiate molecules from custom DSL molecule constructs.
input		Input molecules awaiting input.
macros		Internal macros generating molecule code from custom DSL molecule constructs.
generic		Interfaces to generic information about datoms and Datomic database.
ops		Internal operational helpers for transforming DSL to molecule.
schema		Schema definition DSL.
transform		Internal transformers from DSL to Model/Query/Transaction.
util		Internal Java database functions for Datomic.

Definition Classes: root

package api
Definition Classes
molecule

trait Molecule[Tpl] extends MoleculeBase with CastHelpers[Tpl] with JsonBuilder with GetArray[Tpl] with GetIterable[Tpl] with GetList[Tpl] with GetRaw with GetJson with GetAsyncArray[Tpl] with GetAsyncIterable[Tpl] with GetAsyncList[Tpl] with GetAsyncRaw with GetAsyncJson with ShowDebug[Tpl]

Core molecule interface defining actions that can be called on molecules.

Groups of interfaces:

get	getAsync	Get molecule data.
getAsOf	getAsyncAsOf	Get molecule data asOf point in time.
getSince	getAsyncSince	Get molecule data since point in time.
getWith	getAsyncWith	Get molecule data with given data set.
getHistory	getAsyncHistory	Get molecule data from history of database.
save	saveAsync	Save molecule with applied data.
insert	insertAsync	Insert multiple rows of data matching molecule.
update	updateAsync	Update molecule with applied data.
tx		Molecule transaction data (input to `getWith`).
debug get		Debug calling get method on molecule.
debug operation		Debug calling save/insert/update method on molecule.

Tpl: Type of molecule (tuple of its attribute types)

Definition Classes: api
See also: For retract ("delete") methods, see EntityOps and Entity.
Manual: get, time, asOf/since, history, with, getJson, debug/test, save, insert, update, retract
Tests: get, asOf, since, history, with, test asOf, test since, test with, getJson, save, insert, retract,
update, update map, update ref, update multiple attributes, update multiple entities

Regex
checkInsertModel
debugInsert
getInsertTx
insert
insertAsync
mkDate

molecule.api.Molecule

insertAsync

trait insertAsync extends AnyRef

Asynchronously insert one or more rows of data matching molecule.

Returns Future with TxReport having info about the result of the insert transaction.

Data matching the types of the molecule can be inserted either as individual args or an Iterable (List, Set etc) of tuples:

// Insert single row of data with individual args
val singleInsertFuture: Future[TxReport] = Person.name.age.insertAsync("Ann", 28)

// Insert multiple rows of data. Accepts Iterable[Tpl]
val multipleInsertFuture: Future[TxReport] = Person.name.age insertAsync List(
  ("Ben", 42),
  ("Liz", 37)
)

for {
  _ <- singleInsertFuture
  _ <- multipleInsertFuture
  result <- Person.name.age.getAsync
} yield {
  // Both inserts applied
  result === List(
    ("Ann", 28),
    ("Ben", 42),
    ("Liz", 37)
  )
}

The insert operation is asynchronous and non-blocking. Internally calls Datomic's asynchronous API.

Source: Molecule.scala

Linear Supertypes

AnyRef, Any

Type Hierarchy

Ordering

Alphabetic
By Inheritance

Inherited

insertAsync
AnyRef
Any

Hide All
Show All

Visibility

Public
Protected

Value Members

final def !=(arg0: Any): Boolean
Definition Classes
AnyRef → Any
final def ##: Int
Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean
Definition Classes
AnyRef → Any
final def asInstanceOf[T0]: T0
Definition Classes
Any
def clone(): AnyRef
Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
final def eq(arg0: AnyRef): Boolean
Definition Classes
AnyRef
def equals(arg0: AnyRef): Boolean
Definition Classes
AnyRef → Any
def finalize(): Unit
Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.Throwable])
final def getClass(): Class[_ <: AnyRef]
Definition Classes
AnyRef → Any
Annotations
@native()
def hashCode(): Int
Definition Classes
AnyRef → Any
Annotations
@native()
final def isInstanceOf[T0]: Boolean
Definition Classes
Any
final def ne(arg0: AnyRef): Boolean
Definition Classes
AnyRef
final def notify(): Unit
Definition Classes
AnyRef
Annotations
@native()
final def notifyAll(): Unit
Definition Classes
AnyRef
Annotations
@native()
final def synchronized[T0](arg0: => T0): T0
Definition Classes
AnyRef
def toString(): String
Definition Classes
AnyRef → Any
final def wait(): Unit
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException]) @native()

Packages

Sub-packages

insertAsync

trait insertAsync extends AnyRef

Value Members

Inherited from AnyRef

Inherited from Any

Ungrouped

Packages

Sub-packages

insertAsync

trait insertAsync extends AnyRef

Value Members

Inherited from AnyRef

Inherited from Any

Ungrouped

insertAsync