documentation/manual/zh/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>简介</title>
   6
   7       <para><code>Zend_Mime_Message</code>表示一个包含一个或多个段（段以<link
   8       linkend="zend.mime.part"><code>Zend_Mime_Part</code></link>对象表示）的符合MIME标准的消息。
   9       在<code>Zend_Mime_Message</code>中，符合MIME标准的多段消息由<code>Zend_Mime_Part</code>对象产生。
  10       编码和分段也是在Zend_Mime_Message中被处理。<code>Zend_Mime_Message</code>对象也可从给定的字符串中重构出来（实验性的）。
  11       Zend_Mime_Message也被<link linkend="zend.mail"><code>Zend_Mail</code></link>使用（译注：Zend_Mail继承了Zend_Mime_Message）。
  12       </para>
  13     </sect2>
  14
  15     <sect2 id="zend.mime.message.instantiation">
  16         <title>实例化</title>
  17         <para>
  18             <code>Zend_Mime_Message</code>没有构造函数。
  19         </para>
  20     </sect2>
  21
  22     <sect2 id="zend.mime.message.addparts">
  23         <title>增加MIME消息段</title>
  24
  25         <para>
  26             <code>Zend_Mime_Message</code>对象通过调用<code>addPart($part)</code>方法，
  27             可以添加<link linkend="zend.mime.part"><code>Zend_Mime_Part</code></link>对象。
  28         </para>
  29      <para>
  30          调用<code>Zend_Mime_Message</code>对象的<code>getParts()</code>方法，
  31          返回<link linkend="zend.mime.part"><code>Zend_Mime_Part</code></link> 对象数组。
  32         Zend_Mime_Part对象可以被更改，因为他们以引用的方式存储在Zend_Mime_Message对象的数组中。
  33          如果数组中有新的段加入或者改变了段的顺序，该数组需通过调用<code>setParts($partsArray)</code>方法，反馈到<code>Zend_Mime_Message</code>中去。
  34         </para>
  35
  36         <para>
  37           当<code>Zend_Mime_Message</code>中存在多个段，方法<code>isMultiPart()</code>将返回TRUE。
  38          <code>Zend_Mime_Message</code>在产生实际输出产生多段的MIME消息。
  39      </para>
  40     </sect2>
  41
  42     <sect2 id="zend.mime.message.bondary">
  43         <title>分界线处理</title>
  44         <para>
  45           <code>Zend_Mime_Message</code>通常创建和使用自身的<code>Zend_Mime</code>对象来产生MINE分界线。
  46           如果你想自己定义分界线或想更改<code>Zend_Mime_Message</code>自身的<code>Zend_Mime</code>对象的缺省的行为，
  47           你可以自己实例化<code>Zend_Mime</code>对象，然后通过<code>setMime(Zend_Mime $mime)</code>方法注册到<code>Zend_Mime_Message</code>对象中去，通常你不需要这么做。
  48      </para>
  49         <para><code>-&gt;getMime()</code>方法，返回<code>Zend_Mime</code>实例，当<code>generateMessage()</code>被调用时<code>Zend_Mime</code>实例用来渲染MIME消息。</para>
  50         <para><code>-&gt;generateMessage()</code>方法，渲染<code>Zend_Mime_Message</code>的内容为字符串。</para>
  51    </sect2>
  52
  53     <sect2 id="zend.mime.message.parse">
  54         <title>解析字符串，创建Zend_Mime_Message对象（实验性的）</title>
  55
  56         <para>给定一个字符串形式的符合MIME标准的消息，可以重构出<code>Zend_Mime_Message</code>对象。
  57         <code>Zend_Mime_Message</code>有一个静态的工厂方法，解析字符串，返回<code>Zend_Mime_Message</code>对象。</para>
  58
  59         <para><code>Zend_Mime_Message::createFromMessage($str, $boundary)</code>将给定的字符串解码，
  60             返回<code>Zend_Mime_Message</code>对象，可以用<code>getParts()</code>方法来检验一下。</para>
  61     </sect2>
  62 </sect1>
  63 <!--
  64 vim:se ts=4 sw=4 et:
  65 -->