Magicodes.NET框架
-
前言
一眨眼，已经过去两个多月了 ，哥已经火力全开了（业余时间和精力，甚至为此放弃了各种私活），所以大家不要抱怨慢哈。编程犹如逆水行舟，不进则退。这段时间，一方面是不断地重构和设计框架，另一方面也系统的学习了很多新技术，同时也感受到了其强大的生命力。
所以这两个多月，也感慨良多。两个多月的业余时间和精力，两个多月没玩LOL和CF，两个多月的全身心投入……
现在本篇就重点说说架构这些事：
-
架构多次重构，甚至核心模块多次推倒重来。
-
架构已支持MVC，不过却暂时放弃了WebForm，当然也有可能永久放弃WebForm，毕竟我目前只是一个人在战斗，兼容两套时间精力都极为有限。
-
引入了T4，已支持基于T4模板的代码生成。
-
已支持SignalR。
-
已支持ASP.NET Identity以及集成OAuth（Microsoft、QQ、Google…），暂时移除了对Form验证的支持。
-
支持WebAPI和Odata。
-
前端框架初成，支持响应式布局以及MVVM模式和模块化加载。
-
其他
接下来，我一一简单的介绍下本框架好了。
首先，先从前端开始介绍吧：
-
响应式布局的UI
后台：
其他设备（为了用户体验，后台框架使用了Iframe，在其他设备上访问时，可能多少会有些问题）：
还有个列表页面，但是更改为MVC后，还没来得及改好。
前台：
-
模块化按需加载
前端JS写了一部分，但是感觉还远远达不到完善的级别。很希望哪位前端工程师能够给予支持，这样我的重心就更好的放到后端架构上了。
在JS的选择上，最终选择了优秀的RequireJs，一直用下来，感觉比SeaJs更完善，更好用和更易用。
先看几段Demo，比如登录页面：
Magicodes.js做了不少封装，当然是为了最大限度的节省生产力。整个登录机制就是以上脚本搞定，当然还与MVVM有关联，这个是下面要介绍的。
Magicodes.js为目前的前端框架核心库，当然目前还称不上库。其内部很多模块也都是按需加载的，比如：
window.magicodes.messager = {
showMessage: function (title, message, className, funcs) {
var setting = {
title: title,
text: message,
class_name: className
};
if (typeof (funcs) !== "undefined") {
if (typeof (funcs.before_close) !== "undefined")
setting.before_close = funcs.before_close;
if (typeof (funcs.after_open) !== "undefined")
setting.after_open = funcs.after_open;
}
this._addGritter(setting);
},
showInfoMessage: function (title, message, funcs) {
this.showMessage(title, message, 'gritter-info gritter-light', funcs);
},
showErrorMessage: function (title, message, funcs) {
this.showMessage(title, message, 'gritter-error gritter-light', funcs);
},
showWarnMessage: function (title, message, funcs) {
this.showMessage(title, message, 'gritter-warning gritter-light', funcs);
},
removeAll: function () {
typeof ($.gritter) !== "undefined" && $.gritter.removeAll();
},
_addGritter: function (setting) {
require(["jquery", "jquery.gritter"], function () {
$.gritter.add(setting);
});
}
};
这个是弹出消息的，如：
这里就不多说了。
-
MVVM
在MVVM框架的选择上，最终选择了knockoutjs。主要是够轻量级，也够灵活。用下来，感觉相当不错。
比如登录页面：
登陆页面这个比较简单，重点是导航的绑定，马上给大家秀一段。
按照传统的方式来开发如下图所示的功能，少不了递归绑定（支持多级），一堆的JS控制，一堆的业务代码（其实开始我也是写代码的，后面才改为了MVVM模式，走弯路了，呵呵）
那么现在是怎么做到的呢？如下面代码：
也就是我的绑定逻辑已经脱离了数据模型，前台显示我只需要改动这段代码即可。是不是很强悍呢？
然后JS只要给到数据即可。后台从WebAPI拿到如下JSON：
然后JS处理下，根据父子关系，生成children属性（方便视图绑定）：
//添加菜单子项
//源数据
//当前项
this._appendChildrenMenus = function (data, itemData) {
var childrenNavs = $.grep(data, function (i) {
return i.ParentId == itemData.Id;
});
if (childrenNavs.length > 0) {
itemData.children = childrenNavs;
$.each(childrenNavs, function (i, v) {
v._active = ko.observable(false);
v._open = ko.observable(false);
self._appendChildrenMenus(data, v);
});
}
};
核心代码主要如下：
使用knockoutjs是不是很方便呢？其实knockoutjs很不错，除了这些，knockoutjs可以干很多很便捷的事情，比如绑定分页，绑定列表，绑定表单，这里只是做一些列举，后面开贴细讲，毕竟knockoutjs的实例还是比较少的。
这里再付一个分页的模板：
<script id="pagesTemplate" type="text/html">
<li class="prev" data-bind="css: { disabled: $root.gridViewModel.currentPageIndex() <= 1 }, click: function () { $root.previousPage(); }">
<a href="#">
<i class="ace-icon fa fa-angle-double-left"></i>
</a>
</li>
<!-- ko foreach: $root.gridViewModel.pages -->
<li data-bind="css: { active: $data == $root.gridViewModel.currentPageIndex() }"><a href="#" data-bind=" text: $data, click: function () { $root.gridViewModel.currentPageIndex($data); } "></a></li>
<!-- /ko -->
<li class="next" data-bind="css: { disabled: $root.gridViewModel.currentPageIndex() >= $root.getTotalPages() }, click: function () { $root.nextPage(); }">
<a href="#">
<i class="ace-icon fa fa-angle-double-right"></i>
</a>
</li>
</script>
前端的先就介绍到这里吧，期待前端工程师的加入，让我们一起来打造Magicodes前端框架。
现在，来说说后台框架吧：
-
插件式架构
如下图，这是目前的项目结构。
视图页、控制器、策略、数据模型、Service（含WebApi和Odata）均以插件存在。
在我这里，Service插件和传统的层有很大区别。我这里的Service组件侧重与WebApi和Odata提供的Web接口。
-
MVC
目前已经移除了 对WebForm的支持，正所谓有了老婆忘了娘。嘿嘿。
注意：配置管理的所有配置视图和控制器使用了T4模板自动生成。这个下面会介绍。
-
ASP.NET Identity 和OAuth
Magicodes.NET支持 ASP.NET Identity以及OAuth协议，在不编写一行代码的情况下，您就可以便捷的集成QQ、Microsoft、Google、Facebook、Twitter等OAuth接口。
后面还会支持更多…
-
WebAPI
曾经我也设计了一套WebAPI，目前已经移除了对此API的支持。改为基于微软的WebAPI进行封装。从一接触WebAPI就喜欢上它了，毋庸置疑，她将来的成就会不可限量。这里简单的介绍下:
比如刚才看到的站点信息配置页面，其WebAPI如下：
这里很明显的是一套基于REST协议标准的Web方法。WebAPI并不一定必须基于REST协议来设计哈，只是推荐而已。
Get、Post、Put，其实还有Delete（这里因为配置文件不能删除），这是Rest协议标准的Web方法。一流公司制定标准，我们要抓紧抱佛脚。不要认为标准离我们很远，你不去拥抱，人家能主动过来么？
先介绍下REST协议，代表性状态传输（Representational State Transfer，REST）在 Web 领域已经得到了广泛的接受，是基于 SOAP 和 Web服务描述语言（Web Services Description Language，WSDL）的 Web 服务的更为简单的替代方法。接口设计方面这一转变的关键证据是主流Web 2.0 服务提供者（包括 Yahoo、Google 和 Facebook）对 REST 的采用，这些提供者弃用或放弃了基于 SOAP 和 WSDL 的接口，而采用了更易于使用、面向资源的模型来公开其服务。
也顺便多说点。REST 要求开发人员显式地使用 HTTP 方法，并且使用方式与协议定义一致。这个基本 REST 设计原则建立了创建、读取、更新和删除（create, read, update, and delete，CRUD）操作与 HTTP 方法之间的一对一映射。根据此映射：
-
若要在服务器上创建资源，应该使用 POST 方法。
-
若要检索某个资源，应该使用 GET 方法。
-
若要更改资源状态或对其进行更新，应该使用 PUT 方法。
-
若要删除某个资源，应该使用 DELETE 方法。
我前面为什么说WeAPI会爆发出强大的生命力？是因为之前的WebServices也好，还是SOAP等接口已经不满足现有的使用场景了。很多时候，我们的接口内容得看什么终端输出什么，就如见什么人说什么话一样。看见Html调用，给他JSON就好了，C#、Java客户端调用，就给他返回XML让他去玩好了，MongoDB也要玩，给他BSON就好了。还有不支持的？自己定义好了。总之，程序员们放心了，接口要支持新的平台，我们啥都不需要干了。我们也不需要维护多套代码了。这是多么Happy的事情呀。当然返回什么，是HTTP Accept Header决定的。
我们让他返回JSON
他就乖乖的返回了JSON：
让他返回XML，他就乖乖返回了XML：
上面只是增改查的例子，下面再来一个查询的例子，比如获取导航菜单：
//Get /api/Menus
/// <summary>
/// 获取用户当前的菜单项
/// </summary>
/// <returns></returns>
public IHttpActionResult Get()
{
var userId = User.Identity.GetUserId();
var menus = from link in db.MenuLinks
where
!link.IsDelete &&
link.Roles.Any(p => db.Users.FirstOrDefault(p1 => p1.Id == userId).Roles.Any(p2 => p2.RoleId == p.Id))
select link;
return Ok(menus);
}
好了，这个就说到这里。继续下面的：
-
T4以及代码生成
Magcodes.NET一个比较重要的理念是高效开发，那么代码生成肯定少不了。
以前玩过CodeSmith，但是现在感觉T4真他娘的比CodeSmith方便多了。Magcodes.NET制作了不少T4模板，旨在尽可能的减少代码的编写。这里就举一个例子：
比如下面看到的配置界面，包括后台信息配置、邮箱信息配置等等界面，从View到WebAPI均是生成的，不需要手写代码。
如何生成的呢？我们来看看相关的生成View的T4模板的片段吧（具体的这里就不介绍了）：
后面我会专门写一篇隆重介绍Magicodes.NET使用T4模板生成的，按照我的设想，将来代码生成远不止如此。
-
尾声
今天就介绍到这里吧，写这个也蛮费时间的。累哈。还有些东西，就下篇再介绍吧：
-
OData以及增删改查
-
T4 & 增删改查
-
路由系统
-
配置管理
-
事件管理
-
SignalR
-
Code First与基于代码的迁移
-
日志与监控
-
后台控制
-
… …
代码还在不断更改中，所以最新版下载并不能够随时放出，因为目前的版本还不够稳定，请大家体谅。一旦稳定版出来，我会第一时间提供下载。
另外，也希望有兴趣的小伙伴能够参与进来，按照我的规划，还有不少任务需要完成，比如：
-
社区与博客搭建
-
各种业务的T4模板编写
-
流程引擎
-
ASP.NET服务监控模块
-
通用的支付策略
-
其他
人力有时穷，毕竟一个人的精力有限，而且我的主要精力目前还得围绕框架转，如果你有兴趣和时间，请加入我们。
很多模块并没有开发完或者不够完善，本人精力有限，目前一段时间均会关注在框架这块，希望业务模块和前端有朋友能够帮忙完善完善。
请关注我的官网——http://www.magicodes.net。
另外，Magicodes.NET将提供一个应用实例：官网以及博客社区（目前博客是随便Down的，但是功能却不是我想要的），有兴趣的可以加入。
由于官网使用了本框架进行了重新开发，所以之前的注册数据已经丢失，给你们带来的不便，请谅解。这次之后，应该是不删档测试了，建议大家绑定自己的QQ号码，如果你无法使用QQ登录，那就说明接口还没有审核通过，请耐心等待。
最后，分享一首本人前段时间偶有所感而得的诗，虽然还是之前那首：
夏雪