Interface AwsServiceClient

  • All Known Implementing Classes:
    AwsServiceClientImpl

    public interface AwsServiceClient
    The AWS service client.
    • Method Summary

      Modifier and Type Method Description
      void execute​(AwsRequest request)
      Executes the AWS request.
      <ResultT> ResultT execute​(AwsRequest request, Class<ResultT> resultClass)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      <ResultT> ResultT execute​(AwsRequest request, Class<ResultT> resultClass, CodecRegistry codecRegistry)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      void execute​(AwsRequest request, Long requestTimeout)
      Executes the AWS request.
      <ResultT> ResultT execute​(AwsRequest request, Long requestTimeout, Class<ResultT> resultClass)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      <ResultT> ResultT execute​(AwsRequest request, Long requestTimeout, Class<ResultT> resultClass, CodecRegistry codecRegistry)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      <ResultT> ResultT execute​(AwsRequest request, Long requestTimeout, Decoder<ResultT> resultDecoder)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      <ResultT> ResultT execute​(AwsRequest request, Decoder<ResultT> resultDecoder)
      Executes the AWS request, and decodes the result into an instance of the specified type.
      CodecRegistry getCodecRegistry()
      Get the codec registry that will be used to decode responses when a codec registry.
      AwsServiceClient withCodecRegistry​(CodecRegistry codecRegistry)
      Create a new AwsServiceClient instance with a different codec registry.
    • Method Detail

      • execute

        void execute​(@Nonnull
                     AwsRequest request)
        Executes the AWS request.
        Parameters:
        request - the AWS request to execute.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Decoder<ResultT> resultDecoder)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry specified when the app client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        resultDecoder - the Decoder to use to decode the result into a value.
        Returns:
        the decoded result value.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Class<ResultT> resultClass)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry specified when the app client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        resultClass - the class that the result should be decoded as.
        Returns:
        the decoded result value.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Class<ResultT> resultClass,
                                  @Nonnull
                                  CodecRegistry codecRegistry)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry given.
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        resultClass - the class that the result should be decoded as.
        codecRegistry - the codec registry used for de/serialization of the function call.
        Returns:
        the decoded result value.
      • execute

        void execute​(@Nonnull
                     AwsRequest request,
                     @Nonnull
                     Long requestTimeout)
        Executes the AWS request.
        Parameters:
        request - the AWS request to execute.
        requestTimeout - the number of milliseconds the client should wait for a response from the server before failing with an error.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Long requestTimeout,
                                  @Nonnull
                                  Decoder<ResultT> resultDecoder)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry specified when the app client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        requestTimeout - the number of milliseconds the client should wait for a response from the server before failing with an error.
        resultDecoder - the Decoder to use to decode the result into a value.
        Returns:
        the decoded result value.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Long requestTimeout,
                                  @Nonnull
                                  Class<ResultT> resultClass)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry specified when the app client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        requestTimeout - the number of milliseconds the client should wait for a response from the server before failing with an error.
        resultClass - the class that the result should be decoded as.
        Returns:
        the decoded result value.
      • execute

        <ResultT> ResultT execute​(@Nonnull
                                  AwsRequest request,
                                  @Nonnull
                                  Long requestTimeout,
                                  @Nonnull
                                  Class<ResultT> resultClass,
                                  @Nonnull
                                  CodecRegistry codecRegistry)
        Executes the AWS request, and decodes the result into an instance of the specified type. The response will be decoded using the codec registry given.
        Type Parameters:
        ResultT - the type into which the response will be decoded.
        Parameters:
        request - the AWS request to execute.
        requestTimeout - the number of milliseconds the client should wait for a response from the server before failing with an error.
        resultClass - the class that the result should be decoded as.
        codecRegistry - the codec registry used for de/serialization of the function call.
        Returns:
        the decoded result value.
      • getCodecRegistry

        CodecRegistry getCodecRegistry()
        Get the codec registry that will be used to decode responses when a codec registry.
        Returns:
        the CodecRegistry
      • withCodecRegistry

        AwsServiceClient withCodecRegistry​(@Nonnull
                                           CodecRegistry codecRegistry)
        Create a new AwsServiceClient instance with a different codec registry.
        Parameters:
        codecRegistry - the new CodecRegistry for the client.
        Returns:
        a new AwsServiceClient instance with the different codec registry