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);
    }

- **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");

     */
    public ReadingConverter getReadingConverter() {
        return readingConverter;
    }

    /**
     * Returns the Normalizer instance.
     * @return The Normalizer instance.
     */
    public Normalizer getNormalizer() {
        return normalizer;
    }

    /**
     * Creates a default SuggestIndexer instance.
     * @return A SuggestIndexer instance.
     */

        return this;
    }

    /**
     * Sets the normalizer.
     * @param normalizer The normalizer.
     * @return This builder instance.
     */
    public SuggesterBuilder normalizer(final Normalizer normalizer) {
        this.normalizer = normalizer;
        return this;
    }

    /**
     * Sets the analyzer.
     * @param analyzer The analyzer.