How farnulfo/pst-exp works
Project Type: This is a specialized file format parser/reader for Microsoft Outlook PST files, implemented in Java. It's a technical library focused on reading and interpreting the complex PST file format structure.
Main Components Organization
a) Interface Layer:
• Center IPSTFile interface and PSTFile implementation
• This as the main entry point for clients
b) Core Processing Layer (show as interconnected components):
• Header Processing (Header.java)
• Node Management (NDB.java, NID.java, HN.java)
• Block Management (Block.java, BTH.java)
• Page Management (pages/*)
c) Data Structure Layer:
• Message Store (MessageStore.java)
• Folder (Folder.java)
• Message (Message.java)
Key Relationships to Highlight
a) File Structure Components:
• NID → Node → Block hierarchy
• BTH (B-tree) relationships
b) Data Flow:
• How PSTFile reads Header
• Demonstrate Node B-tree navigation flow
• Property Context (PC) handling
Component Groupings
Related components:
[File Format Processing]
• Header
• Block
• Page
• CRC
[Data Structures]
• MessageStore
• Folder
• Message
• EntryID
[B-tree Components]
• BTH
• BTHHEADER
• BTENTRY
• BBTENTRY
• NBTENTRY
Technical Details
Annotations for:
• CRC verification flows
• Property data type handling
• Special internal NID processing
• Heap-on-Node structures
Implementation Notes
Notes about:
• File format version handling (ANSI/Unicode)
• Error handling paths
• Critical processing paths
• Test coverage points
Remember to include bidirectional relationships where appropriate, as PST parsing involves both forward and backward references in the file structure.
This system design should help developers understand both the high-level architecture and the detailed interactions between components necessary for parsing PST files.