[MappingName("Products")]
public interface Product : Entity
{
[PrimaryKey]
int ProductID { get; }
[SqlType("nvarchar(40)")]
string ProductName { get; set; }
int SupplierID { get; set; }
[SqlType("nvarchar(20)")]
string QuantityPerUnit { get; set; }
decimal UnitPrice { get; set; }
short UnitsInStock { get; set; }
short UnitsOnOrder { get; set; }
short ReorderLevel { get; set; }
bool Discontinued { get; set; }
[FkReverseQuery(LazyLoad = true)]
[MappingName("CategoryID")]
Category Category
{
get;
set;
}
}

    注意，我们没有添加ContainedAttribute，因为，我们并不希望一个Category跟随他的一个Product的更新级联更新。同时，我们将Category属性设置为非延迟载入（即实例化Product的同时就载入Category属性的数据）。

    这里要特别引起注意的是，当两个实体互相关联，或者，多个实体循环关联时，千万注意不要同时将互相关联的属性全都设为LazyLoad=fasle，否则将可能导致循环载入，造成程序死循环。在NBearV3的后续有版本将会引入缓存机制来解决这个问题，但是在这之前，请大家自己注意小心避免。

Step 4 从实体设计代码生成实体代码、实体配置文件

   4.1 至此，实体的设计就完毕了。编译EntityDesigns工程。下面我们将从设计实体生成实际的实体代码和配置文件。注意，这里和之前的ORM教程不同的是，我们不生成数据库创建脚本，而直接使用一个已经存在的数据库Northwind。

    4.2 运行dist目录中的NBear.Tools.EntityDesignToEntity.exe工具，载入EntityDesigns工程编译生成的EntityDesigns.dll。

    4.3 点击Generate Entities按钮，将生成的代码保存到Entities工程中的一个名叫Entities.cs的新代码文件。并为Entities工程添加到dist\NBear.Common.Common.dll的引用。

    4.4 点击Generate Configuration按钮，将生成的代码保存到website工程下的名为EntityConfig.xml的新文件中。

    Step 5 使用实体及NBear.Data.Gateway访问数据库

   5.1 现在我们就可以使用前面生成的实体了。我们先要让website工程引用Entities工程，以及dist/NBear.Data.dll。

    5.2 我们还需要设置website的Web.config文件，添加一个entityConfig section以包含EntityConfig.xml这个实体配置文件，并设置数据库连接字串。下面是设置完的Web.config，注意，粗体的部分都是我们添加的代码（注意修改数据库登录密码。）：

<?xml version="1.0"?>
<configuration>
<configSections>
<section name="entityConfig" type="NBear.Common.EntityConfigurationSection, NBear.Common" />
</configSections>
<entityConfig>
<includes>
<add key="Sample Entity Config" value="~/EntityConfig.xml" />
</includes>
</entityConfig>
<appSettings/>
<connectionStrings>
<add name=" Northwind" connectionString="Server=(local);Database=Northwind;Uid=sa;Pwd=sa" providerName="NBear.Data.SqlServer.SqlDbProvider"/>
</connectionStrings>
<system.web>
<compilation debug="false" />
<authentication mode="Windows" />
</system.web>
</configuration>

    5.3 好了，到目前为止，实体设置和配置完毕了。下面我们将开始讨论IoC模块的使用。

    Step 6 定义Service接口和Service实现

   6.1 下面我们开始定义一个基于NBear.IoC的Service。我们先要为ServiceInterfaces工程添加到dist\NBear.Common.dll和dist\NBear.IoC.dll的引用。一个Service由一个接口定义。我们这个Service的功能很简单，就是我们想获得一些需要的Category和Product。所以，我们还需要为ServiceInterfaces工程添加到Entities工程的引用。在ServiceInterfaces工程中定义接口ICategoryService和IProductService如下：

using System;
using NBear.IoC.Service;
using Entities;
namespace ServiceInterfaces
{
public interface ICategoryService : IService
{
Category[] GetAllCategories();
Category GetCategoryByID(int categoryID);
}
}
using System;
using NBear.IoC.Service;
using Entities;
namespace ServiceInterfaces
{
public interface IProductService
{
Product[] GetAllProducts();
Product GetProductByID(int productID);
}
}

    注意，基于NBear.IoC的Service，必须从NBear.IoC.Service.IServiceInterface这个接口继承。

    6.2 定义完Service接口，我们还需要实现它。在ServiceImpls工程中，添加到Entities，ServiceInterfaces和到dist\NBear.Common.dll，dist\NBear.Data.dll和dist\NBear.IoC.dll的引用，分别实现这两个接口如下：

using System;
using NBear.Common;
using NBear.Data;
using Entities;
using ServiceInterfaces;
namespace ServiceImpls
{
public class CategoryService : ICategoryService
{
ICategoryService Members#region ICategoryService Members
public Category[] GetAllCategories()
{
return Gateway.Default.FindArray<Category>(WhereClip.All, OrderByClip.Default);
}
public Category GetCategoryByID(int categoryID)
{
return Gateway.Default.Find<Category>(categoryID);
}
#endregion
}
}
using System;
using NBear.Common;
using NBear.Data;
using Entities;
using ServiceInterfaces;
namespace ServiceImpls
{
public class ProductService : IProductService
{
IProductService Members#region IProductService Members
public Product[] GetAllProducts()
{
return Gateway.Default.FindArray<Product>(WhereClip.All, OrderByClip.Default);
}
public Product GetProductByID(int productID)
{
return Gateway.Default.Find<Product>(productID);
}
#endregion
}
} 
 Step 7 配置Service，使用ServiceFactory，调用Service

   7.1 编译ServiceImpls。我们就可以准备在website中使用Service了。为website添加到Entities、ServiceInterfacs、dist\NBear.Common.dll、dist\NBear.IoC.dll的引用。

    注意，这里无需为website添加到ServiceImpls的引用。想想为什么？如果website依赖ServiceImpls的实现代码，那么就不叫IoC了。IoC的核心是基于容器的依赖注入。换句话说，我们只需要在配置文件中指定一个Service的接口和对应的实现类的位置，从而使得Service的调用者与Service的实现者松散耦合。但是，为了能让我们的website能根据配置文件找到Service的实现类，我们还是需要复制ServiceImpls编译输出的ServiceImpls.dll到website的Bin目录中。

    7.2 接着，我们需要在Web.config中配置IoC容器。NBearV3的IoC组件使用castle作为IoC容器，因此，可以使用标准的castle配置与法进行配置。不过一般，只需要使用下面这样最简单的语法就行了：

<?xml version="1.0"?>
<configuration>
<configSections>
<section name="entityConfig" type="NBear.Common.EntityConfigurationSection, NBear.Common"/>
<section name="castle" type="Castle.Windsor.Configuration.AppDomain.CastleSectionHandler, Castle.Windsor"/>
</configSections>
<entityConfig>
<includes>
<add key="Sample Entity Config" value="~/EntityConfig.xml"/>
</includes>
</entityConfig>
<castle>
<components>
<!--You can use standard castle component decleration schema to define service interface impls here-->
<component id="category service" service="ServiceInterfaces.ICategoryService, ServiceInterfaces" type="ServiceImpls.CategoryService, ServiceImpls"/>
<component id="product service" service="ServiceInterfaces.IProductService, ServiceInterfaces" type="ServiceImpls.ProductService, ServiceImpls"/>
</components>
</castle>
<appSettings/>
<connectionStrings>
<add name="Northwind" connectionString="Server=(local);Database=Northwind;Uid=sa;Pwd=sa" providerName="NBear.Data.SqlServer.SqlDbProvider"/>
</connectionStrings>
<system.web>
<compilation debug="true">
<assemblies>
<add assembly="System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
<add assembly="System.Data.OracleClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
<add assembly="System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/></assemblies></compilation>
<authentication mode="Windows"/>
</system.web>
</configuration>

    7.3 接着，在Default.aspx.cs文件中的PageLoad中，添加下面的代码，访问Service。

    注意，所有的Service只需简单地从ServiceFactory.GetService<ServiceType>()得到。然后就能使用了。