pro.verron.officestamper.core.PlaceholderFinder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of engine Show documentation

Office-stamper is a Java template engine for docx documents, forked from org.wickedsource.docx-stamper

There is a newer version: 2.6.0

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 find(String text) {
        if (text.isEmpty())
            return emptyList();
        var matcher = pattern.matcher(text);
        int index = 0;
        List matches = new ArrayList<>();
        while (matcher.find(index)) {
            String match = matcher.group();
            matches.add(new StandardPlaceholder(this.matcher, match));
            index = matcher.end();
        }
        return matches;
    }
}