DataResponse<T> to support "304 Not Modified"

[andrus]

Let's add a mechanism to return "304 Not Modified" versions of DataResponse<T>. While it is always possible to control the response status via JAX-RS Response object, there's a benefit to preserving DataResponse<T> in the API method signature, as it allows documentation tools like Swagger to guess the response type.

So while we are not (yet) building full cache control support in Agrest, let's at least allow the users to implement conditional requests without changing the endpoint method signatures.

Changes required:

• DataResponseBodyWriter and SimpleResponseBodyWriter must ensure an empty body if the status is 304
• AgResponse should support setting cache control (or arbitrary) headers
• ResponseStatusFilter should append those headers to response
• Headers must be settable from stage callbacks (i.e. should be set at the Context level)

Here is a simplied example of a custom endpoint that recognizes ETags. Real-life example would need to provide a smarter etag calculation function, and also set a reasonable Cache-Control header.

public static class Resource {

    @Context
    private Configuration config;

    @GET
    public DataResponse<P1> conditional(@HeaderParam("If-None-Match") String eTag) {
        return AgJaxrs
                .select(P1.class, config)
                .routingStage(SelectStage.APPLY_SERVER_PARAMS, c -> stopIfMatch(c, eTag))
                .stage(SelectStage.ENCODE, this::cacheControl)
                .get();
    }

    ProcessorOutcome stopIfMatch(SelectContext<?> context, String eTag) {
        if (!"my-tag".equals(eTag)) {
            return ProcessorOutcome.CONTINUE;
        }

        context.setResponseStatus(HttpStatus.NOT_MODIFIED);
        // even though we are not modified, per HTTP standards, we must return the original ETag
        context.addResponseHeader("etag", eTag);
        return ProcessorOutcome.STOP;
    }

    void cacheControl(SelectContext<?> context) {
        // calculate response etag 
        context.addResponseHeader("etag", "my-tag");
    }
}