Molecule0.22.8 < 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
package exception
Definition Classes
api
package get
Synchronous getter methods to retrieve data from Datomic.
Synchronous getter methods to retrieve data from Datomic.
The Datomic On-Prem(ises) server model provides a Peer that returns data synchronously. The Peer which lives in application memory caches data aggressively and for data fitting in memory latency can be extremely low and queries return very fast. And even when access to disk is needed, clever branching is used. Memcached is also an option.
The Datomic Cloud model data returns data asynchronously. If Datomic creates a Java API for the Cloud model, Molecule could relatively easy adapt to this model too. In the meanwhile, Future-wrapped methods in this package can be used.
Molecule has 5 groups of synchronous getters, each returning data in various formats:
- GetArray - fastest retrieved typed data set. Can be traversed with a fast while loop
- GetIterable - for lazily traversing row by row
- GetJson - data formatted as Json string
- GetList - default getter returning Lists of tuples. Convenient typed data, suitable for smaller data sets
- GetRaw - fastest retrieved raw un-typed data from Datomic
Getters in each of the 5 groups come with 5 time-dependent variations:
- get [current data]
- getAsOf
- getSince
- getWith
- getHistory
Each time variation has various overloads taking different parameters (see each group for more info).
Definition Classes
api
See also
equivalent asynchronous getters in the getAsync package.
package getAsync
Asynchronous getter methods to retrieve data from Datomic.
Asynchronous getter methods to retrieve data from Datomic.
For convenience, all synchronous getter methods from the get package are here wrapped in Futures.
The Datomic On-Prem(ises) server model provides a Peer that returns data synchronously. The Peer which lives in application memory caches data aggressively and for data fitting in memory latency can be extremely low and queries return very fast. And even when access to disk is needed, clever branching is used. Memcached is also an option.
The Datomic Cloud model data returns data asynchronously. If Datomic creates a Java API for the Cloud model, Molecule could relatively easy adapt to this model too. In the meanwhile, Future-wrapped methods in this package can be used.
Molecule has 5 groups of asynchronous getters, each returning Futures of data in various formats:
- GetAsyncArray - fastest retrieved typed data set. Can be traversed with a fast while loop
- GetAsyncIterable - for lazily traversing row by row
- GetAsyncJson - data formatted as Json string
- GetAsyncList - default getter returning Lists of tuples. Convenient typed data, suitable for smaller data sets
- GetAsyncRaw - fastest retrieved raw un-typed data from Datomic
Getters in each of the 5 groups come with 5 time-dependent variations:
- getAsync [current data]
- getAsyncAsOf
- getAsyncSince
- getAsyncWith
- getAsyncHistory
Each time variation has various overloads taking different parameters (see each group for more info).
Definition Classes
api
See also
equivalent synchronous getters in the get package.
Entity
EntityOps
Molecule
OptionalMapOps
ShowDebug
TxMethods
core
in1_out1
in1_out10
in1_out11
in1_out12
in1_out13
in1_out14
in1_out15
in1_out16
in1_out17
in1_out18
in1_out19
in1_out2
in1_out20
in1_out21
in1_out22
in1_out3
in1_out4
in1_out5
in1_out6
in1_out7
in1_out8
in1_out9
in2_out1
in2_out10
in2_out11
in2_out12
in2_out13
in2_out14
in2_out15
in2_out16
in2_out17
in2_out18
in2_out19
in2_out2
in2_out20
in2_out21
in2_out22
in2_out3
in2_out4
in2_out5
in2_out6
in2_out7
in2_out8
in2_out9
in3_out1
in3_out10
in3_out11
in3_out12
in3_out13
in3_out14
in3_out15
in3_out16
in3_out17
in3_out18
in3_out19
in3_out2
in3_out20
in3_out21
in3_out22
in3_out3
in3_out4
in3_out5
in3_out6
in3_out7
in3_out8
in3_out9
out1
out10
out11
out12
out13
out14
out15
out16
out17
out18
out19
out2
out20
out21
out22
out3
out4
out5
out6
out7
out8
out9

molecule.api

ShowDebug

trait ShowDebug[Tpl] extends AnyRef

Debug methods

Call a debug method on a molecule to see the internal transformations and produced transaction statements or sample data.

Self Type: Molecule[Tpl]
Source: ShowDebug.scala

Linear Supertypes

AnyRef, Any

Known Subclasses

Molecule, Molecule01, Molecule02, Molecule03, Molecule04, Molecule05, Molecule06, Molecule07, Molecule08, Molecule09, Molecule10, Molecule11, Molecule12, Molecule13, Molecule14, Molecule15, Molecule16, Molecule17, Molecule18, Molecule19, Molecule20, Molecule21, Molecule22

Type Hierarchy

Ordering

Grouped
Alphabetic
By Inheritance

Inherited

ShowDebug
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
def _debugInsert(conn: Conn, dataRows: Iterable[Seq[Any]]): Unit
Attributes
protected
final def asInstanceOf[T0]: T0
Definition Classes
Any
def clone(): AnyRef
Attributes
protected[lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
def debugGet(implicit conn: Conn): Unit
Debug call to get on a molecule (without affecting the db).
Debug call to get on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows). OBS: printing raw Date's (Clojure Instant) will miss the time-zone
conn
Implicit Conn value in scope
def debugGetAsOf(date: Date)(implicit conn: Conn): Unit
Debug call to getAsOf(date) on a molecule (without affecting the db).
Debug call to getAsOf(date) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
conn
Implicit Conn value in scsope
def debugGetAsOf(tx: TxReport)(implicit conn: Conn): Unit
Debug call to getAsOf(tx) on a molecule (without affecting the db).
Debug call to getAsOf(tx) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
tx
TxReport
conn
Implicit Conn value in scope
def debugGetAsOf(t: Long)(implicit conn: Conn): Unit
Debug call to getAsOf(t) on a molecule (without affecting the db).
Debug call to getAsOf(t) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
conn
Implicit Conn value in scope
def debugGetHistory(implicit conn: Conn): Unit
Debug call to getHistory on a molecule (without affecting the db).
Debug call to getHistory on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
conn
Implicit Conn value in scope
def debugGetSince(date: Date)(implicit conn: Conn): Unit
Debug call to getSince(date) on a molecule (without affecting the db).
Debug call to getSince(date) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
conn
Implicit Conn value in scope
def debugGetSince(tx: TxReport)(implicit conn: Conn): Unit
Debug call to getSince(tx) on a molecule (without affecting the db).
Debug call to getSince(tx) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
tx
TxReport
conn
Implicit Conn value in scope
def debugGetSince(t: Long)(implicit conn: Conn): Unit
Debug call to getSince(t) on a molecule (without affecting the db).
Debug call to getSince(t) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).
conn
Implicit Conn value in scope
def debugGetWith(txData: List[List[_]])(implicit conn: Conn): Unit
Debug call to getWith(txData) on a molecule (without affecting the db).
Debug call to getWith(txData) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).

3. Transactions of applied transaction data.
txData
Raw transaction data as java.util.List[Object]
conn
Implicit Conn value in scope
def debugGetWith(txMolecules: Seq[Seq[Statement]]*)(implicit conn: Conn): Unit
Debug call to getWith(txMolecules) on a molecule (without affecting the db).
Debug call to getWith(txMolecules) on a molecule (without affecting the db).

Prints the following to output:

1. Internal molecule transformation representations:
Molecule DSL --> Model --> Query --> Datomic query

2. Data returned from get query (max 500 rows).

3. Transactions of applied transaction molecules.
txMolecules
Transaction statements from applied Molecules with test data
conn
Implicit Conn value in scope
def debugSave(implicit conn: Conn): Unit
Debug call to save on a molecule (without affecting the db).
Debug call to save on a molecule (without affecting the db).

Prints internal molecule transformation representations to output:

Model --> Generic statements --> Datomic statements
conn
Implicit Conn value in scope
returns
Unit
def debugUpdate(implicit conn: Conn): Unit
Debug call to update on a molecule (without affecting the db).
Debug call to update on a molecule (without affecting the db).

Prints internal molecule transformation representations to output:

Model --> Generic statements --> Datomic statements
conn
Implicit Conn value in scope
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

ShowDebug

trait ShowDebug[Tpl] extends AnyRef

Value Members

Inherited from AnyRef

Inherited from Any

debugGet

debugOp

Ungrouped

Packages

Sub-packages

ShowDebug

trait ShowDebug[Tpl] extends AnyRef

Value Members

Inherited from AnyRef

Inherited from Any

debugGet

debugOp

Ungrouped

ShowDebug