io.vertigo.tempo.mail.MailBuilder Maven / Gradle / Ivy

Go to download
/**
 * vertigo - simple java starter
 *
 * Copyright (C) 2013, KleeGroup, [email protected] (http://www.kleegroup.com)
 * KleeGroup, Centre d'affaire la Boursidiere - BP 159 - 92357 Le Plessis Robinson Cedex - France
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package io.vertigo.tempo.mail;

import io.vertigo.dynamo.file.model.VFile;
import io.vertigo.lang.Assertion;
import io.vertigo.lang.Builder;

import java.util.ArrayList;
import java.util.List;

/**
 * EMail Builder.
 * Multiple value params are in varargs (Type...) and can be call multiple times.
 * @author pchretien, npiedeloup
 */
public class MailBuilder implements Builder {
	private String mySubject;
	private String myReplyTo;
	private String myFrom;
	private String myTextContent;
	private String myHtmlContent;

	private final List myToAddresses = new ArrayList<>();
	private final List myCcAddresses = new ArrayList<>();
	private final List myAttachments = new ArrayList<>();

	/**
	 * Set subject.
	 * @param subject mail subject
	 * @return MailBuilder
	 */
	public MailBuilder withSubject(final String subject) {
		Assertion.checkArgNotEmpty(subject);
		Assertion.checkState(mySubject == null, "subject is already completed");
		//-----
		mySubject = subject;
		return this;
	}

	/**
	 * Set sender.
	 * @param from Mail sender
	 * @return MailBuilder
	 */
	public MailBuilder from(final String from) {
		Assertion.checkState(myFrom == null, "from is already completed");
		Assertion.checkArgNotEmpty(from);
		//-----
		myFrom = from;
		return this;
	}

	/**
	 * Set receiver of return mail (response or delivery fail)
	 * @param replyTo Receiver of return mail (response or delivery fail)
	 * @return MailBuilder
	 */
	public MailBuilder replyTo(final String replyTo) {
		Assertion.checkState(myReplyTo == null, "replyTo is already completed");
		Assertion.checkArgNotEmpty(replyTo);
		//-----
		myReplyTo = replyTo;
		return this;
	}

	/**
	 * Add a receiver.
	 * @param addresses Mail addresses (one or more)
	 * @return MailBuilder
	 */
	public MailBuilder to(final String... addresses) {
		Assertion.checkNotNull(addresses);
		//-----
		for (final String address : addresses) {
			Assertion.checkArgNotEmpty(address);
			myToAddresses.add(address);
		}
		return this;
	}

	/**
	 * Add a copy receiver.
	 * @param addresses Mail addresses (one or more)
	 * @return MailBuilder
	 */
	public MailBuilder cc(final String... addresses) {
		Assertion.checkNotNull(addresses);
		//-----
		for (final String address : addresses) {
			Assertion.checkArgNotEmpty(address);
			myCcAddresses.add(address);
		}
		return this;
	}

	/**
	 * Set mail content at text format.
	 * @param textContent Text content
	 * @return MailBuilder
	 */
	public MailBuilder withTextContent(final String textContent) {
		Assertion.checkState(myTextContent == null, "textContent is already completed");
		Assertion.checkArgNotEmpty(textContent);
		//-----
		myTextContent = textContent;
		return this;
	}

	/**
	 * Set mail content at html format.
	 * @param htmlContent Html content
	 * @return MailBuilder
	 */
	public MailBuilder withHtmlContent(final String htmlContent) {
		Assertion.checkState(myHtmlContent == null, "htmlContent is already completed");
		Assertion.checkArgNotEmpty(htmlContent);
		//-----
		myHtmlContent = htmlContent;
		return this;
	}

	/**
	 * Add a attachment file.
	 * @param files Files to attach (one or more)
	 * @return MailBuilder
	 */
	public MailBuilder withAttachments(final VFile... files) {
		Assertion.checkNotNull(files);
		//-----
		for (final VFile attachment : files) {
			Assertion.checkNotNull(attachment);
			myAttachments.add(attachment);
		}
		return this;
	}

	/** {@inheritDoc} */
	@Override
	public Mail build() {
		Assertion.checkArgument(!myToAddresses.isEmpty(), "No receiver defined");
		//-----
		return new Mail(mySubject, myReplyTo, myFrom, myToAddresses, myCcAddresses, myTextContent, myHtmlContent, myAttachments);
	}
}