ShapeDiver.ContainerCastleWindsor 1.17.0-beta

ShapeDiver IOC Container using Castle Windsor

This package provides an implementation of ShapeDiver.ContainerInterfaces using the Castle Windsor Inversion of Control container.

This implementation is used by the ShapeDiver Plugin for Rhino and Grasshopper as well as other software packages provided by ShapeDiver.

How to get support

• ShapeDiver APIs and SDKs help pages
• ShapeDiver Forum

Examples

We provide examples on how to use the SDK on github and .NET Fiddle. Ask us on the Forum if you don’t understand how they work, or you want suggest further examples to be added.

Usage

using Castle.Windsor;
using Castle.Windsor.Installer;
using ShapeDiver.Common.Container;

// create a windsor container, install implementations from the ShapeDiver Castle Windsor assembly
var windsorContainer = new WindsorContainer();
windsorContainer.Install(FromAssembly.Named("SdContainerCastleWindsor"));

// resolve the implementation of the ShapeDiver IOC container wrapper for Castle Windsor 
IIocContainer container = windsorContainer.Resolve<IIocContainer>();
container.SetContainer(windsorContainer);

// install from other assemblies that contain implementations you want to resolve
container.InstallFromAssembly("ShapeDiverSDK");

// register typed factories
container.RegisterTypedFactories();

// configure the container
container.Configure();

// late dependency resolution
container.ResolveLateDependencies();

Now you can resolve implementations, an example for the ShapeDiver SDK for .NET:

using ShapeDiver.SDK;

var sdk = container.Resolve<IShapeDiverSDK>();

Notes

Conventions

IIocContainer.InstallFromAssembly uses the following convention for registering implementations:

Say you defined an interface called IMyService, then InstallFromAssembly will strip off the leading I and look for matching implementations whose name contain MyService. In case the name of the implementation ends with Singleton or Factory it will be registered as a singleton. Otherwise it will be registered using transient lifestyle, i.e. every call to Resolve will create a new instance.

Typed factories

Typed factories are a very useful feature of Castle Windsor, read more about it here.

IIocContainer.RegisterTypedFactories will try to register all interfaces whose name end with TypedFactory as a typed factory.

Container configuration

In some cases you might want to automatically configure your container. If so, implement the IIocConfiguration interface. The call to IIocContainer.Configure will resolve all implementations of IIocConfiguration and call them. Typically you want to call this before calling IIocContainer.ResolveLateDependencies.

Late dependency resolving

Some of your implementations might want to resolve all implementations of an interface after installation of implementations from all assemblies. In that case implement INeedsLateDependencyResolving for your implementation. The call to IIocContainer.ResolveLateDependencies will resolve all implementations of INeedsLateDependencyResolving and call them. Typically you want to call this as the very last step before using the container.