Documentation – עבודה עם לקוח POP3

Java: התחבר לשרת POP3

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

ה Pop3Client המחלקה מאפשרת ליישומים לנהל תיבות דואר באמצעות Post Office Protocol, גרסה 3 (POP3). כדי להתחבר לשרת, השתמש ב‑ Pop3Client מחלקה. ה- Pop3Client המחלקה היא הכניסה המרכזית למפתחים המעוניינים להוסיף ניהול POP3 ליישומי .NET שלהם. מאמר זה מסביר כיצד להשתמש בה. להתחברות לשרת POP3:

צור מופע של Pop3Client מחלקה.
ציין את המארח, שם המשתמש והסיסמה ב‑ Pop3Client מופע.

הקטע הקוד שלהלן מציג כיצד להתחבר לשרת POP3.

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

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

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connected to POP3 server.");

התחברות לשרת SSL

התחברות לשרת POP3 הוסבר כיצד להתחבר לשרת POP3 בשלושה שלבים פשוטים:

צור מופע של Pop3Client מחלקה.
ציין את המארח, שם המשתמש והסיסמה.

התהליך להתחברות לשרת POP3 עם SSL דומה אך דורש להגדיר כמה מאפיינים נוספים:

SecurityOptions
פורט

כדי להתחבר לשרת POP3 עם SSL, השתמש ב‑ Pop3Client מחלקה והגדר את SecurityOptions ומאפייני פורט. הקטע הקוד שלהלן מציג כיצד להתחבר לשרת POP3 עם SSL.

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

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

// Specify host, username and password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connecting to POP3 server using SSL.");

התחברות לשרת APOP

POP הוא קיצור של Post Office Protocol. APOP הוא קיצור של Authenticated Post Office Protocol. APOP הוא גרסה מורחבת של הגדרות שרת POP3 המשמשת להצפנת שם המשתמש והסיסמה שלך ומשתמשת במנגנון אימות המיועד להגן על סיסמת חשבון POP3 שלך בעת בדיקת אימייל. אימות APOP אינו דורש שליחת סיסמת החשבון כטקסט גלוי לשרת הדואר POP3.

התחברות לשרת דרך פרוקסי

שרתים פרוקסי נפוצים מאוד לתקשורת עם העולם החיצון. במקרים כאלה, כתובות הפרוקסי משמשות לקוחות דואר לגישה לתיבות הדואר דרך האינטרנט. Aspose.Email תומך בגרסאות 4, 4a ו‑5 של פרוטוקול הפרוקסי SOCKS. מאמר זה מציג דוגמה עובדת של שליפת אימייל באמצעות שרת דואר פרוקסי. כדי לשאוב אימייל דרך פרוקסי:

אתחול פרוקסי עם המידע הנדרש, כלומר כתובת הפרוקסי, הפורט וגירסת SOCKS.
אתחול Pop3Client עם כתובת המארח, שם משתמש, סיסמה, וכל ההגדרות האחרות.
הגדר את מאפיין הפרוקסי של הלקוח ל‑ פרוקסי אובייקט שנוצר למעלה.

הקטע הקוד שלהלן מציג כיצד לשאוב אימיילים דרך פרוקסי.

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

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client("pop.domain.com", "username", "password");

// Set proxy address, Port and Proxy
String proxyAddress = "192.168.203.142";
int proxyPort = 1080;
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);
client.setProxy(proxy);
Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();

התחברות לשרת דרך פרוקסי 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 (Pop3Client client = new Pop3Client("imap.domain.com", "username", "password")) {
    client.setProxy(proxy);
    Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();
}

התאמת מנגנון האימות

קבל את רשימת מנגנוני האימות הנתמכים על ידי שרת ה‑POP3 באמצעות ה‑ getSupportedAuthentication שיטה של Pop3Client מחלקה. מתודה זו מאפשרת ללקוח לקבוע אילו שיטות אימות זמינות להקמת חיבור מאובטח עם השרת. לאחר מכן, באמצעות ה‑ setAllowedAuthentication מתודה שמקבלת (או מגדירה) מונה של סוגי האימות המותרים למשתמש, בחרו במנגנון האימות המתאים ביותר לתקשורת לקוח‑שרת. מאפשר להגדיר באופן מפורש את שיטת האימות עבור לקוח הדואר.

דוגמת הקוד שלהלן מציגה כיצד להתאים אישית את אימות לקוח האימייל:

pop3Client.setAllowedAuthentication(Pop3KnownAuthenticationType.Plain);

תמיכה בפרוטוקול OAuth 2.0 עבור הרשאה

OAuth 2.0 מספק הרשאה

Pop3Client תומך ב‑OAuth 2.0 ומספק דרכי הרשאה ספציפיות ליישומים. הקונסטרוקטורים הבאים משמשים לאתחול POP3Client באמצעות OAuth:

public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/ 

            String username, /*The user name*/

            ITokenProvider tokenProvider, /*TokenProvider allowing to retrieve access token*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/



public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/

            String username, /*The user name*/

            String authInfo, /*The user password or XOAUTH2 access token*/

            boolean useOAuth, /*Defines whether SASL XOAUTH2 mechanism is used to login to the server*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/

אימות אישורי שרת המייל ללא שליחת אימייל

לפעמים יש צורך לאמת אישורים ללא שליחת אימייל. Aspose.Email מספקת את validateCredentials() method לביצוע פעולה זו. אם האימות מצליח, הקוד בתוך תנאי ה‑if מתבצע, בדרך כלל לשימוש לפעולות נוספות או לאחזור נתונים משרת IMAP. קטע הקוד הבא מדגים אימות של אישורים ללא שליחת אימייל:

try (Pop3Client pop3Client = new Pop3Client(
        server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto)) {
    pop3Client.setTimeout(4000);

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

שימוש באימות CRAM‑MD5 לחיבור לשרת

כדי להבטיח אימות ותקשורת בטוחה עם שרת ה‑POP3, ניתן לציין ולאכוף את השימוש ב‑CRAM‑MD5 כשיטת האימות המותרת ללקוח ה‑POP3. הקטע הקוד הבא מציג כיצד להגדיר את סוג האימות המותר עבור ה‑ Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

כיצד להגדיר זמן קצוב לפעולות דואר

כל פעולת דואר לוקחת זמן מסוים בהתאם למגוון גורמים (עיכובי רשת, גודל הנתונים, ביצועי השרת, וכו’). ניתן להגדיר זמן קצוב לכל פעולות הדואר. דוגמת הקוד שלהלן מראה כיצד לבצע זאת באמצעות זמן קצוב מאפיין. הערה: אין להגדיר ערכים גדולים כדי למנוע המתנה ארוכה באפליקציה שלך.

try (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.setTimeout(60000); // 60 seconds

    // some code...
}

Java: מחיקת הודעות משרת POP3

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

Aspose.Email הוא רכיב חזק המאפשר לבצע פעולות מותאמות לאחר פעולות מסוימות. Aspose.Email פולט אירועים רבים שעל פיהם משתמשים יכולים לבצע פעולות. תכונה זו מעניקה למשתמשים שליטה רבה יותר על היישום שלהם. לדוגמא, משתמשים יכולים לבצע את הפעולות הרצויות שלהם כאשר:

כל האימיילים ההמוניים נשלחו.
הודעה עומדת להישלח.
אימייל נשלח במלואו.
כאשר הנמען נדחה על ידי שרת ה‑SMTP.

תיבות דואר POP3 ממוקמות בשרת POP3. ניתן לשאוב את האימיילים מתיבות אלו למחשב שלך על‑ידי Pop3Client. ה Pop3Client המחלקה משתמשת בפרוטוקול POP3 כדי להעתיק את הודעות הדואר מתיבת ה‑POP3 שלך למחשב שלך. לאחר שהדואר נשא אתה לא צריך להיות מחובר לאינטרנט בזמן הקריאה, מכיוון שאתה יכול לקרוא את הדואר שהורד על המחשב. אם אינך צריך או רוצה עותק של חלק מהודעות הדואר על שרת ה‑POP3, אתה יכול למחוק אותן. חלק זה מציג כיצד למחוק אימיילים באמצעות Pop3Client מחלקה.

מחק אימייל לפי אינדקס

הקטע הקוד הבא מוחק את כל הודעות הדואר בתיבת הדואר אחת אחרי השנייה, על בסיס האינדקס שלה. האינדקס לעולם אינו צריך להיות <=0 ב‑ Pop3Client.deleteMessage.

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

// Create a POP3 client
Pop3Client client = new Pop3Client("mail.aspose.com", 110, "username", "psw");
try {
    // Delete all the message one by one
    int messageCount = client.getMessageCount();
    for (int i = 1; i <= messageCount; i++) {
        client.deleteMessage(i);
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

מחק את כל האימיילים

אנו עשויים גם לקרוא ל‑ Pop3Client.deleteMessages למחוק את כל ההודעות. הקטע הקוד שלהלן מציג כיצד למחוק את כל האימיילים.

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

// Delete all the messages
client.deleteMessages();

אם החיבור לשרת POP3 נקטע מיד לאחר פעולות המחיקה, לא ניתן יותר לקרוא ל‑ Pop3Client.cancelDeletes() לביצוע הפעולות הרצויות.

ביטול מחיקות

Pop3Client.undeleteMessages ניתן להשתמש בו לביטול מחיקת הודעות אימייל. הקטע הקוד הבא מציג כיצד לבטל מחיקות.

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

// Cancel deletes
client.undeleteMessages();

Java: רישום הרחבות השרת באמצעות Pop3Client

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

Aspose.Email Pop3Client מאפשר לך לאחזר את הרחבות השרת שמשרת תומך בהם כגון IDLE, UNSELECT, QUOTA, וכד’. זה מסייע בזיהוי זמינות ההרחבה לפני שימוש בלקוח עבור תפקוד זה. ה getCapabilities() method מחזירה את סוגי ההרחבות הנתמכות בצורת מערך מחרוזות.

אחזור הרחבות השרת

דוגמת הקוד שלהלן מציגה שליפת הרחבות השרת באמצעות Pop3Client עבור שרת Gmail.

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

// Connect and log in to POP3
Pop3Client client = new Pop3Client("pop.gmail.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
client.setPort(995);
String[] getCaps = client.getCapabilities();
for (String item : getCaps) {
    System.out.println(item);
}

Java: עבודה עם הודעות מהשרת

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

קבלת מידע על תיבת הדואר

אנו יכולים לקבל מידע על תיבת הדואר כגון מספר ההודעות וגודל תיבת הדואר באמצעות ה- getMailBoxSize ו getMailBoxInfo מתודות של ה- Pop3Client מחלקה.

ה getMailBoxSize המתודה מחזירה את גודל תיבת הדואר בתים.
ה getMailBoxInfo המתודת מחזירה אובייקט מסוג Pop3MailBoxInfo.

ניתן גם לקבל את מספר ההודעות באמצעות ה- MessageCount מאפיין והגודל באמצעות ה- OccupiedSize מאפיין של Pop3MailBoxInfo מחלקה. קוד הדוגמה הבא מראה כיצד לקבל מידע על תיבת הדואר. הוא מציג כיצד:

צור Pop3Client.
התחבר לשרת POP3.
קבל את הגודל של תיבת הדואר.
קבל מידע על תיבת הדואר.
קבל את מספר ההודעות בתיבת הדואר.
קבל את הגודל הכבוש.

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

Pop3Client client = new Pop3Client();
// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

// Get the size of the mailbox, Get mailbox info, number of messages in the mailbox
long nSize = client.getMailboxSize();
System.out.println("Mailbox size is " + nSize + " bytes.");
Pop3MailboxInfo info = client.getMailboxInfo();
int nMessageCount = info.getMessageCount();
System.out.println("Number of messages in mailbox are " + nMessageCount);
long nOccupiedSize = info.getOccupiedSize();
System.out.println("Occupied size is " + nOccupiedSize);

קבלת מספר הודעות דוא"ל בתיבת הדואר

קוד הדוגמה הבא מראה כיצד לספור את הודעות הדוא"ל בתיבת הדואר.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
Pop3Client client = new Pop3Client("pop3.server.com", "username", "password");
try {
    client.setSecurityOptions(SecurityOptions.Auto);
    int i = client.getMessageCount();
    System.out.println("Message count: " + i);
} catch (Pop3Exception ex) {
    System.out.println("Error:" + ex.toString());
}

Aspose.Email מאפשר למפתחים לעבוד עם הודעות דוא"ל במגוון דרכים. לדוגמה, הם יכולים לאחזר מידע כותרת לפני קבלת החלטה האם להוריד הודעת דוא"ל. או שהם יכולים לאחזר הודעות משרת ולשמור אותן ללא ניתוח (מהיר יותר) או לאחר ניתוח (איטי יותר). מאמר זה מציג כיצד לאחזר ולהמיר הודעות דוא"ל.

קבלת מידע על כותרות דוא"ל

כותרות דוא"ל יכולות לספק לנו מידע על הודעת דוא"ל שעליו אנו יכולים להשתמש כדי להחליט האם לאחזר את כל ההודעה. בדרך כלל, מידע הכותרת כולל שולח, נושא, תאריך קבלה, וכו’. (כותרות דוא"ל מתוארות בפרוטרוט ב- התאמת כותרות דוא"ל. נושא זה מתמקד במיוחד בשליחת דוא"ל באמצעות SMTP, אך מידע כותרות הדוא"ל נשאר תקף עבור הודעות POP3). הדוגמאות הבאות מראות כיצד לאחזר כותרות דוא"ל משרת POP3 באמצעות מספר הרצף של ההודעה.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username. password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
try {
    HeaderCollection headers = client.getMessageHeaders(1);
    for (int i = 0; i < headers.size(); i++) {
        // Display key and value in the header collection
        System.out.print(headers.getKey(i));
        System.out.print(" : ");
        System.out.println(headers.get(i));
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

קבלת הודעות דוא"ל

ה Pop3Client רכיב המחלקה מספק את האפשרות לאחזר הודעות דוא"ל משרת POP3 ולנתח אותן ל- MailMessage מופע בעזרת MailMessage רכיבים. ה‑ MailMessage מחלקה מכילה כמה מאפיינים ומתודות למניפולציה על תוכן האימייל. באמצעות fetchMessage שיטה של Pop3Client מחלקה, אתה יכול לקבל MailMessage מופע ישירות מהשרת POP3. הקטע הקוד הבא מציג כיצד לשאוב הודעת אימייל מלאה מהשרת POP3.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
try {
    int messageCount = client.getMessageCount();
    // Create an instance of the MailMessage class and Retrieve message
    MailMessage message;
    for (int i = 1; i <= messageCount; i++) {
        message = client.fetchMessage(i);
        System.out.println("From:" + message.getFrom());
        System.out.println("Subject:" + message.getSubject());
        System.out.println(message.getHtmlBody());
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

שילוף מידע מסכם של הודעה באמצעות מזהה ייחודי

לקוח ה‑POP3 של ה‑API יכול לשאוב מידע מסכם של הודעה מהשרת באמצעות מזהה ייחודי של ההודעה. זה מספק גישה מהירה למידע קצר של ההודעה מבלי לשאוב תחילה את ההודעה המלאה מהשרת. הקטע הקוד הבא מציג כיצד לשאוב מידע מסכם של הודעה.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String uniqueId = "unique id of a message from server";
Pop3Client client = new Pop3Client("host.domain.com", 456, "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
Pop3MessageInfo messageInfo = client.getMessageInfo(uniqueId);

if (messageInfo != null) {
    System.out.println(messageInfo.getSubject());
    System.out.println(messageInfo.getDate());
}

רישום הודעות עם חיבור מרובה

Pop3Client מספק UseMultiConnection מאפיין שניתן להשתמש בו ליצירת חיבורים מרובים לפעולות כבדות. ניתן גם להגדיר את מספר החיבורים שישמשו במצב מרובה חיבורים באמצעות Pop3Client.ConnectionsQuantity. הקטע הקוד הבא מדגים את השימוש במצב מרובה חיבורים לרישום הודעות ומשווה את ביצועיו למצב חיבור יחיד.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

pop3Client.setConnectionsQuantity(5);
pop3Client.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol1 = pop3Client.listMessages();
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

pop3Client.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol2 = pop3Client.listMessages();
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

System.out.println("multyConnectionModeTimeSpan: " + multiConnectionModeTimeSpan);
System.out.println("singleConnectionModeTimeSpan: " + singleConnectionModeTimeSpan);
double performanceRelation = singleConnectionModeTimeSpan / multiConnectionModeTimeSpan;
System.out.println("Performance Relation: " + performanceRelation);

שימו לב כי השימוש במצב מרובה חיבורים אינו מבטיח שיפור בביצועים.

הבאת הודעות מהשרת ושמירתן לדיסק

שמירת הודעה לדיסק ללא פירוש

אם ברצונך להוריד הודעות דוא"ל משרת POP3 ללא פירושן, השתמש ב- Pop3Client מחלקה saveMessage פונקציה. ה- saveMessage פונקציה אינה מפענחת את הודעת האימייל ולכן היא מהירה יותר מה- fetchMessage פונקציה. קוד הדוגמה הבא מציג כיצד לשמור הודעה לפי מספר הסדרה שלה, במקרה זה, מספר 1. ה- saveMessage מתודה שומרת את ההודעה בפורמט EML המקורי ללא פירוש.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "pop3/";
String dstEmail = dataDir + "InsertHeaders.eml";

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

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

try {
    // Save message to disk by message sequence number
    client.saveMessage(1, dstEmail);
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}
System.out.println("Retrieved email messages using POP3 ");

פירוש הודעה לפני שמירה

קוד הדוגמה הבא משתמש ב- Pop3Client fetchMessage מתודה לאחזור הודעה משרת POP3 לפי מספר הסדרה שלה, ולאחר מכן לשמור את ההודעה לדיסק תוך שימוש בנושא כשם הקובץ.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "pop3/";

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

// Specify host, username and password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);

try {
    // Fetch the message by its sequence number and Save the message using its subject as the file name
    MailMessage msg = client.fetchMessage(1);
    msg.save(dataDir + "first-message_out.eml", SaveOptions.getDefaultEml());
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

הבאת הודעות בקבוצות

Pop3Client מספק fetchMessages מתודה המקבלת איטרביל של מספרי סדר או ID ייחודי ומחזירה רשימה של MailMessage. קוד הדוגמה הבא מדגים את השימוש ב- fetchMessages מתודה להבאת הודעות לפי מספרי סדר ו-ID ייחודי.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the Pop3Client class
Pop3Client pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

Pop3MessageInfoCollection messageInfoCol = pop3Client.listMessages();
System.out.println("ListMessages Count: " + messageInfoCol.size());

List<Integer> sequenceNumberAr = new ArrayList<Integer>();
List<String> uniqueIdAr = new ArrayList<String>();
for (Pop3MessageInfo mi : messageInfoCol) {
    sequenceNumberAr.add(mi.getSequenceNumber());
    uniqueIdAr.add(mi.getUniqueId());
}

for (MailMessage m : pop3Client.fetchMessagesBySequences(sequenceNumberAr)) {
    System.out.println("FetchMessages-sequenceNumberAr : " + m.getSubject());
}

for (MailMessage m : pop3Client.fetchMessagesByUids(uniqueIdAr)) {
    System.out.println("FetchMessages-uniqueIdAr : " + m.getSubject());
}

סינון הודעות לפי שולח, נמען או תאריך

ה Pop3Client מחלקה, המתוארת ב- התחברות לשרת POP3, מספקת את listMessages מתודה אשר מקבלת את כל ההודעות מתיבת דואר. כדי לקבל רק הודעות שתואמות תנאי מסוים, השתמש ב- listMessages מתודה אשר מקבלת MailQuery כארגומנט. ה- MailQuery המחלקה מספקת מאפיינים שונים לציון תנאי השאילתה, כגון תאריך, נושא, שולח, נמען ועוד. ה- MailQueryBuilder מחלקה משמשת לבניית הביטוי החיפוש. ראשית, כל התנאים והמגבלות מוגדרים ולאחר מכן MailQuery מתמלא עם השאילתה שפותחה על ידי MailQueryBuilder. ה MailQuery אובייקט המחלקה משמש על ידי Pop3Client להוצאת המידע המסונן מהשרת. מאמר זה מציג כיצד לסנן הודעות דוא"ל מתיבת דואר. הדוגמה הראשונה מציגה סינון הודעות לפי תאריך ונושא. אנו גם מציגים סינון לפי קריטריונים אחרים וכיצד להרכיב שאילתות מורכבות יותר. בנוסף, מוצגת השימוש במסנן תאריך ושעה כדי לקבל את ההודעות הספציפיות מתיבת הדואר. בנוסף, מוצג כיצד להפעיל סינון רגיש לרישיות.

סינון הודעות מתיבת דואר

כדי לסנן הודעות מתיבת דואר:

התחבר והיכנס לשרת POP3.
צור מופע של MailQuery ולקבוע את המאפיינים הרצויים.
הפעל את Pop3Client.listMessages(MailQuery query) method והעבר את MailQuery בפרמטרים כדי לקבל רק את ההודעות המסוננות.

קוד הדוגמה הבא מציג כיצד להתחבר לתיבת דואר POP3 ולקבל הודעות שהגיעו היום ויש במושאן את המילה "newsletter".

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to POP3
String host = "host";
int port = 110;
String username = "user@host.com";
String password = "password";
Pop3Client client = new Pop3Client(host, port, username, password);

// Set conditions, Subject contains "Newsletter", Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
Pop3MessageInfoCollection messages = client.listMessages(query);
System.out.println("Pop3: " + messages.size() + " message(s) found.");

קבלת הודעות העונות לקריטריונים ספציפיים

דוגמות הקוד שלעיל מסנן הודעות בהתבסס על נושא ויום של הדוא"ל. אנו יכולים להשתמש במאפיינים אחרים כדי להגדיר תנאים נתמכים נוספים גם. להלן כמה דוגמאות לקביעת התנאים באמצעות MailQuery.

קוד הדוגמאות שלהלן מראה כיצד לסנן הודעות דוא"ל על פי קריטריונים אחרים:

מצא הודעות שנמסרו היום.
מצא הודעות שהתקבלו בטווח.
מצא הודעות משולח ספציפי.
מצא הודעות שנשלחו מדומיין ספציפי.
מצא הודעות שנשלחו למקבל ספציפי.

תאריך היום

קוד הדוגמה הבא מציג כיצד למצוא הודעות שנמסרו היום.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());

טווח תאריכים

קוד הדוגמה הבא מראה כיצד למצוא הודעות שהתקבלו בטווח.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails that arrived in last 7 days
Calendar calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

שולח ספציפי

קוד הדוגמה הבא מראה כיצד למצוא הודעות משולח ספציפי.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

דומיין ספציפי

קוד הדוגמה הבא מציג כיצד למצוא הודעות שנשלחו מדומיין ספציפי.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

מקבל ספציפי

קוד הדוגמה הבא מראה כיצד למצוא הודעות שנשלחו למקבל ספציפי.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails sent to specific recipient
builder.getTo().contains("recipient");

בניית שאילתות מורכבות

אם שונים MailQueryBuilder מאפיינים מוגדרים בהצהרות נפרדות, ואז כל התנאים יותאמו. לדוגמה, אם אנחנו רוצים לקבל הודעות בטווח תאריכים וממארח ספציפי, עלינו לכתוב שלוש הצהרות.

שילוב שאילתות עם AND

קוד הדוגמה הבא מציג כיצד לשלב שאילתות עם AND.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.getFrom().contains("SpecificHost.com");

Calendar calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

שילוב שאילתות עם OR

MailQueryBuilder מספקת את או מתודה שלוקחת שני MailQuery ‏מופעים כפרמטרים. הוא משיג את ההודעות המתאימות לאחת משתי התנאים המצוינים. קוד הדוגמה הבא מציג כיצד לסנן הודעות שיש בהן "test" בנושא או "noreply@host.com" כשולח. קוד הדוגמה הבא מראה כיצד לשלב שאילתות עם OR.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Specify OR condition
builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

החלת מסננים רגישים לרישיות

ה-API גם מספק את היכולת לסנן הודעות דוא"ל מתיבת הדואר בהתבסס על קריטריון רגיש לרישיות. השיטות הבאות מאפשרות לחפש הודעות דוא"ל עם דגל רגיש לרישיות.

Method StringComparisonField.contains(String value, boolean ignoreCase)
Method StringComparisonField.equals(String value, boolean ignoreCase)
Method StringComparisonField.notContains(String boolean, bool ignoreCase)
Method StringComparisonField.notEquals(String boolean, bool ignoreCase)

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.getFrom().contains("tesT", true);
MailQuery query1 = builder1.getQuery();
Pop3MessageInfoCollection messageInfoCol1 = client.listMessages(query1);

Java: עבודה עם Pop3Client באופן אסינכרוני

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

עבודה עם Pop3Client באופן אסינכרוני

ניתן לשאוב הודעות מתיבות דואר בצורה אסינכרונית גם באמצעות Aspose.Email Pop3Client. מאמר זה מציג כיצד לשאוב הודעות מתיבת דואר בצורה אסינכרונית. הוא גם מציג כיצד לרשום הודעות על‑ידי אספקת קריטריוני חיפוש באמצעות MailQuery.

שליפת הודעות בצורה אסינכרונית

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

Pop3Client client = new Pop3Client();
client.setHost("pop.gmail.com");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.SSLImplicit);
client.setUsername("username");
client.setPassword("password");

try {
    Pop3MessageInfoCollection messages = client.listMessages();
    System.out.println("Total Number of Messages in inbox:" + messages.size());
    IAsyncResult asyncResult = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(asyncResult);
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

רשימת הודעות בצורה אסינכרונית עם MailQuery

ה MailQuery ניתן להשתמש במחלקה כדי לציין קריטריוני חיפוש לשאיבת רשימת הודעות בצורה אסינכרונית כפי שמופיע בדוגמת הקוד שלהלן.

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

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
Pop3MessageInfoCollection messages = client.endListMessages(asyncResult);

Documentation – עבודה עם לקוח POP3

Java: התחבר לשרת POP3

התחברות לשרת SSL

התחברות לשרת APOP

התחברות לשרת דרך פרוקסי

התחברות לשרת דרך פרוקסי HTTP

התאמת מנגנון האימות

תמיכה בפרוטוקול OAuth 2.0 עבור הרשאה

אימות אישורי שרת המייל ללא שליחת אימייל

שימוש באימות CRAM‑MD5 לחיבור לשרת

כיצד להגדיר זמן קצוב לפעולות דואר

Java: מחיקת הודעות משרת POP3

מחק אימייל לפי אינדקס

מחק את כל האימיילים

ביטול מחיקות

Java: רישום הרחבות השרת באמצעות Pop3Client

אחזור הרחבות השרת

Java: עבודה עם הודעות מהשרת

קבלת מידע על תיבת הדואר

קבלת מספר הודעות דוא"ל בתיבת הדואר

קבלת מידע על כותרות דוא"ל

קבלת הודעות דוא"ל

שילוף מידע מסכם של הודעה באמצעות מזהה ייחודי

רישום הודעות עם חיבור מרובה

הבאת הודעות מהשרת ושמירתן לדיסק

שמירת הודעה לדיסק ללא פירוש

פירוש הודעה לפני שמירה

הבאת הודעות בקבוצות

סינון הודעות לפי שולח, נמען או תאריך

סינון הודעות מתיבת דואר

קבלת הודעות העונות לקריטריונים ספציפיים

תאריך היום

טווח תאריכים

שולח ספציפי

דומיין ספציפי

מקבל ספציפי

בניית שאילתות מורכבות

שילוב שאילתות עם AND

שילוב שאילתות עם OR

החלת מסננים רגישים לרישיות

Java: עבודה עם Pop3Client באופן אסינכרוני

עבודה עם Pop3Client באופן אסינכרוני

שליפת הודעות בצורה אסינכרונית

רשימת הודעות בצורה אסינכרונית עם MailQuery

תמיכה בפרוטוקול OAuth 2.0 עבור הרשאה