jodd.mail.SmtpSslServer Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jodd-all Show documentation
Show all versions of jodd-all Show documentation
Jodd bundle - all classes in one jar
// Copyright (c) 2003-present, Jodd Team (http://jodd.org)
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// 1. Redistributions of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
//
// 2. Redistributions in binary form must reproduce the above copyright
// notice, this list of conditions and the following disclaimer in the
// documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
package jodd.mail;
import jodd.util.StringPool;
import java.util.Properties;
/**
* Secure SMTP server (STARTTLS) for sending emails.
*/
public class SmtpSslServer extends SmtpServer {
public static final String MAIL_SMTP_STARTTLS_REQUIRED = "mail.smtp.starttls.required";
public static final String MAIL_SMTP_STARTTLS_ENABLE = "mail.smtp.starttls.enable";
public static final String MAIL_SMTP_SOCKET_FACTORY_PORT = "mail.smtp.socketFactory.port";
public static final String MAIL_SMTP_SOCKET_FACTORY_CLASS = "mail.smtp.socketFactory.class";
public static final String MAIL_SMTP_SOCKET_FACTORY_FALLBACK = "mail.smtp.socketFactory.fallback";
protected static final int DEFAULT_SSL_PORT = 465;
public static SmtpSslServer create(String host) {
return new SmtpSslServer(host, DEFAULT_SSL_PORT);
}
public static SmtpSslServer create(String host, int port) {
return new SmtpSslServer(host, port);
}
public SmtpSslServer(String host) {
super(host, DEFAULT_SSL_PORT);
}
public SmtpSslServer(String host, int port) {
super(host, port);
}
// ---------------------------------------------------------------- properties
protected boolean startTlsRequired = false;
protected boolean plaintextOverTLS = false; // google requires it to be false
/**
* Sets mail.smtp.starttls.required
which according to
* Java Mail API means: If true, requires the use of the STARTTLS command.
* If the server doesn't support the STARTTLS command, or the command fails,
* the connect method will fail. Defaults to false
.
*/
public SmtpSslServer startTlsRequired(boolean startTlsRequired) {
this.startTlsRequired = startTlsRequired;
return this;
}
/**
* When enabled, SMTP socket factory class will be not set,
* and Plaintext Authentication over TLS will be enabled.
*/
public SmtpSslServer plaintextOverTLS(boolean plaintextOverTLS) {
this.plaintextOverTLS = plaintextOverTLS;
return this;
}
@Override
protected Properties createSessionProperties() {
Properties props = super.createSessionProperties();
props.setProperty(MAIL_SMTP_STARTTLS_REQUIRED,
startTlsRequired ? StringPool.TRUE : StringPool.FALSE);
props.setProperty(MAIL_SMTP_STARTTLS_ENABLE, StringPool.TRUE);
props.setProperty(MAIL_SMTP_SOCKET_FACTORY_PORT, String.valueOf(port));
props.setProperty(MAIL_SMTP_PORT, String.valueOf(port));
if (!plaintextOverTLS) {
props.setProperty(MAIL_SMTP_SOCKET_FACTORY_CLASS, "javax.net.ssl.SSLSocketFactory");
}
props.setProperty(MAIL_SMTP_SOCKET_FACTORY_FALLBACK, StringPool.FALSE);
props.setProperty(MAIL_HOST, host);
return props;
}
}