contactEmails;
try {
ListContactsResponse contactListResponse = sesClient.listContacts(contactListRequest);
contactEmails = contactListResponse.contacts().stream()
.map(Contact::emailAddress)
.toList();
} catch (Exception e) {
// TODO: Remove when listContacts's GET body issue is resolved.
contactEmails = this.contacts;
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[ListContacts](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListContacts)*中的。
### `SendEmail`
以下代码示例演示了如何使用 `SendEmail`。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ses#code-examples)中查找完整示例，了解如何进行设置和运行。
发送邮件。
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sesv2.model.Body;
import software.amazon.awssdk.services.sesv2.model.Content;
import software.amazon.awssdk.services.sesv2.model.Destination;
import software.amazon.awssdk.services.sesv2.model.EmailContent;
import software.amazon.awssdk.services.sesv2.model.Message;
import software.amazon.awssdk.services.sesv2.model.SendEmailRequest;
import software.amazon.awssdk.services.sesv2.model.SesV2Exception;
import software.amazon.awssdk.services.sesv2.SesV2Client;
/**
* Before running this AWS SDK for Java (v2) example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SendEmail {
public static void main(String[] args) {
final String usage = """
Usage:
\s
Where:
sender - An email address that represents the sender.\s
recipient - An email address that represents the recipient.\s
subject - The subject line.\s
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String sender = args[0];
String recipient = args[1];
String subject = args[2];
Region region = Region.US_EAST_1;
SesV2Client sesv2Client = SesV2Client.builder()
.region(region)
.build();
// The HTML body of the email.
String bodyHTML = "" + "" + "" + "Hello!
"
+ " See the list of customers.
" + "" + "";
send(sesv2Client, sender, recipient, subject, bodyHTML);
}
public static void send(SesV2Client client,
String sender,
String recipient,
String subject,
String bodyHTML) {
Destination destination = Destination.builder()
.toAddresses(recipient)
.build();
Content content = Content.builder()
.data(bodyHTML)
.build();
Content sub = Content.builder()
.data(subject)
.build();
Body body = Body.builder()
.html(content)
.build();
Message msg = Message.builder()
.subject(sub)
.body(body)
.build();
EmailContent emailContent = EmailContent.builder()
.simple(msg)
.build();
SendEmailRequest emailRequest = SendEmailRequest.builder()
.destination(destination)
.content(emailContent)
.fromEmailAddress(sender)
.build();
try {
System.out.println("Attempting to send an email through Amazon SES "
+ "using the AWS SDK for Java...");
client.sendEmail(emailRequest);
System.out.println("email was sent");
} catch (SesV2Exception e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
使用模板发送消息。
```
String coupons = Files.readString(Paths.get("resources/coupon_newsletter/sample_coupons.json"));
for (String emailAddress : contactEmails) {
SendEmailRequest newsletterRequest = SendEmailRequest.builder()
.destination(Destination.builder().toAddresses(emailAddress).build())
.content(EmailContent.builder()
.template(Template.builder()
.templateName(TEMPLATE_NAME)
.templateData(coupons)
.build())
.build())
.fromEmailAddress(this.verifiedEmail)
.listManagementOptions(ListManagementOptions.builder()
.contactListName(CONTACT_LIST_NAME)
.build())
.build();
SendEmailResponse newsletterResponse = sesClient.sendEmail(newsletterRequest);
System.out.println("Newsletter sent to " + emailAddress + ": " + newsletterResponse.messageId());
}
```
发送带有标头信息的消息。
```
public class SendwithHeader {
public static void main(String[] args) {
final String usage = """
Usage:
\s
Where:
sender - An email address that represents the sender.\s
recipient - An email address that represents the recipient.\s
subject - The subject line.\s
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String sender = args[0];
String recipient = args[1];
String subject = args[2];
Region region = Region.US_EAST_1;
SesV2Client sesv2Client = SesV2Client.builder()
.region(region)
.build();
String bodyHTML = """
Hello!
See the list of customers.
""";
sendWithHeader(sesv2Client, sender, recipient, subject, bodyHTML);
sesv2Client.close();
}
/**
* Sends an email using the AWS SES V2 client.
*
* @param sesv2Client the SES V2 client to use for sending the email
* @param sender the email address of the sender
* @param recipient the email address of the recipient
* @param subject the subject of the email
* @param bodyHTML the HTML content of the email body
*/
public static void sendWithHeader(SesV2Client sesv2Client,
String sender,
String recipient,
String subject,
String bodyHTML) {
EmailContent emailContent = EmailContent.builder()
.simple(Message.builder()
.body(b -> b.html(c -> c.charset(UTF_8.name()).data(bodyHTML))
.text(c -> c.charset(UTF_8.name()).data(bodyHTML)))
.subject(c -> c.charset(UTF_8.name()).data(subject))
.headers(List.of(
MessageHeader.builder()
.name("List-Unsubscribe")
.value(", ")
.build(),
MessageHeader.builder()
.name("List-Unsubscribe-Post")
.value("List-Unsubscribe=One-Click")
.build()))
.build())
.build();
SendEmailRequest request = SendEmailRequest.builder()
.fromEmailAddress(sender)
.destination(d -> d.toAddresses(recipient))
.content(emailContent)
.build();
try {
SendEmailResponse response = sesv2Client.sendEmail(request);
System.out.println("Email sent! Message ID: " + response.messageId());
} catch (SesV2Exception e) {
System.err.println("Failed to send email: " + e.awsErrorDetails().errorMessage());
throw new RuntimeException(e);
}
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[SendEmail](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendEmail)*中的。
## 场景
### 时事通讯场景
以下代码示例演示如何运行 Amazon SES API v2 时事通讯场景。
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ses#code-examples) 中查找完整示例，了解如何进行设置和运行。
```
try {
// 2. Create a contact list
String contactListName = CONTACT_LIST_NAME;
CreateContactListRequest createContactListRequest = CreateContactListRequest.builder()
.contactListName(contactListName)
.build();
sesClient.createContactList(createContactListRequest);
System.out.println("Contact list created: " + contactListName);
} catch (AlreadyExistsException e) {
System.out.println("Contact list already exists, skipping creation: weekly-coupons-newsletter");
} catch (LimitExceededException e) {
System.err.println("Limit for contact lists has been exceeded.");
throw e;
} catch (SesV2Exception e) {
System.err.println("Error creating contact list: " + e.getMessage());
throw e;
}
try {
// Create a new contact with the provided email address in the
CreateContactRequest contactRequest = CreateContactRequest.builder()
.contactListName(CONTACT_LIST_NAME)
.emailAddress(emailAddress)
.build();
sesClient.createContact(contactRequest);
contacts.add(emailAddress);
System.out.println("Contact created: " + emailAddress);
// Send a welcome email to the new contact
String welcomeHtml = Files.readString(Paths.get("resources/coupon_newsletter/welcome.html"));
String welcomeText = Files.readString(Paths.get("resources/coupon_newsletter/welcome.txt"));
SendEmailRequest welcomeEmailRequest = SendEmailRequest.builder()
.fromEmailAddress(this.verifiedEmail)
.destination(Destination.builder().toAddresses(emailAddress).build())
.content(EmailContent.builder()
.simple(
Message.builder()
.subject(Content.builder().data("Welcome to the Weekly Coupons Newsletter").build())
.body(Body.builder()
.text(Content.builder().data(welcomeText).build())
.html(Content.builder().data(welcomeHtml).build())
.build())
.build())
.build())
.build();
SendEmailResponse welcomeEmailResponse = sesClient.sendEmail(welcomeEmailRequest);
System.out.println("Welcome email sent: " + welcomeEmailResponse.messageId());
} catch (AlreadyExistsException e) {
// If the contact already exists, skip this step for that contact and proceed
// with the next contact
System.out.println("Contact already exists, skipping creation...");
} catch (Exception e) {
System.err.println("Error occurred while processing email address " + emailAddress + ": " + e.getMessage());
throw e;
}
}
ListContactsRequest contactListRequest = ListContactsRequest.builder()
.contactListName(CONTACT_LIST_NAME)
.build();
List contactEmails;
try {
ListContactsResponse contactListResponse = sesClient.listContacts(contactListRequest);
contactEmails = contactListResponse.contacts().stream()
.map(Contact::emailAddress)
.toList();
} catch (Exception e) {
// TODO: Remove when listContacts's GET body issue is resolved.
contactEmails = this.contacts;
}
String coupons = Files.readString(Paths.get("resources/coupon_newsletter/sample_coupons.json"));
for (String emailAddress : contactEmails) {
SendEmailRequest newsletterRequest = SendEmailRequest.builder()
.destination(Destination.builder().toAddresses(emailAddress).build())
.content(EmailContent.builder()
.template(Template.builder()
.templateName(TEMPLATE_NAME)
.templateData(coupons)
.build())
.build())
.fromEmailAddress(this.verifiedEmail)
.listManagementOptions(ListManagementOptions.builder()
.contactListName(CONTACT_LIST_NAME)
.build())
.build();
SendEmailResponse newsletterResponse = sesClient.sendEmail(newsletterRequest);
System.out.println("Newsletter sent to " + emailAddress + ": " + newsletterResponse.messageId());
}
try {
CreateEmailIdentityRequest createEmailIdentityRequest = CreateEmailIdentityRequest.builder()
.emailIdentity(verifiedEmail)
.build();
sesClient.createEmailIdentity(createEmailIdentityRequest);
System.out.println("Email identity created: " + verifiedEmail);
} catch (AlreadyExistsException e) {
System.out.println("Email identity already exists, skipping creation: " + verifiedEmail);
} catch (NotFoundException e) {
System.err.println("The provided email address is not verified: " + verifiedEmail);
throw e;
} catch (LimitExceededException e) {
System.err
.println("You have reached the limit for email identities. Please remove some identities and try again.");
throw e;
} catch (SesV2Exception e) {
System.err.println("Error creating email identity: " + e.getMessage());
throw e;
}
try {
// Create an email template named "weekly-coupons"
String newsletterHtml = loadFile("resources/coupon_newsletter/coupon-newsletter.html");
String newsletterText = loadFile("resources/coupon_newsletter/coupon-newsletter.txt");
CreateEmailTemplateRequest templateRequest = CreateEmailTemplateRequest.builder()
.templateName(TEMPLATE_NAME)
.templateContent(EmailTemplateContent.builder()
.subject("Weekly Coupons Newsletter")
.html(newsletterHtml)
.text(newsletterText)
.build())
.build();
sesClient.createEmailTemplate(templateRequest);
System.out.println("Email template created: " + TEMPLATE_NAME);
} catch (AlreadyExistsException e) {
// If the template already exists, skip this step and proceed with the next
// operation
System.out.println("Email template already exists, skipping creation...");
} catch (LimitExceededException e) {
// If the limit for email templates is exceeded, fail the workflow and inform
// the user
System.err.println("You have reached the limit for email templates. Please remove some templates and try again.");
throw e;
} catch (Exception e) {
System.err.println("Error occurred while creating email template: " + e.getMessage());
throw e;
}
try {
// Delete the contact list
DeleteContactListRequest deleteContactListRequest = DeleteContactListRequest.builder()
.contactListName(CONTACT_LIST_NAME)
.build();
sesClient.deleteContactList(deleteContactListRequest);
System.out.println("Contact list deleted: " + CONTACT_LIST_NAME);
} catch (NotFoundException e) {
// If the contact list does not exist, log the error and proceed
System.out.println("Contact list not found. Skipping deletion...");
} catch (Exception e) {
System.err.println("Error occurred while deleting the contact list: " + e.getMessage());
e.printStackTrace();
}
try {
// Delete the email identity
DeleteEmailIdentityRequest deleteIdentityRequest = DeleteEmailIdentityRequest.builder()
.emailIdentity(this.verifiedEmail)
.build();
sesClient.deleteEmailIdentity(deleteIdentityRequest);
System.out.println("Email identity deleted: " + this.verifiedEmail);
} catch (NotFoundException e) {
// If the email identity does not exist, log the error and proceed
System.out.println("Email identity not found. Skipping deletion...");
} catch (Exception e) {
System.err.println("Error occurred while deleting the email identity: " + e.getMessage());
e.printStackTrace();
}
} else {
System.out.println("Skipping email identity deletion.");
}
try {
// Delete the template
DeleteEmailTemplateRequest deleteTemplateRequest = DeleteEmailTemplateRequest.builder()
.templateName(TEMPLATE_NAME)
.build();
sesClient.deleteEmailTemplate(deleteTemplateRequest);
System.out.println("Email template deleted: " + TEMPLATE_NAME);
} catch (NotFoundException e) {
// If the email template does not exist, log the error and proceed
System.out.println("Email template not found. Skipping deletion...");
} catch (Exception e) {
System.err.println("Error occurred while deleting the email template: " + e.getMessage());
e.printStackTrace();
}
```
+ 有关 API 详细信息，请参阅《AWS SDK for Java 2.x API Reference》**中的以下主题。
+ [CreateContact](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContact)
+ [CreateContactList](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContactList)
+ [CreateEmailIdentity](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailIdentity)
+ [CreateEmailTemplate](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailTemplate)
+ [DeleteContactList](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteContactList)
+ [DeleteEmailIdentity](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteEmailIdentity)
+ [DeleteEmailTemplate](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/DeleteEmailTemplate)
+ [ListContacts](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/ListContacts)
+ [SendEmail。simple](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendEmail.simple)
+ [SendEmail。模板](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/SendEmail.template)