MVC Music Store 在线音乐商店示例分析（10）ShoppingCartController

ShoppingCartController购物车控制器，专门管理购物车。

注释后源代码如下：

    /// <summary>
    /// 购物车控制器
    /// </summary>
    public class ShoppingCartController : Controller
    {
        /// <summary>
        /// 音乐商店实体
        /// </summary>
        MusicStoreEntities storeDB = new MusicStoreEntities();

        //
        // GET: /ShoppingCart/

        public ActionResult Index()
        {
            //获取购物车
            var cart = ShoppingCart.GetCart(this.HttpContext);

            // Set up our ViewModel
            //设置购物车视图模型，用于装载购物项和总价
            var viewModel = new ShoppingCartViewModel
            {
                CartItems = cart.GetCartItems(),
                CartTotal = cart.GetTotal()
            };

            // Return the view
            return View(viewModel);
        }

        //
        // GET: /Store/AddToCart/5
        // 将指定项添加到购物车
        public ActionResult AddToCart(int id)
        {

            // Retrieve the album from the database
            // 从数据库中检索指定编号的音乐相册
            var addedAlbum = storeDB.Albums
                .Single(album => album.AlbumId == id);

            // Add it to the shopping cart
            // 获取购物车对象
            var cart = ShoppingCart.GetCart(this.HttpContext);
            //将检索到的音乐相册添加到购物车中
            cart.AddToCart(addedAlbum);

            // Go back to the main store page for more shopping
            // 重定向到首页，以便用户添加更多的商品。
            return RedirectToAction("Index");
        }

        //
        // AJAX: /ShoppingCart/RemoveFromCart/5
        /// <summary>
        /// 从购物车中移除指定编号的音乐相册
        /// </summary>
        /// <param name="id">音乐相册编号</param>
        /// <returns></returns>
        [HttpPost]
        public ActionResult RemoveFromCart(int id)
        {
            // Remove the item from the cart
            //获取购物车对象
            var cart = ShoppingCart.GetCart(this.HttpContext);

            // Get the name of the album to display confirmation
            // 获取该编号的音乐相册的名称，以便显示确认信息
            string albumName = storeDB.Carts
                .Single(item => item.RecordId == id).Album.Title;

            // Remove from cart
            //从购物车中移除该项
            int itemCount = cart.RemoveFromCart(id);

            // Display the confirmation message
            // 构建购物车移除项模板，装载对应的消息
            var results = new ShoppingCartRemoveViewModel
            {
                Message = Server.HtmlEncode(albumName) +
                    " has been removed from your shopping cart.",
                CartTotal = cart.GetTotal(),
                CartCount = cart.GetCount(),
                ItemCount = itemCount,
                DeleteId = id
            };
            //以json形式反馈移除项后的信息。
            return Json(results);
        }

        //
        // GET: /ShoppingCart/CartSummary
        /// <summary>
        /// 购物车说明描述
        /// ChildActionOnly特性用于指示操作方法只应作为子操作进行调用。 
        /// 子操作方法呈现部分视图的内联 HTML 标记而不是呈现整个视图。 
        /// 标记有 ChildActionOnlyAttribute 的任何方法只能通过 Action 或 RenderAction HTML 扩展方法调用。
        /// http://msdn.microsoft.com/query/dev10.query?appId=Dev10IDEF1&l=ZH-CN&k=k(SYSTEM.WEB.MVC.CHILDACTIONONLYATTRIBUTE);k(CHILDACTIONONLY)&rd=true
        /// </summary>
        /// <returns></returns>
        [ChildActionOnly]
        public ActionResult CartSummary()
        {
            //获取购物车对象
            var cart = ShoppingCart.GetCart(this.HttpContext);
            //在视图数据模型中填充购物车商品数量
            ViewData["CartCount"] = cart.GetCount();
            //返回部分视图
            return PartialView("CartSummary");
        }
    }

    

    Index Action用于展示购物车中内容。

    AddToCart Action用于将指定项添加到购物车中。

    RemoveFromCart Action用于将指定的项从购物车中移除。移除后呈现对应的消息。

    CartSummary Action 用于呈现购物车的描述信息，该Action属于部分视图，ChildActionOnly特性标记用于表示当前Action作为子操作进行调用，呈现出一个页面的一部分，用于将来组合一个完整的视图。