ProtoBuf

proto文件：请求、回复、服务的接口都定义在proto文件中，且方法都是虚函数。

option cc_generic_service= true：标志生成c++类(java/py_generic_service)。

import引入包，pack跟namespace差不多可以对类进行打包。

proto文件生成后的类，需要写impl类继承proto.class（proto文件生成的类），实现它的虚函数：

class MyImpl : public ProtoClass
{
public:
    void Method(::google::protobuf::RpcController* cntl_base,
                const ::example::Request* request,
                ::example::Response* response,
                ::google::protobuf::Closure* done)
                {
                    //RAII,确保调用done->Run()
                    brpc::ClosureGuard done_guard(done);
                    brpc::Controller* cntl= static_cast<brpc::Controller*>(cntl_base);
                    //fill response
                    response->set_message(/*data*/);
                }
};

HTTP 可通过URL类型访问：

　　前缀为 /ServiceName/MehtodName：制定特定MethodName

　　前缀为 /ServiceName：实现默认虚函数default_method

HTTP 可通过Restful URL访问：

　　brpc支持为service中的每个方法指定一个URL：butil::StringPiece

　　映射规则：多个路径可以映射至同一个方法、service不要求纯HTTP，pb service也支持、没有出现的映射中的方法仍然通过/ServiceName/MethodName访问，出现映射则不可以、一个路径只能出现一个*号

controller：在brpc中可以静态转为brpc::Controller(包含除了reques和response以外的参数集)：

　　客户端methods包括：

　　　　　　　　　　set_timeout_ms(int64_t);RPC call

　　　　　　　　　　set_backup_request_ms(int64_t);delay to send backup request

　　　　　　　　　　response(); response of the RPC call(passed to CallMethod)

　　　　　　　　　　http_request(); mutable header of http request

　　　　　　　　　　set_log_id(uint64_t);an identifier to send to server along with request

　　　　　　　　　　set_type_of_service(short tos);必须在连接前设置，连接后设置是没有影响的

　　　　　　　　　　set_connection_type(ConnectionType);set type of connections for sending RPC

　　　　　　　　　　set_request_compress_type(CompressType);set compression method for request

　　　　　　　　　butil::IOBuf& request_attachment();user atached data or body of htp request,while is wired to network directly instread of begin serialized into protobuf message.

　　　　　　　　　　method();get the called method,may-be NULL for non-pb services.

　　服务器端methods包括：

　　　　　　　　　　　IsCanceled();客户端取消RPC或者链接中断，返回true。服务端应该放弃回复它，然后回调done

　　　　　　　　　　　NotityOnCancel();当RPC取消或者链接中断调用回调（只能调用一次）

　　　　　　　　　　　auth_context();返回一个authenticated结果，null 表示没有 啊uthentication

　　　　　　　　　　　http_response();mutable header of http response

　　　　　　　　　　　butil::IOBuf& response_attachment();user attached data or body of http response,which is wired to network directly inseted of being serialized into protobuf messages

　　　　　　　　　　　CreateProgressiveAttachment();Crate a ProgressiveAttachment to write(often after RPC)

　　　　　　　　　　　trace_id()/span_id();Non-zero when this Rpc call is traced(by rpcz or rig)

　　　　　　　　　　　CloseConnection();tell RPC to close the connection(the underlying connection is not closed immediately) instead of sending back response.

　　　　　　　　　　　is_security_mode();the RPC is from connections accepted from port

　　　　　　　　　　　session_local_data();Get the data attached to current RPC session

　　客户端与服务端同有methods：

　　　　　　　　　　　remote_side();

　　　　　　　　　　　local_side();

　　　　　　　　　　　is_ssl();

　　　　　　　　　　　Reset();resets the controller to its initial state so that it my be reused in a new call

　　　　　　　　　　　SetFauked(); reason will be incorporated into the message returned by ErrorText()

　　　　　　　　　　　Failed(); after a call has finished,returns true if the RPC call failed.

　　　　　　　　　　　ErrorText();if Failed() is true,return description of the errors

　　　　　　　　　　　request/response_compress_type();

　　　　　　　　　　　http_request();如果为NULL则返回默认http header　　

　　　　　　　　　　　http_response();

　　　　　　　　　　　request_attachment();

　　　　　　　　　　　response_attachment();

　　　　　　　　　　　has_remote_stream();return true if the remote side creates a stream.

request：请求，只读的，来自客户端的数据包

response：回复，需要用户填充，如果存在required字段没有被设置，该次调用会失败

done：done由框架创建，递给服务回调，包含了调用服务回调后的后续动作，包括检查response正确性、序列化、打包、发送等逻辑（done由用户自己调用而不是框架(ClosureGuard调用done->Run)，这允许用户把done保存下来，在服务回调之后的某事件发生时再调用，即异步Service，异步为了避免正常脱离函数时done->Run也被调用，可以在结束尾调用done_guard.release()来释放其中done）

服务端的done的逻辑主要是：

　　　　　　发送response会客户端，当其发现用户调用lSetFailed()后，会把错误信息发送会客户端，客户端接收到，它的Controller::Failed()会返回　true,Controller::ErrorCode()和Controller::ErrorText()则分别是错误码和错误信息 

服务端的异步服务：

　　　　　　即done->Run()在Service回调之外被调用。有些server以等待后端服务返回结果为主，且处理时间特别长，为了及时地释放出线程资源，更好的办法是把done注册到被等待事件的回调中，等待事件发生后再调用done->Run()，异步service的最后一行一般是done_guard.release()以确保正常退出CallMethod时不会被调用done->Run()。

　　　　　　service的done由框架创建，用户处理请求后调用done把response发回给客户端

　　　　　　channel的done由用户创建，待RPC结束后被框架调用以执行用户的后续代码。

Protobuf的服务通常可以通过HTTP+json访问，存在http body的json可与对于protobuf消息互相转化，json字段通过匹配的名字和结构与pb字段一一对应。json中一定要包含pb的required字段，否则转化会失败对应请求会被拒绝。json中可以包含pb中没有定义的字段，但它们会被丢弃而不会存入pb的unknown字段（原因在于protobuf真正的key是proto文件中的每个字段后的数字）。