documentation/manual/ja/module_specs/Zend_Feed-CustomFeed.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20774 -->
   4 <sect1 id="zend.feed.custom-feed">
   5     <title>独自のフィードクラスおよびエントリクラス</title>
   6
   7     <para>
   8         独自のフォーマットを提供したい、
   9         あるいは要素が自動的に所定の名前空間に配置されるなどの素敵な機能を追加したい、
  10         といった場合は <classname>Zend_Feed</classname> クラスを拡張して対応します。
  11     </para>
  12
  13     <para>
  14         以下に Atom エントリクラスを拡張する例を示します。
  15         このクラスでは、独自の名前空間 <emphasis>myns:</emphasis> を使用しています。
  16         また、<methodname>registerNamespace()</methodname> がコールされていることに注意しましょう。
  17         このクラスの使用者は、名前空間について心配する必要がなくなります。
  18     </para>
  19
  20     <example id="zend.feed.custom-feed.example.extending">
  21         <title>独自の名前空間を使用しての Atom エントリクラスの拡張</title>
  22
  23         <programlisting language="php"><![CDATA[
  24 /**
  25  * この独自エントリクラスは、自動的にフィード URI を識別 (オプション) して
  26  * 名前空間を追加します
  27  */
  28 class MyEntry extends Zend_Feed_Entry_Atom
  29 {
  30
  31     public function __construct($uri = 'http://www.example.com/myfeed/',
  32                                 $xml = null)
  33     {
  34         parent::__construct($uri, $xml);
  35
  36         Zend_Feed::registerNamespace('myns',
  37                                      'http://www.example.com/myns/1.0');
  38     }
  39
  40     public function __get($var)
  41     {
  42         switch ($var) {
  43             case 'myUpdated':
  44                 // myUpdated を myns:updated に変換します
  45                 return parent::__get('myns:updated');
  46
  47             default:
  48                 return parent::__get($var);
  49             }
  50     }
  51
  52     public function __set($var, $value)
  53     {
  54         switch ($var) {
  55             case 'myUpdated':
  56                 // myUpdated を myns:updated に変換します
  57                 parent::__set('myns:updated', $value);
  58                 break;
  59
  60             default:
  61                 parent::__set($var, $value);
  62         }
  63     }
  64
  65     public function __call($var, $unused)
  66     {
  67         switch ($var) {
  68             case 'myUpdated':
  69                 // myUpdated を myns:updated に変換します
  70                 return parent::__call('myns:updated', $unused);
  71
  72             default:
  73                 return parent::__call($var, $unused);
  74         }
  75     }
  76 }
  77 ]]></programlisting>
  78
  79         <para>
  80             そしてこのクラスを使用すると、インスタンスを作成したらすぐに
  81             <property>myUpdated</property> プロパティを設定できます。
  82         </para>
  83
  84         <programlisting language="php"><![CDATA[
  85 $entry = new MyEntry();
  86 $entry->myUpdated = '2005-04-19T15:30';
  87
  88 // メソッド型のコールは __call 関数が処理します
  89 $entry->myUpdated();
  90 // プロパティ型のコールは __get 関数が処理します
  91 $entry->myUpdated;
  92 ]]></programlisting>
  93     </example>
  94
  95 </sect1>
  96 <!--
  97 vim:se ts=4 sw=4 et:
  98 -->