转载

Fireasy与Asp.net MVC结合

Fireasy之前都是使用HttpService来为jquery ajax提供服务,这个HttpService实际上和MVC的原理机制是一样的,只是它支持两种方式,一种是使用统一的一个类来提供服务(基于MEF导入),另一种是使用aspx的类文件提供服务,具体使用哪一种,根据项目的性质来决定。

Asp.net MVC也就了解了一些皮毛,还不是很熟悉,正在深度学习中。不过基于以前的开发习惯,我觉得MVC要进行以下几点的改进:

(1)异常处理。MVC实现了一个异常滤过器HandleErrorAttribute,可以对执行action发生的异常进行处理,以便返回错误信息。但是它默认返回了一个View,我希望在发生异常时记录日志,并在前台进行友好的提示。

(2)Json序列化。翻出JsonResult的源代码来看,你会发现它的json序列化是由 JavaScriptSerializer类完成的,对于这个类,我不想说什么。

(3)Action参数的反序列化。对于Fireasy的轻实体模型而言,它无法进行反序列化。

暂时先处理这三个问题吧,后来遇到问题再贴上来。

一、异常处理

在之前的开发模式中,我们都是使用ajax取数据和保存数据,我觉得相对于mvc的model bind来说这样比较灵活,因为毕竟使用easyui,在取数的时候可能会有一些复杂的处理,我们都放在前台上编码吧。

在读取和保存数据的时候,避免不了会发生一些异常,如果按mvc的默认处理,我们将无法接收异常信息,这是一样相当头疼的事情。因此,我们对HandleErrorAttribute做一些改进:

对json的包装一会儿会说。如果是ClientNotificationException异常,直接显示错误信息,否则记录日志,返回提示信息。

/// <summary> /// 控制器方法执行发生异常时,记录日志并返回友好的提示信息。 /// </summary> public class HandleErrorAttribute : System.Web.Mvc.HandleErrorAttribute {  /// <summary>  /// 处理异常信息。  /// </summary>  /// <param name="filterContext"></param>  public override void OnException(ExceptionContext filterContext)  {   if (IsJsonResult(filterContext))   {    HandleExceptionForJson(filterContext);   }   else   {    HandleException(filterContext);   }   LogException(filterContext);  }  /// <summary>  /// 判断返回结果是否为 Json 类型。  /// </summary>  /// <param name="filterContext"></param>  /// <returns></returns>  protected virtual bool IsJsonResult(ExceptionContext filterContext)  {   if (ActionContext.Current != null)   {    var desc = ActionContext.Current.ActionDescriptor as ReflectedActionDescriptor;    if (desc != null)    {     return typeof(JsonResult).IsAssignableFrom(desc.MethodInfo.ReturnType);    }   }   return false;  }  /// <summary>  /// 处理返回结果为Json的异常信息。  /// </summary>  /// <param name="filterContext"></param>  protected virtual void HandleExceptionForJson(ExceptionContext filterContext)  {   //如果是通知类的异常,直接输出提示   var notifyExp = filterContext.Exception as Fireasy.Common.ClientNotificationException;   if (notifyExp != null)   {    filterContext.Result = new JsonResultWrapper(new JsonResult { Data = Result.Fail(notifyExp.Message) });    filterContext.ExceptionHandled = true;    return;   }   else   {    filterContext.Result = GetHandledResult();    filterContext.ExceptionHandled = true;   }  }  /// <summary>  /// 处理一般返回结果的异常信息。  /// </summary>  /// <param name="filterContext"></param>  protected virtual void HandleException(ExceptionContext filterContext)  {   var errorPage = ConfigurationManager.AppSettings["error-page"];   if (!string.IsNullOrEmpty(errorPage))   {    filterContext.Result = new RedirectResult(errorPage);    filterContext.ExceptionHandled = true;   }  }  /// <summary>  /// 记录异常日志。  /// </summary>  /// <param name="filterContext"></param>  protected virtual void LogException(ExceptionContext filterContext)  {   //记录日志   var logger = LoggerFactory.CreateLogger();   if (logger != null)   {    var controllerName = (string)filterContext.RouteData.Values["controller"];    var actionName = (string)filterContext.RouteData.Values["action"];    logger.Error(string.Format("执行控制器 {0} 的方法 {1} 时发生错误。",     controllerName, actionName), filterContext.Exception);   }  }  /// <summary>  /// 获取处理后的返回结果。  /// </summary>  /// <returns></returns>  protected virtual ActionResult GetHandledResult()  {   if (ActionContext.Current != null)   {    //检查是否定义了 ExceptionBehaviorAttribute 特性    var attr = ActionContext.Current.ActionDescriptor     .GetCustomAttributes(typeof(ExceptionBehaviorAttribute), false)     .Cast<ExceptionBehaviorAttribute>().FirstOrDefault();    if (attr != null)    {     //返回空数组,一般用在列表绑定上     if (attr.EmptyArray)     {      return new JsonResultWrapper(new JsonResult { Data = new string[0] });     }     //使用提示信息     else if (!string.IsNullOrEmpty(attr.Message))     {      return new JsonResultWrapper(new JsonResult { Data = Result.Fail(attr.Message) });     }    }   }   return new JsonResultWrapper(new JsonResult { Data = Result.Fail("发生错误,请查阅相关日志或联系管理员。") });  } } 

对异常的处理分两种情况,如果是返回Json,则返回结果是Json格式,否则定向到出错页面

二、Json序列化

Json的序列化是在JsonResult的ExecuteResult里完成,它用JavaScriptSerializer这个东东来序列化,有点想不通,webapi都使用Json.Net了,mvc5还是这样,估计MS不想用Json.Net。

实在不想在Action里使用其他的Result类来替代Json()方法,因为这样做会破坏程序的可维护性。那么最好的办法就是对JsonResult进行包装。

/// <summary> ///<see cref="JsonResult"/> 进行包装,重写序列化对象的方法。 /// </summary> public class JsonResultWrapper : JsonResult {  private JsonResult result;  /// <summary>  /// 初始化 <see cref="JsonResultWrapper"/> 类的新实例。  /// </summary>  /// <param name="result"></param>  public JsonResultWrapper(JsonResult result)  {   result.JsonRequestBehavior = System.Web.Mvc.JsonRequestBehavior.AllowGet;   this.result = result;  }  /// <summary>  /// 将结果输出到 Response。  /// </summary>  /// <param name="context"></param>  public override void ExecuteResult(ControllerContext context)  {   if (context == null)   {    throw new ArgumentNullException("context");   }   if (result == null)   {    throw new ArgumentNullException("result");   }   if ((result.JsonRequestBehavior == System.Web.Mvc.JsonRequestBehavior.DenyGet) &&     string.Equals(context.HttpContext.Request.HttpMethod, "GET", StringComparison.OrdinalIgnoreCase))   {    throw new InvalidOperationException("不能在Url中访问。");   }   var response = context.HttpContext.Response;   if (!string.IsNullOrEmpty(result.ContentType))   {    response.ContentType = result.ContentType;   }   else   {    response.ContentType = "application/json";   }   if (result.ContentEncoding != null)   {    response.ContentEncoding = result.ContentEncoding;   }   if (result.Data != null)   {    response.Write(SerializeJson(context, result.Data));   }  }  /// <summary>  /// 将数据序列化为 Json 字符串。这里使用了 Fireasy 提供的 Json 序列化方法。  /// </summary>  /// <param name="context"></param>  /// <param name="data">要序列化的数据。</param>  /// <returns></returns>  protected virtual string SerializeJson(ControllerContext context, object data)  {   var option = new JsonSerializeOption();   if (ActionContext.Current != null)   {    //json转换器    var converters = ActionContext.Current.Converters.Where(s => s is JsonConverter).Cast<JsonConverter>();    option.Converters.AddRange(converters);   }   //jsonp的处理   //var jsoncallback = context.HttpContext.Request.Params["callback"];   var serializer = new JsonSerializer(option);   var json = serializer.Serialize(data);   //if (!string.IsNullOrEmpty(jsoncallback))   //{   // return string.Format("{0}({1})", jsoncallback, json);   //}   return json;  } } 

注意了,上面代码中标红的ActionContext是一个线程内的上下文对象,它的作用是在方法执行期间可以由用户在Action里得到该对象并往里面加东西,比如JsonConverter。

/// <summary> /// 控制器操作方法执行期间的上下文对象。 /// </summary> public class ActionContext : Scope<ActionContext> {  internal ActionContext(ControllerContext controllerContext)  {   ControllerContext = controllerContext;   Converters = new List<ITextConverter>();  }  /// <summary>  /// 获取控制器上下文对象。  /// </summary>  public ControllerContext ControllerContext { get; private set; }  /// <summary>  /// 获取动作相关的 <see cref="ActionDescriptor"/> 对象。  /// </summary>  public ActionDescriptor ActionDescriptor { get; internal set; }  /// <summary>  /// 获取文本转换器列表。  /// </summary>  public List<ITextConverter> Converters { get; private set; }  /// <summary>  /// 获取动作方法的参数字典。  /// </summary>  public IDictionary<string, object> Parameters { get; internal set; } } 

那么它在什么时候被创建,什么时候被销毁呢,幸好有ControllerActionInvoker这个类可以进行继承。

public class ControllerActionInvoker : System.Web.Mvc.ControllerActionInvoker {  internal static ControllerActionInvoker Instance = new ControllerActionInvoker();  /// <summary>  /// 执行控制器的动作。  /// </summary>  /// <param name="controllerContext"></param>  /// <param name="actionName"></param>  /// <returns></returns>  public override bool InvokeAction(ControllerContext controllerContext, string actionName)  {   using (var scope = new ActionContext(controllerContext))   {    return base.InvokeAction(controllerContext, actionName);   }  }  /// <summary>  /// 执行动作方法。  /// </summary>  /// <param name="controllerContext"></param>  /// <param name="actionDescriptor"></param>  /// <param name="parameters"></param>  /// <returns></returns>  protected override ActionResult InvokeActionMethod(ControllerContext controllerContext, ActionDescriptor actionDescriptor, IDictionary<string, object> parameters)  {   if (ActionContext.Current != null)   {    ActionContext.Current.ActionDescriptor = actionDescriptor;    ActionContext.Current.Parameters = parameters;   }   var result = base.InvokeActionMethod(controllerContext, actionDescriptor, parameters);   var jsonResult = result as JsonResult;   if (jsonResult != null && !(result is JsonResultWrapper))   {    return WrapJsonResult(jsonResult);   }   return result;  }  /// <summary>  ///<see cref="JsonResult"/> 对象进行包装并转换输出结果。  /// </summary>  /// <param name="jsonResult"></param>  /// <returns></returns>  protected virtual ActionResult WrapJsonResult(JsonResult jsonResult)  {   return new JsonResultWrapper(jsonResult);  } } 

这样,在Action方法里,都可以通过ActionContext.Current获得此实例,可获得ActionDescriptor等等定义信息,以及序列化转换器。

另外,上面的代码中,重写InvokeActionMethod方法,对JsonResult进行包装。

如果你是使用Json.Net,那一样的道理,换成Json.Net的序列化就行了。

三、Action参数反序列化

在上面的这个类ControllerActionInvoker中,重写GetParameterValue方法,对参数进行反序列化。

public class ControllerActionInvoker : System.Web.Mvc.ControllerActionInvoker {  internal static ControllerActionInvoker Instance = new ControllerActionInvoker();  /// <summary>  /// 获取参数的值。  /// </summary>  /// <param name="controllerContext"></param>  /// <param name="parameterDescriptor"></param>  /// <returns></returns>  protected override object GetParameterValue(ControllerContext controllerContext, ParameterDescriptor parameterDescriptor)  {   var value = base.GetParameterValue(controllerContext, parameterDescriptor);   if (value == null)   {    //对json进行反序列化,由于使用了基于 Fireasy AOP 的实体模型,所以必须使用 Fireasy 的反序列化方法     var json = controllerContext.HttpContext.Request.Params[parameterDescriptor.ParameterName];    if (!string.IsNullOrEmpty(json))    {     try     {      var option = new JsonSerializeOption();      if (ActionContext.Current != null)      {       //json转换器       var converters = ActionContext.Current.Converters.Where(s => s is JsonConverter).Cast<JsonConverter>();       option.Converters.AddRange(converters);      }      var serializer = new JsonSerializer(option);      value = serializer.Deserialize(json, parameterDescriptor.ParameterType);     }     catch (Exception exp)     {      var logger = LoggerFactory.CreateLogger();      if (logger != null)      {       var message = string.Format("无法解析控制器 {0} 的方法 {1} 的参数 {2} 的值。/n/n数据为: {3}",         parameterDescriptor.ActionDescriptor.ControllerDescriptor.ControllerName,         parameterDescriptor.ActionDescriptor.ActionName,         parameterDescriptor.ParameterName,        json);       logger.Error(message, exp);      }     }    }   }   return value;  } } 

改造完成,现在沿用以前的开发模式,但是底层使用了MVC的控制器,也算是一点小进步吧。昨天一讲课一边做了一个小实例,我也放上来分享给大家,以加深对Fireasy的了解。

示例下载

正文到此结束
Loading...