AWS LambdaがJava対応したので簡単チュートリアル

既報(【AWS発表】AWS Lambdaのアップデート、イベントに応じてJavaコードを実行)の通り、AWS Lambdaで利用可能な言語としてこれまでのNode.jsに加えてJavaが追加となりました。オフィシャルブログではそんなにコードのサンプルもなかったのでこちらでもう少し補足してみようかと思います。
ちなみに今回の私の作業環境はMac OSX YosemiteでIDEはEclipseベースのSTS（Spring Tool Suite）を利用しています。あと、mavenは導入済みの前提です。

Lambdaファンクションを書く

まず、LambdaをJavaで書く用に2つのライブラリ、aws-lambda-java-coreとaws-lambda-java-eventsが新たに提供されたのでこれを使えるようにしてください。後者は不要であればなくてもいいです。今回は使いません。以下はmavenの例です。

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-lambda-java-core</artifactId>
    <version>1.0.0</version>
</dependency>

まずは、シンプルに渡された数値を出力するだけのコードを用意してみます。

package com.sample.lambda;

import com.amazonaws.services.lambda.runtime.Context; 
import com.amazonaws.services.lambda.runtime.LambdaLogger;

public class App {
    public String handler(int count, Context context){
        LambdaLogger lambdaLogger = context.getLogger();
        lambdaLogger.log("count = " + count);
        return String.valueOf(count);
    }
}

この例の場合、inputとして受け取る値はintの値です。あとはLambdaのloggerをContextから取得して受け取った値を単にログ出力しています。
ちなみにここではStringに変換した値をreturnしていますが、InvocationTypeがRequestResponseの場合のみこの値が呼び出し元に返されます。Eventの場合はどこにも使われません。InvocationTypeとはLambdaファンクションの呼び出し方のことでRequestResponseだと同期的に、Eventだと非同期で処理されます。

パッケージング

ではこいつを早速Lambdaファンクション用にパッケージングしますがSTSとかEclipse使ってMavenプロジェクトとして作成していれば大した手間はありません。一応言及しておくと以下のような一般的なディレクトリ構成にします。

<プロジェクトディレクトリ>/pom.xml           
<プロジェクトディレクトリ>/src/main/java

この<プロジェクトディレクトリ>/src/main/java以下に先ほど作成したjavaファイルを保存します。もちろんJavaのお作法で保存するのでパッケージ名に対応したディレクトリ構成にしてください。今回の場合だと<プロジェクトディレクトリ>/src/main/java/com/sample/lambda/App.javaになります。

pom.xmlの中身は以下のような感じになります。以下の例ではAWS SDK for Javaも入れてますが不要だったら外してください。あとは前述したLambda用のライブラリです。今回はaws-lambda-java-coreのみにしています。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.sample.lambda</groupId>
  <artifactId>com.sample.lambda</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>
  <name>lambda-java</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-lambda-java-core</artifactId>
      <version>1.0.0</version>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>2.3</version>
        <configuration>
          <createDependencyReducedPom>false</createDependencyReducedPom>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>shade</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

ここまで用意できたらターミナル等でプロジェクトディレクトリに移動して、以下のコマンドを実行します。

mvn package

コマンドじゃなくてEclipse等のIDE上から実行しても構いません。
そうすると<プロジェクトディレクトリ>/target/というディレクトリができてその他のファイルとともにcom.sample.lambda-0.0.1-SNAPSHOT.jarといった名前のjarファイルができているかと思います。

Lambdaファンクションの作成

基本的には今までと変わらないのですがランタイム（Runtime）として"Java8"を指定する必要があります。

これまでとの違いですが、Java 8を選択するとインラインエディタは利用できなくなります。つまり、書いたコードは必ずコンパイルした上でZIPもしくはJARファイルにしてLambdaもしくはS3にアップロードをする必要があります。
ではここで先ほど作成したjarファイルを指定してアップロードしてしまってください。

続いてHandlerを指定します。Handlerの指定はパッケージ.クラス名::メソッドと指定します。今回の場合はcom.sample.lambdaというパッケージのAppというクラスにあるhandlerというメソッドなのでcom.sample.lambda.App::handlerとなります。

ちなみに、Javaの場合はデフォルトのメモリサイズおよびタイムアウトがそれぞれ512MBと15秒となっています（Node.JSの場合は128MB、3秒のまま）。
あと、今回の発表のタイミングで指定可能なメモリサイズの上限が1.5GBまで増えました！

テスト

これでLambdaファンクションが作成されたので早速テスト実行してみましょう。マネージメントコンソール上のダッシュボードから作成したファンクションを選択して、"Actions"というプルダウンから"Edit/Test"を選択します。

次の画面のSample Eventのエリアに適当な値を入れます。Hello Worldを選択した上で中身を消して好きな値を入れるのがいいと思います。通常はJSONなんですが今回のApp.handlerはパラメータとしてintの値を受け取っているのでそれだけをベタ書きします。

そして"Invoke"をクリックするとLambdaファンクションが実行されます。
画面下部のExecution Resultのエリアに以下のようにメソッドでreturnした結果が表示されているかと思います。

まとめ

とりあえずこんな感じでJavaで書いたコードをLambdaで実行することができるようになったことがわかります。次はもう少し実践的な内容としてS3のイベントを受け取って処理するパターンとパラメータをJSONで渡すパターンをやってみたいと思います。