如果您有一个输入参数可能是输出的方法。
假设我们有一个保存方法,它生成一个自动生成的 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)?
谢谢
最佳答案
两者都可以;让 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 模式。
我会推荐使用流利的,如果没有别的来练习使用它的话
关于java - 我应该如何为以下场景设计方法签名,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/6499211/