Package org.jboss.as.controller.client

Interface OperationResponse

All Superinterfaces:
AutoCloseable, Closeable
All Known Implementing Classes:
OperationResponseProxy
public interface OperationResponse extends Closeable
A response to a management request, incorporating a ModelNode containing the detyped response, along with zero or more input streams that may have been associated with the response.

Streams must be consumed promptly once a response is obtained. To prevent resource leaks, the server side will close its side of the stream approximately 30 seconds after the latter of its transmittal of the OperationResponse or any remote read of one of its associated streams.

Author:
Brian Stansberry (c) 2014 Red Hat Inc.

  • Method Details

    • getResponseNode

      ModelNode getResponseNode()
      Gets the DMR response to the operation.
      Returns:
      the response. Will not be null

    • getInputStreams

      List<OperationResponse.StreamEntry> getInputStreams()
      Gets any streams that were associated with the operation response. Streams will be in the order in which they were attached, but callers should exercise caution when making assumptions about that order if the operation executes across multiple servers in a managed domain. Aspects of domain execution often occur concurrently so streams may not be associated with the response in the order in which steps are listed in a multistep operation.

      Returns:
      the streams. Will not be null but may be empty

    • getInputStream

      OperationResponse.StreamEntry getInputStream(String uuid)
      Gets a stream associated with the response that has the given uuid.

      Server side operation step handlers that associate a stream with a response should provide the stream's uuid as the step's result value in the DMR response.

      Parameters:
      uuid - the uuid. Cannot be null
      Returns:
      the stream entry, or null if no entry with the given uuid is associated

    • close

      void close() throws IOException
      Closes any associated stream entries.
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Throws:
      IOException