Trabajando con Archivos Adjuntos y Objetos Embebidos

Gestionando Archivos Adjuntos en Email

Un archivo adjunto en un correo electrónico es un archivo que se envía junto con un mensaje de correo electrónico. El archivo puede enviarse como un mensaje separado así como parte del mensaje al cual está adjunto. La clase Attachment se utiliza con la clase MailMessage. Todos los mensajes incluyen un cuerpo. Además del cuerpo, es posible que desee enviar archivos adicionales. Estos se envían como adjuntos y se representan como una instancia de la clase Attachment. Puede enviar cualquier número de archivos adjuntos, pero el tamaño del archivo adjunto está limitado por el servidor de correo. Gmail, por ejemplo, no admite tamaños de archivo mayores a 10MB.

¡Pruébalo!

Agrega o elimina archivos adjuntos a correos electrónicos en línea con la gratuita Aspose.Email Editor App.

Agregando un Archivo Adjunto

Para adjuntar un archivo a un correo electrónico, siga estos pasos:

Cree una instancia de la clase MailMessage.
Cree una instancia de la clase Attachment.
Cargue el archivo adjunto en la instancia de Attachment.
Agregue la instancia de Attachment a la instancia de MailMessage.

El siguiente fragmento de código muestra cómo agregar un archivo adjunto a un correo electrónico.

// Crear una instancia de la clase MailMessage
MailMessage message = new MailMessage();
message.setFrom(new MailAddress("sender@from.com"));
message.getTo().add("receiver@to.com");
message.setSubject("Este es un mensaje");
message.setBody("Este es el cuerpo");

// Cargar un archivo adjunto
Attachment attachment = new Attachment("1.txt");

// Agregar múltiples archivos adjuntos en la instancia de la clase MailMessage y guardar el mensaje en disco
message.getAttachments().addItem(attachment);
message.addAttachment(new Attachment("1.jpg"));
message.addAttachment(new Attachment("1.doc"));
message.addAttachment(new Attachment("1.rar"));
message.addAttachment(new Attachment("1.pdf"));
message.save("AddAttachments.eml");

Arriba, describimos cómo agregar archivos adjuntos a su mensaje de correo electrónico con Aspose.Email. Lo que sigue muestra cómo eliminar archivos adjuntos y mostrar información sobre ellos en la pantalla.

Eliminando un Archivo Adjunto

Para eliminar un archivo adjunto, siga los pasos a continuación:

Cree una instancia de la clase Attachment.
Cargue el archivo adjunto en la instancia de la clase Attachment.
Agregue el archivo adjunto a la instancia de la clase MailMessage.
Elimine los archivos adjuntos de la instancia de la clase Attachment utilizando la instancia de la clase MailMessage.

El siguiente fragmento de código muestra cómo eliminar un archivo adjunto.

// Crear una instancia de la clase MailMessage
MailMessage eml = new MailMessage();
eml.setFrom(new MailAddress("sender@from.com"));
eml.getTo().add("receiver@to.com");

// Cargar un archivo adjunto
Attachment attachment = new Attachment("1.txt");
eml.getAttachments().addItem(attachment);

// Eliminar el archivo adjunto de su MailMessage
eml.getAttachments().removeItem(attachment);

Mostrando el Nombre del Archivo Adjunto

Para mostrar el nombre del archivo adjunto, siga estos pasos:

Recorra los archivos adjuntos en el mensaje de correo electrónico y
1. Guarde cada archivo adjunto.
2. Muestre cada nombre de archivo adjunto en la pantalla.

El siguiente fragmento de código muestra cómo mostrar el nombre de un archivo adjunto en la pantalla.

MailMessage eml = MailMessage.load("Attachments.eml");

for (Attachment attachment : eml.getAttachments()) {
    // Mostrar el nombre del archivo adjunto
    System.out.println(attachment.getName());
}

Extrayendo Archivos Adjuntos de Emails

Este tema explica cómo extraer un archivo adjunto de un archivo de correo electrónico. Un archivo adjunto en un correo electrónico es un archivo que se envía junto con un mensaje de correo electrónico. El archivo puede enviarse como un mensaje separado así como parte del mensaje al cual está adjunto. Todos los mensajes de correo electrónico incluyen una opción para enviar archivos adicionales. Estos se envían como archivos adjuntos y se representan como instancias de la clase Attachment. La clase Attachment se utiliza con la clase MailMessage para trabajar con archivos adjuntos. Para extraer archivos adjuntos de un mensaje de correo electrónico, siga estos pasos:

Cree una instancia de la clase MailMessage.
Cargue un archivo de correo electrónico en la instancia de MailMessage.
Cree una instancia de la clase Attachment y úsela en un bucle para extraer todos los archivos adjuntos.
Guarde el archivo adjunto y muéstrelo en la pantalla.

Archivos adjuntos extraídos en email

El siguiente fragmento de código muestra cómo extraer archivos adjuntos de email.

MailMessage eml = MailMessage.load("Message.eml", new MsgLoadOptions());

for (Attachment attachment : eml.getAttachments()) {
    attachment.save("MessageEmbedded_out.eml");
    System.out.println(attachment.getName());
}

Recuperando el Content-Description del Archivo Adjunto

La API Aspose.Email proporciona la capacidad de leer el Content-Description del archivo adjunto desde el encabezado del archivo adjunto. El siguiente fragmento de código muestra cómo recuperar la descripción del contenido del archivo adjunto.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");
System.out.println(eml.getAttachments().get_Item(0).getHeaders().get_Item("Content-Description"));

Determinando si un Archivo Adjunto es un Mensaje Embebido

El siguiente fragmento de código demuestra cómo determinar si el archivo adjunto es un mensaje embebido o no.

MailMessage eml = MailMessage.load("EmailWithAttachEmbedded.eml");

System.out.println(eml.getAttachments().get_Item(0).isEmbeddedMessage()
        ? "El archivo adjunto es un mensaje embebido."
        : "El archivo adjunto no es un mensaje embebido.");

Determinar Archivos Adjuntos Formateados TNEF

La propiedad Attachment.isTnef de la API Aspose.Email Java indica si el archivo adjunto de mensaje es un mensaje formateado TNEF.

El siguiente fragmento de código demuestra cómo determinar si un archivo adjunto está formateado TNEF:

MailMessage eml = MailMessage.load(fileName);

for (Attachment attachment : eml.getAttachments()) {
    System.out.println("¿Es el archivo adjunto TNEF?: " + attachment.isTnef());
}

Extrayendo URI del Archivo Adjunto si el Archivo Adjunto es URI-attachment

El siguiente fragmento de código demuestra cómo extraer el URI del archivo adjunto.

MailMessage eml = MailMessage.load("fileName");

Attachment attachment = eml.getAttachments().get_Item(0);
if (attachment.isUri()) {
    InputStream inputStream = attachment.getContentStream();
    String uri = new String(IOUtils.toByteArray(inputStream), Charset.forName("utf-8"));
    System.out.println("URI del archivo adjunto: " + uri);
}

Agregando Archivos Adjuntos de Referencia

Un archivo adjunto de referencia es una alternativa al archivo adjunto local. En algunos casos, los archivos adjuntos de referencia pueden ser preferibles, por ejemplo, si desea gestionar su acceso. Las clases a continuación se utilizan para gestionar y manipular mensajes de correo electrónico y sus archivos adjuntos:

ReferenceAttachment - Representa un archivo adjunto de referencia.
AttachmentPermissionType - Tipo de datos de permiso asociado con un archivo adjunto de referencia web.
AttachmentProviderType - Tipo de servicio web que manipula el archivo adjunto.

El siguiente ejemplo de código demuestra cómo cargar un mensaje de correo electrónico desde un archivo, crear un archivo adjunto de referencia con propiedades específicas, y agregar el archivo adjunto al mensaje de correo electrónico:

MailMessage eml = MailMessage.load("fileName");

ReferenceAttachment refAttach = new ReferenceAttachment("https://[attach_uri]");
refAttach.setName("Document.docx");
refAttach.setProviderType(AttachmentProviderType.OneDrivePro);
refAttach.setPermissionType(AttachmentPermissionType.AnyoneCanEdit);

eml.getAttachments().addItem(refAttach);

Trabajando con Objetos Embebidos

Un objeto embebido es un objeto que fue creado con una aplicación y encerrado dentro de un documento o archivo creado por otra aplicación. Por ejemplo, una hoja de cálculo de Microsoft Excel puede ser embebida en un informe de Microsoft Word, o un archivo de video puede ser embebido en una presentación de Microsoft PowerPoint. Cuando un archivo está embebido, en lugar de ser insertado o pegado en otro documento, conserva su formato original. El documento embebido puede ser abierto en la aplicación original y modificado.

Embeber Objetos en un Email

La clase LinkedResource se utiliza con la clase MailMessage para embeber objetos en sus mensajes de correo electrónico. Para agregar un objeto embebido, siga estos pasos:

Cree una instancia de la clase MailMessage.
Especifique los valores de de, para y asunto en la instancia de MailMessage.
Cree una instancia de la clase AlternateView.
Cree una instancia de la clase LinkedResource.
Cargue un objeto embebido en la LinkedResourceCollection.
Agregue el objeto embebido cargado a la instancia de la clase MailMessage.
Agregue la instancia de AlternateView a la instancia de la clase MailMessage.

Los fragmentos de código a continuación producen un mensaje de correo electrónico con un cuerpo de texto plano y HTML y una imagen embebida en el HTML.

Imagen embebida en el email

Puede enviar cualquier número de objetos embebidos. El tamaño del archivo adjunto está limitado por el servidor de correo. Gmail, por ejemplo, no admite tamaños de archivo mayores a 10MB. Los fragmentos de código a continuación demuestran cómo embeber objetos en un Email.

// Crear una instancia de la clase MailMessage y establecer las direcciones y contenido
MailMessage mail = new MailMessage();
mail.setFrom(new MailAddress("sender@from.com"));
mail.getTo().add("receiver@to.com");
mail.setSubject("Este es un correo electrónico");

// Crear la parte de texto plano que es visible para aquellos clientes que no soportan HTML
AlternateView plainView = AlternateView.createAlternateViewFromString("Este es mi contenido de texto plano", null, "text/plain");

// Crear la parte HTML. Para embeber imágenes, necesitamos usar el prefijo 'cid' en el valor src de img. 
// El valor cid se mapeará al Content-Id de un recurso enlazado. 
// Así, <img src='cid:barcode'> se mapeará a un LinkedResource con un ContentId de 'barcode'.
AlternateView htmlView = AlternateView.createAlternateViewFromString("Aquí hay una imagen embebida.<img src=cid:barcode>", null, "text/html");

// Crear el LinkedResource (imagen embebida) y agregar el LinkedResource a la vista adecuada
LinkedResource barcode = new LinkedResource("1.jpg", MediaTypeNames.Image.JPEG);
barcode.setContentId("barcode");

mail.getLinkedResources().addItem(barcode);
mail.getAlternateViews().addItem(plainView);
mail.getAlternateViews().addItem(htmlView);
mail.save("EmbeddedImage_out.msg", SaveOptions.getDefaultMsgUnicode());

Eliminando Objetos Embebidos de un Email

La LinkedResourceCollection se accede a través de la propiedad MailMessage.LinkedResources. La colección LinkedResourceCollection proporciona un método para eliminar completamente objetos embebidos agregados en un mensaje de correo electrónico. Utilice la versión sobrecargada del método LinkedResourceCollection.removeAt para eliminar todos los rastros de un objeto embebido de un mensaje de correo electrónico.

El código de ejemplo a continuación muestra cómo eliminar objetos embebidos de un mensaje de correo electrónico.

// Cargar el mensaje de prueba con Recursos Enlazados
MailMessage msg = MailMessage.load("EmlWithLinkedResources.eml");

// Eliminar un LinkedResource
msg.getLinkedResources().removeAt(0, true);

// Ahora limpie la Vista Alternativa para Recursos Enlazados
msg.getAlternateViews().get_Item(0).getLinkedResources().clear(true);

Extrayendo Objetos Embebidos

Este tema explica cómo extraer objetos embebidos de un archivo de correo electrónico. Un objeto embebido es un objeto que fue creado con una aplicación y encerrado dentro de un documento o archivo creado por otra aplicación. Por ejemplo, una hoja de cálculo de Microsoft Excel puede ser embebida en un informe de Microsoft Word, o un archivo de video puede ser embebido en una presentación de Microsoft PowerPoint. Cuando un archivo está embebido, en lugar de ser insertado o pegado en otro documento, conserva su formato original. El documento embebido puede ser abierto en la aplicación original y ser modificado. Para extraer un objeto embebido de un mensaje de correo electrónico, siga estos pasos:

Cree una instancia de la clase MailMessage.
Cargue un archivo de correo electrónico en la instancia de MailMessage.
Cree un bucle y cree una instancia de la clase Attachment dentro de él.
Guarde el archivo adjunto y muéstrelo en pantalla.
Especifique la dirección del remitente y el destinatario en la instancia de MailMessage.
Envíe el correo electrónico utilizando la clase SmtpClient.

El siguiente fragmento de código extrae objetos embebidos de un correo electrónico.

Objetos embebidos extraídos en email

El siguiente fragmento de código muestra cómo extraer objetos embebidos.

MailMessage mailMsg = MailMessage.load("Message.msg", new MsgLoadOptions());

for (Attachment attachment : mailMsg.getAttachments()) {
    attachment.save("MessageEmbedded_out.msg");
    System.out.println(attachment.getName());
}

Identificar y Extraer un Archivo Adjunto Embebido desde MSG Formateado como RTF

El siguiente código puede ser utilizado para mensajes formateados como RTF para diferenciar y extraer archivos adjuntos que son Inline o que aparecen como iconos en el cuerpo del mensaje. El siguiente fragmento de código muestra cómo identificar y extraer un archivo adjunto embebido desde MSG formateado como RTF.

public static void extractInlineAttachments() {
    MapiMessage message = MapiMessage.load("MSG file with RTF Formatting.msg");
    for (MapiAttachment attachment : message.getAttachments()) {

        if (isAttachmentInline(attachment)) {
            try {
                saveAttachment(attachment, UUID.randomUUID().toString());
            } catch (Exception ex) {
                System.err.println(ex);
            }
        }
    }
}

static boolean isAttachmentInline(MapiAttachment attachment) {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("\u0003ObjInfo".equals(property.getName())) {
            byte[] data = property.getData();
            int odtPersist1 = data[1] << 8 | data[0];
            return (odtPersist1 & 0x40) == 0;
        }
    }
    return false;
}

static void saveAttachment(MapiAttachment attachment, String fileName) throws IOException {
    for (MapiProperty property : attachment.getObjectData().getProperties().get_Values()) {
        if ("Package".equals(property.getName())) {
            try (FileOutputStream fs = new FileOutputStream(fileName)) {
                fs.write(property.getData(), 0, property.getData().length);
            }
        }
    }
}

Recuperando Archivos Adjuntos de Correos Electrónicos Firmados

Los correos electrónicos firmados contienen un único archivo adjunto smime.p7m. Esto significa que el correo electrónico está cifrado por SMIME. El formato de archivo Smime.p7m es la firma digital. Para ver el contenido de este correo electrónico utilice el método RemoveSignature. El método devuelve un objeto MailMessage sin una firma digital.

MailMessage signedEml = MailMessage.load("signed.eml");

if (signedEml.isSigned()) {
    for (int i = 0; i < signedEml.getAttachments().size(); i++) {
        System.out.println("Archivo adjunto de email firmado " + i + ": " + signedEml.getAttachments().get_Item(i).getName());
    }

    // El correo electrónico está firmado. Eliminar la firma.
    MailMessage eml = signedEml.removeSignature();

    System.out.println("Firma eliminada.");

    for (int i = 0; i < eml.getAttachments().size(); i++) {
        System.out.println("Archivo adjunto de email " + i + ": " + eml.getAttachments().get_Item(i).getName());
    }
}

Trabajando con Content-Type y Content-Disposition

La API Aspose.Email proporciona la capacidad de trabajar con el Content-Type y Content-Disposition del encabezado del archivo adjunto. El siguiente fragmento de código muestra cómo obtener y cambiar la descripción del contenido del archivo adjunto.

Mostrando Parámetros de Content-Type y Content-Disposition

El siguiente fragmento de código muestra cómo mostrar parámetros de Content-Type y Content-Disposition en la pantalla:

void run(MailMessage message) {
    // Archivos adjuntos
    for (Attachment attachment : message.getAttachments()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
    // Recursos enlazados
    for (LinkedResource attachment : message.getLinkedResources()) {
        ContentDisposition contentDisposition = attachment.getContentDisposition();
        printContentDisposition(contentDisposition);
        ContentType contentType = attachment.getContentType();
        printContentType(contentType);
    }
}

void printContentType(ContentType contentType) {
    System.out.println("media-type: " + contentType.getMediaType());
    System.out.println("charset: " + contentType.getCharSet());
    System.out.println("name: " + contentType.getName());
}

void printContentDisposition(ContentDisposition contentDisposition) {
    System.out.println("disposition-type: " + contentDisposition.getDispositionType());
    System.out.println("is-inline: " + contentDisposition.getInline());
    System.out.println("filename: " + contentDisposition.getFileName());
    System.out.println("creation-date: " + contentDisposition.getCreationDate());
    System.out.println("modification-date: " + contentDisposition.getModificationDate());
    System.out.println("read-date: " + contentDisposition.getReadDate());
    System.out.println("size: " + contentDisposition.getSize());
}

Utilizando Parámetros de Content-Type y Content-Disposition con Archivos Adjuntos

El siguiente fragmento de código muestra cómo utilizar los parámetros Content-Type y Content-Disposition con un archivo adjunto:

MailMessage eml = MailMessage.load(fileName);

Attachment attachment = new Attachment(pdfFileName, new ContentType("application/octet-stream"));
attachment.getContentDisposition().setDispositionType("attachment");
attachment.getContentDisposition().setFileName(fileName);

eml.addAttachment(attachment);

Creación y Configuración del Contenido de Correos Electrónicos Extracción de Contenidos de Mensajes de Correos Electrónicos