bpmn-elements/src/flows/Association.js

Executable workflow elements based on BPMN 2.0

import { cloneParent } from '../messageHelper.js';
import { EventBroker } from '../EventBroker.js';
import { Api } from '../Api.js';
import { getUniqueId } from '../shared.js';

const kCounters = Symbol.for('counters');

export default function Association(associationDef, { environment }) {
  const { id, type = 'association', name, parent, targetId, sourceId, behaviour = {} } = associationDef;

  this.id = id;
  this.type = type;
  this.name = name;
  this.parent = cloneParent(parent);
  this.behaviour = behaviour;
  this.sourceId = sourceId;
  this.targetId = targetId;
  this.isAssociation = true;
  this.environment = environment;
  const logger = (this.logger = environment.Logger(type.toLowerCase()));

  this[kCounters] = {
    take: 0,
    discard: 0,
  };

  const { broker, on, once, waitFor } = new EventBroker(this, { prefix: 'association', durable: true, autoDelete: false });
  this.broker = broker;
  this.on = on;
  this.once = once;
  this.waitFor = waitFor;

  logger.debug(`<${id}> init, <${sourceId}> -> <${targetId}>`);
}

Object.defineProperty(Association.prototype, 'counters', {
  get() {
    return { ...this[kCounters] };
  },
});

Association.prototype.take = function take(content) {
  this.logger.debug(`<${this.id}> take target <${this.targetId}>`);
  ++this[kCounters].take;

  this._publishEvent('take', content);

  return true;
};

Association.prototype.discard = function discard(content) {
  this.logger.debug(`<${this.id}> discard target <${this.targetId}>`);
  ++this[kCounters].discard;

  this._publishEvent('discard', content);

  return true;
};

Association.prototype.getState = function getState() {
  const brokerState = this.broker.getState(true);
  if (!brokerState && this.environment.settings.disableTrackState) return;

  return {
    id: this.id,
    type: this.type,
    counters: this.counters,
    broker: brokerState,
  };
};

Association.prototype.recover = function recover(state) {
  Object.assign(this[kCounters], state.counters);
  this.broker.recover(state.broker);
};

Association.prototype.getApi = function getApi(message) {
  return new Api('association', this.broker, message || { content: this._createMessageContent() });
};

Association.prototype.stop = function stop() {
  this.broker.stop();
};

Association.prototype._publishEvent = function publishEvent(action, content) {
  const eventContent = this._createMessageContent({
    action,
    message: content,
    sequenceId: getUniqueId(this.id),
  });

  this.broker.publish('event', `association.${action}`, eventContent, { type: action });
};

Association.prototype._createMessageContent = function createMessageContent(override) {
  return {
    ...override,
    id: this.id,
    type: this.type,
    name: this.name,
    sourceId: this.sourceId,
    targetId: this.targetId,
    isAssociation: true,
    parent: cloneParent(this.parent),
  };
};