* governing permissions and limitations under the License.
 */
package org.codelibs.fess.storage;

import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;
import java.util.Map;

/**
 * Interface for cloud storage operations.
 * Implementations provide access to S3-compatible storage, GCS, or other cloud storage systems.
 */
public interface StorageClient extends AutoCloseable {

    /**

    public String logLevel;

    /**
     * Storage service endpoint URL for cloud storage integration.
     * Used for storing files in cloud storage services like S3.
     */
    @Size(max = 1000)
    public String storageEndpoint;

    /**
     * Access key for cloud storage authentication.
     * Used to authenticate with cloud storage services.
     */
    @Size(max = 1000)

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.storage;

/**
 * Enum for supported storage types.
 */
public enum StorageType {

    /** Amazon S3 */
    S3,

    /** Google Cloud Storage */
    GCS,

    /** S3-compatible storage (MinIO, etc.) */
    S3_COMPAT

import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.BlobInfo;
import com.google.cloud.storage.Bucket;
import com.google.cloud.storage.BucketInfo;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.Storage.BlobListOption;
import com.google.cloud.storage.StorageOptions;

/**
 * Google Cloud Storage client implementation.
 */

            fail();
        } catch (ChildUrlsException e) {
            String[] values = e.getChildUrlList().stream().map(d -> d.getUrl()).sorted().toArray(n -> new String[n]);
            assertEquals(3, values.length);
            assertEquals("storage://fess/dir1/", values[0]);
            assertEquals("storage://fess/dir3/", values[1]);

        super.setUp();
        new StandardCrawlerContainer();
    }

    /**
     * Test that the storage protocol is correctly recognized.
     */
    public void test_protocol() throws Exception {
        URL url = new URL("storage://bucket/object");
        assertEquals("storage", url.getProtocol());
    }

    /**
     * Test URL parsing with bucket and object path.
     */

    private StorageClientFactory() {
        // Utility class
    }

    /**
     * Auto-detect storage type from endpoint URL.
     *
     * @param endpoint the storage endpoint URL
     * @return detected storage type
     */
    public static StorageType detectStorageType(final String endpoint) {
        if (StringUtil.isBlank(endpoint)) {

import io.minio.errors.XmlParserException;

/**
 * Handler for the "storage" protocol, allowing access to objects stored in a MinIO-compatible storage service.
 * This handler extends {@link URLStreamHandler} to provide a way to open connections to storage objects
 * using URLs with the "storage" protocol.
 *
 * <p>
 * The URL format is expected to be: {@code storage://bucketName/objectName}.

     * Preprocesses a URI to ensure it has the correct storage protocol prefix.
     * @param uri the URI to preprocess
     * @return the preprocessed URI with storage:// prefix
     * @throws CrawlerSystemException if the URI is empty
     */
    protected String preprocessUri(final String uri) {
        if (StringUtil.isEmpty(uri)) {

import com.google.cloud.NoCredentials;
import com.google.cloud.storage.Blob;
import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.Storage;
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