NanoContainer Core

NanoContainer Booter

NanoContainer Deployer

NanoContainer AOP

NanoContainer Persistence

NanoContainer Remoting

NanoContainer Web

Comparison of NanoContainer for Java with NanoContainer.NET

This section is useful for those familiar with the Java implementation of NanoContainer. An example of the differences are defined below.

I want to see an example!

So for the impatient lets take a quick look at how we would utilize Nano.NET. The following script registers an implementation (bar.Foo) under the key "hello".

using PicoContainer;
using PicoContainer.Defaults;

namespace WhateverNamespace
{
  public class MyNanoScript
  {
    private IPicoContainer parent;
    public IPicoContainer Parent
    {
      set { parent = value; } 
    }
	
    public IMutablePicoContainer Compose() 
    {
      DefaultPicoContainer p = new DefaultPicoContainer(parent);
      p.RegisterComponentImplementation("hello", typeof(bar.Foo));
      return p; 
    }
  }
}

Now there are 2 important things to notice with the above example.

1. A setter Property named Parent
2. The method public IMutablePicoContainer Compose()
   
   These are both requirements of any script that will be written. In other words every script written for NanoContainer.NET must have the equivalent Property and Method defined (this of course will vary based on the scripting language used).

It is also possible to define your script as an implementation of the NanoContainer.Script.IScript Interface. This interface defines both the Parent property and the Compose method. Regardless of whether your script implements the IScript interface NanoContainer will treat your script it as an instance of IScript.

Remember The purpose of a script is that it can be referenced, compiled and executed at Runtime not at Compile time. So if your script does not implement the Parent property or Compose method you will not receive an error until you execute your script.

Now that we have a script defined we need to load the script so it can be used by NanoContainer.NET. The following example shows the necessary code needed to load the script and build the associated container

// Load in the script
Stream stream = ... // read in script
StreamReader streamReader = new StreamReader(stream);

// Use the correct ContainerBuilderFacade (the script is C#)
ContainerBuilderFacade cbf = new CSharpContainerBuilderFacade(streamReader );

// Build reference to external assemblies
FileInfo fooBarDll = new FileInfo("../FooBar.dll");
StringCollection assemblies = new StringCollection();
assemblies.Add(fooBarDll.FullName);

// build the container
IMutablePicoContainer container = cbf.Build(assemblies);

What languages can be used for scripting?

• C#
• Boo
• Visual Basic
• JScript
• J#
• XML

NanoContainer.NET also supports .NET Attributes for defining contents of a container but then that really doesn't fit under the "Scripts" definition and therefor not listed as a scripting option.

• NanoContainer.NET Attribute
• Example Using NanoContainer.NET Attributes