Este tópico apresenta instruções e exemplos de código para usar a API S3 Java na conexão e no acesso ao Lindorm.
Pré-requisitos
Ambiente Java com JDK 1.8 ou superior instalado.
Obtenha o S3-compatible Endpoint do mecanismo de tabela ampla do Lindorm. Para mais informações, consulte View connection addresses.
Adicione o endereço IP do cliente à lista de permissões do Lindorm. Para mais informações, consulte Configure a whitelist.
Procedimento
-
Instale o SDK Java S3. Abra o cliente Eclipse, crie um projeto e configure as dependências do Maven no arquivo pom.xml conforme abaixo:
-
Adicione a dependência do Maven para o Java SDK 1.x.
<dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-s3</artifactId> <version>1.11.655</version> </dependency> -
Adicione a dependência do Maven para o Java SDK 2.x.
<dependency> <groupId>software.amazon.awssdk</groupId> <artifactId>aws-sdk-java</artifactId> <version>2.17.32</version> </dependency>
-
No seu projeto, insira o código a seguir para se conectar e acessar o LindormTable.
Exemplos de código do Java SDK 1.x
-
Crie uma conexão
String s3Endpoint = "http://ld-bp17j28j2y7pm****-proxy-blob.lindorm.rds.aliyuncs.com:9053"; // The S3-compatible endpoint for LindormTable String bucketName = "testbucket"; // Create a connection AmazonS3 client = AmazonS3ClientBuilder.standard() .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration(s3Endpoint, null)) .withPathStyleAccessEnabled(true) .withCredentials(new AWSStaticCredentialsProvider(new BasicAWSCredentials("AK", "SK"))) .build();NotaSubstitua os campos AK e SK no exemplo pelo nome de usuário e senha do LindormTable. Armazene a senha em uma variável de ambiente ou arquivo de configuração. Não utilize senhas codificadas diretamente no código.
-
Operações de bucket
// Create a bucket Bucket bucket = client.createBucket(bucketName); // Check if the bucket exists HeadBucketResult result = client.headBucket(new HeadBucketRequest(bucketName)); // List all buckets List<Bucket> buckets = client.listBuckets(new ListBucketsRequest());NotaPara criar um novo usuário e conceder permissões para operações de bucket, consulte Create a user e S3 protocol permission management.
-
Operações de objeto
String content = "content"; // Upload an object client.putObject(bucketName, key_name, content); // Read an object S3Object object = client.getObject(bucketName, keyName); // List all objects in the bucket // list v1 ObjectListing objects = client.listObjects(bucketName); // list v2 ListObjectsV2Result results = client.listObjectsV2(bucketName); // Delete an object client.deleteObject(bucketName, keyName); // Delete objects in a batch client.deleteObjects(new DeleteObjectsRequest(bucketName).withKeys(keyName)); -
Operações de upload multipart
// The file to upload File file = new File(filePath); long contentLength = file.length(); long partSize = 5 * 1024 * 1024; // Set the part size to 5 MB List<PartETag> partETags = new ArrayList<PartETag>(); // Initialize the multipart upload InitiateMultipartUploadRequest initRequest = new InitiateMultipartUploadRequest(bucketName, keyName); InitiateMultipartUploadResult initResponse = client.initiateMultipartUpload(initRequest); // Upload parts long filePosition = 0; for (int i = 1; filePosition < contentLength; i++) { partSize = Math.min(partSize, (contentLength - filePosition)); // Upload part request UploadPartRequest uploadRequest = new UploadPartRequest() .withBucketName(bucketName) .withKey(keyName) .withUploadId(initResponse.getUploadId()) .withPartNumber(i) .withFileOffset(filePosition) .withFile(file) .withPartSize(partSize); UploadPartResult uploadResult = client.uploadPart(uploadRequest); partETags.add(uploadResult.getPartETag()); filePosition += partSize; } // Complete the multipart upload. The object is now visible. CompleteMultipartUploadRequest compRequest = new CompleteMultipartUploadRequest(bucketName, keyName, initResponse.getUploadId(), partETags); client.completeMultipartUpload(compRequest);
Exemplos de código do Java SDK 2.x
-
Crie uma conexão
String s3Endpoint = "http://ld-bp17j28j2y7pm****-proxy-blob.lindorm.rds.aliyuncs.com:9053"; // The S3-compatible endpoint for LindormTable String bucketName = "testbucket"; // Create a connection AwsBasicCredentials creds = AwsBasicCredentials.create("AK", "SK"); S3Client client = S3Client.builder() .serviceConfiguration(b -> b.checksumValidationEnabled(false)) .region(Region.AP_EAST_1) .credentialsProvider(StaticCredentialsProvider.create(creds)) .endpointOverride(new URI(s3Endpoint)) .build(); // Close the connection client.close();NotaSubstitua os campos AK e SK no exemplo pelo nome de usuário e senha do LindormTable. Armazene a senha em uma variável de ambiente ou arquivo de configuração. Não utilize senhas codificadas diretamente no código.
-
Operações de bucket
// Create a bucket S3Waiter s3Waiter = client.waiter(); CreateBucketRequest bucketRequest = CreateBucketRequest.builder() .bucket(bucketName) .build(); // Check if the bucket exists client.createBucket(bucketRequest); HeadBucketRequest bucketRequestWait = HeadBucketRequest.builder() .bucket(bucketName) .build(); WaiterResponse<HeadBucketResponse> waiterResponse = s3Waiter.waitUntilBucketExists(bucketRequestWait); waiterResponse.matched().response().ifPresent(System.out::println);NotaPara criar um novo usuário e conceder permissões para operações de bucket, consulte Create a user e S3 protocol permission management.
-
Operações de objeto
// Write an object PutObjectRequest putOb = PutObjectRequest.builder() .bucket(bucketName) .key(keyName) .build(); PutObjectResponse response = client.putObject(putOb, RequestBody.fromString("content")); // Read an object GetObjectRequest objectRequest = GetObjectRequest .builder() .key(keyName) .bucket(bucketName) .build(); ResponseBytes<GetObjectResponse> objectBytes = client.getObjectAsBytes(objectRequest); byte[] data = objectBytes.asByteArray(); // List objects ListObjectsRequest listObjects = ListObjectsRequest .builder() .bucket(bucketName) .build(); ListObjectsResponse res = client.listObjects(listObjects); List<S3Object> objects = res.contents(); -
Operações de upload multipart
// Initialize the multipart upload CreateMultipartUploadRequest createMultipartUploadRequest = CreateMultipartUploadRequest.builder() .bucket(bucketName) .key(keyName) .build(); CreateMultipartUploadResponse response = client.createMultipartUpload(createMultipartUploadRequest); String uploadId = response.uploadId(); System.out.println(uploadId); // Upload part 1 UploadPartRequest uploadPartRequest1 = UploadPartRequest.builder().bucket(bucketName).key(keyName) .uploadId(uploadId) .partNumber(1).build(); String etag1 = client.uploadPart(uploadPartRequest1, RequestBody.fromString("content1")).eTag(); CompletedPart part1 = CompletedPart.builder().partNumber(1).eTag(etag1).build(); // Upload part 2 UploadPartRequest uploadPartRequest2 = UploadPartRequest.builder().bucket(bucketName).key(keyName) .uploadId(uploadId) .partNumber(2).build(); String etag2 = client.uploadPart(uploadPartRequest2, RequestBody.fromString("content2")).eTag(); CompletedPart part2 = CompletedPart.builder().partNumber(2).eTag(etag2).build(); // Complete the multipart upload. The object is now visible. CompletedMultipartUpload completedMultipartUpload = CompletedMultipartUpload.builder() .parts(part1, part2) .build(); CompleteMultipartUploadRequest completeMultipartUploadRequest = CompleteMultipartUploadRequest.builder() .bucket(bucketName) .key(keyName) .uploadId(uploadId) .multipartUpload(completedMultipartUpload) .build(); client.completeMultipartUpload(completeMultipartUploadRequest);