import org.codelibs.fess.util.ComponentUtil;
import org.lastaflute.web.response.StreamResponse;
import org.lastaflute.web.util.LaServletContextUtil;

import jakarta.annotation.PostConstruct;

/**
 * Helper class for Open Search Description Document.
 */
public class OsddHelper {

    /**
     * Default constructor.
     */
    public OsddHelper() {
        // Default constructor
    }

import com.google.cloud.storage.StorageOptions;

/**
 * Handler for the "gcs" protocol, allowing access to objects stored in Google Cloud Storage.
 * This handler extends {@link URLStreamHandler} to provide a way to open connections to GCS objects
 * using URLs with the "gcs" protocol.
 *
 * <p>
 * The URL format is expected to be: {@code gcs://bucketName/objectName}.
 * The bucket name and object name are extracted from the URL.
 * </p>

import software.amazon.awssdk.services.s3.model.S3Exception;

/**
 * Handler for the "s3" protocol, allowing access to objects stored in S3-compatible storage services.
 * This handler extends {@link URLStreamHandler} to provide a way to open connections to S3 objects
 * using URLs with the "s3" protocol.
 *
 * <p>
 * The URL format is expected to be: {@code s3://bucketName/objectName}.
 * The bucket name and object name are extracted from the URL.
 * </p>

            HttpURLConnection connection = null;
            try {
                logger.fine(() -> ">>> " + method + " " + finalUrl);
                final URL u = new URL(finalUrl);
                connection = open(u);
                connection.setRequestMethod(method.toString());
                if (headerList != null) {
                    for (final String[] values : headerList) {

1. Fork repo
2. Create feature branch (`feature/amazing-feature`)
3. Make focused commits
4. Add tests
5. Format code (`mvn formatter:format && mvn license:format`)
6. Run tests (`mvn test`)
7. Open Pull Request

---

## Common Development Tasks

### Adding a Protocol Client

1. **Implement `CrawlerClient`**:
```java
public class MyClient extends AbstractCrawlerClient {
    @Override

                final ExtractData extractData = extractor.getText(in, params);
                return extractData.getContent();
            } catch (final IOException e) {
                throw new ExtractException("Could not open " + outputFile.getAbsolutePath(), e);
            }
        }
        try {
            return new String(FileUtil.readBytes(outputFile), outputEncoding);
        } catch (final UnsupportedEncodingException e) {

                        .prepareOpen(docIndex)
                        .execute(ActionListener.wrap(res2 -> logger.info("Opened index: {}", docIndex),
                                e -> logger.warn("Failed to open index: {}", docIndex, e)));
            }, e -> logger.warn("Failed to close index: {}", docIndex, e)));
        });
        saveInfo(messages -> messages.addSuccessStartedDataUpdate(GLOBAL));

    private static final String META_NAME_THUMBNAIL_CONTENT = "//META[@name=\"thumbnail\" or @name=\"THUMBNAIL\"]/@content";

    /** XPath expression for extracting Open Graph image content from meta tags */
    private static final String META_PROPERTY_OGIMAGE_CONTENT = "//META[@property=\"og:image\"]/@content";

    /** XPath expression for extracting robots content from meta tags */

				<artifactId>maven-javadoc-plugin</artifactId>
				<configuration>
					<encoding>UTF-8</encoding>
					<docencoding>UTF-8</docencoding>
					<charset>UTF-8</charset>
					<locale>en_US</locale>
					<windowtitle>Open Source Enterprise Search: Fess API</windowtitle>
					<header>&lt;a href="https://fess.codelibs.org/" target="_blank"&gt;Enterprise Search Server: Fess&lt;/a&gt;</header>
					<excludePackageNames>

				"application/set-payment",
				"application/set-payment-initiation",
				"application/set-registration",
				"application/set-registration-initiation",
				"application/sgml",
				"application/sgml-open-catalog",
				"application/shf+xml",
				"application/sieve",
				"application/simple-filter+xml",
				"application/simple-message-summary",
				"application/simplesymbolcontainer",
				"application/slate",