Page History

Polish

Wstęp

Przydatne klasy:

EmailService - wysyłanie maili
EmailConfigurationService - pobieranie konfiguracji skrzynek pocztowych

Pobieranie konfiguracji

Code Block

language	java
linenumbers	true

//Pobieranie konfiguracji skrzynki pocztowej
EmailConfiguration emailConfiguration = emailConfigurationService.getDefaultConfiguration(); // Pobranie domyślnej konfiguracji
EmailConfiguration emailConfiguration1 = emailConfigurationService.get( 1L,EmailConfiguration.JOIN_CONNECTION ); // Pobranie po id konfiguracji w bazie danych

Wysyłanie maila za pomocą obiektu EmailMessage

Code Block

language	java
title	Podstawowe
linenumbers	true

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) // Odbiorca wiadomości
    .subject( "Testowy email" ) // Temat wiadomości
    .content( "To jest przykładowy email" ) // Zawartość wiadomości
    .build();

emailService.send( emailMessage ); // Za pomocą domyślnej konfiguracji
emailService.send( emailMessage, emailConfiguration ); // Za pomocą pobranej wcześniej konfiguracji

Code Block

language	java
title	Wysyłanie do wielu oraz kopie i ślepe kopie
linenumbers	true

EmailMessage emailMessage = EmailMessage.builder()
    .recipients( Arrays.asList( "test@testowy.pl", "test@testowy.pl") ) //Odbiorcy
    .copyRecipients( Arrays.asList( "test-copy@testowy.pl", "test-copy1@testowy.pl") ) // Odbiorcy kopii
    .hiddenCopyRecipients( Arrays.asList( "test-blindcopy@testowy.pl", "test-blindcopy1@testowy.pl") ) // Odbiorcy ślepych kopii
    .subject( "Testowy email" ) //Temat wiadomości
    .content( "To jest przykładowy email" ) //Zawartość wiadomości
    .build();

Code Block

language	java
title	Dodatkowe opcje konfiguracyjne
linenumbers	true

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Odbiorca wiadomości
    .subject( "Testowy email" ) //Temat wiadomości
    .content( "To jest <b>przykładowy</b> email" ) //Zawartość wiadomości
    .isHtml( true ) //Czy zawartość wiadomości jest html
    .test( false ) // Czy jest to wiadomość testowa, jeśli tak to nie będzie wysyłana buforowo
    .build();

Code Block

language	java
title	Dołączanie załączników
linenumbers	true

//Tworzenie załączników
EmailAttachment zal1 = EmailAttachment.builder()
    .file( new File( "C:\\test\\plik1.txt" ) )
    .filename( "zal1.txt" )
    .build();

EmailAttachment zal2 = EmailAttachment.builder()
    .file( new File( "C:\\test\\plik2.txt" ) )
    .filename( "zal2.txt" )
    .build();

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Odbiorca wiadomości
    .subject( "Testowy email" ) //Temat wiadomości
    .content( "To jest przykładowy email" ) //Zawartość wiadomości
    .attachments( Arrays.asList( zal1, zal2 ) ) // Dołączanie załączników
    .build();

Code Block

language	java
title	Podmienianie parametrów w temacie i zawartości
linenumbers	true

//Tworzenie listy parametrów
Map<String,String> paramMap = new HashMap<>();
paramMap.put( "param1","Pierwszy argument" );
paramMap.put( "param2","Drugi argument" );

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "

...

test@testowy.pl" ) //Odbiorca wiadomości
    .subject( "Testowy email @param1@" ) //Temat wiadomości
    .content( "Test: @param2@" ) //Zawartość wiadomości
    .params( paramMap ) // Parametry, które mają zostać podmienione w temacie i zawartości wiadomości
    .build();

Code Block

language	java
title	Szablon zawartości
linenumbers	true

// Za pomocą pliku
EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "

...

test@testowy.pl" ) //Odbiorca wiadomości
    .subject( "Testowy email" ) //Temat wiadomości
    .template( new File( "C:\\test\\szablon.html" ) ) // Szablon zawartości
    .build();
 
// Za pomocą input streama
try ( InputStream inputStream = new FileInputStream( "C:\\test\\szablon1.html" ) )
{
    EmailMessage emailMessage = EmailMessage.builder()
        .recipient( "

...

test@testowy.pl" ) //Odbiorca wiadomości
        .subject( "Testowy email" ) //Temat wiadomości
        .templateInputStream( inputStream ) // Szablon zawartości
        .build();
}

Code Block

language	java
title	Dodatkowe informacje do audytów
linenumbers	true

//Tworzenie informacji dla audytu
EmailInfo emailInfo = EmailInfo.builder()
    .activityId( "zad23" )
    .processId( "proc73453" )
    .build();

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "

...

test@testowy.pl" ) //Odbiorca wiadomości
    .subject( "Testowy email" ) //Temat wiadomości
    .content( "Testowa zawartość" ) // Zawartość wiadomości
    .emailInfo( emailInfo ) // Dołączanie informacji
    .build();

Wysyłanie maila za pomocą MimeMessage

Code Block

language	java
linenumbers	true

//Pobranie sesji
Session mailSession = emailService.getSession(); // Pobranie domyślnej sesji
Session mailSession1 = emailService.getSession(emailConfiguration); // Pobranie sesji z konkretnej konfiguracji

//Tworzenie wiadomości
MimeMessage mimeMessage = new MimeMessage( mailSession );
mimeMessage.addRecipients( Message.RecipientType.TO, "

...

test@testowy.pl" ); // Dodanie odbiorcy
mimeMessage.setSubject( "Testowa wiadomość", "UTF-8" ); // Ustawienie tematu
mimeMessage.setSentDate( new Date() ); // Ustawienie daty wysłania
mimeMessage.setFrom( new InternetAddress( "test-nadawca@testowy.pl" ) ); // Ustawienie nadawcy
mimeMessage.setText( "Testowa zawartość" ); // Ustawienie zawartości

emailService.send( mimeMessage ); // Wysłanie z podstawowej konfiguracji
emailService.send( mimeMessage, emailConfiguration ); // Wysłanie z podanej konfiguracji
emailService.send( mimeMessage, emailInfo ); // Wysłanie z podstawowej konfiguracji oraz informacją dla audytów
emailService.send( mimeMessage, emailConfiguration, emailInfo ); // Wysłanie z podanej konfiguracji oraz informacją dla audytów

English

Introduction

Useful calsses

EmailService - sending email
EmailConfigurationService - downloading mailbox configurations

Download configuration

Code Block

language	java
linenumbers	true

// Download configuration of the mailbox
EmailConfiguration emailConfiguration = emailConfigurationService.getDefaultConfiguration(); //  Download default configuration
EmailConfiguration emailConfiguration1 = emailConfigurationService.get( 1L,EmailConfiguration.JOIN_CONNECTION ); // Download configuration by database  id

Sending an email using the EmailMessage object

Code Block

language	java
title	Sending to many and copies and blind copies
linenumbers	true

EmailMessage emailMessage = EmailMessage.builder()
    .recipients( Arrays.asList( "test@testowy.pl", "test@testowy.pl") ) //Recipients
    .copyRecipients( Arrays.asList( "test-copy@testowy.pl", "test-copy1@testowy.pl") ) // Copy Recipients
    .hiddenCopyRecipients( Arrays.asList( "test-blindcopy@testowy.pl", "test-blindcopy1@testowy.pl") ) // Blind Copy Recipients
    .subject( "Testowy email" ) //Message title
    .content( "To jest przykładowy email" ) //Message content
    .build();

Code Block

language	java
title	Additional configuration options
linenumbers	true

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Message recipient
    .subject( "Testowy email" ) //Temat wiadomości
    .content( "To jest <b>przykładowy</b> email" ) //Message content
    .isHtml( true ) //Is the message content html
    .test( false ) // Is this a test message, if so it will not be sent buffered
    .build();

Code Block

language	java
title	Attachments
linenumbers	true

//Create attachments
EmailAttachment zal1 = EmailAttachment.builder()
    .file( new File( "C:\\test\\plik1.txt" ) )
    .filename( "zal1.txt" )
    .build();

EmailAttachment zal2 = EmailAttachment.builder()
    .file( new File( "C:\\test\\plik2.txt" ) )
    .filename( "zal2.txt" )
    .build();

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Message recipient
    .subject( "Testowy email" ) //Message title
    .content( "To jest przykładowy email" ) //Message content
    .attachments( Arrays.asList( zal1, zal2 ) ) // Attachments
    .build();

Code Block

language	java
title	Parameter substitution in theme and content
linenumbers	true

//Tworzenie listy parametrów
Map<String,String> paramMap = new HashMap<>();
paramMap.put( "param1","Pierwszy argument" );
paramMap.put( "param2","Drugi argument" );

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Message recipient
    .subject( "Testowy email @param1@" ) //Message title
    .content( "Test: @param2@" ) //Message content
    .params( paramMap ) // Parameters to be substituted in the title and content of the message
    .build();

Code Block

language	java
title	Content template
linenumbers	true

// Za pomocą pliku
EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Message recipient
    .subject( "Testowy email" ) //Message title
    .template( new File( "C:\\test\\szablon.html" ) ) // Content template
    .build();
 
// Za pomocą input streama
try ( InputStream inputStream = new FileInputStream( "C:\\test\\szablon1.html" ) )
{
    EmailMessage emailMessage = EmailMessage.builder()
        .recipient( "test@testowy.pl" ) //Message recipient
        .subject( "Testowy email" ) //Message title
        .templateInputStream( inputStream ) // Content template
        .build();
}

Code Block

language	java
title	Additional information for audits
linenumbers	true

//Tworzenie informacji dla audytu
EmailInfo emailInfo = EmailInfo.builder()
    .activityId( "zad23" )
    .processId( "proc73453" )
    .build();

EmailMessage emailMessage = EmailMessage.builder()
    .recipient( "test@testowy.pl" ) //Message recipient
    .subject( "Testowy email" ) //Message title
    .content( "Testowa zawartość" ) // Message content
    .emailInfo( emailInfo ) // Attaching information
    .build();

Sending an email using MimeMessage

Code Block

language	java
linenumbers	true

//Session download
Session mailSession = emailService.getSession(); // Default session download
Session mailSession1 = emailService.getSession(emailConfiguration); // Downloading a session from a specific configuration

//Tworzenie wiadomości
MimeMessage mimeMessage = new MimeMessage( mailSession );
mimeMessage.addRecipients( Message.RecipientType.TO, "test@testowy.pl" ); // Message recipient
mimeMessage.setSubject( "Testowa wiadomość", "UTF-8" ); // Set title
mimeMessage.setSentDate( new Date() ); // Sending date setting
mimeMessage.setFrom( new InternetAddress( "test-nadawca@testowy.pl" ) ); // Sender setup
mimeMessage.setText( "Testowa zawartość" ); // Ustawienie zawartości

emailService.send( mimeMessage ); // Sending from a basic configuration
emailService.send( mimeMessage, emailConfiguration ); // Sending from a specific configuration
emailService.send( mimeMessage, emailInfo ); // Sending with basic configuration and information for audits
emailService.send( mimeMessage, emailConfiguration, emailInfo ); // Sending from the given configuration and information for audits

Versions Compared

Old Version 1

New Version Current

Key

Wstęp

Pobieranie konfiguracji

Wysyłanie maila za pomocą obiektu EmailMessage

Wysyłanie maila za pomocą MimeMessage

Introduction

Download configuration

Sending an email using the EmailMessage object

Sending an email using MimeMessage