networkrequesthandle.java

j2me编写的游戏基础引擎,作为学习很不错.

package engine.optional.network;

import java.io.*;

/**
*	网络请求处理类(接口)
*	@author 贾永明
*	@version 2.8.0
*	@since HuoHouStudioEngine1.0
*/
public interface NetworkRequestHandle{
	/**
	*	成功建立网络连接时候的网络数据的处理方法。<br>因为，这个时候responseCode肯定是HTTP_OK状态，即联网成功，而且，这种情况下失败次数会自动清零。所以，与{@link engine.optional.network.NetworkRequestHandle#errorDataHandle(int, int) errorDataHandle(int responseCode,int failedTimes)}相比，本方法没有传入responseCode和failedTime这两个参数。但是，这个时候肯定是从网络上获取了反馈响应，所以，有了参数response，用来分析网络响应。
	*	@param <b>response</b> 当前事件的响应结果，是一个从网络获取的数据实体。
	*	@return 是否需要清除剩余的网络事件。
	*	@throws Exception 一切可能产生的异常。
	*/
	public abstract boolean correctDataHandle(DataInputStream response) throws Exception;
	/**
	*	没有成功建立网络连接时候的网络数据的处理方法。<br>因为，这个时候response肯定是没有获得的，即null。所以，与{@link engine.optional.network.NetworkRequestHandle#correctDataHandle(DataInputStream) correctDataHandle(DataInputStream response)}相比，本方法没有传入response这个参数，即这种情况下不需要处理网络响应。但是，这个时候需要记录失败的次数，所以有了参数failedTimes，来传递失败的次数。
	*	@param <b>responseCode</b> 当前事件的响应状态。
	*	@param <b>failedTimes</b>  联网过程中，上次成功联网之后，发生联网失败和数据传输异常的总的失败次数。
	*	@return 是否需要清除剩余的网络事件。
	*	@throws Exception 一切可能产生的异常。
	*/
	public abstract boolean errorDataHandle(int responseCode, int failedTimes) throws Exception;
}