Aurora

Antenna.NETで利用している設定保存をする場所の概念。現在はGoogleAppEngineで実装されている。

仕組み

URL保持部とバイナリ保持部を使って行う。バイナリ保持部に保存するとリソースはURLを持つので、そのURLをさらにURL保持部で管理することが出来る。 例えばMusicJackではまず下記を行いそれぞれのURLを取得する。

• diconファイルをバイナリ保持部へアップロード
• モジュールURL群をURL保持部へ送信

得られた二つのURLをさらにURL保持部へ送信することで一意の設定URLを作成している。

URL保持部

http://bookmarklists.appspot.com/

URLのリストをbookmarkとして管理する。タグ付けやプロパティ付けをアプリケーションから行うことができる。 outputパラメータをxml、htmlで指定することで必要な出力を取得できる。ただしHTMLは未完成。

list

bookmarklistの一覧を取得する。

リクエスト

http://bookmarklists.appspot.com/list?output=xml

レスポンス

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bookmarklists>

  <bookmarklist>
    <id>ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYzgUM</id>
    <title>jp.MusicJack</title>
    <url>http://bookmarklists.appspot.com/detail?output=xml&amp;key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYzgUM</url>
    
    <bookmarks>
      <bookmark title="jp.Antenna.Dicon" url="http://f-storage.appspot.com/resources/aglmLXN0b3JhZ2VyDwsSCFJlc291cmNlGL0FDA">
      </bookmark> 
    
      <bookmark title="jp.Antenna.Modules" url="http://bookmarklists.appspot.com/detail?output=xml&amp;key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYyQUM">
      </bookmark> 
    
    </bookmarks>
  </bookmarklist>
  
  <bookmarklist>
    <id>ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYyQUM</id>
    <title>jp.MusicJack</title>
    <url>http://bookmarklists.appspot.com/detail?output=xml&amp;key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYyQUM</url>
    
    <bookmarks>
      <bookmark title="Module" url="http://antenna.sourceforge.jp/sandbox/mj/MusicJackMain.zip">
      </bookmark> 
    
      <bookmark title="Module" url="http://antenna.sourceforge.jp/sandbox/mj/Player.zip">
      </bookmark> 
    
      <bookmark title="Module" url="http://antenna.sourceforge.jp/sandbox/mj/News.zip">
      </bookmark> 
    </bookmarks>
  </bookmarklist>
<bookmarklists>

detail

あるBookmarkListの詳細を取得する。

リクエスト

http://bookmarklists.appspot.com/detail?output=xml&key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYzgUM

レスポンス

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bookmarklist>
  <id>ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYzgUM</id>
  <title>jp.MusicJack</title>
  <url>http://bookmarklists.appspot.com/detail?output=xml&amp;key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYzgUM</url>
  
  <bookmarks>
    <bookmark title="jp.Antenna.Dicon" url="http://localhost:8080/resources/aglmLXN0b3JhZ2VyDwsSCFJlc291cmNlGL0FDA">
    </bookmark> 
  
    <bookmark title="jp.Antenna.Modules" url="http://bookmarklists.appspot.com/detail?output=xml&amp;key=ag1ib29rbWFya2xpc3RzchMLEgxCb29rbWFya0xpc3QYyQUM">
    </bookmark> 
  
  </bookmarks>

  <tag value="jp.MusicJack"/>
  <tag value="jp.Antenna.Configs"/>
</bookmarklist>

edit

POSTすることで値を格納することができる。

リクエスト

http://bookmarklists.appspot.com/edit

POSTパラメータ

output=xml&
title=jp.MusicJack&
prop[application]=jp.MusicJack&
tag=jp.MusicJack&
tag=jp.Antenna.Modules&
bookmarks[0][url]=http://antenna.sourceforge.jp/sandbox/mj/MusicJackMain.zip&
bookmarks[0][title]=Module&
bookmarks[1][url]=http://antenna.sourceforge.jp/sandbox/mj/Player.zip&
bookmarks[1][title]=Module&

上記のような意味合いのパラメータをそれぞれURLエンコードしてから送付する。

レスポンス

detailと同様

search

tagを利用して検索できる。プロパティ検索には未対応。

リクエスト

http://localhost:8070/search?output=xml&tag=jp.Antenna.Configs&

レスポンス

listと同様

バイナリ保持部

http://f-storage.appspot.com/

register

http://f-storage.appspot.com/register

へファイルアップロードする。fileのパラメータ名は"file"。

レスポンス

<?xml version="1.0" encoding="UTF-8"?>
<storage>
  <resources>
    <resource id="aglmLXN0b3JhZ2VyDwsSCFJlc291cmNlGPgFDA" url="http://localhost:8080/resources/aglmLXN0b3JhZ2VyDwsSCFJlc291cmNlGPgFDA">
    </resource> 
  </resources>
</storage>

resource

http://localhost:8080/resource/aglmLXN0b3JhZ2VyDwsSCFJlc291cmNlGOQDDA

指定したキーのファイルをダウンロードできる。