はじめに

SpringプロジェクトにはServerless用のフレームワークとしてSpring Cloud Functionというものがあります。

Webアプリで使い慣れたSpring Bootと同じ考えをAWS LambdaやAzure Functionsなどに適用できることから、魅力的に映る人もいるかなと思います。ここから数回はSpring Cloud Functionを使ってAWS Lambda上で関数を動かすことをやってみます。

プロジェクトの作成

まずはgradle initでGradleプロジェクトを作り、以下のようなbuild.gradleを作ります。

plugins {
    id 'java'
    // dependencyManagement用
    id 'io.spring.dependency-management' version '1.1.5'
    // bootRunのため。
    id 'org.springframework.boot' version '3.2.4'
}

group = 'com.github.miyohide'
version = '1.0'

repositories {
    mavenCentral()
}

ext {
    set('springCloudVersion', "2023.0.1")
}

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
    }
}

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-starter-function-web'
    implementation 'org.springframework.cloud:spring-cloud-function-adapter-aws'
    testImplementation platform('org.junit:junit-bom:5.10.0')
    testImplementation 'org.junit.jupiter:junit-jupiter'
}

test {
    useJUnitPlatform()
}

依存関係をまとめるSpring Cloudのバージョンを変数springCloudVersionで設定して、dependencyManagementで設定。dependenciesにて指定するものとしてorg.springframework.cloud:spring-cloud-starter-function-webとorg.springframework.cloud:spring-cloud-function-adapter-awsを指定しておきます。

アプリの実装

アプリは以下のような感じで実装します。

package com.github.miyohide;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

import java.util.function.Function;

@SpringBootApplication
public class App {
  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }

  @Bean
  public Function<String, String> reverseString() {
    return value -> new StringBuilder(value).reverse().toString();
  }
}

これだけで./gradlew bootRunでアプリを起動し、別のシェルでcurl localhost:8080/reverseString -H "Content-Type: text/plain" -d "abc"を実行するとcbaが返ります。メソッド名をURLに付与し、-d "abc"で与えた文字列が逆転した結果cbaが返ります。

ちょっと発展

別のクラスに処理を実装してみます。

package com.github.miyohide.functions;

import java.util.function.Function;

public class Greeter implements Function<String, String> {

  @Override
  public String apply(String s) {
    return "Hello " + s;
  }
}

@Componentを付与しなくても、application.propertiesに以下の記述を追加することでapplyメソッドが関数として登録されます。

spring.cloud.function.scan.packages=com.github.miyohide.functions

公式ドキュメントとしては以下のものです。

docs.spring.io

実際試してみます。別のシェルでcurl localhost:8080/greeting -H "Content-Type: text/plain" -d "abc"にアクセスすると、Hello abcが返ります。

考察

とりあえずSpring Cloud Functionを使ってアプリを作ってみました。Springに関する前提知識が多分に求められていますが、すでにSpringに慣れ親しんでいる場合はSpring Cloud Functionを使ってみるのも良いかなと思います。

ちょっと調べた感じ、最小限必要な記述を解説したものはなかったので、build.gradleなどの設定ファイルをつくるのはちょっと苦労しました。何が必要で何が不要なのかがちょっと分かりにくいです。

miyohide's blog

AWS LambdaとSpringの融合：Spring Cloud Functionの活用

はじめに

プロジェクトの作成

アプリの実装

ちょっと発展

考察