* using the Apache Tika library. It extends {@link PasswordBasedExtractor} to handle password-protected files.
 * </p>
 *
 * <p>
 * This class provides methods to extract text from an input stream, handling different scenarios such as:
 * </p>
 * <ul>
 *   <li>Normalizing text content</li>
 *   <li>Handling resource names and content types</li>

 *   <li>ftpAuthentications: An array of {@link FtpAuthentication} objects for different FTP URLs.</li>
 * </ul>
 *
 * <p>
 * The class also supports FTP authentication via {@link FtpAuthenticationHolder}, which stores
 * authentication details for different FTP URLs.
 * </p>
 *
 * <p>
 * Usage example:
 * </p>
 *
 * <pre>
 * {@code

        assertArrayEquals(new String[] { "role1", "role2", "role3" }, suggestItem.getRoles());

        // Check kind
        assertNotNull(suggestItem.getKinds());
        // The kinds array structure might be different
        boolean hasUserKind = false;
        for (SuggestItem.Kind kind : suggestItem.getKinds()) {
            if (kind == SuggestItem.Kind.USER) {
                hasUserKind = true;
                break;

                extractFile(ent.getKey(), embeddedFile, writer);
            }
        }
    }

    /**
     * Gets the embedded file from a file specification, trying different platform-specific variants.
     * @param fileSpec the file specification
     * @return the embedded file, or null if not found
     */

     * @return The session ID.
     */
    public String getSessionId() {
        return crawlerContext.sessionId;
    }

    /**
     * Sets the session ID.
     * If the new session ID is different from the current one, it updates the session ID in the URL queue service.
     * @param sessionId The new session ID.
     */
    public void setSessionId(final String sessionId) {

          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,

        assertNotNull(mainStackTrace);
        assertNotNull(causeStackTrace);
        assertTrue(mainStackTrace.length > 0);
        assertTrue(causeStackTrace.length > 0);

        // Stack traces should be different
        assertNotSame(mainStackTrace, causeStackTrace);
    }

    /**
     * Test printStackTrace functionality
     */
    public void test_printStackTrace() {

          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,

        assertNull(data);
        assertEquals(1, testTransformer.getGetDataCallCount());
        assertNull(testTransformer.getLastAccessResultData());
    }

    /**
     * Test getData with different data types
     */
    public void test_getData_differentDataTypes() {
        // String data
        TestAccessResultData<String> stringData = new TestAccessResultData<>("string value".getBytes());

    /**
     * Test rule replacement scenario
     */
    public void test_ruleReplacement() {
        TestRule oldRule = new TestRule("rule1", false);
        TestRule newRule = new TestRule("rule1", true); // Same ID, different behavior

        ruleManager.addRule(oldRule);

        ResponseData responseData = new ResponseData();
        assertNull(ruleManager.getRule(responseData)); // Old rule doesn't match