zoukankan      html  css  js  c++  java
  • Effective Java 56 Adhere to generally accepted naming conventions

    Typographical naming conventions

       

    Identifier Type

    Type Examples

    Package

    com.google.inject, org.joda.time.format

    Class or Interface

    Timer, FutureTask, LinkedHashMap, HttpServlet

    Method or Field

    remove, ensureCapacity, getCrc

    Constant Field

    MIN_VALUE, NEGATIVE_INFINITY

    Local Variable

    i, xref, houseNumber

    Type Parameter

    T, E, K, V, X, T1, T2

       

    Grammatical conventions

    Identifier Type

    Type Examples

    Package

    no rules

    Class or Interface

    Timer, BufferedWriter, or ChessPiece.

    Collection or Comparator. Runnable, Iterable, or Accessible.

    BindingAnnotation, Inject, ImplementedBy, or Singleton

    Method

    append or drawImage

    isDigit, isProbablePrime, isEmpty, isEnabled,

    or hasSiblings.

    size, hashCode, or getTime

    toType(toString, toArray) asType(asList) typeValue(intValue), static factories(valueOf, of, getInstance, newInstance, getType, newType)

    Field

    initialized, composite, height, digits, or bodyStyle

    Constant Field

    MIN_VALUE, NEGATIVE_INFINITY

    Local Variable

    i, xref, houseNumber

    Type Parameter

    T, E, K, V, X, T1, T2

       

    Summary

    Internalize the standard naming conventions and learn to use them as second nature. The typographical conventions are straightforward and largely unambiguous; the grammatical conventions are more complex and looser. To quote from The Java Language Specification [JLS, 6.8], "These conventions should not be followed slavishly if long-held conventional usage dictates otherwise." Use common sense.

  • 相关阅读:
    帧同步资料收集
    随机数种子问题
    【转】 DOTA2中的伪随机及其lua实现
    C++ 异常机制分析
    细说new与malloc的10点区别
    static关键字总结
    C++11 并发编程基础(一):并发、并行与C++多线程
    论一个程序员的自我修养
    gSoap的多线程程序
    面试常见问题:
  • 原文地址:https://www.cnblogs.com/haokaibo/p/adhere-to-generally-accepted-naming-conventions.html
Copyright © 2011-2022 走看看