一、前言
上一篇讲述的是将BIM平台后台架构CoreService.sln,该解决方案主要作用是对管控平台的核心业务进行封装,然后让前端的ApiController去调用该解决方案中的对应的dll方法。说到MVC前端架构,可能很多人都有一个误区,觉得都是按照微软的例子去写即可。其实在中大型的项目中按照微软MVC的demo样例去实施会对今后的维护工作带来一定难度。我在BIM平台部门的时候经历过多次MVC架构的修改,在熟悉了整个Web开发一个月之后,我与另一位Tech Leader准备再次进行改造,奠定了以后项目的基调,这大概算是我留给老东家最后的礼物吧。该架构功能清晰,方便复制开发,模块化相对于之前有了质的飞越。
二、架构简图
整个MVC的架构很简单,就三个csproj:
- PlatForm.WebApp.Infrastructure —— BIM平台的基础,用于定义基类、定义基本Config等等。该dll应该是以后很少改动的。
- PlatForm.WebApp.ApiBusiness —— BIM平台中的ApiController中的Action引用该dll中的方法,该dll再引用之前CoreService.sln中相关的方法。
- PlatForm.WebApp —— BIM平台的前端(ASP.NET MVC)
图示:
三、详解
依照上图中的调用关系,我们首先来看Infrastructure它有哪些内容:
a. Application文件夹:
该文件夹包含Config文件夹与MvcApplication.cs。
Config文件夹主要包含:BundleConfig(css、js的路由控制)、FilterConfig(过滤器控制)、RouteConfig(controller路由控制)、WebApiConfig(apicontroller路由控制)
MvcApplication:
public abstract class BaseMvcApplication : System.Web.HttpApplication
{
protected void Application_Start()
{
RegisterAreas(); if (!ApplicationService.Instance.IsInitialized)
ApplicationService.Instance.Initialize(); IUnityContainer container = ServiceLocator.Instance.GetContainer(); // WebApi
GlobalConfiguration.Configuration.DependencyResolver = new Microsoft.Practices.Unity.WebApi.UnityDependencyResolver(container); // MVC
DependencyResolver.SetResolver(new Microsoft.Practices.Unity.Mvc.UnityDependencyResolver(container)); InitializeMvcFactory(); RegisterApiConfig();
RegisterGlobalFilter();
RegisterRoutes();
RegisterBundles();
} protected virtual void RegisterAreas()
{
AreaRegistration.RegisterAllAreas();
} protected virtual void RegisterBundles()
{
BundleConfig.RegisterBundles(BundleTable.Bundles);
} protected virtual void RegisterRoutes()
{
RouteConfig.RegisterRoutes(RouteTable.Routes);
} protected virtual void RegisterGlobalFilter()
{
FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
} protected virtual void RegisterApiConfig()
{
WebApiConfig.Register(GlobalConfiguration.Configuration);
} protected virtual void InitializeMvcFactory()
{
// Customize MVC controller
BIMPlatformControllerFactory controllerFactory = GetControllerFactory();
ControllerBuilder.Current.SetControllerFactory(controllerFactory); BIMPlatformHttpControllerSelector httpControllerSelector = GetHttpControllerSelector();
GlobalConfiguration.Configuration.Services.Replace(typeof(IHttpControllerSelector), httpControllerSelector);
} protected virtual BIMPlatformHttpControllerSelector GetHttpControllerSelector()
{
// Customize API Controller
return new BIMPlatformHttpControllerSelector(GlobalConfiguration.Configuration);
} protected virtual BIMPlatformControllerFactory GetControllerFactory()
{
return new BIMPlatformControllerFactory();
} public override void Init()
{
this.PostAuthenticateRequest += (sender, e) => HttpContext.Current.SetSessionStateBehavior(SessionStateBehavior.Required); base.Init();
} /// <summary>
/// Get the EF DB Context when begin the Http Request so that the application could use one context per request
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Application_BeginRequest(object sender, EventArgs e)
{
//Avoid Error("Response for preflight has invalid HTTP status code 405") from H5 App
if (Request.Headers.AllKeys.Contains("Origin") && Request.HttpMethod == "OPTIONS")
{
Response.End();
}
} /// <summary>
/// Dispose the EF DB Context when begin the Http Request
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Application_EndRequest(object sender, EventArgs e)
{
try
{
// Singleton
IEnumerable<IRepositoryContext> lcolContexts = ServiceLocator.Instance.GetServices<IRepositoryContext>();
if (lcolContexts != null)
{
foreach (IRepositoryContext lobjContext in lcolContexts)
{
ServerLogger.Info("Start to dispose DB context");
lobjContext.Dispose();
ServerLogger.Info("Disposed DB context");
}
}
}
catch (Exception ex)
{
// Log error
ServerLogger.Error("Failed to dispose DB Context", ex);
}
}
}
b. Controller文件夹:主要放置BaseController类,该类继承Controller类并根据项目进行自定义改写
c. Filters文件夹:该文件夹主要放置一些自定义的Attribute类
d. Integration文件夹:该文件夹中的类主要是继承DefaultControllerFactory、继承DefaultHttpControllerSelector、继承Attribute并根据项目进行自定义改写
ApiBusiness 这个csproj不用多说,它就是纯写Apicontroller/Action,没啥花招,相应的api服务引用CoreService中相应的dll就可以了。
WebApp 这个csproj是整个Web前端平台的关键,其使用Areas将各个功能进行模块化区分:
a. AppStart文件夹:主要重写BundleConfig与RouteConfig,供Global.asax进行覆盖使用。
public class BundleConfig
{
public static void RegisterBundles(BundleCollection bundles)
{
#region layout
bundles.Add(new ScriptBundle("~/Content/layout/js").Include(
"~/Content/Common/plug-in/JQuery/jquery-2.1.0.js",
"~/Content/Common/plug-in/BootStrap/bootstrap.js",
"~/Content/Common/plug-in/SweetAlert/sweet-alert.js",
));
bundles.Add(new StyleBundle("~/Content/layout/css").Include(
"~/Content/Common/plug-in/BootStrap/bootstrap.css",
"~/Content/Common/fonts/fontawesome/font-awesome.css",
"~/Content/Common/plug-in/SweetAlert/sweet-alert.css",
"~/Content/Layout/css/layout.css"
));
#endregion
... ...
} }
public class RouteConfig
{
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); string defaultsAppSettings = ConfigurationManager.AppSettings["DefaultPage"];
string[] defaultArray = defaultsAppSettings.Split('/'); routes.MapRoute(
name: "login_default",
url: "{controller}/{action}/{id}",
defaults: new { controller = defaultArray[], action = defaultArray[], id = UrlParameter.Optional },
namespaces: new string[] { "Platform.WebApp.Controllers" }
);
}
}
public class MvcApplication : BaseMvcApplication
{
protected override void RegisterBundles()
{
base.RegisterBundles();
BundleConfig.RegisterBundles(BundleTable.Bundles);
RouteConfig.RegisterRoutes(RouteTable.Routes);
}
}
b. Content文件夹,这个不用多说,一张图就懂了,主要放置全局性的前端文件:
c. Controllers与Views文件夹:只放关于Home与Account相关的东西,注意Controller中的命名空间必须为:Platform.WebApp.Controllers
d. Areas文件夹:放置各个模块。假设有一个模块是BIMModel,其架构如下:
其关键在于AreaRegistration类:
public class BIMModleAreaRegistration : AreaRegistration
{
public override string AreaName
{
get { return "BIMModel"; }
} public override void RegisterArea(AreaRegistrationContext context)
{
context.MapRoute(
"bimmodel_default",
"bimmodel/{controller}/{action}/{id}",
new { action = "Index", id = UrlParameter.Optional },
new string[] { "Platform.WebApp.Areas.BIMModel.Controllers" }
);
}
}
注意其controller路由为"bimmodel/{controller}/{action}/{id}",其Controller的命名空间为"Platform.WebApp.Areas.BIMModel.Controllers"
四、总结
经过一番折腾,BIM平台就这样可以搭建起来了,当然要搞的好还是需要很多功夫的。
五、后记
这个月7号就要去新公司报到了。在找下家的时候,按照惯例HR总会问你为什么要换工作?我的答案大概和很多人一样:可爱的领导与同事都走了,钱也没给够。我原来的公司大领导和各小组领导都是非常可爱的人,他们从一个公司出来一起创业,把自己知道的所有技能都毫无保留的教授给新人,整个公司欣欣向荣,团结一致。
但是被完全收购之后却是另一番景象,集团空降领导,外行指挥内行,军心涣散,原来的大领导也被架空出走。空降大领导画大饼可厉害了,开会的时候喊出:“三年之后咱分公司独立上市”,真是想起了无间道里的 “说好了三年,三年之后又三年,三年之后又三年,都快十年了,老大!”。空降大领导想搞大事还不肯加大薪资投入,各组核心都纷纷离开公司,连刚进几个月的实习都想着离开,各小组领导们也很伤心。
领导们都是很可爱的人,和我吃中饭的时候他们对我说到,看到咱公司培养出的怪物们都去了非常棒的企业,他们也很欣慰,圈子很小,以后合作机会还多,记得回来看看!
祝福老东家,希望领导们与同事们都能一切顺利!
进入新公司后自己一个人负责一个产品,重新架构一个BIM软件,也祝福自己,希望努力工作,带给家人幸福!