导入程序设计指南

下面的例子假设要导入的对象是Vendor

1 根据导入文件的格式，创建对应的VendorImportItem，此类应该继承自ImportLibrary.BaseImportItem

2 创建VendorFileParser，此类需要实现ImportLibrary.IFileParser接口。在实现Parse方法的过程中，读取导入文件的内容，生成IEnumerable<VendorImportItem>的集合。注意：Parser不要加入业务逻辑过程，只把文件中的有用的原始数据导入

3 创建一系列VendorXXXValidateHandler, 这些Handler需要继承自ImportLibrary.Validate.ValidateHandler<VendorImportItem>

3.1 每一个VendorXXXValidateHandler的类定义的前面需要加一个属性Order如下

[Order(1)]

    public class VendorCodeValidateHandler : ValidateHandler<VendorImportItem>

    {

        protected override void Validate(IEnumerable<VendorImportItem> item)

        {

            --这里是验证逻辑

IEnumerable<VendorImportItem> emptyItems = item.Where (x=>string.IsNullOrEmpty(x.Code)) ;

            this.AppendErrorMessage(emptyItems, "编号不能为空");

        }

  }

Order属性的参数是验证的顺序，框架会搜索所有的ValidateHandler<VendorImportItem>的实现类,并按Order后面的参数排序后逐个调用。如果省略此属性，则缺省值为100

可以调用基类的AppendErrorMessage和AppendWarningMessage方法添加验证的错误信息。

4创建VendorImporter，此类继承自ImportLibrary.BaseImporter<VendorImportItem>

实现DoImport方法的步骤

4.1此时VendorImportItem集合中，每一项的Result有Succeed, Failed, Warning三种，可以根据需要决定是否导入Warning的记录。

4.2 调用相应的业务逻辑把符合条件的项导入到业务表中。

注：BaseImporter有另外一种重载的格式BaseImporter<T,ResultT>, 详见文末关于自定义结果格式的说明

5 Controller层

5.1 通过IImportFactory创建对应的Importer

IFileParser parser = new VendorFileParser(Server.MapPath("~/Temp/" + fileName));

            IImport importer = ImportFactory.CreateImport("Vendor");

            importer.FileParser = parser;

　　5.2 调用Import方法

return RcJson(JsonConvert.DeserializeObject<FeedbackResult<VendorImportItem>>(importer.Import()));

　　5.3 在MyValueSelector.cs中配置Importer。Dictionary中每一项是对应的实现类。

Dictionary<string, string> importerType = new Dictionary<string, string> {

                {"QR","ESC.QRImpl.Import.QRImporter,ESC.QRImpl"},

                {"Vendor","ESC.VendorImpl.Import.VendorImporter,ESC.VendorImpl" }

            };

6 客户端呈现导入结果

返回客户端的对象结构如下

{

FailedCount: 失败的数量,

SucceedCount: 成功的数量,

WarningCount: 警告的数量,

Items: 导入文件中的Item的集合，包含一个ErrorMessage属性，如果是Failed或者Warning此属性不为空

ErrorMessage: 如果上传的文件格式错误或者导入过程中出现意外错误，此属性包含对应的错误信息。

}

7 自定义结果格式

可自定义一个VendorImportResult, 这个类需要继承自ImportLibrary.BaseImportResult<VendorImportItem>，然后重载GetSucceedMessage方法。

同时VendorImporter需要继承自BaseImporter<VendorImportItem,VendorImportResult>.