go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

export PATH="$PATH:$(go env GOPATH)/bin"

go run greeter_server/main.go

go run greeter_client/main.go

// Copyright 2015 gRPC authors.
//
// 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.


// Protocol Buffersのバージョン宣言　最初に記述する必要がある！
// 記述がない場合 proto2として扱われる
syntax = "proto3";

// 言語ごとの生成オプション
// ここで生成後コードのパッケージ名などを設定する
// (パッケージ名は自分のプロジェクトフォルダの構成に合わせて設定する)
option go_package = "google.golang.org/grpc/examples/helloworld/helloworld";
option java_multiple_files = true;
option java_package = "io.grpc.examples.helloworld";
option java_outer_classname = "HelloWorldProto";

// protoの名前空間。生成されるプログラム言語のパッケージとは別物で、
// gRPCの通信パスの一部として利用される
package helloworld;

// Serviceはメソッドの集まりで、Goのinterfaceに相当する宣言
// ここで記載したメソッドを、実際に各プログラム言語にて実装する
// 引数と戻り値の型はこの後登場するmessageにて定義する
// The greeting service definition.
service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// messageは構造体のようなもので、やり取りするデータの形式を定義する
// フィールド番号は一度決めたら「変更は不可」となる(古いクライアントとの互換性を保つため)
// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

brew install protobuf

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

# PATHに追加(~/.bashrc などに書いておく)
export PATH="$PATH:$(go env GOPATH)/bin"

protoc \
  --go_out=. --go_opt=paths=source_relative \
  --go-grpc_out=. --go-grpc_opt=paths=source_relative \
  helloworld/helloworld.proto

/*
 *
 * Copyright 2015 gRPC authors.
 *
 * 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.
 *
 */

// Package main implements a server for Greeter service.
package main

import (
	"context"
	"flag"
	"fmt"
	"log"
	"net"

	"google.golang.org/grpc"
    // 生成したプロトコルバッファのインポート
    // 別名でpbとしている(Protocol Bufferの略)
	pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

var (
	port = flag.Int("port", 50051, "The server port")
)

// server is used to implement helloworld.GreeterServer.
// GreeterServerを実装するための構造体
// UnimplementedGreeterServerを埋め込む理由は2つ
//  UnimplementedGreeterServerを埋め込まないとビルドが通らない
//  埋め込むことで未実装のメソッドが存在してもビルドが壊れずUnimplementedエラーが返却される
type server struct {
	pb.UnimplementedGreeterServer
}

// SayHello implements helloworld.GreeterServer
// 実装部分
// 引数のinにクライアントから送信されたデータが構造体として復元され、格納されている
// 戻り値はprotoファイルのmessageで定義したHelloReply形式で生成する
// contextについては未使用のため_指定(メタデータなどが可能されている)
func (s *server) SayHello(_ context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
    // Getterを利用することで、inがnilでもパニックにならず、空文字を返す
	log.Printf("Received: %v", in.GetName())
	return &pb.HelloReply{Message: "Hello " + in.GetName()}, nil
}

// メイン処理
// gRPCサーバーの起動は4段階
// 1. net.Listenでポートを開く
// 2. grpc.NewServer()でサーバーを作る
// 3. pb.RegisterGreeterServerで実装を登録する(これをしないとUnimplementedエラーが発生する)
// 4. s.Serve(lis)でリクエスト待ちとなる
func main() {
	flag.Parse()
	lis, err := net.Listen("tcp", fmt.Sprintf(":%d", *port))
	if err != nil {
		log.Fatalf("failed to listen: %v", err)
	}
	s := grpc.NewServer()
	pb.RegisterGreeterServer(s, &server{})
	log.Printf("server listening at %v", lis.Addr())
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

/*
 *
 * Copyright 2015 gRPC authors.
 *
 * 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.
 *
 */

// Package main implements a client for Greeter service.
package main

import (
	"context"
	"flag"
	"log"
	"time"

	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials/insecure"
    // 生成したProtocol Bufferのインポート
    // 同じようにpbの別名を付けている
	pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

const (
	defaultName = "world"
)

var (
	addr = flag.String("addr", "localhost:50051", "the address to connect to")
	name = flag.String("name", defaultName, "Name to greet")
)

func main() {
	flag.Parse()
	// Set up a connection to the server.
    // 接続の管理オブジェクトの作成
    // 引数のinsecure.NewCredentials()はTLSは利用しないと言う指定
    // これはあくまでサンプルなので平文通信で問題ないが、本番では適切なTLS認証情報を設定する 
	conn, err := grpc.NewClient(*addr, grpc.WithTransportCredentials(insecure.NewCredentials()))
	if err != nil {
		log.Fatalf("did not connect: %v", err)
	}
    // deferを利用して確実に接続がクローズされるようにする
	defer conn.Close()
    // クライアントスタブの生成
    // SayHelloが実装されている
	c := pb.NewGreeterClient(conn)

	// Contact the server and print out its response.
    // gRPC通信時はtime.Secondでタイムアウトを設定する。これがないと、サーバー側で処理が止まった場合、いつまでもレスポンスを待ち続けてしまう
	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()
    // SayHello呼び出し。通常の関数の呼び出しに見えるが、HTTP/2通信が行われている
	r, err := c.SayHello(ctx, &pb.HelloRequest{Name: *name})
	if err != nil {
		log.Fatalf("could not greet: %v", err)
	}
	log.Printf("Greeting: %s", r.GetMessage())
}