Programación con Thunderbird

Leer Mensajes desde MBOX

Mozilla Thunderbird es un cliente de correo electrónico de código abierto y multiplataforma, desarrollado por la Fundación Mozilla. Almacena correos electrónicos en su propia estructura de archivos, gestionando índices de mensajes y subcarpetas a través de formatos de archivo propietarios. Aspose.Email puede trabajar con estructuras de almacenamiento de correo de Thunderbird. La clase MboxrdStorageReader permite a los desarrolladores leer mensajes del archivo de almacenamiento de correo de Mozilla Thunderbird. Este artículo muestra cómo leer los mensajes del almacenamiento de correo de Thunderbird:

Abre el archivo de almacenamiento de Thunderbird en FileStream.
Crea una instancia de la clase MboxrdStorageReader y pasa el flujo anterior al constructor.
Llama a ReadNextMessage() para obtener el primer mensaje.
Utiliza el mismo ReadNextMessage() en un bucle while para leer todos los mensajes.
Cierra todos los flujos.

El siguiente fragmento de código te muestra cómo leer todos los mensajes de un almacenamiento de correo de Thunderbird.

//Obteniendo información del marcador mientras se leen mensajes del archivo de almacenamiento Mbox
try (FileInputStream stream = new FileInputStream(dataDir + "Outlook.pst")) {
    MboxLoadOptions lo = new MboxLoadOptions();
    lo.setLeaveOpen(false);
    try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
        MailMessage msg;
        String[] fromMarker = {null};
        while ((msg = reader.readNextMessage(/* out */fromMarker)) != null) {
            System.out.println(fromMarker[0]);
        }
    }
}

Configurar Opciones de Carga al Leer Mensajes desde MBOX

La API Aspose.Email permite las siguientes manipulaciones con mensajes al leerlos desde un archivo MBOX:

Convertir Mensajes de MBOX a PST Preservando Adjuntos TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailStorageConverter.setMboxMessageOptions(emlLoadOptions);
// Convertir mensajes de mbox a pst preservando adjuntos tnef.
PersonalStorage storage = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

La propiedad MailStorageConverter.MboxMessageOptions() - Obtiene o establece las opciones de carga de correo al analizar un almacenamiento Mbox.

Leer Mensajes Preservando Adjuntos TNEF

MboxrdStorageReader reader = new MboxrdStorageReader("Input.mbox", new MboxLoadOptions());
// Leer mensajes preservando adjuntos tnef.
EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
MailMessage eml = reader.readNextMessage(emlLoadOptions);

El método MboxrdStorageReader.readNextMessage(EmlLoadOptions options) - El parámetro EmlLoadOptions especifica opciones al leer un mensaje del almacenamiento Mbox.

Enumerar Mensajes Preservando Adjuntos TNEF

EmlLoadOptions emlLoadOptions = new EmlLoadOptions();
emlLoadOptions.setPreserveTnefAttachments(true);
// Enumerar mensajes preservando adjuntos tnef.
for (MailMessage message : reader.enumerateMessages(emlLoadOptions)) {
    // hacer algo
}

El método MboxrdStorageReader.enumerateMessages(EmlLoadOptions options) - Especifica EmlLoadOptions al leer un mensaje del almacenamiento Mbox.

Extraer Mensajes de MBOX por Identificadores

A veces es necesario extraer mensajes seleccionados por identificadores. Por ejemplo, tu aplicación almacena identificadores en una base de datos y extrae un mensaje a pedido. Esta es la manera eficiente de evitar recorrer todo el almacenamiento cada vez para encontrar un mensaje específico para extraer. Para implementar esta función para archivos MBOX, Aspose.Email proporciona los siguientes métodos y clases:

La clase MboxMessageInfo con la propiedad EntryId - Obtiene el identificador de entrada.
El método enumerateMessageInfo() de la clase MboxStorageReader - Expone el enumerador, que soporta la iteración de mensajes en el almacenamiento.
El método extractMessage(String id) de la clase MboxStorageReader - Obtiene el mensaje de MBOX.

El siguiente ejemplo de código demuestra cómo extraer mensajes de MBOX por identificadores:

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

for (MboxMessageInfo msgInfo : reader.enumerateMessageInfo()) {
    MailMessage eml = reader.extractMessage(msgInfo.getEntryId(), new EmlLoadOptions());
}

Nota: El ID del mensaje es único dentro del archivo de almacenamiento. Los ID son creados por Aspose.Email y no pueden ser utilizados en otras bibliotecas o aplicaciones de procesamiento de MBOX de terceros.

Escribir Mensajes

La clase MboxrdStorageWriter proporciona la facilidad de escribir nuevos mensajes en el archivo de almacenamiento de correo de Thunderbird. Para escribir mensajes:

Abre el archivo de almacenamiento de Thunderbird en FileStream.
Crea una instancia de la clase MboxrdStorageWriter y pasa el flujo anterior al constructor.
Prepara un nuevo mensaje utilizando la clase MailMessage.
Llama al método WriteMessage() y pasa la instancia de MailMessage anterior para agregar el mensaje al almacenamiento de Thunderbird.
Cierra todos los flujos.

El siguiente fragmento de código te muestra cómo escribir mensajes en el almacenamiento de correo de Thunderbird.

//Obteniendo información del marcador mientras se escriben mensajes en el archivo de almacenamiento Mbox
try (FileOutputStream writeStream = new FileOutputStream(dataDir + "inbox")) {
    try (MboxrdStorageWriter writer = new MboxrdStorageWriter(writeStream, false)) {
        MailMessage msg = MailMessage.load(dataDir + "Message.msg");
        String[] fromMarker = {null};
        writer.writeMessage(msg, fromMarker);
        System.out.println(fromMarker[0]);
    }
}

Obteniendo el Número Total de Mensajes desde el Archivo MBox

La clase MboxrdStorageReader proporciona la capacidad de leer el número de elementos disponibles en un archivo MBox. Esto puede ser utilizado para desarrollar aplicaciones que muestren el progreso de la actividad mientras se procesa dicho archivo.

MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader("inbox.dat", lo)) {
    System.out.println("Número total de mensajes en el archivo Mbox: " + reader.getTotalItemsCount());
}

Obtener Tamaño Actual del Mensaje

FileInputStream stream = new FileInputStream(dataDir + "ExampleMbox.mbox");
MboxLoadOptions lo = new MboxLoadOptions();
try (MboxrdStorageReader reader = new MboxrdStorageReader(stream, lo)) {
    MailMessage msg = null;
    while ((msg = reader.readNextMessage()) != null) {
        //devuelve el número de bytes leídos
        long currentDataSize = reader.getCurrentDataSize();
        System.out.println("Bytes leídos: " + currentDataSize);
    }
}

Establecer Codificación de Texto Preferida al Cargar Archivos Mbox

El método setPreferredTextEncoding(Charset value) de la clase MboxLoadOptions obtiene o establece la codificación preferida para los mensajes. Crea un lector para el archivo Mbox con las opciones de carga especificadas y tus mensajes con el contenido codificado serán correctamente leídos y procesados. El siguiente ejemplo de código muestra cómo implementar esta función en un proyecto:

MboxLoadOptions lo = new MboxLoadOptions();
lo.setPreferredTextEncoding(Charset.forName("utf-8"));
MboxrdStorageReader reader = new MboxrdStorageReader("sample.mbox", lo);
MailMessage message = reader.readNextMessage();

Dividir Almacenamiento Mbox en Partes Más Pequeñas

Aspose.Email proporciona los siguientes componentes diseñados para tener más control sobre el procesamiento de almacenamiento Mbox, permitiéndote dividir archivos grandes en partes manejables e implementar acciones personalizadas durante el proceso:

El método MboxStorageReader.SplitInto(long chunkSize, String outputPath) - Te permite dividir el almacenamiento Mbox en partes más pequeñas, facilitando la gestión y el procesamiento de archivos Mbox grandes.

MboxStorageReader.SplitInto(long chunkSize, String outputPath, String partFileNamePrefix) Una variación del método anterior, este también te permite especificar un prefijo personalizado para los nombres de archivos Mbox divididos.

MboxStorageReader.setEmlCopyingEventHandler Evento Este evento ocurre antes de que un correo electrónico sea copiado a un nuevo archivo Mbox. Puedes personalizar acciones antes de que los correos sean procesados.

MboxStorageReader.setEmlCopiedEventHandler Evento Este evento ocurre después de que un correo electrónico es copiado a un nuevo archivo Mbox. Puedes realizar acciones de post-procesamiento en los correos.

MboxStorageReader.setMboxFileCreatedEventHandler Evento Este evento ocurre cuando se crea un nuevo archivo Mbox. Puedes manejar este evento para reaccionar a la creación del archivo.

MboxStorageReader.setMboxFileFilledEventHandler Evento Este evento ocurre cuando un nuevo archivo Mbox se llena con correos electrónicos. Puedes responder al archivo siendo poblado con correos.

NewStorageEventHandler(Object sender, NewStorageEventArgs e) Representa un delegado para manejar eventos que ocurren después de que se crea o procesa un nuevo archivo de almacenamiento.

MimeItemCopyEventHandler(Object sender, MimeItemCopyEventArgs e) Representa un delegado para manejar eventos relacionados con la copia de elementos Mime, típicamente usado en escenarios donde un objeto MailMessage es copiado de un almacenamiento a otro.

NewStorageEventArgs Representa argumentos usados en eventos que se generan después de que se crea un nuevo archivo de almacenamiento o después de que es procesado.

MimeItemCopyEventArgs Representa argumentos de evento relacionados con la copia de un objeto MailMessage de un almacenamiento a otro, ya sea antes de que comience la copia o después de que se complete.

El siguiente ejemplo de código demuestra cómo interactuar con archivos Mbox, manejar eventos relacionados con estos archivos y realizar operaciones como dividir el almacenamiento Mbox en partes más pequeñas mientras se lleva un seguimiento del conteo de mensajes y partes:

messageCount = 0;
partCount = 0;

// Crear una instancia de MboxrdStorageReader
MboxLoadOptions lo = new MboxLoadOptions();
lo.setLeaveOpen(false);
MboxrdStorageReader mbox = new MboxrdStorageReader("my.mbox", lo);

// Suscribirse a eventos
mbox.setMboxFileCreatedEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("Nuevo archivo Mbox creado: " + e.getFileName());
        partCount++;
    }
});

mbox.setMboxFileFilledEventHandler(new NewStorageEventHandler() {
    public void invoke(Object sender, NewStorageEventArgs e) {
        System.out.println("Archivo Mbox lleno de mensajes: " + e.getFileName());
    }
});

mbox.setEmlCopiedEventHandler(new MimeItemCopyEventHandler() {
    public void invoke(Object sender, MimeItemCopyEventArgs e) {
        System.out.println("Mensaje añadido al nuevo archivo Mbox. Asunto: " + e.getItem().getSubject());
        messageCount++;
    }
});

// Dividir el almacenamiento Mbox en partes más pequeñas
mbox.splitInto(10000000, testOutPath, "Prefix");

// Salida del conteo final de mensajes y partes
System.out.println("Total de mensajes añadidos: " + messageCount);
System.out.println("Total de partes creadas: " + partCount);

Programación con Gmail Trabajando con Zimbra