org.opentcs.util.Comparators Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opentcs-common Show documentation
openTCS-Common
There is a newer version: 6.4.0
/**
 * Copyright (c) The openTCS Authors.
 *
 * This program is free software and subject to the MIT license. (For details,
 * see the licensing information (LICENSE.txt) you should have received with
 * this copy of the software.)
 */
package org.opentcs.util;

import java.util.Comparator;
import org.opentcs.data.TCSObject;
import org.opentcs.data.TCSObjectReference;
import org.opentcs.data.order.TransportOrder;
import org.opentcs.data.peripherals.PeripheralJob;
import org.opentcs.util.annotations.ScheduledApiChange;

/**
 * Some commonly used comparator implementations.
 *
 * @author Stefan Walter (Fraunhofer IML)
 */
public final class Comparators {

  /**
   * A Comparator for ordering TCSObjects ascendingly
   * by their names.
   */
  private static final Comparator> OBJECTS_BY_NAME
      = (TCSObject o1, TCSObject o2) -> o1.getName().compareTo(o2.getName());
  /**
   * A Comparator for ordering TCSObjectReferences ascendingly
   * by their names.
   */
  private static final Comparator> REFERENCES_BY_NAME
      = (TCSObjectReference o1, TCSObjectReference o2) -> o1.getName().compareTo(o2.getName());
  /**
   * A comparator for sorting transport orders by their age, with the oldest ones coming first.
   */
  private static final Comparator ORDERS_BY_AGE
      = (TransportOrder o1, TransportOrder o2) -> {
        if (o1.getCreationTime().isBefore(o2.getCreationTime())) {
          return -1;
        }
        else if (o1.getCreationTime().isAfter(o2.getCreationTime())) {
          return 1;
        }
        else {
          return OBJECTS_BY_NAME.compare(o1, o2);
        }
      };
  /**
   * A comparator for sorting transport orders by their deadline, with those with the earliest
   * deadline coming first.
   * If two orders have exactly the same deadline, they are sorted by their (unique) creation
   * times, with the older one coming first.
   */
  private static final Comparator ORDERS_BY_DEADLINE
      = (TransportOrder o1, TransportOrder o2) -> {
        if (o1.getDeadline().isBefore(o2.getDeadline())) {
          return -1;
        }
        else if (o1.getDeadline().isAfter(o2.getDeadline())) {
          return 1;
        }
        else {
          return ORDERS_BY_AGE.compare(o1, o2);
        }
      };
  /**
   * A comparator for sorting peripheral jobs by their age, with the oldest ones coming first.
   */
  private static final Comparator JOBS_BY_AGE
      = (PeripheralJob o1, PeripheralJob o2) -> {
        if (o1.getCreationTime().isBefore(o2.getCreationTime())) {
          return -1;
        }
        else if (o1.getCreationTime().isAfter(o2.getCreationTime())) {
          return 1;
        }
        else {
          return OBJECTS_BY_NAME.compare(o1, o2);
        }
      };
  /**
   * Compares ModelLayoutElements by the names of their visualized objects.
   */
  @Deprecated
  private static final Comparator LAYOUT_ELEMS_BY_NAME
      = (org.opentcs.data.model.visualization.ModelLayoutElement o1,
          org.opentcs.data.model.visualization.ModelLayoutElement o2)
      -> o1.getVisualizedObject().getName().compareTo(
          o2.getVisualizedObject().getName());

  /**
   * Prevents undesired instantiation.
   */
  private Comparators() {
  }

  /**
   * Returns a comparator for ordering TCSObjects ascendingly
   * by their names.
   *
   * @return A comparator for ordering TCSObjects ascendingly
   * by their names.
   */
  public static Comparator> objectsByName() {
    return OBJECTS_BY_NAME;
  }

  /**
   * Returns a comparator for ordering TCSObjectReferences ascendingly
   * by their names.
   *
   * @return A comparator for ordering TCSObjectReferences ascendingly
   * by their names.
   */
  public static Comparator> referencesByName() {
    return REFERENCES_BY_NAME;
  }

  /**
   * A comparator for sorting transport orders by their priority, with those
   * with the highest priority coming first.
   * Transport orders are sorted by their deadlines first; if two orders have
   * exactly the same deadline, they are sorted by their (unique) creation
   * times, with the older one coming first.
   *
   * @return A comparator for sorting transport orders by their priority.
   */
  public static Comparator ordersByDeadline() {
    return ORDERS_BY_DEADLINE;
  }

  /**
   * A comparator for sorting transport orders by their age, with the oldest
   * ones coming first.
   *
   * @return A comparator for sorting transport orders by their age.
   */
  public static Comparator ordersByAge() {
    return ORDERS_BY_AGE;
  }

  /**
   * A comparator for sorting peripheral jobs by their age, with the oldest ones coming first.
   *
   * @return A comparator for sorting peripheral jobs by their age.
   */
  public static Comparator jobsByAge() {
    return JOBS_BY_AGE;
  }

  /**
   * A comparator for ordering ModelLayoutElements by the names of their
   * visualized objects.
   *
   * @return A comparator for ordering ModelLayoutElements by the names of their
   * visualized objects.
   */
  @Deprecated
  @ScheduledApiChange(details = "Will be removed.", when = "6.0")
  public static Comparator modelLayoutElementsByName() {
    return LAYOUT_ELEMS_BY_NAME;
  }
}