nlib
JsonRpcRequest.h
[詳解]
1 
2 /*---------------------------------------------------------------------------*
3 
4  Project: CrossRoad
5  Copyright (C)2012-2016 Nintendo. All rights reserved.
6 
7  These coded instructions, statements, and computer programs contain
8  proprietary information of Nintendo of America Inc. and/or Nintendo
9  Company Ltd., and are protected by Federal copyright law. They may
10  not be disclosed to third parties or copied or duplicated in any form,
11  in whole or in part, without the prior written consent of Nintendo.
12 
13  *---------------------------------------------------------------------------*/
14 
15 #pragma once
16 #ifndef INCLUDE_NN_NLIB_MSGPACK_JSONRPC_JSONRPCREQUEST_H_
17 #define INCLUDE_NN_NLIB_MSGPACK_JSONRPC_JSONRPCREQUEST_H_
18 
19 #include <iterator>
20 
21 #include "nn/nlib/Config.h"
22 #include "nn/nlib/UniquePtr.h"
23 #include "nn/nlib/Nlist.h"
27 
28 #if defined(_MSC_VER) && defined(nx_msgpack_EXPORTS)
29 #undef NLIB_VIS_PUBLIC
30 #define NLIB_VIS_PUBLIC NLIB_WINEXPORT
31 #endif
32 
33 NLIB_NAMESPACE_BEGIN
34 namespace msgpack {
35 namespace jsonrpc {
36 
37 namespace fortest {
38 class JsonRpcErrorRequestTest;
39 } // namespace fortest
40 
41 typedef uint32_t reqid_t;
42 
44  public:
45  // NOTE:
46  // If id_ is 0, the request becomes notification(ID is not sent.).
47  JsonRpcRequest() NLIB_NOEXCEPT : id_(0), method_(NULL) {}
49  reqid_t GetId() const NLIB_NOEXCEPT { return id_; }
50  const char* GetMethod() const NLIB_NOEXCEPT { return method_; }
51  const MpObject& GetParams() const NLIB_NOEXCEPT { return params_; }
52  MpObject& GetParams() NLIB_NOEXCEPT { return params_; }
53 
54  void SetId(reqid_t id) NLIB_NOEXCEPT { id_ = id; }
55  bool SetMethod(const char* method) NLIB_NOEXCEPT;
56  void MoveParamsFrom(MpObject& params) NLIB_NOEXCEPT { // NOLINT
57  MpObject tmp;
58  tmp.swap(params);
59  tmp.swap(params_);
60  }
61 
62  private:
63  NLIB_VIS_HIDDEN JsonRpcResponse& GetResponse() NLIB_NOEXCEPT { return response_; }
64  NLIB_VIS_HIDDEN bool SetMethodRaw(const void* p, size_t n) NLIB_NOEXCEPT;
66 
67  private:
68  reqid_t id_;
69  char* method_;
70  MpObject params_;
71  JsonRpcResponse response_;
72 
73  friend NLIB_VIS_PUBLIC size_t JsonRpcServerExec(const void* p, size_t n,
75  friend class JsonRpcRequestReader;
76  friend class fortest::JsonRpcErrorRequestTest;
78 };
79 
81  public:
82  JsonRpcRequestWriter() NLIB_NOEXCEPT : prv_(NULL), is_msgpack_(false) {}
84  explicit JsonRpcRequestWriter(bool use_msgpack) NLIB_NOEXCEPT
85  : prv_(NULL), is_msgpack_(use_msgpack) {}
86  errno_t BeginWriteRequest(uint32_t n) NLIB_NOEXCEPT;
87  errno_t WriteRequest(const char* method, reqid_t id, const MpObject& params) NLIB_NOEXCEPT;
88  errno_t WriteNotification(const char* method, const MpObject& params) NLIB_NOEXCEPT {
89  return WriteRequest(method, 0, params);
90  }
91  errno_t WriteRequest(const JsonRpcRequest& req) NLIB_NOEXCEPT {
92  return WriteRequest(req.GetMethod(), req.GetId(), req.GetParams());
93  }
94  errno_t EndWriteRequest(ReallocOutputStream::UniquePtrType* ptr, size_t* n) NLIB_NOEXCEPT;
95 
96  private:
97  struct JsonRpcRequestWriterPrivate;
98  JsonRpcRequestWriterPrivate* prv_;
99  bool is_msgpack_;
100 
102 };
103 
105  public:
107  static errno_t ReadRequest(const void* p, size_t n, ListType* request_list) NLIB_NOEXCEPT;
108 
109  private:
111 };
112 
113 } // namespace jsonrpc
114 } // namespace msgpack
115 NLIB_NAMESPACE_END
116 
117 #if defined(_MSC_VER) && defined(nx_msgpack_EXPORTS)
118 #undef NLIB_VIS_PUBLIC
119 #define NLIB_VIS_PUBLIC NLIB_WINIMPORT
120 #endif
121 
122 #endif // INCLUDE_NN_NLIB_MSGPACK_JSONRPC_JSONRPCREQUEST_H_
JsonRpcRequestWriter() noexcept
デフォルトコンストラクタです。
JSON-RPCのレスポンスを表すクラスです。
JsonRpcRequest() noexcept
デフォルトコンストラクタです。
errno_t WriteNotification(const char *method, const MpObject &params) noexcept
JSON-RPCのNotificationを書き込みます。
const char * GetMethod() const noexcept
このリクエストのメソッド名を取得します。
#define NLIB_DISALLOW_COPY_AND_ASSIGN(TypeName)
TypeName で指定されたクラスのコピーコンストラクタと代入演算子を禁止します。
Definition: Config.h:158
void SetId(reqid_t id) noexcept
リクエストのidを設定します。
JSON-RPCのリクエストをシリアライズしてメモリに書きこむためのクラスです。
reqid_t GetId() const noexcept
このリクエストのid を取得します。0の場合はリクエストはnotificationとなります。
UniquePtrはポインタの所有権を保持し、UniquePtrがスコープから出るときにデストラクタでポインタをDELで指...
Definition: UniquePtr.h:109
std::unique_ptrに相当するクラスが定義されています。
#define NLIB_VIS_HIDDEN
関数やクラス等のシンボルをライブラリの外部に公開しません。
Definition: Platform_unix.h:86
#define NLIB_VIS_PUBLIC
関数やクラス等のシンボルをライブラリの外部に公開します。
Definition: Platform_unix.h:87
MessagePack又はJSONを読み込むことで作成されるオブジェクトです。
Definition: MpObject.h:95
JsonRpcRequestWriter(bool use_msgpack) noexcept
trueにすることでJSONの記述方式にJSONではなくmsgpackを利用します。
std::vectorに似ていますが、コピーできないオブジェクトを格納可能なクラスが定義されています。 ...
void swap(MpObject &rhs) noexcept
オブジェクトの中身をスワップします。
Definition: MpObject.h:284
JSON-RPCリクエストを読み込むためのクラスです。
JSON-RPCのリクエストを表すクラスです。
void MoveParamsFrom(MpObject &params) noexcept
JSON-RPCのパラメータを設定します。
MessagePack, JSON及びCSVを読み込むと作成されるオブジェクトです。
Nlist< JsonRpcRequest > ListType
バイト列から復元されるJSON-RPCリクエストのシーケンスを格納する型
#define NLIB_NOEXCEPT
環境に合わせてnoexcept 又は同等の定義がされます。
Definition: Config.h:99
開発環境別の設定が書かれるファイルです。
uint32_t reqid_t
JSON-RPCのリクエストに付与されるidの型です。
Definition: JsonRpcClient.h:32
std::vectorに似た、コピーコンストラクタを持たないオブジェクトを格納可能なコンテナ類似クラスです。 ...
Definition: Nlist.h:32
const MpObject & GetParams() const noexcept
このリクエストのパラメータを取得します。
errno_t WriteRequest(const JsonRpcRequest &req) noexcept
JSON-RPCのリクエストを書き込みます。
size_t JsonRpcServerExec(const void *p, size_t n, ReallocOutputStream::UniquePtrType *ptr)
JSON-RPCリクエストを処理してJSON-RPCレスポンスのバイト列を作成します。
#define NLIB_FINAL
利用可能であればfinalが定義されます。そうでない場合は空文字列です。
Definition: Config.h:224
MpObject & GetParams() noexcept
このリクエストのパラメータを取得します。
int errno_t
intのtypedefで、戻り値としてPOSIXのエラー値を返すことを示します。
Definition: NMalloc.h:37