在.NET Core 刚刚1.0 RC的时候,我就给OData团队创建过Issue让他们支持ASP.NET Core,然而没有任何有意义的答复。
Roadmap for ASP.NET Core 1.0 RC2?
接着,在.NET Core 1.0刚刚发布的时候,又给他们创建了另外一个Issue,虽然被他们列为P1,但是已经没有下文:
Roadmap for OData WebAPI run on ASP.NET Core 1.0
然后在.NET Core 2.0 Preview版本发布的时候,我继续给OData 团队提Issue:
[vNext] Even ASP.NET Core 2 Preview 1 announced, OData WebAPI vNext still no updates
最终,在OData 7.0的时候,OData发布了基于ASP.NET Core的支持。
经过这么长时间的测试和迭代,我想,是时候创建一个基于OData的Web API。
本篇为Part I: Business Scenario
Knowledge Builder是个用来创建、维护、浏览知识点的Web App,Knowledge Builder API是服务于其需求的API。
简单来说,Knowlege Item是个复杂文本,外加一些额外的属性。
就常见的语数英而言,Knowledge本身要支持各种特殊符号,而且需要支付各种数学公式、数学图形等。
这是一个复杂度适中的API, 主要关于rich text的存储,图形文件上传下载等。
数据库表定义如下:
CREATE TABLE [dbo].[Knowledge] ( [ID] INT IDENTITY (1, 1) NOT NULL, [ContentType] SMALLINT NULL, [Title] NVARCHAR (50) NOT NULL, [Content] NVARCHAR (MAX) NOT NULL, [Tags] NCHAR (100) NULL, [CreatedAt] DATETIME DEFAULT (getdate()) NULL, [ModifiedAt] DATETIME DEFAULT (getdate()) NULL, PRIMARY KEY CLUSTERED ([ID] ASC) );