1時間コースの入門編の資料です。

1. Google App
Engine for Java
Java
shin1ogawa@

2. • Platform
•
•
•
•
• Datastore
•
•
•

3. Platform

4. Platform
•
• Disk
•
• AppEngine
• Google Apps Apps

5. Platform
• Google
• Google
•

6. Platform
•
•
JVM …
• Platform
•
•
• AppEngine

7. Platform
• WebContainer
• static FrontEnd
•
• DatastoreService
• MailService
• URLFetchService
• ImageService...

8. Platform
•
/ , CPU
, DISK
, API ,
...

9. Platform
“ ”
• 1
1
• ”release”
”snapshot” …
• http://myappid.appspot.com/ ...
• http://snapthot.latest.myappid.appspot.com/ ...
•
• datastore
• python java

10. Platform
Web
• JVM JDK1.6 Hotspot Client VM
• Jetty
• Jetty JEE App Engine
• Jetty Comet (30 stream )
• = JVM
• static

11. Platform
•
• Disk
•
• API
• Java
: http://code.google.com/intl/ja/appengine/docs/quotas.html

12. Platform
Java
•
• Thread
• Socket
• JDK class
• white-list class -> http://
code.google.com/intl/ja/appengine/docs/java/jrewhitelist.html
• GC
• ...

14. 1
• : Google
•
• Best practices for writing scalable applications
•
• Google Group
• Google App Engine for Java
• Google App Engine
• Google-App-Engine-Japan
• Google Code
• googleappengine
• Google I/O

15. 2
• Google App Engine Blog
• AppEngine Cookbook
• appengine java night ( ?)
•
• tips
•
•
• shin1ogawa
• 1, 3 IRC Office Hour
• irc://irc.freenode.net/#appengine
• Google Calendar: delevepoer-calendar@google.com

16. 3
• http://tech.topgate.co.jp/
: AppEngineSDK
Hackathon Googler

18. • Google Plugins for Eclipse(SDK )
• Eclipse
• AppEngine ! ( )
• Ant(SDK )
• dev_appserver
• app_cfg AppEngine
• Python SDK(JavaSDK )
• index vacuum(Index Error )
• bulkloader(Datastore Export/Import)
• NetBeans IntelliJ IDEA plugin …

19. •
• SDK
local_db.bin(
) SDK
• local_db.bin AppID
local_db.bin k
• Maven
• mvnsearch appengine
• shin1ogawa Maven SDK plugin

20. •
• java.util.logging
• war/WEB-INF/appengine-web.xml logging.properties
•
...shin1ogawa

21. appengine
• war/WEB-INF/
• appengine-web.xml
...appengine
• datastore-indexes.xml ... index
• cron.xml ...cron
• queue.xml ...taskqueue
• appegnine-generated/
• datastore-indexes-auto.xml
... index
• local_db.bin ...Datastore

22. appengine-web.xml
• on/off
• https on/off ...1.2.6 on
• static
•
• logging.properties
• web.xml

23. Datastore

24. Datastore
• Kind...RDB
• Entity...RDB
• Property...RDB
• Index...RDB
• Key...Entity
• Filter...SQL Where
• equality filter... ”=” Filter
• inequality filter...”>”, “>=”, “<=”, “<“
• Entity Group... Entity

25. Datastore
• BigTable
• ...
• RDB
• ( = key )
• [0]id=1, name=”Hoge”
• [1]id=2, height=170.5, weight=65.5
• [2]id=3, tag=[“Apple”, “Java”]
•

26. Datastore
•
• Entity 80ms/1
• RDB Index
• Entity
•
• Query
( )
•

27. Datastore
•
• Entity 80ms/1
• RDB Index
• Entity
•
• Query
( )
•

28. Datastore
Entity Group
• Entity
• RDB Relation
• Java
• )
• Kind:Entity:id=1
• Kind:Entity:id=2
• Kind:Entity:id=3
• Kind:Entity:id=4
• Kind:Entity:id=5

29. Datastore
Key
• Entity Property
• Long (id) String (name) Key Id
• EntityGroup Entity Key
Entity
• Entity: Kind=Parent, id=1
• Entity: Kind=Child, name=“hoge@fuga.com”
• Entity Key
• Parent(1)/Child(“hoge@fuga.com”)

30. Datastore
Property
• Entity
• java.lang
• String 500
• Text
• 500 String
• Blob
•
• List Property
•

31. Datastore
Index
• Property
• Kind Index
• Kind Key Index
• Single Property Index
• Property Index
• Composite Index
• Property Index
• Text Blob Index
(index explosion) Composite
Property Index

32. Datastore
Transaction
• ACID
•
• JDO
•
• Transaction EntityGroup
Entity
•

33. Datastore
Query
• ’<‘, ‘<=’, ‘==’, ‘>=’, ‘>’
• Like (startsWith())
• And
• Java ‘IN’, ‘!=’
• Property
inequality filter Property
• max() min()
• Join

34. Datastore
Query
• Index
! Index
• Kind Index, Single Property Index
Datastore
• Composite Index datastore-indexes.xml

35. Datastore
NG
•
•
ID
• 1,2,3,1001,1002...
•
• 1000
• JDO 1000
Google tips
” ”

36. Datastore
•
•
•
• Kind
• EntityGroup (
Transaction )
• Transaction
•

37. Datastore
• JDO, JPA, Low-level API 3
• JPA
• JDO ORM
• Datastore
• Low-level API
• JDO Low-level API
• JDO Low-level API
JEE ...
Low-level API

38. Datastore
JDO/Entity
@PersistenceCapable(identityType = IdentityType.APPLICATION)
public class Entity {
@Persistent
@PrimaryKey(valueStrategy = IdGeneratorStrategy.IDENTITY)
Key id;
@Persistent String value;
@Persistent(defaultFetchGroup = “true”) Text text;
@Persistent(defaultFetchGroup = “true”) List<Child> children;
@Persistent Key otherEntity;
}
Fetch Fetch
Entity List Owned
Entity Unowned

39. Datastore
JDO/
PersistentManager pm = ... // PersistentManager ;
Parent parent = new Parent();
parent.set......
List<Child> children = new ArrayList<Child>();
children.add(child1);
parent.setChildren(children);
try {
Transaction transaction = pm.currentTransaction();
transaction.begin();
pm.makePersistent(parent);
transaction.commit();
} finally {
if (transaction.isActive())
transaction.rollback();
}

40. Datastore
JDO/
PersistentManager pm = ... // PersistentManager ;
Query query = pm.newQuery(Entity.class);
query.setFilter(“name == param”);
query.declareParameters(“java.lang.String param”);
query.setOrdering(“name asc, key desc”);
@SuppressWarnings("unchecked")
List<Entity> list = (List<Entity>) query.execute(“hoge”);
...
Key key = KeyFactory.createKey(“Entity”, “keyName”);
Entity entity = pm.getObjectById(Entity.class, key);
Key key = entity.getOtherEntityKey();
OtherEntity otherEntity = pm.getObjectById(OtherEntity.class, key);

41. Datastore
JDO/
•
• transient, hollow, persistent/detached
• JDOHelper#getObjectState()
• PersistenceManager
InstanceLifecycleListener
• PersistenceManager#execute() List
serialize
• PersistenceManager#retrieve[All]() Property
fetch

42. Datastore
Low-level API/
Entity entity = new Entity(“Kind”); // Low-level API Entity
entity.setProperty(“name”, “hoge”);
entity.setProperty(“height”, 170.5);
DatastoreService service =
DatastoreServiceFactory.getDatastoreService();
service.put(entity);
Entity[] entities = ....
service.put(entities);
Entity

43. Datastore
Low-level API/
Query query = new Query(“Entity”);
query
.addFilter(“name”, FilterOperator.GREATER_THAN_OR_EQUAL, “hoge”)
.addSort("name", SortDirection.ASCENDING)
.addSort("__key__", SortDirection.ASCENDING);
DatastoreService service =
DatastoreServiceFactory.getDatastoreService();
List<Entity> entities = service.prepare(query).asList(
FetchOptions.Builder.withOffset(0));
Key key = KeyFactory.createKey(“Entity”, “keyName”);
Entity entity = service.get(key);
property ”__key__”

45. MemcacheService
•
• ( )
•
• cache
• JCache(javax.cache), Low-level API 2
MemcacheService service =
MemcacheServiceFactory.getMemcacheService();
service.put("key", list);
Object cachedObject = service.get("key");
service.delete("key");

46. cron
•
• URL Servlet
•
•
cron.xml
<?xml version="1.0" encoding="UTF-8"?>
<cronentries>
<cron>
<url>/cron/fetch?name=jiemamy-sf</url>
<description>fetch the jiemamy SF.jp timeline.</description>
<schedule>every 1 minutes</schedule>
</cron>
</cronentries>

47. TaskQueue
• (task)
• URL Servlet
•
queue.xml
<?xml version="1.0" encoding="UTF-8"?>
<queue-entries>
<queue>
<name>default</name>
<rate>1/s</rate>
<bucket-size>3</bucket-size>
</queue>
</queue-entries>

48. • MailService
• ( Servlet )
• XMPPService
• ( Servlet )
• URLFetchService
• ImageService
• UserService
• Google Account
• Google
appengine-java ML

49. UI
• UI …
…
•
Google App Engine ” ” ”
”

50. shin1ogawa@