chore: import upstream snapshot with attribution

2026-07-13 13:29:29 +08:00
commit f52cf32e56
1718 changed files with 366293 additions and 0 deletions
@@ -0,0 +1,139 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you 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.
+
+#include <gflags/gflags.h>
+#include <butil/logging.h>
+#include <brpc/channel.h>
+#include <brpc/server.h>
+#include "echo.pb.h"
+
+DEFINE_int32(timeout_ms, 100, "RPC timeout in milliseconds");
+DEFINE_int32(max_retry, 3, "Max retries(not including the first RPC)"); 
+
+DEFINE_bool(echo_attachment, true, "Echo attachment as well");
+DEFINE_int32(port, 8000, "TCP Port of this server");
+DEFINE_string(server, "", "The server to connect, localhost:FLAGS_port as default");
+DEFINE_string(load_balancer, "", "The algorithm for load balancing");
+DEFINE_bool(use_http, false, "Use http protocol to transfer messages");
+DEFINE_int32(idle_timeout_s, -1, "Connection will be closed if there is no "
+             "read/write operations during the last `idle_timeout_s'");
+
+brpc::Channel channel;
+
+// Your implementation of example::EchoService
+namespace example {
+class CascadeEchoService : public EchoService {
+public:
+    CascadeEchoService() {}
+    virtual ~CascadeEchoService() {}
+    virtual void Echo(google::protobuf::RpcController* cntl_base,
+                      const EchoRequest* request,
+                      EchoResponse* response,
+                      google::protobuf::Closure* done) {
+        // This object helps you to call done->Run() in RAII style. If you need
+        // to process the request asynchronously, pass done_guard.release().
+        brpc::ClosureGuard done_guard(done);
+
+        brpc::Controller* cntl =
+            static_cast<brpc::Controller*>(cntl_base);
+
+        if (request->depth() > 0) {
+            CLOGI(cntl) << "I'm about to call myself for another time, depth=" << request->depth();
+            example::EchoService_Stub stub(&channel);
+            example::EchoRequest request2;
+            example::EchoResponse response2;
+            brpc::Controller cntl2(cntl->inheritable());
+            request2.set_message(request->message());
+            request2.set_depth(request->depth() - 1);
+
+            cntl2.set_timeout_ms(FLAGS_timeout_ms);
+            cntl2.set_max_retry(FLAGS_max_retry);
+            stub.Echo(&cntl2, &request2, &response2, NULL);
+            if (cntl2.Failed()) {
+                CLOGE(&cntl2) << "Fail to send EchoRequest, " << cntl2.ErrorText();
+                cntl->SetFailed(cntl2.ErrorCode(), "%s", cntl2.ErrorText().c_str());
+                return;
+            }
+            response->set_message(response2.message());
+        } else {
+            CLOGI(cntl) << "I'm the last call";
+            response->set_message(request->message());
+        }
+        
+        if (FLAGS_echo_attachment && !FLAGS_use_http) {
+            // Set attachment which is wired to network directly instead of
+            // being serialized into protobuf messages.
+            cntl->response_attachment().append(cntl->request_attachment());
+        }
+    }
+};
+}  // namespace example
+
+int main(int argc, char* argv[]) {
+    // Parse gflags. We recommend you to use gflags as well.
+    GFLAGS_NAMESPACE::SetUsageMessage("A server that may call itself");
+    GFLAGS_NAMESPACE::ParseCommandLineFlags(&argc, &argv, true);
+
+    // A Channel represents a communication line to a Server. Notice that 
+    // Channel is thread-safe and can be shared by all threads in your program.
+    brpc::ChannelOptions coption;
+    if (FLAGS_use_http) {
+        coption.protocol = brpc::PROTOCOL_HTTP;
+    }
+    
+    // Initialize the channel, NULL means using default options. 
+    // options, see `brpc/channel.h'.
+    if (FLAGS_server.empty()) {
+        if (channel.Init("localhost", FLAGS_port, &coption) != 0) {
+            LOG(ERROR) << "Fail to initialize channel";
+            return -1;
+        }
+    } else {
+        if (channel.Init(FLAGS_server.c_str(), FLAGS_load_balancer.c_str(), &coption) != 0) {
+            LOG(ERROR) << "Fail to initialize channel";
+            return -1;
+        }
+    }
+
+    // Generally you only need one Server.
+    brpc::Server server;
+    // For more options see `brpc/server.h'.
+    brpc::ServerOptions options;
+    options.idle_timeout_sec = FLAGS_idle_timeout_s;
+
+    // Instance of your service.
+    example::CascadeEchoService echo_service_impl;
+
+    // Add the service into server. Notice the second parameter, because the
+    // service is put on stack, we don't want server to delete it, otherwise
+    // use brpc::SERVER_OWNS_SERVICE.
+    if (server.AddService(&echo_service_impl, 
+                          brpc::SERVER_DOESNT_OWN_SERVICE) != 0) {
+        LOG(ERROR) << "Fail to add service";
+        return -1;
+    }
+
+    // Start the server.
+    if (server.Start(FLAGS_port, &options) != 0) {
+        LOG(ERROR) << "Fail to start EchoServer";
+        return -1;
+    }
+    
+    // Wait until Ctrl-C is pressed, then Stop() and Join() the server.
+    server.RunUntilAskedToQuit();
+    return 0;
+}