Package com.linecorp.armeria.common

Interface HttpResponseDuplicator

All Superinterfaces:
AutoCloseable, SafeCloseable, StreamMessageDuplicator<HttpObject>
public interface HttpResponseDuplicator
extends StreamMessageDuplicator<HttpObject>
A duplicator that duplicates a HttpResponse into one or more HttpResponses, which publish the same elements. 

 HttpResponse res = ...
 try (HttpResponseDuplicator duplicator = res.toDuplicator()) {
     // res.subscribe(...) will throw an exception. You cannot subscribe to res anymore.

     // Duplicate the response as many as you want to subscribe.
     HttpResponse duplicatedResponse1 = duplicator.duplicate();
     HttpResponse duplicatedResponse2 = duplicator.duplicate();

     duplicatedResponse1.subscribe(...);
     duplicatedResponse2.subscribe(...);
 }

Use the try-with-resources block or call StreamMessageDuplicator.close() manually to clean up the resources after all subscriptions are done. If you want to stop publishing and clean up the resources immediately, call StreamMessageDuplicator.abort(). If you do none of these, memory leak might happen.

If you subscribe to the duplicated http response with the SubscriptionOption#WITH_POOLED_OBJECTS, the published elements can be shared across Subscribers. So do not manipulate the data unless you copy them.