编码规范_java.htm

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

 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>public class CounterSet</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>extends Observable</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span>implements Cloneable</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:l41 level1 lfo13;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>Class
     Fields<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> * Packet counters</span></pre><pre
  style='line-height:150%'><span lang=EN-US> */</span></pre><pre
  style='line-height:150%'><span lang=EN-US>protected int[] packets;</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:l41 level1 lfo13;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>public
     </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"'>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"'>proceted</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"'>private</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"'>
     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"'><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:l16 level1 lfo14;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>/**</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * Get the counters</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * @return an array containing the statistical data.<span style="mso-spacerun: yes">&nbsp; </span>This array has been</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * freshly allocated and can be modified by the caller.</span></pre><pre
  style='line-height:150%'><span lang=EN-US> */</span></pre><pre
  style='line-height:150%'><span lang=EN-US>public int[] getPackets() { return copyArray(packets, offset); }</span></pre><pre
  style='line-height:150%'><span lang=EN-US>public int[] getBytes() { return copyArray(bytes, offset); }</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>public int[] getPackets() { return packets; }</span></pre><pre
  style='line-height:150%'><span lang=EN-US>public void setPackets(int[] packets) { this.packets = packets; }</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:l16 level1 lfo14;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>

<ul type=disc>
 <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
     line-height:150%;mso-list:l1 level1 lfo15;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"'><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"'>
     (&quot;public&quot;, &quot;private&quot; </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
     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"'>
     &quot;static&quot;, &quot;final&quot; </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"'>
     &quot;synchronized&quot; </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>public</span></pre><pre
  style='line-height:150%'><span lang=EN-US>CounterSet(int size){</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>this.size = size;</span></pre><pre
  style='line-height:150%'><span lang=EN-US>}</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:l19 level1 lfo16;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"'>
     clone </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>public</span></pre><pre
  style='line-height:150%'><span lang=EN-US>Object clone() {</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>try {</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>CounterSet obj = (CounterSet)super.clone();</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>obj.packets = (int[])packets.clone();</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>obj.size = size;</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>return obj;</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>}catch(CloneNotSupportedException e) {</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>throw new InternalError(&quot;Unexpected CloneNotSUpportedException: &quot; + e.getMessage());</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>}</span></pre><pre
  style='line-height:150%'><span lang=EN-US>}</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:l11 level1 lfo17;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>/**</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * Set the packet counters</span></pre><pre
  style='line-height:150%'><span lang=EN-US> * (such as when restoring from a database)</span></pre><pre
  style='line-height:150%'><span lang=EN-US> */</span></pre><pre
  style='line-height:150%'><span lang=EN-US>protected final</span></pre><pre
  style='line-height:150%'><span lang=EN-US>void setArray(int[] r1, int[] r2, int[] r3, int[] r4)</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>throws IllegalArgumentException</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; </span>//</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>// Ensure the arrays are of equal size</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>//</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>if (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length)</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp;&nbsp;&nbsp; </span>throw new IllegalArgumentException(&quot;Arrays must be of the same size&quot;);</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>System.arraycopy(r1, 0, r3, 0, r1.length);</span></pre><pre
  style='line-height:150%'><span lang=EN-US><span style="mso-spacerun: yes">&nbsp; </span>System.arraycopy(r2, 0, r4, 0, r1.length);</span></pre><pre
  style='line-height:150%'><span lang=EN-US>}</span></pre><pre
  style='line-height:150%'><![if !supportEmptyParas]>&nbsp;<![endif]><span
  lang=EN-US><o:p></o:p></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:l15 level1 lfo18;tab-stops:list 36.0pt'><span
     lang=EN-US style='font-size:10.0pt;font-family:"helvetica\,helv\,arial\,sans-serif"'>toString
     </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>
     </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"'>
     toString </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%'><