7. 避免状态,使用函数HTTP的好处是无状态。所有相关的状态在每次请求和响应中转移。这是REST命名的本质:表征状态转移。 在Java中这样做也很赞。当方法接收状态参数对象的时候从规则2的角度想想这件事。如果状态通过这种对 象转移,而不是从外边操作状态,那么事情将会更简单。以JDBC为例。下述例子从一个存储的程序中读取 一个光标。
这使得JDBC API如此的古怪。每个对象都是有状态的,难以操作。具体的说,有两个主要的问题:
戏剧海报《阿甘正传》,版权1994年由派拉蒙影业公司。保留所有权利。相信上述惯例满足所谓的合理使用。 规则:更多的以函数风格实现。通过方法参数转移状态。极少操作对象状态。 8. 短路式 equals()这是一个比较容易操作的方法。在比较复杂的对象系统中,你可以获得显著的性能提升,只要你在所有对象的 equals()方法中首先进行相等判断:
注意,其它短路式检查可能涉及到null值检查,所以也应当加进去:
规则: 在你所有的equals()方法中使用短路来提升性能。 9. 尽量使方法默认为final有些人可能不同意这一条,因为使方法默认为final与Java开发者的习惯相违背。但是如果你对代码有完全的 掌控,那么使方法默认为final是肯定没错的:
这特别适用于静态方法,在这种情况下“覆盖”(实际上是遮蔽)几乎不起作用。我最近在Apache Tika中遇 到了一个很糟糕的遮蔽静态方法的例子。考虑: TikaInputStream扩展了TaggedInputStream,以一种相对不同的实现遮蔽了它的静态get()方法。 与常规方法不同,静态方法不能互相覆盖,因为调用的地方在编译时就绑定了静态方法调用。如果你不走运, 你可能会意外获得错误的方法。 规则:如果你完全掌控你的API,那么使尽可能多的方法默认为final。 10. 避免方法(T…)签名在特殊场合下使用“accept-all”变量参数方法接收一个Object...参数就没有错的:
编写这样的方法为Java生态系统带来一点儿JavaScript的感觉。当然你可能想要根据真实的情形限制实际的 类型,比如String...。因为你不想要限制太多,你可能会认为用泛型T取代Object是一个好想法:
但是不是。T总是会被推断为Object。实际上你可能仅仅认为上述方法中不能使用泛型。更重要的是你可能 认为你可以重载上述方法,但是你不能:
这看起来好像你可以可选地传递一个String消息到方法。但是这个调用会发生什么呢?
编译器将T推断为>,这将会使调用不明确!所以无论何时你有一个“accept-all”签名(即使是泛型),你将永 远不能类型安全地重载它。API使用者可能仅仅在走运的时候才会让编译器“偶然地”选择“正确的”限定最多的方 法。但是也可能使用accept-all方法或者无法调用任何方法。 规则: 如果可能,避免“accept-all”签名。如果不能,不要重载这样的方法。 结论Java是一个野兽。不像其它更理想主义的语言,它慢慢地演进为今天的样子。这可能是一件好事,因为以Java 的开发速度就已经有成百上千个警告,而且这些警告只能通过多年的经验去把握。 敬请期待更多关于这个主题的前十名列表! 英文原文:10 Subtle Best Practices when Coding Java参与翻译(5人): |