package cn.ksource.core.remote;

import java.util.List;
import java.util.Map;

import cn.ksource.core.util.HttpCharset;
import cn.ksource.core.util.HttpMethod;
import cn.ksource.core.util.HttpRemoteException;

/**
 * 提供基础原创接口通讯服务
 */
public interface BaseRemote {

	/**
	 * 远程查询接口，返回值类型 string
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:19:32 PM
	 */
	public String queryForString(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 远程查询接口，返回值类型 map
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:20:22 PM
	 */
	public Map queryForMap(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 远程查询接口，返回值类型 List
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:20:22 PM
	 */
	public List<Map> queryForList(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 执行远程接口
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:23:32 PM
	 */
	public String executeForString(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 执行远程接口
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:23:32 PM
	 */
	public Map executeForMap(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 执行远程接口
	 * @param remoteUrl
	 * @param paramMap
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:23:32 PM
	 */
	public List<Map> executeForList(String remoteUrl,Map paramMap) throws HttpRemoteException;
	
	/**
	 * 使用指定的HTTP协议，执行远程接口
	 * @param remoteUrl
	 * @param paramMap
	 * @param charset
	 * @return
	 * @version V1.0.0
	 * @author 杨凯
	 * @date Apr 10, 2014 7:25:58 PM
	 */
	public String executeByHttp(String remoteUrl,Map paramMap,HttpMethod method) throws HttpRemoteException;
	
}