123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277 |
- //------------------------------------------------------------
- // Game Framework
- // Copyright © 2013-2021 loyalsoft. All rights reserved.
- // Homepage: http://www.game7000.com/
- // Feedback: http://www.game7000.com/
- //------------------------------------------------------------
- using System;
- using System.Collections.Generic;
- namespace GameFramework.WebRequest
- {
- /// <summary>
- /// Web 请求管理器接口。
- /// </summary>
- public interface IWebRequestManager
- {
- /// <summary>
- /// 获取 Web 请求代理总数量。
- /// </summary>
- int TotalAgentCount
- {
- get;
- }
- /// <summary>
- /// 获取可用 Web 请求代理数量。
- /// </summary>
- int FreeAgentCount
- {
- get;
- }
- /// <summary>
- /// 获取工作中 Web 请求代理数量。
- /// </summary>
- int WorkingAgentCount
- {
- get;
- }
- /// <summary>
- /// 获取等待 Web 请求数量。
- /// </summary>
- int WaitingTaskCount
- {
- get;
- }
- /// <summary>
- /// 获取或设置 Web 请求超时时长,以秒为单位。
- /// </summary>
- float Timeout
- {
- get;
- set;
- }
- /// <summary>
- /// Web 请求开始事件。
- /// </summary>
- event EventHandler<WebRequestStartEventArgs> WebRequestStart;
- /// <summary>
- /// Web 请求成功事件。
- /// </summary>
- event EventHandler<WebRequestSuccessEventArgs> WebRequestSuccess;
- /// <summary>
- /// Web 请求失败事件。
- /// </summary>
- event EventHandler<WebRequestFailureEventArgs> WebRequestFailure;
- /// <summary>
- /// 增加 Web 请求代理辅助器。
- /// </summary>
- /// <param name="webRequestAgentHelper">要增加的 Web 请求代理辅助器。</param>
- void AddWebRequestAgentHelper(IWebRequestAgentHelper webRequestAgentHelper);
- /// <summary>
- /// 根据 Web 请求任务的序列编号获取 Web 请求任务的信息。
- /// </summary>
- /// <param name="serialId">要获取信息的 Web 请求任务的序列编号。</param>
- /// <returns>Web 请求任务的信息。</returns>
- TaskInfo GetWebRequestInfo(int serialId);
- /// <summary>
- /// 根据 Web 请求任务的标签获取 Web 请求任务的信息。
- /// </summary>
- /// <param name="tag">要获取信息的 Web 请求任务的标签。</param>
- /// <returns>Web 请求任务的信息。</returns>
- TaskInfo[] GetWebRequestInfos(string tag);
- /// <summary>
- /// 根据 Web 请求任务的标签获取 Web 请求任务的信息。
- /// </summary>
- /// <param name="tag">要获取信息的 Web 请求任务的标签。</param>
- /// <param name="results">Web 请求任务的信息。</param>
- void GetAllWebRequestInfos(string tag, List<TaskInfo> results);
- /// <summary>
- /// 获取所有 Web 请求任务的信息。
- /// </summary>
- /// <returns>所有 Web 请求任务的信息。</returns>
- TaskInfo[] GetAllWebRequestInfos();
- /// <summary>
- /// 获取所有 Web 请求任务的信息。
- /// </summary>
- /// <param name="results">所有 Web 请求任务的信息。</param>
- void GetAllWebRequestInfos(List<TaskInfo> results);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, string tag);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, int priority);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, string tag);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, int priority);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, string tag, int priority);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, string tag, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, int priority, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, string tag, int priority);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, string tag, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, int priority, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, string tag, int priority, object userData);
- /// <summary>
- /// 增加 Web 请求任务。
- /// </summary>
- /// <param name="webRequestUri">Web 请求地址。</param>
- /// <param name="postData">要发送的数据流。</param>
- /// <param name="tag">Web 请求任务的标签。</param>
- /// <param name="priority">Web 请求任务的优先级。</param>
- /// <param name="userData">用户自定义数据。</param>
- /// <returns>新增 Web 请求任务的序列编号。</returns>
- int AddWebRequest(string webRequestUri, byte[] postData, string tag, int priority, object userData);
- /// <summary>
- /// 根据 Web 请求任务的序列编号移除 Web 请求任务。
- /// </summary>
- /// <param name="serialId">要移除 Web 请求任务的序列编号。</param>
- /// <returns>是否移除 Web 请求任务成功。</returns>
- bool RemoveWebRequest(int serialId);
- /// <summary>
- /// 根据 Web 请求任务的标签移除 Web 请求任务。
- /// </summary>
- /// <param name="tag">要移除 Web 请求任务的标签。</param>
- /// <returns>移除 Web 请求任务的数量。</returns>
- int RemoveWebRequests(string tag);
- /// <summary>
- /// 移除所有 Web 请求任务。
- /// </summary>
- /// <returns>移除 Web 请求任务的数量。</returns>
- int RemoveAllWebRequests();
- }
- }
|