CronDescriptorTest.java

/*
 * Copyright 2015 jmrozanec
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.cronutils.utils.descriptor;

import com.cronutils.descriptor.CronDescriptor;
import com.cronutils.model.SingleCron;
import com.cronutils.model.definition.CronDefinition;
import com.cronutils.model.field.CronField;
import com.cronutils.model.field.CronFieldName;
import com.cronutils.model.field.constraint.FieldConstraints;
import com.cronutils.model.field.constraint.FieldConstraintsBuilder;
import com.cronutils.model.field.expression.Between;
import com.cronutils.model.field.expression.Every;
import com.cronutils.model.field.expression.FieldExpression;
import com.cronutils.model.field.expression.On;
import com.cronutils.model.field.value.IntegerFieldValue;
import com.cronutils.model.field.value.SpecialChar;
import com.cronutils.model.field.value.SpecialCharFieldValue;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.mockito.Mock;
import org.mockito.MockitoAnnotations;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Locale;

import static org.junit.jupiter.api.Assertions.assertEquals;

import com.cronutils.model.CronType;
import com.cronutils.model.definition.CronDefinitionBuilder;
import com.cronutils.parser.CronParser;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class CronDescriptorTest {
    private CronDescriptor descriptor;
    private FieldConstraints nullFieldConstraints;
    @Mock
    private CronDefinition mockDefinition;

    @BeforeEach
    public void setUp() {
        MockitoAnnotations.initMocks(this);
        descriptor = CronDescriptor.instance(Locale.UK);
        nullFieldConstraints =
                FieldConstraintsBuilder.instance()
                        .addHashSupport()
                        .addLSupport()
                        .addWSupport()
                        .createConstraintsInstance();
    }

    @Test
    public void testDescribeEveryXTimeUnits() {
        final int time = 3;
        final Every expression = new Every(new IntegerFieldValue(time));
        assertEquals(String.format("every %s seconds", time), descriptor.describe(
                new SingleCron(mockDefinition, Collections.singletonList(new CronField(CronFieldName.SECOND, expression, nullFieldConstraints)))
                )
        );
        assertEquals(String.format("every %s minutes", time), descriptor.describe(
                new SingleCron(mockDefinition, Collections.singletonList(new CronField(CronFieldName.MINUTE, expression, nullFieldConstraints)))
                )
        );
        final List<CronField> params = new ArrayList<>();
        params.add(new CronField(CronFieldName.HOUR, expression, nullFieldConstraints));
        params.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(time)), nullFieldConstraints));
        assertEquals(String.format("every %s hours at minute %s", time, time), descriptor.describe(new SingleCron(mockDefinition, params)));
    }

    @Test
    public void testDescribeEveryXMinutesBetweenTime() {
        final int hour = 11;
        final int start = 0;
        final int end = 10;
        final Between expression = new Between(new IntegerFieldValue(start), new IntegerFieldValue(end));
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.MINUTE, expression, nullFieldConstraints));
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        assertEquals(String.format("every minute between %s:%02d and %s:%02d", hour, start, hour, end), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testDescribeAtXTimeBetweenDaysOfWeek() {
        final int hour = 11;
        final int minute = 30;
        final int start = 2;
        final int end = 6;
        final Between expression = new Between(new IntegerFieldValue(start), new IntegerFieldValue(end));
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(minute)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.DAY_OF_WEEK, expression, nullFieldConstraints));
        assertEquals(String.format("at %s:%s every day between Tuesday and Saturday", hour, minute), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testDescribeAtXHours() {
        final int hour = 11;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.SECOND, FieldExpression.always(), nullFieldConstraints));
        assertEquals(String.format("at %s:00", hour), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testEverySecondInMonth() {
        final int month = 2;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.SECOND, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MONTH, new On(new IntegerFieldValue(month)), nullFieldConstraints));
        assertEquals("every second at February month", descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testEveryMinuteBetweenMonths() {
        final int monthStart = 2;
        final int monthEnd = 3;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, FieldExpression.always(), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MONTH, new Between(new IntegerFieldValue(monthStart), new IntegerFieldValue(monthEnd)), nullFieldConstraints));
        assertEquals("every minute every month between February and March", descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testLastDayOfWeekInMonth() {
        final int dayOfWeek = 2;
        final int hour = 10;
        final int minute = 15;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(minute)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.DAY_OF_WEEK, new On(new IntegerFieldValue(dayOfWeek), new SpecialCharFieldValue(SpecialChar.L)),
                nullFieldConstraints));
        assertEquals(String.format("at %s:%s last Tuesday of every month", hour, minute), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testNthDayOfWeekInMonth() {
        final int dayOfWeek = 2;
        final int hour = 10;
        final int minute = 15;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(minute)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.DAY_OF_WEEK,
                new On(new IntegerFieldValue(dayOfWeek), new SpecialCharFieldValue(SpecialChar.HASH), new IntegerFieldValue(dayOfWeek)), nullFieldConstraints));
        assertEquals(String.format("at %s:%s Tuesday %s of every month", hour, minute, dayOfWeek), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testLastDayOfMonth() {
        final int hour = 10;
        final int minute = 15;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(minute)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.DAY_OF_MONTH, new On(new SpecialCharFieldValue(SpecialChar.L)), nullFieldConstraints));
        assertEquals(String.format("at %s:%s last day of month", hour, minute), descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testNearestWeekdayToNthOfMonth() {
        final int dayOfMonth = 22;
        final int hour = 10;
        final int minute = 15;
        final List<CronField> results = new ArrayList<>();
        results.add(new CronField(CronFieldName.HOUR, new On(new IntegerFieldValue(hour)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.MINUTE, new On(new IntegerFieldValue(minute)), nullFieldConstraints));
        results.add(new CronField(CronFieldName.DAY_OF_MONTH, new On(new IntegerFieldValue(dayOfMonth), new SpecialCharFieldValue(SpecialChar.W)),
                nullFieldConstraints));
        assertEquals(String.format("at %s:%s the nearest weekday to the %s of the month", hour, minute, dayOfMonth),
                descriptor.describe(new SingleCron(mockDefinition, results)));
    }

    @Test
    public void testGetResourceBundle() {
        assertTrue(descriptor.getResourceBundle().containsKey("hours"));
        assertTrue(descriptor.getResourceBundle().containsKey("minutes"));
        assertTrue(descriptor.getResourceBundle().containsKey("seconds"));
    }

    @Test
    public void testDescribeDayOfMonthEveryXDays() {
        final String cronExpression = "0 0 0 3/5 * ? *";
        final CronParser parser = new CronParser(CronDefinitionBuilder.instanceDefinitionFor(CronType.QUARTZ));
        final String description = descriptor.describe(parser.parse(cronExpression));
        assertEquals("at 00:00 every 5 days from day 3", description);
    }
}