documentation/manual/pl/module_specs/Zend_Mime_Message.xml

   1 <sect1 id="zend.mime.message">
   2     <title>Zend_Mime_Message</title>
   3
   4     <sect2 id="zend.mime.message.introduction">
   5       <title>Wprowadzenie</title>
   6
   7       <para><code>Zend_Mime_Message</code> reprezetuje wiadomość zgodną z MIME,
   8       która zawiera jedną lub więcej odrębnych części (Reprezentowanych przez obiekty
   9       <link linkend="zend.mime.part"><code>Zend_Mime_Part</code></link>). Klasa
  10       <code>Zend_Mime_Message</code>, może wygenerować wieloczęściowe wiadomości
  11       zgodne z MIME z obiektów <code>Zend_Mime_Part</code>. Kodowanie i obsługa
  12       pól rozgraniczających są obsługiwane przez samą klasę. Obiekty <code>Zend_Mime_Message</code>
  13       mogą być także zrekonstruowane z podanych łańcuchów znaków (eksperymentalne).
  14       Klasa używana jest przez <link linkend="zend.mail"><code>Zend_Mail</code></link>.
  15       </para>
  16     </sect2>
  17
  18     <sect2 id="zend.mime.message.instantiation">
  19         <title>Tworzenie instancji</title>
  20         <para>
  21             <code>Zend_Mime_Message</code> nie posiada konstruktora.
  22         </para>
  23     </sect2>
  24
  25     <sect2 id="zend.mime.message.addparts">
  26         <title>Dodawanie części MIME</title>
  27
  28         <para>Obiekty <link linkend="zend.mime.part"><code>Zend_Mime_Part</code></link>
  29         mogą być dodane poprzez ich przekazanie do obiektu <code>Zend_Mime_Message</code>
  30         za pomocą metody <code>-&gt;addPart($part)</code></para>
  31
  32         <para>Tablica z wszystkimi obiektami <link linkend="zend.mime.part">
  33         <code>Zend_Mime_Part</code></link> z wiadomości <code>Zend_Mime_Message</code>
  34         jest zwraca za pomocą metody <code>-&gt;getParts()</code>. Obiekty Zend_Mime_Part
  35         mogą być wtedy zmienione ponieważ są one przechowywane w tablicy jako referencje.
  36         Jeśli jakieś części są dodane do tablicy lub zmieniona jest ich kolejność,
  37         konieczne jest przekazanie tablicy spowrotem do <link linkend="zend.mime.part">
  38         <code>Zend_Mime_Part</code></link> poprzez wywolanie <code>-&gt;setParts($partsArray)</code>.</para>
  39
  40         <para>Funkcja <code>-&gt;isMultiPart()</code> zwróci wartość true jeśli
  41         w obiekcie <code>Zend_Mime_Message</code> zarejestrowanych jest więcej
  42         części niż jedna. Wtedy gdy obiekt będzie generował wyjściową wiadomość,
  43         wygeneruje ją jako wieloczęściową wiadomość MIME.</para>
  44     </sect2>
  45
  46     <sect2 id="zend.mime.message.bondary">
  47         <title>Obsługa pola rozgraniczającego (boundary)</title>
  48
  49         <para><code>Zend_Mime_Message</code> zazwyczaj tworzy obiekt <code>Zend_Mime</code>
  50         i używa go do tworzenia pola rozgraniczającego. Jeśli chcesz zdefiniować
  51         pole samodzielnie lub chcesz zmienić zachowanie obiektu <code>Zend_Mime</code>
  52         używanego przez <code>Zend_Mime_Message</code>, możesz utworzyć instancję
  53         obiektu <code>Zend_Mime</code> samodzielnie i potem zarejestrować ją do obiekcie
  54         <code>Zend_Mime_Message</code>. Zazwyczaj jednak nie jest to potrzebne.
  55         <code>-&gt;setMime(Zend_Mime $mime)</code> ustawia specjalną instancję
  56         <code>Zend_Mime</code> która ma być używana przez obiekt <code>Zend_Mime_Message</code></para>
  57
  58         <para><code>-&gt;getMime()</code> zwraca instancję <code>Zend_Mime</code>
  59         która będzie użyta do renderowania wiadomości przez wywołanie metody
  60         <code>generateMessage()</code>.</para>
  61
  62         <para><code>-&gt;generateMessage()</code> renderuje wiadomość
  63         <code>Zend_Mime_Message</code> do postaci łańcuchu znaków.</para>
  64     </sect2>
  65
  66     <sect2 id="zend.mime.message.parse">
  67         <title>Tworzenie obiektu Zend_Mime_Message z łańcucha znaków.
  68         (eksperymentalne)</title>
  69
  70         <para>Wiadomość zgodna z MIME zapisana w postaci łańcucha znaków może
  71         być użyta do zrekonstruowania obiektu <code>Zend_Mime_Message</code>.
  72         <code>Zend_Mime_Message</code> ma statyczną fabrykę przetwarzającą podany
  73         łańcuch znaków i następnie zwracającą obiekt <code>Zend_Mime_Message</code>.
  74         </para>
  75
  76         <para><code>Zend_Mime_Message::createFromMessage($str, $boundary)</code>
  77         dekoduje podany łańcuch znaków i zwraca obiekt <code>Zend_Mime_Message</code>.
  78         Jego poprawność może być następnie sprawdzona przez użycie metody
  79         <code>-&gt;getParts()</code></para>
  80     </sect2>
  81 </sect1>
  82 <!--
  83 vim:se ts=4 sw=4 et:
  84 -->