com.amazon.speech.speechlet

Class SpeechletRequestHandler

java.lang.Object

com.amazon.speech.speechlet.SpeechletRequestHandler

Direct Known Subclasses:

LambdaSpeechletRequestHandler, ServletSpeechletRequestHandler

public class SpeechletRequestHandler
extends Object

The SpeechletRequestHandler processes an incoming request from the Alexa service, decides what action to take on the configured SpeechletV2, executes that call, and returns the resulting response bytes. This class can be hosted by a servlet (for instance, for a web server) or by AWS Lambda. In either case, the logic is the same with different surrounding logic to handle the generated output bytes.

Constructor Summary

Constructors

Constructor and Description
SpeechletRequestHandler(List<SpeechletRequestEnvelopeVerifier> requestEnvelopeVerifiers)
SpeechletRequestHandler(List<SpeechletRequestVerifier> requestVerifiers, List<SpeechletResponseVerifier> responseVerifiers) Deprecated.

Method Summary

Modifier and Type	Method and Description
byte[]	handleSpeechletCall(Speechlet speechlet, byte[] serializedSpeechletRequest) Deprecated. Please use handleSpeechletCall(SpeechletV2, byte[]) instead.
byte[]	handleSpeechletCall(SpeechletV2 speechlet, byte[] serializedSpeechletRequest) Processes the provided bytes as a request from the Alexa service and generates an appropriate response after dispatching the request to the appropriate method calls on the SpeechletV2 provided at construction time.

Methods inherited from class java.lang.Object

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

Constructor Detail

SpeechletRequestHandler

@Deprecated
public SpeechletRequestHandler(List<SpeechletRequestVerifier> requestVerifiers,
                                           List<SpeechletResponseVerifier> responseVerifiers)

Deprecated.

SpeechletRequestHandler

public SpeechletRequestHandler(List<SpeechletRequestEnvelopeVerifier> requestEnvelopeVerifiers)

Method Detail

handleSpeechletCall

@Deprecated
public byte[] handleSpeechletCall(Speechlet speechlet,
                                              byte[] serializedSpeechletRequest)
                                       throws IOException,
                                              SpeechletRequestHandlerException,
                                              SpeechletException

Deprecated. Please use handleSpeechletCall(SpeechletV2, byte[]) instead.

Processes the provided bytes as a request from the Alexa service and generates an appropriate response after dispatching the request to the appropriate method calls on the Speechlet provided at construction time.

Parameters:

speechlet - the speechlet to be invoked

serializedSpeechletRequest - the request coming from Alexa service

Returns:

the response that should be returned to the Alexa service. This comes from the appropriate method call in the configured SpeechletV2

Throws:

IOException - may occur during request or response serialization

SpeechletRequestHandlerException - indicates a problem with the request or response

SpeechletException - indicates a problem from within the included SpeechletV2

handleSpeechletCall

public byte[] handleSpeechletCall(SpeechletV2 speechlet,
                                  byte[] serializedSpeechletRequest)
                           throws IOException,
                                  SpeechletRequestHandlerException,
                                  SpeechletException

Processes the provided bytes as a request from the Alexa service and generates an appropriate response after dispatching the request to the appropriate method calls on the SpeechletV2 provided at construction time.

Parameters:

speechlet - the speechlet to be invoked

serializedSpeechletRequest - the request coming from Alexa service

Returns:

the response that should be returned to the Alexa service. This comes from the appropriate method call in the configured SpeechletV2

Throws:

IOException - may occur during request or response serialization

SpeechletRequestHandlerException - indicates a problem with the request or response

SpeechletException - indicates a problem from within the included SpeechletV2