2．Drive上のSpreadSheetをApp Engineから読み取り画面表示する
ここまでで、ExcelシートとSpreadsheetのアップロードおよびファイル変換についての説明は終わり、次に本連載メインテーマのApp EngineからのSpreadsheet読み取りについて入っていきます。
ただし、ここからはJavaやJavascriptを使用したプログラミングの内容になっていきますので、ある程度プログラミング経験があることを前提とした内容になっていきます。
図9：Drive上のスプレッドデータをApp Engineから読み取る（クリックで拡大）
ここで紹介するApp EngineからのSpreadsheet読み取りでは、参照画面のボタンクリックから起動されるサーブレットによってビーンズをインスタンス化し、その中のメソッドによって実行されます（図9）。読み取られたSpreadデータはブラウザに画面表示されますが、今回は簡易形式での画面表示を紹介し、次回の連載でスプレッドシート風のグリッド表示について紹介します。
2.1 デプロイメントディスクリプタ（web.xml）を記述する
リスト1 デプロイメントディスクリプタ（web.xml）
01 | <?xml version="1.0" encoding="utf-8" standalone="no"?> |
04 | <servlet-name>spread</servlet-name> |
05 | <servlet-class>com.google.gdata.SpreadServlet</servlet-class> |
08 | <servlet-name>spread</servlet-name> |
09 | <url-pattern>/spread</url-pattern> |
13 | <welcome-file>index.htm</welcome-file> |
ブラウザからの表示リクエストはデプロイメントディスクリプタ（web.xml）の記述にしたがってサーブレットを呼び出します。この辺りは問題ないでしょう。
2.2 サーブレットを記述する
リスト2 サーブレット（SpreadServlet.java）
01 | package com.google.gdata; |
02 | import java.io.IOException; |
03 | import java.io.PrintWriter; |
04 | import javax.servlet.http.*; |
05 | import com.google.gdata.util.ServiceException; |
07 | @SuppressWarnings("serial") |
08 | public class SpreadServlet extends HttpServlet { |
09 | public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException { |
10 | resp.setContentType("text/plain"); |
11 | resp.setContentType("text/html; charset=utf-8"); |
12 | PrintWriter out = resp.getWriter(); |
13 | String mode = req.getParameter("mode"); //呼び出すビーンズメソッドを指定 |
14 | String sheet = req.getParameter("sheet"); //読み取るシート名を指定 |
15 | SpreadBean ss = new SpreadBean(); //スプレッドシート処理のビーンズをインスタンス化 |
16 | if (mode.equals("getspreadallshopym")) { //modeパラメータでビーンズメソッド指定 |
17 | String rv = ss.getSpreadAllShopYm(sheet); |
18 | //ワークシート一覧表示のビーンズメソッド呼び出し |
20 | } else if (mode.equals("getspreadshopym")) { |
21 | String shop = req.getParameter("shop"); |
22 | String rv = ss.getSpreadShopYm(sheet, shop); |
23 | //ワークシート店舗別表示のビーンズメソッド呼び出し |
呼び出されたサーブレットはmodeパラメータで指定された値によってビーンズメソッドを呼び出します。
2.3 ワークシート一覧表示のビーンズメソッドを記述する
ここで見ていくビーンズメソッドでは、ワークシートに書き込まれたデータを一覧表示するもので、Spreadsheetの検索表示では一般的なものです。
リスト3 ビーンズ（SpreadBean.java）
01 | package com.google.gdata; |
03 | import java.io.IOException; |
05 | import java.text.DateFormat; |
06 | import java.text.SimpleDateFormat; |
07 | import java.util.ArrayList; |
09 | import java.util.Iterator; |
12 | import com.google.appengine.api.datastore.DatastoreService; |
13 | import com.google.appengine.api.datastore.DatastoreServiceFactory; |
14 | import com.google.appengine.api.datastore.Entity; |
15 | import com.google.appengine.api.datastore.EntityNotFoundException; |
16 | import com.google.appengine.api.datastore.Key; |
17 | import com.google.appengine.api.datastore.KeyFactory; |
18 | import com.google.appengine.api.datastore.Query; |
19 | import com.google.appengine.api.datastore.Query.Filter; |
20 | import com.google.appengine.api.datastore.Query.FilterOperator; |
21 | import com.google.gdata.client.spreadsheet.FeedURLFactory; |
22 | import com.google.gdata.client.spreadsheet.ListQuery; |
23 | import com.google.gdata.client.spreadsheet.SpreadsheetQuery; |
24 | import com.google.gdata.client.spreadsheet.SpreadsheetService; |
25 | import com.google.gdata.data.spreadsheet.CustomElementCollection; |
26 | import com.google.gdata.data.spreadsheet.ListEntry; |
27 | import com.google.gdata.data.spreadsheet.ListFeed; |
28 | import com.google.gdata.data.spreadsheet.SpreadsheetEntry; |
29 | import com.google.gdata.data.spreadsheet.SpreadsheetFeed; |
30 | import com.google.gdata.data.spreadsheet.WorksheetEntry; |
31 | import com.google.gdata.data.spreadsheet.WorksheetFeed; |
32 | import com.google.gdata.util.AuthenticationException; |
33 | import com.google.gdata.util.ServiceException; |
34 | import com.google.appengine.api.datastore.Query.FilterPredicate; |
35 | import com.google.appengine.api.datastore.PreparedQuery; |
37 | public class SpreadBean { |
38 | public String getSpreadAllShopYm(String sheet) { |
39 | String appliName = "cyberspace-SpreadsheetSearch-1"; |
40 | String user = "xxxxxxxxxxxxxxxxxxx"; |
41 | String pass = "xxxxxxxxxxxxxxxxx"; |
43 | /////////////////////////////////////////////////////// |
45 | SpreadsheetService spreadsheetservice = new SpreadsheetService(appliName); |
46 | spreadsheetservice.setUserCredentials(user, pass); |
47 | /////////////////////////////////////////////////////// |
48 | // [II] 検索対象のスプレッドシートを特定 |
49 | FeedURLFactory feedurlfactory = FeedURLFactory.getDefault(); |
50 | SpreadsheetQuery spreadsheetquery |
51 | = new SpreadsheetQuery(feedurlfactory.getSpreadsheetsFeedUrl()); |
52 | spreadsheetquery.setTitleQuery(sheet); |
53 | SpreadsheetFeed spreadsheetfeed |
54 | = spreadsheetservice.query(spreadsheetquery, SpreadsheetFeed.class); |
55 | SpreadsheetEntry spreadsheetentry = spreadsheetfeed.getEntries().get(0); |
56 | /////////////////////////////////////////////////////// |
57 | // [III] 検索対象のワークシートを特定 |
58 | WorksheetEntry worksheetentry = spreadsheetentry.getDefaultWorksheet(); |
59 | /////////////////////////////////////////////////////// |
60 | // [IV] クエリでワークシート内の検索 |
61 | ListQuery listquery = new ListQuery(worksheetentry.getListFeedUrl()); |
62 | ListFeed listfeed = spreadsheetservice.query(listquery, ListFeed.class); |
63 | List<ListEntry> datalist = lisfFeed.getEntries(); |
64 | /////////////////////////////////////////////////////// |
65 | // [V] ワークシートデータをJSONフォーマットにする |
66 | String rv = "{ \"wsdat\":["; |
67 | for (Iterator<ListEntry> it = datalist.iterator(); it.hasNext();) { |
68 | ListEntry listentry = (ListEntry) it.next(); |
69 | rv += "{\"cdat\": \"" + listentry.getPlainTextContent() + "\"},"; |
71 | rv = rv.substring(0, rv.length() - 1) + "]}"; |
73 | } catch (AuthenticationException e) { |
76 | } catch (IOException e) { |
79 | } catch (ServiceException e) { |
[I] 認証処理
1 | String appliName = "cyberspace-SpreadsheetSearch-1"; |
2 | String user = "xxxxxxxxxxxxxxxxxxx"; |
3 | String pass = "xxxxxxxxxxxxxxxxx"; |
5 | SpreadsheetService spreadsheetservice = new SpreadsheetService(appliName); //（1） |
6 | spreadsheetservice.setUserCredentials(user, pass); //（2） |
処理の最初はアプリケーション名の指定と、ユーザ名とパスワードによる認証処理です。
（1）アプリケーション名はSpreadsheetと接続する場合の識別用に使用されます。
（2）ユーザ名とパスワードによる認証はsetUserCredentialsメソッドで行いますが、Googleアカウントのメールアドレスとパスワードを使用します。 実システムでは画面からGoogleアカウントとパスワードを入力して、ユーザの認証を行うようにするのが良いでしょう。
[II] 検索対象のスプレッドシートを特定する
1 | FeedURLFactory feedurlfactory = FeedURLFactory.getDefault(); （1） |
2 | SpreadsheetQuery spreadsheetquery |
3 | = new SpreadsheetQuery(feedurlfactory.getSpreadsheetsFeedUrl()); （2） |
4 | spreadsheetquery.setTitleQuery(sheet); （3） |
5 | SpreadsheetFeed spreadsheetfeed |
6 | = spreadsheetservice.query(spreadsheetquery, SpreadsheetFeed.class); （4） |
7 | SpreadsheetEntry spreadsheetentry = spreadsheetfeed.getEntries().get(0); （5） |
（1）では、Spreadsheetsサーバで使用される フィードURLのデフォルトインスタンスを生成します。
フィード（Feed）には幾つかの意味がありますが、ここでは、Webサイトから受信可能なデータと考えれば良いでしょう。
（2）feedurlfactory.getSpreadsheetsFeedUrl() では認証によってアクセス可能なすべてのSpreadsheetに対するフィードを受け取ることができるURLを取得し、SpreadsheetQueryでは取得したフィードURLを引数にして、Spreadsheetを検索するためのqueryを生成します。
（3）生成されたqueryにスプレッドシート名（sheet）を引数にしたフルテキスト検索を構成します。
ここで注意が必要なのは、Drive上には同じ名前のSpreadsheetファイルを複数配置することができるということです。また、同じ名前のspreadsheetはDrive上のフォルダが同じでも違っていても、すべて（3）のフル検索の対象になります。
例えば、図10にはSalesフォルダ内にファイル名201304のシートが1つあり、図11にはtestフォルダ内に同じ201304のシートが2つありますが、これらはすべて検索の対象になります。
図10：Salesフォルダ内の201304シート（クリックで拡大）
図11：Testフォルダ内の201304シート（クリックで拡大）
（4）では（3）で生成したspreadsheetqueryを引数にクエリを実行し、クエリ内容に一致するエントリを含んだフィードを取得します。
（5）spreadsheetfeed.getEntries() でフィード内のスプレッドシートエントリのリストを返しますが、上で見たように同じ名前のスプレッドシートを複数作成することもできるので、get(0) で１つのスプレッドシートを特定します。ただここで、複数の同じ名前のシートの内、どのシートがget(0)で選択されるのかが問題ですが、図10、図11の右端に表示されているLAST MODIFIED(最終更新日)が最も新しいシートが選択されます。つまりgetメソッドの引数は更新日の新しい方から、0,1,2…となっている訳です。
ただし、更新の度に選択されるシートが変わってしまうのでは正確な処理を行うことはできません。したがって、Drive上でのスプレッドシート名はすべて一意（unique）にしておくべきです。
[III] 検索対象のワークシートを特定する
1 | WorksheetEntry worksheetentry = spreadsheetentry.getDefaultWorksheet(); （1） |
ここまでの処理で、検索対象は1枚のスプレッドシートに特定されましたが、最後にワークシートの特定を行います。
図12：スプレッドシート内のワークシート（クリックで拡大）
Excelでは１つのシートファイルに、タブ設定によって複数の入力シートを保持できますが、Drive上のSpreadsheet でも同様に複数のワークシートを保持することができます。したがって、複数ワークシートから１つを特定することが必要になってきますが、これを行っているのが（1）です。getDefaultWorksheet() は複数のワークシートから一番上に表示されているシート（図12のSheet1）を選択して返します。
[IV] クエリでワークシートデータの検索
ここまでで、複数のSpreadsheetから、幾つかの処理を経て検索対象のワークシートを特定する処理を見てきましたが、これでようやくワークシートデータの検索ができるようになります。
1 | ListQuery listQuery = new ListQuery(worksheetentry.getListFeedUrl()); （1） |
2 | ListFeed listFeed = spreadsheetservice.query(listQuery, ListFeed.class); （2） |
3 | List<ListEntry> dataList = listFeed.getEntries(); （3） |
（1）worksheetentry.getListFeedUrl() でワークシートのリストフィードのURLを取得し、それを引数にした ListQuery の生成でワークシートに対する行ベースのクエリを構成します。
（2）ターゲットサービスへのクエリを実行し、クエリ結果に一致するリストフィード（listFeed）を返します。
（3）リストフィード内のエントリを行単位のリストで返します。
[V] ワークシートデータをJSONフォーマットで返す
1 | String rv = "{ \"wsdat\":["; |
2 | for (Iterator<ListEntry> it = dataList.iterator(); it.hasNext();) { |
3 | ListEntry listEntry = (ListEntry) it.next(); |
4 | rv += "{\"cdat\": \"" + listEntry.getPlainTextContent() + "\"},"; |
6 | rv = rv.substring(0, rv.length() - 1) + "]}"; |
最後に、行単位のワークシートデータをJSONフォーマットに組み立てでクライアントに送りますが、この部分は一般的な繰り返し（iterate）処理ですので、問題ないでしょう。
