首页 > 代码库 > SPWebServer:一个基于 SPServer 的 web 服务器框架

SPWebServer:一个基于 SPServer 的 web 服务器框架

SPWebServer:一个基于 SPServer 的 web 服务器框架

博客分类:
     
  • OpenSource项目
应用服务器框架Web网络应用多线程 
看到这个题目,估计很多人会问:为什么要再实现一个 web 服务器? 

这里有几个原因: 

1.这是一个 web 服务器框架,不是一个完整的 web 服务器。也就是说 SPWebServer 提供的是一套 API 和类库,可以方便地集成到现有的应用程序中。可以称 SPWebServer 为 embedded web server 。 

2.有些时候,我们需要的不是一个功能强大完整的 web 服务器(例如 apache ),我们只是需要一个能提供最基本的 http 功能的服务器框架。比如要用 C/C++ 实现 XML-RPC,JSON-RPC 服务器端,或者为 jabberd 实现一个 http bind 的时候。这些场景下,也可以使用 apache,但是使用 embedded web server 可以简化配置。 

3.在如下的场合中,apache 显得不合适,而 embedded web server 却正好合适:在一个现有的应用程序中,用 http 接口来提供一些简单的控制和统计功能。 

基于以上原因,也为了 
1.丰富 SPServer 项目(请参考: SPServer : 一个基于 Half-Sync/Half-Async 模式的高并发 server 框架)的功能; 
2.正好作为 SPServer 框架的一个比较好的示范例子; 
因此基于 SPServer 框架实现了一个 web 服务器框架。 

源代码下载: 
http://spserver.googlecode.com/files/spserver-0.5.src.tar.gz 
http://code.google.com/p/spserver/downloads/list 

下面来看一个使用 SPWebServer 的简单例子。 

Java代码  收藏代码
  1. class SP_HttpEchoHandler : public SP_HttpHandler {  
  2. public:  
  3.     SP_HttpEchoHandler(){}  
  4.     virtual ~SP_HttpEchoHandler(){}  
  5.   
  6.     virtual void handle( SP_HttpRequest * request, SP_HttpResponse * response ) {  
  7.         response->setStatusCode( 200 );  
  8.         response->appendContent( "<html><head>"  
  9.             "<title>Welcome to simple http</title>"  
  10.             "</head><body>" );  
  11.   
  12.         char buffer[ 512 ] = { 0 };  
  13.         snprintf( buffer, sizeof( buffer ),  
  14.             "<p>The requested URI is : %s.</p>", request->getURI() );  
  15.         response->appendContent( buffer );  
  16.   
  17.         snprintf( buffer, sizeof( buffer ),  
  18.             "<p>Client IP is : %s.</p>", request->getClientIP() );  
  19.         response->appendContent( buffer );  
  20.   
  21.         for( int i = 0; i < request->getParamCount(); i++ ) {  
  22.             snprintf( buffer, sizeof( buffer ),  
  23.                 "<p>Param - %s = %s<p>", request->getParamName( i ),  
  24.                 request->getParamValue( i ) );  
  25.             response->appendContent( buffer );  
  26.         }         
  27.   
  28.         for( int i = 0; i < request->getHeaderCount(); i++ ) {  
  29.             snprintf( buffer, sizeof( buffer ),  
  30.                 "<p>Header - %s: %s<p>", request->getHeaderName( i ),  
  31.                 request->getHeaderValue( i ) );  
  32.             response->appendContent( buffer );  
  33.         }         
  34.   
  35.         if( NULL != request->getContent() ) {  
  36.             response->appendContent( "<p>" );  
  37.             response->appendContent( request->getContent(),  
  38.                 request->getContentLength() );  
  39.             response->appendContent( "</p>" );  
  40.         }         
  41.   
  42.         response->appendContent( "</body></html>\n" );  
  43.     }     
  44. };  
  45.   
  46. class SP_HttpEchoHandlerFactory : public SP_HttpHandlerFactory {  
  47. public:  
  48.     SP_HttpEchoHandlerFactory(){}  
  49.     virtual ~SP_HttpEchoHandlerFactory(){}  
  50.   
  51.     virtual SP_HttpHandler * create() const {  
  52.         return new SP_HttpEchoHandler();  
  53.     }  
  54. };  
  55.   
  56. //---------------------------------------------------------  
  57.   
  58. int main( int argc, char * argv[] )  
  59. {  
  60.     int port = 8080;  
  61.   
  62.     SP_Server server( "", port,  
  63.         new SP_HttpHandlerAdapterFactory( new SP_HttpEchoHandlerFactory() ) );  
  64.   
  65.     server.runForever();  
  66.   
  67.     return 0;  
  68. }  


上面的代码演示的是一个 http echo server ,即把 client 发过来的请求信息显示在页面上。 

在最简单的情况下,使用 SPWebServer 需要实现两个类:SP_HttpHandler 的子类 和 SP_HttpHandlerFactory 的子类。 
SP_HttpHandler 的子类负责处理具体的 http 请求。 
SP_HttpHandlerFactory 的子类协助 spserver 为每一个连接创建一个 SP_HttpHandler 子类实例。 

在实现过程中,使用了 Adapter 模式,把 SP_HttpHandler 和 SP_HttpHandlerFactory 适配为 SP_Handler 和 SP_HandlerAdapterFactory。这两个 Adapter 都已经实现,不需要使用者来实现。