添加项目文件。

test/Basic/Controllers/CrudActionsController.cs

@@ -0,0 +1,118 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    /// <summary>
+    /// Summary for CrudActionsController
+    /// </summary>
+    [Route("/products")]
+    [Produces("application/json")]
+    [ApiExplorerSettings(GroupName = "v1")]
+    public class CrudActionsController
+    {
+        /// <summary>
+        /// Creates a <paramref name="product"/>
+        /// </summary>
+        /// <remarks>
+        /// ## Heading 1
+        /// 
+        ///     POST /products
+        ///     {
+        ///         "id": "123",
+        ///         "description": "Some product"
+        ///     }
+        /// 
+        /// </remarks>
+        /// <param name="product"></param>
+        /// <returns></returns>
+        [HttpPost(Name = "CreateProduct")]
+        public Product Create([FromBody, Required] Product product)
+        {
+            return product;
+        }
+
+        /// <summary>
+        /// Searches the collection of products by description key words
+        /// </summary>
+        /// <param name="keywords" example="hello">A list of search terms</param>
+        /// <returns></returns>
+        [HttpGet(Name = "SearchProducts")]
+        public IEnumerable<Product> Get([FromQuery(Name = "kw")] string keywords = "foobar")
+        {
+            return new[]
+            {
+                new Product { Id = 1, Description = "A product" },
+                new Product { Id = 2, Description = "Another product" },
+            };
+        }
+
+        /// <summary>
+        /// Returns a specific product
+        /// </summary>
+        /// <param name="id" example="111">The product id</param>
+        /// <returns></returns>
+        [HttpGet("{id}", Name = "GetProduct")]
+        public Product Get(int id)
+        {
+            return new Product { Id = id, Description = "A product" };
+        }
+
+        /// <summary>
+        /// Updates all properties of a specific product
+        /// </summary>
+        /// <param name="id" example="222"></param>
+        /// <param name="product"></param>
+        [HttpPut("{id}", Name = "UpdateProduct")]
+        public void Update(int id, [FromBody, Required] Product product)
+        {
+        }
+
+        /// <summary>
+        /// Updates some properties of a specific product
+        /// </summary>
+        /// <param name="id" example="333"></param>
+        /// <param name="updates"></param>
+        [HttpPatch("{id}", Name = "PatchProduct")]
+        public void Patch(int id, [FromBody, Required] IDictionary<string, object> updates)
+        {
+        }
+
+        /// <summary>
+        /// Deletes a specific product
+        /// </summary>
+        /// <param name="id" example="444"></param>
+        [HttpDelete("{id}", Name = "DeleteProduct")]
+        public void Delete(int id)
+        {
+        }
+    }
+
+    public enum ProductStatus
+    {
+        All = 0,
+        OutOfStock = 1,
+        InStock = 2
+    }
+
+    /// <summary>
+    /// Represents a product
+    /// </summary>
+    public class Product
+    {
+        /// <summary>
+        /// Uniquely identifies the product
+        /// </summary>
+        public int Id { get; set; }
+
+        /// <summary>
+        /// Describes the product
+        /// </summary>
+        public string Description { get; set; }
+
+        public ProductStatus Status { get; set; }
+
+        public ProductStatus? Status2 { get; set; }
+    }
+}

test/Basic/Controllers/DataAnnotationsController.cs

@@ -0,0 +1,55 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Produces("application/json")]
+    public class DataAnnotationsController : Controller
+    {
+        [HttpPost("payments/authorize")]
+        [ProducesResponseType(200, Type = typeof(string))]
+        public IActionResult AuthorizePayment([FromBody, Required]PaymentRequest request)
+        {
+            if (!ModelState.IsValid)
+                return new BadRequestObjectResult(ModelState);
+
+            return new ObjectResult("123456");
+        }
+
+        [HttpPut("payments/{paymentId}/cancel")]
+        public IActionResult CancelPayment([MinLength(6)]string paymentId)
+        {
+            return Ok();
+        }
+    }
+
+    public class PaymentRequest
+    {
+        [Required]
+        public Transaction Transaction { get; set; }
+
+        [Required]
+        public CreditCard CreditCard { get; set; }
+    }
+
+    public class Transaction
+    {
+        [Required]
+        public decimal Amount { get; set; }
+
+        public string Note { get; set; }
+    }
+
+    public class CreditCard
+    {
+        [Required, RegularExpression("^[3-6]?\\d{12,15}$")]
+        public string CardNumber { get; set; }
+
+        [Required, Range(1, 12)]
+        public int ExpMonth { get; set; }
+
+        [Required, Range(14, 99)]
+        public int ExpYear { get; set; }
+    }
+}

test/Basic/Controllers/DefaultValuesAttribute.cs

@@ -0,0 +1,8 @@
+using System;
+
+namespace Basic.Controllers
+{
+    internal class DefaultValuesAttribute : Attribute
+    {
+    }
+}

test/Basic/Controllers/DynamicTypesController.cs

@@ -0,0 +1,28 @@
+using System.Collections.Generic;
+using System.Dynamic;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Produces("application/json")]
+    public class DynamicTypesController
+    {
+        [HttpPost("kittens")]
+        public int CreateKitten([FromBody]dynamic kitten)
+        {
+            return 1;
+        }
+
+        [HttpGet("unicorns")]
+        public ExpandoObject GetUnicorns()
+        {
+            return new ExpandoObject(); 
+        }
+
+        [HttpPost("dragons")]
+        public IActionResult CreateDragons([FromBody]object dragon)
+        {
+            return new ObjectResult(1);
+        }
+    }
+}

test/Basic/Controllers/FilesController.cs

@@ -0,0 +1,50 @@
+using System;
+using System.IO;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Route("files")]
+    public class FilesController : Controller
+    {
+        [HttpPost("single")]
+        public IActionResult PostFile(IFormFile file)
+        {
+            throw new NotImplementedException();
+        }
+
+        [HttpPost("multiple")]
+        public IActionResult PostFiles(IFormFileCollection files)
+        {
+            throw new NotImplementedException();
+        }
+
+        [HttpPost("form-with-file")]
+        public IActionResult PostFormWithFile([FromForm]FormWithFile formWithFile)
+        {
+            throw new NotImplementedException();
+        }
+
+        [HttpGet("{name}")]
+        [Produces("application/octet-stream", Type = typeof(FileResult))]
+        public FileResult GetFile(string name)
+        {
+            var stream = new MemoryStream();
+
+            var writer = new StreamWriter(stream);
+            writer.WriteLine("Hello world!");
+            writer.Flush();
+            stream.Position = 0;
+
+            return File(stream, "application/octet-stream", name);
+        }
+    }
+
+    public class FormWithFile
+    {
+        public string Name { get; set; }
+
+        public IFormFile File { get; set; }
+    }
+}

test/Basic/Controllers/FromFormParamsController.cs

@@ -0,0 +1,22 @@
+using Microsoft.AspNetCore.Mvc;
+using System.Collections.Generic;
+
+namespace Basic.Controllers
+{
+    public class FromFormParamsController
+    {
+        [HttpPost("registrations")]
+        [Consumes("application/x-www-form-urlencoded")]
+        public IActionResult PostForm([FromForm]RegistrationForm form)
+        {
+            throw new System.NotImplementedException();
+        }
+    }
+
+    public class RegistrationForm
+    {
+        public string Name { get; set; }
+
+        public IEnumerable<int> PhoneNumbers { get; set; }
+    }
+}

test/Basic/Controllers/FromQueryParamsController.cs

@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using Microsoft.AspNetCore.Mvc;
+using System.ComponentModel.DataAnnotations;
+using System.ComponentModel;
+
+namespace Basic.Controllers
+{
+    [Produces("application/json")]
+    public class FromQueryParamsController
+    {
+        [HttpGet("addresses/validate")]
+        public IActionResult ValidateAddress([FromQuery]Address address)
+        {
+            return new NoContentResult(); 
+        }
+
+        [HttpGet("zip-codes/validate")]
+        public IActionResult ValidateZipCodes([FromQuery]IEnumerable<string> zipCodes)
+        {
+            return new NoContentResult(); 
+        }
+    }
+
+    public class Address
+    {
+        /// <summary>
+        /// 3-letter ISO country code
+        /// </summary>
+        [Required]
+        public string Country { get; set; }
+
+        /// <summary>
+        /// Name of city
+        /// </summary>
+        [DefaultValue("Seattle")]
+        public string City { get; set; }
+    }
+}

test/Basic/Controllers/JsonAnnotationsController.cs

@@ -0,0 +1,38 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Produces("application/json")]
+    public class JsonAnnotationsController
+    {
+        [HttpGet("/promotions")]
+        public IEnumerable<Promotion> GetPromotions()
+        {
+            return new[]
+            {
+                new Promotion { Code = "A", DiscountType = DiscountType.Amount, Discount = 30 },
+                new Promotion { Code = "B", DiscountType = DiscountType.Percentage, Discount = 10 }
+            };
+        }
+    }
+
+    public class Promotion
+    {
+        [JsonPropertyName("promo-code")]
+        public string Code { get; set; }
+
+        public DiscountType DiscountType { get; set; }
+
+        [JsonIgnore]
+        public int Discount { get; set; }
+    }
+
+    [JsonConverter(typeof(JsonStringEnumConverter))]
+    public enum DiscountType
+    {
+        Percentage,
+        Amount
+    }
+}

test/Basic/Controllers/PolymorphicTypesController.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Route("/shapes")]
+    public class PolymorphicTypesController
+    {
+        [HttpPost]
+        public int CreateShape([FromBody]Shape shape)
+        {
+            throw new NotImplementedException();
+        }
+
+        [HttpGet]
+        public IEnumerable<Shape> GetShapes()
+        {
+            throw new NotImplementedException();
+        }
+    }
+
+    public abstract class Shape
+    {
+        public string Name { get; set; } 
+    }
+
+    public class Rectangle : Shape
+    {
+        public int Height { get; set; }
+
+        public int Width { get; set; }
+    }
+
+    public class Circle : Shape
+    {
+        public int Radius { get; set; }
+    }
+}

test/Basic/Controllers/ResponseTypeAnnotationsController.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Route("/orders")]
+    [Consumes("application/xml")]
+    [Produces("application/xml")]
+    public class ResponseTypeAnnotationsController
+    {
+        /// <summary>
+        /// Creates an order 
+        /// </summary>
+        /// <param name="order"></param>
+        /// <response code="201">Order created</response>
+        /// <response code="400">Order invalid</response>
+        [HttpPost]
+        [ProducesResponseType(typeof(int), 201)]
+        [ProducesResponseType(typeof(IDictionary<string, string>), 400)]
+        public IActionResult CreateOrder([FromBody, Required]Order order)
+        {
+            return new CreatedResult("/orders/1", 1);
+        }
+    }
+
+    public class Order
+    {
+        public int Id { get; set; }
+
+        public string Description { get; set; }
+
+        public decimal Total { get; set; }
+    }
+}

test/Basic/Controllers/SwaggerAnnotationsController.cs

@@ -0,0 +1,44 @@
+using Microsoft.AspNetCore.Mvc;
+using Swashbuckle.AspNetCore.Annotations;
+using Basic.Swagger;
+
+namespace Basic.Controllers
+{
+    [SwaggerTag("Manipulate Carts to your heart's content", "http://www.tempuri.org")]
+    public class SwaggerAnnotationsController
+    {
+        [HttpPost("/carts")]
+        [SwaggerOperation(OperationId = "CreateCart")]
+        [SwaggerResponse(201, "The cart was created", typeof(Cart))]
+        [SwaggerResponse(400, "The cart data is invalid")]
+        public Cart Create([FromBody, SwaggerRequestBody(Description = "The cart request body")]Cart cart)
+        {
+            return new Cart { Id = 1 };
+        }
+
+        [HttpGet("/carts/{id}")]
+        [SwaggerOperation(OperationId = "GetCart")]
+        [SwaggerOperationFilter(typeof(AddCartsByIdGetExternalDocs))]
+        public Cart Get([SwaggerParameter("The cart identifier")]int id)
+        {
+            return new Cart { Id = id };
+        }
+
+        [HttpDelete("/carts/{id}")]
+        [SwaggerOperation(
+            OperationId = "DeleteCart",
+            Summary = "Deletes a specific cart",
+            Description = "Requires admin privileges")]
+        public Cart Delete([FromRoute(Name = "id"), SwaggerParameter("The cart identifier")]int cartId)
+        {
+            return new Cart { Id = cartId };
+        }
+    }
+
+    [SwaggerSchema(Required = new[] { "Id" })]
+    public class Cart
+    {
+        [SwaggerSchema("The cart identifier", ReadOnly = true)]
+        public int Id { get; set; }
+    }
+}

test/Basic/Controllers/UnboundParamsController.cs

@@ -0,0 +1,50 @@
+using System.Collections.Generic;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Basic.Controllers
+{
+    [Route("/stores")]
+    [Produces("application/json")]
+    public class UnboundParamsController
+    {
+
+        [HttpPost]
+        public int Create(Store store)
+        {
+            return 1;
+        }
+
+        [HttpGet]
+        public IEnumerable<Store> Search(string[] locations = null)
+        {
+            return new[]
+            {
+                new Store { Id = 1, Location = "Boston" },
+                new Store { Id = 1, Location = "Seattle" }
+            };
+        }
+
+        [HttpGet("{id}")]
+        public Store GetById(int id)
+        {
+            return new Store { Id = 1, Location = "Boston" };
+        }
+
+        [HttpPut("{id}")]
+        public void Update(int id, Store store)
+        {
+        }
+
+        [HttpDelete("{id}")]
+        public void Delete(int id)
+        {
+        }
+    }
+
+    public class Store
+    {
+        public int Id { get; set; }
+
+        public string Location { get; set; }
+    }
+}