com.ksc.handlers.RequestHandler2 Maven / Gradle / Ivy
/*
* Copyright 2010-2016 ksyun.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://ksyun.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
package com.ksc.handlers;
import com.ksc.KscWebServiceRequest;
import com.ksc.Request;
import com.ksc.Response;
import com.ksc.http.HttpResponse;
import com.ksc.util.TimingInfo;
/**
* Interface for addition request handling in clients. A request handler is executed on a request
* object before it is sent to the client runtime to be executed.
*
* This interface deprecates {@link RequestHandler} by providing access to not only the KSC
* response, but also the associated http response via {@link Response}.
*
* Note {@link TimingInfo} is accessible via {@link Request#getAWSRequestMetrics()} and hence is
* omitted from the interface to reduce duplication by design.
*/
public abstract class RequestHandler2 implements IRequestHandler2 {
@Override
public KscWebServiceRequest beforeMarshalling(KscWebServiceRequest request) {
return request;
}
@Override
public void beforeRequest(Request request) {
}
@Override
public HttpResponse beforeUnmarshalling(Request request, HttpResponse httpResponse) {
return httpResponse;
}
@Override
public void afterResponse(Request request, Response response) {
}
@Override
public void afterError(Request request, Response response, Exception e) {
}
/**
* Returns an instance of request handler adapted to the {@link RequestHandler2} interface from
* the given request handler implementing the deprecated {@link RequestHandler} interface.
*/
public static RequestHandler2 adapt(@SuppressWarnings("deprecation") RequestHandler old) {
return new RequestHandler2Adaptor(old);
}
}