Documentation – POP3 클라이언트 작업

Python-Net: Python에서 POP3 서버 연결

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

기본 인증을 사용하여 POP3 서버에 연결

Aspose.Email for Python API는 Pop3Client 클래스는 애플리케이션이 우편국 프로토콜 버전 3(POP3)를 통해 메일함을 관리할 수 있게 합니다. 이 클래스를 사용하여 POP3 서버에 연결하십시오. .NET 애플리케이션에 POP3 관리를 통합하려는 개발자를 위한 주요 인터페이스 역할을 합니다. 이 문서는 Pop3Client 클래스를 효과적으로 사용하는 방법을 안내합니다.

다음 코드 스니펫은 Aspose.Email을 사용하여 POP3 이메일 서버에 연결하는 방법을 보여줍니다. Pop3Client 클래스. 서버 주소, 사용자 자격 증명, 보안 설정 및 포트 번호와 같은 필수 매개변수를 사용하여 연결을 구성하는 과정을 보여줍니다. 이 설정은 Gmail 계정에서 이메일을 안전하게 가져오는데 필요합니다.

다음의 인스턴스를 생성합니다 Pop3Client.
호스트, 사용자 이름, 비밀번호, 포트 및 보안 옵션을 지정합니다.

SSL이 활성화된 POP3 서버에 연결

SSL이 활성화된 POP3 서버에 연결하려면 Aspose.Email을 사용하십시오 Pop3Client 클래스와 보안 옵션 및 포트 속성을 설정합니다. 다음 코드 스니펫은 SSL이 활성화된 POP3 서버에 연결하는 방법을 보여줍니다:

APOP 인증을 사용해 POP3 서버에 연결

APOP(Authenticated Post Office Protocol)은 메일 서버에서 이메일을 안전하게 가져오는 방법입니다. 기존 POP3 프로토콜에 인증 계층을 추가하여 사용자 자격 증명을 보호합니다.

사용자 이름과 비밀번호를 평문으로 보내는 대신, APOP은 인증 과정에서 해시 값을 사용합니다. 로그인 시 클라이언트는 비밀 키(사용자 비밀번호)와 챌린지 값(서버가 생성한 고유 문자열)을 사용하여 해시를 생성합니다.

프록시를 통해 POP3 서버에 연결

프록시 서버는 외부와 통신할 때 이메일 클라이언트와 메일 서버 사이의 중개자 역할을 합니다. 메일 서버에 직접 연결하는 대신 이메일 요청이 프록시를 통과하게 되며, 이는 IP 주소를 은폐하고 제한된 콘텐츠에 접근하는 등 여러 이점을 제공합니다. 특히 공용 네트워크에서 이메일에 액세스할 때 프록시 서버를 사용하면 개인정보 보호와 보안을 강화할 수 있습니다.

Aspose.Email은 SOCKS 프록시 프로토콜 버전 4, 4a 및 5를 사용한 프록시 서버 지원을 제공합니다. 이를 통해 개발자는 프록시를 통해 메일 서버와 효율적으로 통신하는 애플리케이션을 만들 수 있습니다. Pop3Client 클래스는 애플리케이션이 우편국 프로토콜 버전 3(POP3)를 사용하여 메시지에 접근하고 조작할 수 있게 합니다. 유용한 메서드 중 하나는 getmailboxinfo(), 메일함에 대한 필수 정보(예: 메시지 수 및 총 크기)를 검색하여 이메일 계정 관리 효율성을 높입니다.

다음 코드 예제는 Aspose.Email을 사용하여 프록시 메일 서버를 통해 이메일을 검색하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
# Set proxy address, Port and Proxy
proxy_address = "192.168.203.142"
proxy_port = 1080
proxy = ae.clients.SocksProxy(proxy_address, proxy_port, ae.clients.SocksVersion.SOCKS_V5)
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

HTTP 프록시 지원

프록시에는 HTTP 프록시, SOCKS 프록시 등 다양한 유형이 있으며, 각각은 다른 목적을 수행하고 다른 수준의 기능을 제공합니다. 사용되는 프록시 유형에 따라 구체적인 단계와 설정이 달라질 수 있습니다. 아래 코드 예제는 설정 방법을 보여줍니다. Pop3Client HTTP 프록시를 추가로 구성하고 메일함 정보를 가져오는 방법:

import aspose.email as ae

proxy = ae.clients.HttpProxy("18.222.124.59", 8080)
client = ae.clients.pop3.Pop3Client("pop.domain.com", "username", "password")
client.socks_proxy = proxy
mailboxInfo = client.get_mailbox_info()

CRAM-MD5 인증을 통해 서버에 연결

CRAM-MD5(MD5 기반 챌린지-응답 인증 메커니즘)는 POP3 및 IMAP과 같은 이메일 프로토콜에서 보안 인증이 중요할 때 일반적으로 사용됩니다. 이는 평문 비밀번호 전송에 비해 더 강력한 보안을 제공합니다. Aspose.Email for .NET은 이 인증 방식을 지원하는 이메일 서버에 안전하게 인증하고 접근할 수 있게 합니다.

client.allowed_authentication = ae.clients.pop3.Pop3KnownAuthenticationType.CRAM_MD5

메일 작업 시간 제한 구성

Aspose.Email은 ’timeout’ 속성을 제공합니다. Pop3Client 클래스는 메일 작업에 대한 시간 제한을 가져오거나 설정하여 응답 정지 또는 차단을 방지하고, 네트워크 또는 서버 문제를 처리하며, 응답성을 향상시키고 효율적인 리소스 관리를 보장합니다. 다음 코드 예제는 해당 속성을 프로젝트에 구현하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
#  60 seconds
client.timeout = 60000

POP3 클라이언트와 암호화 프로토콜 사용

Aspose.Email은 SSL(구식) 및 TLS 암호화 프로토콜을 지원하여 통신 보안을 제공합니다. 애플리케이션과 메일 서버 간 데이터 교환을 보호하기 위해 암호화 암호화를 활성화할 수 있습니다.

NOTE: It's important to know that you can only configure protocol versions supported by the .NET Framework. If your current .NET Framework version does not support certain protocol versions, those unsupported versions will be disregarded and skipped. This could result in a potential downgrade in TLS security level, and it's crucial to be aware that no exceptions will be raised in this situation. Developers should exercise caution to ensure the desired TLS security level is maintained based on the supported protocols in their .NET Framework environment.

다음 코드 예제는 안전한 통신을 위해 TLS 1.3 암호화 프로토콜 구성을 사용하여 POP3 클라이언트를 설정하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.supported_encryption = ae.clients.base.EncryptionProtocols.TLS13

지정된 암호화 프로토콜이 현재 .NET Framework 버전에서 지원되지 않을 경우, ‘SetSupportedEncryptionUnsafe’ 메서드와 ‘SupportedEncryption’ 속성 간 동작 차이는 다음과 같습니다:

‘SupportedEncryption’ 속성을 사용하면 이메일 클라이언트가 암호화 프로토콜을 지원되는 수준으로 낮춥니다.

‘SetSupportedEncryptionUnsafe’ 메서드를 사용하면 이메일 클라이언트가 예외를 발생시킵니다.

Python-Net: Python에서 POP3 서버의 이메일 삭제

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

Aspose.Email for .NET은 POP3 서버에서 메시지를 관리하는 완전한 제어 기능을 제공합니다. 이를 사용하여 Pop3Client 클래스를 사용하면 개발자는 메일함에 연결하고 서버의 메시지에 대해 특정 메시지 또는 전체 메시지를 삭제하는 등 다양한 작업을 프로그래밍 방식으로 수행할 수 있습니다. 이는 조회 후 또는 사용자 지정 로직에 따라 이메일 정리가 필요한 서버 측 메일 처리 애플리케이션에서 특히 유용합니다.

이 문서는 다양한 시나리오에서 Aspose.Email POP3 클라이언트를 사용하여 메시지를 삭제하는 방법을 설명합니다.

인덱스로 이메일 삭제

다음 코드 스니펫은 인덱스를 기반으로 메일함의 모든 메시지를 하나씩 삭제하는 방법을 보여줍니다. Pop3Client.DeleteMessage에서 인덱스 번호는 0 이하가 되어서는 안 됩니다.

모든 이메일 삭제

또한 호출할 수 있습니다 delete_messages() 모든 메시지를 삭제하는 메서드. 다음 코드 스니펫은 이 메서드를 사용하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Delete all the messages
client.delete_messages()

삭제 작업 직후 POP3 서버와의 연결이 끊어지면 undelete_messages() 메서드를 더 이상 호출하여 데이터를 복원할 수 없습니다.

삭제 작업 취소

이 메서드 undelete_messages 이 메소드를 사용하여 이메일 메시지 삭제를 취소할 수 있습니다. 다음 코드 스니펫은 이 메소드를 사용하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("imap.example.com", "username", "password")

# Cancel deletes
client.undelete_messages()

Python-Net: Python에서 POP3 서버 자격 증명 검증

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

Aspose.Email은 다음을 제공합니다 validate_credentials() 메서드 Pop3Client POP3 이메일 서버에 대한 사용자의 로그인 자격 증명(사용자 이름 및 비밀번호)을 확인하는 클래스입니다. 이 메서드는 자격 증명이 유효함을 보장하여 POP3 프로토콜을 통해 인증에 성공하고 메일함에 액세스할 수 있도록 합니다. 자격 증명이 올바르지 않으면, 메서드는 ‘False’를 반환하거나 예외를 발생시켜 인증 실패를 나타냅니다.

아래 코드 스니펫은 Aspose.Email API를 사용하여 POP3 서버 자격 증명을 검증하는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: 유틸리티 기능 - POP3 클라이언트

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

메일 서버 자격 증명 검증

Aspose.Email은 ‘validate_credentials()’ 메서드를 제공합니다 Pop3Client 사용자가 POP3 이메일 서버에 액세스하기 위해 제공한 자격 증명(사용자 이름 및 비밀번호)을 확인하는 클래스입니다. 이 메서드는 사용자의 로그인 자격 증명이 정확하고 유효함을 보장하여 POP3 프로토콜을 사용해 인증에 성공하고 이메일 계정에 액세스할 수 있도록 합니다. 제공된 자격 증명이 올바르지 않으면, 메서드는 오류를 반환하거나 예외를 발생시켜 로그인 프로세스가 실패했음을 나타냅니다.

아래 코드 스니펫은 API가 제공하는 검증 메서드를 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
client.timeout = 40000
if client.validate_credentials():
# to do something

Python-Net: 지원되는 POP3 서버 확장 기능 목록

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

Aspose.Email은 Pop3Client 클래스는 IDLE, UNSELECT, QUOTA 등과 같은 POP3 서버의 지원 확장 기능을 검색할 수 있게 합니다. 어떤 확장이 사용 가능한지 아는 것은 특정 기능을 활용할 수 있는지를 판단하는 데 중요합니다. get_capabilities() 메서드는 지원되는 확장 유형을 문자열 배열로 반환합니다.

다음 코드 예제는 Gmail 서버에 대해 Pop3Client를 사용하여 서버 확장 기능을 검색하는 방법을 보여줍니다:

Python-Net: Python에서 POP3 서버 활동 로깅 활성화

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

활동 로깅은 POP3 클라이언트가 POP3 서버에 연결하고 상호 작용할 때 수행되는 작업을 모니터링하고 기록할 수 있게 해줍니다. 이 기능을 활성화하면 문제 해결에 도움이 되고, 보안 모니터링이 개선되며, 데이터 보존 및 개인정보 보호 정책 준수를 지원합니다.

아래 예제는 Aspose.Email을 사용하여 활동 로깅을 활성화하는 방법을 보여줍니다. Pop3Client 클래스:

다음의 인스턴스를 생성합니다 Pop3Client, 호스트, 포트, 사용자 이름 및 비밀번호와 보안 옵션을 지정합니다.
다음으로 로그 파일 경로를 설정합니다: log_file_name 속성.
선택적으로, 다음을 설정하여 로깅 설정을 조정합니다: use_date_in_log_file_name 필요한 경우 속성.

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)
# Set the path to the log file using the LogFileName property.
client.log_file_name = "C:\\Aspose.Email.Pop3.log"
# Set the UseDateInLogFileName property if it is necessary.
client.use_date_in_log_file_name = False

Python-Net: Python에서 POP3 서버의 이메일 검색

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

사서함 정보 및 메시지 수 가져오기

Aspose.Email API를 사용하면 서버의 메시지에 대해 다양한 작업을 수행할 수 있으며, 메시지 수 및 사서함 크기와 같은 사서함 정보를 가져올 수 있습니다. get_mailbox_size() 및 get_mailbox_info() 메서드들.

다음은 get_mailbox_size() 메서드는 사서함의 크기를 바이트 단위로 반환합니다.
다음은 get_mailbox_info() 메서드는 타입의 객체를 반환합니다. Pop3MailBoxInfo.

다음 방법을 사용하여 메시지 수를 가져올 수도 있습니다. message_count occupied_size 속성을 사용하여 속성 및 크기를 가져옵니다. 다음 샘플 코드는 사서함에 대한 정보를 얻는 방법을 보여줍니다. 다음을 수행하는 방법을 보여줍니다:

다음을 생성합니다 Pop3Client.
POP3 서버에 연결합니다.
사서함의 크기를 가져옵니다.
사서함 정보를 가져옵니다.
사서함의 메시지 수를 가져옵니다.
사용 중인 크기를 가져옵니다.

메시지 수만 가져오기

위의 코드 샘플은 사서함의 전체 메시지 수와 함께 크기 또는 사용된 공간과 같은 사서함 통계를 가져오는 방법을 보여줍니다. 다음 코드 샘플은 사서함에 있는 이메일 메시지 수를 직접 가져오는 방법을 보여줍니다. 메시지 수만 필요한 경우 이 방법이 더 간단하고 빠릅니다.

이메일 헤더만 가져오기

Aspose.Email을 사용하면 전체 메시지 내용을 다운로드하지 않고도 이메일 메타데이터에 접근할 수 있습니다. 많은 경우에 발신자, 제목 및 수신 날짜와 같은 헤더만 확인하여 메시지를 가져올 가치가 있는지 판단하는 것이 유용합니다. 이 접근 방식은 서버 부하를 줄이고 특히 POP3 연결을 통한 대용량 사서함 작업 시 성능을 향상시킵니다.

다음 코드 샘플은 POP3 서버에 연결하고 해당 시퀀스 번호를 사용하여 특정 메시지의 헤더만 가져오는 방법을 보여줍니다. 이 가벼운 작업은 어떤 이메일을 다운로드하거나 무시할지에 대한 정보에 입각한 결정을 내리는 데 도움이 됩니다.

서버에서 이메일 메시지 다운로드

Aspose.Email Pop3Client 클래스는 POP3 서버에서 이메일 메시지를 가져와 MailMessage 인스턴스로 변환하는 기능을 제공합니다. 이는 해당 클래스의 속성과 메서드를 통해 가능해집니다. MailMessage 클래스는 이메일 콘텐츠 조작을 용이하게 합니다. 이를 사용하여 fetch_message 메서드 Pop3Client 클래스에서, 다음을 얻을 수 있습니다: MailMessage POP3 서버에서 인스턴스를 직접 가져옵니다. 다음 코드 스니펫은 서버에서 전체 이메일 메시지를 가져오는 방법을 보여줍니다:

고유 ID로 메시지 요약 가져오기

API의 POP3 클라이언트를 사용하면 고유 ID를 통해 서버에서 메시지 요약 정보를 가져올 수 있습니다. 이 기능을 사용하면 전체 콘텐츠를 다운로드하지 않고도 메시지의 핵심 세부 정보를 빠르게 액세스할 수 있습니다. 다음 코드 스니펫은 Aspose.Email Python API를 사용하여 메시지 요약 정보를 액세스하는 방법을 보여줍니다:

다중 연결을 사용하여 메시지 나열

부하가 큰 작업을 위해 Aspose.Email은 다음을 제공합니다: use_multi_connection 속성 Pop3Client 클래스는 이메일을 가져오는 동안 여러 연결을 사용할 수 있게 합니다. 이 모드를 활성화한다고 해서 항상 성능이 향상된다는 보장은 없습니다. 다음 코드 스니펫은 POP3 서버에 연결하고, 최대 5개의 동시 연결을 허용하도록 클라이언트를 구성하고, 다중 연결 모드를 활성화하여 서버에 저장된 메시지 정보를 가져오는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

Python-Net: Python에서 POP3 서버의 이메일 검색

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

파싱 없이 이메일을 디스크에 저장

POP3 서버에서 이메일 메시지를 파싱 없이 다운로드하려면 다음을 사용할 수 있습니다: save_message Aspose.Email의 메서드 Pop3Client 클래스. 다음 코드 스니펫은 시퀀스 번호(예: 1)를 사용해 메시지를 저장하는 방법을 보여줍니다. 해당 save_message 메서드는 파싱 없이 원본 EML 형식을 보존합니다:

저장하기 전에 메시지 파싱

다음 방법을 사용해 특정 이메일 메시지를 가져올 수 있습니다: fetch_message 메서드 Pop3Client 클래스는 클라이언트 객체에 원하는 시퀀스 번호를 지정합니다. 다음 코드 샘플은 특정 메시지를 가져와 그 제목을 파일 이름으로 사용해 저장하는 방법을 보여줍니다. save msg 객체의 메서드:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

조건으로 서버에서 이메일 필터링

Aspose.Email Pop3Client class는 다음을 제공합니다 list_messages() 메서드는 사서함의 모든 메시지를 가져옵니다. 특정 조건에 일치하는 메시지만 얻으려면 오버로드된 메서드를 사용하십시오 list_messages(query) 메서드는 ~를 받아들입니다 MailQuery 을 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자, 수신자 등 다양한 속성을 제공하여 쿼리 조건을 지정할 수 있게 합니다.

검색 표현식을 만들려면 다음을 사용하십시오: MailQueryBuilder 클래스. 먼저 필요한 모든 조건과 제약을 정의한 뒤 MailQueryBuilder가 만든 쿼리로 MailQuery 객체를 채웁니다. MailQueryBuilder. Pop3Client는 이 MailQuery 객체를 사용해 서버에서 필터링된 정보를 가져옵니다.

다음 코드 샘플은 Gmail 계정에서 제목, 내부 날짜, 발신자 및 수신자를 포함한 다양한 기준으로 이메일을 필터링하고 가져오는 방법을 보여줍니다. 또한 대소문자 구분 필터링을 보여주고 복잡한 쿼리를 효율적으로 구축하는 방법을 시연합니다.

Gmail POP3 서버에 연결하려면 다음을 사용하십시오: Pop3Client 클래스는 지정된 서버 주소, 포트, 사용자 이름 및 비밀번호를 포함합니다. 보안 옵션은 안전한 연결을 위해 AUTO로 설정됩니다.
다음의 인스턴스를 생성합니다. MailQueryBuilder 이메일을 필터링하기 위한 검색 기준을 구성합니다.
제목 기준으로 필터링:
- 제목에 "Newsletter"가 포함된 이메일이 필터 조건으로 지정되었습니다.
내부 날짜 기준으로 필터링:
- 현재 날짜에 수신된 이메일에 대한 필터가 설정되었습니다.
- 지난 주에 수신된 이메일을 가져오기 위해 추가 필터가 추가되었습니다.
보낸사람 기준으로 필터링:
- 특정 이메일 주소(sa qib.razzaq@127.0.0.1)와 특정 도메인(SpecificHost.com)에서 온 이메일을 찾기 위해 필터가 적용되었습니다.
수신인 기준으로 필터링:
- 특정 수신인에게 보낸 이메일을 찾기 위한 필터가 지정되었습니다.
OR 연산자를 사용해 쿼리를 결합하여 지정된 제목과 일치하거나 특정 주소에서 보낸 이메일을 검색합니다.
대소문자 구분 필터링:
- "Newsletter"가 포함된 제목에 대해 대소문자를 구분하는 필터가 지정되었습니다(True 매개변수로 표시).
메시지 나열:
- list_messages() 메서드는 구성된 쿼리를 사용해 사서함에서 필터링된 메시지를 가져옵니다.
마지막으로 필터링된 메시지 수를 출력합니다.

날짜별 이메일 필터링

전송 날짜별로 메시지를 가져오려면, 다음을 사용하십시오 internal_date 아래 코드 샘플에 표시된 속성:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

날짜 범위별 이메일 필터링

날짜 범위 내의 메시지를 가져오려면, 동일한 것을 사용하십시오 internal_date 아래 코드 샘플에 표시된 날짜 범위를 지정하는 속성:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

발신자별 이메일 필터링

특정 발신자에서 메시지를 가져오려면, 다음을 사용하십시오 from_address 아래 코드 샘플에 표시된 속성:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

도메인별 이메일 필터링

특정 도메인에서 메시지를 가져오려면, 다음을 사용하십시오 from_address 아래 코드 샘플에 표시된 속성:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

수신자별 이메일 필터링

특정 수신자에게 메시지를 가져오려면, 다음을 사용하십시오 to 아래 코드 샘플에 표시된 속성:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

복잡한 검색 쿼리 만들기

때때로 하나 이상의 쿼리를 만족시켜야 할 필요가 있습니다. Aspose.Email은 여러 문장에서 쿼리를 결합할 수 있게 해줍니다. 생성합니다 MailQueryBuilder 객체와 그 속성을 사용해 특정 쿼리를 작성합니다.

AND 연산자로 쿼리 결합

다음 코드 스니펫은 AND 연산자를 사용해 쿼리를 결합하는 방법을 보여줍니다:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

OR 연산자로 쿼리 결합

다음 코드 스니펫은 OR 연산자를 사용해 쿼리를 결합하는 방법을 보여줍니다:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

대소문자 구분 필터 적용

API는 또한 대소문자를 구분하는 기준에 따라 사서함에서 이메일을 필터링할 수 있는 기능을 제공합니다. 다음 메서드들은 StringComparisonField 클래스는 대소문자를 구분하는 플래그를 지정해 이메일을 검색할 수 있는 기능을 제공합니다:

메서드 Aspose.Email.StringComparisonField.contains(value, ignore_case) 메서드 Aspose.Email.StringComparisonField.equals(value, ignore_case) 메서드 Aspose.Email.StringComparisonField.not_contains(value, ignore_case) 메서드 Aspose.Email.StringComparisonField.not_equals(value, ignore_case)

다음 코드 스니펫은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)

Python-Net: 서버에서 메시지 작업

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

사서함 정보 가져오기

GetMailBoxSize() 및 GetMailBoxInfo() 메서드를 사용하여 메시지 수와 사서함 크기와 같은 사서함 정보를 얻을 수 있습니다.

GetMailBoxSize() 메서드는 사서함의 크기를 바이트 단위로 반환합니다.
GetMailBoxInfo() 메서드는 Pop3MailBoxInfo 유형의 객체를 반환합니다.

MessageCount 속성을 사용하여 메시지 수를, OccupiedSize 속성을 사용하여 크기를 가져올 수도 있습니다. 다음 샘플 코드는 사서함에 대한 정보를 얻는 방법을 보여줍니다. 다음을 수행하는 방법을 보여줍니다:

다음을 생성합니다 Pop3Client.
POP3 서버에 연결합니다.
사서함의 크기를 가져옵니다.
사서함 정보를 가져옵니다.
사서함의 메시지 수를 가져옵니다.
사용 중인 크기를 가져옵니다.

사서함 내 이메일 수 가져오기

다음 코드 스니펫은 사서함에서 이메일 메시지 수를 계산하는 방법을 보여줍니다.

Aspose.Email은 개발자가 이메일을 다양한 방식으로 작업할 수 있도록 합니다. 예를 들어, 이메일을 다운로드할지 여부를 결정하기 전에 헤더 정보를 가져올 수 있습니다. 또는 서버에서 이메일을 가져와 파싱하지 않고 저장(빠르게)하거나 파싱한 후 저장(느리게)할 수 있습니다. 이 문서는 이메일을 검색하고 변환하는 방법을 보여줍니다.

이메일 헤더 정보 검색

이메일 헤더는 전체 이메일을 가져올지 여부를 판단하는 데 사용할 수 있는 정보를 제공합니다. 일반적으로 헤더 정보에는 발신자, 제목, 수신 날짜 등이 포함됩니다(이메일 헤더에 대한 자세한 내용은 ‘Customizing Email Headers’에 나와 있습니다. 해당 주제는 SMTP를 통한 이메일 전송에 대해 다루지만, POP3 이메일에서도 헤더 내용은 동일하게 유효합니다). 다음 예제는 메시지의 시퀀스 번호를 사용하여 POP3 서버에서 이메일 헤더를 가져오는 방법을 보여줍니다.

이메일 메시지 검색

Aspose.Email.Pop3 클래스 구성 요소는 POP3 서버에서 이메일 메시지를 가져와 MailMessage 컴포넌트를 활용해 MailMessage 인스턴스로 파싱하는 기능을 제공합니다. MailMessage 클래스는 이메일 콘텐츠를 조작하기 위한 여러 속성과 메서드를 포함합니다. Pop3Client 클래스의 FetchMessage 함수를 사용하면 POP3 서버에서 직접 MailMessage 인스턴스를 얻을 수 있습니다. 다음 코드 스니펫은 POP3 서버에서 전체 이메일 메시지를 가져오는 방법을 보여줍니다.

고유 ID를 사용한 메시지 요약 정보 가져오기

API의 POP3 클라이언트를 사용하면 메시지의 고유 ID를 이용해 서버에서 메시지 요약 정보를 가져올 수 있습니다. 이를 통해 전체 메시지를 먼저 가져오지 않고도 메시지의 간략 정보를 빠르게 확인할 수 있습니다. 다음 코드 스니펫은 메시지 요약 정보를 가져오는 방법을 보여줍니다.

멀티 연결을 사용한 메시지 목록

부하가 큰 작업을 위해 Aspose.Email은 ‘use_multi_connection’ 속성을 제공합니다: Pop3Client 클래스는 이메일을 가져오는 동안 여러 연결을 사용할 수 있게 합니다. 하지만 이 모드가 반드시 성능 향상으로 이어지는 것은 아닙니다. 다음 코드 스니펫은 POP3 서버에 연결하고, 최대 5개의 동시 연결을 허용하도록 클라이언트를 구성하고, 다중 연결 모드를 활성화하여 서버에 존재하는 메시지 정보를 가져오는 방법을 보여줍니다:

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

client.connections_quantity = 5
client.use_multi_connection = ae.clients.MultiConnectionMode.ENABLE
message_info_coll = client.list_messages()

서버에서 메시지를 가져와 디스크에 저장

파싱 없이 메시지를 디스크에 저장

POP3 서버에서 이메일 메시지를 파싱하지 않고 다운로드하려면 Pop3Client 클래스의 SaveMessage 함수를 사용하십시오. SaveMessage 함수는 이메일 메시지를 파싱하지 않으므로 FetchMessage 함수보다 빠릅니다. 다음 코드 스니펫은 시퀀스 번호(예: 1번)를 사용해 메시지를 저장하는 방법을 보여줍니다. SaveMessage 메서드는 메시지를 파싱하지 않고 원본 EML 형식으로 저장합니다.

저장하기 전에 메시지 파싱

생성된 클라이언트 객체의 ‘fetch_message’ 메서드를 사용합니다. Pop3Client 클래스는 특정 시퀀스 번호를 가진 메시지를 가져오는 기능을 제공합니다. 아래 샘플 코드는 특정 메시지를 가져와 그 제목을 파일 이름으로 사용해 저장하는 방법을 보여줍니다. 이는 msg 객체의 ‘save’ 메서드를 호출하여 수행됩니다.

import aspose.email as ae

client = ae.clients.pop3.Pop3Client("host", 995, "username", "password", ae.clients.SecurityOptions.AUTO)

# Fetch the message by its sequence number and Save the message using its subject as the file name
msg = client.fetch_message(1)
msg.save("first-message_out.eml", ae.SaveOptions.default_eml)

발신자, 수신자 또는 날짜 기반 메시지 필터링

Pop3Client 클래스는 POP3 서버에 연결하는 방법에 대해 설명된 바와 같이 list_messages() 메서드를 제공하여 사서함의 모든 메시지를 가져옵니다. 특정 조건에 맞는 메시지만 가져오려면 MailQuery를 인수로 받는 오버로드된 ListMessages() 메서드를 사용하십시오. MailQuery 클래스는 날짜, 제목, 발신자, 수신자 등 다양한 조건을 지정할 수 있는 속성을 제공합니다. MailQueryBuilder 클래스를 사용해 검색 표현식을 빌드합니다. 먼저 모든 조건과 제약을 설정한 뒤 MailQueryBuilder가 만든 쿼리로 MailQuery를 채웁니다. Pop3Client는 MailQuery 객체를 사용해 서버에서 필터링된 정보를 추출합니다. 이 문서는 사서함에서 이메일을 필터링하는 방법을 보여줍니다. 첫 번째 예제는 날짜와 제목을 기준으로 메시지를 필터링하는 방법을 설명합니다. 또한 다른 기준으로 필터링하는 방법과 복잡한 쿼리를 효율적으로 구성하는 방법을 보여줍니다. 또한 특정 이메일을 사서함에서 가져오기 위해 날짜와 시간 필터를 적용하는 방법도 보여줍니다. 추가로 대소문자를 구분하는 필터링 적용 방법도 포함됩니다.

사서함에서 메시지 필터링

사서함에서 메시지를 필터링하려면:

POP3 서버에 연결하고 로그인합니다.
MailQuery 인스턴스를 만들고 원하는 속성을 설정합니다.
Pop3Client.list_messages(MailQuery query) 메서드를 호출하고 매개변수에 MailQuery를 전달하여 필터링된 메시지만 가져옵니다.

다음 코드 스니펫은 POP3 사서함에 연결하고 오늘 도착한 메시지 중 제목에 "newsletter"가 포함된 메시지를 가져오는 방법을 보여줍니다.

특정 기준에 부합하는 메시지 가져오기

Aspose.Email은 이메일 메시지를 쿼리하고 필터링하기 위한 복잡한 검색 기준을 구축할 수 있게 합니다. 이를 위해 다음을 사용하십시오: MailQueryBuilder 클래스와 그 속성입니다. 가져오기 기준은 다음과 같습니다:

전송 날짜로 메시지를 가져옵니다.
범위 내에서 메시지를 가져옵니다.
특정 발신인에서 메시지를 가져옵니다.
특정 도메인에서 메시지를 가져옵니다.
특정 수신인에게 메시지를 가져옵니다.

오늘 날짜

전송 날짜로 메시지를 가져오려면 아래 코드 예시와 같이 ‘internal_date’ 속성을 사용하십시오:

import aspose.email as ae
from datetime import datetime

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.on(datetime.now())

날짜 범위

날짜 범위 내에서 메시지를 가져오려면 동일한 ‘internal_date’ 속성을 사용해 아래 코드 예시와 같이 날짜 범위를 지정하십시오:

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
# Emails that arrived in last 7 days
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))

특정 발신자

특정 발신인으로부터 메시지를 가져오려면 아래 코드 예시와 같이 ‘from_address’ 속성을 사용하십시오:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("saqib.razzaq@127.0.0.1")

특정 도메인

특정 도메인에서 메시지를 가져오려면 아래 코드 예시와 같이 ‘from_address’ 속성을 사용하십시오:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("SpecificHost.com")

특정 수신인

특정 수신인에게 메시지를 가져오려면 아래 코드 예시와 같이 ’to’ 속성을 사용하십시오:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.to.contains("recipient")

복잡한 쿼리 구축

때때로 하나 이상의 쿼리를 만족해야 할 필요가 있습니다. Aspose.Email은 여러 문장에서 쿼리를 결합함으로써 이를 가능하게 합니다. 다음을 생성하십시오: MailQueryBuilder 객체와 그 속성을 사용해 특정 쿼리를 작성합니다.

AND로 쿼리 결합

다음 코드 스니펫은 AND로 쿼리를 결합하는 방법을 보여줍니다.

import aspose.email as ae
from datetime import datetime, timedelta

builder = ae.tools.search.MailQueryBuilder()
builder.internal_date.before(datetime.now())
builder.internal_date.since(datetime.today() - timedelta(days=7))
builder.from_address.contains("SpecificHost.com")

OR로 쿼리 결합

다음 코드 스니펫은 OR 연산자를 사용해 쿼리를 결합하는 방법을 보여줍니다.

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.either(builder.subject.contains("test"), builder.from_address.contains("noreply@host.com"))

대소문자 구분 필터 적용

API는 또한 대소문자를 구분하는 기준에 따라 사서함에서 이메일을 필터링할 수 있는 기능을 제공합니다. 다음 메서드들은 StringComparisonField 클래스는 대소문자 구분 플래그를 지정하여 이메일을 검색할 수 있는 기능을 제공합니다.

다음 코드 스니펫은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:

import aspose.email as ae

builder = ae.tools.search.MailQueryBuilder()
builder.from_address.contains("noreply@host.com", True)