forked from loafle/openapi-generator-original
fde8c772fb
* [BUG] [C++][Pistache] cpp-pistache-server generating API include undefined "Object.h" (#2769) Should handle Object.h, AnyType.h correctly. Set.h also tested. - #include Object.h removed and replaced by a typeMapping.put(object, nlohmann::json) like suggested in other issues - object had an invalid syntax: ':' instead of '::' in types with namespace - extra include of #include nlohmann/json.h removed when there's already #include <nlohmann/json.hpp> - nlohmann::json is excluded from model namespace Tested with custom petstore played, with suggested openapi specs coming from issues #2769, #10266, #14234 ```bash rm -rf samples/server/petstore/cpp-pistache-everything/ && ./bin/generate-samples.sh ./bin/configs/cpp-pistache-server-cpp-pistache-everything.yaml && cd samples/server/petstore/cpp-pistache-everything/ && mkdir build && cd build && cmake .. && cmake --build . --parallel ``` * - Adding to samples/server/petstore cpp-pistache-everything * - .md and FILES missing
49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
# REST API Server for OpenAPI Petstore
|
|
|
|
## Overview
|
|
This API Server was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.
|
|
It uses the [Pistache](https://github.com/oktal/pistache) Framework.
|
|
|
|
## Files organization
|
|
The Pistache C++ REST server generator creates three folders:
|
|
- `api`: This folder contains the handlers for each method specified in the OpenAPI definition. Every handler extracts
|
|
the path and body parameters (if any) from the requests and tries to parse and possibly validate them.
|
|
Once this step is completed, the main API class calls the corresponding abstract method that should be implemented
|
|
by the developer (a basic implementation is provided under the `impl` folder)
|
|
- `impl`: As written above, the implementation folder contains, for each API, the corresponding implementation class,
|
|
which extends the main API class and implements the abstract methods.
|
|
Every method receives the path and body parameters as constant reference variables and a reference to the response
|
|
object, that should be filled with the right response and sent at the end of the method with the command:
|
|
response.send(returnCode, responseBody, [mimeType])
|
|
- `model`: This folder contains the corresponding class for every object schema found in the OpenAPI specification.
|
|
|
|
The main folder contains also a file with a main that can be used to start the server.
|
|
Of course, is you should customize this file based on your needs
|
|
|
|
## Installation
|
|
First of all, you need to download and install the libraries listed [here](#libraries-required).
|
|
|
|
Once the libraries are installed, in order to compile and run the server please follow the steps below:
|
|
```bash
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
```
|
|
|
|
Once compiled run the server:
|
|
|
|
```bash
|
|
cd build
|
|
./api-server
|
|
```
|
|
|
|
## Libraries required
|
|
- [pistache](http://pistache.io/quickstart)
|
|
- [JSON for Modern C++](https://github.com/nlohmann/json/#integration): Please download the `json.hpp` file and
|
|
put it under the model/nlohmann folder
|
|
|
|
## Namespaces
|
|
org.openapitools.server.api
|
|
org.openapitools.server.model
|