com.wl4g.infra.common.notification.email.internal.MailSendException Maven / Gradle / Ivy
/*
* Copyright 2002-2018 the original author or authors.
*
* 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
*
* https://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 com.wl4g.infra.common.notification.email.internal;
import java.io.PrintStream;
import java.io.PrintWriter;
import java.util.LinkedHashMap;
import java.util.Map;
import javax.annotation.Nullable;
import com.wl4g.infra.common.lang.ObjectUtils2;
/**
* Exception thrown when a mail sending error is encountered. Can register
* failed messages with their exceptions.
*
* @author Dmitriy Kopylenko
* @author Juergen Hoeller
*/
@SuppressWarnings("serial")
public class MailSendException extends MailException {
private final transient Map failedMessages;
@Nullable
private final Exception[] messageExceptions;
/**
* Constructor for MailSendException.
*
* @param msg
* the detail message
*/
public MailSendException(String msg) {
this(msg, null);
}
/**
* Constructor for MailSendException.
*
* @param msg
* the detail message
* @param cause
* the root cause from the mail API in use
*/
public MailSendException(String msg, @Nullable Throwable cause) {
super(msg, cause);
this.failedMessages = new LinkedHashMap<>();
this.messageExceptions = null;
}
/**
* Constructor for registration of failed messages, with the messages that
* failed as keys, and the thrown exceptions as values.
*
* The messages should be the same that were originally passed to the
* invoked send method.
*
* @param msg
* the detail message
* @param cause
* the root cause from the mail API in use
* @param failedMessages
* a Map of failed messages as keys and thrown exceptions as
* values
*/
public MailSendException(@Nullable String msg, @Nullable Throwable cause, Map failedMessages) {
super(msg, cause);
this.failedMessages = new LinkedHashMap<>(failedMessages);
this.messageExceptions = failedMessages.values().toArray(new Exception[0]);
}
/**
* Constructor for registration of failed messages, with the messages that
* failed as keys, and the thrown exceptions as values.
*
* The messages should be the same that were originally passed to the
* invoked send method.
*
* @param failedMessages
* a Map of failed messages as keys and thrown exceptions as
* values
*/
public MailSendException(Map failedMessages) {
this(null, null, failedMessages);
}
/**
* Return a Map with the failed messages as keys, and the thrown exceptions
* as values.
*
* Note that a general mail server connection failure will not result in
* failed messages being returned here: A message will only be contained
* here if actually sending it was attempted but failed.
*
* The messages will be the same that were originally passed to the invoked
* send method, that is, SimpleMailMessages in case of using the generic
* MailSender interface.
*
* In case of sending MimeMessage instances via JavaMailSender, the messages
* will be of type MimeMessage.
*
* NOTE: This Map will not be available after serialization. Use
* {@link #getMessageExceptions()} in such a scenario, which will be
* available after serialization as well.
*
* @return the Map of failed messages as keys and thrown exceptions as
* values
* @see SimpleMailMessage
* @see javax.mail.internet.MimeMessage
*/
public final Map getFailedMessages() {
return this.failedMessages;
}
/**
* Return an array with thrown message exceptions.
*
* Note that a general mail server connection failure will not result in
* failed messages being returned here: A message will only be contained
* here if actually sending it was attempted but failed.
*
* @return the array of thrown message exceptions, or an empty array if no
* failed messages
*/
public final Exception[] getMessageExceptions() {
return (this.messageExceptions != null ? this.messageExceptions : new Exception[0]);
}
@Override
@Nullable
public String getMessage() {
if (ObjectUtils2.isEmpty(this.messageExceptions)) {
return super.getMessage();
} else {
StringBuilder sb = new StringBuilder();
String baseMessage = super.getMessage();
if (baseMessage != null) {
sb.append(baseMessage).append(". ");
}
sb.append("Failed messages: ");
for (int i = 0; i < this.messageExceptions.length; i++) {
Exception subEx = this.messageExceptions[i];
sb.append(subEx.toString());
if (i < this.messageExceptions.length - 1) {
sb.append("; ");
}
}
return sb.toString();
}
}
@Override
public String toString() {
if (ObjectUtils2.isEmpty(this.messageExceptions)) {
return super.toString();
} else {
StringBuilder sb = new StringBuilder(super.toString());
sb.append("; message exceptions (").append(this.messageExceptions.length).append(") are:");
for (int i = 0; i < this.messageExceptions.length; i++) {
Exception subEx = this.messageExceptions[i];
sb.append('\n').append("Failed message ").append(i + 1).append(": ");
sb.append(subEx);
}
return sb.toString();
}
}
@Override
public void printStackTrace(PrintStream ps) {
if (ObjectUtils2.isEmpty(this.messageExceptions)) {
super.printStackTrace(ps);
} else {
ps.println(super.toString() + "; message exception details (" + this.messageExceptions.length + ") are:");
for (int i = 0; i < this.messageExceptions.length; i++) {
Exception subEx = this.messageExceptions[i];
ps.println("Failed message " + (i + 1) + ":");
subEx.printStackTrace(ps);
}
}
}
@Override
public void printStackTrace(PrintWriter pw) {
if (ObjectUtils2.isEmpty(this.messageExceptions)) {
super.printStackTrace(pw);
} else {
pw.println(super.toString() + "; message exception details (" + this.messageExceptions.length + ") are:");
for (int i = 0; i < this.messageExceptions.length; i++) {
Exception subEx = this.messageExceptions[i];
pw.println("Failed message " + (i + 1) + ":");
subEx.printStackTrace(pw);
}
}
}
}