pl.chilldev.commons.text.Formatter Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of commons-text Show documentation

Text processing utilities.

There is a newer version: 0.4.4

/*
 * This file is part of the ChillDev-Commons.
 *
 * @license http://mit-license.org/ The MIT license
 * @copyright 2016 © by Rafał Wrzeszcz - Wrzasq.pl.
 */

package pl.chilldev.commons.text;

import java.util.HashMap;
import java.util.Map;

import pl.chilldev.commons.text.formatter.FormatterInterface;

/**
 * Text formats handler.
 */
public class Formatter
{
    /**
     * All known format handlers.
     */
    private Map formatters = new HashMap<>();

    /**
     * Registers format handler.
     *
     * @param format Format name.
     * @param handler Format handler.
     */
    public void registerFormatter(String format, FormatterInterface handler)
    {
        this.formatters.put(format, handler);
    }

    /**
     * Transforms text from given form.
     *
     * @param format Format name.
     * @param text Source text.
     * @return Generated markup snippet.
     * @throws TextProcessingException When specified format can't be handled or handler throws exception.
     */
    public String transform(String format, String text)
        throws
            TextProcessingException
    {
        if (!this.formatters.containsKey(format)) {
            throw new TextProcessingException(String.format("No handler for format \"%s\" registred.", format));
        }

        return this.formatters.get(format).transform(text);
    }
}