อะไรทำให้“ สไตล์ดี” ใน Java? [ปิด]

ฉันได้ถามคำถามนี้เกี่ยวกับ Stackoverflow และก่อนที่จะถูกโห่ไล่ฉันได้รับคำแนะนำที่เป็นประโยชน์จากPéterTörökว่านี่อาจเป็นสถานที่ที่ดีกว่าในการโพสต์

ฉันเขียนโปรแกรมใน Java มาสองสามปีแล้ว ฉันมักจะพูดคุยเกี่ยวกับการตัดสินใจออกแบบกับเพื่อนร่วมงานบนพื้นฐานของสิ่งที่ถือว่าเป็น 'รูปแบบที่ดี' แท้จริงแล้วมีจำนวนคำถาม / คำตอบ StackOverflow ที่กล่าวถึงการออกแบบบนพื้นฐานของสิ่งที่เป็นสไตล์ที่ดี

แต่อะไรที่ทำให้ 'สไตล์ดี'? เช่นเดียวกับหลาย ๆ สิ่งฉันรู้ว่าเมื่อฉันเห็นมัน ... แต่ฉันต้องการความคิดที่ดีกว่าแค่ความรู้สึกผิดชอบชั่วดีของฉันโดยบอกว่าการออกแบบนี้ไม่ถูกต้อง

คุณคิดอย่างไรเกี่ยวกับการสร้างโค้ดที่ดีและออกแบบมาอย่างดี?

(ฉันยอมรับว่านี่เป็นเรื่องส่วนตัวเนื่องจาก 'สไตล์ดี' จะขึ้นอยู่กับงานในมือ) (นอกจากนี้ฉันควรเพิ่มว่าฉันไม่สนใจสไตล์ทีม - เช่น "เราใช้การเยื้องของ 2 ช่องว่างแทนที่จะเป็น 4" ... และฉันไม่สนใจระเบียบของโค้ด Java)

แก้ไข: ขอบคุณสำหรับคำตอบ / ความคิดเห็นที่ดีทั้งหมด ฉันกระตือรือร้นเป็นอย่างยิ่งสำหรับคำตอบที่จะช่วยจัดระเบียบสิ่งต่าง ๆ ที่ทำให้ประแจความรู้สึกผิดชอบของโปรแกรมเมอร์ (และอาจเป็นไปได้)

ประเด็นสั้น ๆ บางประการ:

• ชื่อที่ตั้งใจเปิดเผย
• ไม่มีความคิดเห็นที่ไม่ให้คำแนะนำ
• ไม่มีวิธีการใดที่มีความซับซ้อนสูงจนคุณไม่สามารถบรรจุได้ทั้งหมดในหัวของคุณในครั้งเดียว
• วัตถุความรับผิดชอบเดี่ยว
• ทำตามข้อกำหนดของรหัส (คุณบอกว่าคุณไม่ได้สนใจ แต่สำคัญมาก)

เพิ่มในรายการของ Ryan:

• ปฏิบัติตามหลักการที่เป็นของแข็ง
• ตรวจสอบให้แน่ใจว่ารหัสของคุณไม่มีความซับซ้อนตามรอบมากเกินไป
• Test Driven Java เป็นสิ่งที่ดีเสมอ
• หากคุณมีxFactoryFactoryชั้นเรียนคุณทำผิด :-)
• เนื่องจากไลบรารี่โอเพ่นซอร์สในระบบนิเวศของจาวาทำให้การคิดค้นวงล้อใหม่นั้นเป็นรูปแบบที่ไม่ดี
• ใช้เวลา Jodaสำหรับวันที่และเวลา

ฉันจะหยุดตรงนั้น

ในขณะที่เห็นคุณค่าคำตอบของคนอื่นฉันคิดว่ามันยุติธรรมที่จะแบ่งปันบางสิ่งที่ฉันคิดเมื่อพยายามเขียนโค้ดที่ดี:

• สิ่งที่จำเป็นต้องรู้เกี่ยวกับคลาส / เมธอด / ตัวแปรนี้ ความรู้นี้ควรอยู่ที่ไหน

• รหัสนี้มีผลกับหน่วยความจำ / ประสิทธิภาพของแอปพลิเคชันของฉันอย่างไร (ฉันยอมรับว่า 'การเพิ่มประสิทธิภาพก่อนวัยอันควรเป็นรากฐานของความชั่วร้ายทั้งหมด' ดังนั้นฉันจึงไม่แนะนำให้ใช้เวลามากที่สุดในการปรับให้เหมาะสม

• ชัดเจนหรือไม่ (จากรหัสและโครงสร้างโค้ด) สิ่งนี้ทำอะไร (ฉันพยายามที่จะทำตามจุดสูงสุด: "พยายามอย่าทำให้ผู้คนเข้าใจได้พยายามที่จะทำให้คนเข้าใจผิดไม่ได้")

อ่านคลาส String และ ArrayList เพื่อดูตัวอย่างการเขียนโปรแกรม Java ที่เหมาะสม แต่มีความรัดกุมสูงเกือบจะเป็นสไตล์ C ซึ่งไม่จำเป็นต้องดีที่สุดสำหรับการบำรุงรักษาโค้ดที่มี w / เอกสาร Java น้อยที่สุด การปฏิบัติทั่วไปที่ร้านค้าของฉันไม่มีความคิดเห็นดังนั้นฉันจึงพยายามแสดงความคิดเห็นด้วยรหัสโดยใช้ชื่อ verbose camelCase var และการใช้บรรทัดใหม่มากเกินไปในการกำหนดขอบเขตความคิดหนึ่งบรรทัดจากอีกบรรทัดหนึ่ง ฉันยังคงอภิปรายโดยใช้แท็บเพื่อแยก vars จากค่าของพวกเขา แท็บสามารถเพิ่มความสามารถในการอ่าน, IMO, แต่เมื่อทำน้อยที่สุดและเป็นอัตนัย ฉันพบว่ามันเป็นเรื่องของผู้ชม ไม่มีคำตอบที่ดีที่สุดที่นี่