美文网首页
Effective Java-方法

Effective Java-方法

作者: 松哥888 | 来源:发表于2019-01-29 18:02 被阅读21次

检查参数的有效性

  • 对于公有的方法,要用javadoc的@throws标签抛出异常

  • 非公有的方法,通常使用断言assert来检查它们的参数

必要时进行保护性拷贝

  • 保护性拷贝是在检查参数的有效性之前进行的,并且有效性检查是针对拷贝之后的对象,而不是针对原始的对象。

  • 对于参数类型可以被不可信任方子类化的参数,请不要使用clone方法进行保护性拷贝。

  • 访问方法应该返回可变内部域的保护性拷贝

  • 只要有可能,都应该使用不可变的对象作为对象内部的组件,这样就不必再为保护性拷贝操心

  • 通常使用Date.getTime()返回的long基本类型作为内部的时间表示法,而不是使用Date对象引用,是因为Date是可变的。

谨慎设计方法签名

  • 谨慎地选择方法的名称。选择与大众认可的名称相一致的名称。

  • 不要过于追求提供便利的方法。如果不能确定,还是不提供快捷为好。

  • 避免过长的参数列表。目标是4个参数,或者更少。

  • 对于参数类型,要优先使用接口而不是类

  • 对于boolean参数,要优先使用两个元素的枚举类型。

慎用重载

  • 永远不要导出两个具有相同参数数目的重载方法。

  • 如果方法使用可变参数,保守的策略是根本不要重载它。

慎用可变参数

返回零长度的数组或者集合,而不是null

为所有导出的API元素编写文档注释

相关文章

  • Effective Java-方法

    本章讨论方法设计的几个方面:如何处理参数和返回值?如何设计方法签名?如何为方法编写文档?焦点集中在可用性、健壮性和...

  • Effective Java-方法

    检查参数的有效性 对于公有的方法,要用javadoc的@throws标签抛出异常 非公有的方法,通常使用断言ass...

  • Effective Java-并发

    本部分旨在介绍多线程编程的一些注意事项,指导如何编写出清晰、正确、文档组织良好的并发程序。本章内容导图如下: 1....

  • Effective Java-异常

    异常机制可以使程序中异常处理代码和正常业务代码分离,提高程序的可读性、可靠性和可维护性。 1.只针对异常的情况才使...

  • Effective Java-异常

    只针对异常的情况才使用异常 异常应该只用于异常的情况下,它们永远不应该用于正常的控制流 基于异常的模式比标准模式要...

  • Effective Java-并发

    同步访问共享的可变数据 避免过度同步 executor和task优先于线程 并发工具优先于wait和notify ...

  • Effective Java-泛型

    Java1.5版本中增加了泛型。在没有泛型之前,从集合中读取到的每一个对象都必须进行转换。如果不小心插入了错误类型...

  • Effective Java-泛型

    请不要在新代码中使用原生态类型 如果使用像List这样的原生态类型,就会失掉类型安全性,但是如果使用像List 这...

  • Hello Java

    目录 Java-基础(1/6) Java-对象(2/6) Java-核心库类 上(3/6) Java-核心库类下(...

  • Effective Java-对于所有对象都通用的方法

    Object是一个具体类,设计它主要是为了扩展,它所有的非final方法(equals、hashCode、toSt...

网友评论

      本文标题:Effective Java-方法

      本文链接:https://www.haomeiwen.com/subject/ucgtsqtx.html