Azure 存储 Java SDK 教程

Azure 存储 Java SDK 教程

azure-storage-java项目地址:https://gitcode.com/gh_mirrors/az/azure-storage-java

1. 项目目录结构及介绍

在 Azure/azure-storage-java 仓库中，目录结构通常如下：

.
├── src            # 主代码源文件
│   ├── main        # 主要应用代码
│   └── test        # 测试代码
├── build.gradle    # Gradle 构建脚本
├── pom.xml         # Maven 依赖管理文件
├── README.md       # 项目简介文件
└── ...             # 其他相关配置或资源文件

• src/main：存储主要的应用代码，按服务（如 Blob 存储、Queue 存储等）组织。
• src/test：包含单元测试和集成测试的代码，用于验证核心功能。
• build.gradle / pom.xml：构建工具配置文件，Gradle 或 Maven 用来编译、打包和管理依赖。

2. 项目启动文件介绍

由于 Azure/azure-storage-java 是一个库项目，它不包含一个传统的“启动”文件，如 Main.java。开发者通常不会直接运行这个库，而是会在自己的应用项目中引入这个库来访问 Azure 存储服务。例如，创建一个新的 Java 应用来上传 Blob 至 Azure Blob 存储，您会有一个类似这样的主类：

public class Main {
    public static void main(String[] args) {
        // 初始化客户端和服务连接配置
        // 创建 BlobServiceClient 并执行操作
    }
}

在这个例子中，实际的初始化和操作 Azure 存储的部分会使用 Azure 存储 SDK 提供的类和方法。

3. 项目的配置文件介绍

Azure 存储 Java SDK 需要配置存储帐户名和密钥以进行身份验证。这通常通过以下方式实现：

• 环境变量：设置 AZURE_STORAGE_ACCOUNT 和 AZURE_STORAGE_KEY。
• 配置文件：创建一个配置文件，如 application.properties，并添加相应的条目。
• 编程式配置：在代码中显式传递账户名和密钥。

例如，在 application.properties 中的配置可能是这样：

azure.storage.account-name=your_storage_account_name
azure.storage.account-key=your_storage_account_key

然后在代码中加载这些配置：

import com.azure.core.credential.AzureNamedKeyCredential;
import com.azure.storage.blob.BlobServiceClientBuilder;

public class Main {
    public static void main(String[] args) {
        String accountName = System.getenv("azure.storage.account-name");
        String accountKey = System.getenv("azure.storage.account-key");

        AzureNamedKeyCredential credential = new AzureNamedKeyCredential(accountName, accountKey);
        
        // 使用凭证构建 BlobServiceClient
        BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
                .credential(credential)
                .endpoint("https://" + accountName + ".blob.core.windows.net")
                .buildClient();

        // 接下来可以使用 blobServiceClient 进行操作
    }
}

请注意，实际部署时应确保安全地处理和存储这些敏感信息，避免泄露。

azure-storage-java项目地址:https://gitcode.com/gh_mirrors/az/azure-storage-java