E-MailRelay
gverifierfactorybase.h
Go to the documentation of this file.
1//
2// Copyright (C) 2001-2023 Graeme Walker <graeme_walker@users.sourceforge.net>
3//
4// This program is free software: you can redistribute it and/or modify
5// it under the terms of the GNU General Public License as published by
6// the Free Software Foundation, either version 3 of the License, or
7// (at your option) any later version.
8//
9// This program is distributed in the hope that it will be useful,
10// but WITHOUT ANY WARRANTY; without even the implied warranty of
11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12// GNU General Public License for more details.
13//
14// You should have received a copy of the GNU General Public License
15// along with this program. If not, see <http://www.gnu.org/licenses/>.
16// ===
17///
18/// \file gverifierfactorybase.h
19///
20
21#ifndef G_SMTP_VERIFIER_FACTORY_BASE_H
22#define G_SMTP_VERIFIER_FACTORY_BASE_H
23
24#include "gdef.h"
25#include "gverifier.h"
26#include "gexceptionsink.h"
27#include <string>
28#include <utility>
29#include <memory>
30
31namespace GSmtp
32{
33 class VerifierFactoryBase ;
34}
35
36//| \class GSmtp::VerifierFactoryBase
37/// A factory interface for addresss verifiers.
38///
40{
41public:
42 struct Spec /// Verifier specification tuple for GSmtp::VerifierFactoryBase::newVerifier().
43 {
44 Spec() ;
45 Spec( const std::string & , const std::string & ) ;
46 std::string first ; // "exit", "file", "net", empty on error
47 std::string second ; // reason on error, or eg. "/bin/a" if "file"
48 } ;
49
50 virtual std::unique_ptr<Verifier> newVerifier( GNet::ExceptionSink ,
51 const Verifier::Config & config , const Spec & spec ) = 0 ;
52 ///< Returns a Verifier on the heap. Throws if an invalid
53 ///< or unsupported specification.
54
55 virtual ~VerifierFactoryBase() = default ;
56 ///< Destructor.
57} ;
58
59#endif
A tuple containing an ExceptionHandler interface pointer and a bound 'exception source' pointer.
A factory interface for addresss verifiers.
virtual ~VerifierFactoryBase()=default
Destructor.
virtual std::unique_ptr< Verifier > newVerifier(GNet::ExceptionSink, const Verifier::Config &config, const Spec &spec)=0
Returns a Verifier on the heap.
SMTP classes.
Definition: gadminserver.h:42
Verifier specification tuple for GSmtp::VerifierFactoryBase::newVerifier().
Configuration passed to address verifier constructors.
Definition: gverifier.h:55