Class Builder

src/main/java/com/lodborg/intervaltree/Interval.java:655–738

Used to create new intervals in an intuitive fashion by using the builder pattern. Since the implementation of the Interval class strives to avoid reflexion, despite being generic class, the Builder inner class is not static. Instead it is always tied to a particular object, so that

	 * specific runtime type.
	 */
	public class Builder {
		private Interval<T> interval;

		/**
		 * {@code private} constructor, used only in the internals of the {@link Interval}
		 * class. You can create new instances of the class by using either an existing
		 * object:
		 * <pre>existingInterval.builder()</pre>
		 * or by instantiating an "everything" interval with the default constructor and
		 * calling its {@link Interval#builder() builder} method:
		 * <pre>new IntegerInterval().builder()</pre>
		 *
		 * @param ref A reference object used only to determine the runtime type of the
		 *            new object. The reference interval doesn't influence the start and
		 *            end points of the new interval in any way.
		 */
		private Builder(Interval<T> ref){
			interval = ref.create();
		}

		/**
		 * Sets the start point of the currently building interval to the given value.
		 * The interval will be open to the left. If this method is called more than
		 * once or in conjunction with the {@link #greaterEqual(Comparable)} method, only
		 * the last call in the subsequence will take effect.
		 *
		 * @param start The value for the start point of the new interval.
		 */
		public Builder greater(T start){
			interval.start = start;
			interval.isStartInclusive = false;
			return this;
		}

		/**
		 * Sets the start point of the currently building interval to the given value.
		 * The interval will be closed to the left. If this method is called more than
		 * once or in conjunction with the {@link #greater(Comparable)} method, only
		 * the last call in the subsequence will take effect.
		 *
		 * @param start The value for the start point of the new interval.
		 */
		public Builder greaterEqual(T start){
			interval.start = start;
			interval.isStartInclusive = true;
			return this;
		}

		/**
		 * Sets the end point of the currently building interval to the given value.
		 * The interval will be open to the right. If this method is called more than
		 * once or in conjunction with the {@link #lessEqual(Comparable)} method, only
		 * the last call in the subsequence will take effect.
		 *
		 * @param end The value for the end point of the new interval.
		 */
		public Builder less(T end){
			interval.end = end;