/* * Copyright (C) 1996-2023 The Squid Software Foundation and contributors * * Squid software is distributed under GPLv2+ license and includes * contributions from numerous individuals and organizations. * Please see the COPYING and CONTRIBUTORS files for details. */ #ifndef SQUID_ACLSTRATEGISED_H #define SQUID_ACLSTRATEGISED_H #include "acl/Acl.h" #include "acl/Data.h" #include "acl/FilledChecklist.h" #include "acl/Strategy.h" // XXX: Replace with a much simpler abstract ACL child class without the // ACLStrategy parameter (and associated call forwarding). Duplicating key // portions of the ACL class API in ACLStrategy is not needed because // ACLStrategy is unused outside the ACLStrategised context. Existing classes // like ACLExtUser, ACLProxyAuth, and ACLIdent seem to confirm this assertion. // It also requires forwarding ACL info to ACLStrategy as method parameters. /// Splits the ACL API into two individually configurable components: /// * ACLStrategy that usually extracts information from the current transaction /// * ACLData that usually matches information against admin-configured values template class ACLStrategised : public ACL { MEMPROXY_CLASS(ACLStrategised); public: typedef M MatchType; ~ACLStrategised(); ACLStrategised(ACLData *, ACLStrategy *, char const *); ACLStrategised(ACLStrategised const &&) = delete; virtual char const *typeString() const; virtual void parseFlags(); virtual bool requiresRequest() const {return matcher->requiresRequest();} virtual bool requiresReply() const {return matcher->requiresReply();} virtual void prepareForUse() { data->prepareForUse();} virtual const Acl::Options &options() { return matcher->options(); } virtual void parse(); virtual int match(ACLChecklist *checklist); virtual int match (M const &); virtual SBufList dump() const; virtual bool empty () const; virtual bool valid () const; private: ACLData *data; char const *type_; ACLStrategy *matcher; }; /* implementation follows */ template ACLStrategised::~ACLStrategised() { delete data; delete matcher; } template ACLStrategised::ACLStrategised(ACLData *newData, ACLStrategy *theStrategy, char const *theType): data(newData), type_(theType), matcher(theStrategy) {} template char const * ACLStrategised::typeString() const { return type_; } template void ACLStrategised::parseFlags() { ParseFlags(options(), data->supportedFlags()); } template void ACLStrategised::parse() { data->parse(); } template bool ACLStrategised::empty() const { return data->empty(); } template int ACLStrategised::match(ACLChecklist *cl) { ACLFilledChecklist *checklist = dynamic_cast(cl); assert(checklist); return matcher->match(data, checklist); } template int ACLStrategised::match(MatchType const &toFind) { return data->match(toFind); } template SBufList ACLStrategised::dump() const { return data->dump(); } template bool ACLStrategised::valid () const { return matcher->valid(); } #endif /* SQUID_ACLSTRATEGISED_H */