```

## Troubleshooting

### Common Issues

**Index Creation Fails**
- Verify OpenSearch cluster is accessible
- Check index permissions and mappings
- Ensure sufficient cluster resources

**Suggestions Not Appearing**
- Confirm documents are indexed: `suggester.refresh()`
- Check query formatting and filters
- Verify analyzer configurations

**Performance Issues**
- Increase thread pool size in SuggesterBuilder

 * It also provides a method to retrieve the extracted data as a String from an AccessResultData object.
 *
 * <p>
 * The class handles character encoding issues by attempting to use the specified charset.
 * If the specified charset is invalid, it falls back to UTF-8.
 * </p>
 *
 * <p>

     *  The implementation of this is a little slow, since it creates
     *  a number of objects each time it is called.  This could be optimized
     *  to keep the same objects around, but then thread-safety issues would arise.
     *
     *  @param contextNode The node to start searching from.
     *  @param expression A valid XPath string.

            longUrl.append("very/long/path/segment/");
        }
        longUrl.append("file.html");

        urlFilter.addInclude("https://example.com/.*");

        // Should handle long URLs without issues
        assertTrue(urlFilter.match(longUrl.toString()));
    }

    /**
     * Test internationalized domain names (IDN)
     */
    public void test_internationalizedDomainNames() {

        try {
            List<String> results = langConverter.convert("test", "content");
            assertNotNull(results);
        } catch (Exception e) {
            // Null language might cause issues with analyzer lookup
            assertNotNull(e);
        }
    }

    @Test
    public void testConvertWithNumbersAndSymbols() throws IOException {
        // Test convert with numbers and symbols

import org.apache.lucene.store.ByteArrayDataInput;
import org.apache.lucene.util.BytesRef;
import org.apache.lucene.util.CharsRef;
import org.apache.lucene.util.UnicodeUtil;
import org.apache.lucene.util.fst.FST;

// https://issues.apache.org/jira/browse/LUCENE-5252
public final class NGramSynonymTokenizer extends Tokenizer {

    public static final int DEFAULT_N_SIZE = 2;

    public static final String DEFAULT_DELIMITERS = " 　\t\n\r";