RubyAPIラッパーを構成する3つの方法

APIラッパーの各インスタンスを構成できても、気にしないときにグローバルな「デフォルト」インスタンスがあった場合はどうなりますか？

この「defaultSomething」または「sharedWhatever」パターンは、iOSおよびMac OS SDK全体に表示されます：

[[NSURLSession sharedSession] downloadTaskWithURL:@"https://www.google.com"];

[[NSFileManager defaultManager] removeItemAtPath:...];

また、デフォルトで提供される以上のものが必要な場合でも、これらのクラスのインスタンスを要求できます。

NSURLSession *session = [NSURLSession sessionWithConfiguration:...];

NSFileManager fileManager = [[NSFileManager alloc] init];

default_apiを使用して、Rubyでそのようなものを構築できます。 クラスメソッド：

def show
  @product = ProductApi.default_product_api.find(params[:id])
end

...

def show_special
  special_product_api = ProductApi.new(
    root: "https://special-product-host.example.com/"
    user: "justin"
    secret: "mysecret123")
  @special_product = special_product_api.find(params[:id])
end

また、実装は次のようになります。

class ProductApi
  def initialize(root:, user:, secret:)
    @root, @user, @secret = root, user, secret
  end

  def self.default_api
    @default_api ||= new(
      root: ENV['PRODUCT_API_ROOT'],
      user: ENV['PRODUCT_API_USER'],
      secret: ENV['PRODUCT_API_SECRET'])
  end

  def find(product_id)
    ...
  end
end

ここでは、default_apiで環境変数を使用しました 、ただし、構成ファイルを使用することもできます。そして、||=を切り替えることができます 代わりにスレッドまたはリクエストローカルストレージを使用します。

しかし、これはまともなスタートです。

私が見たほとんどのgemは、Twitter gemのように、必要なときに各APIオブジェクトを構成および作成する必要があります。これは問題のない解決策です（ただし、通常、これらをグローバルに割り当てる人がいますが、とにかく 。

ただし、さらに一歩進んで、事前に構成されたデフォルトオブジェクトを使用すると、はるかに快適な時間を過ごすことができます。