チュートリアル 上級者 3-5: XML Document の構成要素の分析

Oracle of Bacon ではXML のフォーマットでファイルを保存しています。XLM または eXtensible マークアップ言語 はそれぞれのデータタイプをエレメント（要素）を使ってテキストフォームで記述されたデータです。例えば絵画についての XML データベースならば 画家の名前の他に生年月日や命日、絵画のタイトル、製作年などの要素があるはずです。

Oracle of Bacon XML データベースは俳優や出演した映画名などの情報を持っています。Oracle of Bacon Script は俳優名での入力を受け入れ その俳優の出演した映画名を共演者名とともに引き出して１番目の俳優と２番目の俳優を結び付けます。

コードの重要な部分について見てみます。

最初の関数でユーザーがスプレッドシートにインプットした俳優名を保持してOracle of Baconからデータを回収してきます。 コードを調べるためにKevin Bacon spreadsheet へ行ってはじめのセッションを維持してください。【Script editor】を開いて見て見ましょう。 from to という引数名をもつコードがあります。

function kb(from, to) {
  if (!to) {
    to = "Kevin Bacon";
  }

次のブロックで Oracle of Bacon で回収したデータを定義付ています。from toという引数は関係を調べようとして入力された二人の俳優名を含みます。 payload はHTTP POST メソッドで受け取ったOracle of Baconサイトで稼動している CGI への検索言語 を持っています。

 var parameters = {
     method : "post",
     payload :
    "a=" + encodeURIComponent(from) +
     "&b=" + encodeURIComponent(to) +
     "&u=1" +  // movies only. Use "3" to include TV
     "&p=" + encodeURIComponent('google-apps')
   };

メソッドの引数は使用されているHTTP リクエストメソッドを指定しており、この場合は HTTP POSTです。 payload 引数は POST リクエスト本体を含みます。この場合はOracle of Bacon サイトへのリクエストを指定するのに必要な４つのname値の組があります。 それらは次のような意味になります。

• "a=" + encodeURIComponent(from) ・・ 一番目の俳優をリクエストします。
• "&b=" + encodeURIComponent(to) ・・ 二番目の配収をリクエストします。
• "&u=1" ・・ 二人の俳優が共に出演している映画をリクエストしています。もし"&u=3"が使われればそれは映画とTVでの二人の共演フィルムということです。
• "&p=" + encodeURIComponent('google-apps') ・・ Google AppsからのリクエストであることをOracle of Bacon に伝えています。

次の行で Oracle of Bacon のXMLデータを拾って、変数textへ入れます。parameters引数は前のコードブロックでOracle of Baconに対して定義づけられたparametersは無視します。

var text = UrlFetchApp.fetch("http://oracleofbacon.org/cgi-bin/xml",
                                parameters).getContentText();

これが Oracle of Bacon から返されたデータの一部です。

 
   Arnold Schwarzenegger
   Total Recall (1990)
   Anne Lockhart (I)
   The Last Song (2010)
   Miley Cyrus
 

XMLデータは と タグの使われている俳優と映画を書き出しています。

kb関数はテスト関数であるtestBacon関数によって継承されます。

最後の parse関数です。ここで XMLデータ がパースされて、表示された XMLデータ が抽出されます。 スクリプトは Xml メソッド の parseを使った変数text中のデータをパースします。parse メソッドは文字列によって提供されるXMLの内容を必要とし、ここでは doc と呼ばれるXMLドキュメントを返します。

function parse(txt) {
var doc = Xml.parse(txt, true);

XMLドキュメントである doc から３個のXMLエレメント（要素）オブジェクトを取り出すのが次のコードです。順番に html,head,body セクションです。

var html = doc.html;       
var head = doc.html.head;       
var body = doc.html.body;

Oracle of Bacon では htmlタグ と head タグだけの使用なので doc.html.body は失敗します。 body タグはありません。 doc.html.head タグの呼び出しでは movieタグ や actorタグ を含む XML-tagged データを返します。それぞれ典型的なものです。 次のコードでは doc から映画名や俳優名を抽出する明示的なメソッドを使っています。そして moovie や actors という配列にします。

var movies = doc.html.head.getElements("movie");
var actors = doc.html.head.getElements("actor");

最後に次のコードで二人の俳優の関連を検索して表示します。

var movieIndex = 0;
  var r = '';
  var firstPerson = true;
  for (var i in actors) {
    r = r + actors[i].getText();
    if (movies[movieIndex]) {
      r = r + (firstPerson ? "" : " who") + " was in " +
         movies[movieIndex].getText() + " with ";
    }
    movieIndex++;
    firstPerson = false;
  }
  
  return r;
  }

Kevin Bacon Scriptの完全版です。

// This script makes use of the Oracle of Bacon,
// a very cool site at http://oracleofbacon.org.
// Takes two arguments: names of actors.  The second 
// is optional, and defaults to "Kevin Bacon" if unspecified.
//
// Example usage in a spreadsheet:
//      =kb("Miley Cyrus", "Arnold Schwarzenegger")
//

function kb(from, to) {
  if (!to) {
    to = "Kevin Bacon";
  }
  var parameters = {
    method : "post",
    payload :
    "a=" + encodeURIComponent(from) +
    "&b=" + encodeURIComponent(to) +
    "&u=1" +  // movies only. Use "3" to include TV
    "&p=" + encodeURIComponent('google-apps')
  };
  
  var text = UrlFetchApp.fetch("http://oracleofbacon.org/cgi-bin/xml",
                               parameters).getContentText();
  return parse(text);
}
  
function testBacon() {
  var result = kb("Miley Cyrus", "arnold schwarzenegger");
  Logger.log(result);
}

function parse(txt) {
  var doc = Xml.parse(txt, true);
  var attr = doc.spellcheck;
  if (attr) {
    return "Cannot find actor: " + attr.name;
  }
 
  var actors = doc.html.head.getElements("actor");      
  var movies = doc.html.head.getElements("movie");
  
  if (!actors || actors.length ==0) {
    return "no match found";
  }
  
  var movieIndex = 0;
  var r = '';
  var firstPerson = true;
  for (var i in actors) {
    r = r + actors[i].getText();
    if (movies[movieIndex]) {
      r = r + (firstPerson ? "" : " who") + " was in " +
        movies[movieIndex].getText() + " with ";
    }
    movieIndex++;
    firstPerson = false;
  }
  
  return r;
}