[BACK]Return to pa_sapi.h CVS log [TXT] [DIR] Up to [parser3project] / parser3 / src / include

Diff for /parser3/src/include/pa_sapi.h between versions 1.18 and 1.36

version 1.18, 2002/02/08 08:30:13 version 1.36, 2020/10/26 23:15:51
Line 1 Line 1
 /** @file  /** @file
         Parser: web server api interface object decl.          Parser: web server api interface object decl.
   
         Copyright (c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2017 Art. Lebedev Studio (http://www.artlebedev.com)
         Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)          Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
   
         $Id$  
 */  */
   
 #ifndef PA_SAPI_H  #ifndef PA_SAPI_H
 #define PA_SAPI_H  #define PA_SAPI_H
   
 #include "pa_pool.h"  #define IDENT_PA_SAPI_H "$Id$"
 #include "pa_types.h"  
   // includes
   
 class Array;  #include "pa_common.h"
 class String;  #include "pa_array.h"
 class Hash;  #include "pa_exception.h"
   
   // forwards
   class SAPI_Info;
   
 /// target web-Server API  /// target web-Server API
 struct SAPI {  struct SAPI {
         /// log error message          /// log error message
         static void log(Pool& pool, const char *fmt, ...);          static void log(SAPI_Info& info, const char* fmt, ...);
         /// log error message & die          /// log error message & exit
         static void die(const char *fmt, ...);          static void die(const char* fmt, ...);
         /// get environment string  
         static const char *get_env(Pool& pool, const char *name);  
         /// read POST request bytes          /// read POST request bytes
         static size_t read_post(Pool& pool, char *buf, size_t max_bytes);          static size_t read_post(SAPI_Info& info, char *buf, size_t max_bytes);
         /// add response header attribute [but do not send it to client]          /// add response header attribute [but do not send it to client]
         static void add_header_attribute(Pool& pool, const char *key, const char *value);          static void add_header_attribute(SAPI_Info& info, const char* dont_store_key, const char* dont_store_value);
         /// send collected header attributes to client          /// send collected header attributes to client
         static void send_header(Pool& pool);          static void send_header(SAPI_Info& info);
         /// output body bytes          /// output body bytes
         static void send_body(Pool& pool, const void *buf, size_t size);          static size_t send_body(SAPI_Info& info, const void *buf, size_t size);
   
           static void send_error(SAPI_Info& info, const char *exception_cstr, const char *status = "500"){
                   // capitalized headers passed for preventing malloc during capitalization
                   add_header_attribute(info, HTTP_STATUS_CAPITALIZED, status);
                   add_header_attribute(info, HTTP_CONTENT_TYPE_CAPITALIZED, "text/plain");
                   send_header(info);
                   send_body(info, exception_cstr, strlen(exception_cstr));
           }
   
           class Env {
           public:
                   /// entire environment
                   static const char* const* get(SAPI_Info& ainfo);
                   /// single environment string
                   static char* get(SAPI_Info& ainfo, const char* name);
                   static bool set(SAPI_Info& ainfo, const char* name, const char* value);
   
                   class Iterator {
                   private:
                           const char* const* pairs;
                           const char* pair;
                           const char* eq_at;
                   public:
                           Iterator(SAPI_Info& asapi_info) : pair(NULL), eq_at(NULL){
                                   if(pairs=SAPI::Env::get(asapi_info))
                                           next();
                           }
                           operator bool () {
                                   return pair!=0;
                           }
                           void next() {
                                   while(pair=*pairs++)
                                           if(eq_at=strchr(pair, '=')) // valid pair (key=value)
                                                   if(eq_at[1]) // value is not empty
                                                           break;
                           }
                           char* key(){
                                   return pa_strdup(pair, eq_at-pair);
                           }
                           char* value(){
                                   return pa_strdup(eq_at+1);
                           }
                   };
           };
 };  };
   
 #endif  #endif
Removed from v.1.18  
changed lines
  Added in v.1.36

E-mail: