6 * SQUID Web Proxy Cache http://www.squid-cache.org/
7 * ----------------------------------------------------------
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.
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.
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.
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.
34 #ifndef SQUID_ICAPLAUNCHER_H
35 #define SQUID_ICAPLAUNCHER_H
37 #include "adaptation/Initiator.h"
38 #include "adaptation/Initiate.h"
39 #include "adaptation/icap/ServiceRep.h"
42 * The ICAP Launcher starts an ICAP transaction. If the transaction fails
43 * due to what looks like a persistent connection race condition, the launcher
44 * starts a new ICAP transaction using a freshly opened connection.
46 * ICAPLauncher and one or more ICAP transactions initiated by it form an
49 * An ICAP Initiator deals with the ICAP Launcher and not an individual ICAP
50 * transaction because the latter may disappear and be replaced by another
53 * Specific ICAP launchers implement the createXaction() method to create
54 * REQMOD, RESPMOD, or OPTIONS transaction from initiator-supplied data.
56 * TODO: This class might be the right place to initiate ICAP ACL checks or
57 * implement more sophisticated ICAP transaction handling like chaining of
70 // Note: Initiate must be the first parent for cbdata to work. We use
71 // a temporary InitaitorHolder/toCbdata hacks and do not call cbdata
72 // operations on the initiator directly.
73 class Launcher
: public Adaptation::Initiate
, public Adaptation::Initiator
76 Launcher(const char *aTypeName
, Adaptation::Initiator
*anInitiator
, Adaptation::ServicePointer
&aService
);
79 // Adaptation::Initiate: asynchronous communication with the initiator
80 void noteInitiatorAborted();
82 // Adaptation::Initiator: asynchronous communication with the current transaction
83 virtual void noteAdaptationAnswer(HttpMsg
*message
);
84 virtual void noteXactAbort(XactAbortInfo
&info
);
87 bool canRetry(XactAbortInfo
&info
) const; //< true if can retry in the case of persistent connection failures
88 bool canRepeat(XactAbortInfo
&info
) const; //< true if can repeat in the case of no or unsatisfactory response
89 virtual void noteAdaptationQueryAbort(bool final
);
92 // Adaptation::Initiate API implementation
94 virtual bool doneAll() const;
95 virtual void swanSong();
97 // creates the right ICAP transaction using stored configuration params
98 virtual Xaction
*createXaction() = 0;
100 void launchXaction(const char *xkind
);
102 Adaptation::ServicePointer theService
; ///< ICAP service for all launches
103 Adaptation::Initiate
*theXaction
; ///< current ICAP transaction
104 int theLaunches
; // the number of transaction launches
107 /// helper class to pass information about aborted ICAP requests to
108 /// the Adaptation::Icap::Launcher class
112 XactAbortInfo(HttpRequest
*anIcapRequest
, HttpReply
*anIcapReply
,
113 bool beRetriable
, bool beRepeatable
);
114 XactAbortInfo(const XactAbortInfo
&);
117 HttpRequest
*icapRequest
;
118 HttpReply
*icapReply
;
123 XactAbortInfo
&operator =(const XactAbortInfo
&); // undefined
126 /* required by UnaryMemFunT */
127 inline std::ostream
&operator << (std::ostream
&os
, Adaptation::Icap::XactAbortInfo info
)
129 // Nothing, it is unused
133 /// A Dialer class used to schedule the Adaptation::Icap::Launcher::noteXactAbort call
134 class XactAbortCall
: public UnaryMemFunT
<Adaptation::Icap::Launcher
, Adaptation::Icap::XactAbortInfo
>
137 typedef void (Adaptation::Icap::Launcher::*DialMethod
)(Adaptation::Icap::XactAbortInfo
&);
138 XactAbortCall(Adaptation::Icap::Launcher
*launcer
, DialMethod aMethod
,
139 const Adaptation::Icap::XactAbortInfo
&info
):
140 UnaryMemFunT
<Adaptation::Icap::Launcher
, Adaptation::Icap::XactAbortInfo
>(launcer
, NULL
, info
),
141 dialMethod(aMethod
) {}
142 virtual void print(std::ostream
&os
) const { os
<< '(' << "retriable:" << arg1
.isRetriable
<< ", repeatable:" << arg1
.isRepeatable
<< ')'; }
145 DialMethod dialMethod
;
148 virtual void doDial() { (object
->*dialMethod
)(arg1
); }
152 } // namespace Adaptation
155 #endif /* SQUID_ICAPLAUNCHER_H */