s2container 0.8.0

data/lib/seasar/container/assembler/manual-property-assembler.rb

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Assembler
+      # マニュアルインジェクションでプロパティを設定するアセンブラです。
+      class ManualPropertyAssembler < AbstractAssembler
+
+        # ManualPropertyAssemblerを構築します。
+        # - args
+        #   1. Seasar::Container::ComponentDef <em>component_def</em>
+        def initialize(component_def)
+          super
+        end
+
+        # マニュアルプロパティインジェクションを実施します。
+        # - args
+        #   1. Object <em>component</em>
+        # - return
+        #   - none
+        #
+        def assemble(component)
+          bean_desc = Seasar::Beans::BeanDescFactory.get_bean_desc(component)
+          prop_descs = bean_desc.typehint_property_descs
+          property_defs = @component_def.get_property_defs
+          @component_def.get_property_defs.each {|property_name, property_def|
+            value = nil
+            if bean_desc.property_descs.key?(property_name)
+              prop_desc = bean_desc.property_descs[property_name]
+              begin
+                value = property_def.value
+              rescue Seasar::Container::Exception::TooManyRegistrationRuntimeException => e
+                if prop_desc.array_acceptable
+                  child_component_defs = property_def.container.get_component_def(property_def.value).component_defs
+                  value = []
+                  for child_component_def in child_component_defs
+                    value << child_component_def.component
+                  end
+                else
+                  raise e
+                end
+              end
+              prop_desc.set_value(component, value)
+            else
+              raise Seasar::Exception::PropertyNotFoundRuntimeException.new(@component_def.component_class, property_name)
+            end
+          }
+        end
+      end
+    end
+  end
+end

data/lib/seasar/container/autobinding-def.rb

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    class AutoBindingDef
+      AUTO_NAME = :auto
+      NONE_NAME = :none
+
+      #
+      # - args
+      #   1. Seasar::Container::ComponentDef <em>component_def</em>
+      # - return
+      #   - Seasar::Container::Assembler::AbstractAssembler
+      #
+      def create_property_assembler(component_def)
+      end
+      attr_accessor :name
+    end
+  end
+end

data/lib/seasar/container/component-def.rb

@@ -0,0 +1,229 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    class ComponentDef
+
+      # - args
+      #   1. Class <em>component_class</em>
+      #   2. String|Symbol <em>component_name</em>
+      #   3. Proc <em>procedure</em>
+      def initialize(component_class, component_name = nil, &procedure)
+        @procedure = procedure
+        @onetime_proc = nil
+        @container = nil
+        @component_class = component_class
+        @concreate_class = nil
+        @component_name = component_name.nil? ? Seasar::Util::ClassUtil.ub_name(component_class) : component_name
+        @component_deployer = nil
+        @arg_defs   = []
+        @property_defs = {}
+        @aspect_defs   = []
+        @instance_def    = Seasar::Container::Deployer::InstanceDefFactory.get_instance_def(InstanceDef::SINGLETON_NAME)
+        @autobinding_def = Seasar::Container::Assembler::AutoBindingDefFactory.get_autobinding_def(AutoBindingDef::AUTO_NAME)
+      end
+      attr_accessor :container, :component_class, :component_name, :instance_def, :autobinding_def
+      attr_accessor :procedure, :onetime_proc
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Object
+      #
+      def get_component
+        return self.get_component_deployer.deploy
+      end
+      alias component get_component
+
+      #
+      # - args
+      #   1. Seasar::Container::S2Container <em>container</em>
+      # - return
+      #   - none
+      #
+      def container=(container)
+        @container = container
+        @arg_defs.each {|i| i.container = container}
+        @property_defs.each {|i, v| v.container = container}
+        @aspect_defs.each {|i| i.container = container}
+      end
+
+      #
+      # - args
+      #   1. Integer <em>index</em>
+      # - return
+      #   - Seasar::Container::ArgDef
+      #
+      def get_arg_def(index)
+        return @arg_defs[index]
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Integer
+      #
+      def get_arg_def_size
+        return @arg_defs.length
+      end
+
+      #
+      # - args
+      #   1. Seasar::Container::ArgDef <em>arg_def</em>
+      # - return
+      #   - none
+      #
+      def add_arg_def(arg_def)
+        if arg_def.container.nil?
+          arg_def.container = @container
+        end
+        @arg_defs << arg_def
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Array
+      #
+      def get_arg_defs
+        return @arg_defs
+      end
+
+      #
+      # - args
+      #   1. Symbol <em>property_name</em>
+      # - return
+      #   - Boolean
+      #
+      def has_property_def(property_name)
+        return @property_defs.key?(property_name)
+      end
+
+      #
+      # - args
+      #   1. String <em>property_name</em>
+      # - return
+      #   - Seasar::Container::PropertyDef
+      #
+      def get_property_def(property_name)
+        return @property_defs[property_name]
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Array
+      #
+      def get_property_defs
+        return @property_defs
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Integer
+      #
+      def get_property_def_size
+        return @property_defs.length
+      end
+
+      #
+      # - args
+      #   1. Seasar::Container::PropertyDef <em>property_def</em>
+      # - return
+      #   - none
+      #
+      def add_property_def(property_def)
+        if property_def.container.nil?
+            property_def.container = @container
+        end
+        @property_defs[property_def.property_name] = property_def
+      end
+
+      #
+      # - args
+      #   1. Integer <em>index</em>
+      # - return
+      #   - Seasar::Container::AspectDef
+      #
+      def get_aspect_def(index)
+        return @aspect_defs[index]
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Integer
+      #
+      def get_aspect_def_size()
+        return @aspect_defs.length
+      end
+
+      #
+      # - args
+      #   1. Seasar::Container::AspectDef <em>aspect_def</em>
+      # - return
+      #   - none
+      #
+      def add_aspect_def(aspect_def)
+        @concreate_class = nil
+        if aspect_def.container.nil?
+            aspect_def.container = @container
+        end
+        @aspect_defs << aspect_def
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Seasar::Container::Deployer::AbstractComponentDeployer
+      #
+      def get_component_deployer
+        if @component_deployer.nil?
+          @component_deployer = @instance_def.create_component_deployer(self)
+        end
+        return @component_deployer
+      end
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - Class
+      #
+      def get_concreate_class
+        if @aspect_defs.length == 0
+            return @component_class
+        end
+        if not @concreate_class.nil?
+            return @concreate_class
+        end
+        @concreate_class = Seasar::Aop::S2AopFactory.create(@component_class, @aspect_defs.map {|aspect_def| aspect_def.aspect})
+        return @concreate_class
+      end
+    end
+  end
+end

data/lib/seasar/container/component-info-def.rb

@@ -0,0 +1,117 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    class ComponentInfoDef
+      @@auto_namespace = false
+
+      class << self
+        #
+        # - args
+        #   1. Boolean <em>val</em>
+        # - return
+        #   - none
+        #
+        def auto_namespace=(val); @@auto_namespace = val; end
+
+        #
+        # - args
+        #   - none
+        # - return
+        #   - Boolean
+        #
+        def auto_namespace; return @@auto_namespace; end
+      end
+
+      # - args
+      #   1. Hash <em>options</em>
+      #   1. Proc <em>procedure</em>
+      def initialize(options, &procedure)
+        @component_class = options[:class]
+        @component_name  =  options[:name]
+        @instance    = options[:instance]
+        @autobinding = options[:autobinding]
+        @namespace   = options[:namespace]
+        @procedure   = procedure
+      end
+      attr_accessor :component_class, :component_name, :instance, :autobinding, :namespace, :procedure
+
+      #
+      # - args
+      #   - none
+      # - return
+      #   - String
+      #
+      def namespace
+        return @namespace unless @namespace.nil?
+        if @@auto_namespace
+          @namespace = Seasar::Util::ClassUtil.module_name(@component_class).gsub(/::/, '.')
+        end
+        return @namespace
+      end
+
+      #
+      # - args
+      #   1. Symbol <em>key</em>
+      # - return
+      #   - Object
+      #
+      def [](key)
+        return self.instance_variable_get(key)
+      end
+
+      #
+      # - args
+      #   1. Objectn <em>matcher</em>
+      # - return
+      #   - Boolean
+      #
+      def match(matcher)
+        case
+        when matcher.is_a?(Regexp)
+          if @component_name.is_a?(String)
+            if matcher.match(@component_name)
+              return true
+            end
+          end
+          return matcher.match(@component_class.name)
+        when matcher.is_a?(Class)
+          return @component_class == matcher
+        when matcher.is_a?(Module)
+          return @component_class.name.match(/^#{matcher.name}::/)
+        when matcher.is_a?(String)
+          return (matcher == @component_name or matcher == @component_class.name)
+        when matcher.is_a?(Symbol)
+          return (matcher == @component_name or matcher == @component_class.name.to_sym)
+        else
+          raise ArgumentError.new("unsupported argument #{matcher}")
+        end
+      end
+
+      def ==(other)
+        @component_class == other.component_class &&
+        @component_name  == other.component_name &&
+        @instance == other.instance &&
+        @autobinding == other.autobinding &&
+        self.namespace() == other.namespace() &&
+        @procedure == other.procedure
+      end
+    end
+  end
+end

data/lib/seasar/container/deployer/abstract-component-deployer.rb

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Deployer
+      # コンポーネントを組み立てる抽象クラスです。
+      class AbstractComponentDeployer
+
+        # AbstractComponentDeployerを構築します。
+        # - args
+        #   1. Seasar::Container::ComponentDef <em>component_def</em>
+        def initialize(component_def)
+          @component_def = component_def
+          @constructor_assembler = nil
+          @property_assembler    = nil
+          self.setup_assembler
+        end
+
+        # デフォルトのアセンブラインスタンスを作成します。
+        # - args
+        #   - none
+        # - return
+        #   - none
+        def setup_assembler
+          @constructor_assembler = @component_def.autobinding_def.create_constructor_assembler(@component_def)
+          @property_assembler    = @component_def.autobinding_def.create_property_assembler(@component_def)
+        end
+      end
+    end
+  end
+end

data/lib/seasar/container/deployer/instance-def-factory.rb

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Deployer
+
+      # インスタンスの管理方法を表すクラスを生成・管理するファクトリクラスです。
+      class InstanceDefFactory
+
+        @@instance_defs = {}
+
+        #InstanceDefを追加します。
+        # - args
+        #   1. Seasar::Container::InstanceDef <em>instance_def</em>
+        # - return
+        #   - none
+        def InstanceDefFactory.add_instance_def(instance_def)
+          @@instance_defs[instance_def.name] = instance_def
+        end
+
+        # 指定された名前のInstanceDefを返します。
+        # - args
+        #   1. Symbol <em>name</em>
+        # - return
+        #   - Seasar::Container::InstanceDef
+        def InstanceDefFactory.get_instance_def(name)
+          if not @@instance_defs.key?(name)
+            raise Seasar::Container::Exception::IllegalInstanceDefRuntimeException.new(name)
+          end
+          return @@instance_defs[name]
+        end
+      end
+
+      # InstanceDefFactoryに初期値としてInstanceDefを登録します。
+      InstanceDefFactory.add_instance_def(InstanceSingletonDef.new(Seasar::Container::InstanceDef::SINGLETON_NAME))
+      InstanceDefFactory.add_instance_def(InstancePrototypeDef.new(Seasar::Container::InstanceDef::PROTOTYPE_NAME))
+      InstanceDefFactory.add_instance_def(InstanceOuterDef.new(Seasar::Container::InstanceDef::OUTER_NAME))
+    end
+  end
+end

data/lib/seasar/container/deployer/instance-outer-def.rb

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Deployer
+
+      # インスタンスの管理をOuter Componentと定義するクラスです。
+      class InstanceOuterDef < Seasar::Container::InstanceDef
+
+        # InstanceOuterDefを構築します。
+        # - args
+        #   1. Symbol <em>name</em>
+        def initialize(name)
+          @name = name
+        end
+
+        # OuterComponentDeployerを生成します。
+        # - args
+        #   1. Seasar::Container::ComponentDef <em>component_def</em>
+        # - return
+        #   - Seasar::Container::Deployer::OuterComponentDeployer
+        def create_component_deployer(component_def)
+          return OuterComponentDeployer.new(component_def)
+        end
+      end
+    end
+  end
+end

data/lib/seasar/container/deployer/instance-prototype-def.rb

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Deployer
+
+      # インスタンスの管理をPrototypeと定義するクラスです。
+      class InstancePrototypeDef < Seasar::Container::InstanceDef
+
+        # InstancePrototypeDefを構築します。
+        # - args
+        #   1. Symbol <em>name</em>
+        def initialize(name)
+          @name = name
+        end
+
+        # PrototypeComponentDeployerを生成します。
+        # - args
+        #   1. Seasar::Container::ComponentDef <em>component_def</em>
+        # - return
+        #   - Seasar::Container::Deployer::PrototypeComponentDeployer
+        def create_component_deployer(component_def)
+          return PrototypeComponentDeployer.new(component_def)
+        end
+      end
+    end
+  end
+end

data/lib/seasar/container/deployer/instance-singleton-def.rb

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+#--
+# +----------------------------------------------------------------------+
+# | Copyright 2005-2008 the Seasar Foundation and the Others.            |
+# +----------------------------------------------------------------------+
+# | Licensed under the Apache License, Version 2.0 (the "License");      |
+# | you may not use this file except in compliance with the License.     |
+# | You may obtain a copy of the License at                              |
+# |                                                                      |
+# |     http://www.apache.org/licenses/LICENSE-2.0                       |
+# |                                                                      |
+# | Unless required by applicable law or agreed to in writing, software  |
+# | distributed under the License is distributed on an "AS IS" BASIS,    |
+# | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,                        |
+# | either express or implied. See the License for the specific language |
+# | governing permissions and limitations under the License.             |
+# +----------------------------------------------------------------------+
+#++
+module Seasar
+  module Container
+    module Deployer
+      #インスタンスの管理をSingletonと定義するクラスです。
+      class InstanceSingletonDef < Seasar::Container::InstanceDef
+        # InstanceSingletonDefを構築します。
+        # - args
+        #   1. Symbol <em>name</em>
+        def initialize(name)
+          @name = name
+        end
+
+        # SingletonComponentDeployerを生成します。
+        # - args
+        #   1. Seasar::Container::ComponentDef <em>component_def</em>
+        # - return
+        #   - Seasar::Container::Deployer::SingletonComponentDeployer
+        def create_component_deployer(component_def)
+          return SingletonComponentDeployer.new(component_def)
+        end
+      end
+    end
+  end
+end