tools.vitruv.dsls.demo.familiespersons.families2persons.FamiliesToPersonsHelper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of tools.vitruv.dsls.demo.familiespersons Show documentation
A demo for the Vitruv framework based on the families and persons metamodels
The newest version!
package tools.vitruv.dsls.demo.familiespersons.families2persons;

import edu.kit.ipd.sdq.activextendannotations.Utility;
import edu.kit.ipd.sdq.metamodels.families.FamiliesUtil;
import edu.kit.ipd.sdq.metamodels.families.Family;
import edu.kit.ipd.sdq.metamodels.families.Member;
import edu.kit.ipd.sdq.metamodels.persons.Female;
import edu.kit.ipd.sdq.metamodels.persons.Male;
import edu.kit.ipd.sdq.metamodels.persons.Person;

@Utility
@SuppressWarnings("all")
public final class FamiliesToPersonsHelper {
  public static final String EXCEPTION_MESSAGE_FIRSTNAME_NULL = "A member\'s firstname is not allowed to be null.";

  public static final String EXCEPTION_MESSAGE_FIRSTNAME_WHITESPACE = "A member\'s firstname has to contain at least one non-whitespace character.";

  public static final String EXCEPTION_MESSAGE_FIRSTNAME_ESCAPES = "A member\'s firstname cannot contain any whitespace escape sequences.";

  /**
   * Returns the name of a Person corresponding to a Member. By convention, Persons whose fullname
   *  do not contain a space (" ") to separate firstname and lastname are inserted into a Family with
   *  an empty lastname. Therefore, Persons have to be named accordingly to keep both models consistent.
   * 
   *  @param member Member from which a corresponding Person should be given a correct name.
   *  @return Name that the corresponding Person from the persons model should have.
   */
  public static String getPersonName(final Member member) {
    final Family family = FamiliesUtil.getFamily(member);
    String _firstName = member.getFirstName();
    final StringBuilder personNameBuilder = new StringBuilder(_firstName);
    boolean _equals = family.getLastName().equals("");
    boolean _not = (!_equals);
    if (_not) {
      personNameBuilder.append(" ").append(family.getLastName());
    }
    return personNameBuilder.toString();
  }

  /**
   * Checks if a members firstname is null, empty or contains escape sequences.
   * These first names are not valid for members, since single names for persons are always interpreted
   * as firstnames and if needed, lastnames are set to "". Since empty fullnames for persons
   * are not allowed but empty lastnames for families are, a member's firstname can not be allowed to be
   * empty to avoid conversions between the models which lead to invalid models.
   * @param member The member whose firstname is checked
   * @throws IllegalArgumentException if firstname is not valid
   */
  public static void assertValidFirstname(final Member member) {
    String _firstName = member.getFirstName();
    boolean _tripleEquals = (_firstName == null);
    if (_tripleEquals) {
      throw new IllegalStateException(FamiliesToPersonsHelper.EXCEPTION_MESSAGE_FIRSTNAME_NULL);
    } else {
      boolean _isEmpty = member.getFirstName().trim().isEmpty();
      if (_isEmpty) {
        throw new IllegalStateException(FamiliesToPersonsHelper.EXCEPTION_MESSAGE_FIRSTNAME_WHITESPACE);
      } else {
        if (((member.getFirstName().contains("\n") || member.getFirstName().contains("\t")) || member.getFirstName().contains("\r"))) {
          throw new IllegalStateException(FamiliesToPersonsHelper.EXCEPTION_MESSAGE_FIRSTNAME_ESCAPES);
        }
      }
    }
  }

  /**
   * Checks if a person is a Male and throws an exception if not to indicate an unsupported operation
   * when the user tries to assign a member with a female corresponding person to a position inside a family
   * which requires no or a male corresponding person. For example is the user tries to assign a former
   * mother to be a father from now on, this is considered an unsupported operation.
   * @param person The person which is supposed to be a Male.
   * @throws UnsupportedOperationException if the person is not a Male.
   */
  public static void assertMale(final Person person) {
    if ((!(person instanceof Male))) {
      throw new UnsupportedOperationException(
        "The position of a male family member can only be assigned to members with no or a male corresponding person.");
    }
  }

  /**
   * Checks if a person is a Female and throws an exception if not to indicate an unsupported operation
   * when the user tries to assign a member with a male corresponding person to a position inside a family
   * which requires no or a female corresponding person. For example is the user tries to assign a former
   * father to be a mother from now on, this is considered an unsupported operation.
   * @param person The person which is supposed to be a Female.
   * @throws UnsupportedOperationException if the person is not a Female.
   */
  public static void assertFemale(final Person person) {
    if ((!(person instanceof Female))) {
      throw new UnsupportedOperationException(
        "The position of a female family member can only be assigned to members with no or a female corresponding person.");
    }
  }

  private FamiliesToPersonsHelper() {
    
  }
}