* <p>
 * The {@link #getData(AccessResultData)} method allows retrieving the transformed data as a String (XML content),
 * a Map, or an instance of a specified class.
 * </p>
 *
 * <p>
 * Example usage:
 * </p>
 *
 * <pre>
 * XpathTransformer transformer = new XpathTransformer();
 * transformer.addFieldRule("title", "//title/text()");
 * transformer.addFieldRule("body", "//body/p/text()");
 *

/**
 * Character mapping file handler for managing character mapping dictionaries.
 * This class provides functionality to load, parse, and manage character mapping
 * rules that define how input characters should be transformed to output characters
 * during text analysis and search processing.
 *
 * Character mapping files contain mapping rules in the format:
 * input1,input2,... => output
 */

                accessResult.setAccessResultData(null);
                try {
                    final Transformer transformer = ComponentUtil.getComponent(accessResultData.getTransformerName());
                    if (transformer == null) {
                        // no transformer
                        logger.warn("Transformer not found: name={}, url={}", accessResultData.getTransformerName(), accessResult.getUrl());

        TestTransformer transformer1 = new TestTransformer();
        NameTrackingTransformer transformer2 = new NameTrackingTransformer();

        transformer1.setName("transformer1");
        transformer2.setName("transformer2");

        assertEquals("transformer1", transformer1.getName());
        assertEquals("transformer2", transformer2.getName());

        TestTransformer transformer3 = new TestTransformer("transformer3");

        ResponseData responseData = new ResponseData();
        responseData.setUrl("http://example.com");

        ResultData result1 = transformer1.transform(responseData);
        ResultData result2 = transformer2.transform(responseData);
        ResultData result3 = transformer3.transform(responseData);

 * </p>
 *
 * <p>
 * Example Usage:
 * </p>
 *
 * <pre>
 * XmlTransformer transformer = new XmlTransformer();
 * transformer.setNamespaceAware(true);
 * transformer.setCacheDuration(30);
 * transformer.addFieldRule("title", "/book/title/text()");
 * transformer.addFieldRule("author", "/book/author/name/text()");
 *
 * ResponseData responseData = new ResponseData();

    }

    /**
     * Gets the transformer.
     *
     * @return the transformer
     */
    public Transformer getTransformer() {
        return transformer;
    }

    /**
     * Sets the transformer.
     *
     * @param transformer the transformer to set
     */
    public void setTransformer(final Transformer transformer) {
        this.transformer = transformer;
    }

    /**

        assertEquals(content, new String(resultData.getData()));
        assertEquals(1, resultData.getChildUrlSet().size());
        assertEquals("http://hoge/test.html?q=hoge", resultData.getChildUrlSet().iterator().next().getUrl());
    }

    public void test_transform_null() {
        try {
            htmlTransformer.transform(null);
            fail();

crawler.crawlerContext.setMaxDepth(5);               // Limit crawl depth

// Use streaming for large files
container.singleton("fileTransformer", FileTransformer.class, transformer -> {
    transformer.setMaxContentSize(10 * 1024 * 1024); // 10MB limit
});
```

## Troubleshooting

### Common Issues

#### Connection Timeouts
```java
// Increase timeout values

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.crawler.transformer.impl;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

import org.codelibs.core.io.ResourceUtil;
import org.codelibs.fess.crawler.Constants;