summaryrefslogtreecommitdiffstats
path: root/src/rpc-server/include/trex_rpc_cmd_api.h
blob: c773b15fa2e4d069ff1e2f513aa9e127c49c473a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/*
 Itay Marom
 Cisco Systems, Inc.
*/

/*
Copyright (c) 2015-2015 Cisco Systems, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

#ifndef __TREX_RPC_CMD_API_H__
#define __TREX_RPC_CMD_API_H__

#include <string>
#include <vector>
#include <json/json.h>

/**
 * interface for RPC command
 * 
 * @author imarom (13-Aug-15)
 */
class TrexRpcCommand {
public:

    /**
     * describe different types of rc for run()
     */
    enum rpc_cmd_rc_e {
        RPC_CMD_OK,
        RPC_CMD_PARAM_COUNT_ERR = 1,
        RPC_CMD_PARAM_PARSE_ERR,
        RPC_CMD_INTERNAL_ERR
    };

    /**
     * method name and params
     */
    TrexRpcCommand(const std::string &method_name) : m_name(method_name) {

    }

    rpc_cmd_rc_e run(const Json::Value &params, Json::Value &result) {
        return _run(params, result);
    }

    const std::string &get_name() {
        return m_name;
    }

    virtual ~TrexRpcCommand() {}

protected:

    /**
     * implemented by the dervied class
     * 
     */
    virtual rpc_cmd_rc_e _run(const Json::Value &params, Json::Value &result) = 0;

    /**
     * error generating functions
     * 
     */
    void genernate_err(Json::Value &result, const std::string &msg) {
        result["specific_err"] = msg;
    }

    void generate_err_param_count(Json::Value &result, int expected, int provided) {
        std::stringstream ss;
        ss << "method expects '" << expected << "' paramteres, '" << provided << "' provided";
        genernate_err(result, ss.str());
    }

    std::string m_name;
};

#endif /* __TREX_RPC_CMD_API_H__ */