Documentation – 기술 기사

Java: Inline 첨부 파일과 일반 첨부 파일 구분

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

이메일 메시지는 inline 이미지와 첨부 파일을 모두 포함할 수 있습니다. 사용하여 MailMessage, inline 첨부 파일은 다음에서 추출할 수 있습니다 LinkedResourceCollection 컬렉션에서 정규 첨부 파일은 메시지의 AttachmentCollection 컬렉션에 있습니다. 그러나 메시지를 다음을 사용하여 로드할 경우 상황이 다릅니다 MapiMessage, 모든 inline 이미지와 일반 첨부 파일이 동일한 MapiAttachmentCollection따라서 inline과 일반 첨부 파일을 구분할 수 있는 메서드가 필요합니다 MapiMessage 필요할 때 사용됩니다.

이 문서는 inline 첨부 파일과 일반 첨부 파일을 구분하는 방법을 설명합니다 MapiMessage. 결정 시, 본문의 타입은 MapiMessage 다음과 같이 고려됩니다:

Plain text 본문: 일반 텍스트 본문 타입의 이메일 메시지는 별도로 확인할 필요가 없습니다. 이러한 메시지의 모든 첨부 파일은 항상 일반 첨부 파일이기 때문입니다.
HTML 본문: HTML 본문이 있는 메시지의 경우, 첨부 파일은 PR_ATTACH_FLAGS (0x37140003) 속성을 포함해야 할 뿐만 아니라, inline 첨부 파일인 경우 해당 값이 0x00000004이어야 합니다. 이 조건이 충족되면 PR_ATTACH_CONTENT_LOCATION 및 PR_ATTACH_CONTENT_ID 태그를 추가로 확인하여 첨부 파일의 성격을 판단합니다. 그러나 PR_ATTACH_FLAGS MAPI 태그가 없는 경우, 첨부 파일은 PR_ATTACH_DISPOSITION (0x3716001F 또는 0x3716001E) 속성을 확인하여 첨부 파일 유형을 결정합니다.
RTF 본문: 본문이 RTF인 경우 모든 OLE 첨부 파일은 inline 첨부 파일입니다. 모든 OLE 첨부 파일의 PR_ATTACH_METHOD 값은 0x00000006과 같습니다.

다음 코드 샘플은 inline 첨부 파일과 일반 첨부 파일을 프로그램matically 구분하는 방법을 보여줍니다. isInlineAttachment 함수는 첨부 파일과 MapiMessage를 입력 매개변수로 받아들이며, 첨부 파일이 inline인 경우 true를 반환합니다.

public static boolean isInlineAttachment(MapiAttachment att, MapiMessage msg) {
    if (msg.getBodyType() == BodyContentType.PlainText)
        // ignore indications for plain text messages
        return false;
    else if (msg.getBodyType() == BodyContentType.Html) {
        // check the PidTagAttachFlags property
        Long attachFlagsValue = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_FLAGS);
        if (attachFlagsValue != null && (attachFlagsValue > 3 || attachFlagsValue < 1)) {
            // check PidTagAttachContentId property
            String contentId = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID_W);
            if (contentId != null && !contentId.isEmpty() && msg.getBodyHtml().contains("cid:" + contentId)) {
                return true;
            }
            // check PidTagAttachContentLocation property
            String contentLocation = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION_W);
            if (contentLocation != null && !contentLocation.isEmpty() && msg.getBodyHtml().contains(contentLocation)) {
                return true;
            }
        }
        return "inline".equals(att.getPropertyString(0x3716001F)) || "inline".equals(att.getPropertyString(0x3716001E));
    } else if (msg.getBodyType() == BodyContentType.Rtf) {
        // If the body is RTF, then all OLE attachments are inline attachments.
        // OLE attachments have 0x00000006 for the value of the PidTagAttachMethod property
        Long attachMethod = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_METHOD);
        return attachMethod != null && attachMethod == 0x00000006;
    } else {
        throw new ArgumentOutOfRangeException();
    }
}

이 코드 조각은 isInlineAttachment() 함수를 사용해 첨부 파일을 평가합니다.

Java

String fileName = ("Sample.msg");
MapiMessage message = MapiMessage.fromFile(fileName);
MapiAttachmentCollection attachments = message.getAttachments();
for (int i = 0; i < attachments.size(); i++) {
    MapiAttachment attachment = (MapiAttachment) attachments.get(i);
    if (isInlineAttachment(attachment, message)) {
        System.out.println(attachment.getLongFileName() + " is inline attachment");
    } else {
        System.out.println(attachment.getLongFileName() + " is regular attachment");
    }
}

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

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

RTF 형식 본문을 가진 이메일 메시지는 전체 객체로 내장되었거나 아이콘으로 내장된 inline 첨부 파일을 포함할 수 있습니다. 이 두 종류의 첨부 파일을 구분하려면 먼저 첨부 파일의 특정 속성을 조사해야 합니다. 첨부 파일 속성을 기반으로 특정 기준을 충족한 후, ObjectData에서 추출하여 첨부 파일을 저장할 수 있습니다.

이 문서는 RTF 형식 MSG 파일에서 내장된 첨부 파일을 식별하고 추출합니다.

Java


   static void ExtractInlineAttachments()

  {

        MapiMessage message = MapiMessage.fromFile("Test.msg");

    MapiAttachmentCollection attachments = message.getAttachments();

    for (Object untypedAttachment : attachments)

    {

          MapiAttachment attachment = (MapiAttachment) untypedAttachment;

          if(IsAttachmentInline(attachment))

          {

                try

                {

                      SaveAttachment(attachment, UUID.randomUUID().toString());

                }

                catch (IOException | FileNotFoundException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

  static boolean IsAttachmentInline(MapiAttachment attachment)

  {

        MapiObjectProperty objectData = attachment.getObjectData();

        if (objectData == null)

              return false;

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              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, FileNotFoundException

  {

        for (Object prop : attachment.getObjectData().getProperties().getValues())

        {

              MapiProperty property = (MapiProperty)prop;

              if ("Package".equals(property.getName()))

          {

                FileOutputStream fs;

                try

                {

                      fs = new FileOutputStream(fileName);

                      fs.write(property.getData(), 0, property.getData().length);

                }

                catch (java.io.IOException e)

                {

                      // TODO Auto-generated catch block

                          e.printStackTrace();

                    }

              }

        }

  }

Java: MSG 파일을 PDF로 저장

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

이 기사에서는 Aspose.Email을 사용하여 이메일 메시지를 PDF로 변환하는 방법을 보여줍니다. Java용 Aspose.Email은 Microsoft Outlook 기능을 다루지만 PDF로 직접 변환은 지원하지 않습니다. 이를 해결하기 위해 이 기사에서는 샘플을 통해 Aspose.Email으로 이메일 메시지를 MHTML 스트림으로 변환한 다음, Java용 Aspose.Words를 사용해 해당 MHTML 스트림을 로드하고 PDF로 저장합니다.

이메일 메시지는 첨부 파일을 포함할 수도 있습니다. 첨부 파일마다 미디어 유형이 다를 수 있기 때문에 Aspose.Email은 MHTML로 변환할 때 이러한 첨부 파일을 무시합니다. 즉, 메시지의 인라인 이미지만 MHTML에 포함되고 일반 첨부 파일은 무시됩니다.

이메일 메시지를 PDF로 변환

다음 코드는 Aspose.Email과 Java용 Aspose.Words를 결합하여 이메일 메시지를 PDF로 변환하는 방법을 보여줍니다. 다음 단계가 포함됩니다:

MailMessage를 사용해 이메일 메시지 로드
이메일 메시지를 MemoryStream에 MHTML로 저장
Aspose.Words를 사용해 스트림 로드
메시지를 PDF로 저장

원본 이메일 메시지는 다음과 같이 볼 수 있습니다:

|| | :- | |그림: 원본 MSG 파일 |

|| | :- | |그림: 변환된 PDF 파일 | Java


 static void EmailToPdf(String emailPath) throws Exception

{

       FileInputStream fstream=new FileInputStream(emailPath);

       MailMessage eml = MailMessage.load(fstream);

       //Save the Message to output stream in MHTML format

       ByteArrayOutputStream emlStream = new ByteArrayOutputStream();

       eml.save(emlStream, SaveOptions.getDefaultMhtml());

       //Load the stream in Word document

       LoadOptions lo = new LoadOptions();

       lo.setLoadFormat(LoadFormat.MHTML);

       Document doc = new Document(new ByteArrayInputStream(emlStream.toByteArray()), lo);

       //Save to disc

       doc.save("About Aspose.Pdf", SaveFormat.PDF);

       //or Save to stream

       ByteArrayOutputStream foStream = new ByteArrayOutputStream();

       doc.save(foStream, SaveFormat.PDF);

}

Java: 연결 풀 리팩터링

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

Aspose.Email 19.3 릴리스와 함께 연결 풀이 리팩터링되었습니다. 새로운 EmailClient 클래스가 도입되어 결국 기존을 대체합니다 CredentialsByHostClient 클래스. EmailClient 클래스는 ConnectionAsgmtMode 멀티스레드 환경에서 연결 할당 모드를 정의하는 속성. EmailClient.ConnectionAsgmtMode 다음으로 설정됩니다: ConnectionAsgmtType 열거형.

연결 유형

다음 세 가지 연결 유형이 있습니다:

메인 연결: 메일 클라이언트와 함께 생성되고 해제되는 연결입니다. 수동으로 생성하거나 해제할 수 없습니다.
기본 연결: 사용자는 다음을 사용하여 스레드에 기본 연결을 생성할 수 있습니다 CreateConnection 메서드. 기본 연결이 존재하는 경우, 해당 스레드에서 실행되는 이메일 클라이언트의 모든 메서드는 암시적으로 이 연결을 사용합니다. 스레드당 하나의 기본 연결만 존재할 수 있습니다. 이는 수동 또는 자동으로 생성될 수 있으며 EmailClient.ConnectionAsgmtMode 속성에 따라 결정됩니다. 이러한 연결은 다음을 사용하여 수동으로 생성할 수 있습니다 EmailClient.CreateConnection(createAsDefaultConnection = true) 메서드. 기본 연결이 사용되지 않는 경우(연결 할당 모드에 따라), 메인 연결이 대신 암시적으로 사용됩니다.
독립 연결: 스레드에 연결되지 않은 연결입니다. 수동으로 생성할 수 있으며 메서드 매개변수로 명시적으로 사용해야 합니다. 이러한 연결은 다음을 사용하여 수동으로 생성할 수 있습니다 EmailClient.CreateConnection() 메서드 또는 EmailClient.CreateConnection(createAsDefaultConnection = false) 메서드.

연결 할당 유형

설정하려면 EmailClient.ConnectionAsgmtMode 속성, ConnectionAsgmtType 열거형이 사용됩니다. 다음이 제공하는 할당 유형 ConnectionAsgmtType 다음에 나열됩니다.

ConnectionAsgmtType.UseMainOrDefault 이 모드는 이메일 클라이언트에서 기본적으로 사용됩니다. 기본 연결이 생성되지 않았거나 메서드 매개변수로 명시적으로 전달된 연결이 없는 경우, 이메일 클라이언트는 여러 스레드의 모든 작업에 메인 연결을 사용합니다. 메인 연결은 이메일 클라이언트와 동시에 생성되는 연결입니다. 사용자는 다음을 사용하여 스레드에 기본 연결을 생성할 수 있습니다 CreateConnection 메서드. 스레드에 대한 기본 연결이 생성된 경우, 해당 스레드에서 호출되는 이메일 클라이언트의 모든 메서드에 암시적으로 사용됩니다. 스레드에 기본 연결이 생성되지 않은 경우, 메인 연결이 해당 스레드에서 호출되는 이메일 클라이언트의 모든 메서드에 사용됩니다. 사용자는 또한 스레드에 연결되지 않은 (기본 연결이 아닌) 연결을 다음을 사용하여 생성할 수 있습니다 CreateConnection 메서드. 사용자가 메인 및 기본 연결이 아닌 다른 연결을 사용하려면 해당 연결을 사용하려는 메서드의 매개변수로 명시적으로 전달해야 합니다. 사용자는 추가로 원하는 만큼의 연결을 생성할 수 있습니다. 기본 연결은 스레드당 하나만 가능합니다. 기본 연결은 사용자가 멀티태스킹 프로그래밍에 Thread 객체를 사용할 경우 정상적으로 작동합니다. 사용자가 ConnectionPool을 사용하거나 Task 객체를 사용하여 멀티태스킹 프로그래밍을 할 경우, 이 모드가 애플리케이션의 잘못된 동작을 초래할 수 있습니다. 이 문제를 방지하려면 사용자는 코드 실행이 끝난 후 기본 연결을 (사용했다면) 수동으로 해제해야 합니다.
ConnectionAsgmtType.UseMain 이메일 클라이언트는 여러 스레드의 모든 작업에 메인 연결을 사용합니다. 메인 연결은 이메일 클라이언트와 동시에 생성되는 연결입니다. 사용자는 기본 연결을 생성할 수 없습니다. 사용자는 다음을 사용하여 스레드에 연결되지 않은 (기본 연결이 아닌) 연결을 생성할 수 있습니다 CreateConnection 메서드. 사용자가 메인 및 기본 연결이 아닌 다른 연결을 사용하려면 해당 연결을 사용하려는 메서드의 매개변수로 명시적으로 전달해야 합니다.
ConnectionAsgmtType.UseDefault 이메일 클라이언트는 여러 스레드에서 수행되는 모든 작업에 기본 연결만을 암시적으로 사용합니다. 이 모드에서는 메인 연결이 사용되지 않습니다. 특정 스레드에 대해 기본 연결이 생성되지 않은 경우(이메일 클라이언트 메서드 최초 호출), 이메일 클라이언트는 첫 번째 작업이 실행되기 전에 해당 스레드에 기본 연결을 암시적으로 생성합니다. 사용자는 다음을 사용하여 스레드에 기본 연결을 생성할 수 없습니다 CreateConnection메서드는 자동으로 생성되기 때문입니다. 스레드에 대한 기본 연결이 생성되면 해당 스레드에서 호출되는 이메일 클라이언트의 모든 메서드에 암시적으로 사용됩니다. 사용자는 또한 스레드에 연결되지 않은 (기본 연결이 아닌) 연결을 다음을 사용하여 생성할 수 있습니다 CreateConnection메서드. 사용자가 기본 및 메인 연결이 아닌 다른 연결을 사용하려면 해당 연결을 사용하려는 메서드의 매개변수로 명시적으로 전달해야 합니다. 사용자는 추가로 원하는 만큼의 연결을 생성할 수 있습니다. 스레드당 기본 연결은 하나만 사용할 수 있습니다. 기본 연결은 사용자가 멀티태스킹 프로그래밍에 Thread 객체를 사용할 경우 정상적으로 작동합니다. 사용자가 ConnectionPool을 사용하거나 Task 객체를 사용하여 멀티태스킹 프로그래밍을 할 경우, 이 모드가 애플리케이션의 잘못된 동작을 초래할 수 있습니다. 이 문제를 피하려면 사용자는 코드 실행이 끝난 후 기본 연결을 수동으로 해제해야 합니다.

Java: 현재 스레드에 대한 Locale 설정 지원

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

Aspose.Email은 현재 스레드의 Locale을 설정하는 기능을 제공합니다. Aspose.Email은 클래스를 제공합니다 CurrentThreadSettings 이를 제공하는 setLocale 이 목적을 위한 메서드. 다음 코드 스니펫은 사용을 보여줍니다. CurrentThreadSettings 현재 Locale을 설정하는 클래스. 샘플은 먼저 Locale을 잘못된 값으로 설정한 다음 사용합니다. CurrentThreadSettings.setLocale 현재 스레드의 Locale을 설정하는 메서드.

Locale defaultLocale = Locale.getDefault();
try {
    // set incorrect default Locale
    Locale.setDefault(new Locale("en", "RU"));
    // set Current Thread Locale
    CurrentThreadSettings.setLocale("en-US");
    // or
    // CurrentThreadSettings.setLocale(new Locale("en", "US"));

    PersonalStorage.create(dataDir + "test.pst", FileFormatVersion.Unicode);
} finally {
    Locale.setDefault(defaultLocale);
}

Java: 중요한 iCalendar RFC 2445 세부 사항

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

Aspose iCalendar 객체 모델에 대하여

Aspose.Email은 Aspose에서 제공하는 모든 클래스를 포함합니다 iCalendar component RecurrencePattern 및 RecurrenceRule 는 Aspose의 핵심 클래스입니다 iCalendar, 그리고 해당 RFC 2445 요소들의 구체적인 구현을 제공합니다.

다음은 RecurrencePattern 클래스는 전체 반복 패턴을 나타냅니다. 기본 생성자를 사용하여 새 반복 패턴을 처음부터 만들거나 기존 패턴을 로드할 수 있습니다 CalendarRecurrence. The RecurrenceRule 클래스는 반복 패턴의 RRULE 또는 EXRULE 부분을 나타냅니다. RecurrenceRule iCalendar 표준의 대응 항목에 직접 매핑되는 여러 속성을 노출합니다. 예를 들어, ByMonth는 iCalendar의 BYMONTH에 매핑됩니다. 이러한 속성들의 값을 조사하거나 설정함으로써 RecurrenceRule 반복 규칙을 분석하거나 수정할 수 있는 속성들입니다. 자세한 정보와 코드 샘플은 다음을 참조하십시오 RecurrencePattern 및 RecurrenceRule API 참조에 있습니다.

중요한 iCalendar RFC 2445 세부 사항

이 섹션에는 다음 주제가 포함됩니다:

날짜 및 시간 형식.
DATE.
로컬 시간이 포함된 DATE-TIME.
UTC 시간이 포함된 DATE-TIME.
시간대와 로컬 시간이 포함된 DATE-TIME.
BYWEEKNO는 ISO 8601 준수를 제공합니다

날짜 및 시간 형식

날짜 또는 시간과 연관된 날짜는 반복 패턴을 지정할 때 DTSTART, UNTIL, EXDATE 및 RDATE 요소에서 사용할 수 있습니다. iCalendar는 캘린더 날짜를 식별하는 DATE 값 유형을 정의하고, 정확한 캘린더 날짜와 시간대를 지정하는 DATE-TIME 유형을 정의합니다. DATE-TIME 값은 다음 세 가지 형태로 지정될 수 있습니다:

로컬 시간.
UTC 시간.
로컬 시간 및 시간대.

DATE

iCalendar 표준에 따르면 DATE 값은 yyyyMMdd 형식을 따라야 합니다. 다음 예는 1997년 7월 14일을 나타냅니다: 19970714

로컬 시간이 포함된 DATE-TIME

로컬 시간 형태의 날짜는 UTC 지정자가 포함되지 않은 날짜-시간 값이며, 시간대를 참조하지 않습니다. 예를 들어, 다음은 1998년 1월 18일 오후 11시를 나타냅니다: DTSTART:19980118T230000. 이 유형의 날짜-시간 값은 "플로팅"이라고 하며 특정 시간대에 고정되지 않습니다. 현재 관찰 중인 시간대와 상관없이 동일한 시, 분, 초 값을 나타내는 데 사용됩니다.

UTC 시간이 포함된 DATE-TIME

UTC 시간(절대 시간)이 포함된 날짜는 라틴 대문자 Z 접미사(UTC 지정자)를 시간 값에 추가하여 식별합니다. 예를 들어, 다음은 1998년 1월 19일 07:00 UTC를 나타냅니다: DTSTART:19980119T070000Z. Aspose에 유의하십시오 iCalendar UTC 형식의 Z 접미사를 무시하고 시간을 로컬 시간으로 처리합니다. RFC2445 표준에 따르면 반복 패턴의 UNTIL 규칙에 지정된 시간 부분은 UTC 형식이어야 합니다. 이는 매우 이상한 진술이며, 실제로 표준에는 잘못 계산된 예제가 있습니다. Aspose iCalendar UNTIL 규칙에서 모든 형식의 시간을 허용합니다.

로컬 시간 및 시간대가 포함된 DATE-TIME

시간대를 참조하려면 DATE-TIME에 TZID 속성을 수정합니다. 예를 들어, 다음은 1998년 1월 19일 뉴욕 시간으로 오전 2시를 나타냅니다: DTSTART;TZID=US-Eastern:19980119T020000. Aspose에 유의하십시오 iCalendar 현재 TZID 매개변수를 무시하고 시간을 로컬 시간으로 처리합니다.

BYWEEKNO는 ISO 8601 준수를 제공합니다

BYWEEKNO는 다음과의 호환성이 필요할 때만 사용하십시오 ISO 8601 필요합니다. ISO 8601에서 정의된 주 번호는 일반적인 의미의 주 번호와 매우 다릅니다. ISO 8601에 따르면, 연도 첫 번째 주는 최소 네 일 이상을 포함하는 연도의 첫 번째 주입니다. 이 규칙은 ISO 8601 준수를 요구하는 애플리케이션에 특정 알고리즘을 적용하게 하며, 다른 용도에는 거의 적용할 수 없습니다. ISO 8601은 일부 유럽 은행 및 금융 애플리케이션에서 지원됩니다. 또한 텔레비전에서 광고 예약에 사용됩니다. BYWEEKNO 규칙은 연도의 주를 식별하는 숫자의 콤마 구분 목록을 지정합니다. 유효 값은 1~53이며, 이는 ISO 8601에 정의된 주 번호 체계에 해당합니다. BYWEEKNO는 YEARLY 규칙에만 유효합니다.

Java: Microsoft Outlook 메시지 파일 구문 분석

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

Aspose.Email을 사용하면 몇 줄의 코드만으로 Microsoft Outlook 메시지를 구문 분석할 수 있습니다. 이 기사에서는 그 방법을 보여줍니다. Aspose.Email에는 Outlook 메시지와 관련된 다양한 프로그래밍 작업을 수행할 클래스가 있습니다. 아래 코드 예시는 다음과 같은 작업을 수행하는 방법을 보여줍니다:

이메일 메시지를 로드합니다.
이메일 제목을 가져옵니다.
발신자 이름을 가져옵니다.
전체 메시지 본문을 가져옵니다.
첨부 파일이 있는지 확인합니다.
첨부 파일의 파일 이름을 가져와 저장합니다.

다음 코드 스니펫은 Microsoft Outlook 메시지 파일을 구문 분석하는 방법을 보여줍니다.

// The path to the File directory and Load Microsoft Outlook email message file
String dataDir = "data/";
MapiMessage msg = MapiMessage.fromFile(dataDir + "message3.msg");

// Obtain subject of the email message, sender, body and Attachment count
System.out.println("Subject:" + msg.getSubject());
System.out.println("From:" + msg.getSenderName());
System.out.println("Body:" + msg.getBody());
System.out.println("Attachment Count:" + msg.getAttachments().size());

// Iterate through the attachments
for (MapiAttachment attachment : msg.getAttachments()) {
    // Access the attachment's file name and Save attachment
    System.out.println("Attachment:" + attachment.getFileName());
    attachment.save(dataDir + attachment.getLongFileName());
}

Java: 성공적으로 전송된 메시지 및 전송 실패 메시지에 대한 알림 수신

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

성공적으로 전송된 메시지와 실패한 메시지 모두에 대한 배달 알림을 받으려면 파이프(|) 연산자를 사용합니다. DeliveryNotificationOptions 속성 MailMessage 클래스. 다음 코드 스니펫은 성공적으로 전송된 메시지와 전송 실패 메시지에 대한 알림을 받는 방법을 보여줍니다.

// Create the message
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@sender.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@receiver.com"));
msg.setSubject("the subject of the message");

// Set delivery notifications for success and failed messages and Add the MIME headers
msg.setDeliveryNotificationOptions(DeliveryNotificationOptions.OnSuccess | DeliveryNotificationOptions.OnFailure);
msg.getHeaders().add("Read-Receipt-To", "sender@sender.com");
msg.getHeaders().add("Disposition-Notification-To", "sender@sender.com");

// Send the message
SmtpClient client = new SmtpClient("host", "username", "password");
client.send(msg);

Java: POP3 서버에서 새 이메일 메시지 감지

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

POP3 계정에서는 다운로드 및 읽을 때 메시지를 서버에 남겨둘 수 있습니다. 서버에 이메일을 남겨두면 여러 장치에서 이메일에 액세스하는 사용자와 같은 다른 애플리케이션 및 개인이 해당 이메일을 사용할 수 있습니다. 또는 특정 조건(예: 특정 제목이 있는 메시지)에 맞는 메시지만 다운로드하려 할 수도 있습니다. 이메일을 관리하려면 다음을 수행할 수 있습니다;

Aspose.Email을 사용해 POP3 메일 서버에서 모든 메시지를 읽습니다.
메시지를 로컬 데이터베이스에 다운로드합니다.

메시지는 삭제되지 않고 서버에 남아 있습니다. 처음 실행할 때는 이 프로세스가 정상적으로 작동하여 필요한 모든 메시지가 데이터베이스에 다운로드됩니다. 그러나 두 번째 실행 시에도 동일한 메시지가 여전히 이메일 서버에 남아 있기 때문에 다시 다운로드되어 중복 레코드가 발생합니다. 이 문제를 해결하려면 다음을 사용하십시오. Pop3MessageInfo.UniqueID 이미 다운로드된 메시지인지 확인하는 속성. 메시지의 고유 ID는 데이터베이스에 저장되어야 하며, 이는 새 메시지를 감지하기 위한 검색 키입니다.

새 메시지 감지

POP3 서버의 이메일 목록에서 새 이메일을 식별하려면:

서버에 연결합니다.
이메일 목록을 가져옵니다.
데이터베이스에 연결합니다.
이메일 목록을 가져옵니다.
목록을 비교합니다.
새 이메일을 데이터베이스에 저장합니다.

다음과 같은 경우 프로세스가 더 빠릅니다:

메시지의 모든 고유 ID를 해시 테이블에 가져옵니다.
for(…) 루프에서 각 이메일 메시지에 대해 데이터베이스 대신 해시 테이블을 검색합니다.

각 메시지마다 데이터베이스를 조회하여 여러 번 호출하는 대신, 이 메서드는 한 번의 호출만 필요합니다. 다음 코드 스니펫은 POP3 서버에서 새 이메일 메시지를 감지하는 방법을 보여줍니다.

public static void run() {
    try {
        // Connect to the POP3 mail server and check messages.
        Pop3Client pop3Client = new Pop3Client("pop.domain.com", 993, "username", "password");

        // List all the messages
        Pop3MessageInfoCollection msgList = pop3Client.listMessages();
        for (Pop3MessageInfo msgInfo : msgList) {
            // Get the POP3 message's unique ID
            String strUniqueID = msgInfo.getUniqueId();

            // Search your local database or data store on the unique ID. If a match is found, that means it's already downloaded. Otherwise download and save it.
            if (searchPop3MsgInLocalDB(strUniqueID) == true) {
                // The message is already in the database. Nothing to do with this message. Go to next message.
            } else {
                // Save the message
                savePop3MsgInLocalDB(msgInfo);
            }
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }

}

private static void savePop3MsgInLocalDB(Pop3MessageInfo msgInfo) {
    // Open the database connection according to your database. Use public properties (for example msgInfo.Subject) and store in database,
    // for example, " INSERT INTO POP3Mails (UniqueID, Subject) VALUES ('" + msgInfo.UniqueID + "' , '" + msgInfo.Subject + "') and Run the query to store in database.
}

private static boolean searchPop3MsgInLocalDB(String strUniqueID) {
    // Open the database connection according to your database. Use strUniqueID in the search query to find existing records,
    // for example, " SELECT COUNT(*) FROM POP3Mails WHERE UniqueID = '" + strUniqueID + "' Run the query, return true if count == 1. Return false if count == 0.
    return false;
}

Java: 이메일 메시지의 기본 텍스트 인코딩 설정

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

이 기사에서는 다음을 소개합니다: MailMessage.PreferredTextEncoding 속성 및 사용 방법을 설명합니다. 이 속성을 사용하면 다음 속성들의 기본 텍스트 인코딩을 설정할 수 있습니다:

From: 표시 이름
To: 표시 이름
Subject
본문

기본 텍스트 인코딩 설정

이전 버전의 Aspose.Email에서는 from, to, subject 및 body 속성의 텍스트 인코딩을 개별적으로 설정했습니다. 사용성을 향상시키기 위해 우리는 PreferredTextEncoding 한 번에 모두 설정하는 속성입니다. 이제 위 속성들의 모든 텍스트가 이메일 메시지에서 올바르게 인코딩되는지 보장하기가 더 쉬워졌습니다. 다음 코드 스니펫은 이메일 주소, 제목 및 본문의 표시 이름으로 프랑스어 단어를 사용하는 방법을 보여줍니다.

// Create an instance of MailMessage
String fileName = "data/";
MailMessage msg = new MailMessage();

// Set the default or preferred encoding. This encoding will be used as the default for the from/to email addresses, subject and body of message.
msg.setPreferredTextEncoding(Charset.forName("cp1252"));

// Set email addresses, subject and body
msg.setFrom(new MailAddress("dmo@domain.com", "démo"));
msg.getTo().addItem(new MailAddress("dmo@domain.com", "démo"));
msg.setSubject("démo");
msg.setHtmlBody("démo");
msg.save(fileName + "SetDefaultTextEncoding_out.msg", SaveOptions.getDefaultMsg());

Java: Outlook 메시지 파일 (MSG)을 TIFF 이미지로 변환

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

Outlook MSG 파일을 TIFF 이미지로 변환하는 기능은 Aspose.Email for Java에서 지원되지 않습니다.

Java: Microsoft Word 문서를 메시지 본문으로 사용하고 이메일 보내기

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

이 문서는 Microsoft Word 문서를 이메일 본문으로 사용하고 수신자에게 보내는 방법을 보여줍니다. 샘플 문서는 Northwind 데이터베이스 샘플의 판매 인보이스이며 Microsoft Word 형식으로 내보낸 것입니다. Aspose.Email for Java은 네트워크 프로토콜 및 Microsoft Outlook 기능을 다루며 Microsoft Word 문서를 처리할 수 없습니다. 이를 해결하기 위해 이 문서의 샘플에서는 사용합니다 Aspose.Words for Java Word 문서를 로드하고 MHTML 형식으로 변환합니다. Aspose.Email for Java는 이메일 본문에 MHTML 문서를 사용합니다.

Microsoft Word 문서를 이메일 본문으로 사용

아래 프로그래밍 샘플은 Aspose.Words for Java와 Aspose.Email for Java를 사용하여 Word 문서를 이메일 본문으로 보내는 방법을 보여줍니다.

Aspose.Word for Java의 Document 클래스.
MHTML 형식으로 저장합니다.
Aspose.Email for Java의 MailMessage 이메일 본문을 설정하는 클래스.
다른 MailMessage 클래스 속성과 메서드.
Aspose.Email for Java의 SMTPClient 클래스.

소스 문서는 Microsoft Northwind 샘플에서 Microsoft Word로 내보낸 판매 청구서이며 아래에서 확인할 수 있습니다.

메시지를 Microsoft Outlook에서 전송하고 수신하면 아래와 같이 보입니다.

HTML 서식 및 이미지는 Outlook이나 Gmail, Hotmail과 같은 웹 이메일 클라이언트에서 볼 때 원본 문서와 동일하게 보존됩니다. 아래는 Chrome 브라우저에서 Gmail로 열었을 때의 메시지 스크린샷입니다.

다음 코드 스니펫은 Microsoft Word 문서를 메시지 본문으로 사용하고 이를 사용하여 이메일을 보내는 방법을 보여줍니다. SmtpClient 클래스 인스턴스.

// The path to the File directory
String dataDir = "data/";

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(dataDir + "Test.doc");
ByteArrayOutputStream mhtmlStream = new ByteArrayOutputStream();
wordDocument.save(mhtmlStream, SaveFormat.MHTML);

// Load the MHTML in a MailMessage object
MailMessage message = MailMessage.load(new ByteArrayInputStream(mhtmlStream.toByteArray()), new MhtmlLoadOptions());
message.setSubject("Sending Invoice in Email");
message.setFrom(new MailAddress("sender@gmail.com"));
message.setTo(MailAddressCollection.to_MailAddressCollection("recipient@gmail.com"));

// Save the message in MSG format to disk
message.save(dataDir + "WordDocAsEmailBody_out.msg", SaveOptions.getDefaultMsgUnicode());

    // Send the email message
try (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "pwd")) {
    client.setSecurityOptions(SecurityOptions.SSLExplicit);
    client.send(message);
}

Java: Aspose.Email 인쇄 기능

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

인쇄 기능

Java용 Aspose.Email에서는 인쇄 기능이 지원되지 않습니다.

Java: 반복 패턴에서 발생 횟수 생성

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

Aspose.Email을 사용하면 반복 패턴을 사용하여 발생을 생성할 수 있습니다. 이 기사에서는 방법 및 방법을 설명합니다 다음 발생 생성 및 사용자 친화적인 항목 설명 가져오기. MAPI 캘린더 반복 패턴에서 발생은 Aspose.Email을 사용하여 생성할 수 있습니다. 다음 코드 스니펫은 반복 패턴에서 발생을 생성하는 방법을 보여줍니다.

다음 발생 또는 n개의 발생 계산

"next" 발생을 얻으려면 nNextOccurrences = 1 파라미터와 함께 GenerateOccurrences 메서드를 사용하십시오. 다음 코드 스니펫은 nNextOccurrences = 20을 사용하여 20개의 발생을 생성하는 방법을 보여줍니다. 아래 코드의 출력은 다음과 같습니다:

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

CalendarRecurrence recurrencePattern = new CalendarRecurrence();

recurrencePattern.setStartDate(sdf.parse("1997-09-10 09:00:00"));
RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(20);
rule.setInterval(18);
rule.getByMonthDay().add(new int[] { 10, 11, 12, 13, 14, 15 });
DateCollection expectedDates = recurrencePattern.generateOccurrences(20);
System.out.println("expectedDates.Count = " + expectedDates.size());
for (int i = 0; i < expectedDates.size(); i++) {
    System.out.println("DateTime = " + sdf.format(expectedDates.getItem(i)));
}

반복에 대한 사용자 친화적인 텍스트 가져오기

규칙에 대한 사용자 친화적인 텍스트는 아래와 같이 FriendlyText 속성을 사용하여 얻을 수 있습니다. 코드의 출력은 "최대 2번 반복으로 매월 말일로부터 1일 및 1일에 반복됩니다."가 됩니다. 다음 코드 조각은 반복에 대한 사용자 친화적인 텍스트를 얻는 방법을 보여줍니다.

RecurrenceRule rule = recurrencePattern.getRRules().add();
rule.setFrequency(Frequency.Monthly);
rule.setCount(2);
rule.getByMonthDay().add(1);
rule.getByMonthDay().add(-1);
System.out.println(rule.getFriendlyText());

Java: OAuth를 사용한 메일 서비스 액세스

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

Aspose.Email에 OAuth 2.0 지원이 추가되어 SMTP, POP3, IMAP, EWS 서버에 액세스할 수 있습니다. 일반적으로 OAuth 2.0 베어러 토큰을 지원하는 모든 서버를 Aspose.Email과 함께 사용할 수 있지만, 당사의 이메일 클라이언트는 Google 메일 서버와 Microsoft Office 365 서버에서 테스트되었습니다. 서버에 대한 액세스는 SmtpClient, Pop3Client, ImapClient 및 EWSClient OAuth를 사용한 구현은 두 가지 방법이 있습니다.

액세스 토큰을 이메일 클라이언트의 생성자에 직접 제공합니다. 이 경우 사용자는 액세스 토큰의 수명이 제한되어 있음을 이해해야 합니다. 토큰이 만료되면 이메일 클라이언트를 사용해 서버에 접근할 수 없습니다.
다음 기반의 토큰 공급자 맞춤 구현을 제공합니다 ITokenProvider 이메일 클라이언트의 생성자에 인터페이스를 전달합니다. 이 경우 클라이언트는 토큰 만료 시간을 확인하고 요청합니다 ITokenProvider 이전 토큰이 만료된 경우 새 액세스 토큰을 발급받습니다. 이렇게 하면 클라이언트가 토큰을 주기적으로 갱신하며 서버와 무제한으로 작업할 수 있습니다. 많은 서비스가 액세스 토큰을 갱신하는 간단한 방식을 지원합니다. 예를 들어, Google 서비스의 리프레시 토큰을 사용하거나 Microsoft ID 플랫폼의 ROPC 인증 흐름을 사용하여 토큰 공급자를 구현할 수 있습니다.

적절한 서버에 계정 구성

다음 문서는 메일 서비스에 액세스하는 계정을 구성하는 데 도움이 됩니다.

대상 Office 365
대상 Gmail

액세스 토큰을 사용한 메일 서비스 액세스

다음 코드 예제에서는 액세스 토큰을 사용하여 메일 서비스에 연결하는 방법을 보여줍니다.

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

토큰 공급자를 사용한 메일 서비스 액세스

다음 코드 예제에서는 토큰 공급자를 사용하여 메일 서비스에 연결하는 방법을 보여줍니다.

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

Office 365용 맞춤 ITokenProvider 구현

아래 토큰 공급자 구현을 사용하여 Office 365 메일 서비스에 액세스할 수 있습니다.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

다음 코드 예제에서는 사용자 지정 토큰 공급자를 사용하여 Office 365 서비스에 연결하는 방법을 보여줍니다.

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

Java: OAuth를 사용하여 메일 서비스에 액세스하기

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

액세스 토큰을 이메일 클라이언트의 생성자에 직접 제공합니다. 이 경우 사용자는 액세스 토큰의 수명이 제한되어 있음을 이해해야 합니다. 토큰이 만료되면 이메일 클라이언트를 사용해 서버에 접근할 수 없습니다.
다음 기반의 토큰 공급자 맞춤 구현을 제공합니다 ITokenProvider 이메일 클라이언트의 생성자에 인터페이스를 전달합니다. 이 경우 클라이언트는 토큰 만료 시간을 확인하고 요청합니다 ITokenProvider 이전 토큰이 만료된 경우 새 액세스 토큰을 발급받습니다. 이렇게 하면 클라이언트가 토큰을 주기적으로 갱신하며 서버와 무제한으로 작업할 수 있습니다. 많은 서비스가 액세스 토큰을 갱신하는 간단한 방식을 지원합니다. 예를 들어, Google 서비스의 리프레시 토큰을 사용하거나 Microsoft ID 플랫폼의 ROPC 인증 흐름을 사용하여 토큰 공급자를 구현할 수 있습니다.

적절한 서버에 계정 구성

다음 문서는 메일 서비스에 액세스하는 계정을 구성하는 데 도움이 됩니다.

대상 Office 365
대상 Gmail

액세스 토큰을 사용한 메일 서비스 액세스

다음 코드 예제에서는 액세스 토큰을 사용하여 메일 서비스에 연결하는 방법을 보여줍니다.

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        "accessToken",
        true,
        SecurityOptions.Auto)) {

}

토큰 공급자를 사용한 메일 서비스 액세스

다음 코드 예제에서는 토큰 공급자를 사용하여 메일 서비스에 연결하는 방법을 보여줍니다.

ITokenProvider tokenProvider = TokenProvider.Google.getInstance(
        "ClientId",
        "ClientSecret",
        "RefreshToken");

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.gmail.com",
        587,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "imap.gmail.com",
        993,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "pop.gmail.com",
        995,
        "user1@gmail.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

Office 365용 맞춤 ITokenProvider 구현

아래 토큰 공급자 구현을 사용하여 Office 365 메일 서비스에 액세스할 수 있습니다.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

다음 코드 예제에서는 사용자 지정 토큰 공급자를 사용하여 Office 365 서비스에 연결하는 방법을 보여줍니다.

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
        "Tenant",
        "ClientId",
        "ClientSecret",
        "EMail",
        "Password",
        scopes);

// Connecting to SMTP server
try (SmtpClient client = new SmtpClient(
        "smtp.office365.com",
        587,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLExplicit)) {

}

// Connecting to IMAP server
try (ImapClient client = new ImapClient(
        "outlook.office365.com",
        993,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.SSLImplicit)) {

}

// Connecting to POP3 server
try (Pop3Client client = new Pop3Client(
        "outlook.office365.com",
        995,
        "Test1@test.onmicrosoft.com",
        tokenProvider,
        SecurityOptions.Auto)) {

}

// Connecting to EWS server
final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
try (IEWSClient ewsClient = EWSClient.getEWSClient(mailboxUri, credentials)) {

}

IMAP, POP3 또는 SMTP를 통해 Office 365에 액세스하기 위한 권한

Office 365 메일 서비스에 액세스하려면 올바른 API 권한을 적용하고 관리자 동의를 부여해야 합니다:

API 권한 / 권한 추가 마법사에서 Microsoft Graph를 선택한 다음 위임된 권한을 선택하면 다음 권한 범위가 나열됩니다:

offline_access
IMAP.AccessAsUser.All
POP.AccessAsUser.All
SMTP.Send

토큰 공급자 예제:

ITokenProvider tokenProvider = new AzureROPCTokenProvider(OAuth.Tenant, OAuth.ClientId, OAuth.ClientSecret, User.EMail, User.Password,
        new String[] {
                "offline_access",
                "https://outlook.office.com/IMAP.AccessAsUser.All", // IMAP scope
                "https://outlook.office.com/POP.AccessAsUser.All",  // POP3 scope
                "https://outlook.office.com/SMTP.Send"              // SMTP scope
        });

Java: 임베디드 객체 데이터 추출

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

때때로 포함된 OLE 데이터가 "oleData.mso" 첨부 파일로 표시됩니다 MapiAttachment 수동으로 추출해야 합니다. 이 oleData.mso 파일은 Microsoft Computer Document File (MCDF) 형식이며, 이러한 파일에 대한 지원은 Aspose.Email의 범위를 벗어납니다. 그러나 Aspose.Email은 OpenMCDF와 같은 다른 오픈 소스 라이브러리와 결합하여 이러한 파일의 내용을 읽어 디스크에 저장할 수 있습니다. Aspose.Email은 InlineAttachmentExtractor oledata.mso의 바이너리 데이터에서 MSO 패키지를 열거하는 클래스이며, 이를 통해 복합 파일 읽기 라이브러리로 내용 추출에 사용할 수 있습니다.

메시지 본문 유형이 HTML(RTF가 아님)이고 메시지에 OLE 객체가 포함된 경우, MapiPropertyTag.PR_ATTACH_DATA_OBJ 속성이 존재하지 않습니다. 이 경우 OLE 객체에 대한 정보는 oldedata.mso에 포함됩니다.

임베디드 객체 추출

이 기사에서는 Aspose.Email을 사용하여 해당 파일의 내용을 추출하는 방법을 보여줍니다:

// The path to the File directory
String dataDir = "/data";

MapiMessage msg = MapiMessage.fromFile(dataDir + "double.msg");
for (MapiAttachment mapiAttachment : msg.getAttachments()) {
    if ("oledata.mso".equals(mapiAttachment.getLongFileName())) {
        IGenericDictionary<String, byte[]> oledata = InlineAttachmentExtractor.enumerateMsoPackage(new ByteArrayInputStream(mapiAttachment.getBinaryData()));

        for (String oleItem : oledata.getKeys()) {
            // Use binary data
            processBynaryData(oledata.get_Item(oleItem));
        }
    }
}

Java: 반복 일정이 포함된 회의 요청 전송

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

Aspose.Email을 사용하면 반복 일정이 포함된 회의 요청을 생성할 수 있습니다. 이 기사에서는 특정 반복을 갖는 회의 요청을 생성하는 방법을 설명합니다. 약속 고유 ID를 저장해두면 이후에 약속에 대한 업데이트를 보낼 때 사용할 수 있습니다.

반복 일정이 포함된 회의 요청 생성

다음 코드 샘플은 이를 달성하는 방법을 보여줍니다.

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String szUniqueId;

// Create a mail message
MailMessage msg1 = new MailMessage();
msg1.getTo().add("to@domain.com");
msg1.setFrom(new MailAddress("from@gmail.com"));

// Fill appointment object
Date startDate = sdf.parse("2013-12-01 17:00:00");
Date endDate = sdf.parse("2013-12-31 17:30:00");

// Create appointment object
Appointment agendaAppointment = new Appointment("same place", startDate, endDate, msg1.getFrom(), msg1.getTo());

// Create unique id as it will help to access this appointment later
szUniqueId = UUID.randomUUID().toString();
agendaAppointment.setUniqueId(szUniqueId);
agendaAppointment.setDescription("----------------");

// Create a weekly reccurence pattern object
WeeklyRecurrencePattern pattern1 = new WeeklyRecurrencePattern(14);

// Set weekly pattern properties like days: Mon, Tue and Thu
pattern1.setStartDays(new int[3]);
pattern1.getStartDays()[0] = CalendarDay.Monday;
pattern1.getStartDays()[1] = CalendarDay.Tuesday;
pattern1.getStartDays()[2] = CalendarDay.Thursday;
pattern1.setInterval(1);

// Set recurrence pattern for the appointment
agendaAppointment.setRecurrence(pattern1);

// Attach this appointment with mail
msg1.getAlternateViews().addItem(agendaAppointment.requestApointment());

// Create SmtpCleint
SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
client.setSecurityOptions(SecurityOptions.Auto);

// Send mail with appointment request
client.send(msg1);

// Return unique id for later usage
// return szUniqueId;

약속 업데이트 요청 전송

이전 약속에 대한 업데이트를 보내려면 고유 ID가 필요합니다. 다음 샘플 코드에서는 이 약속 업데이트 요청을 보내는 방법을 보여줍니다

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date startDate = sdf.parse("2013-12-12 17:00:00");
Date endDate = sdf.parse("2013-12-12 17:30:00");
Appointment appUpdate = new Appointment("Different Place", startDate, endDate, new MailAddress("newcustomeronnet@gmail.com"),
        MailAddressCollection.to_MailAddressCollection("kashif.iqbal@aspose.com"));
appUpdate.setUniqueId(szUniqueId);
WeeklyRecurrencePattern pattern3 = (WeeklyRecurrencePattern) appUpdate.getRecurrence();
appUpdate.setSummary("update meeting request summary");
appUpdate.setDescription("update");
MailMessage msgUpdate = new MailMessage("newcustomeronnet@gmail.com", "kashif.iqbal@aspose.com", "06 - test email - update meeting request", "test email");
msgUpdate.addAlternateView(appUpdate.updateAppointment());
SmtpClient smtp = new SmtpClient("server.domain.com", 587, "username", "password");
smtp.send(msgUpdate);

Java: 메일 클라이언트의 다중 스레드 지원

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

다음과 같은 메일 클라이언트 ImapClient 및 Pop3Client 사용자가 멀티스레드 환경에서 이를 사용할 수 있도록 합니다. 메일 클라이언트는 서버와 하나 이상 연결을 가질 수 있습니다. 클라이언트 내부에서 연결 집합을 관리하기 위해 연결 풀을 사용합니다. 동시에 생성·사용 가능한 연결 수는 CredentialsByHostClient.MaxConnectionsPerServer 속성에 의해 제한됩니다. 이 속성은 1 이상의 값으로 설정할 수 있으며, 기본값은 10입니다. 연결에 대해 멀티스레드 작업을 지원하기 위해 명령 큐가 구현되었습니다. 명령은 Noop, Authenticate 등 프로토콜에서 정의된 가장 간단한 작업을 구현합니다. 사용자는 사용 가능한 연결 수보다 더 많은 명령을 실행하려 할 수 있지만, 실제로 실행되는 것은 클라이언트가 해당 작업을 위한 연결을 생성할 수 있을 때만입니다.

멀티스레드 환경에서 메일 클라이언트 사용 방법

이메일 클라이언트는 다음과 같은 동작을 합니다:

1. MaxConnectionsPerServer = 1인 경우, 클라이언트는 1개의 연결을 생성하고 인증 및 인가를 수행합니다. 이 연결은 클라이언트가 해제될 때까지 작업 상태를 유지합니다. 서로 다른 스레드의 모든 작업은 기본 연결에 배치된 하나의 명령 큐로 전달됩니다.

2. MaxConnectionsPerServer > 1인 경우, 클라이언트는 필요량만큼 연결을 생성하고 각 연결에 대해 인증 및 인가를 수행합니다. 하나의 연결은 기본 연결로 예약됩니다. 이 연결은 클라이언트가 해제될 때까지 작업 상태를 유지합니다. 다른 연결은 필요에 따라 생성·해제됩니다. 이러한 연결의 최대 수는 MaxConnectionsPerServer 속성으로 정의되며, 예를 들어 MaxConnectionsPerServer = 2이면 하나는 기본 연결로 예약되고, 두 번째 연결은 다른 스레드에서 실행되는 작업을 위한 추가 연결로 사용됩니다. MaxConnectionsPerServer = 3이면 첫 번째 연결이 기본 연결로 예약되고, 두 개의 추가 연결이 다른 스레드 작업에 사용됩니다. 새로운 스레드에서 연결 요청이 들어오고 모든 연결이 사용 중이면, 사용 중인 연결 수가 감소할 때까지 클라이언트는 대기합니다. 이는 연결을 올바르게 해제하는 것이 왜 중요한지를 명확히 하는 매우 중요한 상황입니다.

예제

사용자는 여러 방법으로 다른 스레드에서 작업을 실행할 수 있습니다. 이는 두 가지 유형으로 구분됩니다:

1. 사용자는 클라이언트에 정의된 비동기(Begin/End) 메서드를 사용합니다. 이 경우 메일 클라이언트는 필요에 따라 새로운 스레드를 시작합니다. 클라이언트에는 작업 큐가 구현되어 있는데(연결의 명령 큐와 혼동하지 마세요), 연결이 사용 가능하면 작업이 실행됩니다. 사용 중인 연결 수가 제한값보다 적어지면 클라이언트는 새 연결을 만들고 현재 작업을 위한 스레드를 생성하여 해당 작업을 실행합니다. 비동기 작업 사용 예시:

// Create an imapclient with host, user and password
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");
client.selectFolder("InBox");

ImapMessageInfoCollection messages = client.listMessages();
IAsyncResult res1 = client.beginFetchMessage(messages.get_Item(0).getUniqueId());
IAsyncResult res2 = client.beginFetchMessage(messages.get_Item(1).getUniqueId());
MailMessage msg1 = client.endFetchMessage(res1);
MailMessage msg2 = client.endFetchMessage(res2);

2. 사용자는 Thread, ExecutorService 등과 같은 객체 또는 이 목적을 위한 기타 객체를 사용하여 스레드를 생성할 수 있습니다. 또한 써드파티 코드에서 생성된 스레드를 사용할 수도 있습니다. 이때 클라이언트는 두 가지 동작 모델을 가집니다

a. 사용자가 스레드 내 작업을 위해 추가 연결을 만들지 않은 경우, 해당 스레드의 모든 작업은 명령 큐를 통해 기본 연결로 전송됩니다. 새로운 연결을 만들지 않고 추가 스레드에서 수행되는 작업 예시로, 모든 트랜잭션이 기본 연결을 통해 이루어집니다:

/**
 * Creates an executor service with a fixed pool size, that will time 
 * out after a certain period of inactivity.
 * 
 * @param poolSize The core- and maximum pool size
 * @param keepAliveTime The keep alive time
 * @param timeUnit The time unit
 * @return The executor service
 */
private static ExecutorService createFixedTimeoutExecutorService(
    int poolSize, long keepAliveTime, TimeUnit timeUnit)
{
    ThreadPoolExecutor e = 
        new ThreadPoolExecutor(poolSize, poolSize,
            keepAliveTime, timeUnit, new LinkedBlockingQueue<Runnable>());
    e.allowCoreThreadTimeOut(true);
    return e;
}

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        client.selectFolder("folderName");
        ImapMessageInfoCollection messageInfoCol = client.listMessages();
        for (ImapMessageInfo messageInfo : messageInfoCol) {
            list.add(client.fetchMessage(messageInfo.getUniqueId()));
        }
    }
});

b. 사용자가 추가 스레드용 새로운 연결을 생성하는 메서드를 실행하면, 새 연결을 허용하도록 연결 할당량 값이 변경될 때까지 해당 스레드가 차단됩니다. 그 후 새 연결이 생성됩니다. 이 연결은 해당 스레드의 모든 작업에 대한 기본 연결로 설정됩니다. 스레드의 모든 작업이 완료된 후 연결을 해제해야 합니다. 새로운 연결을 만들려면 CredentialsByHostClient.CreateConnection 메서드를 사용하십시오. 이 메서드는 IDisposable 인터페이스를 구현하는 객체를 반환합니다. 연결을 해제하려면 Dispose 메서드를 호출해야 합니다. 연결 생성 및 해제는 메일 작업이 실행되는 스레드 내에서 수행되어야 합니다. 메일 클라이언트가 생성된 스레드에서 새로운 연결을 만들려고 하면 오류가 발생하는데, 해당 스레드는 현재 새로운 연결을 생성하는 데 사용할 수 없기 때문입니다. 또한 MaxConnectionsPerServer = 1인 경우 새로운 연결을 만들 수 없습니다. 추가 스레드에서 새로운 연결을 생성하는 코드 예시:

final List<MailMessage> list = new ArrayList<MailMessage>();

ExecutorService executor = createFixedTimeoutExecutorService(1, 1000, TimeUnit.MILLISECONDS);

executor.execute(new Runnable() {
    public void run() {
        IConnection connection = client.createConnection();
        try {
            client.selectFolder(connection, "FolderName");
            ImapMessageInfoCollection messageInfoCol = client.listMessages(connection);
            for (ImapMessageInfo messageInfo : messageInfoCol)
                list.add(client.fetchMessage(connection, messageInfo.getUniqueId()));
        } finally {
            connection.dispose();
        }
    }
});

권장 사항

사용자가 모든 명령을 기본 연결에 보낼 경우, 서로 다른 스레드의 명령이 섞이는 상황이 발생할 수 있다는 점에 유의해야 합니다. 사용자는 어떤 명령이 순서에 의존하는지 이해하고, 이러한 명령들의 동기화를 위해 조치를 취해야 합니다. 또한 다른 세션(IMAP/POP3)에서 명령을 실행하는 가능성도 고려해야 합니다. FetchMessage, AppendMessage, Send와 같은 가장 시간이 많이 소요되는 작업은 새 스레드와 새 연결을 사용하여 수행하는 것이 바람직합니다. 하지만 Delete와 같은 빠른 작업은 기본 연결에서 수행하는 것이 적합합니다. 새 연결 초기화 자체가 충분히 시간이 소요되는 작업임을 기억하십시오.

Java: 소개 및 샘플 애플리케이션

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

Aspose.Email Mail 사용 시나리오

이 문서는 Aspose.Email for Java의 다양한 활용 방안을 제시하며, 특히 구성 요소의 이메일 프로그래밍 기능에 초점을 맞춥니다.

뉴스레터 소프트웨어

Aspose.Email Mail API를 사용해 강력한 뉴스레터 애플리케이션을 만들 수 있습니다. Aspose.Email의 임베디드 객체(그림, 소리 등) 추가 지원을 활용하면 이미지(및 기타 임베디드 객체)가 포함된 풍부한 HTML 뉴스레터를 만들 수 있습니다. Aspose.Email Mail API의 대량 메일 기능을 사용하면 제한된 시간 안에 대규모 이메일을 전송할 수도 있습니다. 또한 Aspose.Email Mail는 템플릿 기반 메일 병합 기능을 제공하여 뉴스레터 템플릿을 만들 수 있으며, 이를 사용해 대량 뉴스레터를 메일 병합으로 보낼 수 있습니다. 이메일 마케팅 애플리케이션에서 Aspose.Email Mail가 수행할 수 있는 다른 많은 작업이 있습니다.

기타 마케팅 도구

뉴스레터 애플리케이션과 유사하게, Aspose.Email Mail을 사용해 다양한 종류의 소프트웨어를 구축할 수 있습니다. 이를 활용해 이메일 마케팅, 대량 메일러 및 전자 캠페인 대량 메일러 등을 만들 수 있습니다.

비즈니스 애플리케이션

Aspose.Email Mail은 거의 모든 유형의 비즈니스 애플리케이션에서 유틸리티 작업을 수행하는 데 사용할 수 있습니다:

이메일 알림: 사용자의 활동을 알리기 위해 이메일 알림을 보냅니다.
회의 요청: Aspose.Email Mail의 iCalendar 지원을 사용해 비즈니스 회의 요청을 보냅니다.
이메일 예약 보고서: 보고서는 대부분의 비즈니스 애플리케이션에서 필수적이며, 많은 비즈니스 보고서가 일정 간격으로 생성됩니다. Aspose.Email Mail을 사용해 예약된 보고서를 이메일로 전송하십시오.

이메일 클라이언트

Aspose.Email Mail은 이메일 클라이언트에서도 일반 이메일을 보내는 데 사용할 수 있습니다. 첨부 파일, 임베디드 객체, iCalendar 이벤트, 메일 병합, 대량 이메일 전송 등을 지원하므로, Aspose.Email Mail은 이메일 클라이언트 애플리케이션을 만들기에 최적의 선택입니다.

Aspose.Email Mail 샘플 애플리케이션

Aspose.Email Mail 사용 방법을 보여주기 위해, 다음과 같이 이메일 메시지를 구성하는 애플리케이션을 만들겠습니다. MailMessage 클래스 그리고 SmtpClient 클래스를 사용해 전송합니다.

Mail : 샘플 애플리케이션 단계

아래 단계에 따라 Aspose.Email을 사용해 애플리케이션을 생성하십시오.

애플리케이션을 설계하십시오: From, To, Message 세 필드를 입력받는 인터페이스를 만듭니다.
디자인 뷰에서 Send 버튼을 두 번 클릭하고 편집기에 코드를 작성하십시오.
MailMessage 클래스의 인스턴스를 생성하고 해당 속성을 사용해 이메일 메시지를 구성합니다. (MailMessage 클래스 인스턴스는 SmtpClient 클래스를 사용해 SMTP 서버로 전달되는 이메일 메시지를 구성하는 데 사용됩니다).
SmtpClient 클래스의 인스턴스를 생성하고 해당 속성을 사용해 이메일 메시지를 전송합니다.
애플리케이션을 테스트하십시오.
From 및 To 필드에 주소를 입력하십시오.
Message Body 필드에 메시지를 입력하십시오.
Send 버튼을 클릭하십시오.

위 단계는 아래에 설명되어 있습니다. 디자인 뷰에서 Send 버튼을 두 번 클릭하고 아래 코드를 추가하십시오:

// Declare message as MailMessage instance
MailMessage message = new MailMessage();
// Specify From, To, Subject and Body
message.setFrom(new MailAddress("#From"));
message.setTo(MailAddressCollection.to_MailAddressCollection("#To"));
message.setSubject("#Subject");
message.setBody("#Body");

// Send email using SmtpClient, Create an instance of the SmtpClient Class and Specify the mailing host server, Username, Password and Port
SmtpClient client = new SmtpClient();

// Specify the mailing host server, Username, Password and Port
client.setHost("mail.server.com");
client.setUsername("username");
client.setPassword("password");
client.setPort(25);
client.send(message);

// Notify the user that a message has been sent
System.out.println("Message Sent");

SSL이 활성화된 서버에 연결할 때는 다음 SMTPClient 객체 속성을 설정해야 합니다.

// Set the port to 587. This is the SSL port of Gmail SMTP server, set the security mode to explicit
client.setPort(587);
client.setSecurityOptions(SecurityOptions.SSLExplicit);

결론

Aspose.Email Mail은 개발자가 다중 스레드 대량 이메일 전송, 메일 병합 사용, 첨부 파일 추가, 이메일 메시지에 그림 및 사운드 삽입, iCalendar 이벤트 추가, 이메일 수신 등 거의 모든 이메일 작업을 수행할 수 있는 매우 강력한 구성 요소입니다.

Aspose.Email Pop3

Aspose.Email Pop3 Java에서 우편 프로토콜 v3(POP3)를 구현합니다. Java 개발자가 프로토콜 세부 사항이나 이메일·네트워크 프로그래밍의 복잡성에 관여하지 않고도 Java 애플리케이션에 이메일 조회 및 수신 기능을 추가할 수 있습니다. Aspose.Email Pop3는 표준 POP3 프로토콜에 정의된 모든 명령을 지원하며, 사용하기 쉬운 인터페이스와 간결하고 직관적인 객체 모델을 제공합니다. 이는 Java 개발자의 학습 곡선을 크게 감소시킵니다.

Pop3 : 주요 기능

Aspose.Email의 일부인 Aspose.Email Pop3는 Java 전용으로 설계되었으며 관리형 Java 코드로 작성되었습니다. 이를 통해 다음을 수행할 수 있습니다:

POP3 서버에 연결하고 로그인합니다.
APOP 지원.
메시지 조회.
메시지 검색.
비동기 프로그래밍 방식을 완전 지원합니다.
SSL 지원.

Aspose.Email Pop3 시나리오

Aspose.Email Pop3는 개발자들이 다양한 시나리오에서 사용할 수 있습니다. 여기서는 몇 가지 예를 공유합니다.

비즈니스 이메일 자동화

Aspose.Email Pop3는 이메일 수신함을 조회하고 이메일 메시지를 가져오는 데 사용할 수 있습니다. 이메일 전송 구성 요소인 Aspose.Email Mail와 원활하게 작동합니다. Aspose.Email는 이메일 자동화를 완전하게 지원합니다. Aspose.Email Mail로 이메일을 보내고 Aspose.Email Pop3로 메시지를 가져오세요. 다운로드된 이메일 메시지는 Aspose.Email Mime으로 파싱할 수 있습니다.

이메일 클라이언트

Aspose.Email Pop3는 이메일 클라이언트 애플리케이션에서 이메일을 수신하는 데 사용할 수 있습니다.

Pop3 : 샘플 애플리케이션

여기서는 사용 방법을 보여드리겠습니다. Aspose.Email Pop3. 이 클래스는 많은 기능을 제공하지만 여기서는 POP3 서버에 연결하고 메시지를 검색하는 방법에 집중합니다. 예제는 애플리케이션을 만드는 방법과 애플리케이션을 작동시키는 코드 예제를 보여줍니다. 아래 단계에 따라 Aspose.Email Pop3를 사용해 샘플 애플리케이션을 만드세요.

Pop3Client 인스턴스를 생성합니다.
이 인스턴스에 POP3 호스트 이름, 로그인 및 비밀번호를 설정합니다.
MailMessage 인스턴스를 생성하고 fetchMessage() 함수를 호출하여 계정의 첫 번째 이메일을 가져옵니다. 이렇게 하면 이메일 계정의 첫 번째 메시지가 MailMessage 인스턴스로 들어옵니다.
MailMessage 인스턴스의 From, Subject 및 HtmlBody 속성을 사용하여 발신자, 제목 및 메시지 본문을 확인합니다.

위 단계는 아래 코드 예제에서 보여줍니다.

// Create a POP3 client
Pop3Client client = new Pop3Client();

// Basic settings (required)
client.setHost("pop3.youdomain.com");
client.setUsername("username");
client.setPassword("psw");

try {
    // Retrieve first message in MailMessage format directly
    MailMessage msg;
    msg = client.fetchMessage(1);
    System.out.println(msg.getFrom().toString());
    System.out.println(msg.getSubject());
    System.out.println(msg.getHtmlBody());
} catch (Exception ex) {
    System.err.println(ex);
}

SSL이 활성화된 서버의 경우, Pop3Client 객체의 다음 속성을 변경해야 합니다:

// Set implicit security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Imap

Aspose.Email Imap Java에서 인터넷 메시지 액세스 프로토콜(IMAP)을 구현합니다. Aspose.Email Imap을 사용하면 Java 개발자가 프로토콜 세부 사항을 이해하지 않아도 Java 애플리케이션에 IMAP 기능을 빠르게 추가할 수 있습니다. 이 구성 요소는 메시지 가져오기 및 업로드, 메시지의 새/읽음/읽지 않음 상태 확인 등을 지원합니다.

Imap : 주요 기능

Aspose.Email Imap을 사용하면 다음을 할 수 있습니다:

이메일 메시지 가져오기.
이메일 메시지를 업로드합니다.
다양한 폴더의 이메일 메시지를 나열합니다.
이메일 메시지 상태를 확인합니다.
MailMessage와 작업합니다.
SSL 지원으로 작업합니다.

Using Aspose.Email Imap

Aspose.Email Imap은 Java에서 인터넷 메시지 액세스 프로토콜(IMAP)을 구현합니다. 이를 통해 개발자는 IMAP 서버 이메일을 쉽게 조회하고 관리할 수 있으며, 이메일 폴더를 생성, 삭제 또는 이름 변경할 수 있습니다. Aspose.Email Imap을 사용하면 IMAP 프로토콜을 쉽게 사용할 수 있는 API를 통해 이메일을 서버에 저장된 상태로 어떤 PC에서도 접근할 수 있습니다. 또한 웹 또는 데스크톱 애플리케이션을 만들어 IMAP 서버에서 이메일을 수신하고 조작할 수 있습니다. Aspose는 인터넷 인증 및 RFC 표준에 따라 IMAP 프로토콜을 구현했습니다. 따라서 Aspose.Email Imap은 이해하기 쉬운 객체 모델과 인터페이스를 가진 안전하고 완전한 기능의 IMAP 구현입니다.

Imap : Sample Application

이 문서는 사용 방법을 설명합니다 Aspose.Email Imap작은 애플리케이션을 만들어 IMAP 이메일 계정의 메시지 수를 가져옵니다. 아래 단계에 따라 Aspose.Email Imap을 사용한 샘플 애플리케이션을 생성하십시오.

IMAP 서버 이름, 로그인 및 비밀번호를 전달하여 ImapClient 인스턴스를 생성합니다.
ImapClient 인스턴스의 selectFolder() 함수를 호출하여 메시지 수를 셀 폴더를 선택하십시오.
이제 ImapClient 인스턴스의 CurrentFolder.TotalMessageCount 속성을 호출하여 이메일 메시지 수를 얻습니다.

Imap : 코드 예제

아래 코드 예제는 위에서 설명한 단계를 Aspose.Email을 사용하여 구현하는 방법을 보여줍니다.

// Creates an instance of the class ImapClient by specified the host, username and password
ImapClient client = new ImapClient("localhost", "username", "password");

try {
    client.selectFolder(ImapFolderInfo.IN_BOX);
    String strTemp;
    strTemp = "You have " + client.getCurrentFolder().getTotalMessageCount() + " messages in your account.";
    // Gets number of messages in the folder, Disconnects to imap server.
    System.out.println(strTemp);
} catch (Exception ex) {
    System.err.println(ex);
}

SSL이 활성화된 메일 서버의 경우, ImapClient 객체의 다음 속성을 설정하십시오:

// Set security mode
client.setSecurityOptions(SecurityOptions.SSLImplicit);

Aspose.Email Exchange

Aspose.Email Exchange 개발자가 Microsoft Exchange Server에서 이메일을 관리할 수 있게 합니다. 이 구성 요소를 사용하면 프로토콜 세부 사항을 이해하지 않고도 연결, 메시지 목록 조회 및 이메일 다운로드 등을 수행할 수 있습니다. 이 구성 요소는 메시지 목록, 이메일 전송, 메시지 다운로드 및 로컬 디스크에 eml 또는 msg 형식으로 저장 등을 지원합니다.

Exchange : 주요 기능

Aspose.Email Exchange를 사용하면 다음을 수행할 수 있습니다:

Microsoft Exchange 서버에 연결합니다.
Exchange 사서함의 이메일 메시지를 나열합니다.
받은 편지함, 보낸 편지함, 삭제된 편지함 또는 초안 폴더와 같이 다양한 폴더의 이메일 메시지를 나열합니다.
Exchange 서버의 모든 폴더에서 메시지를 삭제합니다.

Using Aspose.Email Exchange

Aspose.Email Exchange를 사용하면 개발자가 Java 애플리케이션에서 Exchange Server 사서함에 접근할 수 있습니다. Exchange 서버의 이메일 관리를 위한 사용하기 쉬운 API를 제공하며, 콘솔, 데스크톱 또는 웹 애플리케이션을 만들어 Exchange 사서함의 이메일을 관리할 수 있습니다.

Aspose.Email Exchange Sample Application

이 문서는 사용하는 방법을 보여줍니다 Aspose.Email Exchange간단한 데스크톱 애플리케이션을 만들어 Exchange Server 사서함에 연결하고, 받은 편지함 폴더의 메시지 목록을 가져와 윈도우 폼에 표시합니다.

Exchange : 샘플 애플리케이션 단계

애플리케이션을 성공적으로 실행하려면 Exchange Server에 접근할 올바른 자격 증명이 필요합니다. 여기서는 Windows 폼에서 Exchange Server URI, 사용자 이름, 비밀번호 및 도메인 정보를 가져옵니다. 이 샘플은 매우 기본적이어서 메시지 속성(제목, 발신자 및 수신자)만 리스트박스에 표시합니다.

Exchange : 코드 예제

List Messages 버튼의 클릭 이벤트 핸들러에 다음 코드를 추가하십시오.

// Clear the items in the listbox
lstMessages.clear();

// Create instance of IEWSClient class by giving credentials and Call ListMessages method to list messages info from Inbox
IEWSClient client = EWSClient.getEWSClient("mailboxURI", "Username", "Password", "Domain");
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : msgCollection) {
    String strMsgInfo = "Subject: " + msgInfo.getSubject() + " == From: " + msgInfo.getFrom().toString() + " == To: " + msgInfo.getTo().toString();
    lstMessages.add(strMsgInfo);
}

Exchange : 출력

이 스크린샷은 Exchange Server에서 가져온 메시지를 보여줍니다. listMessages() 메서드는 제목, 발신자, 수신자 및 메시지 ID와 같은 기본 정보를 반환합니다. 전체 메시지를 얻으려면 IEWSClient.fetchMessage() 메서드를 호출하십시오. (IEWSClient.fetchMessage() 사용법은 기사에 설명되어 있습니다 Exchange 사서함 및 메시지 작업.)

Aspose.Email Mime

Multipurpose Internet Mail Extensions (MIME)는 이메일 형식을 US-ASCII가 아닌 문자 집합, 텍스트가 아닌 첨부 파일, 다중 파트 메시지 본문 및 비 ASCII 문자 집합의 헤더 정보를 지원하도록 확장하는 인터넷 표준입니다. Aspose.Email Mime은 Java에서 MIME 프로토콜을 구현합니다. 파일(.eml 등)이나 메모리(문자열)에서 이메일을 읽을 수 있는 변환기 역할을 하며, 이메일 파일이나 문자열을 의미 있는 파트로 구문 분석합니다. MIME 프로토콜 세부 사항에 관여하지 않고 이메일 파일을 처리하고 싶을 때, 예를 들어 이메일에서 첨부 파일을 추출하려면 Aspose.Email Mime을 사용하십시오.

주요 기능

Aspose.Email Mime는 Aspose.Email Pop3 및 Aspose.Email Mail와 완벽하게 작동합니다.

Aspose.Email Pop3는 지정된 사서함에서 이메일 메시지를 검색합니다.
Aspose.Email Mail은 지정된 사서함으로 이메일을 보냅니다.
Aspose.Email Mime은 위 두 요소의 핵심이며 이메일 메시지를 구문 분석합니다.

Java: 캘린더를 이용한 회의 요청 취소

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

Aspose.Email의 Appointment 클래스를 사용해 회의 취소 요청을 보낼 수 있습니다. 요청을 취소하려면 원래 회의 요청 정보가 필요합니다. 이 문서의 예제는 먼저 회의 요청을 보내고 정보를 데이터베이스에 저장한 뒤, 메시지 ID를 기반으로 요청을 취소합니다.

회의 요청 보내기

우리가 하기 전에 회의 요청 취소, 우리는 일부를 전송해야 합니다:

먼저 메시지를 전송하기 위해 SmtpClient 유형의 인스턴스를 생성합니다.
모든 참석자 정보를 MailAddressCollection 컬렉션에 저장합니다.
MailMessage 클래스의 인스턴스를 생성하고 From, To, Subject와 같은 필수 속성을 설정합니다.
Appointment 유형의 인스턴스를 생성하고 위치, 시작 시간, 종료 시간, 주최자 및 참석자 정보를 지정합니다.
모든 정보를 데이터베이스에 저장합니다. 데이터베이스 관련 작업은 SaveIntoDB 메서드에서 수행됩니다.

다음 코드 스니펫은 회의 요청을 보내는 방법을 보여줍니다.

class Attendees {
    public String MessageId;
    public String EmailAddress;
    public String DisplayName;
}

class Message {
    public String MessageId;
    public String From;
    public String Subject;
    public String Body;
    public String AppLocation;
    public Date AppStartDate;
    public Date AppEndDate;
    public String AppSummary;
    public String AppDescription;
}

public void send(Attendees[] attendeesArr, String from, String appLocation, Date appStartDate, Date appEndDate) {
    try {
        // Create an instance of SMTPClient
        SmtpClient client = new SmtpClient("MailServer", "Username", "Password");
        // Get the attendees
        MailAddressCollection attendees = new MailAddressCollection();
        for (Attendees a : attendeesArr) {
            attendees.addItem(new MailAddress(a.EmailAddress, a.DisplayName));
        }

        // Create an instance of MailMessage for sending the invitation
        MailMessage msg = new MailMessage();

        // Set from address, attendees
        msg.setFrom(new MailAddress(from));
        msg.setTo(attendees);

        // Create am instance of Appointment
        Appointment app = new Appointment(appLocation, appStartDate, appEndDate, new MailAddress(from), attendees);
        app.setSummary("Monthly Meeting");
        app.setDescription("Please confirm your availability.");
        msg.addAlternateView(app.requestApointment());

        // Save the info to the database
        if (saveIntoDB(msg, app) == true) {
            // Save the message and Send the message with the meeting request
            msg.save(msg.getMessageId() + ".eml", SaveOptions.getDefaultEml());
            client.send(msg);
            System.out.println("message sent");
        }
    } catch (Exception ex) {
        System.err.println(ex);
    }
}

private boolean saveIntoDB(MailMessage msg, Appointment app) {
    // Save Message and Appointment information
    Message messageRow = new Message();
    messageRow.MessageId = msg.getMessageId();
    messageRow.From = msg.getFrom().getAddress();
    messageRow.Subject = msg.getSubject();
    messageRow.Body = msg.getBody();
    messageRow.AppLocation = app.getLocation();
    messageRow.AppStartDate = app.getStartDate();
    messageRow.AppEndDate = app.getEndDate();
    messageRow.AppSummary = app.getSummary();
    messageRow.AppDescription = app.getDescription();
    addToDB(messageRow);

    // Save attendee information
    for (MailAddress address : app.getAttendees()) {
        Attendees attendeesRow = new Attendees();
        attendeesRow.MessageId = msg.getMessageId();
        attendeesRow.EmailAddress = address.getAddress();
        attendeesRow.DisplayName = address.getDisplayName();
        addToDB(attendeesRow);
    }

    return true;
}

회의 요청 취소

회의 요청을 취소하려면 먼저 이메일 메시지의 메시지 ID를 가져와야 합니다. 이 예제에서는 해당 정보를 데이터베이스에 저장했으므로 쉽게 다시 가져올 수 있습니다.

취소 요청을 보낼 메시지를 선택합니다.
Send Cancel Request 를 클릭해 요청을 보냅니다.
데이터베이스를 조회해 참석자, 메시지 및 캘린더 관련 정보를 가져옵니다.
데이터베이스에서 가져온 정보를 이용해 Calendar 클래스와 MailMessage 클래스의 인스턴스를 생성합니다.
Appointment.cancelAppointment() 메서드를 사용해 취소 요청을 보냅니다.
SMTP를 사용해 메일을 전송합니다.

다음 코드 스니펫은 회의 요청을 취소하는 방법을 보여줍니다.

public void cancel(String messageId) {
    // Get the message and calendar information from the database get the attendee information

    // Get the attendee information in reader
    Attendees[] attendeesRows = getAttendeesFromDB(messageId);

    // Create a MailAddressCollection from the attendees found in the database
    MailAddressCollection attendees = new MailAddressCollection();
    for (Attendees attendeesRow : attendeesRows) {
        attendees.addItem(new MailAddress(attendeesRow.EmailAddress, attendeesRow.DisplayName));
    }
    // Get message and calendar information
    Message messageRow = getMessageFromDB(messageId);

    // Create the Calendar object from the database information
    Appointment app = new Appointment(messageRow.AppLocation, messageRow.AppSummary, messageRow.AppDescription, messageRow.AppStartDate, messageRow.AppEndDate,
            new MailAddress(messageRow.From), attendees);

    // Create message and Set from and to addresses and Add the cancel meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(new MailAddress(messageRow.From));
    msg.setTo(attendees);
    msg.setSubject("Cencel meeting");
    msg.addAlternateView(app.cancelAppointment());
    SmtpClient smtp = new SmtpClient("smtp.gmail.com", 587, "user@gmail.com", "password");
    smtp.send(msg);
    System.out.println("cancellation request successfull");
}

Java: Aspose.Email Outlook을 사용한 첫 번째 애플리케이션

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

이 섹션에서는 Aspose.Email Mapi 사용 방법을 보여줍니다. 우리는 Outlook 메시지 파일(TestMessage.msg)을 로드하고 제목, 발신자 및 수신자 주소와 본문 내용을 표시하는 작은 애플리케이션을 생성합니다. Aspose.Email Outlook을 사용해 첫 번째 애플리케이션을 만들려면 다음 단계를 따르세요.

다음의 인스턴스를 생성합니다. MapiMessage 메시지 파일 경로를 지정하는 클래스.
공용 속성을 사용하여 제목, 발신자, 수신자 및 본문을 표시합니다.

위 단계의 구현은 아래 코드 스니펫에서 보여줍니다.

// Load the outlook message file
MapiMessage msg = MapiMessage.fromFile("outlookmessage.msg");

// Use the public properties
//read subject
System.out.print("Subject:" + msg.getSubject());

//sender name
System.out.print("From:" + msg.getSenderName());

//message body
System.out.print("Body:" + msg.getBody());

//Attachments
for(MapiAttachment att : msg.getAttachments())
{
    System.out.print("Attachment Name:"+att.getFileName());
    att.save(att.getFileName());
}

Java: 예외 무시 방법

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

예외 무시 지원

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");
    }
});

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

//Ignore all exceptions
ExceptionManager.setIgnoreAll(true);

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

ExceptionManager.setIgnoreExceptionsLogHandler(new IgnoreExceptionsLogCallback() {
    public void invoke(String message) {
        System.out.println("=== EXCEPTION IGNORED === " + message);
    }
});

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

Exceptioin message:

AsposeArgumentException: properties should not be empty.
If you want to ignore an exception and want to proceed further then you can use:
ExceptionManager.getIgnoreList().add("MailMessage\\Load\\DecodeTnefAttachment\\64149867-679e-4645-9af0-d46566cae598")
Invalid TNEF Attachment will be interpreted as regular attachment.