com.amazonaws.serverless.proxy.InitializationWrapper Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of aws-serverless-java-container-core Show documentation

Allows Java applications written for a servlet container to run in AWS Lambda

There is a newer version: 2.0.3

Show newest version

package com.amazonaws.serverless.proxy;

import com.amazonaws.serverless.exceptions.ContainerInitializationException;
import com.amazonaws.serverless.proxy.internal.LambdaContainerHandler;

import java.util.concurrent.CountDownLatch;

/**
 * This class is in charge of initializing a {@link LambdaContainerHandler}.
 * In most cases, this means calling the {@link LambdaContainerHandler#initialize()} method. Some implementations may
 * require additional initialization steps, in this case implementations should provide their own
 * InitializationWrapper. This library includes an async implementation of this class
 * {@link AsyncInitializationWrapper} for frameworks that are likely to take longer than 10 seconds to start.
 */
public class InitializationWrapper {
    /**
     * This is the main entry point. Container handler builder and the static getAwsProxyHandler() methods
     * of the various implementations will call this to initialize the underlying framework
     * @param handler The container handler to be initializer
     * @throws ContainerInitializationException If anything goes wrong during container initialization.
     */
    public void start(LambdaContainerHandler handler) throws ContainerInitializationException {
        handler.initialize();
    }

    /**
     * Asynchronous implementations of the framework should return a latch that the container handler can use to decide
     * whether it can start handling events. Synchronous implementations of this interface should return null.
     * @return An initialized latch if the underlying container is starting in a separate thread, null otherwise.
     */
    public CountDownLatch getInitializationLatch() {
        return null;
    }
}