S2ApplicationContextの生成は、instanceメソッドで行います。

S2ApplicationContext#instance

instanceメソッドでS2ApplicationContextを生成した場合は、Singletonインスタンスが返ります。 新規インスタンスを生成する場合は、newメソッドを使用して下さい。

S2ApplicationContext#new

S2ApplicationContext#instanceメソッドへのショートカットとしてs2appメソッドが定義されています。

s2componentメソッドを用いてクラスをコンポーネントとして登録します。

s2component(options = {}, &procedure)
alias s2comp s2component

S2Containerインスタンスの生成は次のメソッドで行います。

S2ApplicationContext#create(namespaces = [])

生成されるS2Containerは、s2componentメソッドで登録した全クラスをコンポーネントとして持ちます。 namespaces引数(文字列、文字列の配列)を設定した場合は、指定されたnamespaceを含むS2Containerインスタンスが返されます。 例として、グローバル(namespace指定無し)にActionクラスがあり、services namespaceにServiceクラスが ある場合は、次のようにS2Containerを生成できます。

	NOTE
	この例は example/example05 にあります。

createメソッドでS2Containerを生成する際に、s2componentメソッドで登録されたクラスから一部を選択することができます。

コンポーネントの選択でインクルードされたコンポーネントに対して、自動的にアスペクトを適用します。 自動アスペクトの設定は、s2aspectメソッドで行います。

s2aspect(options, &procedure)

s2aspectメソッドがクラス定義内で実行された場合は、第1引数の:pattern値に文字列でクラス名が自動設定されます。

ActionクラスのindexメソッドにTraceInterceptorをアスペクトする場合を次に示します。 TraceInterceptorは、予め 「interceptor.trace」としてコンポーネントが登録されています。

module Example
  class Action
    s2comp
    s2aspect :interceptor => "interceptor.trace", :pointcut => :index
    def index
      s2logger.debug(self.class.superclass) {"index action called."}
    end
  end
end

実行スクリプトは次になります。

require 's2container'
require 'example'

container = s2app.create
component = container.get(Example::Action)
component.index

	NOTE
	この例は example/example06 にあります。

ActionクラスのindexメソッドにブロックでInterceptorをアスペクトする場合を次に示します。

module Example
  class Action
    s2comp :name => :action
    def index
      s2logger.debug(self.class.superclass) {"index action called."}
    end
  end
end

実行スクリプトは次になります。

require 's2container'
require 'example'

s2aspect(:pattern => :action, :pointcut => :index) {|invocation|
  s2logger.debug(invocation.component_class) {"before"}
  result = invocation.proceed
  s2logger.debug(invocation.component_class) {"after "}
  next result
}

container = s2app.create
component = container.get(:action)
component.index

	NOTE
	この例は example/example07 にあります。

S2ApplicationContextは、namespace単位でSingleton S2Containerを生成、管理します。 Singleton S2Containerへのアクセスは次のメソッドで行います。

例として、グローバル(namespace指定無し)にActionクラスがあり、services namespaceにServiceクラスが ある場合は、次のように 各コンポーネントを取得できます。

クラス定義は次になります。

module Example
  class Action
    s2comp
  end

  class Service
    s2comp :namespace => "services"
  end
end

実行スクリプトは次になります。

require 's2container'
require 'example'

global_action = s2app.get(Example::Action)
p global_action
global_service = s2app.get(Example::Service)
p global_service

begin
  services_action = s2app.get(Example::Action, "services")
rescue => err
  puts err.message                # -> component [Example::Action] not found.
end
services_service = s2app.get(Example::Service, "services")
p services_service
p global_service == services_service       # -> false

	注意
	グローバルのSingletonコンテナが生成される際にservices namespaceのコンテナも生成され、子コンテナとして保持されていますが、 services namespaceのSingletonコンテナとは別インスタンスとなります。

	NOTE
	この例は example/example08 にあります。