A JavaMail egy Java nyelven írt alkalmazásprogramozási felület, amivel e-maileket lehet küldeni és fogadni SMTP, POP3 és IMAP protokollokon keresztül. A JavaMail a Java EE része, de egy opcionális csomag formájában Java SE környezetben is használható.
A hivatalos referenciaimplementáció mellett létezik egy másik, szintén nyílt forráskódú implementáció, a GNU JavaMail. Igaz, hogy csak a JavaMail 1.3-as változatát támogatja, de ezen kívül lehetőséget kínál NNTP csatlakozásra is. Ezzel a rendszerrel tehát hírfolyamcikkeket lehet írni és olvasni.
A JavaMail komponensei
Message osztály: egy levél attribútumait és a tartalmi részét foglalja magába Folder osztály: leveleket és almappákat tartalmazhat, valamint levelek másolását, törlését, összefűzését is lehetővé tevő metódusokat definiál Store osztály: egy adatbázist definiál, amely magába foglalja a könyvtárszerkezetet és az abban lévő leveleket, valamint metódusokat biztosít az adatbázishoz kapcsolódáshoz, lekérdezéséhez, valamint a kapcsolat megszüntetéséhez Transport osztály: a levél célba való eljuttatásáért felelős, metódusokat definiál a több címzettnek való küldéshez is Session osztály: olyan globális és felhasználókénti tulajdonságokat definiál, amelyek meghatározzák a levelezésre képes alkalmazások és a hálózat közötti interfészt
A JavaMail használata
1. Egy JavaMail kliens jellemzően egy Session objektum létrehozásával kezdődik:
Session session = Session.getInstance(props, authenticator);
2. A Session objektum getStore() metódusának segítségével kapcsolódik az alapértelmezett tárolóhoz, valamint a connect() metódus segítségével hozhatja létre a tényleges kapcsolatot:
Store store = session.getStore(); store.connect();
3. Amennyiben a kapcsolat sikeresen létrejött, a kliens eléri az adott tároló mappáit és az azokban lévő leveleket:
// az INBOX mappa lekérése Folder inbox = store.getFolder("INBOX"); // az INBOX mappa megnyitása inbox.open(Folder.READ_WRITE); // az első levél lekérése Message m = inbox.getMessage(1); // a levél címének lekérése String subject = m.getSubject(); // a levél tartalmának lekérése Object content = m.getContent();
4. Végezetül a kliens bezárja az összes megnyitott mappát, valamint a tárolót:
// INBOX bezárása inbox.close(); // a tároló bezárása store.close();
Egyrészes, sima szöveges e-mail küldése
import java.util.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*;
public class TestEmail {
public static void main(String[] args) {
String to = "sendToMailAddress"; String from = "sendFromMailAddress"; String host = "smtp.yourisp.net";
Properties props = new Properties();
// Ha a statikus Transport.send()-et használjuk, // meg kell adni melyik hoston keresztül küldjünk props.put("mail.smtp.host", host);
// Debug bekapcs props.put("mail.debug", "true"); Session session = Session.getInstance(props);
try { Message msg = new MimeMessage(session);
msg.setFrom(new InternetAddress(from)); InternetAddress[] address = {new InternetAddress(to)}; msg.setRecipients(Message.RecipientType.TO, address); msg.setSubject("sima, szöveges email java kódból"); msg.setSentDate(new Date()); msg.setText("Íme itt az üzenet,\n" + "ez a második sora.");
Transport.send(msg);
catch (MessagingException mex) { mex.printStackTrace();
Többrészes e-mail és HTML-e-mail küldése valamint fájl csatolása import java.util.*; import java.io.*; import javax.mail.*; import javax.mail.internet.*; import javax.activation.*;
public class SendMailUsage {
public static void main(String[] args) {
String to = "sendToMailAddress"; String from = "sendFromMailAddress"; String host = "smtpserver.yourisp.net";
Properties props = new Properties();
// Ha a statikus Transport.send()-et használjuk, // meg kell adni melyik hoston keresztül küldjünk props.put("mail.smtp.host", host);
// Debug bekapcsolása props.put("mail.debug", "true");
Session session = Session.getInstance(props);
try { // Transport objektummal történő küldés Transport bus = session.getTransport("smtp");
// Csak egyszer csatlakozik // Transport.send() minden küldés után kapcsolatot bont // Általában, SMTP-hez nem szükséges felhasználónév és jelszó bus.connect(); //de ha mégis, akkor //bus.connect("smtpserver.yourisp.net", "username", "password");
Message msg = new MimeMessage(session);
msg.setFrom(new InternetAddress(from)); InternetAddress[] address = {new InternetAddress(to)}; msg.setRecipients(Message.RecipientType.TO, address); msg.setSubject("javás emailküldés"); msg.setSentDate(new Date());
// Üzenet tartalmának megadása és küldés setTextContent(msg); msg.saveChanges(); bus.sendMessage(msg, address);
setMultipartContent(msg); msg.saveChanges(); bus.sendMessage(msg, address);
setFileAsAttachment(msg, "C:/WINDOWS/CLOUD.GIF"); msg.saveChanges(); bus.sendMessage(msg, address);
setHTMLContent(msg); msg.saveChanges(); bus.sendMessage(msg, address);
bus.close();
catch (MessagingException mex) { mex.printStackTrace();
// Egyszerű, egyrészes text/plain email public static void setTextContent(Message msg) throws MessagingException { // Üzenet tartalmának beállítása String mytxt = "Íme itt az email, \n" + "ez a második sora."; msg.setText(mytxt);
// A form tartalmának megváltoztatása az általunk definiáltra msg.setContent(mytxt, "text/plain");
// Egyszerű többrészes e-mail. Mindkét törzsrész text/plain. public static void setMultipartContent(Message msg) throws MessagingException { // Első rész létrehozása és kitöltése MimeBodyPart p1 = new MimeBodyPart(); p1.setText("This is part one of a test multipart e-mail.");
// Második rész létrehozása és kitöltése MimeBodyPart p2 = new MimeBodyPart(); // A karakterkészlet beállítása p2.setText("Ez a második rész", "utf-8");
// Multipart létrehozása. A törzsrészeket hozzáadjuk. Multipart mp = new MimeMultipart(); mp.addBodyPart(p1); mp.addBodyPart(p2);
// Beállítjuk a Multipartot az üzenet tartalmának msg.setContent(mp);
// Fájl csatolása a JAF FileDataSource használatával: public static void setFileAsAttachment(Message msg, String filename)throws MessagingException {
// Első rész létrehozása és kitöltése MimeBodyPart p1 = new MimeBodyPart(); p1.setText("Ez az email első része." + "A második rész csatolmány.");
// Második rész létrehozása és kitöltése MimeBodyPart p2 = new MimeBodyPart();
// Betesszük a fájlt a második részbe FileDataSource fds = new FileDataSource(filename); p2.setDataHandler(new DataHandler(fds)); p2.setFileName(fds.getName());
// Multipart létrehozása. A törzsrészeket hozzáadjuk. Multipart mp = new MimeMultipart(); mp.addBodyPart(p1); mp.addBodyPart(p2);
// Beállítjuk a Multipart-ot üzenet tartalmának msg.setContent(mp);
// Egyrészes HTML-tartalom beállítása. // Bármilyen más típusú adat küldése hasonló public static void setHTMLContent(Message msg) throws MessagingException {
String html = "<html><head><title>" + msg.getSubject() + "</title></head><body><h1>" + msg.getSubject() + "</h1><p>This is a test of sending an HTML e-mail" + " through Java.</body></html>";
// HTMLDataSource egy belső osztály msg.setDataHandler(new DataHandler(new HTMLDataSource(html)));
/* * Belső osztály, hogy JAF adatforrásként HTML e-mail tartalmat *küldhessünk */ Static class HTMLDataSource implements DataSource { private String html;
public HTMLDataSource(String htmlString) { html = htmlString;
// HTML string InputStream-ként történő visszaadása. // Minden alkalommal új folyamot kell visszaadni. public InputStream getInputStream() throws IOException { if (html == null) throw new IOException("Null HTML"); return new ByteArrayInputStream(html.getBytes());
public OutputStream getOutputStream() throws IOException { throw new IOException("This DataHandler cannot write HTML");
public String getContentType() { return "text/html";
public String getName() { return "JAF text/html dataSource to send e-mail only";
Licence A JavaMail a Project Kenai részeként nyílt forráskódú program.
A forráskód a következő licencek alatt érhető el: CDDL-1.0 GPL-2.0 BSD
Források http://www.oracle.com/technetwork/java/javamail-1-149769.pdf http://download.oracle.com/docs/cd/E19644-01/817-5449/djmail.html
További információk JavaMail projekt site-ja a Kenai-n GNU JavaMail
Kategória:Java API-k Kategória:Java-kódpéldák