Orchard模块开发全接触2：新建 ProductPart

一：创建 Part

1：项目引用 Orchard.Framework；

2：创建 Models 文件夹；

3：在 Models 文件夹下创建类 ProductPartRecord，如下：

public class ProductPartRecord : ContentPartRecord
{
    public virtual decimal UnitPrice { get; set; }
    public virtual string Sku { get; set; }

}

注意，为 virtual，因为 orchard 的 NHIBERNATE 需要这样。

以及 ProductRecord：

public class ProductPart : ContentPart<ProductPartRecord>
{
    public decimal UnitPrice
    {
        get { return Record.UnitPrice; }
        set { Record.UnitPrice = value; }
    }

public string Sku
    {
        get { return Record.Sku; }
        set { Record.Sku = value; }
    }
}

二：更新数据库

更新数据库，依赖于一个叫 Migrations 的类型，我们需要创建在 根目录下，如下：

public class Migrations : DataMigrationImpl
{
    public int Create()
    {

SchemaBuilder.CreateTable("ProductPartRecord", table => table
            // The following method will create an "Id" column for us and set it is the primary key for the table
            .ContentPartRecord()
            // Create a column named "UnitPrice" of type "decimal"
            .Column<decimal>("UnitPrice")
            // Create the "Sku" column and specify a maximum length of 50 characters
            .Column<string>("Sku", column => column.WithLength(50))
            );

// Return the version that this feature will be after this method completes
        return 1;
    }
}

如果不知道 Migrations 的用法，可参考：Orchard之Module升级，现在，我们查询数据库：

可以看到代码已经执行，然后，表 TMinji_Shop_ProductPartRecord 也已经被创建了。

三：创建 ProductPart

上面，我们创建了 ProductPart 这个类，但是还不够，我们需要把这个类更新到 ContentPartDefinition 这个表中，并且，我们需要注明 ProductPart 是 attachable 的，即：需用用户在后台附加（attach）ProductPart。

现在，我们继续通过代码来做到这一点，我们仍旧在 Migrations 中做，这回，我们首先要引入 Orchard.Core，然后增加下面的代码：

编译，刷新下后台，查看数据库：

发现 version 为 2 了，并且，Settings_ContentPartDefinitionRecord 表多了行数据：

并且，进入后台

发现，多了：

Edit 之，发现为：

这正是我们的代码所定义的。

四：添加 Driver

现在，我们 Content -> Content Types and Create new Type，取名为 Book，并且，选择：Body, Comments, Product, Title, Autoroute, and Tags ，然后保存，然后，重复以上，添加 DVD。

当到了这个时候，如果我们去添加 book，我们会发现，并没有看到 Price 和 SKU，它们在哪里呢？是的，我们还缺少一个 Driver，

Driver 类似于 MVC 控制器，但是它对 contentpart 负责。典型的，它有三个方法：一个用于 part 的前台显式，一个用于后台 edit 模式下的显式，一个用于处理用户在保存 content item的时候（这个时候，part 被 attached）。

其返回值为 DriverResult，当然，大部分情况下，实际上返回为 ShapeResult（从 DriverResult 继承）。ShapeResult 告诉 Orchard，Razor 模版如何 render part。

现在，创建之：

1：首先，创建 Drivers 目录；

2：创建 ProductPartDriver：

using Orchard.ContentManagement;
using Orchard.ContentManagement.Drivers;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using TMinji.Shop.Models;

namespace TMinji.Shop.Drivers
{
    public class ProductPartDriver : ContentPartDriver<ProductPart>
    {

protected override string Prefix
        {
            get { return "Product"; }
        }

protected override DriverResult Editor(ProductPart part, dynamic shapeHelper)
        {
            return ContentShape("Parts_Product_Edit", () => shapeHelper
                .EditorTemplate(TemplateName: "Parts/Product", Model: part, Prefix: Prefix));
        }

protected override DriverResult Editor(ProductPart part, IUpdateModel updater, dynamic shapeHelper)
        {
            updater.TryUpdateModel(part, Prefix, null, null);
            return Editor(part, shapeHelper);
        }

}

}

现在，有必要对代码进行一下说明：

1：当前的 Driver 有两个方法，一个在显示 ProductPart 的 editor 的时候被嗲用，一个在后台提交 editor 表单的时候被调用（含 updater 的那个方法）。

2：我们把我们的 shape 命名为 Parts_Product_Edit，这样子，它的视图就是 Views/EditorTemplates/parts/product.cshtml。

现在，不妨来添加这个视图

@using System.Web.Mvc.Html
@model TMinji.Shop.Models.ProductPart
<fieldset>
    <legend>Product Fields</legend>

<div class="editor-label">@Html.LabelFor(x => x.Sku)</div>
    <div class="editor-field">
        @Html.EditorFor(x => x.Sku)
        @Html.ValidationMessageFor(x => x.Sku)
    </div>
    <div class="hint">Enter the Stock Keeping Unit</div>

<div class="editor-label">@Html.LabelFor(x => x.UnitPrice)</div>
    <div class="editor-field">
        @Html.EditorFor(x => x.UnitPrice)
        @Html.ValidationMessageFor(x => x.UnitPrice)
    </div>
    <div class="hint">Enter the sales price per unit</div>
</fieldset>

为了让这个视图能正确呈现，我们还需要就加入引用

System.Web
System.Web.Mvc
System.Web.WebPages

前者在 全局程序集 下，后两者，则可以在 lib\aspnetmvc 下可以找到（顺注：你一定知道这个 lib 就是哪个 lib）。

然后，我们根目录还缺少一个 web.config，我建议你直接从 blog 那个模块下面进行拷贝，（顺注：我的 orchard 是 1.8 版本）：

<?xml version="1.0"?>
<configuration>
  <configSections>
    <sectionGroup name="system.web.webPages.razor" type="System.Web.WebPages.Razor.Configuration.RazorWebSectionGroup, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">
      <remove name="host"/>
      <remove name="pages"/>
      <section name="host" type="System.Web.WebPages.Razor.Configuration.HostSection, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false"/>
      <section name="pages" type="System.Web.WebPages.Razor.Configuration.RazorPagesSection, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false"/>
    </sectionGroup>
  </configSections>
  <system.web.webPages.razor>
    <host factoryType="System.Web.Mvc.MvcWebRazorHostFactory, System.Web.Mvc, Version=5.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
    <pages pageBaseType="Orchard.Mvc.ViewEngines.Razor.WebViewPage">
      <namespaces>
        <add namespace="System.Web.Mvc"/>
        <add namespace="System.Web.Mvc.Ajax"/>
        <add namespace="System.Web.Mvc.Html"/>
        <add namespace="System.Web.Routing"/>
        <add namespace="System.Web.WebPages"/>
        <add namespace="System.Linq"/>
        <add namespace="System.Collections.Generic"/>
        <add namespace="Orchard.Mvc.Html"/>
      </namespaces>
    </pages>
  </system.web.webPages.razor>
  <system.web>
    <compilation targetFramework="4.5">
      <assemblies>
        <add assembly="System.Web.Abstractions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
        <add assembly="System.Web.Routing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
        <add assembly="System.Data.Linq, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>
        <add assembly="System.Web.Mvc, Version=5.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
        <add assembly="System.Web.WebPages, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </assemblies>
    </compilation>
  </system.web>
</configuration>

然后，在根目录下，在创建一个 Placement.info，

<Placement>
  <Place Parts_Product_Edit="Content:1" />
</Placement>

这是告诉 Orchard，请显式在 Widget 的 Content 部位。

现在，我们可以看到：

五：添加 handler（持久化数据）

我们来添加下面的数据：

Books:

• The Hobbit, $50, SKU-1001
• Wizard's First Rule, $39, SKU-1002
• The Hunger Games, $29, SKU-1003

DVDs:

• Prometheus, $30, SKU-1004
• The Shawshank Redemption, $25, SKU-1005
• The Dark Knight, $20, SKU-1006

然后，保存成功，然后，我们打算修改这些数据，结果发现 Price 和 Sku 是空的，这是为什么呢？因为我们还没有实现持久化哦。要让 Orchard 持久化数据，我们需要：

1：创建 Handlers 文件夹；

2：添加 ProductPartHandler，如下：

public class ProductPartHandler : ContentHandler
{
    public ProductPartHandler(IRepository<ProductPartRecord> repository)
    {
        Filters.Add(StorageFilter.For(repository));
    }
}

现在，我们发现可以增删数据了。去查查数据库吧：