HttpServer的特點
1、完全采用IOCP模型,實現真正的異步IO,高並發、高可靠;
2、支持4G以上文件下載;
3、支持斷點續傳;
4、輕量級,體積小,服務器文件僅200多K,無任何依賴庫;
5、支持CGI網關,通過CGI.xml可動態配置各種網關接口,實現動態交互;
6、內置上傳文件接口;
SSL版本
《HttpServer: 基於IOCP模型且集成Openssl的輕量級高性能web服務器》
一、命令行參數介紹
啟動服務器: HttpServer.exe -W d:\web -H index.html -P 80 -M 10000
-W : web網站的發布路徑,如:d:\web,如果路徑中有空格,可使用雙引號。
如不指定,則會在當前服務運行的目錄下創建web目錄,並以此為web網站目錄。
-H :web網站的主頁,如:index.html,
如果不指定主頁,則顯示web目錄的文件清單,可作為簡單的文件服務器使用。
-P : web服務的端口號,缺省值為80。
-M :最大並發量,缺省值為20000。
其它參數(后面不帶值,參數存在則表示容許或使用):
-AllowUpload : 容許上傳
-CacheM :使用緩存(具體含義見下節的"UseCacheMem"字段)
-CacheC : 使用緩存(具體含義見下節的"UseCacheClass"字段)
缺省值是指,如果該命令參數不指定,服務器使用的默認參數。
HttpServer也可以通過配置文件進行參數設置,配置文件為HttpServer.ini。
二、配置文件參數介紹
HttpServer可通過HttpServer.ini文件進行參數配置,參數更加豐富,是對命令行參數的補充。
WebPath : web網站的發布路徑,等同於命令行參數"-W"。
HomePage:web網站的主頁,等同於命令行參數"-H"。
Port: web服務的端口號,等同於命令行參數"-P"。
TimeOut: 超時,單位秒,缺省值為60秒。
MaxConn: 最大並發數,等同於命令行參數"-M",缺省值為20000。
PostDataPath: 上傳數據的保存路徑,缺省值為當前用戶的temp目錄。
1、使用場景一:用戶在上傳文件時,上傳文件保存的臨時路徑;
2、使用場景二:post請求時,如果用戶post數據過大,超過"MaxPostCacheFileSize"字段指定的閥值, 則轉為文件存儲,防止內存使用過大;
MaxPostCacheFileSize: POST請求時,接收POST數據cache緩存的最大值,如果超過該值,則將緩存轉存為文件,單位為字節BYTE;
MaxUploadFileSize:最大上傳文件尺寸,單位M字節,缺省值為2G。
UseCacheMem:是否使用緩存,缺省值為0,表示不使用。 如使使用緩存,則服務器會用空間換時間,預先開辟若干連續的大內存塊,並重載malloc和free函數,在預先開辟的大內存塊中尋找可用的“碎片化”內存,從而減少在高並發下頻繁的申請和銷毀內存導致的速度變慢。
UseCacheClass:是否使用結構體(struct/class)緩存,缺省值為0,表示不使用。 如使用該值,則服務器會用空間換時間,即:根據MaxConn指定的並發數,預先開辟出指定的內存空間, 如果MaxConn為2萬,則會開辟對應2萬個結構體(struct/class)用於保存HTTP會話時的上下文(context)數據。 同上,該值也是為了減少在高並發下頻繁的申請和銷毀內存導致的速度變慢。
UseMappingFile: 是否使用Mapping File方式訪問磁盤文件,缺省值為1,表示使用。
AccessControlAllowOrigin: 是否容許跨域,缺省值1,表示容許。
PrintMessage:是否在控制台輸出HTTP請求,缺省值1,表示打印輸出。
注: 高並發時務必關閉控制台輸出!!!
AllowUpload:是否容許上傳,缺省值為0,表示不容許。
AllowCacheFile:是否容許文件緩存,缺省值為1,表示容許,該值有效時,會對文件進行緩存,避免頻繁的進行磁盤文件操作。
MaxCacheFileSize:最大緩存的文件尺寸,缺省值為5(單位M),小於該值的文件會加載到內存中,后續訪問將不再從磁盤中讀取而是直接讀內存。
三、Content-Type類型設置
通過ContentType.ini該配置文件,用戶可添加指定文件類型的Content-Type類型,當瀏覽器從服務器讀取文件時,
服務器會根據該配置文件返回指定的Content-Type給瀏覽器。
配置格式為如下,.文件擴展名:Content-Type
.mp4:video/mp4,表示如果是mp4文件,則Content-Type為video/mp4。
.cc:text/plain,表示如果是cc文件,則content-Type為text/plain。
四、CGI網關設置
CGI網關設置在CGI.xml文件中。各節點含義如下:
path:CGI網關文件所在的目錄,這里是全路徑,該路徑不一定在發布的web目錄下(不在web目錄下會更安全)。
timeout:執行網關程序的超時,單位秒,缺省值為10秒,防止有的網關程序不退出,或長時間不退出。
cgi:子節點,每個cgi子節點代表一個CGI網關類型。
cgi/name:該CGI節點名稱,比如python,表示該CGI中的網關文件是python腳本。
cgi/exe:執行該腳本的應用程序全路徑,如:c:\python25\python.exe。
cgi/action:響應配置,該節點代表一個需要處理的Http請求命令(在服務端則為一個應用),該節點有兩個字段,如下:
cgi/action/appname:url中的請求命令(應用名),如:python/test1.do
cgi/action/filename:處理上述請求的文件,如:test1.py,該文件必須在上述path節點指定的目錄中。
說明:當用戶發送 http://server:port/python/test1.do請求時,網關會執行test1.py腳本,並將腳本執行的結果返回給瀏覽器。
1、QUERY-SRING數據的傳遞
python/test1.do?key1=value1&key2=value2
"key1=value1&key2=value2"會通過命令行參數的方式傳遞給調用者。
python中為:sys.argv[1],詳見案例:test2.py。
2、POST-DATA數據的傳遞
POST數據的傳遞通過讀取標准的輸入獲取,python中為:sys.stdin.readline(),詳見案例:test1.py。
注意:
1、HttpServer沒有通過環境變量來傳遞QUERY-STRING;
2、CGI網關數據返回時,服務器會自動添加Content-Length字段(根據返回數據“\r\n\r\n”來計算HTTP響應頭和響應體的各自長度);
3、如果CGI網關返回數據中沒有"\r\n\r\n"來分割HTTP響應頭和響應體,則服務器會認為響應數據是明文,並自動添加類型為“text/plain”的響應頭,並返回給瀏覽器;
用戶可根據需要配置多個cgi子節點,用於處理不同類型的網關程序(或腳本)。 cgi配置的保留節點有兩個,一個是bat,一個是exe。對於windows下的bat格式腳本文件,是不需要指定執行程序,同樣exe文件也是。
網關配置文件如下:
python 網關文件案例:
BAT批處理網關文件案例:
exe網關文件案例:
五、內置上傳接口
接口名稱:command/upload.do
使用post命令,可將文件上傳到web發布目錄。
如果要將文件上傳至web目錄的子目錄中,可通過path參數指定,如下
command/upload.do?path=subfolder,subfolder為相對於web目錄中的子目錄。