java - 我应该如何为以下场景设计方法签名

Question

如果您有一个输入参数可能是输出的方法。

假设我们有一个保存方法，它生成一个自动生成的 ID，客户端可能有兴趣在调用 save() 后使用该 ID。

人

• id(自动生成)
• 姓名
• ...(其他领域)

你是否应该像这样设计方法签名:

1.

public void save(Person person);

客户端调用:

personService.save(person);
System.out.println(person.getId());

2.

public Person save(Person person);

客户端调用:

person = personService.save(person);
System.out.println(person.getId());

我们知道，在接收对象的方法调用中，会传递对该对象的引用，因此只要其他人具有相同的引用，对该对象所做的任何更改都会被其他人感知。但是在远程调用的情况下会发生序列化/反序列化，因此我的对象引用与远程服务对象的引用不同。因此，即使在那里进行了更改，客户也不会注意到差异。

此时我知道该方法不会是远程调用，所以我可以使用第一个签名来设计它。但是，如果将来这种情况发生变化并且需要作为远程调用来调用怎么办。

所以我的问题是:我在设计我的 API 时是否应该考虑将来可能会调用该 API 作为远程调用并且不使用对象参数作为向客户端返回值的方式 (2) 还是应该根据我的实际情况来设计我的 API服务不远程的情况(1)?

谢谢

Answer 1

两者都可以；让 save() 返回新 ID 并且有 getId() 方法。从“setter”(一种改变状态的方法)返回一个值有很多先例 - java Collections API 一直这样做，例如 Map.remove(Object) 返回一个 boolean 。

流畅的界面

您可能需要考虑另一种模式，Fluent Interface图案。使用流畅的 API，您可以从每个方法返回对象(即 this)，否则将返回 void。这让调用者“链接”方法调用。使用流畅的界面，您的代码将如下所示:

public Person save() {
    // do your save stuff
    return this;
}

如果您想要保存后的 ID，您可以这样编码:

save().getId();

简单!这种模式也已在许多现有的 Java 代码中使用，特别是在 this java fluent code example 中的 hibernate 模式。

我会推荐使用流利的，如果没有别的来练习使用它的话