Documentation – MIME 메시지 작업

Java: 이메일 내용 만들기 및 설정

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

새 이메일 메시지 만들기

Aspose.Email for Java는 개발자가 처음부터 MIME(Multipurpose Internet Mail Extensions) 메시지를 만들 수 있도록 합니다. 이를 위한 Aspose.Email for Java API의 주요 클래스는 MailMessage 클래스. 이 항목에서는 Aspose.Email for Java를 사용하여 EML, MSG 및 MTH 파일 형식의 이메일 메시지를 만드는 데 필요한 단계들을 설명합니다.

처음부터 이메일 메시지를 만들려면:

MailMessage 클래스를 인스턴스화합니다.
사용하여 메시지 제목을 설정합니다. setSubject() 메서드.
사용하여 메시지 본문을 설정합니다. setHtmlBody() 메서드.
사용하여 이메일 발신자를 설정합니다. setFrom() 메서드.
사용하여 TO 필드에 받는 사람을 설정합니다. getTo().add() 메서드.
사용하여 CC 필드에 받는 사람을 설정합니다. getCC().add() 메서드.
다음을 호출합니다. Save() MSG, EML 및 MHT 형식으로 메시지 파일을 디스크에 저장하는 메서드.

다중 수신자 지정

다음은 MailMessage 이메일 메시지를 나타냅니다. MailMessage 클래스의 인스턴스는 SMTP 서버를 통해 전송되는 이메일 메시지를 구성하는 데 사용됩니다. SmtpClient 클래스. 이 항목에서는 하나 이상의 이메일 주소를 지정하는 방법을 보여줍니다. MailMessage 클래스를 사용하여 이메일 주소를 지정할 수 있습니다. MailMessage 클래스에서 사용되는 이메일 주소는 다음과 같습니다:

To - 수신자 주소는 ‘To’ 필드에 지정합니다. ‘To’ 필드의 수신자는 메시지의 주요 대상이며, 여러 수신자 주소를 지정할 수 있습니다.
Cc - CC는 "Carbon Copy"(복사) 또는 "Courtesy Copy"(예의 복사)를 의미하며, 이메일을 볼 필요는 있지만 반드시 행동을 취해야 하는 것은 아닌 수신자를 추가할 수 있습니다. 예를 들어 관리자는 물론 대화 내용을 알아야 하는 팀 구성원 등이 있습니다. Aspose.Email를 사용하면 코드에서 CC 주소를 지정할 수 있습니다. 이렇게 하면 자동 이메일이나 특정 주소로 보내는 모든 이메일을 해당 담당자에게 복사할 수 있습니다.
Bcc - Bcc(Blind Carbon Copy)는 다른 수신자에게 보이지 않게 이메일을 보낼 수 있게 합니다. CC가 주요 수신자가 보는 이메일 정보에 표시되는 반면, Bcc는 표시되지 않습니다. 숨겨진 알림용입니다.

이메일 메시지에 여러 이메일 주소를 지정하려면 다음 단계를 따르세요:

MailMessage 클래스를 인스턴스화합니다.
MailMessage 인스턴스를 사용하여 From 및 여러 To, Cc, Bcc 주소를 지정합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용하여 이메일을 보냅니다.

아래 코드 샘플은 여러 To, CC 및 BCC 주소를 지정하는 방법을 보여줍니다.

이메일 주소를 친숙한 이름으로 변경

아래 프로그래밍 예제는 이메일 메시지에서 이메일 주소를 친숙한 이름으로 변경하는 방법을 보여줍니다. 친숙한 이름은 이메일 주소보다 사람에게 더 친근한 이름이며, 예를 들어 js346@domain.com 대신 John Smith와 같이 사용할 수 있습니다. 이메일을 보낼 때 친숙한 이름을 이메일 주소에 연결할 수 있습니다. MailMessage 클래스 생성자.

이메일 메시지에서 이메일 주소를 친숙한 이름으로 변경하려면 다음 단계를 따르세요:

MailMessage 클래스 인스턴스를 만들고 To 및 From 필드에 친숙한 이름과 함께 이메일 주소를 지정합니다.
MailMessage 인스턴스에서 MailMessage 클래스 생성자를 호출하여 Cc 및 Bcc 이메일 주소와 친숙한 이름을 지정합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용하여 이메일을 보냅니다.

다음 코드 스니펫은 이메일 주소에 대한 이름을 표시하는 방법을 보여줍니다.

메일 본문 설정

다음은 MailMessage 클래스는 이메일 메시지를 나타냅니다. MailMessage 클래스의 인스턴스는 SMTP 서버를 통해 전달되는 이메일 메시지를 구성하는 데 사용됩니다. SmtpClient 클래스. 메일 본문은 MailMessage 클래스를 사용하여 지정할 수 있습니다. 이메일 본문도 다음을 사용하여 지정할 수 있습니다. setHtmlBody MailMessage의 메서드.

뿐만 아니라 HtmlBody, Aspose.Email에는 메일 본문과 관련된 또 다른 메서드가 있습니다:

isBodyHtml: 본문이 HTML인지 일반 텍스트인지 사용자에게 알려줍니다.

이 항목에서는 HTML 본문 텍스트를 정의하고 대체 텍스트를 설정하는 방법을 보여줍니다.

HTML 본문 설정

HtmlBody 메시지 본문의 HTML 내용을 지정하는 데 사용됩니다. HtmlBody는 태그 사이에 있어야 합니다. 다음 코드 스니펫은 HTML 본문을 설정하는 방법을 보여줍니다.

대체 텍스트 설정

다음 사용 AlternateView 다른 형식으로 이메일 메시지 사본을 지정하는 클래스입니다. 예를 들어 HTML로 메시지를 보낼 경우, HTML을 표시할 수 없는 이메일 클라이언트를 사용하는 수신자를 위해 일반 텍스트 버전을 제공하고 싶을 수 있습니다. 이 클래스에는 두 개의 속성이 있습니다, LinkedResources 및 BaseUri, 이는 이메일 내용 내 URL을 해결하는 데 사용됩니다.

LinkedResources는 LinkedResources 객체들의 컬렉션입니다. 렌더링 시 이메일 내용 내 URL은 먼저 LinkedResources 컬렉션에 있는 각 객체의 Content Link URL과 매칭되어 해결됩니다.
BaseUri는 메일 리더가 본문 내 상대 URL을 해결하고, LinkedResources 컬렉션의 상대 Content Link URL을 해결하는 데 사용됩니다.

다음 코드 스니펫은 대체 텍스트를 설정하는 방법을 보여줍니다.

메일 본문 인코딩 지정

콘텐츠 유형은 이메일 내용 형식, 즉 문자 집합을 정의합니다. 예를 들어 java.nio.Charset에서 제공하는 일반적인 문자 집합은 다음과 같습니다:

US-ASCII - 7비트 ASCII, 일명 ISO646-US, 유니코드 문자 집합의 기본 라틴 블록
ISO-8859-1 - ISO 라틴 알파벳 1, 일명 ISO-LATIN-1
UTF-8 - 8비트 UCS 변환 형식
UTF-16BE - 16비트 UCS 변환 형식, 빅 엔디안 바이트 순서
UTF-16LE - 16비트 UCS 변환 형식, 리틀 엔디안 바이트 순서
UTF-16 - 16비트 UCS 변환 형식, 옵션 바이트 순서 표시(BOM)로 바이트 순서를 식별

Aspose.Email은 다음을 사용합니다: BodyEncoding 메일 본문 인코딩을 지정하기 위한 MailMessage 클래스의 속성입니다. 이메일 메시지 본문을 인코딩하려면 아래 단계에 따르세요:

MailMessage 클래스를 인스턴스화합니다.
MailMessage 인스턴스에서 발신자, 수신자 및 HTML 본문 이메일을 지정합니다.
BodyEncoding 속성 값을 지정합니다.
다음의 인스턴스를 생성합니다. SmtpClient 클래스와 Send 메서드를 사용하여 이메일을 보냅니다.

MailMessage 기능

다음은 MailMessage 클래스는 이메일 메시지의 내용을 나타냅니다. MailMessage 클래스의 인스턴스는 SMTP 서버를 통해 전달되는 이메일 메시지를 구성하는 데 사용됩니다. SmtpClient 클래스. 이 문서에서는 다음 이메일 기능을 제어하기 위해 MailMessage 클래스 유틸리티 기능을 활용하는 방법을 보여줍니다:

날짜 및 시간 - MailMessage 클래스를 통해 setDate 이메일의 날짜와 시간을 설정하는 메서드.
메시지 우선순위 - MailPriority 클래스는 이메일 전송 시 우선 순위 수준을 지정합니다. 낮음, 보통, 높음이 있으며, 우선 순위는 전송 속도와 전달에 영향을 줍니다.
메시지 민감도 - MailSensitivity 클래스는 다섯 단계의 민감도를 지정합니다.
배달 알림 - 배달 알림은 발신자에게 이메일이 수신자의 받은편지함에 전달되었음을 알려줍니다.

기본적으로 날짜와 시간은 Microsoft Outlook에 표시되는 대로 메시지가 실제로 전송된 날짜와 시간입니다. 하지만 실제 이메일 전달 시간은 SMTP 서버가 메일 헤더에 추가합니다. 예를 들어 아래는 일반적인 메일 헤더이며, Date 필드는 MailMessage.setDate를 사용해 설정되었습니다.

아래 코드 스니펫은 위에서 논의한 각 기능을 어떻게 사용할 수 있는지 보여줍니다.

수신 확인 요청

아래 프로그래밍 샘플은 수신 확인을 요청하는 방법을 보여줍니다. MailMessage 클래스 DeliveryNotificationOptions 열거형 속성은 설명합니다 배달 알림 옵션 이메일에 대해. 이메일을 보낸 후 수신 확인 요청을 하려면 다음 단계를 따르세요:

MailMessage 클래스를 인스턴스화합니다.
MailMessage 인스턴스에서 이메일의 발신자, 수신자 및 HTML 본문을 지정합니다.
다른 MailMessage 인스턴스에서 DeliveryNotificationOptions를 지정합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용해 이메일을 보냅니다.

읽음 확인 요청이 항상 허용되지 않을 수 있는 이유는:

메일 클라이언트가 해당 기능을 구현하지 않을 수 있습니다.
최종 사용자는 해당 기능을 비활성화했을 수 있습니다.
최종 사용자는 이를 전송하지 않을 수 있습니다.

다음 코드 스니펫은 읽음 확인 요청 방법을 보여줍니다.

이메일 헤더 설정

이메일 헤더는 인터넷 표준을 나타내며 RFC에서 인터넷 이메일 메시지에 포함되는 헤더 필드를 정의합니다. 이메일 헤더는 다음을 사용하여 지정할 수 있습니다. MailMessage 클래스. 일반 헤더 유형은 여기에서 정의됩니다. HeaderType 클래스. 이는 일반 열거형처럼 동작하는 sealed 클래스입니다.

일반적으로 이메일 헤더에는 다음 필드가 포함됩니다:

To: 수신자 주소는 To 필드에 지정할 수 있습니다. To 필드 수신자는 메시지의 주요 대상이며, 수신자 주소는 하나 이상일 수 있습니다.
From: 이 필드는 메시지 발신자의 이메일 주소를 표시합니다.
Cc: 사용자가 메시지를 "Carbon Copy" 혹은 "Courtesy Copy" 로 보낼 수 있게 합니다. 즉, 수신자는 회신하거나 조치를 취할 필요가 없으며, 보통 감독자에게 알리기 위해 사용됩니다.
Bcc: Blind Carbon Copy의 약자로, 수신자 목록 전체가 보이지 않게 메시지를 여러 수신자에게 보내는 방식을 의미합니다. 숨겨진 알림을 위해 사용됩니다.
ReplyTo: 이 헤더 필드는 발신자가 회신을 받고자 하는 주소를 나타냅니다.
Subject: 제목, 헤딩, 주제. 일반적으로 다른 메시지에 회신하거나 댓글을 달 때 스레드 표시기로 사용됩니다.
Date: 이 헤더는 날짜(및 시간)를 지정합니다. 일반적으로 메시지가 작성되고 전송된 날짜입니다.
XMailer: 발신자의 클라이언트 소프트웨어에 대한 정보입니다. 예: X-Mailer: Aspose.Email XMailer는 메일 클라이언트에서 사용됩니다. 클라이언트마다 XMailer 값이 다릅니다. MS Outlook의 XMailer 값은 Microsoft Office Outlook, Build 11.0.5510입니다. 이는 이메일 수신자나 읽는 프로그램에 의해 무시됩니다.

일반적으로 이메일 헤더는 다음과 같이 보입니다:


 Reply-To: reply@reply.com

From: sender@sender.com

To: guangzhou@guangzhoo.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

이메일 헤더를 사용자 정의하려면 다음 단계를 따르세요:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
MailMessage 클래스 인스턴스를 사용하여 To, From, CC, Bcc, ReplyTo, Subject, Date 및 XMailer를 지정합니다.
다음의 인스턴스를 생성합니다. MimeHeader 클래스와 비밀 헤더를 지정합니다.
MailMessage 인스턴스에 비밀 헤더를 추가합니다.

아래 제공된 코드에서 이메일 헤더를 사용자 정의했습니다.

위 코드 스니펫은 다음 형식의 이메일 헤더를 생성합니다. 이는 Microsoft Outlook에서 MsgHeaders.msg 파일을 열고 속성을 확인하면 확인할 수 있습니다.


 Reply-To: reply@reply.com

From: sender@sender.com

To: receiver1@receiver.com

CC: receiver2@receiver.com

BCC: receiver3@receiver.com

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

특정 위치에 헤더 삽입

다음은 추가 HeadersCollection의 메서드는 헤더를 컬렉션 끝에 삽입합니다. 그러나 특정 위치에 헤더를 삽입해야 할 경우가 있습니다. 이 경우 Add 메서드는 도움이 되지 않으며, 이를 위해서는 Insert HeadersCollection의 메서드입니다. 컬렉션에 동일한 이름의 헤더가 포함되어 있으면 이 헤더는 동일한 이름의 다른 헤더 앞에 삽입됩니다. 아래는 Insert 메서드 서명과 사용 예시 코드입니다.


 Method Signature

HeaderCollection.insert(String name, String value)

이메일에 사용자 정의 헤더 추가

아래 프로그래밍 샘플은 이메일 메시지에 사용자 정의 헤더를 지정하는 방법을 보여줍니다. 이메일 헤더는 MailMessage 클래스를 사용하여 지정할 수 있습니다. 이메일 메시지에 사용자 정의 헤더를 지정하려면 다음 단계를 따르세요:

MailMessage 클래스를 인스턴스화합니다.
MailMessage 인스턴스를 사용하여 to, from 및 subject 값을 지정합니다.
비밀 헤더를 MailMessage 인스턴스에 추가합니다.
SmtpClient 클래스를 인스턴스화하고 Send 메서드를 사용하여 이메일을 보냅니다.

다음 코드 스니펫은 이메일에 사용자 정의 헤더를 추가하는 방법을 보여줍니다.

DKIM으로 이메일 서명

Aspose.Email은 DKIM(DomainKeys Identified Mail)으로 이메일에 서명할 수 있게 합니다. 이를 통해 조직은 전송 중인 메시지에 대한 책임을 질 수 있습니다 (DKIM에 대하여). DKIM은 수신자가 검증할 수 있는 디지털 서명을 이메일 메시지 헤더에 추가합니다. 발신자의 공개 키를 통해 수신자는 서명이 메시지 내용과 일치하는지 확인할 수 있습니다. MailMessage 클래스 dKIMSign 메서드는 메시지 서명을 위한 암호화 및 서명 정보를 설정하는 데 사용됩니다. 아래 코드 스니펫은 DKIM으로 이메일에 서명하는 방법을 보여줍니다.

메일 병합 수행

메일 병합을 사용하면 유사한 이메일 메시지를 일괄 생성 및 전송할 수 있습니다. 이메일 내용은 동일하지만, 받는 사람의 연락처 정보(이름, 성, 회사 등)를 활용해 개인화할 수 있습니다.

|| | :- | |그림: 메일 병합 작동 방식 설명|

Aspose.Email으로 메일 병합을 수행하려면 다음 단계를 따르세요:

signature 라는 이름의 함수를 생성합니다
다음의 인스턴스를 생성합니다. MailMessage 클래스.
보낸 사람, 받는 사람, 제목 및 본문을 지정합니다.
이메일 끝에 서명을 생성합니다.
다음의 인스턴스를 생성합니다. TemplateRoutine 클래스와 이를 전달합니다 MailMessage 인스턴스.
다음에서 서명을 가져옵니다 TemplateRoutine 인스턴스.
다음의 인스턴스를 생성합니다. DataTable 클래스.
DataTable 클래스에 Receipt, FirstName 및 LastName 열을 데이터 소스로 추가합니다
다음의 인스턴스를 생성합니다. DataRow 클래스
DataRow 객체에서 영수증 주소와 이름(성, 이름)을 지정합니다
다음의 인스턴스를 생성합니다. MailMessageCollection 클래스
지정하세요 TemplateRoutine 및 DataTable 인스턴스를 MailMessageCollection 인스턴스.
다음의 인스턴스를 생성합니다. SmtpClient 클래스를 사용하고 서버, 포트, 사용자 이름 및 비밀번호를 지정합니다
다음으로 이메일 전송: SmtpClient BulkSendAsync 클래스 메서드

아래 코드는 세 명이 한 명에게 이메일을 보냅니다.

Java: 첨부 파일 및 내장 객체 작업

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

이메일 첨부 파일 관리

이메일 첨부 파일은 이메일 메시지와 함께 전송되는 파일입니다. 파일은 별도의 메시지로도 전송될 수 있고, 첨부된 메시지의 일부로도 전송될 수 있습니다. 그 Attachment 클래스는 MailMessage 클래스. 모든 메시지는 본문을 포함합니다. 본문 외에 추가 파일을 전송하려면 첨부 파일로 전송되며, 이는 다음 클래스의 인스턴스로 표현됩니다 Attachment 클래스. 첨부 파일 수에는 제한이 없지만 첨부 파일 크기는 메일 서버에 의해 제한됩니다. 예를 들어 Gmail은 10MB 초과 파일을 지원하지 않습니다.

사용해 보세요!

무료로 온라인에서 이메일 첨부 파일을 추가하거나 제거하세요 Aspose.Email Editor App.

첨부 파일 추가

이메일에 첨부 파일을 추가하려면 다음 단계를 따르세요:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
다음의 인스턴스를 생성합니다. Attachment 클래스.
첨부 파일을 로드합니다 Attachment 인스턴스.
다음 추가 Attachment 인스턴스를 MailMessage 인스턴스.

다음 코드 스니펫은 이메일에 첨부 파일을 추가하는 방법을 보여줍니다.

// Create an instance of MailMessage class
MailMessage message = new MailMessage();
message.setFrom(new MailAddress("sender@from.com"));
message.getTo().add("receiver@to.com");
message.setSubject("This is message");
message.setBody("This is body");

// Load an attachment
Attachment attachment = new Attachment("1.txt");

// Add Multiple Attachment in instance of MailMessage class and Save message to disk
message.getAttachments().addItem(attachment);
message.addAttachment(new Attachment("1.jpg"));
message.addAttachment(new Attachment("1.doc"));
message.addAttachment(new Attachment("1.rar"));
message.addAttachment(new Attachment("1.pdf"));
message.save("AddAttachments.eml");

앞서 Aspose.Email를 사용하여 이메일 메시지에 첨부 파일을 추가하는 방법을 설명했습니다. 다음은 첨부 파일을 제거하고 화면에 정보를 표시하는 방법을 보여줍니다.

첨부 파일 제거

첨부 파일을 제거하려면 아래 단계를 따르세요:

다음의 인스턴스를 생성합니다 Attachment 클래스.
인스턴스에 첨부 파일을 로드합니다 Attachment 클래스.
인스턴스에 첨부 파일을 추가합니다 MailMessage 클래스.
인스턴스에서 첨부 파일을 제거합니다 Attachment 클래스 사용 MailMessage 클래스 인스턴스.

다음 코드 스니펫은 첨부 파일을 제거하는 방법을 보여줍니다.

// Create an instance of MailMessage class
MailMessage eml = new MailMessage();
eml.setFrom(new MailAddress("sender@from.com"));
eml.getTo().add("receiver@to.com");

// Load an attachment
Attachment attachment = new Attachment("1.txt");
eml.getAttachments().addItem(attachment);

// Remove attachment from your MailMessage
eml.getAttachments().removeItem(attachment);

첨부 파일 이름 표시

첨부 파일 이름을 표시하려면 다음 단계를 따르세요:

이메일 메시지의 첨부 파일을 순회하고
1. 각 첨부 파일을 저장합니다.
2. 각 첨부 파일 이름을 화면에 표시합니다.

다음 코드 스니펫은 화면에 첨부 파일 이름을 표시하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("Attachments.eml");

for (Attachment attachment : eml.getAttachments()) {
    // Display the attachment file name
    System.out.println(attachment.getName());
}

이메일 첨부 파일 추출

이 항목에서는 이메일 파일에서 첨부 파일을 추출하는 방법을 설명합니다. 이메일 첨부 파일은 이메일 메시지와 함께 전송되는 파일입니다. 파일은 별도의 메시지로 전송될 수도 있고, 첨부된 메시지의 일부로 전송될 수도 있습니다. 모든 이메일 메시지는 추가 파일을 전송할 수 있는 옵션을 제공하며, 이러한 파일은 첨부 파일로 전송되고 다음 클래스의 인스턴스로 표시됩니다. Attachment 클래스. Attachment 클래스는 MailMessage 클래스는 첨부 파일을 다룹니다. 이메일 메시지에서 첨부 파일을 추출하려면 다음 단계를 따르세요:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
이메일 파일을 로드합니다 MailMessage 인스턴스.
다음의 인스턴스를 생성합니다. Attachment 클래스를 사용하여 루프에서 모든 첨부 파일을 추출합니다.
첨부 파일을 저장하고 화면에 표시합니다.

|이메일에서 추출된 첨부 파일| | :- | || 다음 코드 스니펫은 이메일 첨부 파일을 추출하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("Message.eml", new MsgLoadOptions());

for (Attachment attachment : eml.getAttachments()) {
    attachment.save("MessageEmbedded_out.eml");
    System.out.println(attachment.getName());
}

첨부 파일에서 Content-Description 가져오기

Aspose.Email API는 첨부 파일 헤더에서 Content-Description을 읽을 수 있는 기능을 제공합니다. 다음 코드 스니펫은 첨부 파일에서 내용 설명을 가져오는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");
System.out.println(eml.getAttachments().get_Item(0).getHeaders().get_Item("Content-Description"));

첨부 파일이 포함된 메시지인지 판단

다음 코드 스니펫은 첨부 파일이 포함된 메시지인지 여부를 판단하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");

System.out.println(eml.getAttachments().get_Item(0).isEmbeddedMessage()
        ? "Attachment is an embedded message."
        : "Attachment isn't an embedded message.");

TNEF 형식 첨부 파일 판단

다음은 Attachment.isTnef Aspose.Email Java API의 해당 속성은 첨부 파일이 TNEF 형식인지 여부를 나타냅니다.

다음 코드 스니펫은 첨부 파일이 TNEF 형식인지 확인하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load(fileName);

for (Attachment attachment : eml.getAttachments()) {
    System.out.println("Is Attachment TNEF?: " + attachment.isTnef());
}

TNEF 첨부 파일 로드 및 저장

Aspose.Email for Java는 다음 메서드를 제공합니다 MapiAttachment 다음 작업을 수행하는 클래스:

TNEF 로드

static MapiAttachment loadFromTnef(String fileName) – TNEF 파일에서 첨부 파일을 로드합니다.
static MapiAttachment loadFromTnef(InputStream stream) – TNEF 스트림에서 첨부 파일을 로드합니다.

TNEF 저장

void saveToTnef(String fileName) – 첨부 파일을 TNEF 파일에 저장합니다.
void saveToTnef(OutputStream stream) – 첨부 파일을 TNEF 스트림에 저장합니다.

다음 코드 샘플은 메시지에서 TNEF 첨부 파일을 추출하고, 스트림 또는 파일에 저장한 뒤, 다시 메시지에 로드하는 방법을 보여줍니다. MapiAttachment:

// Load message containing a TNEF attachment (winmail.dat)
MapiMessage msg = MapiMessage.load("message.eml");

// Save the first attachment to a TNEF stream
ByteArrayOutputStream bos = new ByteArrayOutputStream();
msg.getAttachments().get(0).saveToTnef(bos);

// Load attachment back from the TNEF stream
ByteArrayInputStream bis = new ByteArrayInputStream(bos.toByteArray());
MapiAttachment fromtnefAttachment = MapiAttachment.loadFromTnef(bis);
msg.getAttachments().addMapiAttachment(fromtnefAttachment);

// Load TNEF attachment directly from a file
fromtnefAttachment = MapiAttachment.loadFromTnef("winmail.dat");
msg.getAttachments().addMapiAttachment(fromtnefAttachment);

첨부 파일이 URI-첨부인 경우 URI 추출

다음 코드 스니펫은 첨부 파일 URI를 추출하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("fileName");

Attachment attachment = eml.getAttachments().get_Item(0);
if (attachment.isUri()) {
    InputStream inputStream = attachment.getContentStream();
    String uri = new String(IOUtils.toByteArray(inputStream), Charset.forName("utf-8"));
    System.out.println("Attachment URI: " + uri);
}

참조 첨부 추가

참조 첨부 파일은 로컬 파일 첨부의 대안입니다. 경우에 따라 접근을 관리하고 싶을 때와 같이 참조 첨부 파일이 더 적합할 수 있습니다. 아래 클래스들은 이메일 메시지와 그 첨부 파일을 관리하고 조작하는 데 사용됩니다.

ReferenceAttachment - 참조 첨부 파일을 나타냅니다.
AttachmentPermissionType - 웹 참조 첨부 파일과 연관된 권한 유형 데이터.
AttachmentProviderType - 첨부 파일을 조작하는 웹 서비스 유형.

다음 코드 샘플은 파일에서 이메일 메시지를 로드하고, 특정 속성을 가진 참조 첨부 파일을 생성한 다음, 해당 첨부 파일을 이메일 메시지에 추가하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("fileName");

ReferenceAttachment refAttach = new ReferenceAttachment("https://[attach_uri]")
refAttach.setName("Document.docx");
refAttach.setProviderType(AttachmentProviderType.OneDrivePro);
refAttach.setPermissionType(AttachmentPermissionType.AnyoneCanEdit);

eml.getAttachments().addItem(refAttach);

포함된 개체 작업

포함된 개체는 하나의 애플리케이션으로 생성되어 다른 애플리케이션에서 만든 문서나 파일에 포함된 개체입니다. 예를 들어 Microsoft Excel 스프레드시트를 Microsoft Word 보고서에 포함하거나 비디오 파일을 Microsoft PowerPoint 프레젠테이션에 포함할 수 있습니다. 파일이 삽입되는 대신 포함되면 원래 형식을 유지합니다. 포함된 문서는 원본 애플리케이션에서 열어 수정할 수 있습니다.

이메일에 개체 포함

다음은 LinkedResource 클래스는 MailMessage 클래스는 이메일 메시지에 개체를 포함합니다. 포함된 개체를 추가하려면 다음 단계를 따르세요.

다음의 인스턴스를 생성합니다. MailMessage 클래스.
보낸 사람, 받는 사람 및 제목 값을 지정합니다 MailMessage 인스턴스.
다음의 인스턴스를 생성합니다. AlternateView 클래스.
다음의 인스턴스를 생성합니다. LinkedResource 클래스.
포함된 개체를 다음에 로드합니다 LinkedResourceCollection.
로드된 포함된 개체를 다음에 추가합니다 MailMessage 클래스 인스턴스.
다음 추가 AlternateView 인스턴스를 MailMessage 클래스 인스턴스.

아래 코드 스니펫은 일반 텍스트와 HTML 본문을 모두 포함하고 HTML에 이미지가 포함된 이메일 메시지를 생성합니다.

|이메일에 포함된 이미지| | :- | || 포함된 개체를 원하는 만큼 보낼 수 있습니다. 첨부 파일 크기는 메일 서버에 의해 제한됩니다. 예를 들어 Gmail은 10MB를 초과하는 파일을 지원하지 않습니다. 아래 코드 스니펫은 이메일에 개체를 포함하는 방법을 보여줍니다.

// Create an instance of the MailMessage class and Set the addresses and Set the content
MailMessage mail = new MailMessage();
mail.setFrom(new MailAddress("sender@from.com"));
mail.getTo().add("receiver@to.com");
mail.setSubject("This is an email");

// Create the plain text part It is viewable by those clients that don't support HTML
AlternateView plainView = AlternateView.createAlternateViewFromString("This is my plain text content", null, "text/plain");

// Create the HTML part.To embed images, we need to use the prefix 'cid' in the img src value. 
// The cid value will map to the Content-Id of a Linked resource. 
// Thus <img src='cid:barcode'> will map to a LinkedResource with a ContentId of //'barcode'.
AlternateView htmlView = AlternateView.createAlternateViewFromString("Here is an embedded image.<img src=cid:barcode>", null, "text/html");

// Create the LinkedResource (embedded image) and Add the LinkedResource to the appropriate view
LinkedResource barcode = new LinkedResource("1.jpg", MediaTypeNames.Image.JPEG);
barcode.setContentId("barcode");

mail.getLinkedResources().addItem(barcode);
mail.getAlternateViews().addItem(plainView);
mail.getAlternateViews().addItem(htmlView);
mail.save("EmbeddedImage_out.msg", SaveOptions.getDefaultMsgUnicode());

이메일에서 포함된 개체 제거

LinkedResourceCollection 다음으로 접근 MailMessage.LinkedResources 속성. LinkedResourceCollection 컬렉션은 이메일 메시지에 추가된 포함된 개체를 완전히 제거하는 메서드를 제공합니다. 다음의 오버로드된 버전을 사용하십시오 LinkedResourceCollection.removeAt 이메일 메시지에서 포함된 개체의 모든 흔적을 제거하는 메서드.

아래 샘플 코드는 이메일 메시지에서 포함된 개체를 제거하는 방법을 보여줍니다.

// Load the test message with Linked Resources
MailMessage msg = MailMessage.load("EmlWithLinkedResources.eml");

// Remove a LinkedResource
msg.getLinkedResources().removeAt(0, true);

// Now clear the Alternate View for linked Resources
msg.getAlternateViews().get_Item(0).getLinkedResources().clear(true);

포함된 개체 추출

이 항목에서는 이메일 파일에서 포함된 개체를 추출하는 방법을 설명합니다. 포함된 개체는 하나의 애플리케이션으로 생성되고 다른 애플리케이션에서 만든 문서나 파일에 포함된 개체를 말합니다. 예를 들어 Microsoft Excel 스프레드시트를 Microsoft Word 보고서에 포함하거나 비디오 파일을 Microsoft PowerPoint 프레젠테이션에 포함시킬 수 있습니다. 파일이 삽입되거나 복사되지 않고 포함되면 원래 형식을 유지합니다. 포함된 문서는 원본 애플리케이션에서 열어 수정할 수 있습니다. 이메일 메시지에서 포함된 개체를 추출하려면 다음 단계를 따르세요:

다음의 인스턴스를 생성합니다. MailMessage 클래스.
이메일 파일을 로드합니다 MailMessage 인스턴스.
루프를 만들고 해당 클래스의 인스턴스를 생성합니다. Attachment 그 안의 클래스.
첨부 파일을 저장하고 화면에 표시합니다.
보낸 사람과 받는 사람 주소를 지정합니다 MailMessage 인스턴스.
다음 방법을 사용하여 이메일을 보냅니다 SmtpClient 클래스.

아래 코드 스니펫은 이메일에서 내장 객체를 추출합니다.

|이메일에서 추출된 내장 객체| | :- | || 다음 코드 스니펫은 내장 객체를 추출하는 방법을 보여줍니다.

MailMessage mailMsg = MailMessage.load("Message.msg", new MsgLoadOptions());

for (Attachment attachment : mailMsg.getAttachments()) {
    attachment.save("MessageEmbedded_out.msg");
    System.out.println(attachment.getName());
}

RTF 형식 MSG에서 내장된 첨부 파일 식별 및 추출

다음 코드는 RTF 형식 메시지에서 인라인 또는 아이콘 형태로 나타나는 첨부 파일을 구분하고 추출하는 데 사용할 수 있습니다. 아래 코드 스니펫은 RTF 형식 MSG에서 내장된 첨부 파일을 식별하고 추출하는 방법을 보여줍니다.

public static void extractInlineAttachments() {
    MapiMessage message = MapiMessage.load("MSG file with RTF Formatting.msg");
    for (MapiAttachment attachment : message.getAttachments()) {

        if (isAttachmentInline(attachment)) {
            try {
                saveAttachment(attachment, UUID.randomUUID().toString());
            } catch (Exception ex) {
                System.err.println(ex);
            }
        }
    }
}

static boolean isAttachmentInline(MapiAttachment attachment) {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("\u0003ObjInfo".equals(property.getName())) {
            byte[] data = property.getData();
            int odtPersist1 = data[1] << 8 | data[0];
            return (odtPersist1 & 0x40) == 0;
        }
    }
    return false;
}

static void saveAttachment(MapiAttachment attachment, String fileName) throws IOException {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("Package".equals(property.getName())) {
            try (FileOutputStream fs = new FileOutputStream(fileName)) {
                fs.write(property.getData(), 0, property.getData().length);
            }
        }
    }
}

서명된 이메일에서 첨부 파일 가져오기

서명된 이메일에는 단일 smime.p7m 첨부 파일이 포함됩니다. 이는 이메일이 SMIME으로 암호화되었음을 의미합니다. Smime.p7m 파일 형식은 디지털 서명입니다. 이 이메일의 내용을 보려면 RemoveSignature 메서드. 이 메서드는 MailMessage 디지털 서명 없는 객체.

MailMessage signedEml = MailMessage.load("signed.eml");

if (signedEml.isSigned()) {
    for (int i = 0; i < signedEml.getAttachments().size(); i++) {
        System.out.println("Signed email attachment" + i + ": " + signedEml.getAttachments().get_Item(i).getName());
    }

    // The email is signed. Remove a signature.
    MailMessage eml = signedEml.removeSignature();

    System.out.println("Signature removed.");

    for (int i = 0; i < eml.getAttachments().size(); i++) {
        System.out.println("Email attachment" + i + ": " + eml.getAttachments().get_Item(i).getName());
    }
}

Content-Type 및 Content-Disposition 작업

Aspose.Email API는 첨부 파일과 작업할 수 있는 기능을 제공합니다 Content-Type 및 Content-Disposition 첨부 파일 헤더에서. 다음 코드 스니펫은 첨부 파일의 내용 설명을 가져오고 변경하는 방법을 보여줍니다.

Content-Type 및 Content-Disposition 매개변수 표시

다음 코드 스니펫은 화면에 Content-Type 및 Content-Disposition 매개변수를 표시하는 방법을 보여줍니다:

void run(MailMessage message) {
    // Attachments
    for (Attachment attachment : message.getAttachments()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
    // Linked Resources
    for (LinkedResource attachment : message.getLinkedResources()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
}

void printContentType(ContentType contentType) {
    System.out.println("media-type: " + contentType.getMediaType());
    System.out.println("charset: " + contentType.getCharSet());
    System.out.println("name: " + contentType.getName());
}

void printContentDisposition(ContentDisposition contentDisposition) {
    System.out.println("disposition-type: " + contentDisposition.getDispositionType());
    System.out.println("is-inline: " + contentDisposition.getInline());
    System.out.println("filename: " + contentDisposition.getFileName());
    System.out.println("creation-date: " + contentDisposition.getCreationDate());
    System.out.println("modification-date: " + contentDisposition.getModificationDate());
    System.out.println("read-date: " + contentDisposition.getReadDate());
    System.out.println("size: " + contentDisposition.getSize());
}

첨부 파일에 Content-Type 및 Content-Disposition 매개변수 사용

다음 코드 스니펫은 첨부 파일과 함께 Content-Type 및 Content-Disposition 매개변수를 사용하는 방법을 보여줍니다:

MailMessage eml = MailMessage.load(fileName);

Attachment attachment = new Attachment(pdfFileName, new ContentType("application/octet-stream"));
attachment.getContentDisposition().setDispositionType("attachment");
attachment.getContentDisposition().setFileName(fileName);

eml.addAttachment(attachment);

Java: 이메일에서 메시지 내용 추출

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

화면에 이메일 정보 표시

다음은 MailMessage 이것은 이메일 메시지를 나타내며 개발자가 이메일 메시지 속성에 접근할 수 있게 합니다. 헤더 정보는 (다음에서 논의됨) 이메일 헤더 추출)는 다양한 방법으로 추출 및 조작할 수 있습니다. 이 문서에서는 선택된 이메일 헤더 정보와 이메일 본문을 화면에 표시하는 방법을 설명합니다.

MailMessage 인스턴스를 생성합니다.
MailMessage 인스턴스로 이메일 메시지를 로드합니다.
이메일 내용을 화면에 표시합니다.

아래 코드는 이메일 메시지를 로드하고 그 내용(보낸 사람, 받는 사람, 제목 및 본문)을 화면에 표시하는 방법을 보여줍니다.

메시지 날짜 및 시간 가져오기

다음은 MailMessage 클래스를 사용하여 메시지 날짜를 UTC 또는 로컬 시간대로 가져올 수 있습니다. 이 정보는 다음과 같이 요약될 수 있습니다:

MailMessage.getDate() - UTC 기준 날짜를 반환합니다
MailMessage.getLocalDate() - 로컬 시간대의 날짜를 반환합니다.
MailMessage.isLocalDate **MailMessage.getDate()**가 로컬 시간대에 있으면 true를 반환합니다.

이메일 헤더 추출

이메일 헤더는 인터넷 이메일 메시지에 포함되는 인터넷 및 RFC 정의 표준 헤더 필드 집합을 나타냅니다. 이메일 헤더는 다음을 사용하여 지정할 수 있습니다. MailMessage 클래스. 일반 헤더 유형은 여기에서 정의됩니다. HeaderType 클래스. 일반 열거형처럼 작동하는 sealed 클래스입니다.

이메일에서 헤더를 추출하려면 다음 단계를 따르세요:

MailMessage 클래스의 인스턴스를 생성합니다.
MailMessage 클래스 인스턴스로 이메일 메시지를 로드합니다.
이메일 메시지를 로드한 후 원시 내용을 가져옵니다. MailMessage 클래스 자체에는 From, To, Cc, Subject 등과 같은 속성이 포함되어 있습니다. 이러한 속성은 헤더에서 추출할 수 있습니다.
원시 내용을 표시합니다.

디코드된 헤더 값 가져오기

연결된 리소스 Disposition 헤더 가져오기 및 수정하기

연결된 리소스는 이메일 메시지 객체에서 프로그래밍 방식으로 액세스하고 조작할 수 있습니다. getContentDisposition() 메서드 LinkedResource 클래스는 Content-Disposition 헤더를 가져옵니다. 아래 코드 샘플은 연결된 리소스의 파일명을 액세스하고 수정하는 방법을 보여줍니다:

MailMessage eml = MailMessage.load(fileName);
eml.getLinkedResources().get_Item(0).getContentDisposition().setFileName("changed.png");

HTML 본문을 일반 텍스트로 가져오기

다음은 MailMessage 클래스는 메시지의 HTML 본문을 일반 텍스트로 추출하는 기능을 제공합니다. MailMessage 클래스는 GetHtmlBodyText HTML 본문을 일반 텍스트로 반환하는 메서드입니다. GetHtmlBodyText 메서드는 본문에 URL을 포함할지 여부를 나타내는 불리언 매개변수를 받습니다. 매개변수를 true 로 전달하면 HTML 본문에 URL이 포함됩니다.

다음 코드 스니펫은 GetHtmlBodyText 메서드를 사용하여 이메일의 HTML 본문을 일반 텍스트로 추출하는 방법을 보여줍니다.

이메일에서 X.500 Exchange 주소 가져오기

Aspose.Email for Java는 X.500 Exchange 주소에 직접 액세스할 수 있게 해줍니다. MailAddress 클래스. 다음과 함께 X500Address 속성을 사용하면 사용 가능한 경우 Exchange X.500 형식의 이메일 주소를 가져올 수 있습니다. 다음 코드 샘플은 이메일 메시지를 로드하고 발신자의 X.500 주소를 가져오는 방법을 보여줍니다:

MailMessage mailMessage = MailMessage.load(fileName);
String exaddr = mailMessage.getFrom().getX500Address();

X.500 주소가 존재하면 문자열로 반환되며, Exchange 기반 시스템과 연동되는 애플리케이션에서 추가 처리나 로깅에 사용할 수 있습니다.

HTML 이메일에서 연결된 이미지를 추출하고 첨부 파일로 삽입하기

Aspose.Email ExtractHTMLBodyResourcesAsAttachments 메서드 HtmlSaveOption 클래스는 HTML 본문 리소스를 첨부 파일로 추출할지 여부를 정의합니다. 따라서 HTML 본문에서 이미지 링크된 콘텐츠를 추출하여 MIME 메시지에 첨부 파일로 삽입할 수 있습니다. 연결된 이미지는 보존되고 이메일과 적절히 연결되어 콘텐츠 무결성과 오프라인 접근성을 향상시킵니다.

다음 코드 샘플은 이 작업을 수행하는 방법을 보여줍니다:

MailMessage mailMessage = MailMessage.load("input.eml");
HtmlSaveOptions options = new HtmlSaveOptions();
options.setExtractHTMLBodyResourcesAsAttachments(true);
options.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {
    public void invoke(final Object sender, final ResourceHtmlRenderingEventArgs e) {
        System.out.println(e.getPathToResourceFile() + " " + ((Attachment)sender).getContentId());
    }
});

Java: 메시지 로드 및 저장

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

이메일 메시지 로드 및 저장

파일 형식 감지

Aspose.Email API는 제공된 메시지 파일의 파일 형식을 감지하는 기능을 제공합니다. The DetectFileFormat 메서드 FileFormatUtil 이 작업을 수행할 수 있는 클래스입니다. 다음 클래스와 메서드를 사용하여 로드된 파일 형식을 감지할 수 있습니다.

FileFormatType 클래스
FileFormatInfo 클래스
FileFormatUtil 클래스
FileFormatUtil.detectFileFormat(Stream) Method
FileFormatUtil.detectFileFormat(String) Method

다음 코드 스니펫은 파일 형식을 감지하는 방법을 보여줍니다.

이메일 메시지 로드

특정 로드 옵션으로 메시지를 로드하려면 Aspose.Email가 제공합니다. LoadOptions 다음과 같이 사용할 수 있는 클래스:

로드 중 임베디드 메시지 형식 보존

이메일 메시지 저장 및 변환

Aspose.Email를 사용하면 모든 메시지 유형을 다른 형식으로 쉽게 변환할 수 있습니다. 이 기능을 보여주기 위해 이 문서의 코드는 디스크에서 세 종류의 메시지를 로드하고 다른 형식으로 다시 저장합니다. 기본 클래스 SaveOptions 및 클래스 EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions 저장 시 추가 설정을 위해 MailMessage 다른 형식으로 메시지를 저장하는 데 사용할 수 있습니다. 이 문서는 이러한 클래스를 사용하여 샘플 이메일을 다음과 같이 저장하는 방법을 보여줍니다:

EML 형식.
Outlook MSG.
MHTML 형식.
HTML 형식.

이메일 메시지 로드 및 저장

다음 코드 스니펫은 EML 메시지를 로드하고 동일한 형식으로 디스크에 저장하는 방법을 보여줍니다.

원본 경계를 보존하며 이메일 메시지 로드 및 저장

다음 코드 스니펫은 원본 경계를 보존하면서 EML을 로드하고 EML로 저장하는 방법을 보여줍니다.

TNEF 첨부 파일을 보존하며 EML로 저장

다음 코드 스니펫은 TNEF 첨부 파일을 보존하면서 EML로 저장하는 방법을 보여줍니다.

EML을 MSG로 저장

다음 코드 스니펫은 EML 메시지를 로드하고 적절한 옵션을 사용하여 MSG로 변환하는 방법을 보여줍니다: SaveOptions.

날짜 보존하면서 EML을 MSG로 저장

다음은 MsgSaveOptions 이 클래스는 날짜를 보존하면서 소스 메시지를 Outlook 메시지 파일(MSG)로 저장할 수 있게 해줍니다. 다음 코드 스니펫은 날짜를 보존하며 MSG로 저장하는 방법을 보여줍니다.

EML을 MHTML로 저장

원하는 결과를 얻기 위해 다양한 MHTML 옵션을 사용할 수 있습니다. 다음 코드 스니펫은 EML 메시지를 로드하는 방법을 보여줍니다: MailMessage 그리고 UTC 시스템의 메시지 날짜와 함께 MHTML로 변환합니다.

// Set options for MHTML output
MhtSaveOptions saveOptions = SaveOptions.getDefaultMhtml();
// save a message date as UTC date
saveOptions.setPreserveOriginalDate(false);

// Initialize and load an existing EML file
try (MailMessage mailMessage = MailMessage.load(dataDir + "Message.eml")) {
    mailMessage.save(outDir + "Message_out.mhtml", saveOptions);
}

EML 저장 시 MHT 헤더 전역 형식 지정

Aspose.Email를 사용하면 MHT 헤더에 대한 전역 형식 옵션을 사용할 수 있습니다. 전역 옵션은 모든 MHT 헤더에 공통 형식을 설정합니다. MhtSaveOptions 인스턴스. 이 기능은 각 인스턴스마다 형식을 설정하는 것을 방지하도록 설계되었습니다. MhtSaveOptions.

다음 메서드를 사용합니다: GlobalFormattingOptions 클래스와 아래 코드 샘플은 MHT 헤더의 형식을 설정합니다:

setPageHeaderFormat(String value) - DefaultPageHeaderFormat이 설정되지 않은 경우 HeadersFormattingOptions 인스턴스에 대한 PageHeaderFormat.
setHeaderFormat(String value) - DefaultHeaderFormat이 설정되지 않은 경우 HeadersFormattingOptions 인스턴스에 대한 HeaderFormat.
setBeforeHeadersFormat(String value) - BeforeHeadersFormat이 설정되지 않은 경우 HeadersFormattingOptions 인스턴스에 대한 BeforeHeadersFormat.
setAfterHeadersFormat(String value) - AfterHeadersFormat이 설정되지 않은 경우 HeadersFormattingOptions 인스턴스에 대한 AfterHeadersFormat.

// saveOptions1 and saveOptions2 have the same mht header formatting
MhtSaveOptions saveOptions1 = new MhtSaveOptions();
MhtSaveOptions saveOptions2 = new MhtSaveOptions();

옵션 설정으로 EML을 MHTML로 변환

다음은 MhtSaveOptions 이 클래스는 이메일 메시지를 MHTML 형식으로 저장하기 위한 추가 옵션을 제공합니다. 열거형 MhtFormatOptions 추가 이메일 정보를 출력 MHTML에 기록할 수 있게 합니다. 다음 추가 필드를 기록할 수 있습니다:

WriteHeader - 이메일 헤더를 출력 파일에 씁니다.
WriteOutlineAttachments - 개요 첨부 파일을 출력 파일에 씁니다.
WriteCompleteEmailAddress - 전체 이메일 주소를 출력 파일에 씁니다.
NoEncodeCharacters - 문자에 대한 전송 인코딩을 사용하지 않아야 합니다.
HideExtraPrintHeader - 출력 파일 상단의 추가 인쇄 헤더를 숨깁니다.
WriteCompleteToEmailAddress - 수신자의 전체 이메일 주소를 출력 파일에 씁니다.
WriteCompleteFromEmailAddress - 발신자의 전체 이메일 주소를 출력 파일에 씁니다.
WriteCompleteCcEmailAddress - 참조 수신자의 전체 이메일 주소를 출력 파일에 씁니다.
WriteCompleteBccEmailAddress - 숨은 참조 수신자의 전체 이메일 주소를 출력 파일에 씁니다.
RenderCalendarEvent - 캘린더 이벤트의 텍스트를 출력 파일에 씁니다.
SkipByteOrderMarkInBody - 바이트 순서 표시(BOM) 바이트를 출력 파일에 씁니다.
RenderVCardInfo - VCard AlternativeView의 텍스트를 출력 파일에 씁니다.
DisplayAsOutlook - From 헤더를 표시합니다.
RenderTaskFields - 특정 작업 필드를 출력 파일에 씁니다.
없음 - 설정이 지정되지 않음.

다음 코드 스니펫은 선택적 설정을 사용하여 EML 파일을 MHTML로 변환하는 방법을 보여줍니다.

MHTML로 변환하면서 캘린더 이벤트 렌더링

다음은 MhtFormatOptions.RenderCalendarEvent 캘린더 이벤트를 출력 MHTML에 렌더링합니다. 다음 코드 스니펫은 MHTML로 변환하면서 캘린더 이벤트를 렌더링하는 방법을 보여줍니다.

인라인 이미지 없이 이메일을 MHT로 내보내기

맞춤형 시간대로 이메일을 MHT로 내보내기

MailMessage class는 다음을 제공합니다 setTimeZoneOffset MHT로 내보낼 때 사용자 지정 시간대를 설정하는 속성입니다. 다음 코드 스니펫은 사용자 지정 시간대로 이메일을 MHT로 내보내는 방법을 보여줍니다.

MailMessage msg = MailMessage.load(filename, new MsgLoadOptions());
msg.setDate(new Date());

// Set the timezone offset in milliseconds
msg.setTimeZoneOffset(5*60*60*1000);

MhtSaveOptions mhtOptions = new MhtSaveOptions();
mhtOptions.setMhtFormatOptions(MhtFormatOptions.WriteHeader);
msg.save(dataDir + "ExportToMHTWithCustomTimezone_out.mhtml", mhtOptions);

이메일을 EML로 내보내기

다음 코드 스니펫은 이메일을 EML로 내보내는 방법을 보여줍니다.

이메일을 HTML로 저장

다음은 HtmlSaveOptions 클래스는 메시지 본문을 HTML로 내보내는 기능을 제공합니다. 다음 코드 스니펫은 메시지를 HTML로 저장하는 방법을 보여줍니다.

리소스에 상대 경로를 사용하여 이메일 메시지를 HTML로 저장

이메일 메시지를 HTML 형식으로 내보낼 때 이메일 리소스를 상대 경로로 저장하도록 선택할 수 있습니다. 이 기능은 출력 HTML 파일에서 리소스가 연결되는 방식을 보다 유연하게 하여 다양한 시스템에서 저장된 이메일을 공유하고 표시하기 쉽게 합니다. HtmlSaveOptions.UseRelativePathToResources 이 속성은 리소스를 상대 경로로 저장할 수 있는 기능을 제공합니다. 기본값은 false이며(리소스가 절대 경로로 저장됨), true 로 설정하면 리소스가 상대 경로로 저장됩니다. 상대 경로를 가진 HTML 파일은 더 포터블하며 호스팅 환경의 파일 구조에 관계없이 올바르게 표시됩니다. 요구 사항에 따라 절대 경로나 상대 경로 중 선택할 수 있습니다. 리소스에 대한 사용자 정의 경로는 다음을 사용하여 정의할 수 있습니다. ResourceHtmlRenderingHandler 이벤트.

리소스를 기본 상대 경로로 저장

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(true);

msg.save("target.html", htmlSaveOptions);

이 경우, 리소스는 [html 파일 이름].files 폴더에 .html 파일과 동일한 경로에 저장되며 HTML은 상대 경로를 통해 리소스를 참조합니다.

리소스에 절대 경로로 저장

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(false);

msg.save("target.html", htmlSaveOptions);

첫 번째 경우와 같이, 리소스는 기본적으로 [html 파일 이름].files 폴더에 저장되지만 HTML은 절대 경로를 사용하여 리소스를 참조합니다.

ResourceHtmlRenderingHandler 이벤트를 사용한 사용자 정의 상대 경로

MapiMessage msg = MapiMessage.load(sourceFileName);

HtmlSaveOptions htmlSaveOptions = new HtmlSaveOptions();
htmlSaveOptions.setResourceRenderingMode(ResourceRenderingMode.SaveToFile);
htmlSaveOptions.setUseRelativePathToResources(false);

htmlSaveOptions.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {
    @Override
    public void invoke(Object sender, ResourceHtmlRenderingEventArgs args) {
        if (sender instanceof AttachmentBase) {
            AttachmentBase attachment = (AttachmentBase) sender;
            // Since UseRelativePathToResources = true, you should assign a relative path to the PathToResourceFile property.
            args.setPathToResourceFile("images\\" + attachment.getContentType().getName());
        }
    }
});

msg.save(targetPath + "A Day in the Park.html", htmlSaveOptions);

사용하여 ResourceHtmlRenderingHandler 이벤트를 사용하면 리소스에 대해 사용자 정의 상대 경로나 절대 경로를 설정할 수 있습니다. 경로를 사용자 정의할 때 ResourceHtmlRenderingHandler 이벤트 핸들러이며, 그리고 UseRelativePathToResources true 로 설정되면, 상대 경로를 지정해야 합니다. PathToResourceFile 정확한 참조를 보장하기 위한 속성입니다.

HTML로 변환하는 동안 메시지의 맞춤 아이콘 보존

때때로 메시지에 인라인 첨부 파일이 포함되어 있으며, 이는 메시지 본문에 아이콘 이미지로 표시됩니다. 이러한 메시지를 HTML로 변환할 때 아이콘 이미지가 손실되어 문제가 발생할 수 있습니다. 이는 첨부 파일의 아이콘이 메시지에 직접 포함되지 않기 때문입니다.

Aspose.Email 사용자는 메시지를 HTML로 변환할 때 첨부 파일 아이콘을 사용자 정의할 수 있습니다. 이를 위해서는 HtmlSaveOptions.ResourceHtmlRendering 이벤트는 이메일 메시지를 HTML 파일로 저장할 때 리소스 파일(예: 첨부 파일)의 렌더링을 사용자 정의하는 데 사용됩니다. 아래 코드 샘플에서 이벤트 핸들러는 첨부 파일의 콘텐츠 유형에 따라 리소스 파일(아이콘)의 경로를 동적으로 설정하는 데 사용됩니다. 이를 통해 파일 유형에 따라 HTML 출력에서 리소스를 맞춤 렌더링할 수 있습니다.


 HtmlSaveOptions options = new HtmlSaveOptions();

options.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {

   @Override

   public void invoke(Object sender, ResourceHtmlRenderingEventArgs e) {

        AttachmentBase attachment = (AttachmentBase) sender;

        e.setCaption(attachment.getContentType().getName());

       if (attachment.getContentType().getName().endsWith(".pdf")) {

            e.setPathToResourceFile("pdf_icon.png");

       } else if (attachment.getContentType().getName().endsWith(".docx")) {

            e.setPathToResourceFile("word_icon.jpg");

       } else if (attachment.getContentType().getName().endsWith(".jpg")) {

            e.setPathToResourceFile("jpeg_icon.png");

       } else {

            e.setPathToResourceFile("not_found_icon.png");

       }

   }

});

options.setResourceRenderingMode(ResourceRenderingMode.SubstituteFromFile);

String fileName = "message.msg";

MailMessage mailMessage = MailMessage.load(fileName);

mailMessage.save("fileName.html", options);

EML을 HTML로 저장할 때 시간 및 시간대 설정

Aspose.Email 사용자는 시간 및 시간대 표시 형식을 설정할 수 있습니다. HtmlSaveOptions. The HeadersFormattingOptions 클래스는 MailMessage를 Mhtml 또는 Html 형식으로 저장할 때 헤더 서식 옵션을 지정할 수 있습니다. 다음 메서드들은 HtmlFormatOptions 클래스는 출력 파일에 표시될 필드를 지정합니다:

RenderCalendarEvent - 캘린더 이벤트의 텍스트가 출력 mhtml에 기록되어야 함을 나타냅니다.
RenderVCardInfo - VCard AlternativeView의 텍스트가 출력 HTML에 기록되어야 함을 나타냅니다.

다음 코드 샘플은 EML을 HTML로 저장할 때 시간 및 시간대를 설정하는 방법을 보여줍니다:

MailMessage msg = MailMessage.load("fileName");
HtmlSaveOptions options = new HtmlSaveOptions();
options.setHtmlFormatOptions(HtmlFormatOptions.WriteHeader);
options.getFormatTemplates().set_Item("DateTime", "MM d yyyy HH:mm tt");

리소스를 포함하지 않고 HTML로 저장

메시지를 Outlook 템플릿(.oft) 파일로 저장

다음 코드 스니펫은 메시지를 Outlook 템플릿(.oft) 파일로 저장하는 방법을 보여줍니다.

Java: 유틸리티 기능 - MailMessage

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

메시지 암호화 및 복호화

Aspose.Email는 이메일 메시지를 암호화 및 복호화하는 기능을 제공합니다. 이 항목에서는 기존 또는 새로운 메시지를 로드하고 다음을 사용하여 암호화하는 방법을 보여줍니다. MailMessage. The encrypt() 및 decrypt() 메서드는 적용된 효과에 대해 MailMessage 객체를 반환하며, 메시지를 암호화/복호화할 때 주의해야 합니다. 메시지 암호화 및 복호화는 다음 단계로 이루어집니다:

새 메시지를 만들거나 기존 메시지를 로드합니다
인증서 파일을 사용하여 메시지를 암호화합니다
메시지를 전송하거나 저장합니다
필요에 따라 메시지를 복호화합니다

다음 코드 스니펫은 메시지를 암호화 및 복호화하는 방법을 보여줍니다.

메시지 암호화 여부 확인

Aspose.Email MailMessage 클래스를 사용하면 메시지가 암호화되었는지 여부를 확인할 수 있습니다. isEncrypted MailMessage의 속성을 사용하면 아래 코드 샘플과 같이 이를 확인할 수 있습니다.

X509Certificate를 사용한 메시지 암호화

Aspose.Email는 X509Certificate를 사용한 암호화된 메시지를 다루는 API를 제공합니다:

MailMessage 클래스에는 메시지 암호화를 위해 다음 메서드가 있습니다:

public MailMessage attachSignature(X509Certificate2 certificate, boolean detached) - 서명된 메시지를 생성합니다.
public MailMessage attachSignature(X509Certificate2 certificate) - 서명된 메시지를 생성합니다.
public X509Certificate2[] checkSignatureCert() - 기존 MailMessage의 서명을 확인합니다.
public MailMessage decrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2 certificate)
public MailMessage encrypt(X509Certificate2[] certificates)

Aspose.Email용 로케일 옵션 구성

다음과 같이 사용할 수 있습니다 LocaleOptions 인식되지 않은 기본 로케일인 경우 Aspose Email 라이브러리에 가장 적합한 로케일을 설정하는 클래스입니다. 작업을 수행하기 위해 다음 메서드를 제공합니다:

getLocale() - Aspose.Email의 기본 로케일을 반환합니다.
setLocale(Locale locale) 및 setLocale(String localeName) - Aspose.Email에 대한 기본 로케일을 설정합니다.
clear() - Aspose.Email의 기본 로케일을 초기화합니다. Java의 기본 로케일로 사용됩니다.

다음 코드 샘플은 지정된 로케일 설정을 사용하여 파일에서 메일 메시지를 로드하는 방법을 보여줍니다:

final Locale locale = new Locale("en", "DE");
Locale.setDefault(locale);

// set Locale for Aspose Email lib
LocaleOptions.setLocale("en-US");
// or
//LocaleOptions.setLocale(new Locale("en", "US"));

MailMessage.load("document.msg");

이 코드는 애플리케이션과 Aspose.Email 라이브러리가 언어, 국가 및 문화 규약을 처리하기 위해 지정된 로케일을 사용하도록 보장합니다.

TNEF 첨부 파일이 포함된 MailMessage

Transport Neutral Encapsulation Format(TNEF)은 Microsoft Outlook 및 Microsoft Exchange Server에서 사용하는 독점 이메일 첨부 형식입니다. Aspose.Email API를 사용하면 TNEF 첨부 파일이 있는 이메일 메시지를 읽고 내용을 수정할 수 있습니다. 그런 이메일을 일반 이메일이나 동일한 형식으로 저장하면서 TNEF 첨부 파일을 보존할 수 있습니다. 이 문서에서는 TNEF 첨부 파일이 포함된 메시지를 다루는 다양한 코드 샘플을 보여줍니다.

TNEF 첨부 파일을 보존하며 메시지 읽기

다음 코드 스니펫은 TNEF 첨부 파일을 보존하면서 메시지를 읽는 방법을 보여줍니다.

TNEF 첨부 파일의 리소스 업데이트 및 TNEF 형식 보존

다음 코드 스니펫은 TNEF 첨부 파일의 리소스를 업데이트하고 TNEF 형식을 보존하는 방법을 보여줍니다.

TNEF가 포함된 메인 메시지에 새 첨부 파일 추가

MSG에서 TNEF EML 만들기

Outlook MSG 파일에는 테이블 및 텍스트 스타일과 같은 정보가 포함되어 있어 EML로 변환하면 손상될 수 있습니다. 이러한 MSG 파일에서 TNEF 메시지를 생성하면 서식을 유지하고 이메일 클라이언트를 통해 서식을 유지한 채로 메시지를 보낼 수 있습니다.

TNEF를 생성하려면 다음 샘플 코드를 사용할 수 있습니다.

메시지가 TNEF인지 감지

바운스 메시지 처리

받는 사람에게 보낸 메시지가 잘못된 주소와 같은 이유로 반송되는 경우는 매우 일반적입니다. Aspose.Email API는 이러한 메시지를 처리하여 반송된 이메일인지 일반 이메일인지 확인할 수 있는 기능을 제공합니다. The 바운스 확인 메서드 MailMessage 클래스는 이메일 메시지가 반송 메일인 경우 유효한 결과를 반환합니다.

이 문서는 사용법을 보여줍니다. BounceResult 클래스는 메시지가 반송 메일인지 확인하는 기능을 제공하며, 수신자, 수행된 조치 및 알림 이유에 대한 자세한 정보를 제공합니다.

예외 무시

이 라이브러리는 다음을 제공합니다 ExceptionManager 응용 프로그램 기능에 예외 무시 기능을 구현하기 위한 클래스입니다. 아래 코드 스니펫은 예외를 처리하기 위한 콜백 설정 방법을 보여줍니다:

 ExceptionManager.setIgnoreExceptionsHandler( new IgnoreExceptionsCallback() {

   //exception path: {Module}\{Method}\{Action}\{GUID}

   //example: MailMessage\Load\DecodeTnefAttachment\64149867-679e-4645-9af0-d46566cae598

   public boolean invoke(AsposeException ex, String path) {

       //Ignore all exceptions on MailMessage.Load

       return path.equals("MailMessage\\Load");

   }

});

또는 대안을 사용하십시오:

 ExceptionManager.setIgnoreAll(true);

또한, 무시된 예외 로그에 대한 콜백을 설정할 수 있습니다:

ExceptionManager.setIgnoreExceptionsLogHandler( new IgnoreExceptionsLogCallback() {

   public void invoke(String message) {

        System.out.println("=== EXCEPTION IGNORED === " + message);

   }

});

사용자에게 예외를 무시해도 된다는 오류 메시지가 표시됩니다. 예시:

메시지의 예외:

AsposeArgumentException: properties should not be empty.

예외를 무시하고 계속 진행하려면 다음을 사용할 수 있습니다:

ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")

Invalid TNEF Attachment will be interpreted as regular attachment.

베이즈 스팸 분석기

Aspose.Email는 베이즈 스팸 분석기를 사용한 이메일 필터링 기능을 제공합니다. It provides the SpamAnalyzer 이 목적을 위한 클래스입니다. 이 문서는 단어 데이터베이스를 기반으로 스팸과 일반 이메일을 구분하도록 필터를 학습시키는 방법을 보여줍니다.

EML 메시지에서 프리앰블 및 에필로그 가져오기

MIME 형식에서 프리앰블은 헤더 뒤와 첫 번째 멀티파트 경계 앞에 나타나는 텍스트입니다. 에필로그는 마지막 경계 뒤와 메시지 끝 사이에 나타나는 텍스트입니다. 이 텍스트는 일반적으로 메일 클라이언트에서 보이지 않지만, 일부 MIME 구현에서는 MIME를 지원하지 않는 프로그램으로 메시지를 읽는 수신자에게 메모를 삽입하기 위해 사용할 수 있습니다.

다음 코드 스니펫은 해당 메서드를 사용하여 EML 메시지에서 프리앰블과 에필로그를 얻는 방법을 보여줍니다. MailMessage 클래스:

setPreamble(String value) - 프리앰블 텍스트를 가져오거나 설정합니다.
setEpilogue(String value) - 에필로그 텍스트를 가져오거나 설정합니다.

// Gets or sets a preamble text.
public String getPreamble, setPreamble

// Gets or sets an epilogue text.
public String getEpilogue, setEpilogue

Java: 문서 변환 진행 상황 추적

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

문서 변환 진행 상황 추적

Aspose.Email는 문서 변환 진행 상황을 추적하는 기능을 제공합니다. 이를 위해 API는 SaveOptions.CustomProgressHandler. 진행 이벤트를 처리하는 메서드를 나타냅니다. 진행 이벤트 유형은 다음에 의해 표현됩니다. ProgressEventType 열거형. ProgressEventType 열거형은 다음 멤버를 포함합니다.

MimeStructureCreated: 이 이벤트는 MIME 구조가 생성되었음을 알립니다.
MimePartSaved: 이 이벤트는 하나의 MIME 파트 저장이 완료되었음을 알립니다.
SavedToStream: 이 이벤트는 모든 MIME 파트가 스트림에 저장되었음을 알립니다.

다음 샘플 코드는 SaveOptions.CustomProgressHandler 및 ProgressEventType 열거형을 사용하여 문서 변환 진행 상황을 추적하는 방법을 보여줍니다.

아래는 위의 코드 샘플에서 사용된 사용자 정의 클래스의 코드입니다.

Java: 사용자 정의 스타일로 하이퍼링크 렌더링

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

응용 프로그램 요구 사항에 따라 특정 스타일로 하이퍼링크를 출력해야 할 경우가 있을 수 있습니다. 이를 위해 Aspose.Email는 HyperlinkRenderingCallback. HyperlinkRenderingCallback을 매개변수로 전달할 수 있습니다. MailMessage.GetHtmlBodyText.

다음 코드 스니펫은 HyperlinkRenderingCallback을 사용하여 사용자의 커스텀 스타일로 하이퍼링크를 출력하는 방법을 보여줍니다.

RenderHyperlinkWithHref 및 RenderHyperlinkWithoutHref 메서드는 하이퍼링크 렌더링을 시연하기 위한 것이며 실제 사용을 위한 것이 아닙니다.

Java: MHTML 파일에서 정보를 사용자 지정 순서대로 표시

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

Aspose.Email은 MhtSaveOptions.RenderingHeaders 렌더링을 위한 헤더 목록을 반환하는 속성입니다. 다음을 사용하여 헤더를 추가할 수 있습니다 MhtTemplateName 클래스. 헤더가 추가된 순서가 정보가 표시되는 순서를 결정합니다.

다음 이미지는 샘플 코드가 생성한 세 가지 출력물을 비교합니다.

다음 코드 스니펫은 사용법을 보여줍니다 MhtSaveOptions.RenderingHeaders 출력 MHTML 파일에 표시되는 정보 순서를 설정하는 속성입니다.