v5.0.1
JUSTAOS's ORM (Object–relational mapping) tool is built for Deno and provides transparent persistence for JavaScript objects to Postgres database.
Attributes
Includes Deno configuration
Repository
Current version released
11 months ago
Dependencies
deno.land/x
std
Versions
- v10.1.0Latest
- v10.0.0
- v10.0.0-pre.2
- v10.0.0-pre.1
- v10.0.0-pre.0
- v9.1.2
- v9.1.1
- v9.1.0
- v9.1.0
- v9.0.1
- v9.0.0
- v8.0.0
- v8.0.0
- v8.0.0-pre.9
- v8.0.0-pre.9
- v8.0.0-pre.8
- v8.0.0-pre.7
- v8.0.0-pre.6
- v8.0.0-pre.5
- v8.0.0-pre.5
- v8.0.0-pre.4
- v8.0.0-pre.3
- v8.0.0-pre.2
- v8.0.0-pre.1
- v7.2.0-pre.0
- v7.1.1
- v7.1.1
- v7.1.1-pre.3
- v7.1.1-pre.3
- v7.1.1-pre.2
- v7.1.1-pre.1
- v7.1.1-pre.0
- v7.1.1-pre.0
- v7.1.0
- v7.0.1
- v6.4.0
- v6.3.0
- v6.2.0
- v6.1.0
- v5.13.0
- v5.14.0
- v5.12.0
- v5.11.0
- v5.10.0
- v5.9.0
- v5.8.0
- v5.7.0
- v5.6.3
- v5.6.2
- v5.6.1
- v5.6.0
- v5.5.10
- v5.5.9
- v5.5.8
- v5.5.7
- v5.5.6
- v5.5.5
- v5.5.4
- v5.5.3
- v5.5.2
- v5.5.1
- v5.5.0
- v5.4.11
- v5.4.10
- v5.4.9
- v5.4.8
- v5.4.7
- v5.4.6
- v5.4.5
- v5.4.4
- v5.4.3
- v5.4.2
- v5.4.1
- v5.4.0
- v5.3.0
- v5.2.7
- v5.2.6
- v5.2.5
- v5.2.3
- v5.2.4
- v5.2.2
- v5.2.1
- v5.2.0
- v5.1.0
- v5.0.2
- v5.0.1
- v5.0.0
- v4.11.0
- v4.10.2
JUSTAOS’s ORM
JUSTAOS’s ORM (Object Relational Mapping) tool is built for Deno and provides transparent persistence for JavaScript objects to Postgres database.
- Supports all primitive data types (string, integer, float, boolean, date, object, array, etc).
- Supports custom data types.
- Supports table with multi-level inheritance.
- Also supports interception on operations (create, read, update and delete).
import { ORM } from 'https://deno.land/x/justaos_orm@$VERSION/mod.ts';
Database connection
const orm = new ORM({
database: "collection-service",
username: "postgres",
password: "admin",
hostname: "localhost",
port: 5432
});
let conn: ORMConnection | undefined;
try {
conn = await orm.connect(true /* create database if not exists */);
console.log("connection success");
} catch (_error) {
console.log("connection failed");
} finally {
if (conn) await conn.closeConnection();
}
Defining models
await orm.defineTable({
name: "blog_post",
columns: [
{
name: "title",
type: "string"
},
{
name: "content",
type: "string"
}
]
});
await orm.defineTable({
name: "comment",
columns: [
{
name: "blog_post",
type: "reference"
},
{
name: "message",
type: "string"
}
]
});
Querying
const teacherTable = conn.table("teacher");
for (let i = 0; i < 10; i++) {
const teacher = teacherTable.createNewRecord();
teacher.set("name", "a" + (i + 1));
teacher.set("roll_no", i + 1);
await teacher.insert();
}
const records = await teacherTable
.select()
.orderBy("roll_no", "DESC")
.toArray();
records.forEach(async function(rec) {
console.log(
`${await rec.getDisplayValue("name")} :: ${await rec.getDisplayValue(
"roll_no"
)}`
);
console.log(JSON.stringify(await rec.toJSON(), null, 4));
});
const count = await teacherTable.select().getCount();
console.log(count);
Intercepting database operations
orm.addInterceptor(
new (class extends DatabaseOperationInterceptor {
getName() {
return "my-intercept";
}
async intercept(
collectionName: string,
operation: DatabaseOperationType,
when: DatabaseOperationWhen,
records: Record[],
_context: DatabaseOperationContext
) {
if (collectionName === "student") {
if (operation === "CREATE") {
console.log(
`[collectionName=${collectionName}, operation=${operation}, when=${when}]`
);
if (when === "BEFORE") {
for (let record of records) {
console.log(
"computed field updated for :: " + record.get("name")
);
record.set("computed", record.get("name") + " +++ computed");
}
}
}
if (operation === "READ") {
console.log(
`[collectionName=${collectionName}, operation=${operation}, when=${when}]`
);
if (when === "AFTER") {
for (const record of records) {
console.log(JSON.stringify(record.toJSON(), null, 4));
}
}
}
}
return records;
}
})()
);
await conn.defineTable({
name: "student",
columns: [
{
name: "name",
type: "string"
},
{
name: "computed",
type: "string"
}
]
});
const studentTable = conn.table("student");
const studentRecord = studentTable.createNewRecord();
studentRecord.set("name", "John " + new Date().toISOString());
await studentRecord.insert();
await studentTable.select().toArray();
/* This will print the following:
[collectionName=student, operation=CREATE, when=BEFORE]
computed field updated for :: John 2023-12-05T13:57:21.418Z
[collectionName=student, operation=CREATE, when=AFTER]
[collectionName=student, operation=READ, when=BEFORE]
[collectionName=student, operation=READ, when=AFTER]
{
"id": "e5d8a03e-7511-45c6-96ad-31a6fa833696",
"_table": "student",
"name": "John 2023-12-05T13:31:13.313Z",
"computed": "John 2023-12-05T13:31:13.313Z +++ computed"
}
*/
Define custom field type
After connection established, you can define custom field type.
orm.addDataType(
class extends DataType {
constructor() {
super(NATIVE_DATA_TYPES.VARCHAR);
}
getName() {
return "email";
}
async validateValue(
_schema: TableSchema,
fieldName: string,
record: RawRecord
) {
const pattern = "(.+)@(.+){2,}\\.(.+){2,}";
if (!new RegExp(pattern).test(record[fieldName]))
throw new Error("Not a valid email");
}
validateDefinition(fieldDefinition: ColumnDefinition) {
return !!fieldDefinition.name;
}
getValueIntercept(
_schema: TableSchema,
fieldName: string,
record: RawRecord
): any {
return record[fieldName];
}
setValueIntercept(
_schema: TableSchema,
_fieldName: string,
newValue: any,
_record: RawRecord
): any {
return newValue;
}
async getDisplayValue(
_schema: TableSchema,
fieldName: string,
record: RawRecord,
_context: DatabaseOperationContext
) {
return record[fieldName];
}
}
);
await conn.defineTable({
name: "student",
columns: [
{
name: "name",
type: "string"
},
{
name: "personal_contact",
type: "email"
},
{
name: "emp_no",
type: "uuid"
},
{
name: "salary",
type: "integer"
},
{
name: "birth_date",
type: "date"
},
{
name: "gender",
type: "boolean"
}
]
});
const studentTable = conn.table("student");
const student = studentTable.createNewRecord();
student.set("personal_contact", "test");
student.set("birth_date", new Date());
try {
await student.insert();
console.log("Student created");
} catch (_error) {
console.log(_error.toJSON());
}
Inheritance
await conn.defineTable({
name: "animal",
columns: [
{
name: "name",
type: "string"
}
]
});
const animalTable = conn.table("animal");
const animal = animalTable.createNewRecord();
animal.set("name", "Puppy");
await animal.insert();
await conn.defineTable({
name: "dog",
inherits: "animal",
final: true,
columns: [
{
name: "breed",
type: "string"
}
]
});
const dogTable = conn.table("dog");
const husky = dogTable.createNewRecord();
husky.set("name", "Jimmy");
husky.set("breed", "Husky");
await husky.insert();
const animals = await animalTable.select().toArray();
animals.forEach((animal) => {
console.log(animal.toJSON());
});
Data type | get | getJSONValue |
---|---|---|
string | string | string |
integer | number | number |
date | Temporal.PlainDate | string |
Check the examples >> here <<