Чистый код. Создание, анализ и рефакторинг

926     /**

927      * Возвращает true, если текущий объект SerialDate представляет более раннюю

928      * дату по сравнению с заданным объектом SerialDate.

929      *

930      * @param other  дата для сравнения.

931      *

932      * @return true, если текущий объект SerialDate представляет

933      *         более раннюю дату по сравнению с заданным объектом SerialDate.

934      */

935     public abstract boolean isBefore(SerialDate other);

936

937     /**

938      * Возвращает true, если текущий объект SerialDate представляет ту же

939      * дату, что и заданный объект SerialDate.

940      *

941      * @param other  дата для сравнения.

942      *

943      * @return true, если текущий объект SerialDate представляет

944      *          ту же дату, что и заданный объект SerialDate.

945      */

946     public abstract boolean isOnOrBefore(SerialDate other);

947

948     /**

949      * Возвращает true, если текущий объект SerialDate представляет ту же

950      * дату, что и заданный объект SerialDate.

951      *

952      * @param other  дата для сравнения.

953      *

954      * @return true, если текущий объект SerialDate представляет

955      *         ту же дату, что и заданный объект SerialDate.

956      */

957     public abstract boolean isAfter(SerialDate other);

958

959     /**

960      * Возвращает true, если текущий объект SerialDate представляет ту же

961      * дату, что и заданный объект SerialDate.

962      *

963      * @param other  дата для сравнения.

964      *

965      * @return true, если текущий объект SerialDate представляет

966      *         ту же дату, что и заданный объект SerialDate.

967      */

968     public abstract boolean isOnOrAfter(SerialDate other);

969

970     /**

971      * Возвращает true, если текущий {@link SerialDate} принадлежит

972      * заданному диапазону (режим INCLUSIVE).  Порядок дат d1 и d2

973      * не важен.

974      *

975      * @param d1  граничная дата диапазона.

976      * @param d2  другая граничная дата диапазона.

977      *

978      * @return Логический признак.

979      */

980     public abstract boolean isInRange(SerialDate d1, SerialDate d2);

981

982     /**

983      * Возвращает true если текущий {@link SerialDate} принадлежит

984      * заданному диапазону (включение границ указывается при вызове). Порядок

985      * дат d1 и d2 не важен.

986      *

987      * @param d1  граничная дата диапазона.

988      * @param d2  другая граничная дата диапазона.

Листинг Б.1 (продолжение)

989      * @param include  код, управляющий включением начальной и конечной дат