DiscuzNT 商品交易插件设计之用例模型

     在今年年初，本人接受了商品交易插件设计和开发任务。在开始的那段时间里，主要是开发一系
列商品交易的基本功能，包括：    
     商品管理（CUD）,在线交易，商品分类管理，定单（交易单）管理等。如下面的图中所示（普
通权限用户）：

 

 

     而下面这张则是有管理权限的用户（管理员或版主之类）用例图。

 

     目前我们开源的商品交易插件基本上完成了上面所绘制的用例功能。

     下面简单介绍一下主要的数据库表之间的关系，结构。请看下图：

 

     这里的商品表（goods）为交易的“核心”，其结构也相对复杂一些，这里引用我们开源时的官
方数据库字典来加以说明：

 

 

     目前商品交易的代码布局如下：

     1.商品交易实体类位于： Discuz.Entity 项目下的Mall文件夹

                

     2.商品交易业务逻辑层代码位于：Discuz.Mall 下的App_Code文件夹

           

  

     3.前台访问和后台访问页面的cs代码分别位于上图的Pages和Admin文件夹

     4.支付宝在线支付模块以及交易插件数据访问接口分别位于Discuz.Plugin项目的Payment和Mall文件夹下

         

   

    而相应的支付宝配置信息类声明在了Discuz.Config项目中(TradeConfigFileManager.cs,

TradeConfigInfo.cs,TradeConfigs.cs), 其中的TradeConfigInfo.cs为配置信息类，内容如下所示：    
    

/// <summary>
    /// 交易配置信息类
    /// </summary>
    [Serializable]
    public class TradeConfigInfo : IConfigInfo
    {
        /// <summary>
        /// 支付宝配置信息
        /// </summary>
        private AliPayConfigInfo _alipayconfiginfo;
        /// <summary>
        /// 支付宝配置信息
        /// </summary>
        public AliPayConfigInfo Alipayconfiginfo
        {
            get {return _alipayconfiginfo;}
            set { _alipayconfiginfo = value; }
        }
    }

     
    /// <summary>
    /// 支付宝配置信息类
    /// </summary>
    [Serializable]
    public class AliPayConfigInfo 
    {
        #region 私有字段
        private string _inputCharset = "utf-8";
        private string _partner = "2088002052150939"; //Discuz Partner ID
        private string _sign = "gh0bis45h89m5mwcoe85us4qrwispes0"; //Discuz 交易安全校验码(key)
        private string _acount = ""; //支付宝帐号(用于兑换或交易功能)
        #endregion

        #region 属性
        /// <summary>
        /// 参数编码字符集,默认为"utf-8"(Alipay文档默认值为"GBK")
        /// </summary>
        public string Inputcharset
        {
            get
            {
                if (_inputCharset == null)
                {
                    return "utf-8";
                }
                else
                {
                    return _inputCharset;
                }
            }
            set
            {
                if (value != null && value.Length > 50)
                {
                    throw new ArgumentOutOfRangeException("无效的 Input_Charset(参数编码字符集)", value, value.ToString());
                }
                _inputCharset = value;
            }
        }

        #region 注释的代码
        //private string _agent = "";

        ///// <summary>
        ///// 如果一些交易网站的交易，有一定的“代理”所属关系，代理商可以在交易中传递该参数，来表明代理的身份。这里传送的值，请使用代理商所属支付宝账户的PartnerID
        ///// </summary>
        //public string Agent
        //{
        //    get { return _agent; }
        //    set
        //    {
        //        if (value != null && value.Length > 16)
        //            throw new ArgumentOutOfRangeException("无效的 Agent(代理)", value, value.ToString());
        //        _agent = value;
        //    }
        //}
        #endregion

        /// <summary>
        /// 合作伙伴在支付宝的用户ID
        /// Alipay文档类型:string(16)
        /// </summary>
        public string Partner
        {
            get
            {
                if (_partner == null)
                {
                    throw new ArgumentNullException(_partner);
                }
                return _partner;
            }
            set
            {
                if (value != null && value.Length > 16)
                    throw new ArgumentOutOfRangeException("无效的 Partner(合作伙伴ID)", value, value.ToString());
                _partner = value;
            }
        }


        /// <summary>
        /// 签名,在此输入交易安全校验码（key），不同于支付宝文档的Sign
        /// </summary>
        public string Sign
        {
            get
            {
                if (_sign == null)
                {
                    throw new ArgumentNullException(_sign);
                }
                return _sign;
            }
            set
            {
                if (value != null && value.Length > 50)
                    throw new ArgumentOutOfRangeException("无效的 Sign(签名)", value, value.ToString());
                _sign = value;
            }
        }

        /// <summary>
        /// 支付宝帐号(用于兑换或交易功能)
        /// </summary>
        public string Acount
        {
            get
            {
                if (_acount == null)
                {
                    throw new ArgumentNullException(_acount);
                }
                return _acount;
            }
            set
            {
                if (value != null && value.Length > 16)
                    throw new ArgumentOutOfRangeException("无效的支付宝帐号", value, value.ToString());
                _acount = value;
            }
        }
        #endregion
    }

    序列化保存后的结果如下（位于discuz.web\config\trade.config）：

 

<?xml version="1.0"?>
<TradeConfigInfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Alipayconfiginfo>
    <Inputcharset>utf-8</Inputcharset>
    <Partner>208800******</Partner>
    <Sign>zwdr8lv1uaj4b******</Sign>
    <Acount />
  </Alipayconfiginfo>
</TradeConfigInfo>

    而有关我们产品配置文件的实现方式请参见这篇文章：
    
    Discuz!NT之配置文件类[discuz.config] 
    
    其中介绍了相应文件的对应关系。

    好了，因为想说的东西不少，只能放到以后慢慢加以介绍了（想以"用例"为单元进行说明）。

    今天的内容就先到这里了。

    最后附上我们产品的最新下载（源码）地址：

    Discuz!NT v2.5 源码包
    Discuz!NT 2.5 Source(Visual Studio 2008) :
    本地下载  

    Discuz!NT v2.5 类库说明文档:
    本地下载

    Discuz!NT v2.5 SQL Server版数据库字段说明文档:
    本地下载

    Discuz!NT v2.5 API说明及整合文档:
    本地下载

    Discuz!NT v2.5 API Client:

    本地下载

    作者：代震军,daizhj

    网站：http://daizhj.cnblogs.com/

    原文链接：http://www.cnblogs.com/daizhj/archive/2008/08/04/1259645.html