"API仕様を書く"の記事一覧

API仕様を書く(6)ー gRPC protoファイル(2) ー

(「API仕様を書く(5)ー gRPC protoファイル ー」からの続き) gRPCから返すコードについては、Go言語用のこちらの定義が分かりやすいです。個々のコードは定義を読めば使い方は分かるかと思います。 API仕様には、gRPCで提供するサービスが提供する機能に応じて、どのような場合にどのコードが返されるかを書く必要…

続きを読むread more

API仕様を書く(5)ー gRPC protoファイル ー

(「API仕様を書く(4)」からの続き) RPCの実装も通常のライブラリを作成するように「防御的プログラミング」を必要とします。すなわち、以下の状態に正しく対処する必要があります パラメータ値不正 呼び出し順序不正 設計ロジックの誤り 最初の二つは呼び出した側の誤りのですので、そのような不正呼び出しに対して、どのような…

続きを読むread more

API仕様を書く(4)

(「API仕様を書く(3)」からの続き) 2017年8月末でリコーを退職して、ソラミツ社で働き始めました。技術的にはgRPCを使ったサーバー側の開発に加わることになりました。 gPRCに触れたのはその時が初めてですが、RPC(Remote Procedure Call)そのものは、Xerox社のCourierとよばれるRPC…

続きを読むread more