AbstractServerHttpResponse (spring-web 5.0.0.M4 API)

java.lang.Object
- org.springframework.http.server.reactive.AbstractServerHttpResponse

All Implemented Interfaces:

HttpMessage, ReactiveHttpOutputMessage, ServerHttpResponse

Direct Known Subclasses:

AbstractListenerServerHttpResponse, ReactorServerHttpResponse, RxNettyServerHttpResponse
```
public abstract class AbstractServerHttpResponse
extends Object
implements ServerHttpResponse
```
Base class for ServerHttpResponse implementations.

Since:

5.0

Author:

Rossen Stoyanchev, Sebastien Deleuze

Constructor Summary

Constructors
Constructor and Description

AbstractServerHttpResponse(org.springframework.core.io.buffer.DataBufferFactory dataBufferFactory)

Constructors
Constructor and Description
`AbstractServerHttpResponse(org.springframework.core.io.buffer.DataBufferFactory dataBufferFactory)`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected abstract void`	`applyCookies()` Implement this method to add cookies from `getHeaders()` to the underlying response.
`protected abstract void`	`applyHeaders()` Implement this method to apply header changes from `getHeaders()` to the underlying response.
`protected abstract void`	`applyStatusCode()` Implement this method to write the status code to the underlying response.
`void`	`beforeCommit(Supplier<? extends reactor.core.publisher.Mono<Void>> action)` Register an action to be applied just before the message is committed.
`org.springframework.core.io.buffer.DataBufferFactory`	`bufferFactory()` Return a `DataBufferFactory` that can be used for creating the body.
`protected reactor.core.publisher.Mono<Void>`	`doCommit()` A variant of `doCommit(Supplier)` for a response without no body.
`protected reactor.core.publisher.Mono<Void>`	`doCommit(Supplier<? extends reactor.core.publisher.Mono<Void>> writeAction)` Apply `beforeCommit` actions, apply the response status and headers/cookies, and write the response body.
`String`	`encodeUrl(String url)` A mechanism for URL rewriting that applications and libraries such as HTML template libraries to use consistently for all URLs emitted by the application.
`org.springframework.util.MultiValueMap<String,ResponseCookie>`	`getCookies()` Return a mutable map with the cookies to send to the server.
`HttpHeaders`	`getHeaders()` Return the headers of this message.
`HttpStatus`	`getStatusCode()` Return the HTTP status code or `null` if not set.
`void`	`registerUrlEncoder(Function<String,String> encoder)` Register a URL rewriting function for use with `ServerHttpResponse.encodeUrl(java.lang.String)`.
`reactor.core.publisher.Mono<Void>`	`setComplete()` Indicate that message handling is complete, allowing for any cleanup or end-of-processing tasks to be performed such as applying header changes made via `HttpMessage.getHeaders()` to the underlying HTTP message (if not applied already).
`boolean`	`setStatusCode(HttpStatus statusCode)` Set the HTTP status code of the response.
`reactor.core.publisher.Mono<Void>`	`writeAndFlushWith(org.reactivestreams.Publisher<? extends org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer>> body)` Use the given `Publisher` of `Publishers` to write the body of the message to the underlying HTTP layer, flushing after each `Publisher<DataBuffer>`.
`protected abstract reactor.core.publisher.Mono<Void>`	`writeAndFlushWithInternal(org.reactivestreams.Publisher<? extends org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer>> body)` Implement this method to write to the underlying the response, and flush after each `Publisher<DataBuffer>`.
`reactor.core.publisher.Mono<Void>`	`writeWith(org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer> body)` Use the given `Publisher` to write the body of the message to the underlying HTTP layer.
`protected abstract reactor.core.publisher.Mono<Void>`	`writeWithInternal(org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer> body)` Implement this method to write to the underlying the response.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractServerHttpResponse
```
public AbstractServerHttpResponse(org.springframework.core.io.buffer.DataBufferFactory dataBufferFactory)
```
- Method Detail
  - bufferFactory
```
public final org.springframework.core.io.buffer.DataBufferFactory bufferFactory()
```
    Description copied from interface: ReactiveHttpOutputMessage
    
    Return a DataBufferFactory that can be used for creating the body.
    
    Specified by:
    
    bufferFactory in interface ReactiveHttpOutputMessage
    
    Returns:
    
    a buffer factory
    
    See Also:
    
    ReactiveHttpOutputMessage.writeWith(Publisher)
  - setStatusCode
```
public boolean setStatusCode(HttpStatus statusCode)
```
    Description copied from interface: ServerHttpResponse
    
    Set the HTTP status code of the response.
    
    Specified by:
    
    setStatusCode in interface ServerHttpResponse
    
    Parameters:
    
    statusCode - the HTTP status as an HttpStatus enum value
    
    Returns:
    
    false if the status code has not been set because the HTTP response is already committed, true if it has been set correctly.
  - getStatusCode
```
public HttpStatus getStatusCode()
```
    Description copied from interface: ServerHttpResponse
    
    Return the HTTP status code or null if not set.
    
    Specified by:
    
    getStatusCode in interface ServerHttpResponse
  - getHeaders
```
public HttpHeaders getHeaders()
```
    Description copied from interface: HttpMessage
    
    Return the headers of this message.
    
    Specified by:
    
    getHeaders in interface HttpMessage
    
    Returns:
    
    a corresponding HttpHeaders object (never null)
  - getCookies
```
public org.springframework.util.MultiValueMap<String,ResponseCookie> getCookies()
```
    Description copied from interface: ServerHttpResponse
    
    Return a mutable map with the cookies to send to the server.
    
    Specified by:
    
    getCookies in interface ServerHttpResponse
  - encodeUrl
```
public String encodeUrl(String url)
```
    Description copied from interface: ServerHttpResponse
    
    A mechanism for URL rewriting that applications and libraries such as HTML template libraries to use consistently for all URLs emitted by the application. Doing so enables the registration of URL encoders via ServerHttpResponse.registerUrlEncoder(java.util.function.Function<java.lang.String, java.lang.String>) that can insert an id for authentication, a nonce for CSRF protection, a version for a static resource, etc.
    
    Specified by:
    
    encodeUrl in interface ServerHttpResponse
    
    Parameters:
    
    url - the URL to encode
    
    Returns:
    
    the encoded URL or the same
  - registerUrlEncoder
```
public void registerUrlEncoder(Function<String,String> encoder)
```
    Description copied from interface: ServerHttpResponse
    
    Register a URL rewriting function for use with ServerHttpResponse.encodeUrl(java.lang.String). The function must return an encoded URL or the same URL.
    
    Specified by:
    
    registerUrlEncoder in interface ServerHttpResponse
    
    Parameters:
    
    encoder - a URL encoding function to use
  - beforeCommit
```
public void beforeCommit(Supplier<? extends reactor.core.publisher.Mono<Void>> action)
```
    Description copied from interface: ReactiveHttpOutputMessage
    
    Register an action to be applied just before the message is committed.
    
    Specified by:
    
    beforeCommit in interface ReactiveHttpOutputMessage
    
    Parameters:
    
    action - the action
  - writeWith
```
public final reactor.core.publisher.Mono<Void> writeWith(org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer> body)
```
    Description copied from interface: ReactiveHttpOutputMessage
    
    Use the given Publisher to write the body of the message to the underlying HTTP layer.
    
    Specified by:
    
    writeWith in interface ReactiveHttpOutputMessage
    
    Parameters:
    
    body - the body content publisher
    
    Returns:
    
    a Mono that indicates completion or error
  - writeAndFlushWith
```
public final reactor.core.publisher.Mono<Void> writeAndFlushWith(org.reactivestreams.Publisher<? extends org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer>> body)
```
    Description copied from interface: ReactiveHttpOutputMessage
    
    Use the given Publisher of Publishers to write the body of the message to the underlying HTTP layer, flushing after each Publisher<DataBuffer>.
    
    Specified by:
    
    writeAndFlushWith in interface ReactiveHttpOutputMessage
    
    Parameters:
    
    body - the body content publisher
    
    Returns:
    
    a Mono that indicates completion or error
  - setComplete
```
public reactor.core.publisher.Mono<Void> setComplete()
```
    Description copied from interface: ReactiveHttpOutputMessage
    
    Indicate that message handling is complete, allowing for any cleanup or end-of-processing tasks to be performed such as applying header changes made via HttpMessage.getHeaders() to the underlying HTTP message (if not applied already).
    This method should be automatically invoked at the end of message processing so typically applications should not have to invoke it. If invoked multiple times it should have no side effects.
    
    Specified by:
    
    setComplete in interface ReactiveHttpOutputMessage
    
    Returns:
    
    a Mono that indicates completion or error
  - doCommit
```
protected reactor.core.publisher.Mono<Void> doCommit()
```
    A variant of doCommit(Supplier) for a response without no body.
    
    Returns:
    
    a completion publisher
  - doCommit
```
protected reactor.core.publisher.Mono<Void> doCommit(Supplier<? extends reactor.core.publisher.Mono<Void>> writeAction)
```
    Apply beforeCommit actions, apply the response status and headers/cookies, and write the response body.
    
    Parameters:
    
    writeAction - the action to write the response body or null
    
    Returns:
    
    a completion publisher
  - writeWithInternal
```
protected abstract reactor.core.publisher.Mono<Void> writeWithInternal(org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer> body)
```
    Implement this method to write to the underlying the response.
    
    Parameters:
    
    body - the publisher to write with
  - writeAndFlushWithInternal
```
protected abstract reactor.core.publisher.Mono<Void> writeAndFlushWithInternal(org.reactivestreams.Publisher<? extends org.reactivestreams.Publisher<? extends org.springframework.core.io.buffer.DataBuffer>> body)
```
    Implement this method to write to the underlying the response, and flush after each Publisher<DataBuffer>.
    
    Parameters:
    
    body - the publisher to write and flush with
  - applyStatusCode
```
protected abstract void applyStatusCode()
```
    Implement this method to write the status code to the underlying response. This method is called once only.
  - applyHeaders
```
protected abstract void applyHeaders()
```
    Implement this method to apply header changes from getHeaders() to the underlying response. This method is called once only.
  - applyCookies
```
protected abstract void applyCookies()
```
    Implement this method to add cookies from getHeaders() to the underlying response. This method is called once only.

Class AbstractServerHttpResponse

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AbstractServerHttpResponse

Method Detail

bufferFactory

setStatusCode

getStatusCode

getHeaders

getCookies

encodeUrl

registerUrlEncoder

beforeCommit

writeWith

writeAndFlushWith

setComplete

doCommit

doCommit

writeWithInternal

writeAndFlushWithInternal

applyStatusCode

applyHeaders

applyCookies