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.

  • 相关阅读:
    可持久化线段树学习笔记
    GDI+学习之路
    tcpdump——分析tcp关闭4次过程
    nasm过程调用
    ios学习:NSURLConnection 和 Json数据解析
    ios学习:文件简单读写
    JSONP原理及其简单封装
    JSP使用JSTL
    JDBC
    Apache无法正常启动的原因
  • 原文地址:https://www.cnblogs.com/haokaibo/p/adhere-to-generally-accepted-naming-conventions.html
Copyright © 2011-2022 走看看