src/client_side_request.h

   1
   2 /*
   3  * $Id: client_side_request.h,v 1.37 2008/02/12 23:07:52 rousskov Exp $
   4  *
   5  *
   6  * SQUID Web Proxy Cache          http://www.squid-cache.org/
   7  * ----------------------------------------------------------
   8  *
   9  *  Squid is the result of efforts by numerous individuals from
  10  *  the Internet community; see the CONTRIBUTORS file for full
  11  *  details.   Many organizations have provided support for Squid's
  12  *  development; see the SPONSORS file for full details.  Squid is
  13  *  Copyrighted (C) 2001 by the Regents of the University of
  14  *  California; see the COPYRIGHT file for full details.  Squid
  15  *  incorporates software developed and/or copyrighted by other
  16  *  sources; see the CREDITS file for full details.
  17  *
  18  *  This program is free software; you can redistribute it and/or modify
  19  *  it under the terms of the GNU General Public License as published by
  20  *  the Free Software Foundation; either version 2 of the License, or
  21  *  (at your option) any later version.
  22  *
  23  *  This program is distributed in the hope that it will be useful,
  24  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  25  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  26  *  GNU General Public License for more details.
  27  *
  28  *  You should have received a copy of the GNU General Public License
  29  *  along with this program; if not, write to the Free Software
  30  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
  31  *
  32  */
  33
  34
  35 #ifndef SQUID_CLIENTSIDEREQUEST_H
  36 #define SQUID_CLIENTSIDEREQUEST_H
  37
  38 #include "squid.h"
  39 #include "HttpHeader.h"
  40 #include "clientStream.h"
  41 #include "client_side.h"
  42 #include "AccessLogEntry.h"
  43 #include "dlink.h"
  44 #include "ICAP/AsyncJob.h"
  45
  46 #if USE_ADAPTATION
  47 #include "adaptation/forward.h"
  48 #include "adaptation/Initiator.h"
  49
  50 class HttpMsg;
  51 #endif
  52
  53 /* client_side_request.c - client side request related routines (pure logic) */
  54 extern int clientBeginRequest(const HttpRequestMethod&, char const *, CSCB *, CSD *, ClientStreamData, HttpHeader const *, char *, size_t);
  55
  56 class MemObject;
  57
  58 class ConnStateData;
  59
  60 class ClientRequestContext;
  61
  62 class ClientHttpRequest
  63 #if USE_ADAPTATION
  64     : public Adaptation::Initiator, // to start adaptation transactions
  65     public BodyConsumer     // to receive reply bodies in request satisf. mode
  66 #endif
  67 {
  68
  69 public:
  70     void *operator new (size_t);
  71     void operator delete (void *);
  72 #if USE_ADAPTATION
  73     void *toCbdata() { return this; }
  74 #endif
  75     ClientHttpRequest(ConnStateData *);
  76     ~ClientHttpRequest();
  77     /* Not implemented - present to prevent synthetic operations */
  78     ClientHttpRequest(ClientHttpRequest const &);
  79     ClientHttpRequest& operator=(ClientHttpRequest const &);
  80
  81     String rangeBoundaryStr() const;
  82     void freeResources();
  83     void updateCounters();
  84     void logRequest();
  85     _SQUID_INLINE_ MemObject * memObject() const;
  86     bool multipartRangeRequest() const;
  87     void processRequest();
  88     void httpStart();
  89     bool onlyIfCached()const;
  90     bool gotEnough() const;
  91     _SQUID_INLINE_ StoreEntry *storeEntry() const;
  92     void storeEntry(StoreEntry *);
  93     _SQUID_INLINE_ StoreEntry *loggingEntry() const;
  94     void loggingEntry(StoreEntry *);
  95
  96     _SQUID_INLINE_ ConnStateData * getConn();
  97     _SQUID_INLINE_ ConnStateData * const getConn() const;
  98     _SQUID_INLINE_ void setConn(ConnStateData *);
  99     HttpRequest *request;               /* Parsed URL ... */
 100     char *uri;
 101     char *log_uri;
 102
 103     struct
 104     {
 105         int64_t offset;
 106         int64_t size;
 107         size_t headers_sz;
 108     } out;
 109
 110     HttpHdrRangeIter range_iter;        /* data for iterating thru range specs */
 111     size_t req_sz;              /* raw request size on input, not current request size */
 112     log_type logType;
 113
 114     struct timeval start_time;
 115     AccessLogEntry al;
 116
 117     struct
 118     {
 119         unsigned int accel:1;
 120         unsigned int intercepted:1;
 121         unsigned int spoof_client_ip:1;
 122         unsigned int internal:1;
 123         unsigned int done_copying:1;
 124         unsigned int purging:1;
 125     } flags;
 126
 127     struct
 128     {
 129         http_status status;
 130         char *location;
 131     } redirect;
 132
 133     dlink_node active;
 134     dlink_list client_stream;
 135     int mRangeCLen();
 136
 137     ClientRequestContext *calloutContext;
 138     void doCallouts();
 139
 140 #if USE_ADAPTATION
 141     // AsyncJob virtual methods
 142     virtual bool doneAll() const { return Initiator::doneAll() &&
 143                                        BodyConsumer::doneAll() && false;}
 144 #endif
 145
 146 private:
 147     CBDATA_CLASS(ClientHttpRequest);
 148     int64_t maxReplyBodySize_;
 149     StoreEntry *entry_;
 150     StoreEntry *loggingEntry_;
 151     ConnStateData * conn_;
 152
 153 #if USE_SSL
 154 public:
 155     bool sslBumpNeeded() const;
 156     void sslBumpStart();
 157     void sslBumpEstablish(comm_err_t errflag);
 158 #endif
 159
 160 #if USE_ADAPTATION
 161
 162 public:
 163     bool startAdaptation(Adaptation::ServicePointer);
 164
 165     // private but exposed for ClientRequestContext
 166     void handleAdaptationFailure(bool bypassable = false);
 167
 168 private:
 169     // Adaptation::Initiator API
 170     virtual void noteAdaptationAnswer(HttpMsg *message);
 171     virtual void noteAdaptationQueryAbort(bool final);
 172
 173     // BodyConsumer API, called by BodyPipe
 174     virtual void noteMoreBodyDataAvailable(BodyPipe::Pointer);
 175     virtual void noteBodyProductionEnded(BodyPipe::Pointer);
 176     virtual void noteBodyProducerAborted(BodyPipe::Pointer);
 177
 178     void endRequestSatisfaction();
 179
 180 private:
 181     Adaptation::Initiate *virginHeadSource;
 182     BodyPipe::Pointer adaptedBodySource;
 183
 184     bool request_satisfaction_mode;
 185     int64_t request_satisfaction_offset;
 186 #endif
 187 };
 188
 189 /* client http based routines */
 190 SQUIDCEXTERN char *clientConstructTraceEcho(ClientHttpRequest *);
 191 SQUIDCEXTERN ACLChecklist *clientAclChecklistCreate(const acl_access * acl,ClientHttpRequest * http);
 192 SQUIDCEXTERN int clientHttpRequestStatus(int fd, ClientHttpRequest const *http);
 193 SQUIDCEXTERN void clientAccessCheck(ClientHttpRequest *);
 194
 195 /* ones that should be elsewhere */
 196 SQUIDCEXTERN void redirectStart(ClientHttpRequest *, RH *, void *);
 197
 198 SQUIDCEXTERN void tunnelStart(ClientHttpRequest *, int64_t *, int *);
 199
 200 #ifdef _USE_INLINE_
 201 #include "Store.h"
 202 #include "client_side_request.cci"
 203 #endif
 204
 205 #endif /* SQUID_CLIENTSIDEREQUEST_H */