try {
            final Bucket existingBucket = storage.get(bucket);
            if (existingBucket == null) {
                storage.create(BucketInfo.newBuilder(bucket).build());
                logger.info("Created storage bucket: {}", bucket);
            }
        } catch (final Exception e) {
            logger.warn("Failed to ensure bucket exists: {}", bucket, e);
        }
    }

    @Override

        }
    }

    /**
     * Checks if a bucket exists in the object storage.
     * @param name the name of the bucket to check
     * @return true if the bucket exists, false otherwise
     * @throws CrawlingAccessException if an error occurs while checking bucket existence
     */
    protected boolean bucketExists(final String name) {
        try {

                }
            }
        }
    }

    /**
     * Parses a GCS path into bucket name and object path components.
     * @param path the GCS path to parse (format: bucket/object/path)
     * @return an array containing the bucket name and object path
     * @throws CrawlingAccessException if the path format is invalid
     */
    protected String[] parsePath(final String path) {

        values = s3Client.parsePath("bucket/path");
        assertEquals("bucket", values[0]);
        assertEquals("path", values[1]);

        values = s3Client.parsePath("bucket/path1/path2");
        assertEquals("bucket", values[0]);
        assertEquals("path1/path2", values[1]);

        values = s3Client.parsePath("bucket/");
        assertEquals("bucket", values[0]);

     *
     * <p>
     * The connection extracts bucket and object names from the URL and uses environment
     * variables for authentication and endpoint configuration.
     * </p>
     */
    public class S3URLConnection extends URLConnection {

        /** The AWS S3 client for storage operations */
        private S3Client s3Client;
        /** The name of the storage bucket */
        private String bucketName;

            s3Client.headBucket(request);
        } catch (final NoSuchBucketException e) {
            try {
                final CreateBucketRequest createRequest = CreateBucketRequest.builder().bucket(bucket).build();
                s3Client.createBucket(createRequest);
                logger.info("Created storage bucket: {}", bucket);
            } catch (final Exception e1) {

     *
     * <p>
     * The connection extracts bucket and object names from the URL and uses environment
     * variables for authentication and endpoint configuration.
     * </p>
     */
    public class GcsURLConnection extends URLConnection {

        /** The GCS Storage client for storage operations */
        private Storage storage;
        /** The name of the storage bucket */
        private String bucketName;

        assertEquals("my-bucket-name", getField(gcsConn, "bucketName"));
        assertEquals("object.txt", getField(gcsConn, "objectName"));
    }

    /**
     * Test URL parsing with dots in bucket name.
     */
    public void test_urlParsing_dotsInBucket() throws Exception {
        URL url = new URL("gcs://my.bucket.name/object.txt");
        Handler handler = new Handler();

  private transient int size;
  private transient int modCount;

  /** Maps a bucket to the "entry" of its first element. */
  private transient int[] hashTableKToV;

  /** Maps a bucket to the "entry" of its first element. */
  private transient int[] hashTableVToK;

  /** Maps an "entry" to the "entry" that follows it in its bucket. */
  private transient int[] nextInBucketKToV;

        assertEquals("my-bucket-name", getField(storageConn, "bucketName"));
        assertEquals("object.txt", getField(storageConn, "objectName"));
    }

    /**
     * Test URL parsing with dots in bucket name.
     */
    public void test_urlParsing_dotsInBucket() throws Exception {
        URL url = new URL("storage://my.bucket.name/object.txt");
        Handler handler = new Handler();