Page 175 - การเขียนโปรแกรมบนมาตรฐานเปิด

175

2.1.3.การประกาศ class และ Interface

ล าดับในการประกาศ class มีดังนี้

ล าดับท ี่ การประกาศ class/interface หมายหต ุ
1 คอมเมนต์เริ่มต้น,Class/interface ดูรายละเอียดเพิ่มเติมใน "Documentation

documentation comment (/**...*/) Comments"

2 class/interface statements

3 คอมเมนต์เสริม,Class/interface ควรประกอบด้วยข้อมูลเกี่ยวกับ

implementation comment class/intetface ที่ไม่เหมาะที่จะใส่ไว้ใน
(/*...*/)(ถ้ามี) documentation comments

4 Class (static) variables กระกาศตัวแปรของ public class เป็นอันดับ

แรก ตามด้วย protected class, package

level และ private class ตามลาดับ
5 Instance variables ประกาศตัวแปรของ Public เป็นอันดับแรกตาม

ด้วย protected, package label และ private
ตามล าดับ

6 Constructors

7 Methods ควรจัดกลุ่มของตามการใช้งานมากกว่าการจัด
กลุ่มตามหมวดหมู่หรือการเข้าถึงเช่นสามารถจด
ั
private class methods ไว้รวมกับ public

instance methods ได้เพื่อให้สามารถทาความ
เข้าใจ code ได้ง่าย

3.การย่อหน้า (Indentation)

ควรใช้การเคาะ spacebar 4 ครั้งในการย่อหน้า ไม่ควรใช้ Tabs ในการย่อหน้า และควรตั้งค่า Tabs ให้

เท่ากับการเคาะ space bar 8 ครั้ง

3.1.ความยาวของบรรทัด

ควรหลีกเลี่ยงการเขียนโปรแกรมโดยมีความยาวในแต่ละบรรทัดเกินกว่า 80 ตัวอักษร เนื่องจากอาจไม่ได ้

รับการรองรับในเครื่องมือบางชนิด