はとのーと

エジソンノート(アイデア、思い付き、メモ)として使っています。誰かの役に立つかもしれないので公開しています。

愚考 2020-03

イデアメモには根拠の希薄な思いつきなどを書きます。

目次:

2020-03-12

HTTPをリモートメソッドの呼び出し方法だと考えるとIDはURLに入れずにパラメータとして渡すべき

だと思います。

次のように見做すとHTTPを「リモートメソッドの呼び出し方法」だと考えることができます。

  • ベースURL = メソッドや関数の識別子
  • パラメータやリクエストボディ = 引数
  • レスポンスボディ = 戻り値(ステータスコードでエラーも返せる)

Web APIではIDはベースURLに、検索条件はパラメータに入れるでIDをベースURLに入れることを考えましたが、IDは引数になるのでパラメータで渡すべきだということになります。

2020-03-18

公開する情報は後から差し替え可能にすべき

だと思います。

たとえばWindows用パッケージマネージャChocolateyではパッケージを一般ユーザーでインストールしようとすると次のようなメッセージが表示されます。

Chocolatey v0.10.15
Chocolatey detected you are not running from an elevated command shell
 (cmd/powershell).

 You may experience errors - many functions/packages
 require admin rights. Only advanced users should run choco w/out an
 elevated shell. When you open the command shell, you should ensure
 that you do so with "Run as Administrator" selected. If you are
 attempting to use Chocolatey in a non-administrator setting, you
 must select a different location other than the default install
 location. See
 https://chocolatey.org/install#non-administrative-install for details.

この最後に表示されるURL

https://chocolatey.org/install#non-administrative-install

にアクセスしてもここで必要な情報は表示されません。 実際の情報は次のURLのページにあります。(ページが移動したと思われます。)

https://chocolatey.org/docs/installation#non-administrative-install

このようなことを避けるためには埋め込まれた情報を後から差し替える仕組みを組み込むことが必要だと思います。 たとえばURLの場合には短縮URLのような仕組みが使えます。