SendCloudJavaSDK1.0.6使用指南.docx

SendCloud Java SDK 1.0.6使用指南SendCloud的Java SDK使用Java mail实现邮件的发送，提供了一些新的功能，如返回EmailId（SendCloud会给每封邮件生成一个唯一的Id，便于跟踪）。并提供扩展字段X-SMTPAPI支持，便于用户能够实现点击和打开跟踪，取消订阅等功能，还能实现邮件内容的按需替换。Java SDK 需要依赖的jar包为：Java_mail_ 1.5Json_lib相关依赖包XercesImpl 2.9.1代码示例简单的发送邮件public void testSimpleSendMail() throws Exception {Message message = new Message(from@, fromName);// 正文，使用html形式，或者纯文本形式message.setBody(htmlbody欢迎使用a href=\\SendCloud/a/bodyhtml) // html// 添加to, cc, bcc replytomessage.setSubject(SendCloud测试邮件);ListString addressList = new ArrayListString();addressList.add(example1@);message.addRecipients(addressList).addRecipient(example2@).addBcc(bcc@).addCc(cc@).setReplyAddress(sendcloud@);// 添加附件message.addAttachment(SendCloud SDK 1.0.5.docx, /path/to/SendCloud SDK 1.0.5.docx);// 组装消息发送邮件SendCloudsendCloud = new SendCloud(username, password);sendCloud .setMessage(message);//sendCloud.setDebug(true); //设置调试, 可以看到java mail的调试信息// 设置连接超时时间为10000毫秒。如果不设置，默认为60000毫秒。// sendCloud.setConnectionTimeout(10000l);// 设置Socket I/O 超时时间，默认为无穷大。// sendCloud.setSocketTimeout(180000l); // 设为180秒sendCloud.send();// 获取emailId列表System.out.println(sendCloud.getEmailIdList());}使用扩展字段X-SMTPAPI字段发送邮件为了方便拼成X-SMTPAPI的json字符串。SendCloud Java SDK提供了SmtpApiHeader类来生成符合SendCloud格式的扩展字段。您只需要调用SmtpApiHeader的toString()方法即可。当然也可以自己拼成X-SMTPAPI的json字符串。对邮件进行分类，启用取消订阅，点击跟踪，打开跟踪功能。public void testXsmtpApi1() throws Exception {Message message = new Message(from@, fromName);// 正文，使用html形式，或者纯文本形式message.setBody(htmlbody欢迎使用a href=\\SendCloud/a/bodyhtml) ;// 添加to, cc, bcc replytomessage.setSubject(SendCloud测试邮件);ListString addressList = new ArrayListString();addressList.add(to1@);message.addRecipients(addressList).addRecipient(to2@);// X-SMTPAPISmtpApiHeadersmtpApiHeader = new SmtpApiHeader();// 添加category字段，只能添加一个smtpApiHeader.addCategory(xsmtpApi category); // 启动取消订阅，打开跟踪，点击跟踪应用smtpApiHeader.addFilter(AppFilter.ADD_UNSUBSCRIBE, enable, 1);smtpApiHeader.addFilter(AppFilter.ADD_HIDDEN_IMAGE, enable, 1);smtpApiHeader.addFilte