关于设计.NET API以供将来与F#一起使用的技巧

Question

我正在设计一个.NET API，允许开发人员为三维模拟足球联赛创建RoboCup代理。

我对API如何使用C#代码非常满意，但是我想使用这个项目来提高我的F#技能(它目前是基于阅读而不是实践)。

因此，我想问一下，在设计C#和F#代码都要使用的API时，应该考虑哪些方面的问题。

一些要点。

• 我充分利用了矩阵和向量数学。这些当前是不可变的类/结构。
• API目前定义了与使用者实现(例如：IAgent)的几个接口，使用它们的实现实例(例如：MyAgent)来构造其他API类(例如：new Client(myAgent))。
• API触发事件。
• API公开了一些委托类型。
• API包括几个枚举。

我想尽快发布一个API版本，如果我意识到它很难从F#中使用，我不想在以后对它进行重大更改。如有任何建议，敬请见谅。

Answer 1

最好的建议可能是尝试使用来自F#的API。:)

尽管如此，我认为你所拥有的一切听起来还不错

• 任何好的C# API都应该是相当好的F# API。
• 在边界上使用委托/Func/Action时有一点摩擦，但是这里没有什么可以更改的
• 枚举、事件、接口、类、结构都很好。
• 如果可能，请避免返回通常被忽略的值的API(例如，fluent接口“返回此”以便能够“链式调用”--这些会导致F#需要大量的|>ignore)。

但是，真的，花一个小时试着编写一个库的F#使用者。在最坏的情况下，您可能会为F#建议一些辅助函数或扩展方法，以平滑界面边界上的任何摩擦点，但我认为您所拥有的一切都应该是好的。