org.eclipse.linuxtools.tmf/src/org/eclipse/linuxtools/tmf/event/TmfTimeRange.java

   1 /*******************************************************************************
   2  * Copyright (c) 2009 Ericsson
   3  *
   4  * All rights reserved. This program and the accompanying materials are
   5  * made available under the terms of the Eclipse Public License v1.0 which
   6  * accompanies this distribution, and is available at
   7  * http://www.eclipse.org/legal/epl-v10.html
   8  *
   9  * Contributors:
  10  *   Francois Chouinard - Initial API and implementation
  11  *******************************************************************************/
  12
  13 package org.eclipse.linuxtools.tmf.event;
  14
  15 /**
  16  * <b><u>TmfTimeRange</u></b>
  17  * <p>
  18  * A utility class to define time ranges.
  19  */
  20 public class TmfTimeRange {
  21
  22         // ------------------------------------------------------------------------
  23     // Constants
  24         // ------------------------------------------------------------------------
  25
  26         public static final TmfTimeRange Eternity = new TmfTimeRange(TmfTimestamp.BigBang, TmfTimestamp.BigCrunch);
  27
  28         // ------------------------------------------------------------------------
  29     // Attributes
  30         // ------------------------------------------------------------------------
  31
  32         private final TmfTimestamp fStartTime;
  33         private final TmfTimestamp fEndTime;
  34
  35         // ------------------------------------------------------------------------
  36     // Constructors
  37         // ------------------------------------------------------------------------
  38
  39         @SuppressWarnings("unused")
  40         private TmfTimeRange() {
  41                 throw new AssertionError();
  42         }
  43
  44         /**
  45          * @param startTime
  46          * @param endTime
  47          */
  48         public TmfTimeRange(TmfTimestamp startTime, TmfTimestamp endTime) {
  49                 if (startTime == null || endTime == null) {
  50                 throw new IllegalArgumentException();
  51                 }
  52                 fStartTime =  new TmfTimestamp(startTime);
  53                 fEndTime   =  new TmfTimestamp(endTime);
  54         }
  55
  56         /**
  57          * Copy constructor
  58          * @param other
  59          */
  60         public TmfTimeRange(TmfTimeRange other) {
  61         if (other == null) {
  62                 throw new IllegalArgumentException();
  63         }
  64                 fStartTime = new TmfTimestamp(other.fStartTime);
  65                 fEndTime   = new TmfTimestamp(other.fEndTime);
  66         }
  67
  68         // ------------------------------------------------------------------------
  69     // Accessors
  70         // ------------------------------------------------------------------------
  71
  72         /**
  73          * @return The time range start time
  74          */
  75         public TmfTimestamp getStartTime() {
  76                 return new TmfTimestamp(fStartTime);
  77         }
  78
  79         /**
  80          * @return The time range end time
  81          */
  82         public TmfTimestamp getEndTime() {
  83                 return new TmfTimestamp(fEndTime);
  84         }
  85
  86         // ------------------------------------------------------------------------
  87     // Predicates
  88         // ------------------------------------------------------------------------
  89
  90         /**
  91          * Check if the timestamp is within the time range
  92          *
  93          * @param ts
  94          * @return
  95          */
  96         public boolean contains(TmfTimestamp ts) {
  97                 return (fStartTime.compareTo(ts, true) <= 0) && (fEndTime.compareTo(ts, true) >= 0);
  98         }
  99
 100         /**
 101          * Check if the time range is within the time range
 102          *
 103          * @param range
 104          * @return
 105          */
 106         public boolean contains(TmfTimeRange range) {
 107                 TmfTimestamp startTime = range.getStartTime();
 108                 TmfTimestamp endTime   = range.getEndTime();
 109                 return (fStartTime.compareTo(startTime, true) <= 0) && (fEndTime.compareTo(endTime, true) >= 0);
 110         }
 111
 112         // ------------------------------------------------------------------------
 113     // Object
 114         // ------------------------------------------------------------------------
 115
 116         @Override
 117     public int hashCode() {
 118                 int result = 17;
 119                 result = 37 * result + fStartTime.hashCode();
 120                 result = 37 * result + fEndTime.hashCode();
 121         return result;
 122     }
 123
 124         @Override
 125     public boolean equals(Object other) {
 126         if (!(other instanceof TmfTimeRange))
 127                 return false;
 128                 TmfTimeRange range = (TmfTimeRange) other;
 129                 return range.fStartTime.equals(fStartTime) && range.fEndTime.equals(fEndTime);
 130     }
 131
 132         @Override
 133         public String toString() {
 134                 return "[TmfTimeRange(" + fStartTime + ":" + fEndTime + ")]";
 135         }
 136
 137 }