repo_zf1/documentation/manual/de/module_specs/Zend_Mime_Message.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.mime.message">
    <title>Zend_Mime_Message</title>

    <sect2 id="zend.mime.message.introduction">
        <title>Einführung</title>

        <para>
            <classname>Zend_Mime_Message</classname> repräsentiert eine <acronym>MIME</acronym>
            konforme Nachricht, welche einen oder mehrere Abschnitte (Repräsentiert durch
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> Objekte)
            beinhalten kann. Mit <classname>Zend_Mime_Message</classname> können
            <acronym>MIME</acronym> konforme Nachrichten, durch die Klasse, erstellt werden.
            Verschlüsselungs- und BoundaryGrenzbehandlung werden transparent durch die Klasse
            behandelt. MimeMessage Objekte können auch durch übergebene Strings rekonstruiert werden
            (Experimentell). Verwendet durch <link
                linkend="zend.mail"><classname>Zend_Mail</classname></link>.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.instantiation">
        <title>Instanziierung</title>

        <para>
            Es gibt keinen expliziten Konstruktor für <classname>Zend_Mime_Message</classname>.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.addparts">
        <title>MIME Abschnitte hinzufügen</title>

        <para>
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>
            Objekte können zu einem bestehenden <classname>Zend_Mime_Message</classname> Objekt
            hinzugefügt werden durch aufruf von <methodname>addPart($part)</methodname>
        </para>

        <para>
            Ein Array mit allen <classname>Zend_Mime_Part</classname> Objekten der
            <classname>Zend_Mime_Message</classname> wird von der Methode
            <methodname>getParts()</methodname> zurück gegeben. Das
            <classname>Zend_Mime_Part</classname> Objekt kann dann geändert werden, da es im Array
            als Referenz gespeichert wird. Wenn Abschnitte zum Array hinzugefügt werden oder die
            Sequenz geändert wird, muß das Array dem <classname>Zend_Mime_Message</classname> Objekt
            zurückgegeben werden, durch Aufruf von <methodname>setParts($partsArray)</methodname>
        </para>

        <para>
            Die Funktion <methodname>isMultiPart()</methodname> gibt <constant>TRUE</constant>
            zurück, wenn mehr als ein Abschnitt im <classname>Zend_Mime_Message</classname> Objekt
            registriert wurde, und das Objekt deshalb bei der Erstellung des aktuellen Outputs eine
            Multipart-Mime-Message erstellen würde.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.bondary">
        <title>Grenzbehandlung</title>

        <para>
            <classname>Zend_Mime_Message</classname> erzeugt und verwendet normalerweise sein
            eigenes <classname>Zend_Mime</classname> Objekt zur Erstellung einer Grenze. Wenn eine
            eigene Grenze erstellt wird, oder dass das Verhalten des
            <classname>Zend_Mime</classname> Objekts geändert werden muß, welches von
            <classname>Zend_Mime_Message</classname> verwendet wird, kann ein eigenes Zend Mime
            Objekt instanziiert und bei <classname>Zend_Mime_Message</classname> registriert werden.
            Normalerweise muß das nicht gemacht werden.
            <methodname>setMime(Zend_Mime $mime)</methodname> setzt eine spezielle Instanz von
            <classname>Zend_Mime</classname> welche durch diese
            <classname>Zend_Mime_Message</classname> verwendet wird.
        </para>

        <para>
            <methodname>getMime()</methodname> gibt eine Instanz von
            <classname>Zend_Mime</classname> zurück, welche zur Wiedergabe der Nachricht verwendet
            wird, wenn <methodname>generateMessage()</methodname> aufgerufen wird.
        </para>

        <para>
            <methodname>generateMessage()</methodname> gibt den
            <classname>Zend_Mime_Message</classname> Inhalt in einem String wieder.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.parse">
        <title>
            Parst einen String um ein Zend_Mime_Message Objekt zu erstellen (Experimentell)
        </title>

        <para>
            Eine übergebene <acronym>MIME</acronym> konforme Nachricht in einem String kann dazu
            verwendet werden, um daraus ein <classname>Zend_Mime_Message</classname> Objekt wieder
            herzustellen. <classname>Zend_Mime_Message</classname> hat eine statische Factory
            Methode um den String zu parsen und gibt ein <classname>Zend_Mime_Message</classname>
            Objekt zurück.
        </para>

        <para>
            <methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
            entschlüsselt einen übergebenen String und gibt ein
            <classname>Zend_Mime_Message</classname> Objekt zurück welches anschließend durch
            <methodname>getParts()</methodname> überprüft werden kann.
        </para>
    </sect2>
</sect1>