编码规范_java.htm

delphi&java&visul c++的各种语言的编程规范,语言通俗易懂,编程高手的心得!

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l42 level1 lfo6;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>Static
     Final </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>变量的命名</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
     Static Final </span><span style='font-size:10.0pt;font-family:宋体;
     mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:
     "helvetica\,helv\,arial\,sans-serif"'>变量的名字应该都大写，并且指出完整含义。</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l36 level1 lfo7;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>参数的命名</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>参数的名字必须和变量的命名规范一致。</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l10 level1 lfo8;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>数组的命名</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>数组应该总是用下面的方式来命名：</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>byte[] buffer;</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l10 level1 lfo8;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>而不是：</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>byte buffer[];</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l30 level1 lfo9;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>方法的参数</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>使用有意义的参数命名，如果可能的话，使用和要赋值的字段一样的名字：</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>SetCounter(int size){</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>this.size = size;</span></pre><pre
  style='line-height:150%'><span lang=EN-US>}</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:6.0pt;
margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:10.0pt;
font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
<br style='mso-special-character:line-break'>
<![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
<![endif]><o:p></o:p></span></p>

<p><strong><span lang=EN-US style='font-size:12.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>Java
</span></strong><strong><span style='font-size:12.0pt;mso-ascii-font-family:
"helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>文件样式</span></strong><span
lang=EN-US style='font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
</span><span style='mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>所有的</span><span
lang=EN-US style='font-family:"helvetica\,helv\,arial\,sans-serif"'>
Java(*.java) </span><span style='mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>文件都必须遵守如下的样式规则</span><span
lang=EN-US style='font-family:"helvetica\,helv\,arial\,sans-serif"'><o:p></o:p></span></p>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l37 level1 lfo10;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>版权信息</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><br>
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>版权信息必须在</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     java </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>文件的开头，比如：</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>/**</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * Copyright ?2000 Shanghai XXX Co. Ltd.</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * All right reserved.</span></pre><pre
  style='line-height:150%'><span lang=EN-US> */</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;margin-bottom:6.0pt;
     line-height:150%;mso-list:l37 level1 lfo10;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>其他不需要出现在</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     javadoc </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>的信息也可以包含在这里。</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><o:p></o:p></span></li>
</ul>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l21 level1 lfo11;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>Package/Imports<br>
     package </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>行要在</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     import </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>行之前，</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>import
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>中标准的包名要在本地的包名之前，而且按照字母顺序排列。如果</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     import </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>行中包含了同一个包中的不同子目录，则应该用</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     * </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>来处理。</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>package hotlava.net.stats;</span></pre><pre
  style='line-height:150%'><span lang=EN-US><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></pre><pre
  style='line-height:150%'><span lang=EN-US>import java.io.*;</span></pre><pre
  style='line-height:150%'><span lang=EN-US>import java.util.Observable;</span></pre><pre
  style='line-height:150%'><span lang=EN-US>import hotlava.util.Application;</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;margin-bottom:6.0pt;
     line-height:150%;mso-list:l21 level1 lfo11;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>这里</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     java.io.* </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>使用来代替</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>InputStream
     and OutputStream </span><span style='font-size:10.0pt;font-family:宋体;
     mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:
     "helvetica\,helv\,arial\,sans-serif"'>的。</span><span lang=EN-US
     style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><o:p></o:p></span></li>
</ul>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l5 level1 lfo12;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>Class<br>
     </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>接下来的是类的注释，一般是用来解释类的。</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"
 style='width:98.0%;mso-cellspacing:1.5pt;margin-left:36.0pt;background:#CCCCCC;
 mso-padding-alt:0cm 0cm 0cm 0cm'>
 <tr>
  <td style='padding:0cm 0cm 0cm 0cm'>
  <p class=MsoNormal style='margin-top:6.0pt;margin-right:0cm;margin-bottom:
  6.0pt;margin-left:0cm;line-height:150%'><span lang=EN-US style='font-size:
  10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  <pre style='line-height:150%'><span lang=EN-US>/**</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * A class representing a set of packet and byte counters</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * It is observable to allow it to be watched, but only</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * reports changes when the current set is complete</span></pre><pre
  style='line-height:150%'><span lang=EN-US> */</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span></pre></td>
 </tr>
</table>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l5 level1 lfo12;tab-stops:list 36.0pt'><span
     style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:"helvetica\,helv\,arial\,sans-serif";
     mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>接下来是类定义，包含了在不同的行的</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     extends </span><span style='font-size:10.0pt;font-family:宋体;mso-ascii-font-family:
     "helvetica\,helv\,arial\,sans-serif";mso-hansi-font-family:"helvetica\,helv\,arial\,sans-serif"'>和</span><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>
     implements <o:p></o:p></span></li>
</ul>

<table border=0 cellspacing=3 cellpadding=0 width="98%" bgcolor="#cccccc"