Flutter AWS服务集成插件aws_client的使用

High-level APIs for Amazon Web Services (AWS) in Dart

aws_client 是一个用于在Dart中调用Amazon Web Services (AWS) 的高级API库。它使得开发者可以在Flutter应用中轻松地与AWS服务进行交互，包括S3、DynamoDB、SQS、Lambda等。

Usage

S3

以下是一个简单的例子，展示了如何使用aws_client来创建S3存储桶并上传文件：

import 'dart:io';
import 'package:aws_client/s3_2006_03_01.dart';

void main() async {
  final api = S3(region: 'us-west-1');
  await api.createBucket(bucket: 'my_bucket');
  await api.putObject(
      bucket: 'my_bucket',
      key: 'my_file.png',
      body: File('my_file.png').readAsBytesSync());
  api.close();
}

DynamoDB

接下来是使用DynamoDB的例子，演示了如何从表中获取数据：

import 'dart:convert';
import 'package:aws_client/dynamo_document.dart';

void main() async {
  final db = DocumentClient(region: 'us-west-1');

  final getResponse = await db.get(
    tableName: 'MyTable',
    key: {'Car': 'DudeWheresMyCar'},
  );

  print(jsonEncode(getResponse.item));
}

SQS

这个例子说明了如何创建队列并向其发送消息：

import 'package:aws_client/sqs_2012_11_05.dart';

void main() async {
  final sqs = Sqs(region: 'us-west-1');
  final queue = await sqs.createQueue(queueName: 'queue');
  await sqs.sendMessage(
          messageBody: 'Hello from Dart client!', queueUrl: queue.queueUrl!);
  sqs.close();
}

Lambda

下面是如何调用Lambda函数的示例：

import 'package:aws_client/lambda_2015_03_31.dart';

void main(List<String> args) async {
  final lambda = Lambda(region: 'us-west-1');
  final response = await lambda.invoke(
    functionName: 'my-function',
    invocationType: InvocationType.requestResponse,
  );

  print('StatusCode: ${response.statusCode}');
  lambda.close();
}

Cognito Identity Provider

Cognito Identity Provider的使用案例，展示用户管理功能：

import 'package:aws_client/cognito_identity_provider_2016_04_18.dart';

void main() async {
  final api = CognitoIdentityProvider(region: 'us-west-1');

  final cognitoPool = 'us-west-1_abc';
  final user = 'email@email.com';
  
  await api.adminCreateUser(
    userPoolId: cognitoPool,
    username: user,
    temporaryPassword: r'Pass123$$',
    userAttributes: [AttributeType(name: 'email', value: user)],
    clientMetadata: {
      'language': 'fr',
    },
  );

  await api.adminSetUserPassword(
      password: 'newpassword', userPoolId: cognitoPool, username: user);

  await api.adminDeleteUser(userPoolId: cognitoPool, username: user);

  api.close();
}

IAM

IAM（身份和访问管理）的简单使用：

import 'package:aws_client/iam_2010_05_08.dart';

void main() async {
  final iam = Iam();

  final users = await iam.listUsers();
  print(users.users.length);

  iam.close();
}

SES

SES（Simple Email Service）发送邮件的例子：

import 'package:aws_client/ses_v2_2019_09_27.dart';

void main() async {
  final api = SesV2(region: 'us-west-1');

  final response = await api.sendEmail(
    content: EmailContent(
      simple: Message(
        body: Body(text: Content(data: 'Hello, here is a message')),
        subject: Content(data: 'An email from SES'),
      ),
    ),
    destination: Destination(toAddresses: ['user@email.com']),
    fromEmailAddress: 'from@email.com',
  );
  print(response.messageId);

  api.close();
}

How to contribute

此库并非来自Amazon或Google的官方库。它由社区维护，遵循"Scratch your own itch!"的原则，意味着这里包含了我们关心的API。欢迎贡献代码：

• Tests: 不要在代码中直接包含AWS凭证；应从环境变量读取AWS凭证，并提供详细的测试设置说明。
• API Documentation: 帮助完善API文档。
• New API Contribution: 如果您计划实现新的API，请先创建一个问题单，并参考现有API的实现方式。务必附上指向AWS API文档的链接。

Links

• source code
• contributors: Agilord

Available AWS APIs

该包内目前支持的AWS API列表如下：

• AWS Migration Hub (package:aws_client/migration_hub)
• Access Analyzer (package:aws_client/access_analyzer)
• …
• AWS X-Ray (package:aws_client/x_ray)

注意：以上仅列出部分API，完整列表请参阅源码仓库。

希望这些信息能帮助你更好地理解和使用aws_client插件！如果有任何问题或需要进一步的帮助，请随时提问。