MailClientService.java

package org.europa.together.service;

import java.util.List;

import java.util.Map;

import java.util.concurrent.TimeUnit;

import jakarta.mail.Address;

import jakarta.mail.MessagingException;

import jakarta.mail.Transport;

import org.apiguardian.api.API;

import static org.apiguardian.api.API.Status.STABLE;

import org.europa.together.application.LogbackLogger;

import org.europa.together.business.ConfigurationDAO;

import org.europa.together.business.Logger;

import org.europa.together.business.MailClient;

import org.europa.together.domain.ConfigurationDO;

import org.europa.together.domain.HashAlgorithm;

import org.europa.together.domain.LogLevel;

import org.europa.together.utils.Constraints;

import org.europa.together.business.CryptoTools;

import org.europa.together.domain.Mail;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Service;

/**

 * Service implementation for the JakartaMailClient.

 *

 * @author elmar.dott@gmail.com

 * @version 1.0

 * @since 1.0

 */

@API(status = STABLE, since = "1.0")

@Service

public final class MailClientService {

    private static final long serialVersionUID = 206L;

    @Autowired

    private CryptoTools cryptoTools;

    @Autowired

    private ConfigurationDAO configurationDAO;

    @Autowired

    private MailClient mailClient;

    /**

     * Constructor.

     */

    @API(status = STABLE, since = "1.0")

    /**

     * Allows to update the database configuration for the MailClient by a map

     * of configuration entries.<br>

     * - mailer.host<br>

     * - mailer.port<br>

     * - mailer.sender<br>

     * - mailer.user<br>

     * - mailer.password<br>

     * - mailer.ssl<br>

     * - mailer.tls<br>

     * - mailer.debug<br>

     * - mailer.count<br>

     * - mailer.wait

     *

     * @param configurationList as Map

     */

    @API(status = STABLE, since = "3.0")

    public void updateConfiguration(

            final Map<String, String> configurationList) {

        try {

                            Constraints.MODULE_NAME,

                            MailClient.CONFIG_VERSION,

                            MailClient.CONFIG_SET);

                    }

    /**

     * Get the active configuration for the e-mail service and return the result

     * as Map.

     *

     * @return mailConfiguration as Map

     */

    @API(status = STABLE, since = "3.0")

    public Map<String, String> loadConfiguration() {

    }

    /**

     * Send an composed (single) e-mail which is configured in a Mail data

     * class. An e-mail can be configured as followed:  <br>

     * <code>

     *  Mail mail = new Mail();

     *  mail.setSubject(subject);

     *  mail.setMessage(content);

     *  mail.addRecipent(mailAdress);

     * </code> <br>

     * In the case there are more recipients configured the mail will be only

     * send to the first entry.

     *

     * @param mail as MailClient

     * @throws jakarta.mail.MessagingException case of error

     */

    @API(status = STABLE, since = "1.0")

    public void sendEmail(final Mail mail) throws MessagingException {

    /**

     * Send a bulk of composed mails to a configured list of recipients. The

     * bulk mail supports a special feature, to interrupt the sending after an

     * defined amount of mails fo a configured time (milliseconds) until the

     * next bulk can be send. After the termination the method return th count

     * of the send mails. This two parameters are also part of thw whole

     * configuration and will not set seperatly.<br>

     * - <b>wait time:</b> default = -1 (unlimited)<br>

     * - <b>bulk mail limiter:</b> default = -1 (unlimited)

     *

     * @param mail as MailClient

     * @return sendedEmails as int

     * @throws jakarta.mail.MessagingException case of error

     */

    @API(status = STABLE, since = "1.0")

    public int sendBulkMail(final Mail mail) throws MessagingException {

        try {

                //after x mails wait for n seconds

                            LogLevel.DEBUG);

                }

    }

}

Mutations

1.1
Location : updateConfiguration
Killed by : none removed call to org/europa/together/business/MailClient::clearConfiguration → SURVIVED Covering tests

1.1
Location : sendEmail
Killed by : none removed call to org/europa/together/business/MailClient::composeMail → SURVIVED Covering tests

1.1
Location : sendBulkMail
Killed by : none removed call to org/europa/together/business/MailClient::composeMail → SURVIVED Covering tests

1.1
Location : sendBulkMail
Killed by : none removed call to jakarta/mail/Transport::connect → SURVIVED Covering tests