package com.walker.remote;

import com.walker.api.client.ResponseData;
import org.apache.hc.client5.http.cookie.CookieStore;

import java.util.Map;

/**
 * 远程访问接口定义，系统最基本的核心接口之一。</p>
 * 通过该接口可以远程调用各种服务，如：socket、http、webservice等
 * @author shikeying
 * @date 2015-2-7
 *
 */
public interface RemoteAccessor{

	/**
	 * 同步远程服务调用。
	 * @param methodName
	 * @param simpleData
	 * @param jsonParameter
	 * @param responseData 给定一个响应对象的实例，如：new ResponseLogin()
	 * @return
	 */
	public abstract <T> T requestTextSync(String methodName, Map<String, String> simpleData,
			String jsonParameter, ResponseData<T> responseData);
	
	
	/**
	 * 设置调用接口对传输内容的加密方式，可能有多种实现，需要调用方配置一个。<br>
	 * 如果不设置，系统默认使用<code>Base64</code>进行简单编码。
	 * @param byteCoder
	 */
	void setContentEncoder(AbstractByteCoder byteCoder);
	
	/**
	 * 设置访问服务端的基础路径，如：http://www.abc.com:8080/app/request.do
	 * @param baseUrl
	 */
	void setBaseUrl(String baseUrl);
	
	/**
	 * 设置客户端证书信息，双向认证使用
	 * @param doubleTrust
	 */
	void setDoubleTrust(DoubleTrust doubleTrust);
	
//	public abstract void setTimeRecorder(TimeRecorder timeRecorder);

	<T> T requestTextSyncWithCookie(String methodName, Map<String, String> simpleData, String jsonParameter, ResponseData<T> responseData, CookieStore cookieStore);

	<T> T requestSyncDelete(String methodName, String jsonParameter, Map<String, String> header, ResponseData<T> responseData);


	<T> T requestSyncPut(String methodName, String jsonParameter, Map<String, String> header, ResponseData<T> responseData);


	<T> T requestSyncPost(String methodName, String jsonParameter, Map<String, String> header, ResponseData<T> responseData);


	<T> T requestSyncWithoutGet(String methodName, String jsonParameter, String methodType, Map<String, String> header, ResponseData<T> responseData);


	<T> T requestSync(String methodName, Map<String, String> simpleData, String jsonParameter, String methodType, String contentType, Map<String, String> header, ResponseData<T> responseData);

	/**
	 * 默认的提交json格式数据的参数名字，不能直接提交json，必须添加表单名称，<br>
	 * 否则服务端无法接收参数。
	 */
	public static final String DEFALUT_FORM_DATA_NAME = "datas";
	
	/**
	 * 响应返回的结果中以特殊标志开头的内容：此时表示http请求返回的不是html内容，而是重新跳转等额外信息
	 */
	public static final String RESPONSE_EXT_ID = "ext//";
	
}