Oat++ is a modern Web Framework for C++. It's fully loaded and contains all necessary components for effective production level development. It's also light and has a small memory footprint.

1079 Angajamente

7 Ramuri

17 Variante

lganzzzo 8a5ad5c88b memory pools: Remove std::call_once.		3 ani în urmă
.github	b4cb11c74c Create FUNDING.yml	3 ani în urmă
changelog	a23532f937 Update 1.2.0.md	3 ani în urmă
cmake	c85dae66ac update installation scripts	5 ani în urmă
src	8a5ad5c88b memory pools: Remove std::call_once.	3 ani în urmă
test	222cdaaa91 Tests: Uncomment all tests.	3 ani în urmă
utility	cc90da292c better cmake scripts	5 ani în urmă
.gitignore	8a5ad5c88b memory pools: Remove std::call_once.	3 ani în urmă
CMakeLists.txt	24c18ad166 CMakeLists.txt. Add compat option 'OATPP_COMPAT_BUILD_NO_SET_AFFINITY'	4 ani în urmă
CODE_OF_CONDUCT.md	19fae6a0bf Create CODE_OF_CONDUCT.md	5 ani în urmă
CONTRIBUTING.md	89980778ea Fix typos	5 ani în urmă
LICENSE	8914b7d695 Initial commit	6 ani în urmă
README.md	4f1b5fcb34 Update README.md	3 ani în urmă
azure-pipelines.yml	cae4fdf2c0 CI. Fix Build name.	4 ani în urmă
lgtm.yml	6d6af2c0c3 fixing lgtm.yml	5 ani în urmă

Oat++

Attention

Version 1.2.0 is now merged to Master and soon will receive a release tag. Get ready to migrate - see the changelog for details.
To checkout the latest 1.1.0 code use this commit - e577681355ca652f317867c609e07cefabc37c0a

Oat++ is a modern Web Framework for C++. It's fully loaded and contains all necessary components for effective production level development. It's also light and has a small memory footprint.

Start

About

Join Our Community

Chat on Gitter. Oat++ framework/Lobby
Follow us on Twitter for latest news. @oatpp_io
Join community on Reddit. r/oatpp

High Level Overview

API Controller And Request Mapping
Swagger-UI Annotations
- Additional Endpoint Info
API Client - Retrofit / Feign Like Client
- Declare Client
- Using API Client
Object Mapping
- Declare DTO
- Serialize DTO Using ObjectMapper

API Controller And Request Mapping

For more info see Api Controller

Declare Endpoint

ENDPOINT("PUT", "/users/{userId}", putUser,
         PATH(Int64, userId),
         BODY_DTO(Object<UserDto>, userDto)) 
{
  userDto->id = userId;
  return createDtoResponse(Status::CODE_200, m_database->updateUser(userDto));
}

Add CORS for Endpoint

For more info see Api Controller / CORS

ADD_CORS(putUser)
ENDPOINT("PUT", "/users/{userId}", putUser,
         PATH(Int64, userId),
         BODY_DTO(Object<UserDto>, userDto)) 
{
  userDto->id = userId;
  return createDtoResponse(Status::CODE_200, m_database->updateUser(userDto));
}

Endpoint with Authorization

For more info see Api Controller / Authorization

using namespace oatpp::web::server::handler;
  
ENDPOINT("PUT", "/users/{userId}", putUser,
         AUTHORIZATION(std::shared_ptr<DefaultBasicAuthorizationObject>, authObject),
         PATH(Int64, userId),
         BODY_DTO(Object<UserDto>, userDto)) 
{
  OATPP_ASSERT_HTTP(authObject->userId == "Ivan" && authObject->password == "admin", Status::CODE_401, "Unauthorized");
  userDto->id = userId;
  return createDtoResponse(Status::CODE_200, m_database->updateUser(userDto));
}

Swagger-UI Annotations

For more info see Endpoint Annotation And API Documentation

Additional Endpoint Info

ENDPOINT_INFO(putUser) {
  // general
  info->summary = "Update User by userId";
  info->addConsumes<Object<UserDto>>("application/json");
  info->addResponse<Object<UserDto>>(Status::CODE_200, "application/json");
  info->addResponse<String>(Status::CODE_404, "text/plain");
  // params specific
  info->pathParams["userId"].description = "User Identifier";
}
ENDPOINT("PUT", "/users/{userId}", putUser,
         PATH(Int64, userId),
         BODY_DTO(Object<UserDto>, userDto)) 
{
  userDto->id = userId;
  return createDtoResponse(Status::CODE_200, m_database->updateUser(userDto));
}

API Client - Retrofit / Feign Like Client

For more info see Api Client

Declare Client

class UserService : public oatpp::web::client::ApiClient {
public:

  API_CLIENT_INIT(UserService)

  API_CALL("GET", "/users", getUsers)
  API_CALL("GET", "/users/{userId}", getUserById, PATH(Int64, userId))

};

Using API Client

auto response = userService->getUserById(id);
auto user = response->readBodyToDto<oatpp::Object<UserDto>>(objectMapper);

Object Mapping

For more info see Data Transfer Object (DTO).

Declare DTO

class UserDto : public oatpp::DTO {

  DTO_INIT(UserDto, DTO)

  DTO_FIELD(Int64, id);
  DTO_FIELD(String, name);

};

Serialize DTO Using ObjectMapper

using namespace oatpp::parser::json::mapping;

auto user = UserDto::createShared();
user->id = 1;
user->name = "Ivan";

auto objectMapper = ObjectMapper::createShared();
auto json = objectMapper->writeToString(user);

Output:

{
  "id": 1,
  "name": "Ivan"
}

Serialize/Deserialize Data In Free Form

While DTO objects apply strict rules on data ser/de, you can also serialize/deserialize data in free form using type oatpp::Any.

oatpp::Fields<oatpp::Any> map = {
  {"title", oatpp::String("Hello Any!")},
  {"listOfAny",
   oatpp::List<oatpp::Any>({
     oatpp::Int32(32),
     oatpp::Float32(0.32),
     oatpp::Boolean(true)
   })
  }
};

auto json = mapper->writeToString(map);