url = "http://hoge/index.html";
        assertEquals(url, htmlTransformer.normalizeUrl(url));

        url = "http://hoge/index.html?a=1";
        assertEquals(url, htmlTransformer.normalizeUrl(url));

        url = "http://hoge/index.html?a=1&b=2";
        assertEquals(url, htmlTransformer.normalizeUrl(url));

            final String childUrlValue = attrValue.trim();
            final URI childUri = childUrlValue.startsWith("?") ? new URI(uri.toString() + childUrlValue) : uri.resolve(childUrlValue);
            final String u = encodeUrl(normalizeUrl(childUri.toString()), encoding);
            if (logger.isDebugEnabled()) {
                logger.debug("{} -> {}", attrValue, u);
            }
            if (StringUtil.isNotBlank(u)) {

            final URI childUri = uri.resolve(resolveTarget);
            u = encodeUrl(normalizeUrl(childUri.toString()), encoding);
        } catch (final IllegalArgumentException e) {
            final int pos = urlValue.indexOf(':');
            if (pos > 0 && pos < 10) {
                u = encodeUrl(normalizeUrl(urlValue), encoding);
            }
        }

        if (u == null) {

        NormalizerChain chain = new NormalizerChain();
        Normalizer normalizer1 = (text, field, langs) -> text + "-1";
        Normalizer normalizer2 = (text, field, langs) -> text + "-2";
        Normalizer normalizer3 = (text, field, langs) -> text + "-3";

        chain.add(normalizer1);
        chain.add(normalizer2);
        chain.add(normalizer3);

        String result = chain.normalize("test", "field");

    }

    /**
     * Adds a normalizer to the chain.
     * @param normalizer The normalizer to add.
     * @throws IllegalArgumentException if normalizer is null
     */
    public void add(final Normalizer normalizer) {
        if (normalizer == null) {
            throw new IllegalArgumentException("normalizer must not be null");
        }
        normalizers.add(normalizer);
    }

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.suggest.normalizer;

/**
 * An interface for normalizing text.
 * Implementations of this interface should provide a method to normalize
 * a given text based on the specified field and optional language parameters.
 */
public interface Normalizer {
    /**
     * Normalizes the given text.
     * @param text The text to normalize

- **Multi-language Support**: Built-in support for Japanese text processing with Kuromoji analyzer
- **Popular Words Analytics**: Track and analyze frequently searched terms
- **Flexible Text Processing**: Configurable converters and normalizers for text transformation
- **OpenSearch Integration**: Seamless integration with OpenSearch/Elasticsearch clusters
- **Asynchronous Operations**: Non-blocking suggestion requests with callback support

    }

    /**
     * Creates a default normalizer using the provided client and suggest settings.
     * The normalizer chain includes an AnalyzerNormalizer.
     *
     * @param client the client to be used for creating the normalizer
     * @param settings the suggest settings to be used for creating the normalizer
     * @return a NormalizerChain with the default normalizers
     */

│   └── popularwords/          # Popular word queries
├── settings/                   # Configuration management
├── entity/                     # Domain models (SuggestItem, etc.)
├── normalizer/                 # Text normalizers
├── converter/                  # Reading converters (katakana, romaji)
├── concurrent/                 # Async patterns (Deferred/Promise)
└── util/                      # Utilities
```

        HankakuKanaToZenkakuKana normalizer = new HankakuKanaToZenkakuKana();

        String result = normalizer.normalize("ｱｲｳｴｵ", "field");

        assertEquals("アイウエオ", result);
    }

    @Test
    public void test_voicedSounds() throws Exception {
        HankakuKanaToZenkakuKana normalizer = new HankakuKanaToZenkakuKana();

        String result = normalizer.normalize("ｶﾞｷﾞｸﾞｹﾞｺﾞ", "field");