com.fasterxml.clustermate.service.ServiceResponse Maven / Gradle / Ivy
Show all versions of clustermate-service Show documentation
package com.fasterxml.clustermate.service;
import java.net.HttpURLConnection;
import com.fasterxml.clustermate.api.ClusterMateConstants;
import com.fasterxml.clustermate.service.ServiceResponse;
import com.fasterxml.clustermate.service.msg.StreamingResponseContent;
/**
* Interface class that defines interface of (HTTP) Responses
* server returns to caller.
*
* Separated out to allow handlers to operate independent of the
* container like Servlet or JAX-RS container.
*/
public abstract class ServiceResponse
{
/**
* Raw entity to serialize and return, if any.
*
* Note that either this OR _streamingContent can be non-null.
*/
protected Object _entity;
/**
* Content to write out, if any.
*
* Note that either this OR _entity can be non-null.
*/
protected StreamingResponseContent _streamingContent;
/*
/**********************************************************************
/* Statistics
/**********************************************************************
*/
/**
* Accessor for number of bytes written through this response.
*/
public abstract long getBytesWritten();
/*
/**********************************************************************
/* Low-level response building
/**********************************************************************
*/
public abstract RESP set(int code, Object entity);
public abstract RESP setStatus(int code);
public abstract ServiceResponse addHeader(String key, String value);
public abstract ServiceResponse addHeader(String key, int value);
public abstract ServiceResponse addHeader(String key, long value);
/**
* Method for specifying POJO to serialize as content of response;
* either as streaming content (if entity is of type
* {@link StreamingResponseContent}); or as something to serialize
* using default serialization mechanism (usually JSON).
*/
@SuppressWarnings("unchecked")
public final RESP setEntity(Object e)
{
if (e instanceof StreamingResponseContent) {
_entity = null;
_streamingContent = (StreamingResponseContent) e;
} else {
_entity = e;
_streamingContent = null;
}
return (RESP) this;
}
/*
/**********************************************************************
/* Basic accessors
/**********************************************************************
*/
public abstract int getStatus();
public final boolean isError() { return getStatus() >= 300; }
public final boolean hasEntity() { return _entity != null; }
public final boolean hasStreamingContent() { return _streamingContent != null; }
@SuppressWarnings("unchecked")
public final T getEntity() {
return (T) _entity;
}
/*
/**********************************************************************
/* High(er)-level response building; semantic headers
/**********************************************************************
*/
public abstract ServiceResponse setContentType(String contentType);
public ServiceResponse setContentTypeJson() {
return setContentType("application/json");
}
public ServiceResponse setContentTypeText() {
return setContentType("text/plain");
}
public final ServiceResponse setBodyCompression(String type) {
return addHeader(ClusterMateConstants.HTTP_HEADER_COMPRESSION, type);
}
public abstract ServiceResponse setContentLength(long length);
/*
/**********************************************************************
/* High(er)-level response building; ok cases
/**********************************************************************
*/
public final RESP ok() {
return setStatus(ClusterMateConstants.HTTP_STATUS_OK);
}
public final RESP ok(Object entity) {
return ok().setEntity(entity);
}
public final ServiceResponse ok(String contentType, Object entity) {
return ok().setContentType(contentType).setEntity(entity);
}
public final ServiceResponse noContent() {
return setStatus(HttpURLConnection.HTTP_NO_CONTENT);
}
public final ServiceResponse serverOverload() { // 503
return setStatus(HttpURLConnection.HTTP_UNAVAILABLE);
}
public final ServiceResponse internalServerError() { // 500
return setStatus(HttpURLConnection.HTTP_INTERNAL_ERROR);
}
public final ServiceResponse internalServerError(String msg) { // 500
return set(HttpURLConnection.HTTP_INTERNAL_ERROR, msg);
}
public final ServiceResponse accepted(Object entity) {
return set(HttpURLConnection.HTTP_ACCEPTED, entity);
}
public final ServiceResponse partialContent(Object entity, String rangeDesc) {
// 206 means "partial content"
return set(ClusterMateConstants.HTTP_STATUS_OK_PARTIAL, entity)
.addHeader(ClusterMateConstants.HTTP_HEADER_RANGE_FOR_RESPONSE, rangeDesc);
}
/*
/**********************************************************************
/* High(er)-level response building; error cases
/**********************************************************************
*/
public final RESP notChanged() {
return setStatus(304);
}
public final RESP badMethod() {
// Method Not Allowed
return setStatus(405);
}
public final RESP badRange(Object entity) {
// 416 is used for invalid Range requests
return set(416, entity);
}
public final RESP badRequest(Object entity) {
return set(400, entity);
}
public final RESP conflict(Object entity) {
return set(ClusterMateConstants.HTTP_STATUS_ERROR_CONFLICT, entity);
}
public final RESP gone(Object entity) {
return set(ClusterMateConstants.HTTP_STATUS_ERROR_GONE, entity);
}
public final RESP notFound() {
return setStatus(ClusterMateConstants.HTTP_STATUS_NOT_FOUND);
}
public final RESP notFound(Object entity) {
return set(ClusterMateConstants.HTTP_STATUS_NOT_FOUND, entity);
}
public final RESP internalError(Object entity) {
return set(500, entity);
}
public final RESP internalFileNotFound(Object entity) {
/* 12-Dec-2013, tatu: There isn't really any optimal 5xx code; but to distringuish
* this from generic 500, let's use 507 ("not enough space"), which hopefully
* at least allows separating it from other fails.
*/
return set(507, entity);
}
/**
* Couple of choices here, but use 504 to distinguish from "unknown" 500 problem
*/
public final RESP serviceTimeout(Object entity) {
return set(504, entity);
}
}