All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.anaptecs.spring.base.Leg Maven / Gradle / Ivy

There is a newer version: 1.24.2
Show newest version
/*
 * anaptecs GmbH, Ricarda-Huch-Str. 71, 72760 Reutlingen, Germany
 * 
 * Copyright 2004 - 2019. All rights reserved.
 */
package com.anaptecs.spring.base;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;

/**
 * @author JEAF Generator
 * @version JEAF Release 1.4.x
 */
public class Leg {
  /**
   * Constant for the name of attribute "start".
   */
  public static final String START = "start";

  /**
   * Constant for the name of attribute "stop".
   */
  public static final String STOP = "stop";

  /**
   * Constant for the name of attribute "stopovers".
   */
  public static final String STOPOVERS = "stopovers";

  /**
   * 
   */
  private PlaceRef start;

  /**
   * 
   */
  private PlaceRef stop;

  /**
   * 
   */
  private List stopovers = new ArrayList();

  /**
   * Default constructor is only intended to be used for deserialization as many frameworks required that. For "normal"
   * object creation builder should be used instead.
   */
  protected Leg( ) {
    // Nothing to do.
  }

  /**
   * Initialize object using the passed builder.
   * 
   * @param pBuilder Builder that should be used to initialize this object. The parameter must not be null.
   */
  protected Leg( Builder pBuilder ) {
    // Read attribute values from builder.
    start = pBuilder.start;
    stop = pBuilder.stop;
    if (pBuilder.stopovers != null) {
      stopovers.addAll(pBuilder.stopovers);
    }
  }

  /**
   * Class implements builder to create a new instance of class Leg. As the class has read only attributes or
   * associations instances can not be created directly. Instead this builder class has to be used.
   */
  public static class Builder {
    /**
     * 
     */
    private PlaceRef start;

    /**
     * 
     */
    private PlaceRef stop;

    /**
     * 
     */
    private List stopovers;

    /**
     * Use {@link #newBuilder()} instead of private constructor to create new builder.
     */
    protected Builder( ) {
    }

    /**
     * Use {@link #newBuilder(Leg)} instead of private constructor to create new builder.
     */
    protected Builder( Leg pObject ) {
      if (pObject != null) {
        // Read attribute values from passed object.
        start = pObject.start;
        stop = pObject.stop;
        stopovers = pObject.stopovers;
      }
    }

    /**
     * Method returns a new builder.
     * 
     * @return {@link Builder} New builder that can be used to create new ImmutablePOJOParent objects.
     */
    public static Builder newBuilder( ) {
      return new Builder();
    }

    /**
     * Method creates a new builder and initialize it with the data from the passed object.
     * 
     * @param pObject Object that should be used to initialize the builder. The parameter may be null.
     * @return {@link Builder} New builder that can be used to create new Leg objects. The method never returns null.
     */
    public static Builder newBuilder( Leg pObject ) {
      return new Builder(pObject);
    }

    /**
     * Method sets the association "start".
     * 
     * @param pStart PlaceRef to which the association "start" should be set.
     */
    public Builder setStart( PlaceRef pStart ) {
      start = pStart;
      return this;
    }

    /**
     * Method sets the association "stop".
     * 
     * @param pStop PlaceRef to which the association "stop" should be set.
     */
    public Builder setStop( PlaceRef pStop ) {
      stop = pStop;
      return this;
    }

    /**
     * Method sets the association "stopovers".
     * 
     * @param pStopovers Collection with objects to which the association should be set.
     */
    public Builder setStopovers( List pStopovers ) {
      // To ensure immutability we have to copy the content of the passed collection.
      if (pStopovers != null) {
        stopovers = new ArrayList(pStopovers);
      }
      else {
        stopovers = null;
      }
      return this;
    }

    /**
     * Method creates a new instance of class Leg. The object will be initialized with the values of the builder.
     * 
     * @return Leg Created object. The method never returns null.
     */
    public Leg build( ) {
      return new Leg(this);
    }
  }

  /**
   * Method returns the association "start".
   * 
   *
   * @return PlaceRef PlaceRef to which the association "start" is set.
   */
  public PlaceRef getStart( ) {
    return start;
  }

  /**
   * Method sets the association "start".
   * 
   * 
   * @param pStart PlaceRef to which the association "start" should be set.
   */
  public void setStart( PlaceRef pStart ) {
    start = pStart;
  }

  /**
   * Method unsets the association "start".
   * 
   */
  public final void unsetStart( ) {
    start = null;
  }

  /**
   * Method returns the association "stop".
   * 
   *
   * @return PlaceRef PlaceRef to which the association "stop" is set.
   */
  public PlaceRef getStop( ) {
    return stop;
  }

  /**
   * Method sets the association "stop".
   * 
   * 
   * @param pStop PlaceRef to which the association "stop" should be set.
   */
  public void setStop( PlaceRef pStop ) {
    stop = pStop;
  }

  /**
   * Method unsets the association "stop".
   * 
   */
  public final void unsetStop( ) {
    stop = null;
  }

  /**
   * Method returns the association "stopovers".
   * 
   *
   * @return Collection All PlaceRef objects that belong to the association "stopovers". The method never returns null
   * and the returned collection is unmodifiable.
   */
  public List getStopovers( ) {
    // Return all PlaceRef objects as unmodifiable collection.
    return Collections.unmodifiableList(stopovers);
  }

  /**
   * Method sets the association "stopovers" to the passed collection. All objects that formerly were part of the
   * association will be removed from it.
   * 
   * 
   * @param pStopovers Collection with objects to which the association should be set. The parameter must not be null.
   */
  void setStopovers( List pStopovers ) {
    // Check of parameter is not required.
    // Remove all objects from association "stopovers".
    this.clearStopovers();
    // If the association is null, removing all entries is sufficient.
    if (pStopovers != null) {
      stopovers = new ArrayList(pStopovers);
    }
  }

  /**
   * Method adds the passed PlaceRef object to the association "stopovers".
   * 
   * 
   * @param pStopovers Object that should be added to the association "stopovers". The parameter must not be null.
   */
  public void addToStopovers( PlaceRef pStopovers ) {
    // Add passed object to collection of associated PlaceRef objects.
    stopovers.add(pStopovers);
  }

  /**
   * Method adds all passed objects to the association "stopovers".
   * 
   * 
   * @param pStopovers Collection with all objects that should be added to the association "stopovers". The parameter
   * must not be null.
   */
  public void addToStopovers( Collection pStopovers ) {
    // Add all passed objects.
    for (PlaceRef lNextObject : pStopovers) {
      this.addToStopovers(lNextObject);
    }
  }

  /**
   * Method removes the passed PlaceRef object from the association "stopovers".
   * 
   * 
   * @param pStopovers Object that should be removed from the association "stopovers". The parameter must not be null.
   */
  public void removeFromStopovers( PlaceRef pStopovers ) {
    // Remove passed object from collection of associated PlaceRef objects.
    stopovers.remove(pStopovers);
  }

  /**
   * Method removes all objects from the association "stopovers".
   * 
   */
  public void clearStopovers( ) {
    // Remove all objects from association "stopovers".
    Collection lStopovers = new HashSet(stopovers);
    Iterator lIterator = lStopovers.iterator();
    while (lIterator.hasNext()) {
      this.removeFromStopovers(lIterator.next());
    }
  }

  /**
   * Method returns a StringBuilder that can be used to create a String representation of this object. the returned
   * StringBuilder also takes care about attributes of super classes.
   *
   * @return {@link StringBuilder} StringBuilder representing this object. The method never returns null.
   */
  protected StringBuilder toStringBuilder( ) {
    StringBuilder lBuilder = new StringBuilder();
    lBuilder.append(this.getClass().getName());
    lBuilder.append('\n');
    lBuilder.append("Attributes:");
    lBuilder.append('\n');
    return lBuilder;
  }

  /**
   * Method creates a new String with the values of all attributes of this class. All references to other objects will
   * be ignored.
   * 
   * @return {@link String} String representation of this object. The method never returns null.
   */
  @Override
  public String toString( ) {
    return this.toStringBuilder().toString();
  }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy