将 C++ 嵌套类分离到它们自己的头文件中

Question

刚接触这个网站和 C++，但希望得到大家的指导。

我有一个非常有趣的项目想法来学习 C++ 深入挖掘 API、类、引用等，目前我有一个工作示例代码，其中所有内容都存在于 main.cpp 文件中。我面临的问题是，当我将类（内部和外部）移动到它们各自的头文件时，代码不再编译。

嵌套类的原因是 OuterAPI 作为 API 的主要入口点，并且有许多较低级别的 API，然后可以在其下访问（人员、许可证、角色等）。这样，API 用户只需为 OuterAPI 创建一个对象，然后为底层资源和方法创建点符号。

这是 main.cpp 中的工作示例

#include <iostream>
#include <nlohmann/json.hpp>
#include <cpr/cpr.h>
using json = nlohmann::json;

class OuterAPI {
private:
    class InnerAPI {
    private:
        OuterAPI& api;
    public:
        InnerAPI(OuterAPI& a) :api(a) {}
        json get() {
            cpr::Response r = cpr::Get(
                cpr::Url{ api.baseUrl + "resource" },
                cpr::Bearer{ api.token }
            );
            return json::parse(r.text)
    };

    std::string token;
    std::string baseUrl = "";
public:
    InnerAPI people;
    OuterAPI(std::string t) : token(t), people(*this) {}
};

int main(int argc, char** argv)
{
    std::string token = "";
    OuterAPI api(token);
    json jsonData = api.people.get();
    std::cout << jsonData.dump(4) << std::endl;

    return 0;
}

这是我将所有内容移至相应的头文件/cpp 文件

OuterAPI.h

#pragma once

class OuterAPI {
private:
    class InnerAPI;
    std::string token;
    std::string baseUrl = "";
public:
    OuterAPI(std::string t);
    ~OuterAPI();
    InnerAPI* people;
};

外部API.cpp

#include "WebexAPI.h"
#include "PeopleAPI.h"

OuterAPI::OuterAPI(std::string t) : token(t) {
    people = new InnerAPI(*this);
}

OuterAPI::~OuterAPI() { delete people; }

InnerAPI.h

#pragma once

#include <nlohmann/json.hpp>
#include <cpr/cpr.h>
#include "OuterAPI.h"

using json = nlohmann::json;

class OuterAPI::InnerAPI {
private:
    OuterAPI& api;
public:
    InnerAPI(OuterAPI& a);
    json get();
};

InnerAPI.cpp

#include "InnerAPI.h"

OuterAPI::InnerAPI::InnerAPI(OuterAPI& a) : api(a) {}

json OuterAPI::InnerAPI::get() {
    cpr::Response r = cpr::Get(
        cpr::Url{ api.baseUrl + "resource" },
        cpr::Bearer{ api.token }
    );
    return json::parse(r.text);

main.cpp (finally) - 这是在 api.people.get() "expression must have class type but has type "OuterAPI::InnerAPI *" 处发生编译器错误的地方

int main(int argc, char** argv)
{
    std::string token = "";
    OuterAPI api(token);
    json jsonData = api.people.get();     // COMPILER ERROR "expression must have class type but has type "OuterAPI::InnerAPI *"
    std::cout << jsonData.dump(4) << std::endl;

    return 0;
}

据此，我认为问题与我必须将 InnerAPI 对象 people 定义为 OuterAPI 内部的指针有关，但从这里我似乎无法解决。

另外，请随时批评我的设计，就像我说我是 C++ 新手，所以想确保我能做好。谢谢。

Answer 1

在OuterAPI* 中，您已将people 声明为InnerAPI* 类型的成员。

您可以使用api.people->get() 调用您的API，也可以将成员设为InnerAPI。

编辑：

似乎除了指针之外的错误来自您处理文件包含的方式。我设法得到了working version on REPL.it。我做了一些细微的调整，这样我就不必把两个库都集中在它的要点上。这里是：

OuterAPI.h

#pragma once

#include <string>

class OuterAPI {
private:
    class InnerAPI;
    std::string token;
    std::string baseUrl = "";
public:
    OuterAPI(std::string t);
    ~OuterAPI();
    InnerAPI* people;
};

InnerAPI.j

#pragma once

#include "./OuterAPI.h"

class OuterAPI::InnerAPI {
private:
    OuterAPI& api;
public:
    InnerAPI(OuterAPI& a);
    std::string get();
};

外部API.cpp

#include "./OuterAPI.h"
#include "./InnerAPI.h"

OuterAPI::OuterAPI(std::string t) : token(t) {
    people = new InnerAPI(*this);
}

OuterAPI::~OuterAPI() { delete people; }

InnerAPI.cpp

#include "./OuterAPI.h"
#include "./InnerAPI.h"

OuterAPI::InnerAPI::InnerAPI(OuterAPI& a) : api(a) {}

std::string OuterAPI::InnerAPI::get() {
    return api.baseUrl + "resource";
}

Answer 2

确保在您打算这样做的每个文件中都包含您打算使用的所有内容。
将声明和定义分开是很常见的。
这是一种减少大型项目编译时间的方法。
谢天谢地，modules 很快就会™ 让链接成为过去。

要解决错误消息：您将people 声明为OuterAPI 类的原始成员指针...您无法通过使用operator . 的指针访问成员，您需要使用operator ->。