Interface StepLogger

All Known Implementing Classes:
JsonStepLogger, ObjectStepLogger

public interface StepLogger
Author:
Petr Dvorak, petr@wultra.com
  • Method Summary

    Modifier and Type Method Description
    void close()
    Closes the logger output, writes code to close the array and opened object
    void start()
    Start the object streaming, outputs start of the result object:
    void writeDoneFailed​(java.lang.String id)
    Write information about incorrectly finished execution.
    void writeDoneOK​(java.lang.String id)
    Write information about successfully finished execution.
    void writeError​(java.lang.String id, java.lang.Exception exception)
    Write error with given exception information.
    void writeError​(java.lang.String id, java.lang.String errorMessage)
    Write error with given error message.
    void writeError​(java.lang.String id, java.lang.String name, java.lang.String errorMessage)
    Write error with given error name and error message, that is used as a description.
    void writeError​(java.lang.String id, java.lang.String name, java.lang.String errorMessage, java.lang.Exception exception)
    Write error with given error name and error message, that is used as a description.
    void writeItem​(java.lang.String id, java.lang.String name, java.lang.String description, java.lang.String status, java.lang.Object object)
    Writes an object representing the step of the execution.
    void writeServerCall​(java.lang.String id, java.lang.String uri, java.lang.String method, java.lang.Object requestObject, java.util.Map<java.lang.String,​?> headers)
    Write the information about the server call.
    void writeServerCallConnectionError​(java.lang.String id, java.lang.Exception e)
    Write error in case of a network issues.
    void writeServerCallError​(java.lang.String id, int statusCode, java.lang.Object responseObject, java.util.Map<java.lang.String,​?> headers)
    Write information about the failed server request.
    void writeServerCallOK​(java.lang.String id, java.lang.Object responseObject, java.util.Map<java.lang.String,​?> headers)
    Write information about the successful server request.
  • Method Details

    • start

      void start()
      Start the object streaming, outputs start of the result object:
    • writeItem

      void writeItem​(java.lang.String id, java.lang.String name, java.lang.String description, java.lang.String status, java.lang.Object object)
      Writes an object representing the step of the execution.
      Parameters:
      id - Step ID.
      name - Step name.
      description - Step detailed description.
      status - Step status result.
      object - Custom object associated with the step.
    • writeServerCall

      void writeServerCall​(java.lang.String id, java.lang.String uri, java.lang.String method, java.lang.Object requestObject, java.util.Map<java.lang.String,​?> headers)
      Write the information about the server call. Uses "writeItem" method under the hood.
      Parameters:
      id - Step ID.
      uri - URI that will be called.
      method - HTTP method of the call.
      requestObject - Request object, in case of the POST, PUT, DELETE method.
      headers - HTTP request headers.
    • writeServerCallOK

      void writeServerCallOK​(java.lang.String id, java.lang.Object responseObject, java.util.Map<java.lang.String,​?> headers)
      Write information about the successful server request. Uses "writeItem" method under the hood.
      Parameters:
      id - Step ID.
      responseObject - HTTP response object.
      headers - HTTP response headers.
    • writeServerCallError

      void writeServerCallError​(java.lang.String id, int statusCode, java.lang.Object responseObject, java.util.Map<java.lang.String,​?> headers)
      Write information about the failed server request. Uses "writeItem" method under the hood.
      Parameters:
      id - Step ID.
      statusCode - HTTP response status code.
      responseObject - HTTP response object.
      headers - HTTP response headers.
    • close

      void close()
      Closes the logger output, writes code to close the array and opened object
    • writeServerCallConnectionError

      void writeServerCallConnectionError​(java.lang.String id, java.lang.Exception e)
      Write error in case of a network issues.
      Parameters:
      id - Step ID.
      e - Network exception.
    • writeError

      void writeError​(java.lang.String id, java.lang.String errorMessage)
      Write error with given error message. Error message is mapped as a step description.
      Parameters:
      id - Step ID.
      errorMessage - Error message.
    • writeError

      void writeError​(java.lang.String id, java.lang.Exception exception)
      Write error with given exception information. Exception description is mapped as a step description, exception is passed as a custom object.
      Parameters:
      id - Step ID.
      exception - Exception that should be logged.
    • writeError

      void writeError​(java.lang.String id, java.lang.String name, java.lang.String errorMessage)
      Write error with given error name and error message, that is used as a description.
      Parameters:
      id - Step ID.
      name - Error name.
      errorMessage - Error message.
    • writeError

      void writeError​(java.lang.String id, java.lang.String name, java.lang.String errorMessage, java.lang.Exception exception)
      Write error with given error name and error message, that is used as a description.
      Parameters:
      id - Step ID.
      name - Error name.
      errorMessage - Error message.
      exception - Exception that caused the error.
    • writeDoneOK

      void writeDoneOK​(java.lang.String id)
      Write information about successfully finished execution.
      Parameters:
      id - Step ID.
    • writeDoneFailed

      void writeDoneFailed​(java.lang.String id)
      Write information about incorrectly finished execution.
      Parameters:
      id - Step ID.