Tag: API Design

All the articles with the tag "API Design".

• 

  C# 封装：用公开操作守住不变量

  Published: Oct 30, 2026 |  at  01:35 AM

  从一个最小值大于最大值的区间讲起，说清楚封装要守的是对象的不变量：构造与变更共用一条校验、用公开操作替代逐字段赋值，以及 readonly 和只读视图各自的边界。

  • C#
  • .NET
  • Encapsulation
  • OOP
  • API Design
• 

  C# 集合选型：访问语义与所有权边界

  Published: Oct 21, 2026 |  at  12:00 AM

  List 不是默认答案：先回答访问、相等性、顺序、可变性和所有权这五个问题，再选集合类型。本文附 .NET 10 的实跑输出，并给出一份可以照着走的接口检查清单。

  • C#
  • .NET
  • Collections
  • API Design
• 

  重新设计 System.Diagnostics.Process：用类型系统消除「只有启动者才能用」的陷阱

  Published: May 27, 2026 |  at  12:43 AM

  Raymond Chen 提出了一种 System.Diagnostics.Process 的假想重构方案：把 StandardOutput 等属性移到 Start() 的返回类型里，用编译器替代运行时异常来守护 API 正确使用顺序。.NET 11 也正在落实类似思路。

  • CSharp
  • dotnet
  • API Design
  • Process

• 90% 的 API 并非真正的 RESTful：你缺失了什么以及何时它真正重要

  Published: Nov 7, 2025 |  at  12:00 AM

  深入探讨 REST 架构约束、HATEOAS 原则及其在现代 API 设计中的实际应用。了解 Richardson 成熟度模型，掌握在 ASP.NET Core 中实现超媒体控制的最佳实践，以及何时应该（或不应该）采用 HATEOAS。

  • .NET
  • API Design
  • REST
  • HATEOAS
  • ASP.NET Core
  • Architecture