ASP.NET原创框架九-应用模块开发

ASP.NET原创框架九-应用模块开发

创建应用模块HelloMode

编写应用模块一般应用模块的工程目录结构如下图

View为页面视目录，该目录结构

UI库名\语言\页面文件

device\UI库名\语言\页面文件，其中device表示手机页面存储地址

如上图的 amazeui\zh-CN表示存储中文页面，amazeui\en-us表示存储英文页面

对于页面视文件.aspx选中然后在属性里“复制到输出目录”选择“始终复制”，以便在编译完成后自动复制到输出目录

将编译的模块设置输出到主程序XNCrmManager的目录以便调试

如上面HelloMode,点工程属性，然后选择生成

对于Release生成到主程序XNCrmManager的JsonMode下的模块名目录下

对于Debug生成到主程序XNCrmManager的JsonModeDebug下的模块名目录下

在web.config配置

Debug版本的配置如下(红色部分)

<probing privatePath="JsonModeDebug/前沿模块;JsonModeDebug/ShareDll;JsonModeDebug/动态表模块；...；JsonModeDebug/HelloMode;"

Release版本的配置如下(红色部分)

<probing privatePath="JsonMode/前沿模块;JsonMode/ShareDll;JsonMode/动态表模块；...；JsonMode/HelloMode;"

然后在系统里添加应用模块

然后将行业应用绑定到需要的数据库节点上

然后添加应用模块用到的数据库表

输入表名，初始化表的生成语句

是否全局表，也就是是否每个节点的数据都一样，一般情况数据都不一致未非全局表

至此应用模块的基本初始化工作基本配置完成

新建的应用模块工程需要引用必要框架库如下

IJsonModeEngine IXNDBEngine JsonMode MicroJson XNCache XNDBEngine XNCoreNodeDBEngine

引入库位于lib下的$(Configuration)目录下

实际工程会根据编译的Release还是Debug版本去使用lib的Release或Debug下相应文件

记得将所有引用的框架dll文件属性下的复制到本地设置为false

WeiXinFactory,WeiXinPay 位于JsonMode\shareDll下

代码必using空间

using XNWebEngine.JsonBase;

using XNWebEngine;

using XNWebEngine.XNDBEngine;

using WeiXinFactory;

应用模块类的代码实现，应用模块可调用的框架函数见

public partial class HelloMode : BaseJsonMode

初始模块函数

static public void SetJsonMode(string sPath, string sName)

{

//完成应用模块基本初始化工作

}

关于应用模块函数的属性：

[ModeMethod("{CanNoLogin:true,CanEnable:true}")]

static public ReturnJson index(HttpContext ctx, Object m_Parame)

红色部分为函数说明

CanNoLogin:当true时表示该函数可未到登录调用，为false时表示必须登录调用默认为false

CanEnable:当true时表示该函数启用，为false时表示该函数禁止调用，默认为true

CanPost:当true时表示该函数可Post方式启用，为false时表示该函数禁止Post方式调用，默认为true

CanGet:当true时表示该函数可Get方式调用，为false时表示该函数禁止Get方式调用，默认为true

CanThird:当true时表示该函数可第三方调用，为false时表示该函数禁止第三方调用，默认为false

CanClient：当true时表示该函数可浏览器调用，为false时表示该函数禁止浏览器调用，默认为true

CanP2P：当true时表示该函数可其他服务调用，为false时表示该函数禁止其他服务调用，默认为true

CanCrossDomain：当true时表示该函数可跨域调用，为false时表示该函数禁止跨域调用，默认为false

isAppFunction:当true时表示该函数可App调用，为false时表示该函数禁止App调用，默认为false

isEncFunction:当true时表示该函数可P2P加密调用，为false时表示该函数禁止P2P加密调用，默认为false

关于函数的分权，根据实际使用中经常会用到角色对各功能有不同的调用权限，该框架的应用模块采用五级分权模式，为方便权限配置和分权函数编写，特定义不同权限函数采用不同的函数后缀

超级管理权限 函数后缀为_Any

行业代理权限 函数后缀为_HY

企业管理权限 函数后缀为_Company

企业部门权限 函数后缀为_Org

个人权限 函数后缀为_Person

特别注意所有外部调用的应用模块函数都是静态函数

编写一个分权函数例子如下如有个函数为Hello有五个分权，那么我们编写如下

static public ReturnJson Hello(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

if(HavePower(ctx,"HelloMode","Hello_Any",true).bOK)

{

return Hello_Any(ctx,m_Parame);

}

else

{

if(HavePower(ctx,"HelloMode","Hello_HY",true).bOK)

{

return Hello_HY(ctx,m_Parame);

}

else

{

if(HavePower(ctx,"HelloMode","Hello_Company",true).bOK)

{

return Hello_Company(ctx,m_Parame);

}

else

{

if(HavePower(ctx,"HelloMode","Hello_Any",true).bOK)

{

return Hello_Any(ctx,m_Parame);

}

else

{

if(HavePower(ctx,"HelloMode","Hello_Org",true).bOK)

{

return Hello_Org(ctx,m_Parame);

}

else

{

if(HavePower(ctx,"HelloMode","Hello_Person",true).bOK)

{

return Hello_Personctx,m_Parame);

}

else

{

}

}

}

}

}

}

}

catch(Exception e)

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="执行异常";

}

return m_ReturnJson;

}

//各权限实现函数

//超级权限

static public ReturnJson Hello_Any(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

Hashtable m_HH = new Hashtable();

JsonHelper.OBJToHashTable(m_Parame, m_HH);//获得参数

//后续处理

}

catch

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="调用异常";

}

return m_ReturnJson;

}

//代理和超级代理权限

static public ReturnJson Hello_HY(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

if(HavePower(ctx,"CoreSYS.SYS","IsHYAdministrator",true).bOK)

{

//如是超级代理

return Hello_Any(ctx,m_Parame);

}

Hashtable m_HH = new Hashtable();

JsonHelper.OBJToHashTable(m_Parame, m_HH);//获得参数

//后续处理获得登录信息，判断该用户是否归宿权限范围

SessionLink m_SessionLink=GetSessionLink(ctx);

//判断操作数据是否为代理企业

。。。

}

catch

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="调用异常";

}

return m_ReturnJson;

}

//企业权限

static public ReturnJson Hello_Company(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

Hashtable m_HH = new Hashtable();

JsonHelper.OBJToHashTable(m_Parame, m_HH);//获得参数

//后续处理获得登录信息，判断该用户是否归宿权限范围

SessionLink m_SessionLink=GetSessionLink(ctx);

//判断操作数据是否为用户企业

。。。

}

catch

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="调用异常";

}

return m_ReturnJson;

}

//部门权限

static public ReturnJson Hello_Org(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

Hashtable m_HH = new Hashtable();

JsonHelper.OBJToHashTable(m_Parame, m_HH);//获得参数

//后续处理获得的登录信息，判断该用户是否归属权限范围

SessionLink m_SessionLink=GetSessionLink(ctx);

//判断操作数据是否为用户部门

}

catch

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="调用异常";

}

return m_ReturnJson;

}

//个人权限

static public ReturnJson Hello_Person(HttpContext ctx,Object m_Parame)

{

ReturnJson m_ReturnJson=new ReturnJson();

try

{

Hashtable m_HH = new Hashtable();

JsonHelper.OBJToHashTable(m_Parame, m_HH);//获得参数

//后续处理获得的登录信息，判断该用户是否归属权限范围

SessionLink m_SessionLink=GetSessionLink(ctx);

//判断操作数据是否为该用户数据

}

catch

{

m_ReturnJson.bOK=false;

m_ReturnJson.sMsg="调用异常";

}

return m_ReturnJson;

}

对于分权函数可能有读者认为直接调用Hello_Any不就绕过了权限判断吗，在前面章节里已经介绍，框架在反射调用函数时会判断是否对该函数有执行权限，

关于函数执行权限的配置，首先通过后台配置行业应用模块权限，然后对行业应用模块的函数执行权限进行配置,见下图

选中应用行业进行绑定或解绑

对行业应用函数进行权限配置

对权限进行具体配置

选中要配置的行业，然后可批量配置超级权限，行业权限，企业权限，部门权限，个人权限，也可但多配置，勾选表示禁用

也可以配置时间范围调用或调用次数限制配置

为便于快速生成应用模块本框架还编写一个代码工厂应用模块方便生成新的应用模块

按提示输入相应信息生成应用模块代码框架

下集将继续介绍应用模块编写