• 第1引数 : 検索するディレクトリへのパス
• 第2引数 : namespaceの文字列または配列
• 第3引数 : trueの場合、$namespaceで指定されたネームスペースが使用されます。falseの場合は、検索したサブディレクトリが$namespaceに順次追加されます。
• 第4引数 : trueの場合は、$namespaceが「_」で展開されます。falseの場合は、$namespaceが「\」で展開されます
• 第5引数 : trueの場合は、再帰的にディレクトリを検索します。falseの場合は、サブディレクトリを検索しません。

Fooクラスを /path/to/classes/Foo.php に作成します。

<?php
/**
 * @S2Component('name' => 'foo')
 */
class Foo {}

Barクラスを /path/to/classes/Bar.php に作成します。

<?php
/**
 * @S2Component('name' => 'bar', 'namespace' => 'example')
 */
class Bar {}

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

<?php
require_once('S2Container/S2Container.php');
seasar\container\S2ApplicationContext::import('/path/to/classes');

// グローバルコンテナの生成
$globalContainer = seasar\container\S2ApplicationContext::create();
$foo = $globalContainer->getComponent('Foo');
$bar = $globalContainer->getComponent('example.Bar');

// example namespace コンテナの生成
$exampleContainer = seasar\container\S2ApplicationContext::create('example');
$foo = $exampleContainer->getComponent('Foo');          // コンポーネントが存在しないので例外がスローされます。
$bar = $exampleContainer->getComponent('Bar');

• 第1引数 : クラス名 | ReflectionClass | ComponentInfoDefインスタンス
• 戻り値 : ComponentInfoDefインスタンス

• 第1引数 : Interceptorコンポーネント名、Closure、またはExpression
• 第2引数 : コンポーネント名またはコンポーネントクラス名にパターンマッチする正規表現文字列
• 第3引数 : ポイントカットを正規表現文字列で指定
• 戻り値 : AspectInfoDefインスタンス

親クラスのメソッドアノテーション. 

デフォルトでは親クラスのメソッドアノテーションは無効となります。親クラスのメソッドアノテーションを有効とする場合は次のメソッドで設定します。

S2ApplicationContext::setReadParentAnnotation($val = true)

• 第1引数 : bool値、trueを設定すると親クラスのメソッドアノテーションが有効となります。

@S2Component アノテーション. 

コンポーネント情報を設定します。

• アノテーションの表記 : @S2Component
• 引数
  • name : コンポーネント名
  • instance : インスタンスモードタイプ
  • autoBinding : バインディングモードタイプ
  • available : コンポーネントとして使用するかどうか (boolean default true)
  • namespace : S2Container内の名前空間
• 注釈ポイント : クラス
• サンプル

    /**
     * @S2Component('name' => 'hoge')
     */
    class Hoge{} 
    
    /**
     * @S2Component('name'        => 'huga',
     *              'instance'    => 'singleton',
     *              'autoBinding' => 'auto',
     *              'available'   => true,
     *              'namespace'   => 'example.service')
     */
    class Huga{} 
  

@S2Binding アノテーション. 

手動インジェクション設定を行います。

• アノテーションの表記 : @S2Binding
• 引数 : インジェクションするコンポーネント名、またはExpression
• 注釈ポイント : pulbicプロパティ、セッターメソッド
• サンプル

  class IndexAction {
      /**
       * @S2Binding('new HogeService')
       */
      public $service;
   
      /**
       * @S2Binding('Hello World')
       */
      public funcion setHello($val) {
          $this->hello = $val;
      }
  }
  

@S2Aspect アノテーション. 

アスペクト情報を設定します。

• アノテーションの表記 : @S2Aspect
• 引数
  • interceptor : Interceptorコンポーネント名、またはExpression
  • pointcut : ポイントカットを正規表現文字列で指定
• 注釈ポイント : クラス、メソッド
• サンプル

    /**
     * @S2Aspect('interceptor' => 'traceInterceptor',
     *           'pointcut'    => '/.+Action/')
     */
    class CdController {
        public function indexAction(){
            ・・・
        }
    }
  
    class DvdController {
        /**
         * @S2Aspect('interceptor' => 'new seasar\aop\interceptor\TraceInterceptor()')
         */
        public funcion indexAction() {
            ・・・
        }
    }
  

@S2Meta アノテーション. 

メタ情報を設定します。

• アノテーションの表記 : @S2Meta
• 引数
  • name : メタ情報の識別名
  • value : 値、またはExpression
• 注釈ポイント : クラス
• サンプル

    /**
     * @S2Meta('nameA' => 'valueA',
     *         'nameB' => 'valueB')
     */
    class CdController {
        public function indexAction(){
            ・・・
        }
    }
  

getメソッド (getComponentメソッド). 

S2ApplicationContext::get($key, $namespaces = array())
S2ApplicationContext::getComponent($key, $namespaces = array())

• 第1引数 : コンポーネントのキー名
• 第2引数 : S2Containerを管理するnamespace

getメソッドは getComponentメソッドのAliasです。 第1引数で指定されたコンポーネントを取得します。 第2引数で指定されたnamespaceのSingleton S2Containerが未作成の場合は、S2ApplicationContext::createメソッド を用いてコンテナを生成します。 S2ApplicationContext::getメソッドへのショートカットとして、s2get関数が定義されています。

getComponentDefメソッド. 

S2ApplicationContext::getComponentDef($key, $namespaces = array())

• 第1引数 : コンポーネントのキー名
• 第2引数 : S2Containerを管理するnamespace

第1引数で指定されたコンポーネント定義を取得します。 第2引数で指定されたnamespaceのSingleton S2Containerが未作成の場合は、S2ApplicationContext::createメソッド を用いてコンテナを生成します。

Fooクラスを /path/to/classes/Foo.php に作成します。

<?php
/**
 * @S2Component('name' => 'foo')
 */
class Foo {}

Barクラスを /path/to/classes/Bar.php に作成します。

<?php
/**
 * @S2Component('name' => 'bar', 'namespace' => 'example')
 */
class Bar {}

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

<?php
require_once('S2Container/S2Container.php');
use seasar\container\S2ApplicationContext as s2app;
s2app::import('/path/to/classes');

// グローバルの Singleton コンテナを使用する
$globalFoo = s2app::get('Foo');
$globalBar = s2app::get('example.Bar');

// example namespace の Singleton コンテナを使用する
$exampleFoo = s2app::get('Foo', 'example');          // コンポーネントが存在しないので例外がスローされます。
$exampleBar = s2app::get('Bar', 'example');

var_dump($globalBar === $exampleBar);                // false となります。