샌드그리드를 사용하여 예전부터 이메일을 보내고 있었는데 최근들어 예전 API가 이메일을 발송하지 않아 아무래도 문제가 있는것 같아 새로운 API로 바꾸게 되었다.
사용자 입장에서는 모든게 다 바뀌었고 5-6년전부터 쓰던 API는 하나도 같은게 없었다. 아래의 내용은 샘플과 함께 문제점이 있던것을 고친 내용들이다.
- java API jar file download : https://github.com/sendgrid/sendgrid-java/releases/download/4.7.2/sendgrid-java.jar
- 위의 jar file 만 따로 받아서 사용하면 되는데 그렇게 하면 아래의 error가 런타임에 생긴다.
java.lang.SecurityException: Invalid signature file digest for Manifest main attributes.- 이럴때는 가장 쉬운 방법으로는 각종 zip 관련 도구로 META-INT folder 로들어가서 *SF,*.DSF,*RSA 파일들을 모두 지우고 jar 파일을 세이브하면 된다. 아니면 https://github.com/sendgrid/sendgrid-java 에서 코드를 다운받아서 jar 파일을 빌드할때 사이닝 관련된 파일들을 아래와 같이 제외 시킨다.
Maven:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.6</version>
<executions>
<execution>
<id>unpack-dependencies</id>
<phase>package</phase>
<goals>
<goal>unpack-dependencies</goal>
</goals>
<configuration>
<excludeScope>system</excludeScope>
<excludes>META-INF/*.SF</excludes>
<excludes>META-INF/*.DSA</excludes>
<excludes>META-INF/*.RSA</excludes>
<excludeGroupIds>junit,org.mockito,org.hamcrest</excludeGroupIds>
<outputDirectory>${project.build.directory}/classes</outputDirectory>
</configuration>
</execution>
</executions>
</plugin>
ANT:
<jar destfile="app.jar" basedir="${classes.dir}">
<zipfileset excludes="META-INF/**/*" src="${lib.dir}/bcprov-jdk16-145.jar"></zipfileset>
<manifest>
<attribute name="Main-Class" value="app.Main"/>
</manifest>
</jar>다음은 간단한 샘플 코드들이이다. Personalization을 사용하여 여러 사람들한테 보내거나 BCC등 예전과는 많이 다른 모습을 보인다. 물론 기본적으로 디렉트 API 에서 웹서비스 API로 바뀐게 확연히 들어난다.
-
import com.sendgrid.Method; import com.sendgrid.Request; import com.sendgrid.Response; import com.sendgrid.SendGrid; import com.sendgrid.helpers.mail.Mail; import com.sendgrid.helpers.mail.objects.*; import java.io.IOException; public class Example { // Fully populated Mail object public static Mail buildKitchenSink() { Mail mail = new Mail(); Email fromEmail = new Email(); fromEmail.setName(“Example User“); fromEmail.setEmail(“test@example.com“); mail.setFrom(fromEmail); mail.setSubject(“Hello World from the Twilio SendGrid Java Library“); Personalization personalization = new Personalization(); Email to = new Email(); to.setName(“Example User“); to.setEmail(“test1@example.com“); personalization.addTo(to); to.setName(“Example User“); to.setEmail(“test2@example.com“); personalization.addTo(to); Email cc = new Email(); cc.setName(“Example User“); cc.setEmail(“test3@example.com“); personalization.addCc(cc); cc.setName(“Example User“); cc.setEmail(“test4@example.com“); personalization.addCc(cc); Email bcc = new Email(); bcc.setName(“Example User“); bcc.setEmail(“test5@example.com“); personalization.addBcc(bcc); bcc.setName(“Example User“); bcc.setEmail(“test6@example.com“); personalization.addBcc(bcc); personalization.setSubject(“Hello World from the Personalized Twilio SendGrid Java Library“); personalization.addHeader(“X-Test“, “test“); personalization.addHeader(“X-Mock“, “true“); personalization.addSubstitution(“%name%“, “Example User“); personalization.addSubstitution(“%city%“, “Riverside“); personalization.addCustomArg(“user_id“, “343“); personalization.addCustomArg(“type“, “marketing“); personalization.setSendAt(1443636843); mail.addPersonalization(personalization); Personalization personalization2 = new Personalization(); Email to2 = new Email(); to2.setName(“Example User“); to2.setEmail(“test1@example.com“); personalization2.addTo(to2); to2.setName(“Example User“); to2.setEmail(“test2@example.com“); personalization2.addTo(to2); Email cc2 = new Email(); cc2.setName(“Example User“); cc2.setEmail(“test3@example.com“); personalization2.addCc(cc2); cc2.setName(“Example User“); cc2.setEmail(“test4@example.com“); personalization2.addCc(cc2); Email bcc2 = new Email(); bcc2.setName(“Example User“); bcc2.setEmail(“test5@example.com“); personalization2.addBcc(bcc2); bcc2.setName(“Example User“); bcc2.setEmail(“test6@example.com“); personalization2.addBcc(bcc2); personalization2.setSubject(“Hello World from the Personalized Twilio SendGrid Java Library“); personalization2.addHeader(“X-Test“, “test“); personalization2.addHeader(“X-Mock“, “true“); personalization2.addSubstitution(“%name%“, “Example User“); personalization2.addSubstitution(“%city%“, “Denver“); personalization2.addCustomArg(“user_id“, “343“); personalization2.addCustomArg(“type“, “marketing“); personalization2.setSendAt(1443636843); mail.addPersonalization(personalization2); Content content = new Content(); content.setType(“text/plain“); content.setValue(“some text here“); mail.addContent(content); content.setType(“text/html“); content.setValue(“<html><body>some text here</body></html>“); mail.addContent(content); Attachments attachments = new Attachments(); attachments.setContent(“TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdC4gQ3JhcyBwdW12“); attachments.setType(“application/pdf“); attachments.setFilename(“balance_001.pdf“); attachments.setDisposition(“attachment“); attachments.setContentId(“Balance Sheet“); mail.addAttachments(attachments); Attachments attachments2 = new Attachments(); attachments2.setContent(“BwdW“); attachments2.setType(“image/png“); attachments2.setFilename(“banner.png“); attachments2.setDisposition(“inline“); attachments2.setContentId(“Banner“); mail.addAttachments(attachments2); mail.setTemplateId(“13b8f94f-bcae-4ec6-b752-70d6cb59f932“); mail.addSection(“%section1%“, “Substitution Text for Section 1“); mail.addSection(“%section2%“, “Substitution Text for Section 2“); mail.addHeader(“X-Test1“, “1“); mail.addHeader(“X-Test2“, “2“); mail.addCategory(“May“); mail.addCategory(“2016“); mail.addCustomArg(“campaign“, “welcome“); mail.addCustomArg(“weekday“, “morning“); mail.setSendAt(1443636842); ASM asm = new ASM(); asm.setGroupId(99); asm.setGroupsToDisplay(new int[]{4, 5, 6, 7, 8}); mail.setASM(asm); // This must be a valid [batch ID](https://sendgrid.com/docs/API_Reference/SMTP_API/scheduling_parameters.html) to work // mail.setBatchId(“sendgrid_batch_id”); mail.setIpPoolId(“23“); MailSettings mailSettings = new MailSettings(); BccSettings bccSettings = new BccSettings(); bccSettings.setEnable(true); bccSettings.setEmail(“test@example.com“); mailSettings.setBccSettings(bccSettings); Setting sandBoxMode = new Setting(); sandBoxMode.setEnable(true); mailSettings.setSandboxMode(sandBoxMode); Setting bypassListManagement = new Setting(); bypassListManagement.setEnable(true); mailSettings.setBypassListManagement(bypassListManagement); FooterSetting footerSetting = new FooterSetting(); footerSetting.setEnable(true); footerSetting.setText(“Footer Text“); footerSetting.setHtml(“<html><body>Footer Text</body></html>“); mailSettings.setFooterSetting(footerSetting); SpamCheckSetting spamCheckSetting = new SpamCheckSetting(); spamCheckSetting.setEnable(true); spamCheckSetting.setSpamThreshold(1); spamCheckSetting.setPostToUrl(“https://spamcatcher.sendgrid.com“); mailSettings.setSpamCheckSetting(spamCheckSetting); mail.setMailSettings(mailSettings); TrackingSettings trackingSettings = new TrackingSettings(); ClickTrackingSetting clickTrackingSetting = new ClickTrackingSetting(); clickTrackingSetting.setEnable(true); clickTrackingSetting.setEnableText(true); trackingSettings.setClickTrackingSetting(clickTrackingSetting); OpenTrackingSetting openTrackingSetting = new OpenTrackingSetting(); openTrackingSetting.setEnable(true); openTrackingSetting.setSubstitutionTag(“Optional tag to replace with the open image in the body of the message“); trackingSettings.setOpenTrackingSetting(openTrackingSetting); SubscriptionTrackingSetting subscriptionTrackingSetting = new SubscriptionTrackingSetting(); subscriptionTrackingSetting.setEnable(true); subscriptionTrackingSetting.setText(“text to insert into the text/plain portion of the message“); subscriptionTrackingSetting.setHtml(“<html><body>html to insert into the text/html portion of the message</body></html>“); subscriptionTrackingSetting.setSubstitutionTag(“Optional tag to replace with the open image in the body of the message“); trackingSettings.setSubscriptionTrackingSetting(subscriptionTrackingSetting); GoogleAnalyticsSetting googleAnalyticsSetting = new GoogleAnalyticsSetting(); googleAnalyticsSetting.setEnable(true); googleAnalyticsSetting.setCampaignSource(“some source“); googleAnalyticsSetting.setCampaignTerm(“some term“); googleAnalyticsSetting.setCampaignContent(“some content“); googleAnalyticsSetting.setCampaignName(“some name“); googleAnalyticsSetting.setCampaignMedium(“some medium“); trackingSettings.setGoogleAnalyticsSetting(googleAnalyticsSetting); mail.setTrackingSettings(trackingSettings); Email replyTo = new Email(); replyTo.setName(“Example User“); replyTo.setEmail(“test@example.com“); mail.setReplyTo(replyTo); return mail; } // API V3 Dynamic Template implementation public static Mail buildDynamicTemplate() { Mail mail = new Mail(); Email fromEmail = new Email(); fromEmail.setName(“Example User“); fromEmail.setEmail(“test@example.com“); mail.setFrom(fromEmail); mail.setTemplateId(“d-c6dcf1f72bdd4beeb15a9aa6c72fcd2c“); Personalization personalization = new Personalization(); personalization.addDynamicTemplateData(“name“, “Example User“); personalization.addDynamicTemplateData(“city“, “Denver“); personalization.addTo(new Email(“test@example.com“)); mail.addPersonalization(personalization); return mail; } // Minimum required to send an email public static Mail buildHelloEmail() { Email from = new Email(“test@example.com“); String subject = “Hello World from the Twilio SendGrid Java Library“; Email to = new Email(“test@example.com“); Content content = new Content(“text/plain“, “some text here“); // Note that when you use this constructor an initial personalization object // is created for you. It can be accessed via // mail.personalization.get(0) as it is a List object Mail mail = new Mail(from, subject, to, content); Email email = new Email(“test2@example.com“); mail.personalization.get(0).addTo(email); return mail; } public static void baselineExample() throws IOException { final Mail helloWorld = buildHelloEmail(); send(helloWorld); } public static void kitchenSinkExample() throws IOException { final Mail kitchenSink = buildKitchenSink(); send(kitchenSink); } public static void dynamicTemplateExample() throws IOException { final Mail dynamicTemplate = buildDynamicTemplate(); send(dynamicTemplate); } private static void send(final Mail mail) throws IOException { final SendGrid sg = new SendGrid(System.getenv(“SENDGRID_API_KEY“)); sg.addRequestHeader(“X-Mock“, “true“); final Request request = new Request(); request.setMethod(Method.POST); request.setEndpoint(“mail/send“); request.setBody(mail.build()); final Response response = sg.api(request); System.out.println(response.getStatusCode()); System.out.println(response.getBody()); System.out.println(response.getHeaders()); } public static void main(String[] args) throws IOException { baselineExample(); kitchenSinkExample(); dynamicTemplateExample(); } }