PlaceholderFinder.java

package pro.verron.officestamper.core;

import pro.verron.officestamper.api.Placeholder;

import java.util.ArrayList;
import java.util.List;
import java.util.regex.Pattern;

import static java.util.Collections.emptyList;

/**
 * The ExpressionFinder class is responsible
 * for finding expressions in a given text based on a specified pattern and matcher.
 * It uses the Matcher class
 * to determine if an expression matches the specified prefix and suffix,
 * and the Expression class to represent each found expression.
 */
public record PlaceholderFinder(
        Pattern pattern,
        Matcher matcher
) {
    /**
     * Finds expressions in a given text based on a specified pattern and matcher.
     *
     * @param text the text to search for expressions
     * @return a list of found expressions
     */
    public List<Placeholder> find(String text) {
        if (text.isEmpty())
            return emptyList();
        var matcher = pattern.matcher(text);
        int index = 0;
        List<Placeholder> matches = new ArrayList<>();
        while (matcher.find(index)) {
            String match = matcher.group();
            matches.add(new StandardPlaceholder(this.matcher, match));
            index = matcher.end();
        }
        return matches;
    }
}