#pragma once #include #include "bank.hpp" using namespace drogon; #define req_args const HttpRequestPtr &req, std::function &&callback #define JSON(V) callback(HttpResponse::newHttpJsonResponse(JsonReturn(V))); #define INLINE __attribute__((always_inline)) inline #define GEN_BODY \ const auto temp_req = req->getJsonObject(); \ const auto body = temp_req ? *temp_req : Json::Value(); #define PASS_HEADER std::string pass = req->getHeader("Password"); template INLINE Json::Value JsonReturn(T &&val) { Json::Value res; if constexpr (std::is_same_v) { res["value"] = (int)val; //becuase of json lib interpreting 67 as 'A' for example } else if constexpr (std::is_same_v) { res["value"] = (Json::Int64)val; } else { res["value"] = val; } return res; } class BankF : public HttpController { public: void Help(req_args) const { auto resp = HttpResponse::newHttpResponse(); auto handlerInfo = app().getHandlersInfo(); resp->setBody("

Error Responses

# meaning
-1 UserNotFound
-2 WrongPassword
-3 InvalidRequest
-4 WrongAdminPassword
-5 NameTooLong
-6 UserAlreadyExists
-7 InsufficientFunds

Things of Note

  • all endpoints respond with JSON file type
  • "A" denotes requiring Authentication in the form of a header titled "Password"

Usage

Name Path Method A Description
GetBal /{name}/bal GET true returns the balance of a given user {name}
GetLog /{name}/log GET true returns a list of last n number of transactions (a configurable amount) of a given user {name}
SendFunds /{name}/send/{to}/amount={amount} POST false sends {amount} from user {name} to user {to}
VerifyPassword /{name}/pass/verify GET true returns true or false depending on if the supplied user {name}'s password matches the password supplied in the header

Meta Usage

Name Path Method A Description
ChangePassword /{name}/pass/change PATCH true if the password supplied in the header matches the user {name}'s password, the user’s password is changed to the one given in the body
SetBal /admin/{name}/bal/amount={amount} PATCH true sets the balance of a give user {name} if the supplied password matches the admin password

System Usage

Name Path Method A Description
Help /help GET false the page you’re looking at right now!
Close /admin/close POST true saves and then closes the program if the supplied password matches the admin password
Contains /contains/{name} GET false returns true or false depending on if the supplied user {name} exists
AdminVerifyPass /admin/verify GET true returns true or false depending on if the password supplied in the header matches the admin password

User Management

Name Path Method A Description
AddUser /user/{name} POST true registers a user with the name {name}, balance of 0 and a password of the password supplied in the header
AdminAddUser /admin/user/{name}?init_bal={init_bal} POST true if the password supplied in the header matches the admin password, then it registers a user with the name {name}, balance of init_bal and a password supplied by the body of the request
DelUser /user/{name} DELETE true if the password supplied in the header matches the user {name}'s password, then the user is deleted
AdminDelUser /admin/user/{name} DELETE true if the password supplied in the header matches the admin password, then the user is deleted
"); resp->setExpiredTime(0); callback(resp); } void Close(req_args) const { PASS_HEADER bool res; if (pass == bank.admin_pass) { bank.Save(); res = true; app().quit(); } else { res = false; } JSON(res); } void AddUser(req_args, std::string &&name) const { PASS_HEADER JSON(bank.AddUser(std::move(name), std::move(pass))); } void AdminAddUser(req_args, std::string &&name, uint32_t init_bal) const { PASS_HEADER JSON(bank.AdminAddUser(pass, std::move(name), init_bal, std::string(req->getBody()))); } void DelUser(req_args, const std::string &name) const { PASS_HEADER JSON(bank.DelUser(name, pass)); } void AdminDelUser(req_args, const std::string &name) const { PASS_HEADER JSON(bank.AdminDelUser(name, pass)); } void SendFunds(req_args, const std::string name, const std::string to, uint32_t amount) const { PASS_HEADER JSON(bank.SendFunds(name, to, amount, pass)); } void ChangePassword(req_args, const std::string &name) const { PASS_HEADER JSON(bank.ChangePassword(name, pass, std::string(req->getBody()))); } void Contains(req_args, const std::string &name) const { JSON(bank.Contains(name)); } void GetBal(req_args, const std::string &name) const { JSON(bank.GetBal(name)); } void VerifyPassword(req_args, const std::string &name) const { PASS_HEADER JSON(bank.VerifyPassword(name, pass)); } void SetBal(req_args, const std::string &name, uint32_t amount) const { PASS_HEADER JSON(bank.SetBal(name, pass, amount)); } void AdminVerifyPass(req_args) { PASS_HEADER JSON(bank.AdminVerifyPass(pass)); } void GetLog(req_args, const std::string &name) { if constexpr (max_log_size) { PASS_HEADER JSON(bank.GetLogs(name, pass)); } else { auto resp = HttpResponse::newHttpJsonResponse(JsonReturn("Logs are Disabled")); resp->setExpiredTime(0); //cached forever callback(resp); } } METHOD_LIST_BEGIN //Usage METHOD_ADD(BankF::GetBal, "/{name}/bal", Get, Options); METHOD_ADD(BankF::GetLog, "/{name}/log", Get, Options); METHOD_ADD(BankF::SendFunds, "/{name}/send/{to}/amount={amount}", Post, Options); METHOD_ADD(BankF::VerifyPassword, "/{name}/pass/verify", Get, Options); //Meta Usage METHOD_ADD(BankF::ChangePassword, "/{name}/pass/change", Patch, Options); METHOD_ADD(BankF::SetBal, "/admin/{name}/bal/amount={amount}", Patch, Options); //System Usage METHOD_ADD(BankF::Help, "/help", Get, Options); METHOD_ADD(BankF::Close, "/admin/close", Post, Options); METHOD_ADD(BankF::Contains, "/contains/{name}", Get, Options); METHOD_ADD(BankF::AdminVerifyPass, "/admin/verify", Get, Options); //User Managment METHOD_ADD(BankF::AddUser, "/user/{name}", Post, Options); METHOD_ADD(BankF::AdminAddUser, "/admin/user/{name}?init_bal={init_bal}", Post, Options); METHOD_ADD(BankF::DelUser, "/user/{name}", Delete, Options); METHOD_ADD(BankF::AdminDelUser, "/admin/user/{name}", Delete, Options); METHOD_LIST_END };