api-design - API 设计 : pass id or complete object

Question

假设，有一个人和一个地址对象。此人不持有对地址的引用，而只持有其 ID。例如:

Person {
  id: PersonId,
  addressId: AddressId,
  name: String,
  ...
}

Address {
  id: AddressId,
  street: String,
  ....
} 

该模型是遗留的，无法更改。

现在你想给这个人设置一个地址，你会如何设计这个调用的API。您只能选择两种可能性:

void setAddress(PersonId id, Address address)

void setAddress(Person person, Address address)

如您所见，唯一的区别是，一次只发送人的 ID，而一次发送完整的人对象。

你会选择哪一个，为什么？

PS:这个问题来自工作中的内部讨论，我只是想知道其他程序员/设计师是如何看待这个问题的。

Answer 1

我会选择第一个，因此此 API 的调用者只需提供最少的信息，API 实现将获取继续调用所需的所有信息(在您的示例中，从数据库或其他地方获取人员)。第二个对我来说似乎不合逻辑，因为如果你传递整个人对象，你还必须从你的数据源中获取这个人(对象可能在调用期间被修改)，所以你传递的信息比在这种情况下需要。