StorageConnectionString.java

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.

package com.azure.storage.common.implementation.connectionstring;

import com.azure.core.util.logging.ClientLogger;

/**
 * Type representing storage connection string.
 *
 * RESERVED FOR INTERNAL USE.
 */
public final class StorageConnectionString {
    /**
     * The storage account name.
     */
    private final String accountName;

    /**
     * The settings for storage authentication.
     */
    private StorageAuthenticationSettings storageAuthSettings;

    /**
     * The blob endpoint.
     */
    private final StorageEndpoint blobEndpoint;

    /**
     * The file endpoint.
     */
    private final StorageEndpoint fileEndpoint;

    /**
     * The queue endpoint.
     */
    private final StorageEndpoint queueEndpoint;

    /**
     * The table endpoint.
     */
    private final StorageEndpoint tableEndpoint;

    /**
     * @return the storage account name.
     */
    public String getAccountName() {
        return this.accountName;
    }

    /**
     * @return The storage authentication settings associated with this connection string.
     */
    public StorageAuthenticationSettings getStorageAuthSettings() {
        return this.storageAuthSettings;
    }

    /**
     * Get the endpoint for the storage blob service.
     *
     * @return the blob endpoint associated with this connection string.
     */
    public StorageEndpoint getBlobEndpoint() {
        return this.blobEndpoint;
    }

    /**
     * Get the endpoint for the storage file service.
     *
     * @return the file endpoint associated with this connection string.
     */
    public StorageEndpoint getFileEndpoint() {
        return this.fileEndpoint;
    }

    /**
     * Get the endpoint for the storage queue service.
     *
     * @return the queue endpoint associated with this connection string.
     */
    public StorageEndpoint getQueueEndpoint() {
        return this.queueEndpoint;
    }

    /**
     * Get the endpoint for the storage table service.
     *
     * @return the table endpoint associated with this connection string.
     */
    public StorageEndpoint getTableEndpoint() {
        return this.tableEndpoint;
    }

    /**
     * Create a {@link StorageConnectionString} from the given connection string.
     *
     * @param connectionString the connection string
     * @param logger           the logger
     * @return StorageConnectionString based on the provided connection string.
     */
    public static StorageConnectionString create(final String connectionString, final ClientLogger logger) {
        if (connectionString == null || connectionString.length() == 0) {
            throw logger.logExceptionAsError(new IllegalArgumentException("Invalid connection string."));
        }
        ConnectionSettings settings = ConnectionSettings.fromConnectionString(connectionString, logger);
        StorageConnectionString emulatorConnString = StorageEmulatorConnectionString.tryCreate(settings, logger);
        if (emulatorConnString != null) {
            return emulatorConnString;
        }

        StorageConnectionString serviceConnString = StorageServiceConnectionString.tryCreate(settings, logger);
        if (serviceConnString != null) {
            return serviceConnString;
        }
        throw logger.logExceptionAsError(new IllegalArgumentException("Invalid connection string."));
    }

    /**
     * Creates a StorageConnectionString.
     *
     * @param storageAuthSettings the storage authentication settings
     * @param blobEndpoint the blob service endpoint
     * @param queueEndpoint the queue service endpoint
     * @param tableEndpoint the table service endpoint
     * @param fileEndpoint the file service endpoint
     * @param accountName the storage account name
     */
    StorageConnectionString(final StorageAuthenticationSettings storageAuthSettings,
                                    final StorageEndpoint blobEndpoint,
                                    final StorageEndpoint queueEndpoint,
                                    final StorageEndpoint tableEndpoint,
                                    final StorageEndpoint fileEndpoint,
                                    final String accountName) {
        this.storageAuthSettings = storageAuthSettings;
        this.blobEndpoint = blobEndpoint;
        this.fileEndpoint = fileEndpoint;
        this.queueEndpoint = queueEndpoint;
        this.tableEndpoint = tableEndpoint;
        this.accountName = accountName;
    }
}