Package io.servicetalk.http.api

Class StatelessTrailersTransformer<Payload>

java.lang.Object

io.servicetalk.http.api.StatelessTrailersTransformer<Payload>

Type Parameters:

Payload - Type of payload this transformer receives.

All Implemented Interfaces:

TrailersTransformer<Void,Payload>

public class StatelessTrailersTransformer<Payload>
extends Object
implements TrailersTransformer<Void,Payload>

An implementation of TrailersTransformer that does not require any state.

Constructor Summary

Constructors

Constructor	Description
StatelessTrailersTransformer()

Method Summary

Modifier and Type	Method	Description
final Payload	accept(Void __, Payload payload)	Accepts a TrailersTransformer.
protected Payload	accept(Payload payload)	Same as accept(Void, Object) but without the state.
final HttpHeaders	catchPayloadFailure(Void __, Throwable cause, HttpHeaders trailers)	Invoked once all TrailersTransformer instances are accepted and the payload stream has terminated with an error.
final Void	newState()	Creates a new instance of the TrailersTransformer.
protected HttpHeaders	payloadComplete(HttpHeaders trailers)	Same as payloadComplete(Void, HttpHeaders) but without the state.
final HttpHeaders	payloadComplete(Void __, HttpHeaders trailers)	Invoked once all TrailersTransformer instances are accepted and the payload stream has successfully completed.
protected HttpHeaders	payloadFailed(Throwable cause, HttpHeaders trailers)	Same as catchPayloadFailure(Void, Throwable, HttpHeaders) but without the state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StatelessTrailersTransformer

public StatelessTrailersTransformer()

Method Details

newState

public final Void newState()

Description copied from interface: TrailersTransformer

Creates a new instance of the TrailersTransformer.

Specified by:

newState in interface TrailersTransformer<Void,Payload>

Returns:

A new instance of the TrailersTransformer.

accept

public final Payload accept(Void __,
 Payload payload)

Description copied from interface: TrailersTransformer

Accepts a TrailersTransformer.

Specified by:

accept in interface TrailersTransformer<Void,Payload>

Parameters:

__ - TrailersTransformer instance created previously by this transformer.

payload - TrailersTransformer to accept.

Returns:

Potentially transformed TrailersTransformer instance.

payloadComplete

public final HttpHeaders payloadComplete(Void __,
 HttpHeaders trailers)

Description copied from interface: TrailersTransformer

Invoked once all TrailersTransformer instances are accepted and the payload stream has successfully completed.

Specified by:

payloadComplete in interface TrailersTransformer<Void,Payload>

Parameters:

__ - TrailersTransformer instance created previously by this transformer.

trailers - Trailer for the streaming HTTP request/response that is transformed.

Returns:

Potentially transformed trailers.

catchPayloadFailure

public final HttpHeaders catchPayloadFailure(Void __,
 Throwable cause,
 HttpHeaders trailers)
                                      throws Throwable

Description copied from interface: TrailersTransformer

Invoked once all TrailersTransformer instances are accepted and the payload stream has terminated with an error.

This method suppresses the passed cause if it returns successfully. In order to propagate the cause, one should throw the same from this method.

Specified by:

catchPayloadFailure in interface TrailersTransformer<Void,Payload>

Parameters:

__ - TrailersTransformer instance created previously by this transformer.

cause - of the payload stream failure.

trailers - Trailer for the streaming HTTP request/response that is transformed.

Returns:

Potentially transformed trailers. This will swallow the passed cause. In order to propagate the cause, it should be re-thrown.

Throws:

Throwable - If the error has to be propagated

accept

protected Payload accept(Payload payload)

Same as accept(Void, Object) but without the state.

Parameters:

payload - StatelessTrailersTransformer to accept.

Returns:

Potentially transformed StatelessTrailersTransformer instance.

payloadComplete

protected HttpHeaders payloadComplete(HttpHeaders trailers)

Same as payloadComplete(Void, HttpHeaders) but without the state.

Parameters:

trailers - Trailer for the streaming HTTP request/response that is transformed.

Returns:

Potentially transformed trailers.

payloadFailed

protected HttpHeaders payloadFailed(Throwable cause,
 HttpHeaders trailers)
                             throws Throwable

Same as catchPayloadFailure(Void, Throwable, HttpHeaders) but without the state.

Parameters:

cause - of the payload stream failure.

trailers - Trailer for the streaming HTTP request/response that is transformed.

Returns:

Potentially transformed trailers. This will swallow the passed cause. In order to propagate the cause, it should be re-thrown.

Throws:

Throwable - If the error has to be propagated