Module io.helidon.reactive.media.common
Package io.helidon.reactive.media.common

Class MessageBodyReaderContext

java.lang.Object
io.helidon.reactive.media.common.MessageBodyContext
io.helidon.reactive.media.common.MessageBodyReaderContext
All Implemented Interfaces:
MessageBodyFilters, MessageBodyReaders
public final class MessageBodyReaderContext extends MessageBodyContext implements MessageBodyReaders, MessageBodyFilters
Reader message body context.
See Also:

  • Method Details

    • create

      public static MessageBodyReaderContext create()
      Create a new empty reader context backed by empty read-only headers. Such reader context is typically the parent context that is used to hold application wide readers and inbound filters.
      Returns:
      MessageBodyWriterContext

    • registerReader

      public MessageBodyReaderContext registerReader(MessageBodyReader<?> reader)
      Description copied from interface: MessageBodyReaders
      Register a reader.
      Specified by:
      registerReader in interface MessageBodyReaders
      Parameters:
      reader - reader to register
      Returns:
      Readers

    • registerReader

      public MessageBodyReaderContext registerReader(MessageBodyStreamReader<?> reader)
      Description copied from interface: MessageBodyReaders
      Register a stream reader.
      Specified by:
      registerReader in interface MessageBodyReaders
      Parameters:
      reader - reader to register
      Returns:
      Readers

    • unmarshall

      public <T> Single<T> unmarshall(Flow.Publisher<DataChunk> payload, GenericType<T> type)
      Convert a given HTTP payload into a publisher by selecting a reader that accepts the specified type and current context.
      Type Parameters:
      T - entity type
      Parameters:
      payload - inbound payload
      type - actual representation of the entity type
      Returns:
      publisher, never null

    • unmarshall

      public <T> Single<T> unmarshall(Flow.Publisher<DataChunk> payload, MessageBodyReader<T> reader, GenericType<T> type)
      Convert a given HTTP payload into a publisher by selecting a reader with the specified class.
      Type Parameters:
      T - entity type
      Parameters:
      payload - inbound payload
      reader - specific reader
      type - actual representation of the entity type
      Returns:
      publisher, never null

    • unmarshallStream

      public <T> Flow.Publisher<T> unmarshallStream(Flow.Publisher<DataChunk> payload, GenericType<T> type)
      Convert a given HTTP payload into a publisher by selecting a stream reader that accepts the specified type and current context.
      Type Parameters:
      T - entity type
      Parameters:
      payload - inbound payload
      type - actual representation of the entity type
      Returns:
      publisher, never null

    • unmarshallStream

      public <T> Flow.Publisher<T> unmarshallStream(Flow.Publisher<DataChunk> payload, MessageBodyStreamReader<T> reader, GenericType<T> type)
      Convert a given HTTP payload into a publisher by selecting a stream reader with the payload class.
      Type Parameters:
      T - entity type
      Parameters:
      payload - inbound payload
      reader - specific reader
      type - actual representation of the entity type
      Returns:
      publisher, never null

    • headers

      public Headers headers()
      Get the underlying headers.
      Returns:
      Parameters, never null

    • contentType

      public Optional<HttpMediaType> contentType()
      Get the Content-Type header.
      Returns:
      Optional, never null

    • charset

      public Charset charset() throws IllegalStateException
      Description copied from class: MessageBodyContext
      Derive the charset to use from the Content-Type header value or using a default charset as fallback.
      Specified by:
      charset in class MessageBodyContext
      Returns:
      Charset, never null
      Throws:
      IllegalStateException - if an error occurs loading the charset specified by the Content-Type header value

    • create

      public static MessageBodyReaderContext create(MessageBodyReaderContext parent)
      Creates a new parented reader context.
      Parameters:
      parent - parent reader context
      Returns:
      new instance of MessageBodyReaderContext

    • create

      public static MessageBodyReaderContext create(MediaContext mediaContext, MessageBodyContext.EventListener eventListener, Headers headers, Optional<HttpMediaType> contentType)
      Create a new empty reader context backed by the specified headers.
      Parameters:
      mediaContext - mediaSupport instance used to derived the parent context, may be null
      eventListener - subscription event listener, may be null
      headers - backing headers, must not be null
      contentType - content type, must not be null
      Returns:
      MessageBodyReaderContext

    • create

      public static MessageBodyReaderContext create(MessageBodyReaderContext parent, MessageBodyContext.EventListener eventListener, Headers headers, Optional<HttpMediaType> contentType)
      Create a new empty reader context backed by the specified headers.
      Parameters:
      parent - parent context, must not be null
      eventListener - subscription event listener, may be null
      headers - backing headers, must not be null
      contentType - content type, must not be null
      Returns:
      MessageBodyReaderContext