Google App Engine で作った時のメモ

ryomatsu

15年前

先日 Google App Engine を使用して、2ちゃんねるぶろぐという2chコピペブログを集めただけのwebサイトを作ったのだが、それの作成時のメモ。

最初から何も設定しなくても使える webapp を使ってます。

設定
Python Datastore API
webapp フレームワーク
テンプレート
サービス
1. memcache
2. urlfetch

設定

設定ファイルは以下の3つ。yaml形式で書く。
app.yaml
cron.yaml
index.yaml

app.yaml

Python アプリケーション設定 - Google App Engine - Google Code

どのURLを叩かれた場合にどのような動作を行うかを書く。

基本的には以下のような感じ。

application: 2chblogs
version: 1
runtime: python
api_version: 1
# 静的なファイルを置く場合。
# ディレクトリの中にファイルを置いておけばdeployした時に勝手にアップロードされる。
- url: /image
  static_dir: image
# ファビコン
- url: /favicon.ico
  static_files: favicon.ico
  upload: favicon.ico
# 管理ページ memcacheとかdbとかの中身見れる。
# http://d.hatena.ne.jp/bellbind/20090716/1247757120
# login: admin と書いておけばアクセス時に認証が必要になる。
- url: /admin/.*
  script: $PYTHON_LIB/google/appengine/ext/admin
  login: admin
# 上記に当てはまらない場合はすべてmain.pyを叩く場合。
# ここで指定するのとmain.py内で指定するのはどう使い分けるべきなんですかね。
handlers:
- url: .*
  script: main.py

cron.yaml

Python 用の cron を使用したスケジュールタスク - Google App Engine - Google Code

cronで動かすものがある場合に必要。なくてもOK。

以下の例では20分置きに /getFeeds を実行。
schedule の指定は英文っぽい感じで、いわゆる cron とはまた別の形式。

cron:
- description: get feeds
  url: /getFeeds
  schedule: every 20 minutes

index.haml

しらん。

Python Datastore API

いわゆるリレーショナルデータベースの代わりに、データストアを使用する。

Model クラス - Google App Engine - Google Code

アプリケーションは、Model をサブクラスするクラスを定義することで、データモデルを定義します。モデルのプロパティは、クラス属性と Property クラスインスタンスを使用して定義されます。次に例を示します。

以下のようにやればSQLでいうテーブルが作成できる。

from google.appengine.ext import db
class Entry(db.Model):
	title = db.StringProperty(required=True)
	link = db.LinkProperty(required=True)
	date = db.DateTimeProperty(required=True)
	summary = db.TextProperty()
	site_url = db.LinkProperty(required=True)
	site_title = db.StringProperty(required=True)

データの型に関しては以下のページにある。
型とプロパティクラス - Google App Engine - Google Code

# データを挿入する。
_entry = Entry(title=title,
		link=link,
		summary=summary,
		date=_datetime,
		site_url=site_url,
		site_title=site_title)
_entry.put() # put() した時点でデータが入る。
# データを取得する。
# 全部取る場合。
ret = Entry.all()
# Where句を指定且つ一個だけ取得
ret = Entry.gql('WHERE link = :link', link='http://example.com/').fetch(limit=1)
# 並び替え。fetch は limit と offset を引数に与えれる。
ret = Entry.gql('order by date desc').fetch(20,30)

但し、一度に取得できるエントリ数は最大1000までの制限がある。offset で 1000以上を指定しても無駄とかどっかにあった気がする。

where や order by を行う代わりに、Query のインスタンスメソッドの filter() や order() を使用する事もできる。

詳しくは Query クラス - Google App Engine - Google Code を参照。

データの更新はやってないからパス。

webapp フレームワーク

webapp フレームワーク - Google App Engine - Google Code

webapp フレームワークはシンプルな Web アプリケーションフレームワークで、App Engine 向けの Python Web アプリケーション開発に使用できます。

だそうです。

kay とか Django とか使うのも良いのだけど、とりあえず最初なので webapp を使ってみた。

class get(webapp.RequestHandler):
	def get(self, num):
		hoge = self.request.get('hoge')
		# 途中省略
		self.response.out.write(contents)
# http://code.google.com/intl/ja/appengine/docs/python/tools/webapp/running.html
def main():
	application = webapp.WSGIApplication(
		[('/([0-9]*)', get),
		('/getFeeds', getFeeds),
		], debug=True)
	util.run_wsgi_app(application)
if __name__ == '__main__':
	main()

webapp.WSGIApplicationの一つ目の引数の書式は (URL, 実行するクラス) の形のタプル。
URL には正規表現を使用する事ができる。
get() にある num には webapp.WSGIApplication でグループに一致した値が入る。
もしくは、 self.request.get('hoge') で与えられたデータを取得できる。

データの取得方法については以下のページ

リクエストデータ - Google App Engine - Google Code

リクエストハンドラに使用できるメソッドは以下の7つ
get()
post()
head()
options()
put()
delete()
trace()

self.response.out.write(contents)
と書くと contents の中身を表示する。

今回は使ってないけど、リダイレクトとかヘッダーとかステータスコードを使用する場合は以下のページ

リダイレクト、ヘッダー、ステータスコード - Google App Engine - Google Code

テンプレート

webapp で使用できるテンプレートエンジンは Django のそれと同じ。

基本的なとこ

from google.appengine.ext.webapp import template
TEMPLATEDIR = os.path.dirname(__file__) + '/template/'
class hoge(webapp.RequestHandler):
	def get(self):
		template_values = {
				'message' : 'hoge'
				}
		path = TEMPLATEDIR +'hoge.html'
		contents = template.render(path, template_values)
		self.response.out.write(contents)

/template/hoge.html

<p>{{ message }}</p>

if と for

{% if countRanking %}
<div>
	<ul>
		{% for item in itemlist %}
		<li><a href="{{ item.url }}">{{ item.name }}</a></li>
		{% endfor %}
	</ul>
</div>
{% endif %}

block と継承

hoge.html

<h1>{% block h1 %}ここにh1{% endblock %}</h1>

fuga.html

{% extends 'hoge.html' %}
{% block h1 %}ここの値が h1 に入る。{% endblock %}

Filter

一番下はカスタムフィルター。ちょっと前にブログに書いた。
GAE のテンプレートで Unicode 文字列を URLencode する。 - jkl.lomo.jp

{{ item.date|date:"M j, Y H:i:s" }}
{{ item.summary|striptags|slice:"128" }}
{{ item.title|unicode_urlencode }}

詳しくは Django のドキュメントを参考に。
Python プログラマのための Django テンプレート言語ガイド — Django v1.0 documentation
Django テンプレート言語 — Django v1.0 documentation

サービス

memcache と urlfetch しか使ってないのでそこだけメモ

memcache

from google.appengine.api import memcache
# 値をセットする。既に値が保存されていても上書きする。
memcache.set('hoge', hoge, time=3600)
# 値をセットする。既に値が保存されていたら上書きしない。
memcache.add('hoge', hoge, time=3600)
# 値を取得する。値が無ければ None を返す。
hoge = memcache.get('hoge')

ほかにもメソッドあるけど以下略

Memcache Python API - Google App Engine - Google Code

urlfetch

google app engine では外部と通信する場合は http もしくは https しか使えない様です。

from google.appengine.api import urlfetch
result = urlfetch.fetch(url)
if result.status_code is 200:
	hoge(result.content)

URL Fetch Python API - Google App Engine - Google Code

とりあえず自分のメモはこれで終了。

Google App Engine は結構簡単にwebアプリケーションが作れるのでおぬぬめ。

設定