Documentation – Работа с SMTP клиент

Java: Свързване към SMTP сървър

Mon, 01 Jan 0001 00:00:00 +0000

Следните свойства трябва да бъдат зададени при свързване към SMTP сървър с поддръжка на SSL.

SecurityOptions
Порт

В примерите по-долу показваме как да:

Задайте потребителско име.
Задайте парола.
Задайте порта.
Задайте опция за сигурност.

Следният кодов пример показва как да се свържете със SMTP сървър, поддържащ SSL.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

SmtpClient client = new SmtpClient("smtp.gmail.com");

// Set username, password, port, and security options
client.setUsername("your.email@gmail.com");
client.setPassword("your.password");
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);

Свързване към сървър чрез Socks прокси сървър

Понякога използваме прокси сървъри за комуникация с външния свят. В такива случаи имейл клиентите не могат да комуникират през Интернет без посочване на адреса на прокси. Aspose.Email поддържа версии 4, 4a и 5 на SOCKS прокси протокола. Тази статия предоставя работещ пример за изпращане на имейл чрез прокси пощенски сървър. За изпращане на имейл чрез прокси сървър:

Инициализирайте прокси със нужната информация, а именно адрес на прокси, порт и SOCKS версия.
Инициализиране SmtpClient с адреса на хоста, потребителско име и парола, както и други настройки.
Задайте свойството Proxy на клиента на Прокси обект създаден по-рано.

Следният кодов пример показва как да се свържете към сървър чрез прокси сървър.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

SmtpClient client = new SmtpClient("smtp.domain.com", "username", "password");
client.setSecurityOptions(SecurityOptions.SSLImplicit);
String proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);
client.setProxy(proxy);
client.send(new MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy",
        "Implement socks proxy protocol for versions 4, 4a, 5 (only Username/Password authentication)"));

Свързване към сървър чрез HTTP прокси сървър

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
try (SmtpClient client = new SmtpClient("host", 587, "username", "password")) {
    client.setProxy(proxy);
    client.send(new MailMessage("sender@domain.com", "receiver@domain.com", "Sending Email via proxy",
            "Implement socks proxy protocol for versions 4, 4a, 5 (only Username/Password authentication)"));
}

Персонализиране на механизъм за автентикация

Получете списъка с механизми за автентикация, поддържани от SMTP сървъра, като използвате getSupportedAuthentication метод на SmtpClient клас. Този метод позволява на клиента да определи кои методи за автентикация са достъпни за установяване на сигурна връзка със сървъра. След това, използвайки setAllowedAuthentication метод, който получава (или задава) изброяване на типове автентикация, разрешени от потребителя, изберете най‑подходящия механизъм за автентикация за комуникацията клиент‑сървър. Това ви позволява изрично да зададете метода на автентикация за имейл клиента.

Следният пример с код показва как да персонализирате автентикацията на имейл клиент:

smtpClient.setAllowedAuthentication(SmtpKnownAuthenticationType.Login);

Използване на CRAM-MD5 автентикация за свързване към сървър

За да гарантирате сигурна автентикация и комуникация със SMTP сървъра, можете да зададете и наложите използването на CRAM-MD5 като разрешения метод за автентикация за SMTP клиента. Следният кодов пример показва как да конфигурирате разрешения тип автентикация за SmtpClient:

smtpClient.setAllowedAuthentication(SmtpKnownAuthenticationType.CramMD5);

Свържете SMTP клиент към конкретен IP адрес на хоста

Възможността хостът да разполага с няколко налични портове за изпращане на имейли не може да бъде изключена. В такива случаи може да се появи необходимост да се свърже клиентът за изпращане на имейли към конкретен порт на хоста за изпращане на имейли. Това може да се постигне и чрез Aspose.Email API, използвайки SmtpClient bindIPEndPoint свойство. API-то SmtpClient може да бъде зададено да използва конкретен IP адрес на хоста, като се посочи конкретната IP крайна точка. Следният кодов пример показва как да свържете SMTP клиент към конкретен IP адрес на хоста.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

SmtpClient client = new SmtpClient("smtp.domain.com", // host
        587, // port
        "username", // username
        "password", // password
        SecurityOptions.Auto // Security Options
);
try {
    client.bindIPEndPoint(new BindIPEndPointHandler() {
        public InetSocketAddress invoke(InetSocketAddress remoteEndPoint) {
            return new InetSocketAddress(0);
        }
    });
    client.noop();
} finally {
    client.dispose();
}

Валидация на идентификационни данни на пощенски сървър без изпращане на имейл

Понякога е необходимо да се проверят идентификационните данни без изпращане на имейл. Aspose.Email предоставя validateCredentials() метод за изпълнение на тази операция. Ако валидирането е успешно, кодът вътре в if израза се изпълнява, обикновено се използва за извършване на допълнителни действия или извличане на данни от IMAP сървъра. Следният кодов фрагмент демонстрира валидирането на идентификационни данни без изпращане на имейл:

try (SmtpClient smtpClient = new SmtpClient(
        server.SmtpUrl, server.SmtpPort, "username", "password", SecurityOptions.Auto)) {
    smtpClient.setTimeout(4000);

    if (smtpClient.validateCredentials()) {
        // to do something
    }
}

Как да зададете време за изчакване за пощенски операции

Всяка пощенска операция отнема време в зависимост от много фактори (мрежови закъснения, размер на данните, производителност на сървъра и др.). Можете да зададете време за изчакване за всички пощенски операции. Примерният код по-долу ви показва как да направите това, като използвате Време за изчакване свойство. Забележка: не трябва да задавате големи стойности, за да избегнете дълги изчаквания във вашето приложение.

try (SmtpClient smtpClient = new SmtpClient("host", 587, "username", "password", SecurityOptions.SSLExplicit))
{
    smtpClient.setTimeout(60000); // 60 seconds

    // some code...
}

Java: Изпращане и препращане на съобщения - Изпращане на Outlook имейл съобщения с Java програма

Mon, 01 Jan 0001 00:00:00 +0000

Този SmtpClient класът позволява на приложения да изпращат имейли, използвайки протокола Simple Mail Transfer Protocol (SMTP).

Този SmtpClient класът е единственото основно входно място, което разработчиците използват за изпращане на пощенски съобщения.
Този SmtpClient класът също предоставя други чести методи за доставка на имейли, включително записване на имейл съобщения във файловата система, опашка за съобщения и др.
Този SmtpClient класът изцяло поддържа тези два програмни модела:
- Синхронно
- Асинхронно
Този SmtpClient класът също поддържа изпращане на съобщения като TNEF

За да изпратите имейл съобщението и да блокирате, докато се изчака предаването му до SMTP сървъра, използвайте един от синхронните методи Send. За да позволите на главната нишка на вашата програма да продължи да се изпълнява, докато имейлът се предава, използвайте beginSend метод.

Изпращане на имейли синхронно

Имейл съобщение може да се изпрати синхронно, използвайки SmtpClient клас send метод. Той изпраща указаното имейл съобщение през SMTP сървър за доставка. Подателят, получателите, темата и тялото на съобщението се задават с обекти от тип String. За да изпратите имейл съобщение синхронно, следвайте стъпките по-долу:

Създайте инстанция на MailMessage клас и задайте неговите свойства.
Създайте инстанция на SmtpClient клас и посочете хоста, порта, потребителското име и паролата.
Изпратете съобщението, като използвате SmtpClient клас send метод и предайте MailMessage екземпляр.

Следният Java кодов фрагмент ви показва как да изпратите Outlook имейли синхронно.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Declare msg as MailMessage instance
MailMessage msg = new MailMessage();

// Create an instance of SmtpClient class
SmtpClient client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port # and Security option
client.setHost("mail.server.com");
client.setUsername("username");
client.setPassword("password");
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);

try {
    // Client.Send will send this message
    client.send(msg);
    System.out.println("Message sent");
} catch (Exception ex) {
    System.err.println(ex);
}

Изпращане на имейли асинхронно

Понякога може да искате да изпращате поща асинхронно. Например, ако изпращате много имейли чрез вашето приложение, синхронният подход може да не работи. В такъв сценарий можете да използвате beginSend. The beginSend метод на SmtpClient класът изпраща имейл съобщение към SMTP сървър за доставка. Този метод не блокира извикващия нишка и позволява на извикващия да предаде обект на метода, който се извиква, когато операцията завърши. За да изпратите Outlook имейл съобщение асинхронно в Java, следвайте тези стъпки:

Създайте инстанция на MailMessage клас и използвайте различните му свойства.
Създайте инстанция на SmtpClient клас и посочете хоста, порта, потребителското име и паролата.
Създайте потребителско дефинирана инстанция, която ще бъде предадена на метода и извикана, когато асинхронната операция завърши.
Изпратете съобщението, като използвате beginSend метод на SmtpClient клас и предайте MailMessage инстанция и потребителско дефинирана инстанция в нея, заедно с функция за обратно извикване, която да се извика, когато операцията завърши.

За получаване на известие, когато имейлът е изпратен или операцията е отменена, функцията за обратно извикване, предадена на beginSend методът се извиква. След извикване на SmtpClient клас beginSend методът не изисква да се изчака пълното изпращане на имейл съобщение. Можем да извикаме друг метод beginSend едновременно. Когато имейл е изпратен чрез beginSend метод, кодовият фрагмент отпечатва съобщение ("Message Sent"). Следният Java програма или кодов фрагмент показва как да изпратите имейли асинхронно.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

public static void run() {
    sendMail();
}

static SmtpClient getSmtpClient() {
    SmtpClient client = new SmtpClient();
    client.setHost("mail.server.com");
    // Specify your mail Username, Password, Port # and security option
    client.setUsername("username");
    client.setPassword("password");
    client.setPort(587);
    client.setSecurityOptions(SecurityOptions.SSLExplicit);
    return client;
}

static void sendMail() {
    try {

        // Declare msg as MailMessage instance
        MailMessage msg = new MailMessage("sender@gmail.com", "receiver@gmail.com", "Test subject", "Test body");
        SmtpClient client = getSmtpClient();
        Object state = new Object();
        IAsyncResult ar = client.beginSend(msg, callback, state);
        // If the user canceled the send, and mail hasn't been sent yet,
        client.cancelAsyncOperation(ar);

        msg.dispose();
        System.out.println("Goodbye.");
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

static AsyncCallback callback = new AsyncCallback() {
    public void invoke(IAsyncResult ar) {
        IAsyncResultExt task = null;
        if (ar instanceof IAsyncResult)
            task = (IAsyncResultExt) ar;

        if (task != null && task.isCanceled()) {
            System.out.println("Send canceled.");
        }

        if (task != null && task.getErrorInfo() != null) {
            System.out.println(task.getErrorInfo());
        } else {
            System.out.println("Message Sent.");
        }
    }
};

Изпращане на съхранени съобщения от диск

EML файлове (Outlook Express Electronic Mail файлове) съдържат имейл заглавка, тяло на съобщението и всякакви прикачени файлове. Aspose.Email позволява на разработчиците да работят с EML файлове по различни начини. Тази статия показва как да заредите EML файлове от диск и да ги изпратите като имейли чрез SMTP. Можете да заредите .eml файлове от диск или поток в MailMessage клас и изпратете имейл съобщението, използвайки SmtpClient клас. Този MailMessage класът е основният клас за създаване на нови имейл съобщения, зареждане на имейл файлове от диск или поток и запазване на съобщенията. Следният Java кодов фрагмент показва как да изпратите съхранени съобщения от диска.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Load an EML file in MailMessage class
MailMessage message = MailMessage.load(dataDir + "test.eml");

// Send this message using SmtpClient
SmtpClient client = new SmtpClient("host", "username", "password");

try {
    client.send(message);
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

Изпращане на имейл в прост текст

Примерите с код по-долу показват как да изпратите имейл в прост текст. Тяло свойство, свойство на MailMessage клас, който се използва за указване на прост текстовото съдържание на тялото на съобщението. За да изпратите имейл в прост текст, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Посочете имейл адресите на подателя и получателя в MailMessage екземпляр.
Укажете Тяло съдържание, използвано за прост текст съобщението.
Създайте инстанция на SmtpClient клас и изпратете имейла.

Следният кодов фрагмент показва как да изпратите имейл в прост текст.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the MailMessage class
MailMessage message = new MailMessage();

// Set From field, To field and Plain text body
message.setFrom(MailAddress.to_MailAddress("sender@sender.com"));
message.getTo().add("receiver@receiver.com");
message.setBody("This is Plain Text Body");

// Create an instance of the SmtpClient class
SmtpClient client = new SmtpClient();

// And Specify your mailing host server, Username, Password and Port
client.setHost("smtp.server.com");
client.setUsername("Username");
client.setPassword("Password");
client.setPort(25);

try {
    // Client.Send will send this message
    client.send(message);
    System.out.println("Message sent");
} catch (Exception ex) {
    System.err.println(ex);
}

Изпращане на имейл с HTML тяло

Примерите с код по-долу показват как можете да изпратите просто HTML имейл съобщение. HtmlBody, свойство на MailMessage клас, който се използва за указване на HTML съдържанието на тялото на съобщението. За да изпратите прост HTML имейл, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Посочете имейл адресите на подателя и получателя в MailMessage екземпляр.
Укажете HtmlBody съдържание.
Създайте инстанция на SmtpClient клас и изпратете имейла, използвайки send метод.

За целите на тази статия, HTML съдържанието на имейла е простичко: This is the HTML body Повечето HTML имейли ще бъдат по-сложни. Следният Java програмен фрагмент показва как да изпратите имейл с HTML тяло.

public static void run() {
    // Declare msg as MailMessage instance
    MailMessage msg = new MailMessage();

    // Use MailMessage properties like specify sender, recipient, message and HtmlBody
    msg.setFrom(MailAddress.to_MailAddress("newcustomeronnet@gmail.com"));
    msg.setTo(MailAddressCollection.to_MailAddressCollection("asposetest123@gmail.com"));
    msg.setSubject("Test subject");
    msg.setHtmlBody("<html><body>This is the HTML body</body></html>");
    SmtpClient client = getSmtpClient();
    try {
        // Client will send this message
        client.send(msg);
        System.out.println("Message sent");
    } catch (Exception ex) {
        System.err.println(ex);
    }

    System.out.println("Email sent with HTML body.");
}

private static SmtpClient getSmtpClient() {
    SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
    client.setSecurityOptions(SecurityOptions.Auto);
    return client;
}

Изпращане на имейл с алтернативен текст на съобщението

Примерите с код по-долу показват как да изпратите просто HTML имейл съобщение с алтернативно съдържание. Използвайте AlternateView клас за указване на копия на имейл съобщението в различни формати. Например, ако изпратите съобщение в HTML, може да искате да предоставите и версия в прост текст за получатели, които използват клиенти, които не могат да показват HTML съдържание. Или, ако изпращате бюлетин, може да искате да предоставите копие в прост текст за получатели, избрали да получават версия в прост текст. За да изпратите имейл с алтернативен текст, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Посочете имейл адресите на подателя и получателя в MailMessage екземпляр.
Създайте инстанция на AlternateView клас.

Това създава алтернативен изглед на имейл съобщението, използвайки съдържанието, указано в низа.

Добавете инстанцията на AlternateView клас към MailMessage обект.
Създайте инстанция на SmtpClient клас и изпратете имейла, използвайки send метод.

Следният кодов фрагмент показва как да изпратите имейл с алтернативен текст.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Declare message as MailMessage instance
MailMessage message = new MailMessage();

// Creates AlternateView to view an email message using the content specified in the //String
AlternateView alternate = AlternateView.createAlternateViewFromString("Alternate Text");

// Adding alternate text
message.getAlternateViews().addItem(alternate);

Изпращане на масови имейли

Изпращането на имейли масово означава изпращане на група имейли в едно съобщение. Можем да изпратим група имейли, като използваме SmtpClient клас send претоварване на метод, което приема MailMessageCollection клас:

Създайте инстанция на SmtpClient клас.
Укажете SmtpClient свойства на класа.
Създайте инстанция на MailMessage клас.
Посочете подател, получател, тема на имейла и съобщението в инстанцията на MailMessage клас.
Повторете горните две стъпки отново, ако искате да изпратите имейл до различен получател.
Създайте инстанция на MailMessageCollection клас.
Добавете инстанция на MailMessage клас в обекта на MailMessageCollection клас.
Сега изпратете вашия имейл, използвайки SmtpClient клас send метод, като предадете инстанция на MailMessageCollection клас в него.

Следният кодов фрагмент показва как да изпратите масови имейли.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create SmtpClient as client and specify server, port, user name and password
SmtpClient client = new SmtpClient("mail.server.com", 25, "Username", "Password");

// Create instances of MailMessage class and Specify To, From, Subject and Message
MailMessage message1 = new MailMessage("msg1@from.com", "msg1@to.com", "Subject1", "message1, how are you?");
MailMessage message2 = new MailMessage("msg1@from.com", "msg2@to.com", "Subject2", "message2, how are you?");
MailMessage message3 = new MailMessage("msg1@from.com", "msg3@to.com", "Subject3", "message3, how are you?");

// Create an instance of MailMessageCollection class
MailMessageCollection manyMsg = new MailMessageCollection();
manyMsg.addItem(message1);
manyMsg.addItem(message2);
manyMsg.addItem(message3);

// Use client.BulkSend function to complete the bulk send task
try {
    // Send Message using BulkSend method
    client.send(manyMsg);
    System.out.println("Message sent");
} catch (Exception ex) {
    System.err.println(ex);
}

Получаване на информация за масовите изпратени съобщения

Когато изпращате съобщения масово, можете да получите информация за броя успешно изпратени съобщения и списъка с тях. SucceededSending събитие се използва за тази цел.

Следният примерен код показва как да получите информация за броя успешно изпратени съобщения:

try (SmtpClient client = new SmtpClient(host, SecurityOptions.Auto)) {
    final AtomicInteger messageCount = new AtomicInteger(0);

    client.setSucceededSending(new EventHandler<MailMessageEventArgs>() {
        public void invoke(Object sender, MailMessageEventArgs eventArgs) {
            System.out.println("The message " + eventArgs.getMessage().getSubject() + " was successfully sent.");
            messageCount.incrementAndGet();
        }
    });

    client.send(messages);

    System.out.println(messageCount + " messages were successfully sent.");
}

Изпращане на имейли с MultiConnection

SmtpClient предоставя UseMultiConnection свойство, което може да се използва за създаване на множество връзки за тежки операции. Също така можете да зададете броя на връзките, които да се използват по време на режим с множество връзки, като използвате SmtpClient.ConnectionsQuantity. Следният кодов фрагмент демонстрира използването на режим с множество връзки за изпращане на множество съобщения.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

SmtpClient smtpClient = new SmtpClient();
smtpClient.setHost("<HOST>");
smtpClient.setUsername("<USERNAME>");
smtpClient.setPassword("<PASSWORD>");
smtpClient.setPort(587);
smtpClient.setSupportedEncryption(EncryptionProtocols.Tls);
smtpClient.setSecurityOptions(SecurityOptions.SSLExplicit);

List<MailMessage> messages = new ArrayList<MailMessage>();
for (int i = 0; i < 20; i++) {
    MailMessage message = new MailMessage("<EMAIL ADDRESS>", "<EMAIL ADDRESS>", "Test Message - " + UUID.randomUUID().toString(),
            "SMTP Send Messages with MultiConnection");
    messages.add(message);
}

smtpClient.setConnectionsQuantity(5);
smtpClient.setUseMultiConnection(MultiConnectionMode.Enable);
smtpClient.send(messages);

Моля, имайте предвид, че използването на режим с множество връзки не гарантира увеличение на производителността.

Изпращане на съобщение като TNEF

TNEF имейлите имат специално форматиране, което може да се загуби, ако се изпрати чрез стандартното API. Aspose.Email предоставя възможност за изпращане на имейли като TNEF, запазвайки формата. The SmtpClient клас UseTnef свойството може да бъде настроено да изпраща имейла като TNEF. Следният кодов фрагмент ви показва как да изпратите съобщение като TNEF.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

String emlFileName = dataDir + "Message.eml"; // A TNEF Email

// Load from eml
MailMessage eml1 = MailMessage.load(emlFileName, new EmlLoadOptions());
eml1.setFrom(MailAddress.to_MailAddress("somename@gmail.com"));
eml1.getTo().clear();
eml1.getTo().addItem(new MailAddress("first.last@test.com"));
eml1.setSubject("With PreserveTnef flag during loading");
eml1.setDate(new Date());
SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "somename", "password");
client.setSecurityOptions(SecurityOptions.Auto);
client.setUseTnef(true); // Use this flag to send as TNEF
client.send(eml1);

Изпращане на заявки за срещи

Microsoft Outlook предлага функции за календар, както и управление на имейли. Когато потребител отвори имейл с покана за събитие, Outlook го подканва да приеме или откаже поканата. Aspose.Email позволява на разработчиците да добавят календарни функции към вашите имейли.

Изпращане на заявки по имейл

За да изпратите заявки за среща по имейл, следвайте тези стъпки:

Създайте инстанция на MailMessage клас.
Посочете адреси на подател и получател, като използвате инстанция на MailMessage клас.
Инициализирайте инстанция на Appointment клас и предайте неговите стойности.
Посочете обобщение и описание в Calendar екземпляр.
Добавете Calendar) към MailMessage инстанция и предайте й Appointment екземпляр.

|iCalendar заявка за среща, изпратена по имейл| | :- | || Следният кодов фрагмент ви показва как да изпратите заявки по имейл.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the MailMessage class
MailMessage msg = new MailMessage();

// Set the sender, recipient, who will receive the meeting request. Basically, the recipient is the same as the meeting attendees
msg.setFrom(MailAddress.to_MailAddress("newcustomeronnet@gmail.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("person1@domain.com, person2@domain.com, person3@domain.com, asposetest123@gmail.com"));

// Create Appointment instance
Calendar cal = Calendar.getInstance();
cal.set(2015, Calendar.JULY, 17, 13, 0, 0);
Date startDate = cal.getTime();
cal.set(2015, Calendar.JULY, 17, 14, 0, 0);
Date endDate = cal.getTime();
Appointment app = new Appointment("Room 112", startDate, endDate, msg.getFrom(), msg.getTo());
app.setSummary("Release Meetting");
app.setDescription("Discuss for the next release");

// Add appointment to the message and Create an instance of SmtpClient class
msg.addAlternateView(app.requestApointment());
SmtpClient client = getSmtpClient();

try {
    // Client.Send will send this message
    client.send(msg);
    System.out.println("Message sent");
} catch (Exception ex) {
    System.err.println(ex);
}

iCalendar поддръжка за IBM Lotus Notes

Функцията за календар в Aspose.Email се базира на стандарта iCalendar, стандарт за обмен на календарни данни (RFC 2445 или RFC2445 Syntax Reference). Следователно, тя поддържа не само Microsoft Outlook, но и IBM Lotus Notes. За да изпратите заявка за среща в Lotus Notes, следвайте същите стъпки, както е посочено по-горе.

Препратете имейл, използвайки SMTP клиент

Препращане на имейл с SMTP клиент

Препращането на имейл е честа практика в ежедневната дигитална комуникация. Получен имейл може да бъде препратен до конкретни получатели, без да се споделя с оригиналните изпращачи. Aspose.Email API SmtpClient осигурява възможност за препращане на имейл до конкретни получатели. Неговият Препращане методът може да се използва за препращане на получен или запазен имейл към желаните получатели, както е показано в тази статия. Следният кодов фрагмент ви показва как да препратите имейл, използвайки SMTP клиент.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of SmtpClient class
SmtpClient client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port and SecurityOptions
client.setHost("mail.server.com");
client.setUsername("username");
client.setPassword("password");
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);
MailMessage message = MailMessage.load(dataDir + "Message.eml");
client.forward("Recipient1@domain.com", "Recipient2@domain.com", message);

Препращане на имейл без използване на MailMessage

API‑то също поддържа препращане на EML съобщения, без първо да се зареждат в MailMessage. Това е полезно в случаи, когато има ограничени ресурси по отношение на системната памет.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

String host = "mail.server.com";
String username = "username";
String password = "password";
int smtpPort = 587;
String sender = "Sender@domain.com";
MailAddressCollection recipients = new MailAddressCollection();
recipients.add("recepient1@domain.com, recepient2@domain.com");

try (SmtpClient client = new SmtpClient(host, smtpPort, username, password, SecurityOptions.Auto)) {
    String fileName = "test.eml";
    try (FileInputStream fs = new FileInputStream(new File(dataDir + fileName))) {
        client.forward(sender, recipients, fs);
    }
}

Извършване на Mail Merge

Mail merge‑овете ви помагат да създадете и изпратите партида от сходни имейл съобщения. Основата на имейлите е еднаква, но съдържанието може да бъде персонализирано. Обикновено данните за контакт на получателя (име, фамилия, фирма и др.) се използват за персонализиране на имейла.

|Илюстрация как работи сливането на поща:| | :- | || Aspose.Email позволява на разработчиците да настройват сливане на поща, което включва данни от разнообразни източници.

За да извършите сливане на писма (mail merge) с Aspose.Email, изпълнете следните стъпки:

Създайте функция със сигнатурата на името
Създайте инстанция на MailMessage клас.
Посочете подател, получател, тема и тяло.
Създайте подпис за края на имейла.
Създайте инстанция на TemplateEngine клас и предайте му MailMessage екземпляр.
Вземете подписа в TemplateEngine екземпляр.
Създайте инстанция на DataTable клас.
Добавете колоните Receipt, FirstName и LastName като източници на данни в DataTable клас.
Създайте инстанция на DataRow клас.
Посочете адреса за получаване, името и фамилното име в DataRow обект.
Създайте инстанция на MailMessageCollection клас
Укажете TemplateEngine и DataTable инстанции в MailMessageCollection екземпляр.
Създайте инстанция на SmtpClient клас и посочете сървъра, порта, потребителското име и паролата.
Изпращайте имейли, използвайки SmtpClient клас send метод.

В примера по-долу, #FirstName# означава DataTable колона, чиято стойност се задава от потребителя. Следният кодов фрагмент ви показва как да извършите Mail Merge.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    // The path to the File directory.
    String dstEmail = dataDir + "EmbeddedImage.msg";

    // Create a new MailMessage instance
    MailMessage msg = new MailMessage();

    // Add subject and from address
    msg.setSubject("Hello, #FirstName#");
    msg.setFrom(MailAddress.to_MailAddress("sender@sender.com"));

    // Add email address to send email also Add mesage field to HTML body
    msg.getTo().add("your.email@gmail.com");
    String htmlBody = "Your message here/r/n" + "Thank you for your interest in <STRONG>Aspose.Email</STRONG>.";

    // Use GetSignment as the template routine, which will provide the same signature
    htmlBody += "<br><br>Have fun with it.<br><br>#GetSignature()#";

    msg.setHtmlBody(htmlBody);

    // Create a new TemplateEngine with the MSG message, Register GetSignature routine. It will be used in MSG.
    TemplateEngine engine = new TemplateEngine(msg);
    engine.registerRoutine("GetSignature", new TemplateRoutine() {
        public Object invoke(Object[] args) {
            return getSignature(args);
        }
    });

    // Create an instance of DataTable and Fill a DataTable as data source
    DataTable dt = new DataTable();
    dt.getColumns().add("Receipt");
    dt.getColumns().add("FirstName");
    dt.getColumns().add("LastName");

    DataRow dr;
    dr = dt.newRow();
    dr.set("Receipt", "Nancy&lt;Nancy@somedomain.com&gt;");
    dr.set("FirstName", "Nancy");
    dr.set("LastName", "Doe");
    dt.getRows().add(dr);
    dr = dt.newRow();
    dr.set("Receipt", "Andrew&lt;Andrew@somedomain.com&gt;");
    dr.set("FirstName", "Andrew");
    dr.set("LastName", "Doe");
    dt.getRows().add(dr);
    dr = dt.newRow();
    dr.set("Receipt", "Janet&lt;Janet@somedomain.com&gt;");
    dr.set("FirstName", "Janet");
    dr.set("LastName", "Doe");
    dt.getRows().add(dr);

    MailMessageCollection messages;
    try {
        // Create messages from the message and datasource.
        messages = engine.instantiate(dt);

        // Create an instance of SmtpClient and specify server, port, username and password
        SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
        client.setSecurityOptions(SecurityOptions.Auto);

        // Send messages in bulk
        client.send(messages);
    } catch (MailException ex) {
        System.err.println(ex);
    }

    catch (SmtpException ex) {
        System.err.println(ex);
    }

    System.out.println("Message sent after performing mail merge.");
}

// Template routine to provide signature
static Object getSignature(Object[] args) {
    return "Aspose.Email Team<br>Aspose Ltd.<br>" + new Date().toString();
}

Извършване на редово сливане на поща

Потребителят може също да слее отделен ред от данни, за да получи пълен и подготвен MailMessage обект. Това TemplateEngine.merge методът може да се използва за извършване на редово сливане на поща.

// Create message from the data in current row.
MailMessage message = engine.merge(currentRow);

Java: Utility Features - SMTP клиент

Mon, 01 Jan 0001 00:00:00 +0000

Изброяване на разширения на сървъра с използване на Smtp клиент

Aspose.Email SmtpClient ви позволява да извлечете разширенията, които сървърът поддържа, като IDLE, UNSELECT, QUOTA и др. Това помага за идентифициране на наличността на разширението преди да се използва клиентът за конкретната функция. The getCapabilities() методът връща поддържаните типове разширения във формата на масив от низове.

Извличане на разширения на сървъра

Следният кодов фрагмент ви показва как да извлечете разширенията на сървъра.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

SmtpClient client = new SmtpClient("smtp.gmail.com",587,"username","password");
client.setSecurityOptions(SecurityOptions.Auto);
String[] caps = client.getCapabilities();
for (String str:caps)
	System.out.println(str);

Работа със подписано съобщение

Aspose.Email API предоставя възможност за създаване на подписани съобщения с използване на сертификати. The attachSignature метод на MailMessage клас може да се използва за подписване на съобщение за запазване или дори изпращане, като се използва SmtpClient.

Моля, имайте предвид, че Aspose.Email за Java API зависи от Bouncy Castle за функции за криптография.

Bouncy Castle Maven зависимости

<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk15on</artifactId>
<version>1.60</version>
</dependency>

<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcpkix-jdk15on</artifactId>
<version>1.60</version>
</dependency>

Активиране на Bouncy Castle доставчик на сигурността

import java.security.Security;
import org.bouncycastle.jce.provider.BouncyCastleProvider;

if (Security.getProvider("BC") == null)
    Security.addProvider(new BouncyCastleProvider());

Подписване на съобщение

Следният кодов фрагмент ви показва как да подписате съобщение.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

byte[] privateCert = Files.readAllBytes(new File("sample.pfx").toPath());
byte[] publicCert = Files.readAllBytes(new File("sample.cer").toPath());

MailMessage msg = new MailMessage("userfrom@gmail.com", "userto@gmail.com", "Signed message only", "Test Body of signed message");
MailMessage signed = msg.attachSignature(privateCert, "password");
MailMessage encrypted = signed.encrypt(publicCert, "password");
MailMessage decrypted = encrypted.decrypt(privateCert, "password");
MailMessage unsigned = decrypted.removeSignature();// The original message with proper body
MapiMessage mapi = MapiMessage.fromMailMessage(unsigned);

Използване на опцията за отделен сертификат

Уеб-базираните имейл клиенти може да не могат да покажат съдържанието на тялото на подписано съобщение. Това може да се реши, като се отдели сертификатът преди изпращане към уеб-базираните имейл клиенти. Флагът за отделяне в презаредения метод на attachSignature може да се използва за постигане на това. Ако е зададено на true, сертификатът е отделен от имейла и обратно. За да видите тялото на подписаното съобщение в уеб базирани клиенти, трябва да създадете MailMessage с отделен подпис. Следният кодов фрагмент ви показва как да използвате опцията за отделен сертификат.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

MailMessage msg = new MailMessage("dr38445@gmail.com", "dr38445@gmail.com", "subject:Signed message only by AE", "body:Test Body of signed message by AE");
MailMessage signed = msg.attachSignature(privateCert, "password", true);
SmtpClient smtp = getSmtpClient(); //some test smtp client

smtp.send(signed);