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:

    本地下载