Lvx ex Cælis

GAEO 預設有幾種繞徑方式，官方文件如是說：

1. / 代表呼叫 {'controller':'welcome', 'action':'index'}
2. /foo/bar 代表呼叫 {'controller':'foo', 'action': 'bar'}
3. /foo 代表呼叫 {'controller':'foo', 'action':'index'}

如果你也是用 gaeogen.py 產生出基本架構的話，那就還有：

1. /foo/bar/blah 代表呼叫 {'controller':'foo', 'action': 'bar', 'id': 'blah'}

官方文件中的範例跟使用 gaeogen.py 產生出的架構相同，但沒有說要怎麼取得 Controller 、 Action 和 ID ，在下對於 Python 不熟，所以又是試了一段時間才成功。

Controller 應該不用再次介紹，用 gaeogen.py 產生出來便是。Action 是指 Controller 中的 function 名稱，舉例來說， index 就是一個 Action 。

class MyController(BaseController):
  def index(self): # 我就是 Action 啦！
    pass

接下來的問題是要怎麼取得 ID ，我 trace 原始碼 trace 了很久（因為我是新手嘛！），才知道原來用 self.params.get('id') 便能取得。此外也可以用 self.params['id'] ，但這個方法在沒有 ID 時會發生錯誤。以下給一份完整的範例，此範例的用途是將Yahoo!奇摩字典的 Auto-completion 轉換為 Firefox 可用的 OpenSearch Suggestions 格式。

import cgi
from gaeo.controller import BaseController
from google.appengine.api import urlfetch

class YdictController(BaseController):
  def index(self):
    pass

  def lookup(self):
    p = cgi.escape(self.params['id']) if 'id' in self.params else ''
    try:
      result = urlfetch.fetch('http://ws.dict.tpe.yahoo.com/suggest_data.php?of=js&p=' + p, method="GET")
      if result.status_code == 200 and result.content.startswith('fxsearch([') and result.content.endswith('])'):
        suggestions = result.content[9:-1]
        self.render(text=suggestions)
    except:
      pass

成果：http://bcse.appspot.com/ydict/lookup/sugges

等我試出來後，突然想到了什麼，便去查 RoR 的文件…… 果不其然，這取用方法跟 RoR 好像啊～ 看來在 GAEO 缺乏文件的現在，或許也能先參考 RoR 的文件…… XD

雖然放假了，我還是滿常來 Lab 的，這兩天的主要內容是研究 Google App Engine ，進度從安裝、「Hello World!」、以 Google Account 作身分認證，一直到使用 Datastore API ，然後上 PTT 發現有人把功能很完整的 Ikariam 物資交易平台做好了，讓我又失去了我的題目¹ XD

雖然如此，但作一下最近的筆記。

安裝 Python 、 Google App Engine 及 GAEO

1. 下載 Google App Engine SDK 及 Python 2.5。
2. 以上兩個都是照著指示按「下一步」就能裝好。
3. 下載 GAEO，然後解壓縮到任何你喜歡的地方。
4. 在我的電腦上按右鍵→內容→進階→環境變數。然後在 PATH 的最後加上 ;C:\Python25;D:\Documents\htdocs\gaeo\bin ←此為範例，請根據你將 Python 、 GAEO 安裝在哪裡而修改。至於 Google App Engine SDK 則會自動幫你加上，不用我們動手。

建立一個新的專案

1. 在你喜歡的資料夾中，以命令提示字元執行 gaeo.py project_name ，GAEO 就會幫你建立好 project_name 資料夾以及基本的程式與資料夾結構。
2. 然後在 project_name 資料夾中，以命令提示字元執行 dev_appserver.py --port=8080 . ²，這樣就能將程式執行起來，你可以在 http://127.0.0.1:8080/ 看到結果，看見 “It works!!” 就表示成功了。這個畫面的程式位於 project_name/application/controller/welcome.py ，而 template 位於 project_name/application/templates/welcome 資料夾中。

建立新的 Controller

1. 在 project_name 資料夾中，以命令提示字元執行 gaeogen.py controller Say 這樣會在 project_name/application/controller 中建立一個 say.py ，其中就是新的 Controller ，名為 SayController ；此外也會建立一個 project_name/application/templates/say 資料夾，內容是空的，留待未來使用。

上傳到 Google App Engine

1. 這邊我實在得說 Google 包裝得很好，只要在 project_name 資料夾中，以命令提示字元執行 appcfg.py update .³ ，程式便會傳上去，並且會自動編版號。

其他

1. 以 Google Account 作身分認證同樣很簡單，基本上照著 Google 的教學文件作就沒錯了，只不過在本機端測試時它不需要真的登入，只會出現一個看起來怪怪的登入畫面，這並不是你作錯了。
2. 有時候程式發生問題時，會噴 Error 404 而不給錯誤訊息，我目前還不知道 Python 有什麼簡單的 debug 方式…
3. 目前 GAEO 的 gaeogen.py 只能用來生成 Controller ，所以我不知道 Model 應該放在哪裡…
4. 在編輯工具方面我試了 Eclipse 及 UliPad ， Eclipse 看得出來是一個功能非常強大的 IDE ，但我不知道怎麼將它和 GAEO 整合在一起⁴；而 UliPad 有些功能不符合我的習慣，它的 Auto-completion 則是基於「本檔案中曾使用過的函式」，對我來說沒什麼幫助，最後還是用回 EmEditor。