vagabond-uml/lib/helpers/association_helper.js

UML support for Vagabond via XMI and JDL files

'use strict';

var chalk = require('chalk'),
    AssociationData = require('../data/association_data'),
    NullPointerException = require('../exceptions/null_pointer_exception'),
    AssociationException = require('../exceptions/association_exception'),
    cardinalities = require('../cardinalities');

/**
 * Checks the validity of the association.
 * @param {AssociationData} association the association to check.
 * @param {String} sourceName the source's name.
 * @param {String} destinationName the destination's name.
 * @throws NullPointerException if the association is nil.
 * @throws AssociationException if the association is invalid.
 */
exports.checkValidityOfAssociation = function(association, sourceName, destinationName) {
  if (!association || !association.type) {
    throw new NullPointerException('The association must not be nil.');
  }
  switch (association.type) {
    case cardinalities.ONE_TO_ONE:
      if (!association.injectedFieldInFrom) {
        throw new AssociationException(
          'In the One-to-One relationship from ' + sourceName + ' to ' + destinationName + ', '
          + 'the source entity must possess the destination in a One-to-One '
          + ' relationship, or you must invert the direction of the relationship.');
      }
      return;
    case cardinalities.ONE_TO_MANY:
      if (!association.injectedFieldInFrom || !association.injectedFieldInTo) {
        console.warn(
          chalk.yellow(
            'In the One-to-Many relationship from ' + sourceName + ' to ' + destinationName + ', '
            + 'only bidirectionality is supported for a One-to-Many association. '
            + 'The other side will be automatically added.'));
      }
      return;
    case cardinalities.MANY_TO_ONE:
      if (association.injectedFieldInFrom && association.injectedFieldInTo) {
        throw new AssociationException(
          'In the Many-to-One relationship from ' + sourceName + ' to ' + destinationName + ', '
          + 'only unidirectionality is supported for a Many-to-One relationship, '
          + 'you should create a bidirectional One-to-Many relationship instead.');
      }
      return;
    case cardinalities.MANY_TO_MANY:
      if (!association.injectedFieldInFrom || !association.injectedFieldInTo) {
        throw new AssociationException(
          'In the Many-to-Many relationship from ' + sourceName + ' to ' + destinationName + ', '
          + 'only bidirectionality is supported for a Many-to-Many relationship.');
      }
      return;
    default:
      throw new AssociationException(
        'The association type' + association.type + "isn't supported.");
  }
};