Documentation – 시작하기

Java: 제품 개요

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

Aspose.Email for Java에 오신 것을 환영합니다!

Aspose.Email for Java는 Microsoft Outlook®을 사용하지 않고도 Java 애플리케이션이 Microsoft Outlook® 문서를 읽고 쓸 수 있게 해주는 Java API입니다. Aspose.Email for Java는 Microsoft Outlook® MSG 문서에서 수신자, 제목, 본문, 첨부 파일을 관리하고, Microsoft Outlook® PST 문서에서 연락처, 메시지 및 폴더 정보를 읽는 등 여러 핵심 기능을 제공합니다. 또한 EML, MSG 및 MHT 형식의 이메일 메시지를 생성, 수정 및 변환하는 데 사용할 수 있습니다.

제품 설명

Aspose.Email for Java는 웹이든 데스크톱이든 모든 유형의 애플리케이션에서 사용할 수 있습니다. 또한 Aspose.Email for Java는 개발자에게 보다 나은 이해를 돕는 실용적인 예제도 제공합니다.

Aspose.Email for Java는 MSG(Outlook 메시지 형식) 파일을 읽을 수 없으며, 원본 내용을 수정한 후 MSG 파일을 저장할 수 있습니다. 또한 첨부 파일을 구문 분석하고 디스크에 저장할 수 있습니다.

Outlook PST 파일 읽기도 지원됩니다. PST 파일에서 폴더, 하위 폴더, 메시지 수, 메시지 정보(제목, 보낸 사람, 수신자 등) 및 연락처 정보를 가져옵니다. PST 파일에서 메시지를 추출하여 MSG 형식으로 디스크에 저장합니다.

Aspose.Email for Java는 개발자들이 애플리케이션에서 다양한 작업을 수행하도록 사용됩니다. 예를 들어, EML 또는 MHT 파일 형태로 이메일을 열거나 저장하고, Microsoft Outlook 메시지와 Outlook PST 파일을 구문 분석·읽기·저장하며, MIME 메시지를 처리하고, 이메일에 객체를 삽입하는 등입니다.

기능

이메일 메시지 파일 형식 기능

EML, MSG 및 MHTML 형식의 이메일 메시지를 지원합니다.
새 메시지를 생성합니다.
기존 메시지를 수정하고 제목, 보낸 사람, 수신자, 본문, 첨부 파일 등 내용을 업데이트합니다.
기존 메시지를 로드하고 제목, 첨부 파일, 보낸 사람, 수신자 등 메시지 내용을 가져옵니다.
이메일 메시지에서 첨부 파일을 관리(추가/제거)합니다.
HTML 형식의 이메일 메시지를 생성합니다.
임시 보관 모드로 메시지를 생성합니다(MSG 전용).
중첩된 이메일 메시지 첨부 파일을 읽습니다.
지원되는 모든 형식 간에 메시지를 변환합니다.

MSG 파일 기능

처음부터 새로운 MSG 문서를 생성합니다.
기존 MSG 문서를 엽니다.
MSG 내용을 액세스합니다.
기존 MSG 문서를 수정합니다.
다수의 수신자를 검색합니다.
MSG 문서와 연결된 MAPI 속성에 액세스합니다.
MSG 문서에서 첨부 파일을 구문 분석합니다.
첨부 파일을 디스크에 저장합니다.

PST/OST 파일 기능

디스크에서 Outlook PST 파일을 로드하고 모든 폴더에 대한 정보를 가져옵니다(Unicode 형식만 지원).
PST 파일의 모든 폴더에서 메시지 정보를 가져옵니다(예: 제목, 보낸 사람, 첨부 파일 등).
PST 파일에서 메시지를 추출하여 MSG 형식으로 디스크에 저장합니다.
PST 파일에서 연락처 정보를 읽고 MSG 형식으로 디스크에 저장합니다.
OST 파일 형식 읽기/조작 지원(현 시점에서는 OST 형식 생성이 지원되지 않음)

Java: 지원되는 파일 형식

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

|형식|설명|로드|저장| | :- | :- | :- | :- | |MSG|이 형식은 Microsoft Outlook 및 Exchange에서 이메일 메시지, 연락처, 일정 또는 기타 작업을 저장하는 데 사용됩니다.| | | |PST|이 형식은 Outlook 개인 저장 파일을 나타내며, 이메일, 캘린더 항목, 메모, 연락처 및 여러 다른 파일 형식을 저장합니다. 오프라인 이메일 데이터 보관에 사용됩니다.| | | |OST|Microsoft Outlook을 사용해 Exchange Server에 등록된 후 로컬 컴퓨터에서 오프라인 모드로 사용자의 메일함 데이터를 나타냅니다.| | | |OFT|Microsoft Outlook에서 만든 메시지 템플릿 파일입니다.| | | |OLM|이 형식은 Microsoft Outlook for Mac에서 이메일 메시지, 연락처, 저널, 캘린더 데이터 및 기타 사용자 응용 프로그램 데이터를 저장하는 데 사용됩니다.| | | |EML|Outlook 및 기타 관련 애플리케이션을 사용해 저장된 이메일 메시지를 나타냅니다.| | | |EMLX|Apple Mail이 이 형식으로 이메일을 내보냅니다.| | | |MBOX|전자 메일 메시지 컬렉션을 담는 컨테이너를 나타냅니다.| | | |ICS|iCalendar 형식은 일정 이벤트 및 스케줄링을 교환하고 배포하는 데 사용됩니다.| | | |VCF|Virtual Card Format은 연락처 정보를 저장하는 디지털 파일 형식입니다.| | | |HTML|HTML(HyperText Markup Language)은 브라우저에 표시되는 웹 페이지의 확장자입니다.| | | |MHTML|HTML 코드와 관련 리소스를 하나의 파일에 저장하는 웹 페이지 아카이브 형식입니다.| | |

Java: 기능

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

Java: 시스템 요구 사항

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

Aspose.Email for Java는 Microsoft Outlook이 설치되어 있을 필요가 없으며, Aspose.Email 자체가 Microsoft Outlook 문서 생성, 변환 및 조작 라이브러리이기 때문입니다.

지원되는 운영 체제

Aspose.Email for Java는 Java 런타임이 실행되는 모든 운영 체제를 지원하며, 여기에는 다음이 포함됩니다(이에 국한되지 않음):

Windows

Microsoft Windows 2003 Server
Microsoft Windows 2008 Server
Microsoft Windows 2012 Server
Microsoft Windows XP
Microsoft Windows Vista
Microsoft Windows 7
Microsoft Windows 8, 8.1
Microsoft Windows 10

Linux

Linux (Ubuntu, openSUSE, CentOS 등)

Mac

Mac OS X 등.

지원되는 Java 버전

Aspose.Email for Java는 다음 Java 버전을 지원합니다:

J2SE 6.0 (1.6)
J2SE 7.0 (1.7)
J2SE 8.0 (1.8)
이상

Java: 설치

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

Maven 저장소에서 Aspose.Email for Java 설치

Aspose는 모든 Java API를 다음에 호스팅합니다 Aspose Artifactory. 쉽게 사용할 수 있습니다 Aspose.Email for Java 간단한 구성으로 Maven 프로젝트에 API를 직접 사용합니다.

Maven 저장소 구성 지정

먼저, Maven pom.xml에 Aspose Maven 저장소 구성/위치를 다음과 같이 지정해야 합니다:


 <repositories>

    <repository>

        <id>AsposeJavaAPI</id>

        <name>Aspose Java API</name>

        <url>https://releases.aspose.com/java/repo/</url>

    </repository>

</repositories>

Aspose.Email for Java API 의존성 정의

그 다음, pom.xml에 Aspose.Email for Java API 의존성을 다음과 같이 정의합니다:


 <dependencies>

    <dependency>

        <groupId>com.aspose</groupId>

        <artifactId>aspose-email</artifactId>

        <version>19.12</version>

        <classifier>jdk16</classifier>

 </dependency>

</dependencies>

위 단계들을 수행한 후, Aspose.Email for Java 의존성이 Maven 프로젝트에 정의됩니다.

Java: 라이선스

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

Java용 Aspose.Email 평가판을 다운로드 페이지에서 다운로드할 수 있습니다. 평가판은 제품의 정식 라이선스 버전과 동일한 기능을 제공합니다. 또한 라이선스를 구매하고 몇 줄의 코드를 추가하여 라이선스를 적용하면 평가판이 정식 라이선스로 전환됩니다.

Aspose.Email 평가에 만족하면 Aspose 웹사이트에서 라이선스를 구매할 수 있습니다. 제공되는 다양한 구독 유형을 숙지하십시오. 질문이 있으면 언제든지 Aspose 영업팀에 문의하십시오.

모든 Aspose 라이선스에는 1년 구독이 포함되어 있어 해당 기간 동안 출시되는 모든 새 버전 및 수정에 대한 무료 업그레이드를 받을 수 있습니다. 기술 지원은 무료이며 무제한으로 제공되며, 라이선스 사용자와 평가 사용자 모두에게 제공됩니다.

평가판 제한 없이 Aspose.Email을 테스트하려면 30일 임시 라이선스를 요청하십시오. 자세한 내용은 임시 라이선스를 받는 방법은? 자세한 내용은.

평가 버전 제한

라이선스를 지정하지 않은 Aspose.Email 평가 버전은 전체 제품 기능을 제공하지만, Aspose.Email.Mail, Aspose.Email.Pop3, Aspose.Email.Imap 등 일부 구성 요소에는 평가 제한이 있습니다.

License.txt 파일이 Aspose.Email을 사용해 저장된 메시지 파일에 추가됩니다.
PST 파일의 폴더에서 추출할 수 있는 이메일은 최대 50개입니다.
MSG 파일에서 추출할 수 있는 첨부 파일 및 인라인 이미지는 최대 3개입니다.
CFB 형식에서 처리할 수 있는 첨부 파일 수는 최대 1개입니다.
CFB 형식에서 처리할 수 있는 수신자 수는 최대 1명입니다.
CFB, EML 또는 MSG 형식으로 저장할 때 제목에 "Evaluation Message"를 추가합니다.
GenerateOccurrences 메서드의 재발 패턴에서 종료 날짜는 2004년 12월 31일 이후로 설정할 수 없습니다. 이는 제품을 의미 있게 테스트할 수 있게 해 주지만, 실제 애플리케이션에서는 사용할 수 없습니다. 예를 들어 "2000년 1월 1일 시작, 매달 마지막 영업일마다 반복"과 같은 패턴을 만들고 발생을 생성할 수 있습니다. 평가 모드에서는 2004년 12월 31일 이후의 발생은 생성되지 않습니다.
XPS 또는 TIFF 형식으로 저장할 때 "Evaluation Watermark Image"를 추가합니다.
MS Exchange Server가 해결할 수 있는 모호한 이메일 주소 및 표시 이름의 최대 수는 20개입니다.
FileDropPanel로 끌어다 놓을 수 있는 데이터 파일 최대 길이는 51200 바이트입니다.
FileDropPanel에서 사용되는 끌어다 놓기 작업 중에 "Evaluation Message"가 포함된 메시지 박스를 표시합니다.
InlineAttachmentExtractor.EnumerateMsoPackage 메서드에 의해 주어진 MSO 스트림에서 파일 1개만 추출됩니다.

라이선스 설정

라이선스는 제품명, 라이선스 대상 개발자 수, 구독 만료일 등 상세 정보를 포함한 일반 텍스트 XML 파일입니다. 파일은 디지털 서명되어 있으므로 수정해서는 안 됩니다; 파일에 불필요한 줄바꿈을 추가하면 무효화됩니다.

평가 제한을 피하려면 라이선스를 적용해야 합니다. 애플리케이션이나 프로세스당 한 번만 라이선스를 설정하면 됩니다.

라이선스는 다음 위치의 스트림 또는 파일에서 로드할 수 있습니다:

명시적 경로.
Aspose.Email.jar가 포함된 폴더.

License.setLicense 메서드를 사용하여 구성 요소에 라이선스를 적용합니다. 가장 쉬운 방법은 라이선스 파일을 Aspose.Email.jar와 같은 폴더에 두고 경로 없이 파일 이름만 지정하는 것입니다. 아래 예시와 같이:

파일에서 라이선스 설정

이 예제에서 Aspose.Email은 애플리케이션의 JAR 파일이 포함된 폴더에서 라이선스 파일을 찾으려고 시도합니다.

스트림에서 라이선스 설정

스트림에서 라이선스를 초기화합니다.

계량 라이선스 적용

Aspose.Email는 개발자가 메터링 키를 적용하도록 허용합니다. 이는 새로운 라이선스 메커니즘이며 기존 라이선스 방식과 함께 사용됩니다. API 기능 사용량에 따라 청구를 원하시는 고객은 메터링 라이선스를 사용할 수 있습니다. 자세한 내용은 다음을 참고하십시오 Metered 라이선스 FAQ 섹션.

Metered라는 새로운 클래스가 도입되어 메터링 키를 적용할 수 있습니다. 아래는 메터링 공개 및 비공개 키를 설정하는 예제 코드입니다.

라이선스 파일을 포함한 임베디드

라이선스 검증

라이선스가 올바르게 설정되었는지 여부를 검증할 수 있습니다. The 라이선스 클래스에는 라이선스가 올바르게 설정된 경우 true를 반환하는 isLicensed 필드가 있습니다.

Java


 License license = new License();

license.setLicense("Aspose.Email.Java.lic");

if (License.isLicensed()) {

    System.out.println("License is Set!");

}

Java: 예제 실행 방법

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

GitHub에서 다운로드

Aspose.Email for Java의 모든 예제는 다음에 호스팅됩니다 Github. 리포지토리를 좋아하는 Github 클라이언트로 클론하거나 ZIP 파일을 다음에서 다운로드할 수 있습니다 여기.

ZIP 파일의 내용을 컴퓨터의 원하는 폴더에 압축 해제하세요. 모든 예제는 Examples 폴더에 있습니다.

이 프로젝트는 Maven 빌드 시스템을 사용합니다. 최신 IDE라면 프로젝트와 종속성을 쉽게 열거나 가져올 수 있습니다. 아래에서는 일반적인 IDE를 사용해 예제를 빌드하고 실행하는 방법을 보여드립니다.

IntelliJ IDEA

File 메뉴를 클릭하고 Open을 선택합니다. 프로젝트 폴더로 이동하여 pom.xml 파일을 선택하세요.

프로젝트를 열고 종속성을 자동으로 다운로드합니다. Project 탭에서 src/main/java 폴더의 예제를 둘러보세요. 예제를 실행하려면 파일을 마우스 오른쪽 버튼으로 클릭하고 "Run .."를 선택하면 예제가 실행되고 출력이 내장 콘솔 출력 창에 표시됩니다.

Eclipse

File 메뉴를 클릭하고 Import를 선택합니다. Maven - Existing Maven Projects를 선택하세요.

GitHub에서 복제하거나 다운로드한 폴더를 찾아 pom.xml 파일을 선택합니다.

프로젝트가 열리고 의존성이 자동으로 다운로드됩니다. Package Explorer 탭에서 src/main/java 폴더의 예제를 찾아보세요. 예제를 실행하려면 파일을 오른쪽 클릭하고 Run As - Java Application을 선택하면 실행되고 결과가 내장 콘솔 출력 창에 표시됩니다.

NetBeans

File 메뉴를 클릭하고 Open Project를 선택합니다. GitHub에서 복제하거나 다운로드한 폴더를 찾아보세요. Examples 폴더 아이콘이 Maven 프로젝트임을 나타냅니다. Examples를 선택하고 엽니다.

프로젝트가 열리고 의존성이 자동으로 다운로드됩니다. 프로젝트 탭에서 source packages에 있는 예제를 찾아보세요. 예제를 실행하려면 파일을 오른쪽 클릭하고 Run File을 선택하면 실행되며 결과가 내장 콘솔 출력 창에 표시됩니다.

기여

예제를 추가하거나 개선하고 싶다면 프로젝트에 기여하시길 권장합니다. 이 저장소의 모든 예제와 쇼케이스 프로젝트는 오픈 소스이며 자유롭게 자신의 애플리케이션에서 사용할 수 있습니다.

기여하려면 저장소를 포크하고, 소스 코드를 편집한 뒤 풀 리퀘스트를 생성하세요. 변경 사항을 검토하여 유용하다고 판단되면 저장소에 포함하겠습니다.

Java: 기술 지원

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

Aspose는 모든 제품에 대해 무제한 무료 기술 지원을 제공합니다. 지원은 평가를 포함한 모든 사용자가 이용할 수 있습니다.

도움이 필요하면, Aspose.Forums 방문. Aspose.Email for Java 포럼에 질문을 게시하면 몇 시간 내에 답변을 받을 수 있습니다.

포럼에서 답변을 기대할 경우, 시간대 차이를 고려해 주세요.

이슈 보고

문제가 있는 경우, 효율적으로 해결하기 위해 다음 간단한 단계를 따르세요:

이슈를 보고하기 전에 제품 최신 버전을 사용하고 있는지 확인하십시오. 다음을 참고하세요 Aspose.Email for Java 다운로드 페이지 최신 버전에 대해 알아보세요.
다음 내용을 살펴보세요 포럼, 이 문서 위키 및 API 레퍼런스 이슈를 보고하기 전에 확인하십시오. 귀하의 질문에 이미 답변이 있을 수 있습니다.
이슈를 보고할 때 원본 문서와 문제를 일으키는 코드 조각을 포함해 주세요. 여러 파일을 첨부해야 하면 하나의 zip 파일로 압축하십시오. 포럼에 문서를 첨부해도 안전합니다. 첨부 파일에 접근할 수 있는 사람은 귀하와 Aspose 개발자뿐이기 때문입니다.
스레드당 하나의 이슈만 보고해 주세요. 다른 문제가 있으면 별도의 스레드에 보고하십시오.

Aspose는 전화 기술 지원을 제공하지 않으며, 전화 지원은 판매 및 구매 문의에만 한정됩니다.

Java: 리소스

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

이 표에는 Aspose.Email for Java의 주요 기술 리소스가 나열되어 있습니다.

Java: Aspose.Email 평가

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

평가용으로 Aspose.Email for Java를 무료로 다운로드할 수 있습니다. 평가 버전은 일부 제한이 있지만 제품의 거의 모든 기능을 제공합니다. 라이선스를 구매하고 몇 줄의 코드를 추가하면 동일한 평가 버전이 정식 라이선스로 전환됩니다. 라이선스 적용.

제한 없는 평가 버전으로 Aspose.Email을 테스트하려면 30일 임시 라이선스를 요청하세요. 자세한 내용은 임시 라이선스를 받는 방법은?

평가 버전 제한

라이선스가 지정되지 않은 Aspose.Email 평가 버전은 전체 제품 기능을 제공하지만, 일부 구성 요소(Aspose.Email.Mail, Aspose.Email.Pop3, Aspose.Email.Ftp 및 Aspose.Email.Imap)는 평가 제한이 있습니다:

Aspose.Email를 사용해 저장한 메시지 파일에 License.txt 파일이 추가됩니다.
PST 파일의 폴더에서 최대 50개의 이메일만 추출할 수 있습니다.
MSG 파일에서 최대 3개의 첨부 파일과 인라인 이미지만 추출할 수 있습니다.
CFB 형식에서 처리 가능한 최대 첨부 파일 수는 1개입니다.
CFB 형식에서 처리 가능한 최대 수신자 수는 1명입니다.
CFB, EML 또는 MSG 형식으로 저장할 때 제목에 "Evaluation Message"를 추가합니다.
GenerateOccurrences 메서드의 반복 패턴에서 종료 날짜를 2004-12-31 이후로 설정할 수 없습니다. 이는 제품을 의미 있게 테스트할 수 있게 하지만, 실제 애플리케이션에서는 사용할 수 없게 합니다. 예를 들어 "2000년 1월 1일 시작, 매달 마지막 근무일마다 반복"과 같은 패턴을 만들고 발생을 생성할 수 있습니다. 평가 모드에서는 2004년 12월 31일 이후의 발생은 생성되지 않습니다.
InlineAttachmentExtractor.EnumerateMsoPackage 메서드로 주어진 MSO 스트림에서 오직 1개의 파일만 추출됩니다.

저장된 메시지에 삽입된 평가 표시