Skip to main content
Module

x/typeorm/src/index.ts>EntityMetadata

Forked from https://github.com/typeorm/typeorm
Latest
class EntityMetadata
Re-export
import { EntityMetadata } from "https://deno.land/x/typeorm@v0.2.23-rc10/src/index.ts";

Contains all entity metadata.

Constructors

new
EntityMetadata(options: { connection: Connection; inheritanceTree?: Function[]; inheritancePattern?: "STI"; tableTree?: TreeMetadataArgs; parentClosureEntityMetadata?: EntityMetadata; args: TableMetadataArgs; })

Properties

afterInsertListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER INSERT" type.

afterLoadListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER LOAD" type.

afterRemoveListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER REMOVE" type.

afterUpdateListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER UPDATE" type.

allEmbeddeds: EmbeddedMetadata[]

All embeddeds - embeddeds from this entity metadata and from all child embeddeds, etc.

ancestorColumns: ColumnMetadata[]

Ancestor columns used only in closure junction tables.

beforeInsertListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER INSERT" type.

beforeRemoveListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER REMOVE" type.

beforeUpdateListeners: EntityListenerMetadata[]

Listener metadatas with "AFTER UPDATE" type.

checks: CheckMetadata[]

Entity's check metadatas.

childEntityMetadatas: EntityMetadata[]

Children entity metadatas. Used in inheritance patterns.

closureJunctionTable: EntityMetadata

If entity's table is a closure-typed table, then this entity will have a closure junction table metadata.

columns: ColumnMetadata[]

Columns of the entity, including columns that are coming from the embeddeds of this entity.

connection: Connection

Connection where this entity metadata is created.

optional
createDateColumn: ColumnMetadata

Gets entity column which contains a create date value.

optional
database: string

Database name.

descendantColumns: ColumnMetadata[]

Descendant columns used only in closure junction tables.

optional
discriminatorColumn: ColumnMetadata

Gets the discriminator column used to store entity identificator in single-table inheritance tables.

optional
discriminatorValue: string

If this entity metadata is a child table of some table, it should have a discriminator value. Used to store a value in a discriminator column.

eagerRelations: RelationMetadata[]

List of eager relations this metadata has.

embeddeds: EmbeddedMetadata[]

Entity's embedded metadatas.

optional
engine: string

Table's database engine type (like "InnoDB", "MyISAM", etc).

exclusions: ExclusionMetadata[]

Entity's exclusion metadatas.

optional
expression: string | ((connection: Connection) => SelectQueryBuilder<any>)

View's expression. Used in views

foreignKeys: ForeignKeyMetadata[]

Entity's foreign key metadatas.

generatedColumns: ColumnMetadata[]

Gets the column with generated flag.

optional
givenTableName: string

Original user-given table name (taken from schema or @Entity(tableName) decorator). If user haven't specified a table name this property will be undefined.

hasMultiplePrimaryKeys: boolean

Checks if entity's table has multiple primary columns.

hasNonNullableRelations: boolean

Checks if there any non-nullable column exist in this entity.

hasUUIDGeneratedColumns: boolean

Indicates if this entity metadata has uuid generated columns.

indices: IndexMetadata[]

Entity's index metadatas.

optional
inheritancePattern: "STI"

If this entity metadata's table using one of the inheritance patterns, then this will contain what pattern it uses.

inheritanceTree: Function[]

All "inheritance tree" from a target entity. For example for target Post < ContentModel < Unit it will be an array of [Post, ContentModel, Unit]. It also contains child entities for single table inheritance.

inverseColumns: ColumnMetadata[]

In the case if this entity metadata is junction table's entity metadata, this will contain all referenced columns of inverse entity.

isClosureJunction: boolean

Checks if this table is a junction table of the closure table. This type is for tables that contain junction metadata of the closure tables.

isJunction: boolean

Indicates if this entity metadata of a junction table, or not. Junction table is a table created by many-to-many relationship.

Its also possible to understand if entity is junction via tableType.

lazyRelations: RelationMetadata[]

List of eager relations this metadata has.

listeners: EntityListenerMetadata[]

Entity listener metadatas.

manyToManyRelations: RelationMetadata[]

Gets only many-to-many relations of the entity.

manyToOneRelations: RelationMetadata[]

Gets only many-to-one relations of the entity.

optional
materializedPathColumn: ColumnMetadata

Materialized path column. Used only in tree entities with materialized path pattern applied.

name: string

Entity's name. Equal to entity target class's name if target is set to table. If target class is not then then it equals to table name.

optional
nestedSetLeftColumn: ColumnMetadata

Nested set's left value column. Used only in tree entities with nested set pattern applied.

optional
nestedSetRightColumn: ColumnMetadata

Nested set's right value column. Used only in tree entities with nested set pattern applied.

nonVirtualColumns: ColumnMetadata[]

All columns except for virtual columns.

optional
objectIdColumn: ColumnMetadata

Gets the object id column used with mongodb database.

oneToManyRelations: RelationMetadata[]

Gets only one-to-many relations of the entity.

oneToOneRelations: RelationMetadata[]

Gets only one-to-one relations of the entity.

optional
orderBy: OrderByCondition

Specifies a default order by used for queries from this table when no explicit order by is specified.

ownColumns: ColumnMetadata[]

Entity's column metadatas defined by user.

ownerColumns: ColumnMetadata[]

In the case if this entity metadata is junction table's entity metadata, this will contain all referenced columns of owner entity.

ownerManyToManyRelations: RelationMetadata[]

Gets only owner many-to-many relations of the entity.

ownerOneToOneRelations: RelationMetadata[]

Gets only owner one-to-one relations of the entity.

ownIndices: IndexMetadata[]

Entity's own indices.

ownListeners: EntityListenerMetadata[]

Entity's own listener metadatas.

ownRelations: RelationMetadata[]

Entity's relation metadatas.

ownUniques: UniqueMetadata[]

Entity's own uniques.

parentClosureEntityMetadata: EntityMetadata

If this is entity metadata for a junction closure table then its owner closure table metadata will be set here.

parentEntityMetadata: EntityMetadata

Parent's entity metadata. Used in inheritance patterns.

primaryColumns: ColumnMetadata[]

Gets the primary columns.

propertiesMap: ObjectLiteral

Map of columns and relations of the entity.

example: Post{ id: number, name: string, counterEmbed: { count: number }, category: Category }. This method will create following object: { id: "id", counterEmbed: { count: "counterEmbed.count" }, category: "category" }

relationCounts: RelationCountMetadata[]

Entity's relation id metadatas.

relationIds: RelationIdMetadata[]

Entity's relation id metadatas.

relations: RelationMetadata[]

Relations of the entity, including relations that are coming from the embeddeds of this entity.

relationsWithJoinColumns: RelationMetadata[]

Gets only owner one-to-one and many-to-one relations.

optional
schema: string

Schema name. Used in Postgres and Sql Server.

optional
schemaPath: string

Entity schema path. Contains database name and schema name. E.g. myDB.mySchema

synchronize: boolean

Indicates if schema will be synchronized for this entity or not.

tableMetadataArgs: TableMetadataArgs

Metadata arguments used to build this entity metadata.

tableName: string

Entity table name in the database. This is final table name of the entity. This name already passed naming strategy, and generated based on multiple criteria, including user table name and global table prefix.

tableNameWithoutPrefix: string

Gets the table name without global table prefix. When querying table you need a table name with prefix, but in some scenarios, for example when you want to name a junction table that contains names of two other tables, you may want a table name without prefix.

tablePath: string

Entity table path. Contains database name, schema name and table name. E.g. myDB.mySchema.myTable

tableType: TableType

Table type. Tables can be abstract, closure, junction, embedded, etc.

target: Function | string

Target class to which this entity metadata is bind. Note, that when using table inheritance patterns target can be different rather then table's target. For virtual tables which lack of real entity (like junction tables) target is equal to their table name.

targetName: string

Gets the name of the target.

optional
treeChildrenRelation: RelationMetadata

Tree children relation. Used only in tree-tables.

optional
treeLevelColumn: ColumnMetadata

Special column that stores tree level in tree entities.

optional
treeParentRelation: RelationMetadata

Tree parent relation. Used only in tree-tables.

optional
treeType: TreeType

Indicates if this entity is a tree, what type of tree it is.

uniques: UniqueMetadata[]

Entity's unique metadatas.

optional
updateDateColumn: ColumnMetadata

Gets entity column which contains an update date value.

optional
versionColumn: ColumnMetadata

Gets entity column which contains an entity version.

optional
withoutRowid: boolean

Enables Sqlite "WITHOUT ROWID" modifier for the "CREATE TABLE" statement

Methods

protected
buildSchemaPath(): string | undefined

Builds table path using schema name and database name.

protected
buildTablePath(): string

Builds table path using database name, schema name and table name.

compareEntities(firstEntity: ObjectLiteral, secondEntity: ObjectLiteral): boolean

Compares two different entities by their ids. Returns true if they match, false otherwise.

create(queryRunner?: QueryRunner): any

Creates a new entity.

createPropertiesMap(): { [name: string]: string | any; }

Creates a special object - all columns and relations of the object (plus columns and relations from embeds) in a special format - { propertyName: propertyName }.

example: Post{ id: number, name: string, counterEmbed: { count: number }, category: Category }. This method will create following object: { id: "id", counterEmbed: { count: "counterEmbed.count" }, category: "category" }

ensureEntityIdMap(id: any): ObjectLiteral

Ensures that given object is an entity id map. If given id is an object then it means its already id map. If given id isn't an object then it means its a value of the id column and it creates a new id map with this value and name of the primary column.

extractRelationValuesFromEntity(entity: ObjectLiteral, relations: RelationMetadata[]): [RelationMetadata, any, EntityMetadata][]

Iterates through entity and finds and extracts all values from relations in the entity. If relation value is an array its being flattened.

findColumnsWithPropertyPath(propertyPath: string): ColumnMetadata[]

Finds columns with a given property path. Property path can match a relation, and relations can contain multiple columns.

findColumnWithDatabaseName(databaseName: string): ColumnMetadata | undefined

Finds column with a given database name.

findColumnWithPropertyName(propertyName: string): ColumnMetadata | undefined

Finds column with a given property name.

findColumnWithPropertyPath(propertyPath: string): ColumnMetadata | undefined

Finds column with a given property path.

findEmbeddedWithPropertyPath(propertyPath: string): EmbeddedMetadata | undefined

Finds embedded with a given property path.

findRelationWithPropertyPath(propertyPath: string): RelationMetadata | undefined

Finds relation with the given property path.

getEntityIdMap(entity: ObjectLiteral | undefined): ObjectLiteral | undefined

Gets primary keys of the entity and returns them in a literal object. For example, for Post{ id: 1, title: "hello" } where id is primary it will return { id: 1 } For multiple primary keys it returns multiple keys in object. For primary keys inside embeds it returns complex object literal with keys in them.

getEntityIdMixedMap(entity: ObjectLiteral | undefined): ObjectLiteral | undefined

Creates a "mixed id map". If entity has multiple primary keys (ids) then it will return just regular id map, like what getEntityIdMap returns. But if entity has a single primary key then it will return just value of the id column of the entity, just value. This is called mixed id map.

hasAllPrimaryKeys(entity: ObjectLiteral): boolean

Checks if given entity / object contains ALL primary keys entity must have. Returns true if it contains all of them, false if at least one of them is not defined.

hasEmbeddedWithPropertyPath(propertyPath: string): boolean

Checks if there is an embedded with a given property path.

hasId(entity: ObjectLiteral): boolean

Checks if given entity has an id.

registerColumn(column: ColumnMetadata)

Registers a new column in the entity and recomputes all depend properties.

Static Methods

compareIds(firstId: ObjectLiteral | undefined, secondId: ObjectLiteral | undefined): boolean

Compares ids of the two entities. Returns true if they match, false otherwise.

createPropertyPath(
metadata: EntityMetadata,
entity: ObjectLiteral,
prefix?: string,
)

Creates a property paths for a given entity.

difference(firstIdMaps: ObjectLiteral[], secondIdMaps: ObjectLiteral[]): ObjectLiteral[]

Finds difference between two entity id maps. Returns items that exist in the first array and absent in the second array.

getValueMap(
entity: ObjectLiteral,
columns: ColumnMetadata[],
options?: { skipNulls?: boolean; },
): ObjectLiteral | undefined

Creates value map from the given values and columns. Examples of usages are primary columns map and join columns map.