com.github.mvysny.kaributesting.v8.SearchSpecJ Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of karibu-testing-v8 Show documentation
Karibu Testing, support for browserless Vaadin testing in Kotlin
The newest version!
package com.github.mvysny.kaributesting.v8;

import com.vaadin.ui.Component;

import kotlin.jvm.functions.Function1;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

import java.util.function.Predicate;

import kotlin.ranges.IntRange;

/**
 * A criterion for matching components. The component must match all of non-null fields.
 * @author mavi
 */
public class SearchSpecJ {
    @NotNull
    private final SearchSpec spec;

    public SearchSpecJ(@NotNull SearchSpec spec) {
        this.spec = spec;
    }

    /**
     * The required Component.getId; if {@code null}, no particular id is matched.
     * @param id the id
     * @return this
     */
    @NotNull
    public SearchSpecJ withId(@Nullable String id) {
        spec.setId(id);
        return this;
    }

    /**
     * The required {@link Component#getCaption()}; if {@code null}, no particular caption is matched.
     * @param caption the expected caption
     * @return this
     */
    @NotNull
    public SearchSpecJ withCaption(@Nullable String caption) {
        spec.setCaption(caption);
        return this;
    }

    /**
     * The required {@link BasicUtilsKt#getValue(Component)}. If {@code null}, no particular value is matched.
     * @param value the expected value
     * @return this
     */
    @NotNull
    public SearchSpecJ withValue(@Nullable Object value) {
        spec.setValue(value);
        return this;
    }

    /**
     * The required {@link BasicUtilsKt#getPlaceholder(Component)}; if {@code null}, no particular placeholder is matched.
     * @param placeholder the expected placeholder
     * @return this
     */
    @NotNull
    public SearchSpecJ withPlaceholder(@Nullable String placeholder) {
        spec.setPlaceholder(placeholder);
        return this;
    }

    /**
     * If not null, the component must match all of these styles. Space-separated.
     * @param styles expected space-separated styles.
     * @return this
     */
    @NotNull
    public SearchSpecJ withStyles(@Nullable String styles) {
        spec.setStyles(styles);
        return this;
    }

    /**
     * If not null, the component must NOT match any of these styles. Space-separated.
     * @param styles expected space-separated styles, neither of which must be present on the component.
     * @return this
     */
    @NotNull
    public SearchSpecJ withoutStyles(@Nullable String styles) {
        spec.setWithoutStyles(styles);
        return this;
    }

    /**
     * expected count of matching components, defaults to {@code 0..Int.MAX_VALUE}
     * @param count expected count of matching components. Any count of component within this range is accepted.
     * @return this
     */
    @NotNull
    public SearchSpecJ withCount(@NotNull IntRange count) {
        spec.setCount(count);
        return this;
    }

    /**
     * Expected count of matching components, defaults to {@code 0..Int.MAX_VALUE}
     * @param count expected count
     * @return this
     */
    @NotNull
    public SearchSpecJ withCount(int count) {
        return withCount(count, count);
    }

    /**
     * Expected count of matching components, defaults to {@code 0..Int.MAX_VALUE}
     * @param min minimum count, inclusive
     * @param max maximum count, inclusive
     * @return this
     */
    @NotNull
    public SearchSpecJ withCount(int min, int max) {
        if (min > max) {
            throw new IllegalArgumentException("Parameter min: invalid value " + min + ": must be less than or equal to max: " + max);
        }
        return withCount(new IntRange(min, max));
    }

    /**
     * Adds an additional predicate which the component needs to match. Not null.
     * 
     * Please remember to provide a proper {@link Object#toString()} for the predicate,
     * so that you'll get an informative error message on lookup failure.
     * @param predicate the predicate
     * @return this
     */
    @NotNull
    public SearchSpecJ withPredicate(@NotNull Predicate predicate) {
        spec.getPredicates().add(predicate);
        return this;
    }

    @Override
    public String toString() {
        return spec.toString();
    }

    /**
     * Returns a predicate which matches components based on this spec. All rules are matched, except the {@link #withCount(int)} rule. The
     * rules are matched against given component only (not against its children).
     */
    @NotNull
    public Predicate toPredicate() {
        final Function1 predicate = spec.toPredicate();
        final String toString = spec.toString();
        return new Predicate() {
            @Override
            public boolean test(Component component) {
                return predicate.invoke(component);
            }

            @Override
            public String toString() {
                return toString;
            }
        };
    }
}