/* * Copyright (c) 2016 The ZLMediaKit project authors. All Rights Reserved. * * This file is part of ZLMediaKit(https://github.com/xia-chu/ZLMediaKit). * * Use of this source code is governed by MIT license that can be found in the * LICENSE file in the root of the source tree. All contributing project authors * may be found in the AUTHORS file in the root of the source tree. */ #ifndef ZLMEDIAKIT_WEBAPI_H #define ZLMEDIAKIT_WEBAPI_H #include #include #include "jsoncpp/json.h" #include "Common/Parser.h" #include "Network/Socket.h" #include "Http/HttpSession.h" #include "Common/MultiMediaSourceMuxer.h" //配置文件路径 extern std::string g_ini_file; namespace mediakit { ////////////RTSP服务器配置/////////// namespace Rtsp { extern const std::string kPort; } //namespace Rtsp ////////////RTMP服务器配置/////////// namespace Rtmp { extern const std::string kPort; } //namespace RTMP } // namespace mediakit namespace API { typedef enum { NotFound = -500,//未找到 Exception = -400,//代码抛异常 InvalidArgs = -300,//参数不合法 SqlFailed = -200,//sql执行失败 AuthFailed = -100,//鉴权失败 OtherFailed = -1,//业务代码执行失败, Success = 0//执行成功 } ApiErr; }//namespace API class ApiRetException: public std::runtime_error { public: ApiRetException(const char *str = "success" ,int code = API::Success):runtime_error(str){ _code = code; } ~ApiRetException() = default; int code(){ return _code; } private: int _code; }; class AuthException : public ApiRetException { public: AuthException(const char *str):ApiRetException(str,API::AuthFailed){} ~AuthException() = default; }; class InvalidArgsException: public ApiRetException { public: InvalidArgsException(const char *str):ApiRetException(str,API::InvalidArgs){} ~InvalidArgsException() = default; }; class SuccessException: public ApiRetException { public: SuccessException():ApiRetException("success",API::Success){} ~SuccessException() = default; }; using ApiArgsType = std::map; template std::string getValue(Args &args, const First &first) { return args[first]; } template std::string getValue(Json::Value &args, const First &first) { return args[first].asString(); } template std::string getValue(std::string &args, const First &first) { return ""; } template std::string getValue(const mediakit::Parser &parser, const First &first) { auto ret = parser.getUrlArgs()[first]; if (!ret.empty()) { return ret; } return parser.getHeader()[first]; } template std::string getValue(mediakit::Parser &parser, const First &first) { return getValue((const mediakit::Parser &) parser, first); } template std::string getValue(const mediakit::Parser &parser, Args &args, const First &first) { auto ret = getValue(args, first); if (!ret.empty()) { return ret; } return getValue(parser, first); } template class HttpAllArgs { public: HttpAllArgs(const mediakit::Parser &parser, Args &args) { _get_args = [&args]() { return (void *) &args; }; _get_parser = [&parser]() -> const mediakit::Parser & { return parser; }; _get_value = [](HttpAllArgs &that, const std::string &key) { return getValue(that.getParser(), that.getArgs(), key); }; _clone = [&](HttpAllArgs &that) { that._get_args = [args]() { return (void *) &args; }; that._get_parser = [parser]() -> const mediakit::Parser & { return parser; }; that._get_value = [](HttpAllArgs &that, const std::string &key) { return getValue(that.getParser(), that.getArgs(), key); }; that._cache_able = true; }; } HttpAllArgs(const HttpAllArgs &that) { if (that._cache_able) { _get_args = that._get_args; _get_parser = that._get_parser; _get_value = that._get_value; _cache_able = true; } else { that._clone(*this); } } ~HttpAllArgs() = default; template toolkit::variant operator[](const Key &key) const { return (toolkit::variant)_get_value(*(HttpAllArgs*)this, key); } const mediakit::Parser &getParser() const { return _get_parser(); } Args &getArgs() { return *((Args *) _get_args()); } const Args &getArgs() const { return *((Args *) _get_args()); } private: bool _cache_able = false; std::function _get_args; std::function _get_parser; std::function _get_value; std::function _clone; }; #define API_ARGS_MAP toolkit::SockInfo &sender, mediakit::HttpSession::KeyValue &headerOut, const HttpAllArgs &allArgs, Json::Value &val #define API_ARGS_MAP_ASYNC API_ARGS_MAP, const mediakit::HttpSession::HttpResponseInvoker &invoker #define API_ARGS_JSON toolkit::SockInfo &sender, mediakit::HttpSession::KeyValue &headerOut, const HttpAllArgs &allArgs, Json::Value &val #define API_ARGS_JSON_ASYNC API_ARGS_JSON, const mediakit::HttpSession::HttpResponseInvoker &invoker #define API_ARGS_STRING toolkit::SockInfo &sender, mediakit::HttpSession::KeyValue &headerOut, const HttpAllArgs &allArgs, Json::Value &val #define API_ARGS_STRING_ASYNC API_ARGS_STRING, const mediakit::HttpSession::HttpResponseInvoker &invoker #define API_ARGS_VALUE sender, headerOut, allArgs, val //注册http请求参数是map类型的http api void api_regist(const std::string &api_path, const std::function &func); //注册http请求参数是map类型,但是可以异步回复的的http api void api_regist(const std::string &api_path, const std::function &func); //注册http请求参数是Json::Value类型的http api(可以支持多级嵌套的json参数对象) void api_regist(const std::string &api_path, const std::function &func); //注册http请求参数是Json::Value类型,但是可以异步回复的的http api void api_regist(const std::string &api_path, const std::function &func); //注册http请求参数是http原始请求信息的http api void api_regist(const std::string &api_path, const std::function &func); //注册http请求参数是http原始请求信息的异步回复的http api void api_regist(const std::string &api_path, const std::function &func); template bool checkArgs(Args &args, const First &first) { return !args[first].empty(); } template bool checkArgs(Args &args, const First &first, const KeyTypes &...keys) { return checkArgs(args, first) && checkArgs(args, keys...); } //检查http url中或body中或http header参数是否为空的宏 #define CHECK_ARGS(...) \ if(!checkArgs(allArgs,##__VA_ARGS__)){ \ throw InvalidArgsException("缺少必要参数:" #__VA_ARGS__); \ } //检查http参数中是否附带secret密钥的宏,127.0.0.1的ip不检查密钥 #define CHECK_SECRET() \ if(sender.get_peer_ip() != "127.0.0.1"){ \ CHECK_ARGS("secret"); \ if(api_secret != allArgs["secret"]){ \ throw AuthException("secret错误"); \ } \ } void installWebApi(); void unInstallWebApi(); uint16_t openRtpServer(uint16_t local_port, const std::string &stream_id, bool enable_tcp, const std::string &local_ip, bool re_use_port, uint32_t ssrc); bool closeRtpServer(const std::string &stream_id); Json::Value makeMediaSourceJson(mediakit::MediaSource &media); void getStatisticJson(const std::function &cb); void addStreamProxy(const std::string &vhost, const std::string &app, const std::string &stream, const std::string &url, int retry_count, const mediakit::ProtocolOption &option, int rtp_type, float timeout_sec, const std::function &cb); #endif //ZLMEDIAKIT_WEBAPI_H