Documentation – .NET에서 Thunderbird MBOX 파일 읽기 및 변환 방법

Net: C#에서 Aspose.Email을 사용해 MBOX 파일 읽기

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

Aspose.Email 읽기 기능

Mozilla Thunderbird Mozilla Foundation에서 개발한 오픈소스 크로스 플랫폼 이메일 클라이언트입니다. 자체 파일 구조에 이메일을 저장하며, 메시지 인덱스와 하위 폴더를 독자적인 파일 형식으로 관리합니다. Thunderbird는 각 이메일 폴더(예: Inbox, Sent, Trash)마다 하나의 .mbox 파일을 생성하고, 이 파일들을 사용자의 프로필 디렉터리에 저장합니다. 각 파일은 해당 폴더의 모든 메시지를 연결된 형태로 포함합니다.

Aspose.Email for .NET은 Thunderbird .mbox 파일에서 메시지를 읽기 위한 API를 제공하며, 사용 방법은 MboxrdStorageReader 개발자가 할 수 있도록 하는 클래스:

메시지를 순차적으로, 하나씩 열고 읽습니다
전체 내용을 로드하지 않고 Subject, From, To, Date 등 메타데이터를 검색합니다
고유 식별자(EntryId)를 사용하여 개별 메시지를 추출합니다
인코딩, TNEF 첨부 파일 및 서식 유지
대용량 아카이브에서 성능을 향상시키기 위해 파일을 비동기적으로 읽기

MBOX 파일을 동기적으로 읽기

Mozilla Thunderbird 메일 저장 파일에서 메시지를 읽습니다. 이 문서는 Thunderbird 이메일 저장소에서 메시지를 읽는 방법을 보여줍니다:

FileStream에서 Thunderbird 저장소 파일을 엽니다.
다음의 인스턴스를 생성합니다. MboxrdStorageReader 클래스를 사용하고 위의 스트림을 생성자에 전달합니다.
호출하십시오 ReadNextMessage() 첫 번째 메시지를 가져오기 위해.
같은 것을 사용하십시오 ReadNextMessage() while 루프에서 모든 메시지를 읽습니다.
모든 스트림을 닫습니다.

다음 코드 스니펫은 Thunderbird 메일 저장소에서 모든 메시지를 읽는 방법을 보여줍니다.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read);
// Create an instance of the MboxrdStorageReader class and pass the stream
var reader = new MboxrdStorageReader(stream, false);
// Start reading messages
var message = reader.ReadNextMessage();

// Read all messages in a loop
while (message != null)
{
    // Manipulate message - show contents
    Console.WriteLine("Subject: " + message.Subject);
    // Save this message in EML or MSG format
    message.Save(message.Subject + ".eml", SaveOptions.DefaultEml);
    message.Save(message.Subject + ".msg", SaveOptions.DefaultMsgUnicode);

    // Get the next message
    message = reader.ReadNextMessage();
}

// Close the streams
reader.Dispose();
stream.Close();

MBOX 파일을 비동기적으로 읽기

대용량 MBOX 파일을 처리할 때 성능 및 반응성을 향상시키기 위해 Aspose.Email for .NET은 다음을 통해 비동기 MBOX 읽기를 제공합니다: CreateReaderAsync 이 메서드. 이 기능은 대용량 이메일 아카이브를 처리하거나 백그라운드 스레드나 웹 서비스에서 I/O 중심 작업을 수행하는 애플리케이션에 특히 유용합니다. 아래 코드 샘플은 Aspose.Email 스토리지 리더를 사용하여 MBOX 파일에서 이메일 메시지를 비동기적으로 읽는 방법을 보여줍니다:

string mboxFilePath = "emails.mbox";

    // Create a reader for the MBOX file asynchronously
    using (var reader = await MboxrdStorageReader.CreateReaderAsync(mboxFilePath, CancellationToken.None))
    {
    Console.WriteLine("MBOX reader initialized.");

    // Read messages from the MBOX file
        while (reader.ReadNextMessage() is var message && message != null)
        {
            Console.WriteLine($"Subject: {message.Subject}");
        }
    }

페이지 매김을 지원하는 배치 단위 이메일 메시지 읽기

메일함 파일에 저장된 메시지에 대해 페이지화된 접근을 얻습니다. 이 기능은 메시지를 작은 부분으로 가져와 대용량 이메일 아카이브를 보다 효율적으로 처리할 수 있게 하여 성능을 향상하고 메모리 부하를 감소시킵니다. 다음 메서드를 사용하십시오: MboxStorageReader 클래스:

EnumerateMessages(int startIndex, int count) - 지정된 인덱스부터 시작하여 주어진 개수만큼 제한된 MailMessage 인스턴스의 열거 가능한 컬렉션을 반환합니다.
EnumerateMessageInfo(int startIndex, int count) - 메타데이터만 포함한 MboxMessageInfo 객체의 열거 가능한 컬렉션을 반환하며, 인덱스와 개수에 따라 페이지화됩니다.

아래 코드 샘플은 시작 인덱스와 배치 크기를 정의하여 메일 아카이브에서 특정 범위의 메시지를 읽는 방법을 보여줍니다. 예제에서는 해당 메서드가 인덱스 0부터 시작하여 10개의 메시지를 가져옵니다.

using Aspose.Email.Storage.Mbox;
using Aspose.Email;

var reader = MboxStorageReader.CreateReader("input.mbox", new MboxLoadOptions());
int startIndex = 0;
int count = 10; // Retrieve messages in batches of 10

foreach (var message in reader.EnumerateMessages(startIndex, count))
{
    Console.WriteLine("Subject: " + message.Subject);
}

MBOX 파일을 읽을 때 선호 텍스트 인코딩 설정

인코딩 옵션은 다음에 사용할 수 있습니다. MboxrdStorageReader 클래스. 이는 mbox 파일을 로드하기 위한 추가 옵션을 제공하며, 인코딩된 내용이 있는 메시지가 올바르게 읽히고 처리되도록 보장합니다. 다음 코드 조각은 필요에 맞는 텍스트 인코딩을 설정하는 방법을 보여줍니다:

var reader = new MboxrdStorageReader("sample.mbox", new MboxLoadOptions() { PreferredTextEncoding = Encoding.UTF8});
var message = reader.ReadNextMessage();

MBOX 파일의 총 메시지 수 가져오기

다음은 MboxrdStorageReader 클래스는 MBox 파일에 존재하는 항목 수를 읽을 수 있는 기능을 제공합니다. 이는 파일을 처리하는 동안 작업 진행 상황을 표시하는 애플리케이션 개발에 사용할 수 있습니다.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    Console.WriteLine("Total number of messages in Mbox file: " + reader.GetTotalItemsCount());
}

현재 메시지 크기 가져오기

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    MailMessage msg;
    while ((msg = reader.ReadNextMessage()) != null)
    {
        long currentDataSize = reader.CurrentDataSize;

        msg.Dispose();
    }
}

Net: C#에서 Aspose.Email을 사용하여 MBOX 메시지 필터링 및 추출

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

메시지 필터링의 역할

대용량 MBOX 아카이브를 다룰 때 모든 메시지를 메모리로 로드하는 것은 비효율적이고 불필요할 수 있습니다. 대부분의 경우 개발자는 제목, 발신자, 수신자 또는 타임스탬프와 같은 기본 메타데이터만 스캔하면 됩니다:

UI에 메시지 목록 표시
추출 전에 사용자 정의 필터 적용
보고서 또는 요약 생성
검색을 위한 메시지 인덱싱

필터링은 전체 메시지 본문이나 첨부 파일을 파싱하는 비용을 줄여 애플리케이션을 더 빠르고 확장 가능하게 합니다.

메시지 메타데이터 접근

Aspose.Email은 다음을 제공합니다 MboxMessageInfo 전체 MailMessage 내용을 읽지 않고 기본 메시지 메타데이터에 접근하도록 설계된 클래스입니다. 요약 객체 역할을 하며 호출 시 반환됩니다 MboxStorageReader.EnumerateMessageInfo().

다음이 노출하는 주요 속성: MboxMessageInfo 메시지 정보를 가져오기 위해 포함합니다:

DateTime Date - 메시지 날짜를 가져옵니다.
MailAddress From - 발신자 주소를 가져옵니다.
string Subject - 메시지 제목을 가져옵니다.
MailAddressCollection To - 메시지 수신자를 포함하는 주소 컬렉션을 가져옵니다.
MailAddressCollection CC - CC 수신자를 포함하는 주소 컬렉션을 가져옵니다.
MailAddressCollection Bcc - 메시지의 BCC 수신자를 포함하는 주소 컬렉션을 가져옵니다.

MboxStorageReader reader = MboxStorageReader.CreateReader(fileName, new MboxLoadOptions());

foreach (var mboxMessageInfo in reader.EnumerateMessageInfo())
{
    Console.Writeline($"Subject: {mboxMessageInfo.Subject}");
    Console.Writeline($"Date: {mboxMessageInfo.Date}");
    Console.Writeline($"From: {mboxMessageInfo.From}");
    Console.Writeline($"To: {mboxMessageInfo.To}");
    Console.Writeline($"CC: {mboxMessageInfo.CC}");
    Console.Writeline($"Bcc: {mboxMessageInfo.Bcc}");
}

EntryId로 메시지 추출

다음은 MboxStorageReader 클래스는 EnumerateMessageInfo() 메서드는 MBOX 파일의 각 메시지를 반복할 수 있게 해줍니다. 이 메서드를 사용하면 전체 저장소를 반복적으로 탐색할 필요 없이 개별 메시지를 추출할 수 있어 성능이 향상되고 처리 시간이 단축됩니다.

다음은 MboxMessageInfo class는 다음을 제공합니다 EntryId 속성은 MBOX 파일 내 각 메시지의 고유 식별자에 접근할 수 있게 해줍니다. 이 식별자는 데이터베이스에 저장하거나 필요 시 특정 메시지를 빠르게 찾고 추출하는 참조로 사용할 수 있습니다.

다음은 ExtractMessage(string id) 메서드가 MboxStorageReader 클래스는 개발자가 고유한 EntryId를 기반으로 메시지를 추출할 수 있도록 합니다. 이를 통해 ExtractMessage(string id) 메서드를 사용하면 저장된 EntryId를 활용해 해당 메시지를 가져오고 추가 작업을 수행할 수 있습니다.

다음 코드 예제는 식별자를 사용하여 MBOX 파일에서 메시지를 추출하는 방법을 보여줍니다.

MboxStorageReader reader = MboxStorageReader.CreateReader("my.mbox", new MboxLoadOptions());

foreach (MboxMessageInfo msgInfo in reader.EnumerateMessageInfo())
{
    MailMessage eml = reader.ExtractMessage(msgInfo.EntryId, new EmlLoadOptions());
}

MailQuery를 사용한 MBOX 이메일 필터링 및 검색

Aspose.Email for .NET은 사용자 지정 쿼리를 기반으로 메일함 아카이브 내 메시지를 필터링하거나 검색할 수 있는 기능을 제공합니다. 이를 통해 개발자는 특정 기준에 일치하는 메시지만 조회하여 대용량 이메일 아카이브 작업 시 성능과 사용성을 향상시킬 수 있습니다.

다음 코드 샘플은 MailQuery API를 사용해 메일 저장 파일에 검색 기준을 적용하는 방법을 보여줍니다. 이 예제에서는 제목에 "Project Update"가 포함되고 오늘 날짜 이전에 전송된 메시지를 선택합니다.

using Aspose.Email.Storage.Mbox;
using Aspose.Email;

var reader = MboxStorageReader.CreateReader("input.mbox", new MboxLoadOptions());
var mqb = new MailQueryBuilder();
mqb.Subject.Contains("Project Update");
mqb.SentDate.Before(DateTime.Today);

foreach (var message in reader.EnumerateMessages(mqb.GetQuery()))
{
    Console.WriteLine("Subject: " + message.Subject);
}

MBOX에서 메시지를 읽을 때 로드 옵션 구성

다음 기능을 사용하면 메시지 로드 및 처리를 위한 다양한 옵션을 지정할 수 있습니다:

MailStorageConverter.MboxMessageOptions 속성 - Mbox 저장소를 구문 분석할 때 이메일 로드 옵션을 가져오거나 설정합니다.
MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) 메서드 - EmlLoadOptions 매개변수는 Mbox 저장소에서 메시지를 읽을 때 옵션을 지정합니다.

var reader = new MboxrdStorageReader(fileName, new MboxLoadOptions());
// Read messages preserving tnef attachments.
var eml = reader.ReadNextMessage(new EmlLoadOptions {PreserveTnefAttachments = true});
MailStorageConverter.MboxMessageOptions(new EmlLoadOptions {PreserveTnefAttachments = true});
// Convert messages from mbox to pst preserving tnef attachments.
var pst = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

Net: C#에서 Aspose.Email을 사용하여 MBOX 파일 쓰기

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

MBOX 파일 쓰기

프로그래밍 방식으로 MBOX 파일을 생성하거나 업데이트해야 하는 경우 Aspose.Email을 사용하십시오 MboxrdStorageWriter Thunderbird 메일 저장 파일에 새 메시지를 쓸 수 있게 하는 클래스.

다음 코드 조각은 Thunderbird 메일 저장소에 메시지를 쓰는 방법을 보여줍니다:

FileStream에서 Thunderbird 저장소 파일을 엽니다.
다음의 인스턴스를 생성합니다. MboxrdStorageWriter 클래스를 사용하고 위의 스트림을 생성자에 전달합니다.
다음을 사용하여 새 메시지를 준비합니다. MailMessage 클래스.
다음을 호출합니다. WriteMessage() 메서드와 위의 값을 전달합니다. MailMessage 인스턴스를 사용하여 메시지를 Thunderbird 저장소에 추가합니다.
모든 스트림을 닫습니다.

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Write);

// Initialize MboxStorageWriter and pass the above stream to it
var writer = new MboxrdStorageWriter(stream, false);
// Prepare a new message using the MailMessage class
var message = new MailMessage("from@domain.com", "to@domain.com", Guid.NewGuid().ToString(), "added from Aspose.Email");
message.IsDraft = false;
// Add this message to storage
writer.WriteMessage(message);
// Close all related streams
writer.Dispose();
stream.Close();

Net: C#에서 Aspose.Email을 사용해 MBOX를 PST로 변환

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

MBOX를 PST로 변환. 기본 변환

Mozilla Thunderbird와 같은 클라이언트에서 Microsoft Outlook으로 메일 데이터를 마이그레이션할 때 MBOX 아카이브를 PST(Personal Storage Table) 형식으로 변환해야 하는 경우가 많습니다. PST 형식은 Outlook 및 Exchange의 기본 형식이며 폴더 구조와 MAPI 기반 메시지 처리를 포함한 고급 기능을 지원합니다.

Aspose.Email for .NET은 개발자가 MBOX 파일의 메시지를 Outlook 호환 저장소로 수동 전송하면서 변환 과정을 완전히 제어할 수 있게 합니다. 아래 예제는 MBOX 아카이브에서 메시지를 로드하고 구조화된 Outlook 데이터 파일에 저장하는 방법을 보여줍니다:

다음으로 MBOX 리더를 초기화합니다 MboxStorageReader.CreateReader().
다음으로 PST 파일을 생성합니다 PersonalStorage.Create().
저장소에 메일 폴더(예: “Inbox”)를 추가합니다.
각 메시지를 순회하면서, 이를 MapiMessage, 그리고 폴더에 삽입합니다.

// Load the source file
var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

// Create the destination Outlook data file
using (var personalStorage = PersonalStorage.Create(pstFilePath, FileFormatVersion.Unicode))
{
    // Add a folder to hold imported messages
    var folderInfo = personalStorage.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);

    // Process each message from the source file
    foreach (var eml in mbox.EnumerateMessages())
    {
        var msg = MapiMessage.FromMailMessage(eml);
        folderInfo.AddMessage(msg);
    }
}

변환 중 디지털 서명 제거

일부 경우 메시지에 포함된 디지털 서명이 대상 파일에 필요하지 않을 수 있습니다. 전송 중에 이를 제외하려면 다음을 설정하십시오: RemoveSignature 속성은 MboxToPstConversionOptions true 로 설정합니다.

다음 코드 예제는 이 속성을 활용하는 방법을 보여줍니다:

var pstDataStream = new MemoryStream();
var personalStorage = PersonalStorage.Create(pstDataStream, FileFormatVersion.Unicode);
MailStorageConverter.MboxToPst(new MboxrdStorageReader(new FileStream(fileName, FileMode.Open, FileAccess.Read), new MboxLoadOptions()),
personalStorage,
    "Inbox",
new MboxToPstConversionOptions() { RemoveSignature = true });

Net: C#에서 Aspose.Email을 사용하여 MBOX 파일 분할

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

MBOX 저장소 분할/분할 작업 취소

Aspose.Email은 대용량 사서함 파일을 관리하기 쉬운 조각으로 나누는 메서드를 제공합니다. 이는 특히 방대한 이메일 아카이브를 다룰 때 성능과 메모리 효율성을 향상시킵니다. 사용 가능한 분할 옵션은 사용 중인 .NET 버전에 따라 다릅니다.

.NET 버전별 지원 API

.NET Framework 4.5 및 .NET Core용

다음 방법을 사용해 MBOX 데이터를 세분화할 수 있습니다 SplitInto 메서드 MboxStorageReader 클래스이며, 취소 토큰을 포함하거나 출력 파일 이름을 사용자 정의할 옵션이 있습니다:

매개변수:

chunkSize: 각 청크의 대략적인 크기(바이트)입니다.
outputPath: 청크가 생성될 폴더 경로입니다.
partFileNamePrefix: 각 파트 파일 이름에 추가되는 접두사입니다.
token: 작업 취소가 가능한 CancellationToken입니다.

.NET 4.5 미만 버전용

이전 버전에서도 동일하게 지원됩니다 SplitInto 취소 토큰 없이 메서드:

SplitInto(long chunkSize, string outputPath)
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix)
Cancel() - 분할 과정을 중간에 중단하는 데 사용됩니다.

취소 기능을 포함한 제어된 분할 코드 샘플

다음 코드 샘플은 아카이브를 최대 5개 파트로 분할하고 이후 자동으로 작업을 취소하는 방법을 보여줍니다:

.NET 4.5 / .NET Core

int partCount = 0;

var tokenSource = new CancellationTokenSource();

var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });

// Subscribe to events
mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        tokenSource.Cancel();
};

System.Threading.Tasks.Task task = mbox.SplitInto(10000000, outputPath, tokenSource.Token);
task.Wait();

.NET 4.5 이하

int partCount = 0;
var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });
mbox.SplitInto(10000000, outputPath);

mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        mbox.Cancel();
};

대용량 MBOX 파일을 비동기적으로 분할

대용량 이메일 아카이브를 다루는 것은 비효율적이고 메모리를 많이 소모할 수 있습니다. 성능과 관리성을 향상시키기 위해 Aspose.Email for .NET은 비동기 SplitIntoAsync 메서드로, 메인 스레드를 차단하지 않고 큰 파일을 작은 조각으로 분할할 수 있습니다. 아래 코드 샘플은 사용 방법을 보여줍니다 MboxStorageReader.CreateReaderAsync 큰 MBOX 파일을 비동기적으로 열고 다음을 호출합니다 SplitIntoAsync 이를 최대 10 MB 크기의 작은 파일들로 나눕니다. 결과 조각들은 지정된 출력 디렉터리에 "chunk_" 접두사를 사용하여 저장됩니다.

using (var reader = await MboxStorageReader.CreateReaderAsync("input.mbox", new MboxLoadOptions()))
{
    await reader.SplitIntoAsync(10 * 1024 * 1024, "outputDirectory", "chunk_", CancellationToken.None);
}