Skip to content

Latest commit

 

History

History
177 lines (147 loc) · 6.65 KB

README.md

File metadata and controls

177 lines (147 loc) · 6.65 KB

Disclaimer

This is a small facade to the java-libpst project(s)

see paragraph Original...

things added:

  • an Extractor class mainly for extracting attachments
  • adding a simple (and not robust!) command line interface
  • allowing filter relevant message by messageId
  • allowing filter relevant messages by foldername (Displayname) and arbitrary text in message

binary releases

Want to start fast working? Download one of the GRAAL-VM 21 binary releases... (i don't have tested them yet)

how export is done:

technically

Opens a pst file, retrieving relevant messages and exports attachments as files with names like

  • message_id + "_" + attachmentFileName

Ensuring file creation can successfully be done (on every system linuxoid, win...) without overwrite multiple attachments (e.g. with equal names but different cases):

  • uppercase filename testet and eventually suffixed with an ordinal number, if there are multiple versions of the same (uppercase) filename
  • example
    • attachments in message with id 554411: MyAttachment.jpg and myAttachment.jpg
      • generated files
        • 554411_MyAttachment.jpg
        • 554411_myAttachment_2.jpg

example call

  java-libpst path/to/pst 1925551 path/to/outputDir 
  java-libpst path/to/pst all path/to/outputDir 
  java-libpst path/to/pst all path/to/outputDir -fMyFolderNamePart -mSomeRelevantMessageContent
  java-libpst path/to/pst all path/to/outputDir -fMyFolderNamePart
  java-libpst path/to/pst all path/to/outputDir -mSomeRelevantMessageContent
  • Variant a) by messageId: the message is located by id, all attachments will be exported as file (filter expressions are ignored!)
  • Variant b) by switch "ALL": all message and all attachments will be exported as file(s)
  • Variant c,d,e) by switch "ALL" and switches [-f] AND/OR [-m]
    • all pst folders are searched (if given, filtered by -f-expression)
    • all messages in filtered folders are searched by given -m-expression

things to do:

  • make command line robust (a plenty of libs are in the wild)
  • enable search with regex
  • export not only attachments
  • enable password protected pst export

Original (readme from https://github.com/rjohnsondev)

The PST File format is used by Outlook for the storage of emails. Over the years many people have accumulated a large amount of important email and other information into these files, this project aims to allow people to access and extract this information so that it may be migrated to other messaging systems.

This project was originally based off the documentation created through the fantastic reverse engineering effort made by the libpff project. The library has been improved with information provided by the release of the official PST specs by Microsoft.

The functional goals are:

  • Efficiency; should be able to work with very large PST files with reasonable speed
  • Support for compressible encryption (on by default with newer versions of Outlook)
  • Intuitive API
  • Support for ANSI (32bit), Unicode (64bit) Outlook PST and Exchange OST Files.

Things that the library will most likely not do:

  • Fix or work with broken PST files
  • Provide write access to PST files
  • Recover deleted email items

For example usage of the library please see the TestGui application stored in the examples folder. Javadocs are available here: http://rjohnsondev.github.io/java-libpst

Accessing the contents of a PSTFile is a matter of following the folder structure down to the desired email. This example reads a PST and prints the tree structure to the console:

package example;
import com.pff.*;
import java.util.*;

public class Test {
    public static void main(String[] args)
    {
        new Test(args[0]);
    }

    public Test(String filename) {
        try {
            PSTFile pstFile = new PSTFile(filename);
            System.out.println(pstFile.getMessageStore().getDisplayName());
            processFolder(pstFile.getRootFolder());
        } catch (Exception err) {
            err.printStackTrace();
        }
    }

    int depth = -1;
    public void processFolder(PSTFolder folder)
            throws PSTException, java.io.IOException
    {
        depth++;
        // the root folder doesn't have a display name
        if (depth > 0) {
            printDepth();
            System.out.println(folder.getDisplayName());
        }

        // go through the folders...
        if (folder.hasSubfolders()) {
            Vector<PSTFolder> childFolders = folder.getSubFolders();
            for (PSTFolder childFolder : childFolders) {
                processFolder(childFolder);
            }
        }

        // and now the emails for this folder
        if (folder.getContentCount() > 0) {
            depth++;
            PSTMessage email = (PSTMessage)folder.getNextChild();
            while (email != null) {
                printDepth();
                System.out.println("Email: "+email.getSubject());
                email = (PSTMessage)folder.getNextChild();
            }
            depth--;
        }
        depth--;
    }

    public void printDepth() {
        for (int x = 0; x < depth-1; x++) {
            System.out.print(" | ");
        }
        System.out.print(" |- ");
    }
}

Attachments can be read through PSTAttachment.getFileInputStream like so:

int numberOfAttachments = email.getNumberOfAttachments();
for (int x = 0; x < numberOfAttachments; x++) {
    PSTAttachment attach = email.getAttachment(x);
    InputStream attachmentStream = attach.getFileInputStream();
    // both long and short filenames can be used for attachments
    String filename = attach.getLongFilename();
    if (filename.isEmpty()) {
        filename = attach.getFilename();
    }
    FileOutputStream out = new FileOutputStream(filename);
    // 8176 is the block size used internally and should give the best performance
    int bufferSize = 8176;
    byte[] buffer = new byte[bufferSize];
    int count = attachmentStream.read(buffer);
    while (count == bufferSize) {
        out.write(buffer);
        count = attachmentStream.read(buffer);
    }
    byte[] endBuffer = new byte[count];
    System.arraycopy(buffer, 0, endBuffer, 0, count);
    out.write(endBuffer);
    out.close();
    attachmentStream.close();
}

Each object in the PST has a unique identifier called a descriptor node id. This can be useful for retrieving known objects quickly from the PST:

long id = email.getDescriptorNodeId();
pstObject = PSTObject.detectAndLoadPSTObject(pstFile, id);