documentation/manual/ja/module_specs/Zend_Service_Technorati.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20818 -->
   4 <sect1 id="zend.service.technorati">
   5     <title>Zend_Service_Technorati</title>
   6
   7     <sect2 id="zend.service.technorati.introduction">
   8         <title>導入</title>
   9         <para>
  10             <classname>Zend_Service_Technorati</classname> は、Technorati <acronym>API</acronym>
  11             を使うための簡単で直感的なオブジェクト指向インターフェイスを提供します。
  12             利用可能なすべての
  13             <ulink url="http://technorati.com/developers/api/">Technorati <acronym>API</acronym> クエリ</ulink>
  14             にアクセスすることができ、<acronym>API</acronym> が返す XML
  15             形式のレスポンスを <acronym>PHP</acronym> で扱いやすいオブジェクトで返します。
  16         </para>
  17         <para>
  18             <ulink url="http://technorati.com/">Technorati</ulink>
  19             は、人気のあるブログ検索エンジンのひとつです。その <acronym>API</acronym> を使用すると、
  20             特定のブログについての情報を取得したり、
  21             指定したタグやフレーズにマッチするブログの著者の情報を取得したりできます。
  22             使用できるクエリの一覧は、
  23             <ulink url="http://technorati.com/developers/api/">Technorati <acronym>API</acronym> ドキュメント</ulink>
  24             あるいはこのドキュメントの
  25             <link linkend="zend.service.technorati.queries">使用できる Technorati クエリ</link>
  26             を参照ください。
  27         </para>
  28     </sect2>
  29
  30     <sect2 id="zend.service.technorati.getting-started">
  31         <title>さあ始めましょう</title>
  32         <para>
  33             Technorati <acronym>API</acronym> を使用するには、キーが必要です。
  34             <acronym>API</acronym> キーを取得するには、まず最初に
  35             <ulink url="http://technorati.com/signup/">Technorati アカウントを作成</ulink>
  36             し、それから
  37             <ulink url="http://technorati.com/developers/apikey.html"><acronym>API</acronym> キーのセクション</ulink>
  38             に行ってください。
  39         </para>
  40         <note>
  41             <title>API キーの制限</title>
  42             <para>
  43                 一日あたり最大 500 までの Technorati <acronym>API</acronym> コールを無料で行うことができます。
  44                 現在の Technorati <acronym>API</acronym> のライセンスによってはその他の使用制限が適用されるかもしれません。
  45             </para>
  46         </note>
  47         <para>
  48             <acronym>API</acronym> キーを取得したら、いよいよ <classname>Zend_Service_Technorati</classname>
  49             を使うことができます。
  50         </para>
  51     </sect2>
  52
  53     <sect2 id="zend.service.technorati.making-first-query">
  54         <title>はじめてのクエリ</title>
  55         <para>
  56             クエリを実行するにはまず最初に <acronym>API</acronym> キーを使用して
  57             <classname>Zend_Service_Technorati</classname> のインスタンスを作成します。
  58             そしてクエリの形式を選択し、引数を指定したうえでそれをコールします。
  59         </para>
  60         <example id="zend.service.technorati.making-first-query.example-1">
  61             <title>はじめてのクエリの実行</title>
  62             <programlisting language="php"><![CDATA[
  63 // API_KEY を指定して
  64 // Zend_Service_Technorati を作成します
  65 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
  66
  67 // Technorati で PHP というキーワードを検索します
  68 $resultSet = $technorati->search('PHP');
  69 ]]></programlisting>
  70         </example>
  71         <para>
  72             検索用のメソッドにはオプションパラメータの配列を渡すことができます。
  73             これを使用すると、クエリをさらに絞り込むことができます。
  74         </para>
  75         <example id="zend.service.technorati.making-first-query.example-2">
  76             <title>クエリの精度の向上</title>
  77             <programlisting language="php"><![CDATA[
  78 // API_KEY を指定して
  79 // Zend_Service_Technorati を作成します
  80 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
  81
  82 // クエリをフィルタリングし、あまり影響力のない
  83 // (あまり他からリンクされていない) ブログを結果から除外します
  84 $options = array('authority' => 'a4');
  85
  86 // Technorati で PHP というキーワードを検索します
  87 $resultSet = $technorati->search('PHP', $options);
  88 ]]></programlisting>
  89         </example>
  90         <para>
  91             <classname>Zend_Service_Technorati</classname> のインスタンスは使い捨てのオブジェクトではありません。
  92             したがって、クエリをコールするたびに毎回新たなインスタンスを作成するなどということは不要です。
  93             一度作成した <classname>Zend_Service_Technorati</classname>
  94             オブジェクトを、気の済むまで使い回せばいいのです。
  95         </para>
  96         <example id="zend.service.technorati.making-first-query.example-3">
  97             <title>ひとつの Zend_Service_Technorati インスタンスでの複数のクエリの送信</title>
  98             <programlisting language="php"><![CDATA[
  99 // API_KEY を指定して
 100 // Zend_Service_Technorati を作成します
 101 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 102
 103 // Technorati で PHP というキーワードを検索します
 104 $search = $technorati->search('PHP');
 105
 106 // Technorati で一番よく登録されているタブを取得します
 107 $topTags = $technorati->topTags();
 108 ]]></programlisting>
 109         </example>
 110     </sect2>
 111
 112     <sect2 id="zend.service.technorati.consuming-results">
 113         <title>結果の取得</title>
 114         <para>
 115             クエリの結果は、二種類の結果オブジェクトのうちのいずれかの形式で取得できます。
 116         </para>
 117         <para>
 118             まず最初の形式は <classname>Zend_Service_Technorati_*ResultSet</classname>
 119             オブジェクトで表されるものです。結果セットオブジェクトは、
 120             基本的には結果オブジェクトのコレクションとなります。これは基底クラス
 121             <classname>Zend_Service_Technorati_ResultSet</classname> を継承したもので、
 122             <acronym>PHP</acronym> の <code>SeekableIterator</code> インターフェイスを実装しています。
 123             この結果セットを使用するいちばんよい方法は、<acronym>PHP</acronym> の <code>foreach</code>
 124             文を用いてループ処理することです。
 125         </para>
 126         <example id="zend.service.technorati.consuming-results.example-1">
 127             <title>結果セットオブジェクトの取得</title>
 128             <programlisting language="php"><![CDATA[
 129 // API_KEY を指定して
 130 // Zend_Service_Technorati を作成します
 131 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 132
 133 // Technorati で PHP というキーワードを検索します
 134 // $resultSet は Zend_Service_Technorati_SearchResultSet のインスタンスです
 135 $resultSet = $technorati->search('PHP');
 136
 137 // 結果オブジェクトをループします
 138 foreach ($resultSet as $result) {
 139     // $result は Zend_Service_Technorati_SearchResult のインスタンスです
 140 }
 141 ]]></programlisting>
 142         </example>
 143         <para>
 144             <classname>Zend_Service_Technorati_ResultSet</classname> は <code>SeekableIterator</code>
 145             インターフェイスを実装しているので、結果コレクション内での位置を指定して
 146             特定の結果オブジェクトを取得することもできます。
 147         </para>
 148         <example id="zend.service.technorati.consuming-results.example-2">
 149             <title>特定の結果セットオブジェクトの取得</title>
 150             <programlisting language="php"><![CDATA[
 151 // API_KEY を指定して
 152 // Zend_Service_Technorati を作成します
 153 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 154
 155 // Technorati で PHP というキーワードを検索します
 156 // $resultSet は Zend_Service_Technorati_SearchResultSet のインスタンスです
 157 $resultSet = $technorati->search('PHP');
 158
 159 // $result は Zend_Service_Technorati_SearchResult のインスタンスです
 160 $resultSet->seek(1);
 161 $result = $resultSet->current();
 162 ]]></programlisting>
 163         </example>
 164         <note>
 165             <para>
 166                 <code>SeekableIterator</code> は配列として動作し、
 167                 そのインデックスは 0 から始まります。インデックス 1
 168                 を指定すると、コレクション内の 2 番目の結果を取得することになります。
 169             </para>
 170         </note>
 171         <para>
 172             2 番目の形式は、単体の特別な結果オブジェクトで表されるものです。
 173             <classname>Zend_Service_Technorati_GetInfoResult</classname>、<classname>Zend_Service_Technorati_BlogInfoResult</classname>
 174             および <classname>Zend_Service_Technorati_KeyInfoResult</classname> は、
 175             <classname>Zend_Service_Technorati_Author</classname> や <classname>Zend_Service_Technorati_Weblog</classname>
 176             といったオブジェクトのラッパーとして働きます。
 177         </para>
 178         <example id="zend.service.technorati.consuming-results.example-3">
 179             <title>単体の結果オブジェクトの取得</title>
 180             <programlisting language="php"><![CDATA[
 181 // API_KEY を指定して
 182 // Zend_Service_Technorati を作成します
 183 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 184
 185 // weppos についての情報を取得します
 186 $result = $technorati->getInfo('weppos');
 187
 188 $author = $result->getAuthor();
 189 echo '<h2>' . $author->getFirstName() . ' ' . $author->getLastName() .
 190      ' のブログ</h2>';
 191 echo '<ol>';
 192 foreach ($result->getWeblogs() as $weblog) {
 193     echo '<li>' . $weblog->getName() . '</li>';
 194 }
 195 echo "</ol>";
 196 ]]></programlisting>
 197         </example>
 198         <para>
 199             レスポンスクラスの詳細については
 200             <link linkend="zend.service.technorati.classes">Zend_Service_Technorati クラス</link>
 201             のセクションを参照ください。
 202         </para>
 203
 204     </sect2>
 205
 206     <sect2 id="zend.service.technorati.handling-errors">
 207         <title>エラー処理</title>
 208         <para>
 209             <classname>Zend_Service_Technorati</classname> のクエリメソッドは、失敗したときには
 210             <classname>Zend_Service_Technorati_Exception</classname> をスローします。
 211             またその際にはわかりやすいエラーメッセージを提供します。
 212         </para>
 213         <para>
 214             <classname>Zend_Service_Technorati</classname> のクエリが失敗する原因は、いくつか考えられます。
 215             <classname>Zend_Service_Technorati</classname> は、クエリを送信する際にすべてのパラメータを検証します。
 216             もし無効なパラメータや無効な値を指定していた場合は
 217             <classname>Zend_Service_Technorati_Exception</classname> をスローします。
 218             さらに、Technorati <acronym>API</acronym> が一時的に使用できなくなっていたり、
 219             そのレスポンスが整形式でない場合もあり得るでしょう。
 220         </para>
 221         <para>
 222             Technorati のクエリは、常に <code>try</code>...<code>catch</code>
 223             ブロック内に記述するようにしましょう。
 224         </para>
 225         <example id="zend.service.technorati.handling-errors.example-1">
 226             <title>クエリの例外処理</title>
 227             <programlisting language="php"><![CDATA[
 228 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 229 try {
 230     $resultSet = $technorati->search('PHP');
 231 } catch(Zend_Service_Technorati_Exception $e) {
 232     echo "エラーが発生しました: " $e->getMessage();
 233 }
 234 ]]></programlisting>
 235         </example>
 236     </sect2>
 237
 238     <sect2 id="zend.service.technorati.checking-api-daily-usage">
 239         <title>API キーの使用限度の確認</title>
 240         <para>
 241             今日は後何回 <acronym>API</acronym> キーが使えるのかを調べたいことも多々あるでしょう。
 242             デフォルトでは、Technorati の <acronym>API</acronym> は 1 日あたり 500 回までしか使用することができません。
 243             それを超えて使用しようとすると、<classname>Zend_Service_Technorati</classname>
 244             は例外を返します。自分の <acronym>API</acronym> キーの使用状況を取得するには
 245             <methodname>Zend_Service_Technorati::keyInfo()</methodname> メソッドを使用します。
 246         </para>
 247         <para>
 248             <methodname>Zend_Service_Technorati::keyInfo()</methodname> は
 249             <classname>Zend_Service_Technorati_KeyInfoResult</classname> オブジェクトを返します。
 250             詳細は
 251             <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 252             を参照ください。
 253         </para>
 254         <example id="zend.service.technorati.checking-api-daily-usage.example-1">
 255             <title>API キーの使用状況の取得</title>
 256             <programlisting language="php"><![CDATA[
 257 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 258 $key = $technorati->keyInfo();
 259
 260 echo "API Key: " . $key->getApiKey() . "<br />";
 261 echo "Daily Usage: " . $key->getApiQueries() . "/" .
 262      $key->getMaxQueries() . "<br />";
 263 ]]></programlisting>
 264         </example>
 265     </sect2>
 266
 267     <sect2 id="zend.service.technorati.queries">
 268         <title>使用できる Technorati クエリ</title>
 269         <para>
 270             <classname>Zend_Service_Technorati</classname> は以下のクエリをサポートしています。
 271             <itemizedlist>
 272                 <listitem><para><link linkend="zend.service.technorati.queries.cosmos"><code>Cosmos</code></link></para></listitem>
 273                 <listitem><para><link linkend="zend.service.technorati.queries.search"><code>Search</code></link></para></listitem>
 274                 <listitem><para><link linkend="zend.service.technorati.queries.tag"><code>Tag</code></link></para></listitem>
 275                 <listitem><para><link linkend="zend.service.technorati.queries.dailycounts"><code>DailyCounts</code></link></para></listitem>
 276                 <listitem><para><link linkend="zend.service.technorati.queries.toptags"><code>TopTags</code></link></para></listitem>
 277                 <listitem><para><link linkend="zend.service.technorati.queries.bloginfo"><code>BlogInfo</code></link></para></listitem>
 278                 <listitem><para><link linkend="zend.service.technorati.queries.blogposttags"><code>BlogPostTags</code></link></para></listitem>
 279                 <listitem><para><link linkend="zend.service.technorati.queries.getinfo"><code>GetInfo</code></link></para></listitem>
 280             </itemizedlist>
 281         </para>
 282
 283         <sect3 id="zend.service.technorati.queries.cosmos">
 284             <title>Technorati Cosmos</title>
 285             <para>
 286                 <ulink url="http://technorati.com/developers/api/cosmos.html">Cosmos</ulink>
 287                 クエリは、指定した URL にリンクしているブログを探します。このクエリは
 288                 <link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link>
 289                 オブジェクトを返します。詳細は
 290                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 291                 の <classname>Zend_Service_Technorati::cosmos()</classname> を参照ください。
 292             </para>
 293             <example id="zend.service.technorati.queries.cosmos.example-1">
 294                 <title>Cosmos クエリ</title>
 295                 <programlisting language="php"><![CDATA[
 296 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 297 $resultSet = $technorati->cosmos('http://devzone.zend.com/');
 298
 299 echo "<p>Reading " . $resultSet->totalResults() .
 300      " of " . $resultSet->totalResultsAvailable() .
 301      " available results</p>";
 302 echo "<ol>";
 303 foreach ($resultSet as $result) {
 304     echo "<li>" . $result->getWeblog()->getName() . "</li>";
 305 }
 306 echo "</ol>";
 307 ]]></programlisting>
 308             </example>
 309         </sect3>
 310
 311         <sect3 id="zend.service.technorati.queries.search">
 312             <title>Technorati Search</title>
 313             <para>
 314                 <ulink url="http://technorati.com/developers/api/search.html">Search</ulink>
 315                 クエリは、指定した検索文字列を含むブログを探します。このクエリは
 316                 <link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link>
 317                 オブジェクトを返します。詳細は
 318                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 319                 の <classname>Zend_Service_Technorati::search()</classname> を参照ください。
 320             </para>
 321             <example id="zend.service.technorati.queries.search.example-1">
 322                 <title>Search クエリ</title>
 323                 <programlisting language="php"><![CDATA[
 324 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 325 $resultSet = $technorati->search('zend framework');
 326
 327 echo "<p>Reading " . $resultSet->totalResults() .
 328      " of " . $resultSet->totalResultsAvailable() .
 329      " available results</p>";
 330 echo "<ol>";
 331 foreach ($resultSet as $result) {
 332     echo "<li>" . $result->getWeblog()->getName() . "</li>";
 333 }
 334 echo "</ol>";
 335 ]]></programlisting>
 336             </example>
 337         </sect3>
 338
 339         <sect3 id="zend.service.technorati.queries.tag">
 340             <title>Technorati Tag</title>
 341             <para>
 342                 <ulink url="http://technorati.com/developers/api/tag.html">Tag</ulink>
 343                 クエリは、指定したタグがつけられている投稿を探します。このクエリは
 344                 <link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link>
 345                 オブジェクトを返します。詳細は
 346                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 347                 の <classname>Zend_Service_Technorati::tag()</classname> を参照ください。
 348             </para>
 349             <example id="zend.service.technorati.queries.tag.example-1">
 350                 <title>Tag クエリ</title>
 351                 <programlisting language="php"><![CDATA[
 352 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 353 $resultSet = $technorati->tag('php');
 354
 355 echo "<p>Reading " . $resultSet->totalResults() .
 356      " of " . $resultSet->totalResultsAvailable() .
 357      " available results</p>";
 358 echo "<ol>";
 359 foreach ($resultSet as $result) {
 360     echo "<li>" . $result->getWeblog()->getName() . "</li>";
 361 }
 362 echo "</ol>";
 363 ]]></programlisting>
 364             </example>
 365         </sect3>
 366
 367         <sect3 id="zend.service.technorati.queries.dailycounts">
 368             <title>Technorati DailyCounts</title>
 369             <para>
 370                 <ulink url="http://technorati.com/developers/api/dailycounts.html">DailyCounts</ulink>
 371                 クエリは、指定したキーワードを含む投稿の 1 日あたりの数を返します。このクエリは
 372                 <link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link>
 373                 オブジェクトを返します。詳細は
 374                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 375                 の <classname>Zend_Service_Technorati::dailyCounts()</classname> を参照ください。
 376             </para>
 377             <example id="zend.service.technorati.queries.dailycounts.example-1">
 378                 <title>DailyCounts クエリ</title>
 379                 <programlisting language="php"><![CDATA[
 380 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 381 $resultSet = $technorati->dailyCounts('php');
 382
 383 foreach ($resultSet as $result) {
 384     echo "<li>" . $result->getDate() .
 385          "(" . $result->getCount() . ")</li>";
 386 }
 387 echo "</ol>";
 388 ]]></programlisting>
 389             </example>
 390         </sect3>
 391
 392         <sect3 id="zend.service.technorati.queries.toptags">
 393             <title>Technorati TopTags</title>
 394             <para>
 395                 <ulink url="http://technorati.com/developers/api/toptags.html">TopTags</ulink>
 396                 クエリは、Technorati にもっとも多く登録されているタグの情報を返します。このクエリは
 397                 <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
 398                 オブジェクトを返します。詳細は
 399                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 400                 の <classname>Zend_Service_Technorati::topTags()</classname> を参照ください。
 401             </para>
 402             <example id="zend.service.technorati.queries.toptags.example-1">
 403                 <title>TopTags タグ</title>
 404                 <programlisting language="php"><![CDATA[
 405 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 406 $resultSet = $technorati->topTags();
 407
 408 echo "<p>Reading " . $resultSet->totalResults() .
 409      " of " . $resultSet->totalResultsAvailable() .
 410      " available results</p>";
 411 echo "<ol>";
 412 foreach ($resultSet as $result) {
 413     echo "<li>" . $result->getTag() . "</li>";
 414 }
 415 echo "</ol>";
 416 ]]></programlisting>
 417             </example>
 418         </sect3>
 419
 420         <sect3 id="zend.service.technorati.queries.bloginfo">
 421             <title>Technorati BlogInfo</title>
 422             <para>
 423                 <ulink url="http://technorati.com/developers/api/bloginfo.html">BlogInfo</ulink>
 424                 は、指定した URL に関連するブログの情報を返します。このクエリは
 425                 <link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link>
 426                 オブジェクトを返します。詳細は
 427                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 428                 の <classname>Zend_Service_Technorati::blogInfo()</classname> を参照ください。
 429             </para>
 430             <example id="zend.service.technorati.queries.bloginfo.example-1">
 431                 <title>BlogInfo クエリ</title>
 432                 <programlisting language="php"><![CDATA[
 433 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 434 $result = $technorati->blogInfo('http://devzone.zend.com/');
 435
 436 echo '<h2><a href="' . (string) $result->getWeblog()->getUrl() . '">' .
 437      $result->getWeblog()->getName() . '</a></h2>';
 438 ]]></programlisting>
 439             </example>
 440         </sect3>
 441
 442         <sect3 id="zend.service.technorati.queries.blogposttags">
 443             <title>Technorati BlogPostTags</title>
 444             <para>
 445                 <ulink url="http://technorati.com/developers/api/blogposttags.html">BlogPostTags</ulink>
 446                 クエリは、そのブログでよく使われているタグの情報を返します。このクエリは
 447                 <link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link>
 448                 オブジェクトを返します。詳細は
 449                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 450                 の <classname>Zend_Service_Technorati::blogPostTags()</classname> を参照ください。
 451             </para>
 452             <example id="zend.service.technorati.queries.blogposttags.example-1">
 453                 <title>BlogPostTags クエリ</title>
 454                 <programlisting language="php"><![CDATA[
 455 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 456 $resultSet = $technorati->blogPostTags('http://devzone.zend.com/');
 457
 458 echo "<p>Reading " . $resultSet->totalResults() .
 459      " of " . $resultSet->totalResultsAvailable() .
 460      " available results</p>";
 461 echo "<ol>";
 462 foreach ($resultSet as $result) {
 463     echo "<li>" . $result->getTag() . "</li>";
 464 }
 465 echo "</ol>";
 466 ]]></programlisting>
 467             </example>
 468         </sect3>
 469
 470         <sect3 id="zend.service.technorati.queries.getinfo">
 471             <title>Technorati GetInfo</title>
 472             <para>
 473                 <ulink url="http://technorati.com/developers/api/getinfo.html">GetInfo</ulink>
 474                 クエリは、あるメンバーについて Technorati が把握している情報を返します。このクエリは
 475                 <link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link>
 476                 オブジェクトを返します。詳細は
 477                 <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 478                 の <classname>Zend_Service_Technorati::getInfo()</classname> を参照ください。
 479             </para>
 480             <example id="zend.service.technorati.queries.getinfo.example-1">
 481                 <title>GetInfo クエリ</title>
 482                 <programlisting language="php"><![CDATA[
 483 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 484 $result = $technorati->getInfo('weppos');
 485
 486 $author = $result->getAuthor();
 487 echo "<h2>Blogs authored by " . $author->getFirstName() . " " .
 488      $author->getLastName() . "</h2>";
 489 echo "<ol>";
 490 foreach ($result->getWeblogs() as $weblog) {
 491     echo "<li>" . $weblog->getName() . "</li>";
 492 }
 493 echo "</ol>";
 494 ]]></programlisting>
 495             </example>
 496         </sect3>
 497
 498         <sect3 id="zend.service.technorati.queries.keyinfo">
 499             <title>Technorati KeyInfo</title>
 500             <para>
 501                KeyInfo クエリは、<acronym>API</acronym> キーの使用状況についての情報を返します。このクエリは
 502                <link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link>
 503                オブジェクトを返します。詳細は
 504                <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 505                の <classname>Zend_Service_Technorati::keyInfo()</classname> を参照ください。
 506             </para>
 507         </sect3>
 508
 509     </sect2>
 510
 511     <sect2 id="zend.service.technorati.classes">
 512         <title>Zend_Service_Technorati クラス</title>
 513         <para>
 514             以下のクラスは、Technorati の各種クエリから返されるものです。
 515             <classname>Zend_Service_Technorati_*ResultSet</classname> 系のクラスは、
 516             それぞれの形式にあわせた結果セットを保持します。
 517             その中身は形式にあわせた結果オブジェクトであり、容易に処理できます。
 518             これらの結果セットクラスはすべて
 519             <classname>Zend_Service_Technorati_ResultSet</classname> クラスを継承しており、かつ
 520             <code>SeekableIterator</code> インターフェイスを実装しています。
 521             これによって、結果のループ処理や特定の結果の取り出しが簡単にできるようになります。
 522             <itemizedlist>
 523                 <listitem><para><link linkend="zend.service.technorati.classes.resultset"><classname>Zend_Service_Technorati_ResultSet</classname></link></para></listitem>
 524                 <listitem><para><link linkend="zend.service.technorati.classes.cosmosresultset"><classname>Zend_Service_Technorati_CosmosResultSet</classname></link></para></listitem>
 525                 <listitem><para><link linkend="zend.service.technorati.classes.searchresultset"><classname>Zend_Service_Technorati_SearchResultSet</classname></link></para></listitem>
 526                 <listitem><para><link linkend="zend.service.technorati.classes.tagresultset"><classname>Zend_Service_Technorati_TagResultSet</classname></link></para></listitem>
 527                 <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresultset"><classname>Zend_Service_Technorati_DailyCountsResultSet</classname></link></para></listitem>
 528                 <listitem><para><link linkend="zend.service.technorati.classes.tagsresultset"><classname>Zend_Service_Technorati_TagsResultSet</classname></link></para></listitem>
 529                 <listitem><para><link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link></para></listitem>
 530                 <listitem><para><link linkend="zend.service.technorati.classes.cosmosresult"><classname>Zend_Service_Technorati_CosmosResult</classname></link></para></listitem>
 531                 <listitem><para><link linkend="zend.service.technorati.classes.searchresult"><classname>Zend_Service_Technorati_SearchResult</classname></link></para></listitem>
 532                 <listitem><para><link linkend="zend.service.technorati.classes.tagresult"><classname>Zend_Service_Technorati_TagResult</classname></link></para></listitem>
 533                 <listitem><para><link linkend="zend.service.technorati.classes.dailycountsresult"><classname>Zend_Service_Technorati_DailyCountsResult</classname></link></para></listitem>
 534                 <listitem><para><link linkend="zend.service.technorati.classes.tagsresult"><classname>Zend_Service_Technorati_TagsResult</classname></link></para></listitem>
 535                 <listitem><para><link linkend="zend.service.technorati.classes.getinforesult"><classname>Zend_Service_Technorati_GetInfoResult</classname></link></para></listitem>
 536                 <listitem><para><link linkend="zend.service.technorati.classes.bloginforesult"><classname>Zend_Service_Technorati_BlogInfoResult</classname></link></para></listitem>
 537                 <listitem><para><link linkend="zend.service.technorati.classes.keyinforesult"><classname>Zend_Service_Technorati_KeyInfoResult</classname></link></para></listitem>
 538             </itemizedlist>
 539         </para>
 540         <note>
 541             <para>
 542                 <classname>Zend_Service_Technorati_GetInfoResult</classname>、
 543                 <classname>Zend_Service_Technorati_BlogInfoResult</classname>
 544                 そして <classname>Zend_Service_Technorati_KeyInfoResult</classname>
 545                 には上にあげたクラスと異なる点があります。これらは結果セットに属しておらず、
 546                 インターフェイスを実装していません。これらは単一のレスポンスオブジェクトを表し、
 547                 <classname>Zend_Service_Technorati_Author</classname> や <classname>Zend_Service_Technorati_Weblog</classname>
 548                 といった <classname>Zend_Service_Technorati</classname> のオブジェクトのラッパーとして働きます。
 549             </para>
 550         </note>
 551         <para>
 552             <classname>Zend_Service_Technorati</classname> には、これ以外にも
 553             特定のレスポンスオブジェクトを表す便利なクラスが含まれています。
 554             <classname>Zend_Service_Technorati_Author</classname> は、Technorati のアカウント
 555             (ブログの著者、いわゆるブロガー) を表します。
 556             <classname>Zend_Service_Technorati_Weblog</classname> は単一のウェブログオブジェクトを表します。
 557             ここには、フィードの URL やブログ名などの情報が含まれます。詳細は
 558             <ulink url="http://framework.zend.com/apidoc/core/"><acronym>API</acronym> リファレンスガイド</ulink>
 559             の <classname>Zend_Service_Technorati</classname> を参照ください。
 560         </para>
 561
 562         <sect3 id="zend.service.technorati.classes.resultset">
 563             <title>Zend_Service_Technorati_ResultSet</title>
 564             <para>
 565                 <classname>Zend_Service_Technorati_ResultSet</classname> は最も重要な結果セットです。
 566                 クエリ固有の結果セットクラス群はこのクラスを継承して作成しています。
 567                 このクラス自体のインスタンスを直接作成してはいけません。
 568                 各子クラスは、クエリの種類に応じた
 569                 <link linkend="zend.service.technorati.classes.result"><classname>Zend_Service_Technorati_Result</classname></link>
 570                 オブジェクトのコレクションを表します。
 571             </para>
 572             <para>
 573                 <classname>Zend_Service_Technorati_ResultSet</classname> は <acronym>PHP</acronym> の <code>SeekableIterator</code>
 574                 インターフェイスを実装しており、<code>foreach</code>
 575                 文で結果を処理できます。
 576             </para>
 577             <example id="zend.service.technorati.classes.resultset.example-1">
 578                 <title>結果セットコレクション内の結果オブジェクトの反復処理</title>
 579                 <programlisting language="php"><![CDATA[
 580 // 単純なクエリを実行します
 581 $technorati = new Zend_Service_Technorati('VALID_API_KEY');
 582 $resultSet = $technorati->search('php');
 583
 584 // $resultSet は Zend_Service_Technorati_SearchResultSet
 585 // のインスタンスです
 586 // これは Zend_Service_Technorati_ResultSet を継承しています
 587 foreach ($resultSet as $result) {
 588     // Zend_Service_Technorati_SearchResult オブジェクトに対して
 589     // 何らかの操作をします
 590 }
 591 ]]></programlisting>
 592             </example>
 593         </sect3>
 594
 595         <sect3 id="zend.service.technorati.classes.cosmosresultset">
 596             <title>Zend_Service_Technorati_CosmosResultSet</title>
 597             <para>
 598                 <classname>Zend_Service_Technorati_CosmosResultSet</classname> は
 599                 Technorati Cosmos クエリの結果セットを表します。
 600             </para>
 601             <note>
 602                 <para>
 603                     <classname>Zend_Service_Technorati_CosmosResultSet</classname> は
 604                     <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
 605                     を継承しています。
 606                 </para>
 607             </note>
 608         </sect3>
 609
 610         <sect3 id="zend.service.technorati.classes.searchresultset">
 611             <title>Zend_Service_Technorati_SearchResultSet</title>
 612             <para>
 613                 <classname>Zend_Service_Technorati_SearchResultSet</classname> は
 614                 Technorati Search クエリの結果セットを表します。
 615             </para>
 616             <note>
 617                 <para>
 618                     <classname>Zend_Service_Technorati_SearchResultSet</classname> は
 619                     <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
 620                     を継承しています。
 621                 </para>
 622             </note>
 623         </sect3>
 624
 625         <sect3 id="zend.service.technorati.classes.tagresultset">
 626             <title>Zend_Service_Technorati_TagResultSet</title>
 627             <para>
 628                 <classname>Zend_Service_Technorati_TagResultSet</classname> は
 629                 Technorati Tag クエリの結果セットを表します。
 630             </para>
 631             <note>
 632                 <para>
 633                     <classname>Zend_Service_Technorati_TagResultSet</classname> は
 634                     <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
 635                     を継承しています。
 636                 </para>
 637             </note>
 638         </sect3>
 639
 640         <sect3 id="zend.service.technorati.classes.dailycountsresultset">
 641             <title>Zend_Service_Technorati_DailyCountsResultSet</title>
 642             <para>
 643                 <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> は
 644                 Technorati DailyCounts クエリの結果セットを表します。
 645             </para>
 646             <note>
 647                 <para>
 648                     <classname>Zend_Service_Technorati_DailyCountsResultSet</classname> は
 649                     <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
 650                     を継承しています。
 651                 </para>
 652             </note>
 653         </sect3>
 654
 655         <sect3 id="zend.service.technorati.classes.tagsresultset">
 656             <title>Zend_Service_Technorati_TagsResultSet</title>
 657             <para>
 658                 <classname>Zend_Service_Technorati_TagsResultSet</classname> は
 659                 Technorati TopTags あるいは BlogPostTags クエリの結果セットを表します。
 660             </para>
 661             <note>
 662                 <para>
 663                     <classname>Zend_Service_Technorati_TagsResultSet</classname> は
 664                     <link linkend="zend.service.technorati.classes.resultset">Zend_Service_Technorati_ResultSet</link>
 665                     を継承しています。
 666                 </para>
 667             </note>
 668         </sect3>
 669
 670         <sect3 id="zend.service.technorati.classes.result">
 671             <title>Zend_Service_Technorati_Result</title>
 672             <para>
 673                 <classname>Zend_Service_Technorati_Result</classname> は最も重要な結果オブジェクトです。
 674                 クエリ固有の結果クラス群はこのクラスを継承して作成しています。
 675                 このクラス自体のインスタンスを直接作成してはいけません。
 676             </para>
 677         </sect3>
 678
 679         <sect3 id="zend.service.technorati.classes.cosmosresult">
 680             <title>Zend_Service_Technorati_CosmosResult</title>
 681             <para>
 682                 <classname>Zend_Service_Technorati_CosmosResult</classname> は
 683                 Technorati Cosmos クエリの単一の結果オブジェクトを表します。
 684                 単体のオブジェクトとして返されることはなく、常に
 685                 <link linkend="zend.service.technorati.classes.cosmosresultset">Zend_Service_Technorati_CosmosResultSet</link>
 686                 オブジェクトに含まれる形式で返されます。
 687             </para>
 688             <note>
 689                 <para>
 690                     <classname>Zend_Service_Technorati_CosmosResult</classname> は
 691                     <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
 692                     を継承しています。
 693                 </para>
 694             </note>
 695         </sect3>
 696
 697         <sect3 id="zend.service.technorati.classes.searchresult">
 698             <title>Zend_Service_Technorati_SearchResult</title>
 699             <para>
 700                 <classname>Zend_Service_Technorati_SearchResult</classname> は
 701                 Technorati Search クエリの単一の結果オブジェクトを表します。
 702                 単体のオブジェクトとして返されることはなく、常に
 703                 <link linkend="zend.service.technorati.classes.searchresultset">Zend_Service_Technorati_SearchResultSet</link>
 704                 オブジェクトに含まれる形式で返されます。
 705             </para>
 706             <note>
 707                 <para>
 708                     <classname>Zend_Service_Technorati_SearchResult</classname> は
 709                     <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
 710                     を継承しています。
 711                 </para>
 712             </note>
 713         </sect3>
 714
 715         <sect3 id="zend.service.technorati.classes.tagresult">
 716             <title>Zend_Service_Technorati_TagResult</title>
 717             <para>
 718                 <classname>Zend_Service_Technorati_TagResult</classname> は
 719                 Technorati Tag クエリの単一の結果オブジェクトを表します。
 720                 単体のオブジェクトとして返されることはなく、常に
 721                 <link linkend="zend.service.technorati.classes.tagresultset">Zend_Service_Technorati_TagResultSet</link>
 722                 オブジェクトに含まれる形式で返されます。
 723             </para>
 724             <note>
 725                 <para>
 726                     <classname>Zend_Service_Technorati_TagResult</classname> は
 727                     <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
 728                     を継承しています。
 729                 </para>
 730             </note>
 731         </sect3>
 732
 733         <sect3 id="zend.service.technorati.classes.dailycountsresult">
 734             <title>Zend_Service_Technorati_DailyCountsResult</title>
 735             <para>
 736                 <classname>Zend_Service_Technorati_DailyCountsResult</classname> は
 737                 Technorati DailyCounts クエリの単一の結果オブジェクトを表します。
 738                 単体のオブジェクトとして返されることはなく、常に
 739                 <link linkend="zend.service.technorati.classes.dailycountsresultset">Zend_Service_Technorati_DailyCountsResultSet</link>
 740                 オブジェクトに含まれる形式で返されます。
 741             </para>
 742             <note>
 743                 <para>
 744                     <classname>Zend_Service_Technorati_DailyCountsResult</classname> は
 745                     <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
 746                     を継承しています。
 747                 </para>
 748             </note>
 749         </sect3>
 750
 751         <sect3 id="zend.service.technorati.classes.tagsresult">
 752             <title>Zend_Service_Technorati_TagsResult</title>
 753             <para>
 754                 <classname>Zend_Service_Technorati_TagsResult</classname> は
 755                 Technorati TopTags あるいは BlogPostTags クエリの単一の結果オブジェクトを表します。
 756                 単体のオブジェクトとして返されることはなく、常に
 757                 <link linkend="zend.service.technorati.classes.tagsresultset">Zend_Service_Technorati_TagsResultSet </link>
 758                 オブジェクトに含まれる形式で返されます。
 759             </para>
 760             <note>
 761                 <para>
 762                     <classname>Zend_Service_Technorati_TagsResult</classname> は
 763                     <link linkend="zend.service.technorati.classes.result">Zend_Service_Technorati_Result</link>
 764                     を継承しています。
 765                 </para>
 766             </note>
 767         </sect3>
 768
 769         <sect3 id="zend.service.technorati.classes.getinforesult">
 770             <title>Zend_Service_Technorati_GetInfoResult</title>
 771             <para>
 772                 <classname>Zend_Service_Technorati_GetInfoResult</classname> は
 773                 Technorati GetInfo クエリの単一の結果オブジェクトを表します。
 774             </para>
 775         </sect3>
 776
 777         <sect3 id="zend.service.technorati.classes.bloginforesult">
 778             <title>Zend_Service_Technorati_BlogInfoResult</title>
 779             <para>
 780                 <classname>Zend_Service_Technorati_BlogInfoResult</classname> は
 781                 Technorati BlogInfo クエリの単一の結果オブジェクトを表します。
 782             </para>
 783         </sect3>
 784
 785         <sect3 id="zend.service.technorati.classes.keyinforesult">
 786             <title>Zend_Service_Technorati_KeyInfoResult</title>
 787             <para>
 788                 <classname>Zend_Service_Technorati_KeyInfoResult</classname> は
 789                 Technorati KeyInfo クエリの単一の結果オブジェクトを表します。
 790                 これは
 791                 <link linkend="zend.service.technorati.checking-api-daily-usage">Technorati <acronym>API</acronym> キーの使用状況</link>
 792                 についての情報を提供します。
 793             </para>
 794         </sect3>
 795
 796     </sect2>
 797
 798 </sect1>