Rozlištění mezi vloženými a běžnými přílohami

E‑mailové zprávy mohou obsahovat vložené obrázky i přílohy. Použitím MailMessage, vložené přílohy lze extrahovat z LinkedResourceCollection kolekce, zatímco běžné přílohy lze přistupovat a extrahovat pomocí kolekce zprávy AttachmentCollection kolekci. Toto se však liší, když je zpráva načtena pomocí MapiMessage, protože všechny vložené obrázky a běžné přílohy jsou pro uživatele přístupné ve stejném MapiAttachmentCollection. Tudíž metoda, která dokáže rozlišit mezi vloženou a běžnou přílohou, když MapiMessage je potřeba použít.

Tento článek vysvětluje, jak rozlišit vložené přílohy od běžných pomocí MapiMessage. Při rozhodování o typu těla MapiMessage je bráno v úvahu následovně:

• Prostý textový tělo: E‑mailové zprávy s prostým textovým tělem není nutné kontrolovat, protože všechny přílohy v takových zprávách jsou vždy běžné přílohy.
• HTML tělo: U zpráv s HTML tělem by příloha měla kromě vlastnosti PR_ATTACH_FLAGS (0x37140003) mít také hodnotu 0x00000004 pro vložené přílohy. Pokud je tato podmínka splněna, dále záleží na značkách PR_ATTACH_CONTENT_LOCATION a PR_ATTACH_CONTENT_ID pro určení povahy přílohy. V případě absence MAPI značky PR_ATTACH_FLAGS se příloha kontroluje na vlastnost PR_ATTACH_DISPOSITION (0x3716001F nebo 0x3716001E) pro určení typu přílohy.
• RTF tělo: Pokud je tělo RTF, všechny OLE přílohy jsou vložené přílohy. Hodnota PR_ATTACH_METHOD pro všechny OLE přílohy je rovna 0x00000006.

Následující ukázka kódu demonstruje programové rozlišení mezi vloženými a běžnými přílohami. Funkce isInlineAttachment přijímá přílohu a MapiMessage jako vstupní parametry a vrací true, pokud je příloha vložená.

public static boolean isInlineAttachment(MapiAttachment att, MapiMessage msg) {
    if (msg.getBodyType() == BodyContentType.PlainText)
        // ignore indications for plain text messages
        return false;
    else if (msg.getBodyType() == BodyContentType.Html) {
        // check the PidTagAttachFlags property
        Long attachFlagsValue = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_FLAGS);
        if (attachFlagsValue != null && (attachFlagsValue > 3 || attachFlagsValue < 1)) {
            // check PidTagAttachContentId property
            String contentId = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_ID_W);
            if (contentId != null && !contentId.isEmpty() && msg.getBodyHtml().contains("cid:" + contentId)) {
                return true;
            }
            // check PidTagAttachContentLocation property
            String contentLocation = att.getProperties().containsKey(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    ? att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION)
                    : att.getPropertyString(MapiPropertyTag.PR_ATTACH_CONTENT_LOCATION_W);
            if (contentLocation != null && !contentLocation.isEmpty() && msg.getBodyHtml().contains(contentLocation)) {
                return true;
            }
        }
        return "inline".equals(att.getPropertyString(0x3716001F)) || "inline".equals(att.getPropertyString(0x3716001E));
    } else if (msg.getBodyType() == BodyContentType.Rtf) {
        // If the body is RTF, then all OLE attachments are inline attachments.
        // OLE attachments have 0x00000006 for the value of the PidTagAttachMethod property
        Long attachMethod = att.getPropertyLong(MapiPropertyTag.PR_ATTACH_METHOD);
        return attachMethod != null && attachMethod == 0x00000006;
    } else {
        throw new ArgumentOutOfRangeException();
    }
}

Tento úryvek kódu používá funkci isInlineAttachment() k vyhodnocení příloh.

Java

String fileName = ("Sample.msg");
MapiMessage message = MapiMessage.fromFile(fileName);
MapiAttachmentCollection attachments = message.getAttachments();
for (int i = 0; i < attachments.size(); i++) {
    MapiAttachment attachment = (MapiAttachment) attachments.get(i);
    if (isInlineAttachment(attachment, message)) {
        System.out.println(attachment.getLongFileName() + " is inline attachment");
    } else {
        System.out.println(attachment.getLongFileName() + " is regular attachment");
    }
}