Documentation – Outlook 저장소 파일 작업

Java: 새 PST 생성, 하위 폴더 및 메시지 추가

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

기존 PST 파일을 구문 분석하는 것뿐만 아니라, Aspose.Email은 처음부터 PST 파일을 생성할 수 있는 방법을 제공합니다. 이 문서에서는 Outlook PST 파일을 만들고 그에 하위 폴더를 추가하는 방법을 보여줍니다.

다음 사용 PersonalStorage 클래스를 사용해 로컬 디스크의 특정 위치에 PST 파일을 생성합니다. 처음부터 PST 파일을 만들려면:

다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
Root 폴더에 접근한 뒤 호출하여 PST 파일 루트에 하위 폴더를 추가합니다. addSubFolder() 메서드.

다음 코드 스니펫은 PST 파일을 생성하고 Inbox라는 하위 폴더를 추가하는 방법을 보여줍니다.

// Create new PST
try (PersonalStorage pst = PersonalStorage.create(path, FileFormatVersion.Unicode)) {
    // Add new folder "Test"
    pst.getRootFolder().addSubFolder("Inbox");
}

OutputStream을 사용하여 2GB 초과 PST 만들기

Aspose.Email 사용자는 PersonalStorage 생성자를 사용해 PST 내부 캐시를 최적화할 수 있습니다:

blockSize - 캐시 버퍼를 확장하기 위한 최적 블록 크기(바이트).

PersonalStorage create(OutputStream stream, int blockSize, /*FileFormatVersion*/int version)

메시지 크기 및 생성된 PST 파일 크기 감소

Aspose.Email은 본문 콘텐츠를 압축하는 기능을 제공하여 메시지 크기를 줄이는 데 도움이 됩니다. 이는 큰 메시지를 전송하거나 제한된 대역폭·스토리지 환경에서 특히 유용합니다. 이를 위해 라이브러리는 다음 메서드에 포함된 compression 매개변수를 제공합니다:

MapiMessageItemBase.setBodyContent(String content, /BodyContentType/int contentType, boolean compression) - 본문의 내용을 설정합니다.
MapiMessageItemBase.setBodyRtf(String content, boolean compression) - RTF 형식의 메시지 텍스트를 가져오거나 설정합니다.

아래 코드 스니펫은 MAPI 메시지 본문을 설정하면서 RTF 압축을 사용하는 방법을 보여줍니다:

MapiMessage msg = new MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
// set the html body and keep it compressed
// this will reduce the message size
msg.setBodyContent(htmlBody, BodyContentType.Html, true);

SeekableByteChannel 스트림 기반 PersonalStorage 생성

Aspose.Email for Java를 사용하면 java.nio.channels를 이용해 개인 저장소(PST) 파일을 작업할 수 있습니다. SeekableByteChannel 스트림을 사용하여 PersonalStorage 인스턴스를 생성할 수 있습니다. 다음 코드 스니펫은 FileChannel 스트림을 기반으로 PersonalStorage 인스턴스를 만들고, 루트 폴더에 "messageFolder"라는 하위 폴더를 추가한 뒤, "messageFolder" 디렉터리의 파일에서 메시지를 가져오는 방법을 보여줍니다:

try (RandomAccessFile raf = new RandomAccessFile("test.pst", "rw")) {
    FileChannel channel = raf.getChannel();
    try (PersonalStorage pst = PersonalStorage.create(channel, FileFormatVersion.Unicode)) {
        FolderInfo messageFolder = pst.getRootFolder().addSubFolder("messageFolder");

        for (File f : new File("messageFolder").listFiles()) {
            messageFolder.addMessage(MapiMessage.load(f.getAbsolutePath()));
        }
    }
}

폴더 컨테이너 클래스 변경

때때로 폴더 클래스를 변경해야 할 필요가 있습니다. 일반적인 예로 서로 다른 유형(약속, 메시지 등)의 메시지를 동일한 폴더에 추가하는 경우가 있습니다. 이러한 경우 폴더에 있는 모든 요소가 올바르게 표시되도록 폴더 클래스를 변경해야 합니다. 아래 코드 스니펫은 이 목적을 위해 PST에서 폴더의 컨테이너 클래스를 변경하는 방법을 보여줍니다.

try (PersonalStorage pst = PersonalStorage.fromFile("PersonalStorage1.pst")) {
    FolderInfo folder = pst.getRootFolder().getSubFolder("Inbox");

    folder.changeContainerClass("IPF.Note");
}

성능 향상을 위한 일괄 메시지 추가

PST에 개별 메시지를 추가하면 디스크 I/O가 증가하여 성능이 저하될 수 있습니다. 성능 향상을 위해 메시지를 일괄 모드로 PST에 추가하면 I/O 작업을 최소화할 수 있습니다. addMessages(Iterable messages) 메서드를 사용하면 메시지를 일괄 추가할 수 있으며 다음 시나리오에서 사용할 수 있습니다. 또한, MessageAdded 폴더에 메시지가 추가될 때 발생하는 이벤트.

다른 PST에서 메시지 추가

다른 PST에서 메시지를 추가하려면, 다음을 사용합니다: FolderInfo.enumerateMapiMessages() 값을 반환하는 메서드 Iterable<MapiMessage>:

try (PersonalStorage srcPst = PersonalStorage.fromFile("source.pst", false)) {
    try (PersonalStorage destPst = PersonalStorage.fromFile("destination.pst")) {

        // Get the folder by name
        FolderInfo srcFolder = srcPst.getRootFolder().getSubFolder("SomeFolder");
        FolderInfo destFolder = destPst.getRootFolder().getSubFolder("SomeFolder");

        destFolder.MessageAdded.add(new MessageAddedEventHandler() {
            // Handles the MessageAdded event.
            public void invoke(Object sender, MessageAddedEventArgs e) {
                System.out.println("Added: " + e.getEntryId());
            }
        });
        destFolder.addMessages(srcFolder.enumerateMapiMessages());
    }
}

디렉터리에서 메시지 추가

디렉터리에서 메시지를 추가하려면, 다음을 생성합니다: getMessages(String pathToDir) 값을 반환하는 메서드 Iterable<MapiMessage>:

// Read messages from directory.
static Iterable<MapiMessage> getMessages (String pathToDir)
{
    return Arrays.stream(listDirectory(pathToDir, "*.msg"))
            .map(MapiMessage::load).collect(Collectors.toList());
}

try ( PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {
    FolderInfo folder = pst.getRootFolder().getSubFolder("SomeFolder");
    folder.MessageAdded.add(new MessageAddedEventHandler() {
        // Handles the MessageAdded event.
        public void invoke(Object sender, MessageAddedEventArgs e) {
            System.out.println("Added: " + e.getEntryId());
        }
    });
    folder.addMessages(getMessages("MessageDirectory"));
}

Java: Outlook OST 파일 읽기 및 변환

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

Aspose.Email는 Microsoft Outlook OST 파일을 읽기 위한 API를 제공합니다. 디스크 또는 스트림에서 OST 파일을 로드하여 인스턴스로 만들 수 있습니다. PersonalStorage 클래스 및 해당 내용에 대한 정보를 얻습니다(예: 폴더, 하위 폴더, 메시지). Microsoft Outlook은 POP3 또는 IMAP 메일 서버를 사용해 메시지를 다운로드할 때 이메일을 저장하기 위해 PST 파일을 생성합니다. Microsoft Exchange가 메일 서버인 경우에는 OST 파일을 생성합니다. OST는 PST 파일보다 더 큰 파일 크기를 지원합니다.

OST 파일 읽기

Aspose.Email를 사용해 OST 파일을 읽는 과정은 PST 파일을 읽는 것과 정확히 동일합니다. 동일한 코드로 PST와 OST 파일 모두를 읽을 수 있습니다: 올바른 파일 이름을 제공하기만 하면 됩니다. PersonalStorage.fromFile() 방법. 다음 코드 스니펫은 OST 파일을 읽는 방법을 보여줍니다.

OST를 PST로 변환

사용해 보세요!

무료로 이메일 및 메시지 아카이브를 온라인에서 변환하세요 Aspose.Email 변환 앱.

Aspose.Email를 사용하면 한 줄의 코드로 OST 파일을 PST로 변환할 수 있습니다. 마찬가지로 동일한 한 줄의 코드를 사용해 PST 파일에서 OST 파일을 생성할 수 있습니다. FileFormat 열거자. 현재 API는 OST 2013/2016을 제외한 OST 형식을 PST로 변환하는 것을 지원합니다. 다음 코드 스니펫은 OST를 PST로 변환하는 방법을 보여줍니다.

OST 파일에 대한 다른 작업을 수행하려면 다음 페이지를 참고하십시오:

PST를 OST로 변환

Aspose.Email에서는 PST를 OST로 변환하는 것을 지원하지 않습니다. OST는 계정을 추가하고 메일 서버와 동기화할 때 Outlook에 의해 항상 생성되기 때문입니다. PST와 OST 파일의 차이는 PST는 로컬에만 존재하고, OST 내용은 이메일 서버에도 존재한다는 점입니다. 따라서 로컬 용도로 PST를 OST로 변환할 필요가 없습니다. 대신 Outlook의 가져오기/내보내기 마법사를 사용해 PST를 기존 계정으로 가져올 수 있습니다.

Java: PST 파일에서 메시지 작업

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

PST 파일에 메시지 추가

새 PST 파일을 만들고 하위 폴더 추가 PST 파일을 만들고 하위 폴더를 추가하는 방법을 보여주었습니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 하위 폴더에 메시지를 추가할 수 있습니다. 이 문서에서는 디스크에서 두 개의 메시지를 PST의 Inbox 하위 폴더에 추가합니다. Use the PersonalStorage 및 FolderInfo PST 파일에 메시지를 추가하기 위한 클래스들. PST 파일의 Inbox 폴더에 메시지를 추가하려면:

FolderInfo 클래스의 인스턴스를 생성하고 Inbox 폴더의 내용을 로드합니다.
디스크에서 Inbox 폴더로 메시지를 추가하려면 다음을 호출합니다 FolderInfo.addMessage() 메서드. FolderInfo 클래스는 다음을 노출합니다 addMessages 폴더에 다수의 메시지를 추가할 수 있게 해 주는 메서드로, 디스크에 대한 I/O 작업을 줄이고 성능을 향상시킵니다. 전체 예제는 아래에서 찾을 수 있습니다, in 대량 메시지 추가.

아래 코드 스니펫은 Inbox라는 PST 하위 폴더에 메시지를 추가하는 방법을 보여줍니다.

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

// Create new PST
PersonalStorage personalStorage = PersonalStorage.create(dataDir, FileFormatVersion.Unicode);

// Add new folder "Inbox"
personalStorage.getRootFolder().addSubFolder("Inbox");

// Select the "Inbox" folder
FolderInfo inboxFolder = personalStorage.getRootFolder().getSubFolder("Inbox");

// Add some messages to "Inbox" folder
inboxFolder.addMessage(MapiMessage.fromFile(dataDir + "MapiMsgWithPoll.msg"));

대량 메시지 추가

PST에 개별 메시지를 추가하면 디스크에 대한 I/O 작업이 늘어나 성능이 저하될 수 있습니다. 향상된 성능을 위해 메시지를 일괄 모드로 PST에 추가하여 I/O 작업을 최소화할 수 있습니다. The addMessages(Iterable messages) 이 메서드는 향상된 성능을 위해 PST에 추가될 메시지 범위를 정의할 수 있게 해 주며, 다음 시나리오에서 사용할 수 있습니다. 또한, 메시지가 폴더에 추가될 때 MessageAdded 이벤트가 발생합니다.

디스크에서 메시지 로드

다음 코드 스니펫은 디스크에서 메시지를 로드하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
private static void addMessagesInBulkMode(String fileName, String msgFolderName) {
    try (PersonalStorage personalStorage = PersonalStorage.fromFile(fileName)) {
        FolderInfo folder = personalStorage.getRootFolder().getSubFolder("myInbox");
        folder.MessageAdded.add(new MessageAddedEventHandler() {
            public void invoke(Object sender, MessageAddedEventArgs e) {
                onMessageAdded(sender, e);
            }
        });
        folder.addMessages(new MapiMessageCollection(msgFolderName));
    }
}

static void onMessageAdded(Object sender, MessageAddedEventArgs e) {
    System.out.println(e.getEntryId());
    System.out.println(e.getMessage().getSubject());
}

Iterable 구현

다음 코드 스니펫은 Iterable 구현을 만드는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public class MapiMessageCollection implements Iterable<MapiMessage> {

    private final File folder;

    public MapiMessageCollection(String folder) {
        this.folder = new File(folder);
    }

    public Iterator<MapiMessage> iterator() {
        return new MapiMessageIterator(folder.listFiles());
    }
}

public class MapiMessageIterator implements Iterator<MapiMessage> {

    private Queue<String> queue = new LinkedList<String>();

    public MapiMessageIterator(File[] listOfFiles) {
        for (File file : listOfFiles) {
            queue.offer(file.getAbsolutePath());
        }
    }

    public boolean hasNext() {
        return !queue.isEmpty();
    }

    public MapiMessage next() {
        return MapiMessage.fromFile(queue.poll());
    }
}

다른 PST에서 메시지 추가

다른 PST에서 메시지를 추가하려면 다음을 사용하십시오: FolderInfo.enumerateMapiMessages() Iterable를 반환하는 메서드입니다. 다음 코드 조각은 다른 PST에서 메시지를 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
private static void bulkAddFromAnotherPst(String source) {
    // The path to the File directory.
    String dataDir = "data/";

    try (PersonalStorage pst = PersonalStorage.fromFile(source, false)) {
        try (PersonalStorage pstDest = PersonalStorage.fromFile(dataDir + "PersonalStorageFile1.pst")) {
            // Get the folder by name
            FolderInfo folderInfo = pst.getRootFolder().getSubFolder("Contacts");
            MessageInfoCollection ms = folderInfo.getContents();

            // Get the folder by name
            FolderInfo f = pstDest.getRootFolder().getSubFolder("myInbox");
            f.MessageAdded.add(new MessageAddedEventHandler() {
                public void invoke(Object sender, MessageAddedEventArgs e) {
                    onMessageAdded(sender, e);
                }
            });
            f.addMessages(folderInfo.enumerateMapiMessages());
            FolderInfo fi = pstDest.getRootFolder().getSubFolder("myInbox");
            MessageInfoCollection msgs = fi.getContents();
        }
    }
}

// Handles the MessageAdded event.
static void onMessageAdded(Object sender, MessageAddedEventArgs e) {
    System.out.println(e.getEntryId());
    System.out.println(e.getMessage().getSubject());
}

Outlook PST 파일에서 메시지 정보 가져오기

에서 Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보 가져오기, Outlook PST 파일을 로드하고 폴더를 탐색하여 폴더 이름 및 메시지 수를 가져오는 방법을 논의했습니다. 이 문서는 PST 파일의 모든 폴더와 하위 폴더를 읽고 메시지 정보(예: 제목, 발신자, 수신자)를 표시하는 방법을 설명합니다. FolderInfo.getContents() 메서드는 표시하는 데 사용됩니다 간단한 메시지 정보 제목, 발신자, 수신자와 같은 정보를. 성능 측면에서 이는 메시지 기본 정보를 얻기에 가장 적합한 옵션입니다. 추출 전체 메시지 데이터, PersonalStorage.extractMessage() 메서드가 제공됩니다. Outlook PST 파일에는 중첩 폴더가 포함될 수 있습니다. 이러한 폴더와 최상위 폴더의 메시지 정보를 얻으려면 재귀 메서드를 사용하여 모든 폴더를 읽으십시오. 다음 코드 조각은 Outlook PST 파일을 읽고 폴더 및 메시지 내용을 재귀적으로 표시하는 방법을 보여줍니다.

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

    // Load the Outlook file
    String path = dataDir + "PersonalStorage.pst";

    try {

        // Load the Outlook PST file
        PersonalStorage personalStorage = PersonalStorage.fromFile(path);

        // Get the Display Format of the PST file
        System.out.println("Display Format: " + personalStorage.getFormat());

        // Get the folders and messages information
        FolderInfo folderInfo = personalStorage.getRootFolder();

        // Call the recursive method to display the folder contents
        displayFolderContents(folderInfo, personalStorage);
    } catch (Exception ex) {
        System.out.println(ex.getMessage());
    }
}

// This is a recursive method to display contents of a folder
private static void displayFolderContents(FolderInfo folderInfo, PersonalStorage pst) {
    // Display the folder name
    System.out.println("Folder: " + folderInfo.getDisplayName());
    System.out.println("==================================");
    // Display information about messages inside this folder
    MessageInfoCollection messageInfoCollection = folderInfo.getContents();
    for (MessageInfo messageInfo : messageInfoCollection) {
        System.out.println("Subject: " + messageInfo.getSubject());
        System.out.println("Sender: " + messageInfo.getSenderRepresentativeName());
        System.out.println("Recipients: " + messageInfo.getDisplayTo());
        System.out.println("------------------------------");
    }

    // Call this method recursively for each subfolder
    if (folderInfo.hasSubFolders() == true) {
        for (FolderInfo subfolderInfo : folderInfo.getSubFolders()) {
            displayFolderContents(subfolderInfo, pst);
        }
    }
}

PST 파일에서 메시지 추출

이 문서는 Microsoft Outlook PST 파일을 읽는 방법과 메시지 추출. 그런 다음 메시지를 MSG 형식으로 디스크에 저장합니다. 이 문서는 또한 다음 방법을 보여줍니다 특정 개수의 메시지를 추출합니다 PST 파일에서. 모든 폴더(중첩 폴더 포함)를 탐색하는 재귀 메서드를 사용하고 다음을 호출합니다: PersonalStorage.extractMessage() Outlook 메시지를 해당 클래스 인스턴스로 가져오는 메서드 MapiMessage 클래스. 이후에 다음을 호출합니다: MapiMessage.save() MSG 형식으로 메시지를 디스크 또는 스트림에 저장하는 메서드입니다. 다음 코드 조각은 PST 파일에서 메시지를 추출하는 방법을 보여줍니다.

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

    // Load the Outlook file
    String path = dataDir + "PersonalStorage.pst";

    try {
        // load the Outlook PST file
        PersonalStorage pst = PersonalStorage.fromFile(path);

        // get the Display Format of the PST file
        System.out.println("Display Format: " + pst.getFormat());

        // get the folders and messages information
        FolderInfo folderInfo = pst.getRootFolder();

        // Call the recursive method to extract msg files from each folder
        extractMsgFiles(folderInfo, pst);
    } catch (Exception ex) {
        System.out.println(ex.getMessage());
    }
}

// This is a recursive method to display contents of a folder
private static void extractMsgFiles(FolderInfo folderInfo, PersonalStorage pst) {
    // display the folder name
    System.out.println("Folder: " + folderInfo.getDisplayName());
    System.out.println("==================================");
    // loop through all the messages in this folder
    MessageInfoCollection messageInfoCollection = folderInfo.getContents();
    for (MessageInfo messageInfo : messageInfoCollection) {
        System.out.println("Saving message {0} ...." + messageInfo.getSubject());
        // get the message in MapiMessage instance
        MapiMessage message = pst.extractMessage(messageInfo);
        // save this message to disk in msg format
        message.save(message.getSubject().replace(":", " ") + ".msg");
        // save this message to stream in msg format
        ByteArrayOutputStream messageStream = new ByteArrayOutputStream();
        message.save(messageStream);
    }

    // Call this method recursively for each subfolder
    if (folderInfo.hasSubFolders() == true) {
        for (FolderInfo subfolderInfo : folderInfo.getSubFolders()) {
            extractMsgFiles(subfolderInfo, pst);
        }
    }
}

PST에서 스트림으로 직접 메시지 저장

메시지의 MsgInfo를 추출하지 않고 PST 파일에서 직접 스트림으로 메시지를 저장하려면 다음을 사용합니다: saveMessageToStream() 메서드. 다음 코드 조각은 PST에서 직접 스트림으로 메시지를 저장하는 방법을 보여줍니다.

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

// Load the Outlook file
String path = dataDir + "PersonalStorage.pst";

// Save message to MemoryStream
try (PersonalStorage personalStorage = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");
    for (MessageInfo messageInfo : inbox.enumerateMessages()) {
        try (ByteArrayOutputStream memeorystream = new ByteArrayOutputStream()) {
            personalStorage.saveMessageToStream(messageInfo.getEntryIdString(), memeorystream);
        }
    }
}

// Save message to file
try (PersonalStorage pst = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = pst.getRootFolder().getSubFolder("Inbox");
    for (MessageInfo messageInfo : inbox.enumerateMessages()) {
        try (FileOutputStream fs = new FileOutputStream(new File(dataDir + messageInfo.getSubject() + ".msg"))) {
            pst.saveMessageToStream(messageInfo.getEntryIdString(), fs);
        }
    }
}

try (PersonalStorage pst = PersonalStorage.fromFile(path)) {
    FolderInfo inbox = pst.getRootFolder().getSubFolder("Inbox");

    // To enumerate entryId of messages you may use FolderInfo.EnumerateMessagesEntryId() method:
    for (String entryId : inbox.enumerateMessagesEntryId()) {
        try (ByteArrayOutputStream ms = new ByteArrayOutputStream()) {
            pst.saveMessageToStream(entryId, ms);
        }
    }
}

PST 파일에서 n개의 메시지 추출

다음 코드 조각은 PST에서 지정된 개수의 메시지를 추출하는 방법을 보여줍니다. 첫 번째 메시지의 인덱스와 추출할 메시지 총 개수를 제공하기만 하면 됩니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

// Extracts messages starting from 10th index top and extract total 100 messages
MessageInfoCollection messages = inbox.getContents(10, 100);

PST 파일에서 항목 총 수 가져오기

Aspose.Email은 다음을 제공합니다 GetTotalItemsCount() 메서드 PersonalStorage.Store 속성. PST에 포함된 메시지 항목의 총 수를 반환합니다.

다음 코드 샘플은 PST 파일에 저장된 항목(메시지, 일정, 연락처 등)의 총 개수를 검색하는 방법을 보여줍니다:

try (PersonalStorage pst = PersonalStorage.fromFile("my.pst", false)) {
    int count = pst.getStore().getTotalItemsCount();
}

PST 파일에서 항목 삭제

Add Messages to PST Files PST 파일에 메시지를 추가하는 방법을 보여주었습니다. 물론 PST 파일에서 항목(내용)을 삭제하는 것도 가능하며, 메시지를 일괄 삭제하는 것이 바람직할 수도 있습니다. PST 파일의 항목은 다음을 사용하여 삭제할 수 있습니다: FolderInfo.deleteChildItem() 메서드. API는 또한 제공합니다 FolderInfo.deleteChildItems() PST 파일에서 항목을 일괄 삭제하는 메서드입니다.

PST 파일에서 메시지 삭제

이 문서는 사용 방법을 보여줍니다 FolderInfo PST 파일의 특정 폴더에 접근하는 클래스입니다. 이전에 로드하거나 만든 PST 파일의 Sent 하위 폴더에서 메시지를 삭제하려면:

다음의 인스턴스를 생성합니다. FolderInfo 클래스와 Sent 하위 폴더의 내용을 로드합니다.
Sent 폴더의 메시지를 삭제하려면 호출합니다: FolderInfo.deleteChildItem() 메서드와 전달하는 MessageInfo.EntryId 매개변수로 사용됩니다. 다음 코드 조각은 PST 파일의 Sent 하위 폴더에서 메시지를 삭제하는 방법을 보여줍니다.

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

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir);

// Get the Sent items folder
FolderInfo folderInfo = personalStorage.getPredefinedFolder(StandardIpmFolder.SentItems);

MessageInfoCollection msgInfoColl = folderInfo.getContents();
for (MessageInfo msgInfo : msgInfoColl) {
    System.out.println(msgInfo.getSubject() + ": " + msgInfo.getEntryIdString());
    if (msgInfo.getSubject().equals("some delete condition")) {
        // Delete this item
        folderInfo.deleteChildItem(msgInfo.getEntryId());
        System.out.println("Deleted this message");
    }
}

PST 파일에서 폴더 삭제

PST 폴더를 삭제된 항목 폴더로 이동하여 삭제할 수 있습니다.

try (PersonalStorage pst = PersonalStorage.fromFile("test.pst")) {
    FolderInfo deletedItemsFolder = pst.getPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo emptyFolder = pst.getRootFolder().getSubFolder("Empty folder");
    FolderInfo someFolder = pst.getRootFolder().getSubFolder("Some folder");
    pst.moveItem(emptyFolder, deletedItemsFolder);
    pst.moveItem(someFolder, deletedItemsFolder);
}

이 방법의 장점은 삭제된 폴더를 쉽게 복구할 수 있다는 점입니다.

FolderInfo someFolder = deletedItemsFolder.getSubFolder("Some folder");
pst.moveItem(someFolder, pst.getRootFolder());

필요한 경우 삭제된 항목 폴더에서 폴더를 영구적으로 제거할 수도 있습니다.

deletedItemsFolder.deleteChildItem(emptyFolder.getEntryId());

다음은 deleteChildItem() 메서드는 삭제된 항목 폴더를 우회하여 하위 폴더를 즉시 영구 삭제하려는 경우 모든 폴더에 사용할 수 있습니다.

FolderInfo someFolder = pst.getRootFolder().getSubFolder("Some folder");
pst.getRootFolder().deleteChildItem(someFolder.getEntryId());

PST 파일에서 항목을 일괄 삭제

Aspose.Email API를 사용하여 PST 파일에서 항목을 일괄 삭제할 수 있습니다. 이는 다음을 사용하여 구현됩니다: deleteChildItems() 삭제할 항목을 가리키는 Entry ID 목록을 받는 메서드입니다. 다음 코드 조각은 PST 파일에서 항목을 일괄 삭제하는 방법을 보여줍니다.

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

try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir)) {
    // Get Inbox SubFolder from Outlook file
    FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

    // Create instance of PersonalStorageQueryBuilder
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();

    queryBuilder.getFrom().contains("someuser@domain.com");
    MessageInfoCollection messages = inbox.getContents(queryBuilder.getQuery());
    List<String> deleteList = new ArrayList<String>();
    for (MessageInfo messageInfo : messages) {
        deleteList.add(messageInfo.getEntryIdString());
    }

    // delete messages having From = "someuser@domain.com"
    inbox.deleteChildItems(deleteList);
}

PST에서 소프트 삭제된 메시지 열거 및 복구

Aspose.Email for Java를 사용하면 영구 삭제된 메시지를 검색할 수 있습니다. API를 통해 PST 파일에서 소프트 삭제된 메시지를 열거할 수 있습니다. 소프트 삭제된 항목은 두 번 삭제된 메시지로, 먼저 삭제된 항목 폴더로 이동된 후 다시 제거됩니다. 이러한 메시지는 여전히 복구 가능하며, Aspose.Email는 이를 접근하는 편리한 방법을 제공합니다. PersonalStorage.findAndEnumerateSoftDeletedItems() 메서드는 컬렉션을 반환합니다 RestoredItemEntry 객체. 각 항목은 다음을 포함합니다:

MapiMessage item — 복구된 메시지.
String FolderId - 원래 메시지가 속한 폴더의 식별자.

다음 코드 샘플은 PST 파일에서 소프트 삭제된(복구 가능한) 이메일 항목을 열거하는 방법을 보여줍니다:

// Load the PST file
try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    // Enumerate soft-deleted items
    for (RestoredItemEntry entry : pst.findAndEnumerateSoftDeletedItems()) {
        MapiMessage message = entry.getItem();
        String folderId = entry.getFolderId();
        
        System.out.println("Subject: " + message.getSubject());
        System.out.println("Deleted from Folder ID: " + folderId);
        System.out.println("-----------------------------------");
    }
}

기준에 따라 PST에서 메시지 및 폴더 검색

개인 저장소(PST) 파일은 방대한 데이터를 포함할 수 있으며, 이러한 대용량 파일에서 특정 기준을 만족하는 데이터를 검색하려면 정보를 필터링하기 위해 코드에 여러 체크 포인트를 포함해야 합니다. 이를 통해 PersonalStorageQueryBuilder 클래스, Aspose.Email를 사용하면 지정된 검색 기준에 따라 PST에서 특정 레코드를 검색할 수 있습니다. PST는 발신자, 수신자, 제목, 메시지 중요도, 첨부 파일 존재 여부, 메시지 크기, 심지어 메시지 ID와 같은 검색 매개변수를 기반으로 메시지를 검색할 수 있습니다. PersonalStorageQueryBuilder 하위 폴더 검색에도 사용할 수 있습니다.

PST에서 메시지 및 폴더 검색

다음 코드 스니펫은 사용 방법을 보여줍니다. PersonalStorageQueryBuilder 다양한 검색 기준에 따라 PST 내용 검색을 수행하는 클래스입니다. 예를 들어, 다음과 같이 PST를 검색하는 방법을 보여줍니다:

메시지 중요도.
메시지 클래스.
첨부 파일 존재 여부.
메시지 크기.
메시지 날짜.
읽지 않은 메시지.
첨부 파일이 있는 읽지 않은 메시지, 그리고
특정 하위 폴더 이름을 가진 폴더.

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

try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir + "Outlook.pst")) {
    FolderInfo folder = personalStorage.getRootFolder().getSubFolder("Inbox");
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();

    // High importance messages
    builder.getImportance().equals((int) MapiImportance.High);
    MessageInfoCollection messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with High Imp:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    builder.getMessageClass().equals("IPM.Note");
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with IPM.Note:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages with attachments AND high importance
    builder.getImportance().equals((int) MapiImportance.High);
    builder.hasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages with atts: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages with size > 15 KB
    builder.getMessageSize().greater(15000);
    messages = folder.getContents(builder.getQuery());
    System.out.println("messags size > 15Kb:" + messages.size());

    java.util.Calendar c = java.util.Calendar.getInstance();

    builder = new PersonalStorageQueryBuilder();
    // Messages by Current Date
    // (Note that queries by date are not supported for Calendar Items in the Appointments folder)
    builder.getSentDate().on(c.getTime(), DateComparisonType.ByDate);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages by Current Date: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Messages between Dates
    // (Note that queries by date are not supported for Calendar Items in the Appointments folder)
    c.set(2020,  0, 1, 0, 0, 0);
    builder.getSentDate().since(c.getTime());
    c.set(2021,  0, 1, 0, 0, 0);
    builder.getSentDate().before(c.getTime());
    messages = folder.getContents(builder.getQuery());
    System.out.println("Messages between Dates: " + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Unread:" + messages.size());

    builder = new PersonalStorageQueryBuilder();
    // Unread messages with attachments
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);
    builder.hasFlags(MapiMessageFlags.MSGFLAG_HASATTACH);
    messages = folder.getContents(builder.getQuery());
    System.out.println("Unread msgs with atts: " + messages.size());

    // Folder with name of 'SubInbox'
    builder = new PersonalStorageQueryBuilder();
    builder.getFolderName().equals("SubInbox");
    FolderInfoCollection folders = folder.getSubFolders(builder.getQuery());
    System.out.println("Folder having subfolder: " + folders.size());

    builder = new PersonalStorageQueryBuilder();
    // Folders with subfolders
    builder.hasSubfolders();
    folders = folder.getSubFolders(builder.getQuery());
    System.out.println(folders.size());
}

대소문자 구분 없이 PST에서 문자열 검색

다음 코드 조각은 대소문자를 무시하는 매개변수를 사용하여 PST에서 문자열을 검색하는 방법을 보여줍니다.

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

try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CaseSensitivity.pst", FileFormatVersion.Unicode)) {
    FolderInfo folderinfo = personalStorage.createPredefinedFolder("Inbox", StandardIpmFolder.Inbox);
    folderinfo.addMessage(MapiMessage.fromMailMessage(MailMessage.load("Sample.eml")));
    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
    // IgnoreCase is True
    builder.getFrom().contains("automated", true);
    MailQuery query = builder.getQuery();
    MessageInfoCollection coll = folderinfo.getContents(query);
    System.out.println(coll.size());
}

PST 파일에서 여러 키워드로 메시지 제목 검색

다음과 같이 사용할 수 있습니다 MailQueryBuilder.or 아래와 같이 지정된 단어 중 하나 이상을 포함하는 제목을 가진 메시지를 찾는 메서드:

PersonalStorageQueryBuilder builder1 = new PersonalStorageQueryBuilder();
builder1.getSubject().contains("Review"); // 'Review' is key word for the search

PersonalStorageQueryBuilder builder2 = new PersonalStorageQueryBuilder();
builder2.getSubject().contains("Error"); // 'Error' is also key word for the search

PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.or(builder1.getQuery(), builder2.getQuery()); // message subjects must contain 'Review' or 'Error' words

try (PersonalStorage storage = PersonalStorage.fromFile("example.pst"))
{
    FolderInfo folderInfo = storage.getRootFolder().getSubFolder("Inbox");
    MessageInfoCollection messageInfos = folderInfo.getContents(queryBuilder.getQuery());

    for (MessageInfo messageInfo : messageInfos)
    {
        System.out.println(messageInfo.getSubject());
    }
}

PST 폴더 내용 페이지별 검색

대용량 폴더를 탐색할 때 애플리케이션 성능과 제어를 향상시킵니다. Aspose.Email 오버로드를 사용하여 페이지 방식으로 폴더 내용을 검색합니다. getContents 메서드. 이 메서드는 - FolderInfo.getContents(MailQuery query, int startIndex, int count) - 지정된 쿼리와 일치하는 메시지의 일부분을 주어진 인덱스부터 개수 제한으로 가져옵니다. 다음 코드 샘플은 PST 폴더에서 필터링된 메시지를 페이지별로 검색하고 처리하는 방법을 보여줍니다:

// Load the PST file
try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    // Access a specific subfolder
    FolderInfo folder = pst.getRootFolder().getSubFolder("Inbox");

    // Build a query to filter messages by sender address
    PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
    queryBuilder.getFrom().contains("report-service", true);

    // Define the page size
    int pageSize = 5;

    // Retrieve and process messages in pages
    for (int pageIndex = 0; pageIndex < 6; pageIndex++) {
        int startIndex = pageIndex * pageSize;

        // Get a page of messages
        MessageInfoCollection messages = folder.getContents(queryBuilder.getQuery(), startIndex, pageSize);

        for (MessageInfo messageInfo : messages) {
            // Output basic info about each message
            System.out.println("Subject: " + messageInfo.getSubject() + ", Sender: " + messageInfo.getSenderRepresentativeName());
        }
    }
}

PST 파일의 다른 폴더로 항목 이동

Aspose.Email를 사용하면 동일한 개인 저장소(PST) 파일 내에서 소스 폴더의 항목을 다른 폴더로 이동할 수 있습니다. 여기에는 다음이 포함됩니다:

지정된 폴더를 새 상위 폴더로 이동하기.
지정된 메시지를 새 폴더로 이동하기.
내용을 새 폴더로 이동하기.
하위 폴더를 새 상위 폴더로 이동하기.

다음 코드 조각은 동일한 PST 파일 내에서 소스 폴더의 메시지 및 폴더와 같은 항목을 다른 폴더로 이동하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
try (PersonalStorage personalStorage = PersonalStorage.fromFile("test.pst")) {
    FolderInfo inbox = personalStorage.getPredefinedFolder(StandardIpmFolder.Inbox);
    FolderInfo deleted = personalStorage.getPredefinedFolder(StandardIpmFolder.DeletedItems);
    FolderInfo subfolder = inbox.getSubFolder("Subfolder");

    // Move folder and message to the Deleted Items
    personalStorage.moveItem(subfolder, deleted);
    MessageInfoCollection contents = subfolder.getContents();
    personalStorage.moveItem(contents.get(0), deleted);

    // Move all inbox subfolders and subfolder contents to the Deleted Items
    inbox.moveSubfolders(deleted);
    subfolder.moveContents(deleted);
}

PST 파일에서 메시지 속성 업데이트

때때로 메시지의 제목 변경, 중요도 표시 등과 같이 특정 속성을 업데이트해야 할 경우가 있습니다. 이러한 속성 변경을 포함한 PST 파일의 메시지를 업데이트하려면 FolderInfo.changeMessages 이 메서드. 이 문서는 PST 파일에서 메시지 속성을 일괄 변경하는 방법을 보여줍니다. 다음 코드 스니펫은 PST 파일의 여러 메시지에 대해 일괄 모드로 속성을 업데이트하는 방법을 보여줍니다.

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

// Load the Outlook PST file
PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir);

// Get Requierd Subfolder
FolderInfo inbox = personalStorage.getRootFolder().getSubFolder("Inbox");

// find messages having From = "someuser@domain.com"
PersonalStorageQueryBuilder queryBuilder = new PersonalStorageQueryBuilder();
queryBuilder.getFrom().contains("someuser@domain.com");

// Get Contents from Query
MessageInfoCollection messages = inbox.getContents(queryBuilder.getQuery());

// Save (MessageInfo,EntryIdString) in List
List<String> changeList = new ArrayList<String>();
for (MessageInfo messageInfo : messages) {
    changeList.add(messageInfo.getEntryIdString());
}

// Compose the new properties
MapiPropertyCollection updatedProperties = new MapiPropertyCollection();
updatedProperties.add(MapiPropertyTag.PR_SUBJECT_W, new MapiProperty(MapiPropertyTag.PR_SUBJECT_W, "New Subject".getBytes(Charset.forName("utf-16le"))));
updatedProperties.add(MapiPropertyTag.PR_IMPORTANCE, new MapiProperty(MapiPropertyTag.PR_IMPORTANCE, BitConverter.getBytesInt64(2)));

// update messages having From = "someuser@domain.com" with new properties
inbox.changeMessages(changeList, updatedProperties);

PST 파일에서 사용자 정의 속성 업데이트

때때로 PST 파일 내에서 처리된 항목을 표시해야 할 필요가 있습니다. Aspose.Email API는 MapiProperty와 MapiNamedProperty를 사용해 이를 구현할 수 있습니다. 다음 메서드들이 도움이 됩니다.

constructor MapiNamedProperty(long propertyTag, String nameIdentifier, UUID propertyGuid, byte[] propertyValue)
constructor MapiNamedProperty(long propertyTag, long nameIdentifier, UUID propertyGuid, byte[] propertyValue)
FolderInfo.changeMessages(MapiPropertyCollection updatedProperties) - changes all messages in folder
PersonalStorage.changeMessage(String entryId, MapiPropertyCollection updatedProperties) - change message properties

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    // The path to the File directory.
    String dataDir = "data/" + "Sub.pst";

    try (PersonalStorage personalStorage = PersonalStorage.fromFile(dataDir)) {
        FolderInfo testFolder = personalStorage.getRootFolder().getSubFolder("Inbox");

        // Create the collection of message properties for adding or updating
        MapiPropertyCollection newProperties = new MapiPropertyCollection();

        // Normal, Custom and PidLidLogFlags named property
        MapiProperty property = new MapiProperty(MapiPropertyTag.PR_ORG_EMAIL_ADDR_W, "test_address@org.com".getBytes(Charset.forName("utf-16le")));
        MapiProperty namedProperty1 = new MapiNamedProperty(generateNamedPropertyTag(0L, MapiPropertyType.PT_LONG), "ITEM_ID", UUID.randomUUID(),
                BitConverter.getBytesInt64(123));
        MapiProperty namedProperty2 = new MapiNamedProperty(generateNamedPropertyTag(1L, MapiPropertyType.PT_LONG), 0x0000870C,
                UUID.fromString("0006200A-0000-0000-C000-000000000046"), BitConverter.getBytesInt64(0));
        newProperties.add(namedProperty1.getTag(), namedProperty1);
        newProperties.add(namedProperty2.getTag(), namedProperty2);
        newProperties.add(property.getTag(), property);
        testFolder.changeMessages(testFolder.enumerateMessagesEntryId(), newProperties);
    }
}

private static long generateNamedPropertyTag(long index, int dataType) {
    return (((0x8000 | index) << 16) | (long) dataType) & 0x00000000FFFFFFFFL;
}

전체 메시지를 추출하지 않고 첨부 파일 추출

Aspose.Email API를 사용하면 PST 메시지에서 전체 메시지를 먼저 추출하지 않고도 첨부 파일을 추출할 수 있습니다. ExtractAttachments 메서드 PersonalStorage 이를 위해 사용할 수 있습니다. 다음 코드 스니펫은 전체 메시지를 추출하지 않고 첨부 파일만 추출하는 방법을 보여줍니다.

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

try (PersonalStorage personalstorage = PersonalStorage.fromFile(dataDir + "Outlook.pst")) {
    FolderInfo folder = personalstorage.getRootFolder().getSubFolder("Inbox");

    for (String messageInfo : folder.enumerateMessagesEntryId()) {
        MapiAttachmentCollection attachments = personalstorage.extractAttachments(messageInfo);

        if (attachments.size() != 0) {
            for (MapiAttachment attachment : attachments) {
                if (attachment.getLongFileName() != null && !attachment.getLongFileName().isEmpty()) {
                    if (attachment.getLongFileName().contains(".msg")) {
                        continue;
                    } else {
                        attachment.save(dataDir + "Attachments/" + attachment.getLongFileName());
                    }
                }
            }
        }
    }
}

PST에 파일 추가

Microsoft Outlook의 주요 기능은 이메일, 캘린더, 작업, 연락처 및 저널 항목을 관리하는 것입니다. 또한 파일을 PST 폴더에 추가할 수 있으며, 이렇게 추가된 파일은 PST에 기록됩니다. Aspose.Email은 메시지, 연락처, 작업 및 저널 항목을 PST에 추가하는 것과 동일한 방식으로 폴더에 파일을 추가하는 기능을 제공합니다. 다음 코드 스니펫은 Aspose.Email을 사용해 PST 폴더에 문서를 추가하는 방법을 보여줍니다.

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

try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "Ps1_out.pst", FileFormatVersion.Unicode)) {
    FolderInfo folder = personalStorage.getRootFolder().addSubFolder("Files");

    // Add Document.doc file with the "IPM.Document" message class by default.
    folder.addFile(dataDir + "attachment_1.doc", null);
}

Java: PST 파일에서 연락처 작업

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

VCard 형식의 다중 연락처 읽기

아래 코드 샘플은 VCF 파일을 읽고, 다중 연락처가 포함되어 있는지 확인한 다음, 포함되어 있다면 파일에서 연락처를 VCardContact 객체 목록으로 로드하는 방법을 보여줍니다. 코드는 다음 메서드를 사용합니다:

isMultiContacts(InputStream stream) - 소스 스트림에 다중 연락처가 포함되어 있는지 확인합니다.
loadAsMultiple(String filePath, Charset encoding) - 다중 연락처 파일에서 연락처 목록을 로드합니다.
loadAsMultiple(InputStream stream, Charset encoding) - 다중 연락처 스트림에서 연락처 목록을 로드합니다.

try (InputStream stream = new FileInputStream("test.vcf")) {
    if (VCardContact.isMultiContacts(stream)) {
        List<VCardContact> contacts = VCardContact.loadAsMultiple(stream, Charset.forName("utf-8"));
    }
}

PST에 연락처 추가

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email를 사용하면 MapiContact 생성하거나 로드한 PST 파일의 Contacts 하위 폴더에. 아래는 추가 단계입니다 MapiContact PST에:

다음을 생성합니다 MapiContact 객체.
설정합니다. MapiContact 다양한 생성자와 메서드를 사용한 속성들.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Contacts)를 생성합니다. addMapiMessageItem() 메서드.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiContact 그런 다음 새로 만든 PST 파일의 Contacts 폴더에 추가합니다.

PST 파일의 연락처 정보를 MSG 형식으로 저장

이 문서는 Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 MSG 형식으로 디스크에 저장하는 방법을 보여줍니다. 이를 위해 다음을 사용하십시오: PersonalStorage 및 MapiContact 연락처 정보를 가져오고 표시하는 클래스들.

연락처 정보를 가져오려면:

PST 파일을 로드합니다 PersonalStorage 클래스.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
호출하십시오 PersonalStorage.extractMessage() 그리고 toMapiMessageItem() 연락처 정보를 얻는 메서드 MapiContact 클래스.
사용 MapiContact 연락처 정보에 접근하는 속성들.
다음을 호출합니다. PersonalStorage.extractMessage() 연락처 정보를 얻는 메서드 MapiMessage 클래스.
다음을 호출합니다. MapiMessage.save() 연락처를 MSG 형식으로 디스크에 저장하는 메서드.

아래는 PST 파일에서 모든 연락처 정보를 가져와 MSG 형식으로 디스크에 저장하는 샘플 코드입니다.

Outlook PST에서 연락처 정보를 vCard 형식으로 디스크에 저장

이 문서는 Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 vCard(VCF) 형식으로 디스크에 저장하는 방법을 보여줍니다. 이를 사용합니다. PersonalStorage 및 MapiContact 연락처 정보를 가져오는 클래스들.

연락처 정보를 얻기 위한 단계는 다음과 같습니다:

PST 파일을 로드합니다 PersonalStorage 클래스.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
다음을 호출합니다. PersonalStorage.extractMessage() 연락처 정보를 얻는 메서드 MapiContact 클래스.
의 속성을 사용하십시오 MapiContact 연락처 정보를 액세스하는 클래스.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 연락처를 vCard(VCF) 형식으로 저장합니다. VCF 파일은 표준 vCard 연락처 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 VCF 파일을 열면 아래 스크린샷과 같은 형태로 표시됩니다.

|| | :- | |Figure: Aspose.Email로 저장된 vCard|

Java: PST 파일에서 캘린더 항목 작업

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

PST에 MapiCalendar 추가

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 만들고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 MapiCalendar 생성하거나 로드한 PST 파일의 Calendar 하위 폴더에.

다음은 추가 단계입니다: MapiCalendar PST에:

다음을 생성합니다 MapiCalendar 객체.
설정합니다. MapiCalendar 생성자와 메서드를 사용하여 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Calendar)를 생성합니다. addMapiMessageItem() 메서드.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiCalendar 그런 다음 새로 만든 PST 파일의 Calendar 폴더에 추가합니다.

Outlook PST에서 캘린더 항목을 디스크에 ICS 형식으로 저장

이 문서는 Outlook PST 파일에서 캘린더 항목에 접근하고 캘린더를 디스크에 ICS 형식으로 저장하는 방법을 보여줍니다. 이를 위해 PersonalStorage 및 MapiCalendar 캘린더 정보를 가져오는 클래스들.

다음은 캘린더 항목을 저장하는 단계입니다:

PST 파일을 로드합니다 PersonalStorage 클래스.
캘린더 폴더 탐색.
캘린더 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
다음을 호출합니다. PersonalStorage.extractMessage() 연락처 정보를 얻는 메서드 MapiCalendar 클래스.
다음을 호출합니다. MapiCalendar.save() 캘린더 항목을 디스크에 ICS 형식으로 저장하는 메서드.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 캘린더 항목을 ICS 형식으로 저장합니다. 이렇게 생성된 ICS 파일은 표준 ICS 캘린더 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 any ICS 파일을 열면 아래 스크린샷과 같은 모습이 표시됩니다.

|| | :- | |Figure: Aspose.Email으로 저장된 캘린더 항목|

PST 파일에서 캘린더 항목 추출

MapiCalendar 클래스는 Microsoft Outlook MAPI 형식의 캘린더 항목을 나타냅니다. PST 파일에서 메시지를 추출해 MAPI 메시지 항목으로 변환합니다. 다음 코드 샘플은 PST 파일에서 캘린더 항목을 추출하고 이를 MapiCalendar 객체로 변환하여 추가 조작이나 처리에 사용할 수 있게 합니다.

MapiCalendar cal = (MapiCalendar) pst.extractMessage(messageInfo).toMapiMessageItem();

원본 타임스탬프를 유지한 채 캘린더 항목을 ICS 형식으로 저장

위 코드 샘플을 사용해 PST 파일에서 캘린더 항목을 추출한 뒤, 추가 옵션을 지정하여 원본 타임스탬프를 유지하면서 ICS 형식으로 저장할 수 있습니다. setKeepOriginalDateTimeStamp 메서드 MapiCalendarIcsSaveOptions 클래스:

MapiCalendar cal = (MapiCalendar) pst.extractMessage(messageInfo).toMapiMessageItem();

if (cal != null) {
    MapiCalendarIcsSaveOptions so = new MapiCalendarIcsSaveOptions();
    so.setKeepOriginalDateTimeStamp(true);
    cal.save("cal.ics", so);
}

반복 항목에서 발생 인스턴스 수정/삭제

Java: PST에서 MapiTask 작업

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

PST에 MapiTask 추가

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 만들고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Tasks 하위 폴더에 MapiTask를 추가할 수 있습니다.

다음은 PST에 MapiTask를 추가하는 단계입니다:

다음을 생성합니다 MapiTask 객체.
설정합니다. MapiTask 생성자와 다양한 메서드를 사용해 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Tasks)를 생성합니다. addMapiMessageItem() 메서드.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiTask 그런 다음 새로 만든 PST 파일의 Tasks 폴더에 추가합니다.

Java: PST에서 MapiJournal 작업

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

PST에 MapiJournal 추가

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여주었습니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Journal 하위 폴더에 MapiJournal을 추가할 수 있습니다. 아래는 PST에 MapiJournal을 추가하는 단계입니다:

다음을 생성합니다 MapiJournal 객체.
설정합니다. MapiJournal 생성자와 메서드를 사용하여 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 뒤 사전 정의된 폴더(Journals)를 PST 파일의 루트에 생성하고 그 다음에 호출합니다. addMapiMessageItem() 메서드.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiJournal 그런 다음 새로 만든 PST 파일의 Journal 폴더에 추가합니다.

MapiJournal에 첨부 파일 추가

MAPI 저널 항목에 첨부 파일을 추가하는 것도 가능합니다. 아래 코드는 그 방법을 보여줍니다.

Java: PST에서 MapiNote 작업

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

PST에 MapiNote 추가

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 만들고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Notes 하위 폴더에 MapiNote를 추가할 수 있습니다.

다음은 PST에 MapiNote를 추가하는 단계입니다:

Microsoft Outlook을 사용해 템플릿 MapiNote를 만들고 MSG 파일로 저장합니다.
저장된 MSG 메모를 로드합니다. MapiMessage 객체.
다음을 생성합니다 MapiNote 객체를 사용해 템플릿 MSG 메모를 로드합니다.
설정합니다. MapiNote 다양한 메서드를 사용하여 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 후 호출하여 PST 파일 루트에 미리 정의된 폴더(Notes)를 생성합니다. addMapiMessageItem() 메서드.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiNote 그런 다음 새로 만든 PST 파일의 Notes 폴더에 추가합니다.

Java: PST 파일 분할 및 병합

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

Aspose.Email API는 단일 PST 파일을 원하는 크기의 여러 PST 파일로 분할할 수 있는 기능을 제공합니다. 또한 여러 PST 파일을 하나의 PST 파일로 병합할 수 있습니다. 분할 및 병합 작업은 이벤트를 추가하여 추적할 수 있습니다.

PST 파일 분할 및 병합

다음 코드 샘플은 큰 PST 파일을 여러 개의 작은 PST 파일 조각으로 분할하는 방법을 보여줍니다.

여러 PST를 하나의 PST로 병합

다음 코드 샘플은 여러 PST를 하나의 큰 PST 파일로 병합하는 방법을 보여줍니다.

사용해 보세요!

무료로 여러 이메일 파일을 하나로 병합하고 결합합니다 Aspose.Email Merger App.

다른 PST에서 폴더 병합

Aspose.Email API를 사용하면 다른 PST에서 전체 폴더를 대상 PST로 병합할 수 있어 큰 용량의 PST가 생성됩니다.

정의된 기준에 따라 PST 분할

도움 메서드

Java: PST 비밀번호 보호 속성 작업

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

Microsoft Outlook은 사용자가 PST 파일에 비밀번호 보호를 설정해 접근을 제한할 수 있게 합니다. Aspose.Email는 PST 파일의 비밀번호 보호 여부를 감지할 수 있습니다. 이 문서에서는 PST에 비밀번호가 설정되어 있는지와, 적용된 비밀번호가 올바른지 확인하는 방법을 보여줍니다.

비밀번호 보호 확인

다음은 MapiPropertyTag.PR_PST_PASSWORD 값은 MapiPropertyTag 클래스는 파일이 비밀번호 보호되어 있는지 확인하는 데 사용됩니다.

비밀번호 문자열의 CRC-32 해시는 PidTagPstPassword (tag = 0x67ff0003) 속성에 저장됩니다 MessageStore. 이 속성이 존재하고 0이 아니면 PST가 비밀번호 보호됩니다.

다음 코드 스니펫은 PST 파일이 비밀번호 보호되어 있는지와 주어진 문자열이 해당 PST에 대한 유효한 비밀번호인지 확인하는 방법을 보여줍니다.

아래 코드 스니펫은 두 함수를 보여줍니다. 첫 번째는 PST가 비밀번호 보호되어 있는지 확인하고, 두 번째는 제공된 비밀번호가 올바른지 여부를 확인하는 방법을 보여줍니다.

PR_PST_PASSWORD 속성 제거/재설정

제거는 PR_PST_PASSWORD 다른 속성이 메시지 저장소에서 제거되기 때문에 해당 속성을 직접 얻을 수 없습니다. 대신 값을 0(제로)으로 설정하여 제거해야 합니다. 이 경우 PST 클래스의 "Store" 속성은 PST의 MessageStoreProperties 대신 PST의 저장소 속성에 접근할 수 있게 해줍니다.

PST 비밀번호 설정/변경

다음 코드 스니펫은 PST 파일에 비밀번호를 설정하는 방법을 보여줍니다.

비밀번호 보호된 PST 파일에 대한 비밀번호 검증

Aspose.Email는 개발자가 PST 파일이 비밀번호 보호되어 있는지와 주어진 비밀번호가 올바른지 확인할 수 있게 합니다. 이를 위해 API는 다음을 제공합니다 PersonalStorage.Store.IsPasswordProtected 속성 및 PersonalStorage.Store.IsPasswordValid() 메서드. PersonalStorage.Store.IsPasswordProtected 속성은 PST 파일이 비밀번호 보호되어 있으면 true, 그렇지 않으면 false를 반환합니다. PersonalStorage.Store.IsPasswordValid() 메서드는 문자열 비밀번호를 매개변수로 받아 비밀번호가 올바르면 true, 그렇지 않으면 false를 반환합니다.

다음 코드 스니펫은 사용법을 보여줍니다 PersonalStorage.Store.IsPasswordProtected 속성 및 PersonalStorage.Store.IsPasswordValid() 메서드.

샘플 코드

콘솔 출력

스토리지는 비밀번호 보호됨 - True 비밀번호가 유효함 - True

Java: Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보 가져오기

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

Aspose.Email for Java를 사용하면 Microsoft Outlook PST 파일을 읽을 수 있습니다. 디스크나 스트림에서 PST 파일을 로드하여 인스턴스로 만들 수 있습니다. PersonalStorage 클래스를 사용하여 내용에 대한 정보를 얻을 수 있습니다. 예를 들어 폴더, 하위 폴더 및 메시지 등.

PST 파일 로드

Outlook PST 파일을 해당 클래스의 인스턴스로 로드할 수 있습니다. PersonalStorage 클래스. PST 파일을 로드하는 코드 스니펫은 아래에 제공됩니다:

폴더 정보 표시

PST 파일을 로드한 후 PersonalStorage 클래스를 사용하면 파일 표시 이름, 루트 폴더, 하위 폴더 및 메시지 수에 대한 정보를 얻을 수 있습니다. 다음 코드 스니펫은 PST 파일 이름, 폴더 및 각 폴더의 메시지 수를 표시합니다:

사용자 정의 폴더만 가져오기

PST/OST 파일에는 사용자가 만든 폴더가 포함될 수 있습니다. Aspose.Email은 다음을 사용하여 사용자 정의 폴더만 접근할 수 있는 기능을 제공합니다. PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 속성입니다. 이를 설정할 수 있습니다. PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 속성을 true 로 설정하여 사용자 정의 폴더만 가져옵니다. 다음 코드 스니펫은 사용 예시를 보여줍니다. PersonalStorageQueryBuilder.OnlyFoldersCreatedByUser 사용자 정의 폴더를 가져오기 위해.

폴더가 사전 정의된 폴더에 속하는지 확인

PST(Personal Storage Table) 파일 내 폴더를 열고 검사할 때, 각 폴더가 사전 정의된 폴더 유형인지 혹은 사전 정의된 폴더 유형의 하위 폴더인지 확인하고 각 폴더에 대한 정보를 얻을 수 있습니다.

다음은 FolderInfo.getPredefinedType(boolean getForTopLevelParent) 메서드는 폴더가 다음 출처인지 확인하는 데 사용됩니다: StandardIpmFolder.

‘getForTopLevelParent’ 매개변수가 true이면, 메서드는 최상위 부모 폴더에 대한 StandardIpmFolder 열거값을 반환합니다. 이는 현재 폴더가 사전 정의된 폴더의 하위 폴더인지 여부를 판단합니다. ‘getForTopLevelParent’ 매개변수가 false이면, 현재 폴더에 대한 StandardIpmFolder 열거값을 반환합니다.

String fileName = "my.pst";

try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    checkFolders(pst.getRootFolder().getSubFolders());
}

private void checkFolders(FolderInfoCollection folders) {
    for (FolderInfo folder : folders) {
        System.out.println("Display Name: " + folder.getDisplayName());

        // Determines whether the current folder is a predefined folder
        int folderType = folder.getPredefinedType(false);
        String answer = folderType == StandardIpmFolder.Unspecified ? "No" : "Yes, " + folderType;
        System.out.println("Is StandardIpmFolder?: " + answer);

        // Determines whether the current folder is a subfolder of a predefined folder
        if (folderType == StandardIpmFolder.Unspecified) {
            folderType = folder.getPredefinedType(true);
            answer = folderType == StandardIpmFolder.Unspecified ? "No" : "Yes, " + folderType;
            System.out.println("Is subfolder from StandardIpmFolder parent?: " + answer);
        }

        System.out.println();

        checkFolders(folder.getSubFolders());
    }
}

PST 파일에서 표준 RSS 피드 폴더 가져오기 또는 추가하기

Aspose.Email을 사용하면 RSS 피드를 보유하는 사전 정의된 폴더에 대한 참조를 얻을 수 있습니다. 이는 Outlook PST 파일에 저장된 RSS 피드에 프로그래밍으로 접근하고 조작하려는 경우에 유용합니다. RssFeeds 값을 다음에 전달하세요: StandardIpmFolder 열거형.

다음 코드 예제는 RSS 피드 폴더를 가져오는 방법을 보여줍니다:

try (PersonalStorage pst = PersonalStorage.fromFile("my.pst", false)) {
    FolderInfo rssFolder = pst.getPredefinedFolder(StandardIpmFolder.RssFeeds);
}

아래 코드 예제는 RSS 피드 폴더를 추가하는 방법을 보여줍니다:

try (PersonalStorage pst = PersonalStorage.create("my.pst", FileFormatVersion.Unicode)) {
    FolderInfo rssFolder = pst.createPredefinedFolder("RSS Feeds", StandardIpmFolder.RssFeeds);
}

검색 가능한 폴더 파싱

PST/OST는 일반 폴더 외에도 검색 가능한 폴더를 포함할 수 있습니다. Aspose.Email은 다음을 제공합니다. FolderKind 해당 검색 폴더에서 메시지를 지정하기 위한 열거자와 함께 EnumerateFolders 및 GetSubFolders 메서드들.

MessageInfo에서 부모 폴더 정보 가져오기

다음 코드 스니펫은 부모 폴더 정보를 다음으로부터 가져오는 방법을 보여줍니다: MessageInfo.

PST 파일 탐색 API

탐색 API는 원본 파일 일부 데이터가 손상된 경우에도 예외를 발생시키지 않고 가능한 한 모든 PST 항목을 추출할 수 있게 해줍니다. 다음 단계는 이 API를 사용하는 방법을 보여줍니다.

사용 PersonalStorage 생성자와 로드 fromFile 메서드 대신 사용할 메서드.

생성자를 통해 콜백 메서드를 정의할 수 있습니다.

try (PersonalStorage currentPst = new PersonalStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        // Exception handling code.
    }
})) {
    //
}

로드 및 탐색 중 발생한 예외는 콜백 메서드를 통해 확인할 수 있습니다.

다음은 로드 파일이 성공적으로 로드되고 추가 탐색이 가능하면 메서드는 ’true’를 반환합니다. 파일이 손상되어 탐색이 불가능한 경우 ‘false’를 반환합니다.

if (currentPst.load(inputStream))

이 기능을 통해 손상된 PST 파일도 예외를 발생시키지 않고 열고 탐색할 수 있습니다. 예외와 손상된 항목 모두 콜백 메서드에서 처리됩니다.

try (PersonalStorage pst = new PersonalStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        // Exception handling code.
    }
})) {
    if (pst.load("test.pst")) {
        getAllMessages(pst, pst.getRootFolder());
    }
}

private static void getAllMessages(PersonalStorage pst, FolderInfo folder) {
    for (String messageEntryId : folder.enumerateMessagesEntryId()) {
        MapiMessage message = pst.extractMessage(messageEntryId);
    }
    for (FolderInfo subFolder : folder.getSubFolders()) {
        getAllMessages(pst, subFolder);
    }
}

Java: 손상된 PST/OST 파일 읽기

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

손상된 PST/OST 파일 읽기

때때로 일부 문제 때문에 PST/OST를 읽을 수 없을 수 있습니다. 예를 들어, 일부 데이터 블록이 손상될 수 있습니다. 이러한 경우, 일반적으로 해당 메서드를 호출할 때 예외가 발생합니다. EnumerateFolders, EnumerateMessages, GetContents, GetSubfolders, 등 메서드. 그러나 개별 메시지나 폴더는 저장소에서 손상되지 않을 수 있습니다.

Aspose.Email 사용자는 계층적으로 항목 식별자를 찾을 수 있습니다. 또한 식별자를 통해 항목을 추출할 수 있습니다. 이를 위해 라이브러리는 다음 메서드들을 제공합니다:

PersonalStorage.findMessages(String parentEntryId) - 폴더의 메시지 식별자를 찾습니다.
PersonalStorage.findSubfolders(String parentEntryId) - 폴더의 하위 폴더 식별자를 찾습니다.

Note, 그럼에도 불구하고 장점이 있더라도 이러한 메서드로도 읽을 수 없는 손상된 저장소가 있습니다.

다음 코드 스니펫은 손상된 PST/OST 파일을 읽는 데 이러한 메서드들을 사용하는 방법을 보여줍니다:

try (PersonalStorage pst = PersonalStorage.fromFile(fileName)) {
    exploreCorruptedPst(pst, pst.getRootFolder().getEntryIdString());
}

public static void exploreCorruptedPst(PersonalStorage pst, String rootFolderId) {
    Iterable<String> messageIdList = pst.findMessages(rootFolderId);

    for (String messageId : messageIdList) {
        try {
            MapiMessage msg = pst.extractMessage(messageId);
            System.out.println("- " + msg.getSubject());
        } catch (Exception e) {
            System.out.println("Message reading error. Entry id: " + messageId);
        }
    }

    Iterable<String> folderIdList = pst.findSubfolders(rootFolderId);

    for (String subFolderId : folderIdList) {
        if (subFolderId != rootFolderId) {
            try {
                FolderInfo subfolder = pst.getFolderById(subFolderId);
                System.out.println(subfolder.getDisplayName());
            } catch (Exception e) {
                System.out.println("Message reading error. Entry id: " + subFolderId);
            }

            exploreCorruptedPst(pst, subFolderId);
        }
    }
}

손상된 파일에서 PST 항목 추출

탐색 API는 원본 파일의 일부 데이터가 손상된 경우에도 예외를 발생시키지 않고 가능한 한 모든 PST 항목을 추출할 수 있게 합니다.

다음 사용 PersonalStorage(TraversalExceptionsCallback callback) 생성자와 load(String fileName) 메서드 대신에 fromFile 메서드.

생성자를 통해 콜백 메서드를 정의할 수 있습니다.

TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
    @Override
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
};

try (PersonalStorage pst = new PersonalStorage(exceptionsCallback)) { }

로드 및 탐색 중 발생한 예외는 콜백 메서드를 통해 확인할 수 있습니다.

load 메서드는 파일이 성공적으로 로드되고 추가 탐색이 가능한 경우 ’true’를 반환합니다. 파일이 손상되어 탐색이 불가능한 경우 ‘false’가 반환됩니다.

if (currentPst.load(inputStream))

다음 코드 샘플은 프로젝트에 PST 파일 탐색 API를 구현하는 방법을 보여줍니다:

public static void main(String[] args) {
    TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
        @Override
        public void invoke(TraversalAsposeException exception, String itemId) {
            /* Exception handling  code. */
        }
    };

    try (PersonalStorage pst = new PersonalStorage(exceptionsCallback)) {
        if (pst.load("test.pst")) {
            getAllMessages(pst, pst.getRootFolder());
        }
    }
}

private static void getAllMessages(PersonalStorage pst, FolderInfo folder) {
    for (String messageEntryId : folder.enumerateMessagesEntryId()) {
        MapiMessage message = pst.extractMessage(messageEntryId);
    }
    for (FolderInfo subFolder : folder.getSubFolders()) {
        getAllMessages(pst, subFolder);
    }
}

Java: PST에 MapiDistributionList 추가

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

새 PST 생성, 하위 폴더 및 메시지 추가 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email를 사용하면 MapiDistributionList 생성하거나 로드한 PST 파일의 Contacts 하위 폴더에.

EntryId를 설정하려면 MapiDistributionListMember, base64String은 다음을 사용해 변환해야 합니다. Apache Commons Codec.

파일에서 MapidistributionList 로드

아래 코드는 파일에서 MAPI 배포 목록을 로드합니다.

새 MapiDistributionList를 만들고 Contacts 하위 폴더에 추가

다음은 추가 단계입니다: MapiDistributionList PST에:

새 PST 만들기.
Contacts 폴더를 PST에 추가합니다.
샘플 연락처 만들기.
생성된 연락처를 기반으로 배포 목록을 만듭니다.
배포 목록을 PST에 추가합니다.

아래 코드 스니펫은 생성 방법을 보여줍니다 MapiDistributionList 그런 다음 새로 만든 PST 파일의 Contacts 폴더에 추가합니다.

일회성 배포 목록 만들기

이 배포 목록에는 별도의 연락처가 필요하지 않습니다.

Java: Outlook for Mac OLM 파일을 읽고 폴더 및 하위 폴더 정보를 가져오기

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

Aspose.Email for Java를 사용하면 Outlook for Mac OLM 파일을 읽을 수 있습니다. 디스크에서 OLM 파일을 인스턴스로 로드할 수 있습니다. OlmStorage 클래스를 사용하여 내용에 대한 정보를 얻을 수 있습니다. 예를 들어 폴더, 하위 폴더 및 메시지 등.

OLM 형식 파일 열기

OLM 형식 파일은 두 가지 방법으로 열 수 있습니다:

생성자 사용
정적 FromFile 메서드 사용

이 메서드들 사이에는 동작 차이가 있습니다. 아래 섹션을 참고하십시오.

생성자를 사용하여 파일 열기

파일을 열려면, 다음의 생성자를 호출합니다 OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

OlmStorage olm = new OlmStorage("fileName");

FromFile 정적 메서드로 파일 열기

파일을 열려면 정적 메서드를 사용합니다 fromFile 그리고 전체 파일 이름을 인수로 전달합니다:

OlmStorage olm = OlmStorage.fromFile("fileName");

FromStream 정적 메서드로 파일 열기

정적 메서드를 사용하여 파일을 열려면 fromStream, 스트림 이름을 인수로 전달합니다:

OLM 파일 읽기

다음 코드 스니펫은 OLM 파일을 로드하고 내용을 가져오는 방법을 보여줍니다.

폴더 가져오기

OLM (Outlook for Mac) 파일에서 폴더를 검색하려면, 다음으로 로드하십시오 OlmStorage 먼저 클래스를 사용하고, 필요에 따라 다음 메서드 중 하나를 사용하십시오:

getFolder(String name, boolean ignoreCase) - 이름으로 폴더를 가져옵니다.
getFolders() - 폴더 계층 구조/폴더 컬렉션을 가져옵니다.
getFolderHierarchy() - 폴더 계층 구조를 가져옵니다.

아래 코드 샘플은 OLM 파일에서 폴더를 가져오는 방법을 보여줍니다:

// Get the folder by name
OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

} finally {

    olm.dispose();

}

사용할 때 fromFile OLM 파일을 열기 위한 메서드, the getFolderHierarchy() null을 반환합니다. 이 경우, 다음을 호출하십시오 getFolders() OLM 파일 내 디렉터리 목록을 명시적으로 검색하는 메서드.

폴더 경로 가져오기

OML 파일의 폴더 경로도 가져올 수 있습니다. Aspose.Email은 제공합니다 OlmFolder.Path 폴더 경로를 반환하는 속성. 다음 코드 스니펫은 사용법을 보여줍니다 OlmFolder.Path OML 파일에서 폴더 경로를 가져오는 속성.

폴더 내 항목 수 세기

폴더 내 항목 수를 셀 수도 있습니다. Aspose.Email은 제공합니다 OlmFolder.MessageCount 폴더 내 항목 수를 반환하는 속성. 다음 코드 스니펫은 사용법을 보여줍니다 OlmFolder.MessageCount OML 파일 폴더 내 항목 수를 가져오는 속성.

지정된 폴더에서 메시지 열거

Aspose.Email은 OLM 스토리지를 작업하고 지정된 폴더에서 메시지를 추출하기 위한 API를 제공합니다. The OlmFolder 및 OlmMessageInfo 클래스는 각각 저장소의 폴더와 메시지에 대한 간략한 정보를 나타냅니다. The OlmFolder 클래스는 다음 메서드를 제공합니다:

OlmFolder.getSubFolder(String subfolderName, boolean ignoreCase) - 이름으로 하위 폴더를 가져옵니다.
OlmFolder.enumerateMapiMessages() - 현재 폴더에서 MapiMessages를 반복할 수 있는 열거자를 제공합니다.
OlmFolder.enumerateMessages() - 현재 폴더에서 OlmMessageInfo를 반복할 수 있는 열거자를 제공합니다.
OlmFolder.enumerateMessages(int startIndex, int count) - 지정된 범위 내에서 OlmMessageInfo를 반복할 수 있는 열거자를 제공합니다.
OlmFolder.enumerateMessages(MailQuery query) - 검색 기준에 따라 OlmMessageInfo를 반복할 수 있는 열거자를 제공합니다.

아래 코드 샘플은 이러한 메서드 사용을 보여줍니다:

 // Enumerates all messages in a given folder

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages()) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates a range of messages in a given folder

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   int startIndex = 10;

   int count = 100;

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages(startIndex, count)) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates messages by search criteria

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

    MailQueryBuilder mailQueryBuilder = new MailQueryBuilder();

    mailQueryBuilder.getSubject().contains("invitation");

    mailQueryBuilder.getFrom().contains("Mark");

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages(mailQueryBuilder.getQuery())) {

        System.out.println(messageInfo.getSubject());

   }

} finally {

    olm.dispose();

}

// Enumerates all messages and the extraction of some of them

OlmStorage olm = OlmStorage.fromFile("fileName");

try {

    OlmFolder inbox = olm.getFolder("inbox", true);

   for (OlmMessageInfo messageInfo : inbox.enumerateMessages()) {

       if (messageInfo.hasAttachments()) {

            MapiMessage msg = olm.extractMapiMessage(messageInfo);

       }

   }

} finally {

    olm.dispose();

}

식별자를 사용한 OLM 메시지 추출

때때로 식별자를 사용해 선택된 메시지를 추출해야 할 경우가 있습니다. 예를 들어, 애플리케이션이 데이터베이스에 식별자를 저장하고 필요에 따라 메시지를 추출합니다. 이는 매번 전체 저장소를 탐색하여 특정 메시지를 찾는 비효율을 피하는 효율적인 방법입니다. OLM 파일에 이 기능을 구현하기 위해 Aspose.Email은 다음 메서드와 클래스를 제공합니다:

EntryId 속성 OlmMessageInfo 클래스 - 메시지 엔트리 식별자를 가져옵니다.
오버로드된 extractMapiMessage(String id) 메서드 OlmStorage 클래스 - OLM에서 메시지를 가져옵니다.

아래 코드 샘플은 식별자를 사용하여 OLM에서 메시지를 추출하는 방법을 보여줍니다:

for (OlmMessageInfo msgInfo : olmFolder.enumerateMessages()) {
    MapiMessage msg = storage.extractMapiMessage(msgInfo.getEntryId());
}

참고: 메시지 ID는 저장 파일 내에서 고유합니다. ID는 Aspose.Email에 의해 생성되며 다른 타사 OLM 처리 라이브러리나 앱에서 사용할 수 없습니다.

손상된 파일에서 OLM 항목 추출

Aspose.Email은 가능한 한 모든 OLM 항목을 추출할 수 있는 순회 API를 제공하며, 원본 파일의 일부 데이터가 손상되었더라도 예외를 발생시키지 않습니다.

다음 사용 OlmStorage(TraversalExceptionsCallback callback) 생성자와 load(String fileName) 메서드 대신에 fromFile 메서드.

생성자를 통해 콜백 메서드를 정의할 수 있습니다.

OlmStorage olm = new OlmStorage(new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
});

로드 및 탐색 중 발생한 예외는 콜백 메서드를 통해 확인할 수 있습니다.

TraversalExceptionsCallback exceptionsCallback = new TraversalExceptionsCallback() {
    public void invoke(TraversalAsposeException exception, String itemId) {
        /* Exception handling  code. */
    }
};
try (OlmStorage olm = new OlmStorage(exceptionsCallback)) {
    if (olm.load(fileName)) {
        List<OlmFolder> folderHierarchy = olm.getFolders();
        extractItems(olm, folderHierarchy);
    }
}

private static void extractItems(OlmStorage olm, List<OlmFolder> folders) {
    for (OlmFolder folder : folders) {
        if (folder.hasMessages()) {
            System.out.println(folder);

            for (MapiMessage msg : olm.enumerateMessages(folder)) {
                System.out.println(msg.getSubject());
            }
        }

        if (folder.getSubFolders().size() > 0) {
            extractItems(olm, folder.getSubFolders());
        }
    }
}

메시지 수정 날짜 가져오기

다음은 OlmMessageInfo.getModifiedDate 메시지 수정 날짜를 가져올 수 있는 속성.

for (OlmMessageInfo messageInfo : inboxFolder.enumerateMessages()) {
    Date modifiedDate = messageInfo.getModifiedDate();
}

Java: 대용량 PST 파일 작업

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

대용량 개인 저장소 테이블(PST) 파일을 처리하면 성능이 저하되고 메모리 사용량이 증가할 수 있습니다. Aspose.Email for Java는 개발자가 시스템 리소스를 과부하시키지 않으면서 메일함 데이터를 효율적으로 액세스, 처리 및 관리할 수 있도록 여러 기술과 API를 제공합니다.

폴더와 메시지를 순회하기 위해 Iterable 메서드를 사용하세요

폴더와 메시지를 반복할 때는 반환하는 메서드를 선호합니다 Iterable. 이로 인해 메모리 오버헤드가 감소하고 성능이 향상됩니다.

try (PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {
    for (FolderInfo folder : pst.getRootFolder().enumerateFolders()) {
        for (MessageInfo messageInfo : folder.enumerateMessages()) {
            // Process message
        }
    }
}

MessageInfo를 사용하여 기본 메시지 속성을 가져오세요

기본 메시지 세부 정보만 필요한 경우, 사용하세요 MessageInfo 전체 메시지를 로드하는 대신에 사용하십시오. 이것이 더 빠르고 메모리 사용량이 적습니다.

for (MessageInfo messageInfo : folder.enumerateMessages()) {
    System.out.println("Subject: " + messageInfo.getSubject());
    System.out.println("To: " + messageInfo.getDisplayTo());
    System.out.println("Importance: " + messageInfo.getImportance());
    System.out.println("Message Class: " + messageInfo.getMessageClass());
}

필요하지 않을 경우 전체 메시지 추출을 피하십시오

사용하지 마십시오 ExtractMessage 또는 EnumerateMapiMessages 모든 속성이 필요하지 않은 한 모든 메시지에 대한 메서드.

대신 다음을 고려하십시오:

a) 메시지 ID 가져오기

사용 enumerateMessagesEntryId 폴더의 모든 메시지 ID를 가져옵니다. 이후 선택적으로 속성, 메시지 또는 첨부 파일을 추출할 수 있습니다.

for (String id : folder.enumerateMessagesEntryId()) {
    // Retrieve a property using ID (extractProperty),
    // Extract a MapiMessage (extractMessage),
    // Extract message attachments (extractAttachments),
    // Save message to a stream (saveMessageToStream).
}

b) 단일 속성 추출

사용 ExtractProperty 특정 속성만 필요하고 누락된 경우 MessageInfo.

for (String msgId : folder.enumerateMessagesEntryId()) {
    String transportMessageHeaders =
        pst.extractProperty(
            org.apache.commons.codec.binary.Base64.decodeBase64(msgId),
            KnownPropertyList.TRANSPORT_MESSAGE_HEADERS.getTag()
        ).getString();
}

c) 첨부 파일만 추출

첨부 파일만 필요한 경우, 다음을 사용하십시오 ExtractAttachments.

for (String msgId : folder.enumerateMessagesEntryId()) {
    MapiAttachmentCollection attachments = pst.extractAttachments(msgId);
}

검색 기준을 사용해 메시지 필터링

다음으로 메시지 필터링 검색 기준 로드되는 메시지 수를 줄이고 성능을 향상시킵니다.

try (PersonalStorage pst = PersonalStorage.fromFile("storage.pst")) {

    PersonalStorageQueryBuilder builder = new PersonalStorageQueryBuilder();
    // Unread messages
    builder.hasNoFlags(MapiMessageFlags.MSGFLAG_READ);

    for (FolderInfo folder : pst.getRootFolder().enumerateFolders()) {
        MessageInfoCollection unread = folder.getContents(builder.getQuery());
    }
}

메시지를 스트림에 저장

메시지를 하나씩 추출하고 저장하는 대신에, 다음을 사용하십시오 SaveMessageToStream 더 나은 성능을 위해.

for (String id : folder.enumerateMessagesEntryId()) {
    try (OutputStream fos  = new FileOutputStream("message.msg")) {
        pst.saveMessageToStream(id, fos);
    }
}

가능하면 대량 메서드 사용

필요할 때마다 추가 또는 delete 다수의 항목에 대해 개별 작업보다 대량 메서드를 사용하는 것이 좋습니다. 이는 오버헤드를 줄이고 성능을 향상시킵니다.