Send a Single Email to a Single Recipient

[thinkingserious]

Acceptance Criteria:

• A email object that represents the response body payload
• A mail object that handles sending email objects, data validation and error handling

Reference:

• https://github.com/sendgrid/sendgrid-java/tree/master/src/main/java/com/sendgrid/helpers/mail
• https://github.com/sendgrid/sendgrid-java/blob/master/CONTRIBUTING.md
• https://sendgrid.com/docs/API_Reference/Web_API_v3/Mail/index.html

[stangles]

Hi, I would like to work on this issue. I took a peek at the contribution guidelines and will send along a CLA soon.

My understanding of the task: expose a way for a user of sendgrid-java to call some publicly exposed method on a Mail object. This method encapsulates the work of validating the email object, creating the request body, sending the request, parsing the response and handling errors.

Questions I have on the acceptance criteria:

• Don't the Mail and Email objects already exist here: https://github.com/sendgrid/sendgrid-java/tree/master/src/main/java/com/sendgrid/helpers/mail ?
• What sort of pre-flight data validations should be done prior to sending the email? I checked the documentation and was unable to find a ruleset that describes what sort of validations the library guarantees before making the request to send the email.

Additionally, I was wondering if the sendgrid-java library should necessarily treat this issue, #151 and #152 as separate issues. It would seem to me that you could have one or two publicly available methods that would accept a List of Email objects for the to field, which would take care of this and #151 simultaneously.

[thinkingserious]

Hello @stangles,

Thanks for the detailed questions, very helpful!

Yes, the Mail and Email objects already exist. This is a refactor.

The validation should be based upon this swagger (OAI) file. Ideally, the object should load that file and load the validations in the constructor.

You are correct, issue #150, #151 and #152 should be considered together for the initial design.

Please let me know if you have any further questions.

With Best Regards,

Elmer

[thinkingserious]

Implementation will be tracked in this issue.