Часть 6. Создание контроллеров продуктов и заказов

Рик Андерсон

Добавление контроллера продуктов

Контроллер администратора предназначен для пользователей, имеющих права администратора. С другой стороны, клиенты могут просматривать продукты, но не могут создавать, обновлять или удалять их.

Мы можем легко ограничить доступ к методам Post, Put и Delete, оставляя методы Get открытыми. Но ознакомьтесь с данными, возвращаемыми для продукта:

{"Id":1,"Name":"Tomato Soup","Price":1.39,"ActualCost":0.99}

Свойство ActualCost не должно быть видимым для клиентов! Решение заключается в определении объекта передачи данных (DTO), который включает подмножество свойств, которые должны быть видимы для клиентов. Мы будем использовать LINQ для проецирования экземпляров Product в экземпляры ProductDTO.

Добавьте класс с именем ProductDTO в папку Models.

namespace ProductStore.Models
{
    public class ProductDTO
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public decimal Price { get; set; }
    }
}

Теперь добавьте контроллер. В обозревателе решений щелкните правой кнопкой мыши папку Контроллеров. Нажмите кнопку "Добавить", а затем выберите "Контроллер". В диалоговом окне добавления контроллера назовите контроллер ProductsController. В разделе "Шаблон" выберите пустой контроллер API.

Снимок экрана: диалоговое окно добавления контроллера.

Замените все в исходном файле следующим кодом:

namespace ProductStore.Controllers
{
    using System.Collections.Generic;
    using System.Linq;
    using System.Net;
    using System.Net.Http;
    using System.Web.Http;
    using ProductStore.Models;

    public class ProductsController : ApiController
    {
        private OrdersContext db = new OrdersContext();

        // Project products to product DTOs.
        private IQueryable<ProductDTO> MapProducts()
        {
            return from p in db.Products select new ProductDTO() 
                { Id = p.Id, Name = p.Name, Price = p.Price };
        }

        public IEnumerable<ProductDTO> GetProducts()
        {
            return MapProducts().AsEnumerable();
        }

        public ProductDTO GetProduct(int id)
        {
            var product = (from p in MapProducts() 
                           where p.Id == 1 
                           select p).FirstOrDefault();
            if (product == null)
            {
                throw new HttpResponseException(
                    Request.CreateResponse(HttpStatusCode.NotFound));
            }
            return product;
        }

        protected override void Dispose(bool disposing)
        {
            db.Dispose();
            base.Dispose(disposing);
        }
    }
}

Контроллер по-прежнему использует OrdersContext для выполнения запроса к базе данных. Но вместо прямого возврата Product экземпляров мы вызываем MapProducts проектировать их на ProductDTO экземпляры:

return from p in db.Products select new ProductDTO() 
    { Id = p.Id, Name = p.Name, Price = p.Price };

Метод MapProducts возвращает IQueryable, поэтому мы можем создать результат с другими параметрами запроса. Это можно увидеть в методе GetProduct , который добавляет предложение where в запрос:

var product = (from p in MapProducts() 
    where p.Id == 1
    select p).FirstOrDefault();

Добавление контроллера заказов

Затем добавьте контроллер, позволяющий пользователям создавать и просматривать заказы.

Начнем с другого DTO. В обозревателе решений щелкните правой кнопкой мыши папку Models и добавьте класс с именем OrderDTO Use the following implementation:

namespace ProductStore.Models
{
    using System.Collections.Generic;

    public class OrderDTO
    {
        public class Detail
        {
            public int ProductID { get; set; }
            public string Product { get; set; }
            public decimal Price { get; set; }
            public int Quantity { get; set; }
        }
        public IEnumerable<Detail> Details { get; set; }
    }
}

Теперь добавьте контроллер. В обозревателе решений щелкните правой кнопкой мыши папку Контроллеров. Нажмите кнопку "Добавить", а затем выберите "Контроллер". В диалоговом окне "Добавить контроллер" задайте следующие параметры:

В разделе "Имя контроллера" введите "OrdersController".
В разделе "Шаблон" выберите "Контроллер API с действиями чтения и записи с помощью Entity Framework".
В разделе "Класс модели" выберите "Order (ProductStore.Models)".
В разделе "Класс контекста данных" выберите "OrdersContext (ProductStore.Models)".

Снимок экрана: диалоговое окно добавления контроллера. OrdersController записывается в текстовое поле.

Нажмите кнопку Добавить. При этом добавляется файл с именем OrdersController.cs. Затем необходимо изменить реализацию контроллера по умолчанию.

Сначала удалите PutOrder и DeleteOrder методы. В этом примере клиенты не могут изменять или удалять существующие заказы. В реальном приложении для обработки этих случаев потребуется много внутренней логики. (Например, заказ уже отправлен?)

Измените GetOrders метод, чтобы вернуть только заказы, принадлежащие пользователю:

public IEnumerable<Order> GetOrders()
{
    return db.Orders.Where(o => o.Customer == User.Identity.Name);
}

Измените GetOrder метод следующим образом:

public OrderDTO GetOrder(int id)
{
    Order order = db.Orders.Include("OrderDetails.Product")
        .First(o => o.Id == id && o.Customer == User.Identity.Name);
    if (order == null)
    {
        throw new HttpResponseException(Request.CreateResponse(HttpStatusCode.NotFound));
    }

    return new OrderDTO()
    {
        Details = from d in order.OrderDetails
                  select new OrderDTO.Detail()
                      {
                          ProductID = d.Product.Id,
                          Product = d.Product.Name,
                          Price = d.Product.Price,
                          Quantity = d.Quantity
                      }
    };
}

Ниже приведены изменения, внесенные в метод:

Возвращаемое значение — это экземпляр OrderDTO, а не Order.
При запросе базы данных для заказа мы используем метод DbQuery.Include для получения связанных OrderDetail и Product сущностей.
Мы разравним результат с помощью проекции.

Http-ответ будет содержать массив продуктов с количеством:

{"Details":[{"ProductID":1,"Product":"Tomato Soup","Price":1.39,"Quantity":2},
{"ProductID":3,"Product":"Yo yo","Price":6.99,"Quantity":1}]}

Этот формат проще использовать клиентам, чем исходный граф объектов, содержащий вложенные сущности (порядок, сведения и продукты).

Последний метод рассмотрения — это PostOrder. Сейчас этот метод принимает Order экземпляр. Но рассмотрим, что произойдет, если клиент отправляет текст запроса следующим образом:

{"Customer":"Alice","OrderDetails":[{"Quantity":1,"Product":{"Name":"Koala bears", 
"Price":5,"ActualCost":1}}]}

Это хорошо структурированный порядок, и Entity Framework будет счастливо вставлять его в базу данных. Но он содержит сущность Product, которая ранее не существовала. Клиент только что создал новый продукт в нашей базе данных! Это будет сюрпризом для отдела выполнения заказов, когда они видят заказ на коала медведей. Мораль заключается в том, чтобы быть действительно осторожными с данными, которые вы принимаете в запросе POST или PUT.

Чтобы избежать этой проблемы, измените PostOrder метод на экземпляр OrderDTO . Используйте OrderDTO, чтобы создать Order.

var order = new Order()
{
    Customer = User.Identity.Name,
    OrderDetails = (from item in dto.Details select new OrderDetail() 
        { ProductId = item.ProductID, Quantity = item.Quantity }).ToList()
};

Обратите внимание, что мы используем ProductID и Quantity свойства, и мы игнорируем любые значения, отправленные клиентом для имени продукта или цены. Если идентификатор продукта недействителен, это нарушит ограничение внешнего ключа в базе данных, и вставка завершится ошибкой, как и должно быть.

Ниже приведен полный PostOrder метод:

public HttpResponseMessage PostOrder(OrderDTO dto)
{
    if (ModelState.IsValid)
    {
        var order = new Order()
        {
            Customer = User.Identity.Name,
            OrderDetails = (from item in dto.Details select new OrderDetail() 
                { ProductId = item.ProductID, Quantity = item.Quantity }).ToList()
        };

        db.Orders.Add(order);
        db.SaveChanges();

        HttpResponseMessage response = Request.CreateResponse(HttpStatusCode.Created, order);
        response.Headers.Location = new Uri(Url.Link("DefaultApi", new { id = order.Id }));
        return response;
    }
    else
    {
        return Request.CreateResponse(HttpStatusCode.BadRequest);
    }
}

Наконец, добавьте атрибут Authorize к контроллеру:

[Authorize]
public class OrdersController : ApiController
{
    // ...

Теперь только зарегистрированные пользователи могут создавать или просматривать заказы.

Назад Далее

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-27

Часть 6. Создание контроллеров продуктов и заказов

Добавление контроллера продуктов

Добавление контроллера заказов

Обратная связь

Дополнительные ресурсы