request.addRole(role);
        return this;
    }

    /**
     * Adds a field to filter by.
     * @param field The field name.
     * @return This builder instance.
     */
    public PopularWordsRequestBuilder addField(final String field) {
        request.addField(field);
        return this;
    }

    /**
     * Adds a language to filter by.
     * @param lang The language.

                + "<doc>\n"//
                + "<field name=\"title\"><list><item>タイトル</item></list></field>\n"//
                + "<field name=\"body\"><list><item>第一章 第一節 ほげほげふがふが LINK 第2章 第2節</item></list></field>\n"//
                + "<field name=\"pcount\">2.0</field>\n"//
                + "<field name=\"true\">true</field>\n"//
                + "<field name=\"false\">false</field>\n"//
                + "</doc>";

        for (final ReadingConverter converter : converters) {
            converter.init();
        }
    }

    @Override
    public List<String> convert(final String text, final String field, final String... lang) throws IOException {
        final Queue<String> queue = new LinkedList<>();
        queue.add(text);
        final List<String> convertedTexts = new ArrayList<>(getMaxReadingNum());

        request.addRole(role);
        return this;
    }

    /**
     * Adds a field to filter by.
     * @param field The field name.
     * @return This builder instance.
     */
    public SuggestRequestBuilder addField(final String field) {
        request.addField(field);
        return this;
    }

    /**
     * Adds a kind to filter by.
     * @param kind The kind.

                + "<field name=\"email\"><list><item></item><item>******@****.***</item></list></field>\n"//
                + "<field name=\"url\">http://www.taro.com/</field>\n"//
                + "<field name=\"tel\">090-xxxx-xxxx</field>\n"//
                + "</doc>";

        final ResponseData responseData = new ResponseData();
        responseData.setResponseBody(ResourceUtil.getResourceAsFile("extractor/test.xml"), false);

#### Archives and Compressed Files
- ZIP, TAR, GZ archives
- LHA compression format
- Nested archive extraction

#### Web and Markup
- HTML, XHTML with XPath support
- XML documents
- JSON and structured data

#### Media Files
- Audio formats (MP3, WAV, FLAC)
- Video formats (MP4, AVI, MOV)
- Metadata extraction from media files

## Architecture

### Multi-Module Structure

            builder.field(SESSION_ID, sessionId);
        }
        if (method != null) {
            builder.field(METHOD, method);
        }
        if (url != null) {
            builder.field(URL, url);
        }
        if (parentUrl != null) {
            builder.field(PARENT_URL, parentUrl);
        }
        if (depth != null) {
            builder.field(DEPTH, depth);
        }

    /**
     * Analyzes the given text and returns a list of tokens.
     *
     * @param text the text to analyze
     * @param field the field associated with the text
     * @param lang the language of the text
     * @return a list of analyzed tokens
     */
    List<AnalyzeToken> analyze(String text, String field, String lang);

    /**
     * Analyzes the given text and returns a list of tokens along with their readings.
     *

     */
    void init() throws IOException;

    /**
     * Converts the given text into a list of readings based on the specified field and languages.
     *
     * @param text the text to be converted.
     * @param field the field to be used for conversion.
     * @param langs the languages to be used for conversion.
     * @return a list of readings for the given text.

    }

    /**
     * Test protected field access
     */
    public void test_protectedFieldAccess() {
        TestTransformer transformer = new TestTransformer();

        // Direct field access (simulating subclass behavior)
        transformer.name = "directFieldAccess";
        assertEquals("directFieldAccess", transformer.getName());

        // Setter should update the field
        transformer.setName("setterAccess");