Skip to content

Commit b71c8f0

Browse files
vitalii-tvitalii-t
committed
Minor improvements; Added error handling example; Added API reference link to README.md
1 parent 70fa5ba commit b71c8f0

File tree

8 files changed

+83
-13
lines changed

8 files changed

+83
-13
lines changed

‎README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,8 @@ import java.util.List;
5353
public class MailtrapJavaSDKTest {
5454

5555
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
56-
private static final String SENDER_EMAIL = "<[email protected]>";
57-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
56+
private static final String SENDER_EMAIL = "[email protected]";
57+
private static final String RECIPIENT_EMAIL = "[email protected]";
5858

5959
public static void main(String[] args) {
6060
final MailtrapConfig config = new MailtrapConfig.Builder()
@@ -107,6 +107,10 @@ public class MailtrapJavaSDKTest {
107107

108108
Refer to the [`examples`](examples) folder for the source code of this and other advanced examples.
109109

110+
### API Reference
111+
112+
You can find the API reference [here](https://railsware.github.io/mailtrap-java/index.html).
113+
110114
### General API
111115

112116
- [List User & Invite account accesses](examples/java/io/mailtrap/examples/general/AccountAccess.java)
@@ -118,6 +122,7 @@ Refer to the [`examples`](examples) folder for the source code of this and other
118122

119123
- [Advanced](examples/java/io/mailtrap/examples/sending/Everything.java)
120124
- [Minimal](examples/java/io/mailtrap/examples/sending/Minimal.java)
125+
- [Error handling](examples/java/io/mailtrap/examples/sending/Errors.java)
121126
- [Send email using template](examples/java/io/mailtrap/examples/sending/Template.java)
122127

123128
### Email testing API

‎examples/java/io/mailtrap/examples/bulk/BulkSend.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@
1111
public class BulkSend {
1212

1313
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
14-
private static final String SENDER_EMAIL = "<[email protected]>";
15-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
14+
private static final String SENDER_EMAIL = "[email protected]";
15+
private static final String RECIPIENT_EMAIL = "[email protected]";
1616

1717
public static void main(String[] args) {
1818
final MailtrapConfig config = new MailtrapConfig.Builder()

‎examples/java/io/mailtrap/examples/sending/Errors.java

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
package io.mailtrap.examples.sending;
2+
3+
import io.mailtrap.client.MailtrapClient;
4+
import io.mailtrap.config.MailtrapConfig;
5+
import io.mailtrap.exception.InvalidRequestBodyException;
6+
import io.mailtrap.exception.http.HttpClientException;
7+
import io.mailtrap.factory.MailtrapClientFactory;
8+
import io.mailtrap.model.request.emails.Address;
9+
import io.mailtrap.model.request.emails.MailtrapMail;
10+
11+
import java.util.List;
12+
import java.util.UUID;
13+
14+
public class Errors {
15+
16+
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
17+
private static final String SENDER_EMAIL = "[email protected]";
18+
private static final String RECIPIENT_EMAIL = "[email protected]";
19+
20+
public static void main(String[] args) {
21+
final MailtrapConfig config = new MailtrapConfig.Builder()
22+
.token(TOKEN)
23+
.build();
24+
25+
final MailtrapClient client = MailtrapClientFactory.createMailtrapClient(config);
26+
27+
final MailtrapMail invalidMail_TemplateUUIDAndSubjectAreUsed = MailtrapMail.builder()
28+
.from(new Address(SENDER_EMAIL))
29+
.to(List.of(new Address(RECIPIENT_EMAIL)))
30+
.subject("Hello from Mailtrap Sending!")
31+
.text("Welcome to Mailtrap Sending!")
32+
.templateUuid(UUID.randomUUID().toString())
33+
.build();
34+
35+
try {
36+
System.out.println(client.sendingApi().emails().send(invalidMail_TemplateUUIDAndSubjectAreUsed));
37+
} catch (InvalidRequestBodyException e) {
38+
System.out.println("Caught invalid request body exception : " + e);
39+
}
40+
41+
MailtrapClient clientWithInvalidToken = MailtrapClientFactory.createMailtrapClient(new MailtrapConfig.Builder()
42+
.token("invalid token")
43+
.build());
44+
45+
final MailtrapMail validMail = MailtrapMail.builder()
46+
.from(new Address(SENDER_EMAIL))
47+
.to(List.of(new Address(RECIPIENT_EMAIL)))
48+
.subject("Hello from Mailtrap Sending!")
49+
.text("Welcome to Mailtrap Sending!")
50+
.build();
51+
52+
try {
53+
System.out.println(clientWithInvalidToken.sendingApi().emails().send(validMail));
54+
} catch (HttpClientException e) {
55+
System.out.println("Caught unauthorized exception : " + e);
56+
}
57+
58+
try {
59+
System.out.println(client.sendingApi().emails().send(null));
60+
} catch (InvalidRequestBodyException e) {
61+
System.out.println("Caught invalid request body exception : " + e);
62+
}
63+
}
64+
}
65+

‎examples/java/io/mailtrap/examples/sending/Everything.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@
1515
public class Everything {
1616

1717
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
18-
private static final String SENDER_EMAIL = "<[email protected]>";
19-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
18+
private static final String SENDER_EMAIL = "[email protected]";
19+
private static final String RECIPIENT_EMAIL = "[email protected]";
2020

2121
public static void main(String[] args) {
2222
final MailtrapConfig config = new MailtrapConfig.Builder()

‎examples/java/io/mailtrap/examples/sending/Minimal.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@
1111
public class Minimal {
1212

1313
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
14-
private static final String SENDER_EMAIL = "<[email protected]>";
15-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
14+
private static final String SENDER_EMAIL = "[email protected]";
15+
private static final String RECIPIENT_EMAIL = "[email protected]";
1616

1717
public static void main(String[] args) {
1818
final MailtrapConfig config = new MailtrapConfig.Builder()

‎examples/java/io/mailtrap/examples/sending/Template.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@
1212
public class Template {
1313

1414
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
15-
private static final String SENDER_EMAIL = "<[email protected]>";
16-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
15+
private static final String SENDER_EMAIL = "[email protected]";
16+
private static final String RECIPIENT_EMAIL = "[email protected]";
1717

1818
public static void main(String[] args) {
1919
final MailtrapConfig config = new MailtrapConfig.Builder()

‎examples/java/io/mailtrap/examples/testing/Email.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@
1212
public class Email {
1313

1414
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
15-
private static final String SENDER_EMAIL = "<[email protected]>";
16-
private static final String RECIPIENT_EMAIL = "<[email protected]>";
15+
private static final String SENDER_EMAIL = "[email protected]";
16+
private static final String RECIPIENT_EMAIL = "[email protected]";
1717
private static final long INBOX_ID = 1337L;
1818

1919
public static void main(String[] args) {

‎examples/java/io/mailtrap/examples/testing/Messages.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
public class Messages {
1515

1616
private static final String TOKEN = "<YOUR MAILTRAP TOKEN>";
17-
private static final String FORWARD_EMAIL_TO = "<[email protected]>";
17+
private static final String FORWARD_EMAIL_TO = "[email protected]";
1818
private static final long ACCOUNT_ID = 1L;
1919

2020
public static void main(String[] args) {

0 commit comments

Comments
 (0)