OpenApiGenerator.h

/*
╔══════════════════════════════════════════════════════════════════════════════╗
║                       SIMPLY POWERFUL TOOLKIT (SPTK)                         ║
╟──────────────────────────────────────────────────────────────────────────────╢
║  copyright            © 1999-2022 Alexey Parshin. All rights reserved.       ║
║  email                alexeyp@gmail.com                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝
┌──────────────────────────────────────────────────────────────────────────────┐
│   This library is free software; you can redistribute it and/or modify it    │
│   under the terms of the GNU Library General Public License as published by  │
│   the Free Software Foundation; either version 2 of the License, or (at your │
│   option) any later version.                                                 │
│                                                                              │
│   This library is distributed in the hope that it will be useful, but        │
│   WITHOUT ANY WARRANTY; without even the implied warranty of                 │
│   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library   │
│   General Public License for more details.                                   │
│                                                                              │
│   You should have received a copy of the GNU Library General Public License  │
│   along with this library; if not, write to the Free Software Foundation,    │
│   Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.               │
│                                                                              │
│   Please report all bugs and problems to alexeyp@gmail.com.                  │
└──────────────────────────────────────────────────────────────────────────────┘
*/
 
#pragma once
 
#include <sptk5/wsdl/WSOperation.h>
#include <sptk5/xdoc/Document.h>
 
namespace sptk {
 
class SP_EXPORT OpenApiGenerator
{
public:
 
    enum class AuthMethod
        : uint8_t
    {
        NONE,        
        BASIC,       
        BEARER       
    };
 
    struct Options
    {
        AuthMethod defaultAuthMethod {AuthMethod::BEARER};
 
        std::map<String, AuthMethod> operationsAuth;
 
        String openApiFile;
    };
 
    OpenApiGenerator(const String& title, const String& description, const String& version,
                     const Strings& servers, const Options& options);
 
    void generate(std::ostream& output, const WSOperationMap& operations, const WSComplexTypeMap& complexTypes,
                  const std::map<String, String>& documentation) const;
 
    static AuthMethod authMethod(const String& auth);
 
    static String authMethodName(AuthMethod auth);
 
private:
 
    void createComponents(xdoc::Document& document, const WSComplexTypeMap& complexTypes) const;
 
    void createPaths(xdoc::Document& document, const WSOperationMap& operations,
                     const std::map<String, String>& documentation) const;
 
    void createServers(xdoc::Document& document) const;
 
    const String m_title;          
    const String m_description;    
    const String m_version;        
    const Strings m_servers;        
    const Options m_options;        
 
    void parseClassName(const SWSParserComplexType& ctypeProperty, const xdoc::SNode& property) const;
 
    void parseRestriction(const SWSParserComplexType& ctypeProperty, const xdoc::SNode& property) const;
 
    void parseRestrictionPatterns(const xdoc::SNode& property, const SWSRestriction& restriction) const;
};
 
}