WebAPI PUT通话建议

时间:2012-09-07 15:42:31

标签: .net asp.net-web-api

所以我正在使用.NET 4 WebAPI示例,并且我已经将大部分工作都正常工作但是我不确定如何将PUT返回到具有存储在基础表中的值的数据库。我有一个存储过程从表中提取所有数据。我有一个名为Setting.cs的类,这基本上是底层表的对象表示。此

// Model - Settings
public class Setting
{
    public int ID { get; set; }
    public string Category { get; set; }
    public string Sub_Category { get; set; }
    public int UnitSize { get; set; }
    public int UnitOfMeasureID { get; set; }
    public bool Facings { get; set; }
    public bool Quantity { get; set; }
    public double EverydayPrice { get; set; }
    public double PromotionPrice { get; set; }
}

此界面可确保实施正确的方法

// We need to store a collection of settings.  It's a good idea to separate the collection from our service implementation.
// This allows the backing store to be changed without rewriting the service class.  This is a design pattern called REPOSITORY.
public interface ISettingRepository
{
    IEnumerable<Setting> GetAll();
    Setting Get(int id);
    Setting Add(Setting item);
    void Remove(int id);
    bool Update(Setting item);
}

接下来我有实际的存储库

public class SettingRepository : ISettingRepository
{
    private List<Setting> settings = new List<Setting>();
    private int _nextId = 1;

    public SettingRepository()
    {
        SqlConnection conn = new SqlConnection(Security.Security.Decrypt(ConfigurationManager.ConnectionStrings["myDatabase"].ConnectionString, "passwordString"));
        SqlCommand cmd = new SqlCommand("sp_GetAllSettings", conn);
        cmd.CommandType = CommandType.StoredProcedure;

        SqlParameter param_category = cmd.Parameters.Add("CATEGORY", SqlDbType.VarChar);
        param_category.Value = "Salad";
        param_category.Direction = ParameterDirection.Input;

        SqlParameter param_sub_catgegory = cmd.Parameters.Add("SUB_CATEGORY", SqlDbType.VarChar);
        param_sub_catgegory.Value = "Clamshell";
        param_sub_catgegory.Direction = ParameterDirection.Input;

        SqlParameter param_unit_size = cmd.Parameters.Add("UNIT_SIZE", SqlDbType.Int);
        param_unit_size.Value = 5;
        param_unit_size.Direction = ParameterDirection.Input;

        SqlParameter param_unit_of_measure_id = cmd.Parameters.Add("UNIT_OF_MEASURE_ID", SqlDbType.Int);
        param_unit_of_measure_id.Value = 6;
        param_unit_of_measure_id.Direction = ParameterDirection.Input;

        SqlParameter param_facings_bool = cmd.Parameters.Add("FACINGS", SqlDbType.Bit);
        param_facings_bool.Value = true;
        param_facings_bool.Direction = ParameterDirection.Input;

        SqlParameter param_quantity_bool = cmd.Parameters.Add("QUANTITY", SqlDbType.Bit);
        param_quantity_bool.Value = true;
        param_quantity_bool.Direction = ParameterDirection.Input;

        SqlParameter param_everyday_price = cmd.Parameters.Add("EVERYDAY_PRICE", SqlDbType.Money);
        param_everyday_price.Value = 9.99;
        param_everyday_price.Direction = ParameterDirection.Input;

        SqlParameter param_promotion_price = cmd.Parameters.Add("PROMOTION_PRICE", SqlDbType.Money);
        param_promotion_price.Value = 8.95;
        param_promotion_price.Direction = ParameterDirection.Input;

        try
        {
            conn.Open();
            SqlDataReader dr = cmd.ExecuteReader();
            settings = Base.DataReaderMapToList<Setting>(dr);
            dr.Close();
            conn.Close();
        }
        catch (Exception ex)
        {
            ex.Message.ToString();
        }
    }
    public IEnumerable<Setting> GetAll()
    {
        return settings;
    }

    public Setting Get(int id)
    {
        return settings.Find(p => p.ID == id);
    }

    public Setting Add(Setting item)
    {
        item.ID = _nextId++;
        settings.Add(item);
        return item;
    }

    public void Remove(int id)
    {
        settings.RemoveAll(p => p.ID == id);
    }

    public bool Update(Setting item)
    {
        int index = settings.FindIndex(p => p.ID == item.ID);

        if (index == -1)
        {
            return false;
        }

        settings.RemoveAt(index);
        settings.Add(item);
        return true;
    }
}

最后我有了SettingsController

public class SettingsController : ApiController
{
    static readonly ISettingRepository repository = new SettingRepository();

    // GET /api/values
    /// <summary>
    /// Returns the entire list of settings as an IEnumerable<Setting> type.
    /// </summary>
    /// <returns></returns>
    public IEnumerable<Setting> GetAllSettings()
    {
        return repository.GetAll();
    }

    // GET /api/values/5
    /// <summary>
    /// Looks up a single setting by ID
    /// </summary>
    /// <param name="id"></param>
    /// <returns></returns>
    public Setting GetSettingById(int id)
    {
        Setting item = repository.Get(id);

        if (item == null)
        {
            throw new HttpResponseException(new HttpResponseMessage(HttpStatusCode.NotFound));
        }

        return item;
    }

    /// <summary>
    /// Returns all settings with a specified category.
    /// </summary>
    /// <param name="category"></param>
    /// <returns></returns>
    public IEnumerable<Setting> GetSettingsByCategory(string category)
    {
        return repository.GetAll().Where(p => string.Equals(p.Category, category, StringComparison.OrdinalIgnoreCase));
    }

    /// <summary>
    /// Returns all settings with a specified category and subcategory.
    /// </summary>
    /// <param name="category"></param>
    /// <param name="subCategory"></param>
    /// <returns></returns>
    public IEnumerable<Setting> GetDefaultPriceSettingsByCategoryAndSubCategory(string category, string subCategory)
    {
        return repository.GetAll().Where(p => string.Equals(p.Category, category, StringComparison.OrdinalIgnoreCase)).Where(p => string.Equals(p.Sub_Category, subCategory, StringComparison.OrdinalIgnoreCase));
    }

    // TODO: Refactor
    // NOTE: By default, parameters with complex types are deserialized from the request body.
    // Therefore, we expect the client to send us a serialized representation of a product object,
    // using either XML or JSON for the serialization.
    // RESPONSE CODE: By default, the Web API framework sets the response status code to 200 (OK).
    // Per the HTTP/1.1 protocol, when a POST request results in the creation of a resource,
    // the server should reply with status 201 (Created).
    // LOCATION: When the server creates a resource, it should include the URI of the new resource in the Location
    // header of the response.
    // By returning an HttpResponseMessage instead of a Product, we can control the details of the HTTP response message
    // including the status code and the Location header.
    public HttpResponseMessage PostSetting(Setting item)
    {
        item = repository.Add(item);
        //var response = Request.CreateResponse(HttpStatusCode.Created);
        var response = new HttpResponseMessage<Setting>(item) { StatusCode = HttpStatusCode.Created };

        string uri = Url.Route("DefaultApi", new { id = item.ID });
        response.Headers.Location = new Uri(uri);
        return response;
    }

    // PUT /api/values/5
    // This method name starts with a "Put....", so Web API matches it to PUT requests.
    // The contact parameter is deserialized from the request body.  By default, the ASP.NET Web API framework
    // takes simple parameter types from the route and complex types from the request body.
    public void PutSetting(int id, Setting contract)
    {
        contract.ID = id;

        if (!repository.Update(contract))
        {
            throw new HttpResponseException(new HttpResponseMessage(HttpStatusCode.NotFound));
        }
    }

    // DELETE /api/values/5
    // According to the HTTP specification, the DELETE method must be idempotent,
    // meaning that several DELETE requests to the same URI must have the same effect as a single DELETE request.
    // Therefore, the method should not return an error code if the contact was already deleted.
    //
    // If a DELETE request succeeds, it can return status 200 (OK) with an entity-body that describes the status,
    // or status 202 (Accepted) if the deletion is still pending, or status 204 (No Content) with no entity body.
    // In this example, the method returns status 204.
    public HttpResponseMessage DeleteSetting(int id)
    {
        repository.Remove(id);
        return new HttpResponseMessage(HttpStatusCode.NoContent);
    }
}

这是我的存储过程,如果包含所有值,则允许插入行,否则返回select。 ID列是自动增量标识值。

ALTER PROCEDURE [dbo].[sp_GetAllSettings]
@CATEGORY AS VARCHAR(10) = NULL,
@SUB_CATEGORY AS VARCHAR(10) = NULL,
@UNIT_SIZE AS INTEGER = NULL,
@UNIT_OF_MEASURE_ID AS INTEGER = NULL,
@FACINGS AS BIT = NULL,
@QUANTITY AS BIT = NULL,
@EVERYDAY_PRICE AS MONEY = NULL,
@PROMOTION_PRICE AS MONEY = NULL
AS

BEGIN
SET NOCOUNT ON;

IF NOT @CATEGORY IS NULL
    AND NOT @SUB_CATEGORY IS NULL
    AND NOT @UNIT_SIZE IS NULL
    AND NOT @UNIT_OF_MEASURE_ID IS NULL
    AND NOT @FACINGS IS NULL
    AND NOT @QUANTITY IS NULL
    AND NOT @EVERYDAY_PRICE IS NULL
    AND NOT @PROMOTION_PRICE IS NULL

    INSERT INTO Settings(Category,
                         Sub_Category,
                         UnitSize,
                         UnitOfMeasureID,
                         Facings,
                         Quantity,
                         EverydayPrice,
                         PromotionPrice)

    VALUES (@CATEGORY,
            @SUB_CATEGORY,
            @UNIT_SIZE,
            @UNIT_OF_MEASURE_ID,
            @FACINGS,
            @QUANTITY,
            @EVERYDAY_PRICE,
            @PROMOTION_PRICE)
ELSE
    SELECT [ID],
            Category,
            Sub_Category,
            UnitSize,
            UnitOfMeasureID,
            Facings,
            Quantity,
            EverydayPrice,
            PromotionPrice

    FROM Settings
END

一个简单的执行语句将允许插入:

exec [sp_GetAllSettings] "Salad", "Clamshell", 4, 5, 1, 1, 3.99, 2.75

我想弄清楚的是:使用这种方法时,允许将新设置存储在数据库中的最佳方法是什么?我假设PUT电话最好。

似乎我需要一个新的存储过程,或者我可以使用默认NULL值的相同存储过程,如果传递了值,那么我会INSERT而不是{{1} }。

有什么建议吗?

更新:我已使用最新的存储过程更新了我的代码。我真正缺少的部分是如何在URL中创建SELECT调用,以便我可以基本上发送您在上面的存储过程执行语句中看到的内容。我希望有类似的东西:

PUT

但是,我猜这不是正确的方法。

1 个答案:

答案 0 :(得分:0)

您的API具有必要的代码,可以通过此处的存储库将新项目插入数据库:

public HttpResponseMessage PostSetting(Setting item)
{
    item = repository.Add(item);
    //var response = Request.CreateResponse(HttpStatusCode.Created);
    var response = new HttpResponseMessage<Setting>(item) { StatusCode = HttpStatusCode.Created };

    string uri = Url.Route("DefaultApi", new { id = item.ID });
    response.Headers.Location = new Uri(uri);
    return response;
}

我认为你的问题是,如何测试这个?什么是URL?

您需要创建要测试的Setting类或项的JSON表示,并使用Fiddler(现在是Telerik产品)等产品并使用Composer选项卡。< / p>

接下来,您需要对以下网址执行POST:

http:// [您的基本网址] / api / settings

并传递JSON格式的设置类。

您可以在此处查看此示例:ASP.NET Web API - Scott Hanselman