Method createEntity

packages/core/src/entity/EntityFactory.ts:406–465

(data: EntityData<T>, meta: EntityMetadata<T>, options: FactoryOptions)

  }

  private createEntity<T extends object>(data: EntityData<T>, meta: EntityMetadata<T>, options: FactoryOptions): T {
    const schema = this.#driver.getSchemaName(meta, options);

    if (options.newEntity || meta.forceConstructor || meta.virtual) {
      if (meta.polymorphs) {
        throw new Error(`Cannot create entity ${meta.className}, class prototype is unknown`);
      }

      const params = this.extractConstructorParams<T>(meta, data, options);
      const Entity = meta.class as Constructor<T>;

      // creates new instance via constructor as this is the new entity
      const entity = new Entity(...params);

      // creating managed entity instance when `forceEntityConstructor` is enabled,
      // we need to wipe all the values as they would cause update queries on next flush
      if (!options.newEntity && (meta.forceConstructor || this.#config.get('forceEntityConstructor'))) {
        meta.props
          .filter(prop => prop.persist !== false && !prop.primary && data[prop.name] === undefined)
          .forEach(prop => delete entity[prop.name]);
      }

      if (meta.virtual) {
        return entity;
      }

      helper(entity).__schema = schema;

      if (options.initialized) {
        EntityHelper.ensurePropagation(entity);
      }

      return entity;
    }

    // creates new entity instance, bypassing constructor call as its already persisted entity
    const entity = Object.create(meta.class.prototype) as T;
    helper(entity).__managed = true;
    helper(entity).__processing = !meta.embeddable && !meta.virtual;
    helper(entity).__schema = schema;

    if (options.merge && !options.newEntity) {
      this.#hydrator.hydrateReference(
        entity,
        meta,
        data,
        this,
        options.convertCustomTypes,
        options.schema,
        options.parentSchema,
      );
      this.unitOfWork.register(entity);
    }

    if (options.initialized) {
      EntityHelper.ensurePropagation(entity);
    }