mstor
Home :: Features :: Wiki :: Documentation :: News :: Support :: Download :: License
Overview »
mstor is a local store provider for JavaMail. Based on the mbox format, mstor facilitates the storage and retrieval of email messages in the local filesystem. In addition, mstor supports additional metadata not inherently supported by the mbox format, and is designed to handle large mailboxes without a significant degradation in performance.
Usage »
To use mstor as a JavaMail provider simply include the mstor, commons-logging and jdom JARs in your classpath. The protocol supported by mstor is called "mstor" and there are no authentication requirements.

An example url for accessing an mstor mailbox might be: mstor:c:/mail on a Microsoft Windows machine, or mstor:/home/me/mail on a Unix box.

Reading messages from a local store 

Session session = Session.getDefaultInstance(new Properties());

Store store = session.getStore(new URLName("mstor:c:/mailbox/MyStore"));
store.connect();

// read messages from Inbox..
Folder inbox = store.getDefaultFolder().getFolder("Inbox");
inbox.open(Folder.READ_ONLY);

Message[] messages = inbox.getMessages();
Popularity »
SourceForge.net Download Statistics
Version Information »
0.9
  • Initial release
0.9.1
  • Interim release
  • Improved metadata implementation
0.9.2
  • Interim release
  • Support for subfolders and messages in the same folder
0.9.3
  • Interim release
  • Added validation of mbox files
  • Support for headers in metadata
  • Better error handling for Java New I/O issues (Windows 98)
0.9.4
  • Interim release
  • Reimplemented mbox support for greater efficiency and compatibility
  • Improved memory performance with large mailboxes
  • See CHANGELOG for further details
0.9.5
  • Interim release
  • Fixed problems with mailbox modification
  • Added configuration properties for better compatibility (see README for details)
  • Restored Java 1.4 compatibility
  • Restored default encoding to "ISO-8859-1"
  • See CHANGELOG for further details
0.9.6
  • Interim release
  • Resolved major bug with 0.9.5 causing mbox files to be read incorrectly
  • Other bug fixed (see CHANGELOG for details)
0.9.7
  • Interim release
  • Resolved bug regarding message count and content not updating correctly after appending messages to a folder.
  • Implemented more event support
0.9.8
  • Alpha release
  • Added option to disable direct buffers
  • Added support for message tags
  • Added support for persisting search terms
  • Other bug fixes (see CHANGELOG for details)
0.9.9
  • Alpha release
  • Replaced missing javamail.providers file in JAR
  • Added support for capability hints
  • Other bug fixes (see CHANGELOG for details)
0.9.x
  • Milestone release
1.0
  • Stable Release
Dependencies »