Question

我是.NET / MVC / Web API的新手。我创建了一个.Net Web API，它接受输入参数查询OracleDatabase并以JSON格式返回结果。几乎遵循简单的C＃代码。我的控制器看起来像

public class DataController : ApiController
{
   [HttpGet]
    public HttpResponseMessage Getdetails(string ROOM, DateTime DOB_GT)
    {
            List<OracleParameter> prms = new List<OracleParameter>();
            prms.Add(new OracleParameter("ROOM", OracleDbType.Varchar2, ROOM, ParameterDirection.Input));
            prms.Add(new OracleParameter("DOB_GT", OracleDbType.Date, DOB_GT, ParameterDirection.Input));
           string connStr = ConfigurationManager.ConnectionStrings["SDataBaseConnection"].ConnectionString;
            using (OracleConnection dbconn = new OracleConnection(connStr))
            {
                DataSet userDataset = new DataSet();
                var strQuery = "SELECT * from SAMPLE_RESULTS_VW where ROOM = :ROOM and DOB > :DOB_GT ";
                var returnObject = new { data = new OracleDataTableJsonResponse(connStr, strQuery, prms.ToArray()) };
                var response = Request.CreateResponse(HttpStatusCode.OK, returnObject, MediaTypeHeaderValue.Parse("application/json"));
                ContentDispositionHeaderValue contentDisposition = null;
                if (ContentDispositionHeaderValue.TryParse("inline; filename=TGSData.json", out contentDisposition))
                {
                    response.Content.Headers.ContentDisposition = contentDisposition;
                }
                return response;
            }

这完美无缺。现在客户端应用程序正在请求元数据。因此，他们可以从服务中提取元数据。我不确定我们是否可以配置现有API来提供元数据。或者我们将不得不从头开始做smoething

Answer 1

有些项目以NuGet包的形式提供，可以帮助您实现这一目标。所以不需要从头开始编写。

您可以添加Swagger来提供api的元数据。请参阅https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger和https://github.com/domaindrivendev/Swashbuckle

使用Asp.Net Web Api helppages（https://www.nuget.org/packages/Microsoft.AspNet.WebApi.HelpPage/），您可以使用https://www.nuget.org/packages/leeksnet.AspNet.WebApi.Wadl/

添加WADL支持

配置Web API以提供元数据

1 个答案: