Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
lib
.gitignore
LICENSE
README.md
version.txt

README.md

Serverless-Annotations

This project aims to do one thing - make the SLS framework (www.serverless.com) easier to use in the Java world.

Bottom line

Annotated your classes, as seen below, specify some params in gradle, bada boom - you get a serverless.yml file out.

package org.densebrain.serverless.examples.simple
import com.amazonaws.services.lambda.runtime.*;
import org.densebrain.serverless.annotations.*
import org.densebrain.serverless.annotations.Function


data class TestRequestModel(val id:String)
data class TestResponseModel(val id:String)

@Function(
  name = "TestLambda",
  environment = [
    Environment(
      name = "REF_VAR",
      yaml = """"Fn::GetAtt": [SessionUpdateLambdaFunction, Arn]"""
    )
  ],
  http = [
    HttpEvent(
      path = "/test/{hello}",
      method = HttpEventMethod.GET,
      input = TestRequestModel::class,
      output = TestResponseModel::class,
      request = Request(
        paths = [Parameter("hello",true)],
        querystrings = [Parameter("since",false)]
      )
    )
  ],

  schedule = [
    ScheduleEvent("rate(3 minutes)")
  ],

  cloudwatch = [
    CloudwatchEvent("""
      event:
        source:
          - "aws.batch"
        detail:
          jobName:
            - "$""" + """{self:custom.customVar}"
    """)
  ]
)
class TestLambda : RequestHandler<TestRequestModel, TestResponseModel> {
  override fun handleRequest(input: TestRequestModel, context: Context): TestResponseModel {
    return TestResponseModel(input.id)
  }
}

Gradle Configuration

task serverlessBuild(type: ServerlessBuilderTask) {
  
  // WE SUGGEST USING SHADOW TO BUILD 
  // A SINGLE ARCHIVE TO MAKE SCANNING EASIER
  dependsOn(shadowJar)
  
  // PATH TO ARCHIVE OF CLASSES
  archive = file("${buildDir.absolutePath}/libs/${shadowJar.archiveName}")
  
  // (OPTIONAL) Bring your own serverless.yml template
  // If you specify a template then functions will be appended to 
  // your functions block
  serverlessConfigFile = serverlessBaseFile
  
  // OUTPUT PATH FOR serverless.yml
  outputFile = file("${projectDir.absolutePath}/serverless.yml")
  
  // BASE PACKAGE TO SCAN FOR ANNOTATED TYPES
  basePackage = "your.package.here"
  
  // GENERATE MODELS/DOCUMENTATION FOR SWAGGER, etc
  generateDocumentation = true
  
  // (OPTIONAL) If omitted then the documentation block is appended
  // to any existing "custom" block in the serverless.yml
  documentationOutputFile = file("${projectDir.absolutePath}/documentation.yml")
}

build.dependsOn(serverlessBuild)
You can’t perform that action at this time.