typeorm
Version:
Data-Mapper ORM for TypeScript, ES7, ES6, ES5. Supports MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, Oracle, MongoDB databases.
510 lines (508 loc) • 28.9 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.ColumnMetadata = void 0;
var tslib_1 = require("tslib");
var OrmUtils_1 = require("../util/OrmUtils");
var MongoDriver_1 = require("../driver/mongodb/MongoDriver");
var FindOperator_1 = require("../find-options/FindOperator");
var ApplyValueTransformers_1 = require("../util/ApplyValueTransformers");
/**
* This metadata contains all information about entity's column.
*/
var ColumnMetadata = /** @class */ (function () {
// ---------------------------------------------------------------------
// Constructor
// ---------------------------------------------------------------------
function ColumnMetadata(options) {
/**
* Type's length in the database.
*/
this.length = "";
/**
* Indicates if this column is a primary key.
*/
this.isPrimary = false;
/**
* Indicates if this column is generated (auto increment or generated other way).
*/
this.isGenerated = false;
/**
* Indicates if column can contain nulls or not.
*/
this.isNullable = false;
/**
* Indicates if column is selected by query builder or not.
*/
this.isSelect = true;
/**
* Indicates if column is inserted by default or not.
*/
this.isInsert = true;
/**
* Indicates if column allows updates or not.
*/
this.isUpdate = true;
/**
* Puts ZEROFILL attribute on to numeric column. Works only for MySQL.
* If you specify ZEROFILL for a numeric column, MySQL automatically adds the UNSIGNED attribute to the column
*/
this.zerofill = false;
/**
* Puts UNSIGNED attribute on to numeric column. Works only for MySQL.
*/
this.unsigned = false;
/**
* Indicates if this column is an array.
*/
this.isArray = false;
/**
* Indicates if column is virtual. Virtual columns are not mapped to the entity.
*/
this.isVirtual = false;
/**
* Indicates if column is discriminator. Discriminator columns are not mapped to the entity.
*/
this.isDiscriminator = false;
/**
* Indicates if column is tree-level column. Tree-level columns are used in closure entities.
*/
this.isTreeLevel = false;
/**
* Indicates if this column contains an entity creation date.
*/
this.isCreateDate = false;
/**
* Indicates if this column contains an entity update date.
*/
this.isUpdateDate = false;
/**
* Indicates if this column contains an entity delete date.
*/
this.isDeleteDate = false;
/**
* Indicates if this column contains an entity version.
*/
this.isVersion = false;
/**
* Indicates if this column contains an object id.
*/
this.isObjectId = false;
/**
* Indicates if this column is nested set's left column.
* Used only in tree entities with nested-set type.
*/
this.isNestedSetLeft = false;
/**
* Indicates if this column is nested set's right column.
* Used only in tree entities with nested-set type.
*/
this.isNestedSetRight = false;
/**
* Indicates if this column is materialized path's path column.
* Used only in tree entities with materialized path type.
*/
this.isMaterializedPath = false;
this.entityMetadata = options.entityMetadata;
this.embeddedMetadata = options.embeddedMetadata;
this.referencedColumn = options.referencedColumn;
if (options.args.target)
this.target = options.args.target;
if (options.args.propertyName)
this.propertyName = options.args.propertyName;
if (options.args.options.name)
this.givenDatabaseName = options.args.options.name;
if (options.args.options.type)
this.type = options.args.options.type;
if (options.args.options.length)
this.length = options.args.options.length ? options.args.options.length.toString() : "";
if (options.args.options.width)
this.width = options.args.options.width;
if (options.args.options.charset)
this.charset = options.args.options.charset;
if (options.args.options.collation)
this.collation = options.args.options.collation;
if (options.args.options.primary)
this.isPrimary = options.args.options.primary;
if (options.args.options.default === null) // to make sure default: null is the same as nullable: true
this.isNullable = true;
if (options.args.options.nullable !== undefined)
this.isNullable = options.args.options.nullable;
if (options.args.options.select !== undefined)
this.isSelect = options.args.options.select;
if (options.args.options.insert !== undefined)
this.isInsert = options.args.options.insert;
if (options.args.options.update !== undefined)
this.isUpdate = options.args.options.update;
if (options.args.options.readonly !== undefined)
this.isUpdate = !options.args.options.readonly;
if (options.args.options.comment)
this.comment = options.args.options.comment;
if (options.args.options.default !== undefined)
this.default = options.args.options.default;
if (options.args.options.onUpdate)
this.onUpdate = options.args.options.onUpdate;
if (options.args.options.scale !== null && options.args.options.scale !== undefined)
this.scale = options.args.options.scale;
if (options.args.options.zerofill) {
this.zerofill = options.args.options.zerofill;
this.unsigned = true; // if you specify ZEROFILL for a numeric column, MySQL automatically adds the UNSIGNED attribute to the column
}
if (options.args.options.unsigned)
this.unsigned = options.args.options.unsigned;
if (options.args.options.precision !== null)
this.precision = options.args.options.precision;
if (options.args.options.enum) {
if (options.args.options.enum instanceof Object && !Array.isArray(options.args.options.enum)) {
this.enum = Object.keys(options.args.options.enum)
// remove numeric keys - typescript numeric enum types generate them
// From the documentation: “declaration merging” means that the compiler merges two separate declarations
// declared with the same name into a single definition. This concept is often used to merge enum with namespace
// where in namespace we define e.g. utility methods for creating enum. This is well known in other languages
// like Java (enum methods). Here in case if enum have function, we need to remove it from metadata, otherwise
// generated SQL statements contains string representation of that function which leads into syntax error
// at database side.
.filter(function (key) { return isNaN(+key) && typeof options.args.options.enum[key] !== "function"; })
.map(function (key) { return options.args.options.enum[key]; });
}
else {
this.enum = options.args.options.enum;
}
}
if (options.args.options.enumName) {
this.enumName = options.args.options.enumName;
}
if (options.args.options.asExpression) {
this.asExpression = options.args.options.asExpression;
this.generatedType = options.args.options.generatedType ? options.args.options.generatedType : "VIRTUAL";
}
if (options.args.options.hstoreType)
this.hstoreType = options.args.options.hstoreType;
if (options.args.options.array)
this.isArray = options.args.options.array;
if (options.args.mode) {
this.isVirtual = options.args.mode === "virtual";
this.isTreeLevel = options.args.mode === "treeLevel";
this.isCreateDate = options.args.mode === "createDate";
this.isUpdateDate = options.args.mode === "updateDate";
this.isDeleteDate = options.args.mode === "deleteDate";
this.isVersion = options.args.mode === "version";
this.isObjectId = options.args.mode === "objectId";
}
if (options.args.options.transformer)
this.transformer = options.args.options.transformer;
if (options.args.options.spatialFeatureType)
this.spatialFeatureType = options.args.options.spatialFeatureType;
if (options.args.options.srid !== undefined)
this.srid = options.args.options.srid;
if (this.isTreeLevel)
this.type = options.connection.driver.mappedDataTypes.treeLevel;
if (this.isCreateDate) {
if (!this.type)
this.type = options.connection.driver.mappedDataTypes.createDate;
if (!this.default)
this.default = function () { return options.connection.driver.mappedDataTypes.createDateDefault; };
// skip precision if it was explicitly set to "null" in column options. Otherwise use default precision if it exist.
if (this.precision === undefined && options.args.options.precision === undefined && options.connection.driver.mappedDataTypes.createDatePrecision)
this.precision = options.connection.driver.mappedDataTypes.createDatePrecision;
}
if (this.isUpdateDate) {
if (!this.type)
this.type = options.connection.driver.mappedDataTypes.updateDate;
if (!this.default)
this.default = function () { return options.connection.driver.mappedDataTypes.updateDateDefault; };
if (!this.onUpdate)
this.onUpdate = options.connection.driver.mappedDataTypes.updateDateDefault;
// skip precision if it was explicitly set to "null" in column options. Otherwise use default precision if it exist.
if (this.precision === undefined && options.args.options.precision === undefined && options.connection.driver.mappedDataTypes.updateDatePrecision)
this.precision = options.connection.driver.mappedDataTypes.updateDatePrecision;
}
if (this.isDeleteDate) {
if (!this.type)
this.type = options.connection.driver.mappedDataTypes.deleteDate;
if (!this.isNullable)
this.isNullable = options.connection.driver.mappedDataTypes.deleteDateNullable;
// skip precision if it was explicitly set to "null" in column options. Otherwise use default precision if it exist.
if (this.precision === undefined && options.args.options.precision === undefined && options.connection.driver.mappedDataTypes.deleteDatePrecision)
this.precision = options.connection.driver.mappedDataTypes.deleteDatePrecision;
}
if (this.isVersion)
this.type = options.connection.driver.mappedDataTypes.version;
if (options.closureType)
this.closureType = options.closureType;
if (options.nestedSetLeft)
this.isNestedSetLeft = options.nestedSetLeft;
if (options.nestedSetRight)
this.isNestedSetRight = options.nestedSetRight;
if (options.materializedPath)
this.isMaterializedPath = options.materializedPath;
}
// ---------------------------------------------------------------------
// Public Methods
// ---------------------------------------------------------------------
/**
* Creates entity id map from the given entity ids array.
*/
ColumnMetadata.prototype.createValueMap = function (value, useDatabaseName) {
var _a;
var _this = this;
if (useDatabaseName === void 0) { useDatabaseName = false; }
// extract column value from embeds of entity if column is in embedded
if (this.embeddedMetadata) {
// example: post[data][information][counters].id where "data", "information" and "counters" are embeddeds
// we need to get value of "id" column from the post real entity object and return it in a
// { data: { information: { counters: { id: ... } } } } format
// first step - we extract all parent properties of the entity relative to this column, e.g. [data, information, counters]
var propertyNames = tslib_1.__spreadArray([], tslib_1.__read(this.embeddedMetadata.parentPropertyNames));
// now need to access post[data][information][counters] to get column value from the counters
// and on each step we need to create complex literal object, e.g. first { data },
// then { data: { information } }, then { data: { information: { counters } } },
// then { data: { information: { counters: [this.propertyName]: entity[data][information][counters][this.propertyName] } } }
// this recursive function helps doing that
var extractEmbeddedColumnValue_1 = function (propertyNames, map) {
var propertyName = propertyNames.shift();
if (propertyName) {
map[propertyName] = {};
extractEmbeddedColumnValue_1(propertyNames, map[propertyName]);
return map;
}
// this is bugfix for #720 when increment number is bigint we need to make sure its a string
if ((_this.generationStrategy === "increment" || _this.generationStrategy === "rowid") && _this.type === "bigint" && value !== null)
value = String(value);
map[useDatabaseName ? _this.databaseName : _this.propertyName] = value;
return map;
};
return extractEmbeddedColumnValue_1(propertyNames, {});
}
else { // no embeds - no problems. Simply return column property name and its value of the entity
// this is bugfix for #720 when increment number is bigint we need to make sure its a string
if ((this.generationStrategy === "increment" || this.generationStrategy === "rowid") && this.type === "bigint" && value !== null)
value = String(value);
return _a = {}, _a[useDatabaseName ? this.databaseName : this.propertyName] = value, _a;
}
};
/**
* Extracts column value and returns its column name with this value in a literal object.
* If column is in embedded (or recursive embedded) it returns complex literal object.
*
* Examples what this method can return depend if this column is in embeds.
* { id: 1 } or { title: "hello" }, { counters: { code: 1 } }, { data: { information: { counters: { code: 1 } } } }
*/
ColumnMetadata.prototype.getEntityValueMap = function (entity, options) {
var _a, _b;
var _this = this;
var returnNulls = false; // options && options.skipNulls === false ? false : true; // todo: remove if current will not bring problems, uncomment if it will.
// extract column value from embeds of entity if column is in embedded
if (this.embeddedMetadata) {
// example: post[data][information][counters].id where "data", "information" and "counters" are embeddeds
// we need to get value of "id" column from the post real entity object and return it in a
// { data: { information: { counters: { id: ... } } } } format
// first step - we extract all parent properties of the entity relative to this column, e.g. [data, information, counters]
var propertyNames = tslib_1.__spreadArray([], tslib_1.__read(this.embeddedMetadata.parentPropertyNames));
var isEmbeddedArray_1 = this.embeddedMetadata.isArray;
// now need to access post[data][information][counters] to get column value from the counters
// and on each step we need to create complex literal object, e.g. first { data },
// then { data: { information } }, then { data: { information: { counters } } },
// then { data: { information: { counters: [this.propertyName]: entity[data][information][counters][this.propertyName] } } }
// this recursive function helps doing that
var extractEmbeddedColumnValue_2 = function (propertyNames, value) {
var _a, _b;
if (value === undefined) {
return {};
}
var propertyName = propertyNames.shift();
if (propertyName) {
var submap = extractEmbeddedColumnValue_2(propertyNames, value[propertyName]);
if (Object.keys(submap).length > 0) {
return _a = {}, _a[propertyName] = submap, _a;
}
return {};
}
if (isEmbeddedArray_1 && Array.isArray(value)) {
return value.map(function (v) {
var _a;
return (_a = {}, _a[_this.propertyName] = v[_this.propertyName], _a);
});
}
if (value[_this.propertyName] !== undefined && (returnNulls === false || value[_this.propertyName] !== null)) {
return _b = {}, _b[_this.propertyName] = value[_this.propertyName], _b;
}
return {};
};
var map = extractEmbeddedColumnValue_2(propertyNames, entity);
return Object.keys(map).length > 0 ? map : undefined;
}
else { // no embeds - no problems. Simply return column property name and its value of the entity
if (this.relationMetadata && entity[this.relationMetadata.propertyName] && entity[this.relationMetadata.propertyName] instanceof Object) {
var map = this.relationMetadata.joinColumns.reduce(function (map, joinColumn) {
var value = joinColumn.referencedColumn.getEntityValueMap(entity[_this.relationMetadata.propertyName]);
if (value === undefined)
return map;
return OrmUtils_1.OrmUtils.mergeDeep(map, value);
}, {});
if (Object.keys(map).length > 0)
return _a = {}, _a[this.propertyName] = map, _a;
return undefined;
}
else {
if (entity[this.propertyName] !== undefined && (returnNulls === false || entity[this.propertyName] !== null))
return _b = {}, _b[this.propertyName] = entity[this.propertyName], _b;
return undefined;
}
}
};
/**
* Extracts column value from the given entity.
* If column is in embedded (or recursive embedded) it extracts its value from there.
*/
ColumnMetadata.prototype.getEntityValue = function (entity, transform) {
var _this = this;
if (transform === void 0) { transform = false; }
if (entity === undefined || entity === null)
return undefined;
// extract column value from embeddeds of entity if column is in embedded
var value = undefined;
if (this.embeddedMetadata) {
// example: post[data][information][counters].id where "data", "information" and "counters" are embeddeds
// we need to get value of "id" column from the post real entity object
// first step - we extract all parent properties of the entity relative to this column, e.g. [data, information, counters]
var propertyNames = tslib_1.__spreadArray([], tslib_1.__read(this.embeddedMetadata.parentPropertyNames));
var isEmbeddedArray = this.embeddedMetadata.isArray;
// next we need to access post[data][information][counters][this.propertyName] to get column value from the counters
// this recursive function takes array of generated property names and gets the post[data][information][counters] embed
var extractEmbeddedColumnValue_3 = function (propertyNames, value) {
var propertyName = propertyNames.shift();
return propertyName && value ? extractEmbeddedColumnValue_3(propertyNames, value[propertyName]) : value;
};
// once we get nested embed object we get its column, e.g. post[data][information][counters][this.propertyName]
var embeddedObject = extractEmbeddedColumnValue_3(propertyNames, entity);
if (embeddedObject) {
if (this.relationMetadata && this.referencedColumn) {
var relatedEntity = this.relationMetadata.getEntityValue(embeddedObject);
if (relatedEntity && relatedEntity instanceof Object && !(relatedEntity instanceof FindOperator_1.FindOperator) && !(relatedEntity instanceof Buffer)) {
value = this.referencedColumn.getEntityValue(relatedEntity);
}
else if (embeddedObject[this.propertyName] && embeddedObject[this.propertyName] instanceof Object && !(embeddedObject[this.propertyName] instanceof FindOperator_1.FindOperator) && !(embeddedObject[this.propertyName] instanceof Buffer) && !(embeddedObject[this.propertyName] instanceof Date)) {
value = this.referencedColumn.getEntityValue(embeddedObject[this.propertyName]);
}
else {
value = embeddedObject[this.propertyName];
}
}
else if (this.referencedColumn) {
value = this.referencedColumn.getEntityValue(embeddedObject[this.propertyName]);
}
else if (isEmbeddedArray && Array.isArray(embeddedObject)) {
value = embeddedObject.map(function (o) { return o[_this.propertyName]; });
}
else {
value = embeddedObject[this.propertyName];
}
}
}
else { // no embeds - no problems. Simply return column name by property name of the entity
if (this.relationMetadata && this.referencedColumn) {
var relatedEntity = this.relationMetadata.getEntityValue(entity);
if (relatedEntity && relatedEntity instanceof Object && !(relatedEntity instanceof FindOperator_1.FindOperator) && !(relatedEntity instanceof Function) && !(relatedEntity instanceof Buffer)) {
value = this.referencedColumn.getEntityValue(relatedEntity);
}
else if (entity[this.propertyName] && entity[this.propertyName] instanceof Object && !(entity[this.propertyName] instanceof FindOperator_1.FindOperator) && !(entity[this.propertyName] instanceof Function) && !(entity[this.propertyName] instanceof Buffer) && !(entity[this.propertyName] instanceof Date)) {
value = this.referencedColumn.getEntityValue(entity[this.propertyName]);
}
else {
value = entity[this.propertyName];
}
}
else if (this.referencedColumn) {
value = this.referencedColumn.getEntityValue(entity[this.propertyName]);
}
else {
value = entity[this.propertyName];
}
}
if (transform && this.transformer)
value = ApplyValueTransformers_1.ApplyValueTransformers.transformTo(this.transformer, value);
return value;
};
/**
* Sets given entity's column value.
* Using of this method helps to set entity relation's value of the lazy and non-lazy relations.
*/
ColumnMetadata.prototype.setEntityValue = function (entity, value) {
var _this = this;
if (this.embeddedMetadata) {
// first step - we extract all parent properties of the entity relative to this column, e.g. [data, information, counters]
var extractEmbeddedColumnValue_4 = function (embeddedMetadatas, map) {
// if (!object[embeddedMetadata.propertyName])
// object[embeddedMetadata.propertyName] = embeddedMetadata.create();
var embeddedMetadata = embeddedMetadatas.shift();
if (embeddedMetadata) {
if (!map[embeddedMetadata.propertyName])
map[embeddedMetadata.propertyName] = embeddedMetadata.create();
extractEmbeddedColumnValue_4(embeddedMetadatas, map[embeddedMetadata.propertyName]);
return map;
}
map[_this.propertyName] = value;
return map;
};
return extractEmbeddedColumnValue_4(tslib_1.__spreadArray([], tslib_1.__read(this.embeddedMetadata.embeddedMetadataTree)), entity);
}
else {
// we write a deep object in this entity only if the column is virtual
// because if its not virtual it means the user defined a real column for this relation
// also we don't do it if column is inside a junction table
if (!this.entityMetadata.isJunction && this.isVirtual && this.referencedColumn && this.referencedColumn.propertyName !== this.propertyName) {
if (!(this.propertyName in entity)) {
entity[this.propertyName] = {};
}
entity[this.propertyName][this.referencedColumn.propertyName] = value;
}
else {
entity[this.propertyName] = value;
}
}
};
// ---------------------------------------------------------------------
// Builder Methods
// ---------------------------------------------------------------------
ColumnMetadata.prototype.build = function (connection) {
this.propertyPath = this.buildPropertyPath();
this.propertyAliasName = this.propertyPath.replace(".", "_");
this.databaseName = this.buildDatabaseName(connection);
this.databasePath = this.buildDatabasePath();
this.databaseNameWithoutPrefixes = connection.namingStrategy.columnName(this.propertyName, this.givenDatabaseName, []);
return this;
};
ColumnMetadata.prototype.buildPropertyPath = function () {
var path = "";
if (this.embeddedMetadata && this.embeddedMetadata.parentPropertyNames.length)
path = this.embeddedMetadata.parentPropertyNames.join(".") + ".";
path += this.propertyName;
// we add reference column to property path only if this column is virtual
// because if its not virtual it means user defined a real column for this relation
// also we don't do it if column is inside a junction table
if (!this.entityMetadata.isJunction && this.isVirtual && this.referencedColumn && this.referencedColumn.propertyName !== this.propertyName)
path += "." + this.referencedColumn.propertyName;
return path;
};
ColumnMetadata.prototype.buildDatabasePath = function () {
var path = "";
if (this.embeddedMetadata && this.embeddedMetadata.parentPropertyNames.length)
path = this.embeddedMetadata.parentPropertyNames.join(".") + ".";
path += this.databaseName;
// we add reference column to property path only if this column is virtual
// because if its not virtual it means user defined a real column for this relation
// also we don't do it if column is inside a junction table
if (!this.entityMetadata.isJunction && this.isVirtual && this.referencedColumn && this.referencedColumn.databaseName !== this.databaseName)
path += "." + this.referencedColumn.databaseName;
return path;
};
ColumnMetadata.prototype.buildDatabaseName = function (connection) {
var propertyNames = this.embeddedMetadata ? this.embeddedMetadata.parentPrefixes : [];
if (connection.driver instanceof MongoDriver_1.MongoDriver) // we don't need to include embedded name for the mongodb column names
propertyNames = [];
return connection.namingStrategy.columnName(this.propertyName, this.givenDatabaseName, propertyNames);
};
return ColumnMetadata;
}());
exports.ColumnMetadata = ColumnMetadata;
//# sourceMappingURL=ColumnMetadata.js.map