com.amazon.speech.speechlet.lambda

Class SpeechletRequestStreamHandler

java.lang.Object

com.amazon.speech.speechlet.lambda.SpeechletRequestStreamHandler

All Implemented Interfaces:

com.amazonaws.services.lambda.runtime.RequestStreamHandler

public abstract class SpeechletRequestStreamHandler
extends Object
implements com.amazonaws.services.lambda.runtime.RequestStreamHandler

This class provides the handler required when hosting the service as an AWS Lambda function.

Lambda functions written in Java must have a RequestStreamHandler class for the handler. That handler must include a zero argument constructor and implement RequestStreamHandler.

The SpeechletRequestStreamHandler abstract class can be used to create such a class. Extend SpeechletRequestStreamHandler and implement a new zero-argument constructor. Pass the appropriate SpeechletV2 and Set of supported ApplicationIds to the super constructor from your new constructor.

When configuring your Lambda function in the AWS Lambda console, specify your new class as the Handler.

Constructor Summary

Constructors

Constructor and Description
SpeechletRequestStreamHandler(Speechlet speechlet, Set<String> supportedApplicationIds)
SpeechletRequestStreamHandler(SpeechletV2 speechlet, Set<String> supportedApplicationIds) When extending this class, use a zero argument constructor and pass the appropriate SpeechletV2 and Set of supported ApplicationIds to this method.

Method Summary

Modifier and Type	Method and Description
void	handleRequest(InputStream input, OutputStream output, com.amazonaws.services.lambda.runtime.Context context) This method is the primary entry point when executing your Lambda function.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpeechletRequestStreamHandler

public SpeechletRequestStreamHandler(SpeechletV2 speechlet,
                                     Set<String> supportedApplicationIds)

When extending this class, use a zero argument constructor and pass the appropriate SpeechletV2 and Set of supported ApplicationIds to this method.

Parameters:

speechlet - the SpeechletV2 that handles the requests

supportedApplicationIds - a Set of supported ApplicationIds used to validate that the requests are intended for your service

SpeechletRequestStreamHandler

public SpeechletRequestStreamHandler(Speechlet speechlet,
                                     Set<String> supportedApplicationIds)

Method Detail

handleRequest

public final void handleRequest(InputStream input,
                                OutputStream output,
                                com.amazonaws.services.lambda.runtime.Context context)
                         throws IOException

This method is the primary entry point when executing your Lambda function. The configured SpeechletRequestHandler determines the type of request and dispatches the request to the configured SpeechletV2.

Any errors that occur in either the SpeechletV2 or the SpeechletRequestHandler are converted into a RuntimeException, causing the Lambda call to fail. Details on the failure are then available in the Lambda console logs within CloudWatch.

Specified by:

handleRequest in interface com.amazonaws.services.lambda.runtime.RequestStreamHandler

Throws:

IOException