Navigation (Windsor)¶

• Main Page
• Main Page (root)
  

• Random Page
• Create a new Page
• All Pages
• Categories
• Navigation Paths
  

• Administration
• File Management
  

• Create Account
  

• Missing pages
  

Search the wiki
»

This documentation is a work in progress.¶

Let us know if some information is not clear, inaccurate or missing. Also feel free to update the wiki yourself.

Using XML configuration

Introduction¶

Most often you use Fluent Registration API to register and configure components. However that's not the only way and Windsor has comprehensive support for XML configuration to accomplish some of the container related tasks.

What to use it for¶

XML configuration can be used to accomplish the following goals:

• provide configuration-time properties to your components (things like connection strings, addresses of services to talk to, admin email address)
• register installers
• register and configure components (using registration in code is recommended for doing that if possible)
• register and configure facilities (using registration in code is recommended for doing that if possible)
  

To make working with XML configuration easier it can be distributed among several files if you need to partition it.

XML config at a glance¶

The reference below presents all nodes and attributes that the container uses by default. The section above contains links leading to pages exploring them in greater details.

<configuration>
  <!--lets you reference types from that assembly by specifying just their name, instead of assembly qualified full name.-->
  <using assembly="Acme.Crm.Services, Version=1.0.0.0, Culture=neutral, PublicKeyToken=1987352536523" />

  <include uri="file://Configurations/services.xml" />
  <include uri="assembly://Acme.Crm.Data/Configuration/DataConfiguration.xml" />

  <installers>
    <install type="Acme.Crm.Infrastructure.ServicesInstaller, Acme.Crm.Infrastructure"/>
    <install assembly="Acme.Crm.Infrastructure"/>
  </installers>

  <properties>
    <connection_string>value here</connection_string>
  </properties>

  <facilities>
    <facility id="uniqueId" type="Acme.Common.Windsor.AcmeFacility, Acme.Common" />
  </facilities>

  <components>
    <component
      id="uniqueId"
      service="Acme.Crm.Services.INotificationService, Acme.Crm"
      type="Acme.Crm.Services.EmailNotificationService, Acme.Crm"
      inspectionBehavior="all|declaredonly|none"
      lifestyle="singleton|thread|transient|pooled|custom"
      customLifestyleType="type that implements ILifestyleManager"
      componentActivatorType="type that implements IComponentActivator"
      initialPoolSize="2" maxPoolSize="6">
      
      <forwardedTypes>
        <add service="Acme.Crm.Services.IEmailSender, Acme.Crm" />
      </forwardedTypes>

      <additionalInterfaces>
        <add interface="Acme.Crm.Services.IMetadataService, Acme.Crm" />
      </additionalInterfaces>

      <parameters>
        <paramtername>value</paramtername>
        <otherparameter>#{connection_string}</otherparameter>
      </parameters>

      <interceptors selector="${interceptorsSelector.id}" hook="${generationHook.id}">
        <interceptor>${interceptor.id}</interceptor>
      </interceptors>

      <mixins>
        <mixin>${mixin.id}</mixin>
      </mixins>

    </component>
  </components>
</configuration>

Loading XML configuration¶

There are two ways to install XML configuration into the container:

Using static Configuration class¶

You can install configuration from XML just like any other installer via Configuration class (read more)

Using constructor¶

Using WindsorContainer's constructor:

public WindsorContainer(IConfigurationInterpreter interpreter)

you can pass reference to XML configuration file right when the container is created.

IResource resource = new AssemblyResource("assembly://Acme.Crm.Data/Configuration/services.xml");
container = new WindsorContainer(new XmlInterpreter(resource));

In this case XML file embedded in Acme.Crm.Data assembly will be used.

You can also use parameterless constructor of XmlInterpreter in which case AppDomain config file will be used as source of configuration:

container = new WindsorContainer(new XmlInterpreter());