Merge pull request #815 from uhafner/line-range

Add `LineRange` and `LineRangeList` from analysis-model

src/main/java/edu/hm/hafner/util/LineRange.java

@@ -0,0 +1,98 @@
+package edu.hm.hafner.util;
+
+import java.io.Serializable;
+
+import edu.umd.cs.findbugs.annotations.CheckForNull;
+
+/**
+ * A line range in a source file is defined by its first and last line.
+ *
+ * @author Ullrich Hafner
+ */
+public class LineRange implements Serializable {
+    private static final long serialVersionUID = -4124143085672930110L;
+
+    private final int start;
+    private final int end;
+
+    /**
+     * Creates a new instance of {@link LineRange}.
+     *
+     * @param line
+     *            the single line of this range
+     */
+    public LineRange(final int line) {
+        this(line, line);
+    }
+
+    /**
+     * Creates a new instance of {@link LineRange}.
+     *
+     * @param start
+     *            start of the range
+     * @param end
+     *            end of the range
+     */
+    public LineRange(final int start, final int end) {
+        if (start <= 0) {
+            this.start = 0;
+            this.end = 0;
+        }
+        else if (start < end) {
+            this.start = start;
+            this.end = end;
+        }
+        else {
+            this.start = end;
+            this.end = start;
+        }
+    }
+
+    /**
+     * Returns the first line of this range.
+     *
+     * @return the first line of this range
+     */
+    public int getStart() {
+        return start;
+    }
+
+    /**
+     * Returns the last line of this range.
+     *
+     * @return the last line of this range
+     */
+    public int getEnd() {
+        return end;
+    }
+
+    @Override
+    public boolean equals(@CheckForNull final Object obj) {
+        if (this == obj) {
+            return true;
+        }
+        if (obj == null || getClass() != obj.getClass()) {
+            return false;
+        }
+
+        LineRange lineRange = (LineRange) obj;
+
+        if (start != lineRange.start) {
+            return false;
+        }
+        return end == lineRange.end;
+    }
+
+    @Override
+    public int hashCode() {
+        int result = start;
+        result = 31 * result + end;
+        return result;
+    }
+
+    @Override
+    public String toString() {
+        return String.format("[%d-%d]", start, end);
+    }
+}
+