001/**
002 * Powerunit - A JDK1.8 test framework
003 * Copyright (C) 2014 Mathieu Boretti.
004 *
005 * This file is part of Powerunit
006 *
007 * Powerunit is free software: you can redistribute it and/or modify
008 * it under the terms of the GNU General Public License as published by
009 * the Free Software Foundation, either version 3 of the License, or
010 * (at your option) any later version.
011 *
012 * Powerunit is distributed in the hope that it will be useful,
013 * but WITHOUT ANY WARRANTY; without even the implied warranty of
014 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
015 * GNU General Public License for more details.
016 *
017 * You should have received a copy of the GNU General Public License
018 * along with Powerunit. If not, see <http://www.gnu.org/licenses/>.
019 */
020package ch.powerunit.comparator.lang;
021
022import java.util.Comparator;
023
024/**
025 * Specify the value that are less than another one.
026 * 
027 * @author borettim
028 * @since 0.3.0
029 * 
030 * @param <O>
031 *            The object of the comparator
032 * @param <C>
033 *            The comparator undertest
034 */
035public interface ComparatorTesterDSLLess<O, C extends Comparator<O>> extends
036                ComparatorTesterDSLEnd<O, C> {
037        /**
038         * Specify the values that are lesser.
039         * 
040         * @param lessSamples
041         *            the samples that are all less than all the ones specified
042         *            after. <b>All the passed samples must be ordered from the
043         *            smaller to the bigger</b>.
044         * @return {@link ComparatorTesterDSLEquals the next step of the DSL}
045         */
046        ComparatorTesterDSLEquals<O, C> withLessSamples(O... lessSamples);
047
048        /**
049         * Specify the values that are lesser.
050         * 
051         * @param first
052         *            the smaller value of all
053         * @return {@link ComparatorTesterDSLEquals the next step of the DSL}
054         */
055        ComparatorTesterDSLEquals<O, C> withLessSamples(O first);
056
057        /**
058         * Specify the values that are lesser.
059         * 
060         * @param first
061         *            the smaller value of all
062         * @param second
063         *            a value bigger than the previous
064         * @return {@link ComparatorTesterDSLEquals the next step of the DSL}
065         */
066        ComparatorTesterDSLEquals<O, C> withLessSamples(O first, O second);
067
068        /**
069         * Specify the values that are lesser.
070         * 
071         * @param first
072         *            the smaller value of all
073         * @param second
074         *            a value bigger than the previous
075         * @param third
076         *            a value bigger than the previous
077         * @return {@link ComparatorTesterDSLEquals the next step of the DSL}
078         */
079        ComparatorTesterDSLEquals<O, C> withLessSamples(O first, O second, O third);
080
081        /**
082         * Specify the values that are lesser.
083         * 
084         * @param first
085         *            the smaller value of all
086         * @param second
087         *            a value bigger than the previous
088         * @param third
089         *            a value bigger than the previous
090         * @param fourth
091         *            a value bigger than the previous
092         * @return {@link ComparatorTesterDSLEquals the next step of the DSL}
093         */
094        ComparatorTesterDSLEquals<O, C> withLessSamples(O first, O second, O third,
095                        O fourth);
096}