generatePresignedUrl方法介绍

一、generatePresignedUrl方法简介

Amazon S3提供的generatePresignedUrl方法用于生成预签名URL（Pre-Signed URL）。预签名URL是一个能够提供对Amazon S3资源临时访问权限的URL，它可以被其他人或者应用程序使用，以在URL的有效期内访问Amazon S3中的资源。

预签名URL可以在不暴露Amazon S3资源的访问密钥（Access Key）的情况下，允许其他人或者应用程序访问Amazon S3中的资源。预签名URL也可以用于在特定时限内，让临时访问授权的客户端执行对Amazon S3中的资源的读/写操作。

二、生成预签名URL

generatePresignedUrl方法可以用于生成预签名URL，以便其他人或者应用程序可以在URL有效期内访问Amazon S3中的资源。下面是一个示例：

import java.net.URL;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.GeneratePresignedUrlRequest;

public class S3Service {
  private static final String S3_BUCKET_NAME = "my-s3-bucket";
  private AmazonS3 s3Client = AmazonS3ClientBuilder.standard().build();

  public URL generatePresignedUrl(String key) {
    GeneratePresignedUrlRequest generatePresignedUrlRequest =
      new GeneratePresignedUrlRequest(S3_BUCKET_NAME, key);

    return s3Client.generatePresignedUrl(generatePresignedUrlRequest);
  }
}

在上面的示例中，我们首先建立了一个Amazon S3客户端（AmazonS3），然后调用generatePresignedUrl方法，将S3_BUCKET_NAME和key作为参数传递。generatePresignedUrl会返回一个URL，该URL可以在URL有效期内提供对Amazon S3中指定资源的访问权限。

三、控制URL的有效期

generatePresignedUrl方法还可以通过GeneratePresignedUrlRequest API用于控制URL的有效期。GeneratePresignedUrlRequest API提供了多个方法，可以设置URL的有效期、服务端加密、条件检查等参数。下面是一些示例：

1. 控制URL的有效期:

import java.net.URL;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.GeneratePresignedUrlRequest;
import java.util.Date;

public class S3Service {
  private static final String S3_BUCKET_NAME = "my-s3-bucket";
  private AmazonS3 s3Client = AmazonS3ClientBuilder.standard().build();

  public URL generatePresignedUrl(String key) {
    GeneratePresignedUrlRequest generatePresignedUrlRequest =
      new GeneratePresignedUrlRequest(S3_BUCKET_NAME, key);

    //设置URL有效期为24小时
    generatePresignedUrlRequest.setExpiration(new Date(System.currentTimeMillis() + 24 * 60 * 60 * 1000));

    return s3Client.generatePresignedUrl(generatePresignedUrlRequest);
  }
}

上述示例中，我们使用setExpiration方法设置了URL的有效期为24小时。URL将在指定的时间过期，无法再次访问Amazon S3中的资源。

2. 服务端加密:

import java.net.URL;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.GeneratePresignedUrlRequest;
import com.amazonaws.services.s3.model.ObjectMetadata;

public class S3Service {
  private static final String S3_BUCKET_NAME = "my-s3-bucket";
  private AmazonS3 s3Client = AmazonS3ClientBuilder.standard().build();

  public URL generatePresignedUrl(String key) {
    GeneratePresignedUrlRequest generatePresignedUrlRequest =
      new GeneratePresignedUrlRequest(S3_BUCKET_NAME, key);

    //设置服务端加密
    ObjectMetadata metadata = new ObjectMetadata();
    metadata.setSSEAlgorithm(ObjectMetadata.AES_256_SERVER_SIDE_ENCRYPTION);
    generatePresignedUrlRequest.setObjectMetadata(metadata);

    return s3Client.generatePresignedUrl(generatePresignedUrlRequest);
  }
}

上述示例中，我们使用setObjectMetadata方法设置了服务端加密。服务端将在保存object时对其进行加密，以确保数据的安全性。

3. 条件检查:

import java.net.URL;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.GeneratePresignedUrlRequest;
import com.amazonaws.services.s3.model.ObjectMetadata;
import com.amazonaws.services.s3.model.ResponseHeaderOverrides;
import java.util.Date;

public class S3Service {
  private static final String S3_BUCKET_NAME = "my-s3-bucket";
  private AmazonS3 s3Client = AmazonS3ClientBuilder.standard().build();

  public URL generatePresignedUrl(String key) {
    GeneratePresignedUrlRequest generatePresignedUrlRequest =
      new GeneratePresignedUrlRequest(S3_BUCKET_NAME, key);

    //设置条件检查
    ResponseHeaderOverrides overrides = new ResponseHeaderOverrides();
    overrides.setContentType("text/xml");
    generatePresignedUrlRequest.setResponseHeaders(overrides);
    generatePresignedUrlRequest.setExpiration(new Date(System.currentTimeMillis() + 24 * 60 * 60 * 1000));

    return s3Client.generatePresignedUrl(generatePresignedUrlRequest);
  }
}

上述示例中，我们使用setResponseHeaders方法设置了条件检查。如果访问Amazon S3中的对象时响应头未返回ContentType为text/xml，则请求将被拒绝。

四、小结

Amazon S3提供的generatePresignedUrl方法是一种非常方便的方法，可以让我们生成具有有效期限制的预签名URL，以提供对Amazon S3中资源的访问权限。方法具有可配置、弹性、安全等特点，可以满足我们在不同应用场景下的需求。