castle.windsor 2.1.0.0 → 2.5.0.0

data/docs/BreakingChanges.txt

@@ -0,0 +1,229 @@
+================================================================================================
+change - ILazyComponentLoader.Load now accepts a third argument for additional arguments.
+
+impact - medium
+fixability - easy
+revision - 
+
+description - To allow maximum flexibility and usage with Resolve, any additional arguments
+   are now passed to the lazy loader.
+================================================================================================
+change - LifecycleStepCollection class was removed. Instaed LifecycleConcernsCollection class
+	was introduced. ILifecycleConcern has now two innerited interfaces for commission and
+	decommission. LifecycleSteps property of ComponentModel was renamed to Lifecycle.
+	LifecycleStepType type was removed.
+
+impact - medium
+fixability - easy
+revision - 
+
+description - To improve strongly typed nature and decrease probability of mistake and improve
+	general usability of the type LifecycleStepCollection was removed. In it place similar type
+	was introduced - LifecycleConcernsCollection. Instead of using untyped Objects and enums
+	it works with two new interfaces : ICommissionConcern and IDecommissionConcern.
+
+fix - have your lifecycle steps implement one of the new lifecycle interfaces. Use appropriate
+	overload of Add/AddFirst to add them.
+================================================================================================
+change - Typed Factories will not implicitly pick default ITypedFactoryComponentSelector 
+	registered in the container anymore
+
+impact - low
+fixability - easy
+revision - 
+
+description - In version 2.1 where ITypedFactoryComponentSelectors were introduced, when you had
+	a selector registered in the container that selector would be implicitly picked for every
+	factory you had. Since the behavior of a selector tends to be fine grained and targetet for
+	a specific factories, this behavior was removed. You have to explicitly associate the selector
+	with a factory (using .AsFactory(f => f.SelectUsing("MySelector")); or via xml configuration)
+	to override selection behavior.
+
+fix - using either fluent API .AsFactory(f => f.SelectUsing("MySelector")), or XML configuration
+	selector="${MySelector}" specify the selector explicitly for each of your factories.
+================================================================================================
+change - ServiceSelector delegate (used in WithService.Select calls) changed signature
+
+impact - low
+fixability - easy
+revision - 
+
+description - To fix a bug which would occur if type implemented multiple closed version of base
+	open generic interface the signature of the delegate was changed from
+	public delegate IEnumerable<Type> ServiceSelector(Type type, Type baseType);
+	to
+	public delegate IEnumerable<Type> ServiceSelector(Type type, Type[] baseTypes);
+	so that multiple base types are possible (they would be closed versions of the same open
+	generic interface)
+
+fix - depending on the scenario. You would either ignore it, or wrap your current method's body
+	in foreach(var baseType in baseTypes)
+================================================================================================
+change - moved IWindsorInstaller to Castle.MicroKernel.Registration namespace
+
+impact - very low
+fixability - easy
+revision - 
+
+description -In order to improve developer experience when writing installers the interface
+	was moved so that Component and AllTypes entry types for registration are already in scope.
+
+fix - add using Castle.MicroKernel.Registration directive.
+================================================================================================
+change - Added two new overloads to ITypeConverter.PerformConversion
+
+impact - very low
+fixability - easy
+revision - 
+
+description - To reduce casting in the most common scenario where converted value is casted to
+	the type it's been converted to, ITypeConverter.PerformConversion has now generic overloads
+	for handling this case.
+
+fix - If you're implementing ITypeConverter via AbstractTypeConverter you don't have to do
+	anything as the base class will handle the conversion for you. Otherwise implement it like
+	in AbstractTypeConverter.
+
+================================================================================================
+change - AddCustomComponent method were moved from IKernel to IKernelInternal interface
+
+impact - very low
+fixability - easy
+revision - 
+
+description - This method constitute internally used contract of kernel and is not intended
+	for external usage. As such it was moved to internal interface to declutter public
+	interface of IKernel.
+
+fix - You should not have been using this method so it should not affect you in any way. If
+	you did, cast the IKernel to IKernelInternal to invoke the method.
+
+================================================================================================
+change - IModelInterceptorsSelector.SelectInterceptors method changed its signature and how it
+	is used.
+
+impact - medium
+fixability - medium
+revision - 
+
+description - To accomodate additional scenarios that were impossible (or hard to achieve
+	with previous design the method now has additional parameter, an array of references to
+	interceptors, which contains either default interceptors for the component, or interceptors
+	selected by previous interceptors in line). Also, Windsor will now never call
+	IModelInterceptorsSelector.SelectInterceptors without calling 
+	IModelInterceptorsSelector.HasInterceptors before it, or when the latter returns false.
+
+fix - When adjusting your implementation remember that model's interceptors are the default value
+	passed as methods second parameter, so you don't need to merge them again manually (otherwise
+	they'll be invoked twice).
+
+================================================================================================
+change - CreateComponentActivator, RaiseHandlerRegistered, RaiseHandlersChanged and
+	 RegisterHandlerForwarding methods were moved from IKernel to IKernelInternal interface
+
+impact - very low
+fixability - easy
+revision - 
+
+description - These methods constitute internally used contract of kernel and are not intended
+	for external usage. As such they were moved to internal interface to declutter public
+	interface of IKernel.
+
+fix - You should not have been using these methods so it should not affect you in any way. If
+	you did, cast the IKernel to IKernelInternal to invoke the methods.
+
+================================================================================================
+change - IProxyHook interface was removed
+
+impact - very low
+fixability - easy
+revision - 
+
+description - Since MicroKernel was merged with Windsor and now depends on DynamicProxy directly
+	there's no need to provide additional abstraction on top of IProxyGenerationHook.
+
+fix - Make types that were implementing IProxyHook to implement IProxyGenerationHook. Change all
+	usages of IProxyHook to IProxyGenerationHook.
+
+================================================================================================
+change -  AddInstallerConfiguration and GetComponents methods were added to IConfigurationStore.
+
+impact - very low
+fixability - easy
+revision - 3bf716cc6fc218601dab92a6dd75fe269bcb63d0
+
+description - To enable installers to be exposed via configuration the interface has been 
+	extended by addition of the two methods.
+
+fix - Implement the methods accordingly to your situation.
+
+================================================================================================
+change - Multiple types were moved between namespaces
+
+impact - low
+fixability - trivial
+revision - 3bf716cc6fc218601dab92a6dd75fe269bcb63d0
+
+description - To improve the internal structure several types were moved to other namespaces.
+
+fix - When compilation error occurs adjust namespace imports as suggested by Visual Studio
+
+================================================================================================
+change - Assembly Castle.MicroKernel.dll was merged into Castle.Windsor.dll
+
+impact - high
+fixability - easy
+revision - 730b202b0ed23a6b42258a6ffd6a3e63f89501fc
+
+description - Since vast majority of users used Windsor, as opposed to bare MicroKernel it was
+	decided it didn't make sense to maintain two containers. As result of that their assemblies
+	were merged, as first step of integration between Windsor and MicroKernel.
+
+fix - In your projects remove reference to Castle.MicroKernel.dll. If you weren't using Windsor
+	add reference to Castle.Windsor.dll
+	In all places where your were referencing types from Castle.MicroKernel.dll via string
+	(like xml configuration when registering facilities, or <httpModules> section on your 
+	web.config) update references from Castle.MicroKernel to Castle.Windsor.
+
+================================================================================================
+change - ComponentRegistration<S>.Startable public method has been removed.
+	ComponentRegistration<S>.StartUsingMethod public method was moved to extension method.
+	ComponentRegistration<S>.StopUsingMethod public method was moved to extension method.
+
+impact - low
+fixability - trivial
+revision - 6710
+
+description - StartUsingMethod/StopUsingMethod belong to StartableFacility and do not make sense
+	as part of generic API. Startable method was superfluous.
+
+fix - Remove calls to Startable(). Import namespace Castle.Facilities.Startable to use
+	StartUsingMethod and StopUsingMethod as extension methods.
+
+================================================================================================
+change - DefaultProxyFactory.CreateProxyGenerationOptionsFrom protected method  and
+	DefaultProxyFactory.CustomizeProxy protected virtual method have changed signature
+
+impact - very low
+fixability - easy
+revision - 6691
+
+description - the methods now also takes IKernel and CreationContext, to be used by IReferences
+	to do resolution of components they reference
+
+fix - pass required parameters to the methods.
+
+================================================================================================
+change - ProxyOption's properties changed types: 
+	Selector, from IInterceptorSelector to IReference<IInterceptorSelector>
+	Hook from IProxyHook to IReference<IProxyHook>
+	MixIns from object[] to IEnumerable<IReference<object>>
+
+impact - very low
+fixability - easy
+revision - 6691
+
+description - the properties now use IReferences instead of live objects to allow for
+	resolution of their values from the container, as required in case of usage from xml.
+
+fix - wherever used, adjust types appropriately. To obtain actual objects, use Resolve method.

data/docs/{ReleaseNotes/Changes.txt → Changes.txt}

@@ -1,3 +1,180 @@
+2.5.0 (2010-08-21)
+
+- debugger view support has been extracted to a separate subsystem (IContainerDebuggerExtensionHost) and can be extended by users code via IContainerDebuggerExtension and IComponentDebuggerExtension
+
+- calling IHandler.TryStart will no longer silently ignore all the exceptions.
+
+- added CollectionResolver which is a more general version of ArrayResolver and ListResolver and supports in addition ICollection<Foo> and IEnumerable<Foo>
+
+- fixed issue where dependencies would not be cleaned up when component creation failed
+
+- fixed issue where startable component would be created twice when property dependency could not be resolved
+
+- passing arguments to ILazyComponentLoader (see breakingchanges.txt)
+
+- fixed bug that caused exception when proxied component and it's proxied property dependency shared interceptor
+
+2.5.0 beta2 (2010-07-21)
+==================
+
+- added support for selecting components based on custom attributes and their properties. See Component.HasAttribute<T>() methods
+
+- added WithService.DefaultInterface() to fluent API.IT matches Foo to IFoo, SuperFooExtended to IFoo and IFooExtended etc
+
+- added support for CastleComponentAttribute in fluent Api. Also added helper filter method Component.IsCastleComponent
+
+- added ability to specify interceptors selector as a service, not just as instance
+
+- added ability to specify proxy hook in fluent API: 
+
+- indexers on IKernel are now obsolete.
+
+- added WithAppConfig() method to logging facility to point to loging configuration in AppDomain's config file (web.config or app.config)
+
+- Restructured lifecycle concerns - introduced ICommissionConcern and IDecommissionConcern and favors them over old enum driven style.
+
+- Fixed how contextual arguments are handled. Null is no longer considered a valid value (That would cause an exception later on, now it's ignored).
+
+- Changed method DeferredStart on StartableFacility. It now does not take a bool parameter. A DeferredTryStart() method was introduced instead.
+
+2.5.0 beta1 (2010-07-05)
+==================
+- Typed Factories will not implicitly pick default ITypedFactoryComponentSelector registered in the container anymore
+
+- Obsoleted all the AddComponent* methods in favor of using Installers and fluent registration API
+
+- ServiceSelector delegate (used in WithService.Select calls) changed signature to fix a bug: http://3.ly/eP5Q
+
+- moved IWindsorInstaller to Castle.MicroKernel.Registration namespace
+
+- typed factories will now obey container release policy, that is if the container does not track the component, so won't the factory.
+
+- added helper methods to fluently configure logging facility using: container.AddFacility<LoggingFacility>( f = > f.Fluent().Magic().Here() );
+
+- added overload for UsingFactoryMethod which exposees ComponentModel of component to the factory
+
+- added generic overloads for ITypeConverter.PerformConversion to reduce casting.
+
+- it is now possible to call WithService.Foo().WithService.Bar() and both services will be used. Also more methods were added: WithService.Self() and WithService.AllInterfaces()
+
+- added simple debugger visualizer to help diagnosing misconfigured components.
+
+- added optimized mode to StartableFacility for Single-call-to-Install scenario that won't start anything before the end of Install (at which point the container is assumed to be completely configured and all components should be there) and it will throw if it can't resolve and start the component.
+
+- added OptimizeDependencyResolution around calls to Install
+
+- Component.IsInNamespace and its sister methods have now overload that let you include components from subnamespaces as well.
+
+- added ability to load assemblies from designated directory (with fair bit of optional filtering using new AssemblyFilter class). It works in three places:
+	- AllTypes.FromAssemblyInDirectory() - picks assemblies for registration
+	- FromAssembly.InDirectory() - installs installers from assemblies in the directory
+	- <install directory="" /> - installs installers from assemblies in directory via XML
+
+- TypedFactoryFacility - added ability to configure factory inline: Component.For<IFooFactory>().AsFactory(f => f.SelectedWith("selectorKey")) 
+
+- Changed IModelInterceptorSelector's signature and behavior (see breakingChanges.txt for details)
+
+- removed IProxyHook interface (see breakingchanges.txt)
+
+- added support for specifying typed factory component selectors on a per-factory basis
+
+- added support for using services as mixins
+
+- added autogenerated delegate-based factories. Taking dependency on Func<IFoo> and calling the delegate will return IFoo from the container
+
+- implemented IOC-ISSUE-203 - Add to fluent API scanning assemblies for IWindsorInstallers and installing them
+
+- added fluent API for EventWiringFacility
+
+- added ability to specify assemblies that will be scanned for types when shorthened type name is using via XML using the following syntax:
+	<using assembly="Assembly name or path to file.dll" />
+
+- added ability to specify installers (IWindsorInstaller) via XML using either of the following:
+  <installers>
+	<install type="Castle.Windsor.Tests.Installers.CustomerInstaller"/>
+	<install assembly="Castle.Windsor.Tests"/>
+  </installers>
+  installers must be public and have default constructor.
+
+- Xml config does not require assembly qualified type name any more - specifying just type name, or typename+namespace should be enough. Works only for types in already loaded assemblies.
+
+- ResolveAll will now resolve components that are not in Valid state when inline/dynamic arguments are provided
+
+- TypedFactoryFacility: TypedFactoryComponent will now fallback to resolving by type if no component with designated name can be found
+
+- fixed issue with per-web-request components not being released properly in some cases
+
+- fixed IOC-ISSUE-199 - NamingPartsSubSystem broken when RegisterHandlerForwarding is used
+
+- TypedFactoryFacility: added ability to resolve multiple components
+
+- TypedFactoryFacility: added ability to put custom resolving logic
+
+- fixed another case of IoC-168 where a component with two constructors of different parameter length couldn't be resolved when the fewer parameter constructor was not satisfied
+
+- If and Unless functions on fluent registration API are now cumulative - it is legal to call them multiple times and all conditions will be checked. This is a minor breaking change from previous behavior where last call would win.
+
+- added typed arguments (specified by type rather than by name).
+	It works for:
+	- call site (Resolve with Dictionary, specifying System.Type as value of key. A helper class 'Arguments' should be used for this.)
+	- DynamicParameters - there's an extension method Insert that should make using it nicer
+	- fluent Api (DependsOn(Property.ForKey<string>().Eq("typed"))
+
+- added 'Insert' extension method on IDictionary, specifically so simplify usage in DynamicParameters method and similar situations. It behaves like IDictionary's indexer setter
+
+- added 'Arguments' class to carry inline arguments (typed or named) for components. It is recommended to use this class rather than Hashtable or Dictionary<>
+
+- added strongly typed overloads for StartUsingMethod and StopUsingMethod from startable facility's registration API. It is now possible to call .StartUsingMethod(x => x.Start).StopUsingMethod(x => x.Stop)
+
+- moved StartUsingMethod/StopUsingMethod to extension methods in StartableFacility's namespace. Startable() method was removed as superfluous.
+
+- changed the UsingFactoryMethod (and UsingFactory) methods in fluent registration API to not rely on FactorySupportFacility. They now work even if facility is not used.
+
+- fixed IOC-ISSUE-190 - "Resolve with argumentsAsAnonymousType overload is now case sensitive".
+	This fixed a regression bug introduced in v2.1, and brings the behavior back to what it was in v2.0.
+
+- added support for specifying interceptorsSelector, proxyHook and mixins from config (see new tests for example). This also means some small impact breaking changes:
+	- DefaultProxyFactory.CreateProxyGenerationOptionsFrom protected method has changed signature - it now also takes IKernel and CreationContext, to be used by IReferences to do resolve (see below)
+	- DefaultProxyFactory.CustomizeProxy protected virtual method has changed signature, for the same reason as above
+	- ProxyOption's properties changed types: 
+		Selector, from IInterceptorSelector to IReference<IInterceptorSelector>
+		Hook from IProxyHook to IReference<IProxyHook>
+		MixIns from object[] to IEnumerable<IReference<object>>
+	IReference abstraction allows to use components resolved from the container, similar to InterceptorReferences.
+
+- Moved several types from Core:
+	ComponentActivatorAttribute
+	ComponentProxyBehaviorAttribute
+	CustomLifestyleAttribute
+	DoNotWireAttribute      
+	InterceptorAttribute    
+	LifestyleAttribute
+	PooledAttribute
+	TransientAttribute
+	GraphNode
+	IVertex
+	IRecyclable
+	IStartable
+	ComponentModel
+	ConstructorCandidate
+	ConstructorCandidateCollection
+	DependencyModel
+	DependencyModelCollection
+	InterceptorReference
+	InterceptorReferenceCollection
+	LifecycleStepCollection
+	MethodMetaModel
+	MethodMetaModelCollection
+	ParameterModel
+	ParameterModelCollection
+	PropertySet
+	PropertySetCollection
+	TopologicalSortAlgo
+	IOnBehalfAware
+	GraphSets
+	GraphTestCase
+
+
 2.1.1 (2010-01-13)
 ==================
 - Reverted factory support facility changes in r6595, r6596 and r6653 which fixed IOC-ISSUE-153, however caused other bugs
@@ -7,11 +184,11 @@
 ==================
 - Moved the logging facility project into the Windsor project:
   - Applied Tom Allard's patch fixing FACILITIES-93
-    "Extra constructors on LoggingFacility"
+	"Extra constructors on LoggingFacility"
   - Added test case supplied by chris ortman
   - Register base logger and factory when using extended logger.
   - Fixed FACILITIES-77
-    "ILoggerFactory instance creation requires constructor with one argument"
+	"ILoggerFactory instance creation requires constructor with one argument"
 
 - simplified API for attaching interceptors.
 
@@ -270,27 +447,27 @@ RC 4
 -- Introduces the KeySearchNamingSubSystem
 
 -- Allows you to associate a custom component activator using
-    1. componentActivatorType on component node
-    2. ComponentActivatorAttribute
+	1. componentActivatorType on component node
+	2. ComponentActivatorAttribute
 
 -- Allows you to create and configure child containers 
    through the configuration, using
 
   <configuration>
-    <containers>
-        <container name="child1">
-          <configuration>
-                <facilities>
+	<containers>
+		<container name="child1">
+		  <configuration>
+				<facilities>
 					...
-                </facilities>
-          
-                <components>
+				</facilities>
+		  
+				<components>
 					...
-                </components>
-                
-            </configuration>
-        </container>
-    </containers>
+				</components>
+				
+			</configuration>
+		</container>
+	</containers>
   </configuration>
 
 - Applied AndyD's patch fixing IOC-52
@@ -375,7 +552,7 @@ RC 3
   an object per web request.  To use it you must add the following http module
 
   <httpModules>
-      ...
+	  ...
 	  <add name="PerWebRequest" type="Castle.MicroKernel.Lifestyle.PerWebRequestLifestyleManager , Castle.MicroKernel,Version=0.0.1.7, Culture=neutral, PublicKeyToken=407dd0808d44fbdc"/>
 
   <httpModules>
@@ -390,7 +567,7 @@ RC 3
   
   - None: No properties inspection should happen
   - All: All properties will be inspected and collected (on the class and on the superclasses). 
-         This is the default behavior
+		 This is the default behavior
   - DeclaredOnly: Only properties specified on type are checked (superclasses will be ignored) 
 
 - Added overload to ITypeConvertor that accept the current node configuration as well as the type in CanHandleType()
@@ -419,14 +596,14 @@ RC 3
   
 
 - Applied patch by Alex Henderson <webmaster@bittercoder.com> adding
-    IWindsorContainer.RemoveChildContainer(IWindsorContainer childContainer)
-    and IKernel.RemoveChildKernel(IKernel kernel)
+	IWindsorContainer.RemoveChildContainer(IWindsorContainer childContainer)
+	and IKernel.RemoveChildKernel(IKernel kernel)
 
 - Applied fix by Ahmed. Now defines can be used on properties nodes like
 
   <properties>
    <?if DEBUG?>
-    <item>x</item>
+	<item>x</item>
    <?end?>
   </properties>
 
@@ -442,38 +619,38 @@ using #{propertyName} syntax.(Patch from Ahmed)
   Example:
 
   <configuration>
-    <properties>
-       <MyComponentParams>
-         <user>Joe</user>
-         <pwd>Doe</pwd>
-       </MyComponentParams>
-     </properties>
-     <components id=??Component
-       <parameters>#{ MyComponentParams }</parameters>
-     </components>
+	<properties>
+	   <MyComponentParams>
+		 <user>Joe</user>
+		 <pwd>Doe</pwd>
+	   </MyComponentParams>
+	 </properties>
+	 <components id=??Component
+	   <parameters>#{ MyComponentParams }</parameters>
+	 </components>
   </configuration>
   
   Will result in 
 
-     <components id=??Component
-       <parameters>
-         <user>Joe</user>
-         <pwd>Doe</pwd>
-       </parameters>
-     </components>
+	 <components id=??Component
+	   <parameters>
+		 <user>Joe</user>
+		 <pwd>Doe</pwd>
+	   </parameters>
+	 </components>
 
 - Type converter for kernel components. This allows a usage like this:
 
   <component id="mycomp">
   
-    <parameters>
-      <servicelist>
-        <list type="IMyService, MyAssembly">
-          <item>${keytocomponent1}</item>
-          <item>${keytocomponent2}</item>
-        </list>
-      </servicelist>
-    </parameters>
+	<parameters>
+	  <servicelist>
+		<list type="IMyService, MyAssembly">
+		  <item>${keytocomponent1}</item>
+		  <item>${keytocomponent2}</item>
+		</list>
+	  </servicelist>
+	</parameters>
 
 - Removed support for MethodMeta on ComponentModel. The design decision here 
   is to make the facilities interested on it to extend MethodMetaInspector
@@ -518,9 +695,9 @@ RC 2
 - Support for custom lifestyle through configuration (kudos to Bawer Dagdeviren):
 
   <component id="my.component"
-                   type="MyLib.MyComponent, MyLib"
-                   lifestyle="custom"
-                   customLifestyleType="MyLib.MyCustomLifestyle, MyLib" />
+				   type="MyLib.MyComponent, MyLib"
+				   lifestyle="custom"
+				   customLifestyleType="MyLib.MyCustomLifestyle, MyLib" />
 
 - Added Type converter for enums
 
@@ -548,21 +725,21 @@ RC 2
   which are accessible through Uris:
 
   - FileResource:  
-    file://pathtofile 
-    (For example: file://c:\mydir\file.txt)
+	file://pathtofile 
+	(For example: file://c:\mydir\file.txt)
 
   - AssemblyResource:  
-    assembly://AssemblyName/ExtendingNamespace/filename 
-    (For example: assembly://Castle.Windsor.Tests/Configuration2/include1.xml)
+	assembly://AssemblyName/ExtendingNamespace/filename 
+	(For example: assembly://Castle.Windsor.Tests/Configuration2/include1.xml)
 
   - ConfigResource:  
-    config://sectioname 
-    (For example: config://castle will fetch the 
-    <configuration><castle> entry in the configuration)
+	config://sectioname 
+	(For example: config://castle will fetch the 
+	<configuration><castle> entry in the configuration)
 
   - UncResource:  
-    \\server\file 
-    (For example: \\mysharedplace\myconfig.xml)
+	\\server\file 
+	(For example: \\mysharedplace\myconfig.xml)
 
 - IResource, IResourceFactory and IResourceSubSystem introduced
 
@@ -639,13 +816,13 @@ Beta 1  - 21/jan/2005
 - Added: support for dictionaries, lists and arrays on the configuration file.
 
   <component>
-    <parameters>
-      <properties>
-        <dictionary>
-          <item key="mykey">value</item>
-        </dictionary>
-      </properties>
-    </parameters>
+	<parameters>
+	  <properties>
+		<dictionary>
+		  <item key="mykey">value</item>
+		</dictionary>
+	  </properties>
+	</parameters>
   </component>
 
 - Added: Component Graph (used by the Remove method and to dispose the components)