ชื่อวิธีการรับข้อมูล [ปิด]

คำเตือน:นี่เป็นคำถาม / การสนทนาที่ไม่ร้ายแรงมากนักที่ฉันโพสต์ ... แต่ฉันยินดีที่จะพนันว่านักพัฒนาส่วนใหญ่ได้ไตร่ตรอง "ปัญหา" นี้แล้ว ...

อยากได้ความคิดเห็นอื่น ๆ เกี่ยวกับหลักการตั้งชื่อสำหรับวิธีการที่ไปและได้ข้อมูลจากที่ไหนสักแห่งและส่งคืนมา ...

ชื่อเมธอดส่วนใหญ่ค่อนข้างง่ายและชัดเจน ... SaveEmployee (), DeleteOrder (), UploadDocument () แน่นอนว่าในชั้นเรียนคุณมักจะใช้รูปแบบสั้น ๆ ... บันทึก () ลบ () อัปโหลด () ตามลำดับ

อย่างไรก็ตามฉันต่อสู้กับการดำเนินการครั้งแรกมาโดยตลอด ... วิธีรับข้อมูล ดูเหมือนว่าสำหรับทุกโครงการฉันจะต้องกระโดดไปมาระหว่างรูปแบบการตั้งชื่อที่แตกต่างกันเพราะฉันไม่เคยพอใจกับข้อสุดท้ายที่ฉันใช้ เท่าที่ฉันสามารถบอกได้ว่านี่คือความเป็นไปได้ ->

• GetBooks ()
• FetchBooks ()
• ดึงหนังสือ ()
• ค้นหาหนังสือ ()
• โหลดหนังสือ ()

คุณคิดอะไรอยู่?

มันคือทั้งหมดที่เกี่ยวกับความสอดคล้องกับความหมาย ;

ในชื่อคำถามของคุณคุณใช้รับข้อมูล นี่เป็นเรื่องทั่วไปอย่างยิ่งในแง่ที่คุณต้องกำหนดว่าการรับหมายถึงวิธีที่ชัดเจนอย่างมีนัยสำคัญทางความหมาย ฉันขอนำเสนอตัวอย่างต่อไปนี้เพื่อหวังว่าคุณจะมาถูกทางเมื่อคิดจะตั้งชื่อสิ่งต่างๆ

1. getBooks() คือเมื่อคุณได้รับหนังสือทั้งหมดที่เกี่ยวข้องกับออบเจ็กต์นั่นหมายความว่าเกณฑ์สำหรับชุดนั้นได้กำหนดไว้แล้วและที่มาที่ไปคือรายละเอียดที่ซ่อนอยู่
2. findBooks(criteria) คือเมื่อพยายามค้นหาชุดย่อยของหนังสือตามพารามิเตอร์ในการเรียกใช้เมธอดซึ่งมักจะมีเกณฑ์การค้นหาที่แตกต่างกันมากเกินไป
3. loadBooks(source) คือเมื่อคุณกำลังโหลดจากแหล่งภายนอกเช่นไฟล์หรือฐานข้อมูล
4. ฉันจะไม่ใช้การดึง / ดึงข้อมูลเพราะมันคลุมเครือเกินไปและสับสนกับgetและไม่มีความหมายที่ชัดเจนที่เกี่ยวข้องกับข้อกำหนด

ตัวอย่าง: การ ดึงข้อมูลหมายความว่าเอนทิตีบางส่วนต้องไปรับบางสิ่งที่อยู่ห่างไกลและนำกลับมา สุนัขเรียกไม้เท้าและการดึงข้อมูลเป็นคำพ้องความหมายสำหรับการดึงข้อมูลด้วยความหมายเพิ่มเติมที่คุณอาจเคยครอบครองสิ่งนั้นมาก่อนเช่นกัน getเป็นคำพ้องความหมายสำหรับการได้รับเช่นกันซึ่งหมายความว่าคุณมีบางสิ่งในครอบครอง แต่เพียงผู้เดียวและไม่มีใครสามารถได้รับพร้อมกัน

ความหมายมีความสำคัญอย่างยิ่ง:

สาขาภาษาศาสตร์และตรรกะที่เกี่ยวข้องกับความหมาย

ความคิดเห็นเป็นข้อพิสูจน์ว่าคำศัพท์ทั่วไปเช่นget and fetchไม่มีความหมายที่เฉพาะเจาะจงและถูกตีความแตกต่างกันไปตามแต่ละคน เลือกความหมายสำหรับคำศัพท์บันทึกสิ่งที่ตั้งใจจะบอกเป็นนัยว่าถ้าความหมายไม่ชัดเจนและสอดคล้องกับการใช้งาน

คำที่มีความหมายคลุมเครือหรือคลุมเครือจะได้รับความหมายที่แตกต่างกันโดยบุคคลที่แตกต่างกันเนื่องจากอคติและอคติตามความคิดเห็นส่วนตัวของพวกเขาและจะไม่จบลงด้วยดี

ตามจริงแล้วคุณควรตัดสินใจร่วมกับทีมของคุณว่าจะใช้หลักการตั้งชื่อแบบใด แต่เพื่อความสนุกสนานลองดูว่ารถไฟแห่งความคิดของคุณจะตัดสินใจเลือกสิ่งใดสิ่งเหล่านี้:

• GetBooks ()

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

• FetchBooks ()

คุณปฏิบัติต่อแหล่งข้อมูลของคุณเหมือนการล่าสัตว์และเป็นหน้าที่ของเขาในการดึงหนังสือของคุณ ฉันเดาว่าคุณควรตัดสินใจด้วยตัวเองว่าเขาสามารถใส่เข้าปากได้กี่ครั้ง

• ค้นหาหนังสือ ()

แหล่งข้อมูลของคุณคือบรรณารักษ์และจะใช้ระบบทศนิยมดิวอี้เพื่อค้นหาหนังสือของคุณ

• โหลดหนังสือ ()

หนังสือเหล่านี้อยู่ใน "กระเป๋าหนังสืออิเล็กทรอนิกส์" บางประเภทและต้องโหลดไว้ในนั้น อย่าลืมเรียก ZipClosed () หลังจากโหลดเพื่อป้องกันการสูญหาย

• ดึงหนังสือ ()

ฉันไม่มีอะไร.

คำตอบคือยึดติดกับสิ่งที่คุณพอใจและมีความสม่ำเสมอ

หากคุณมีเว็บไซต์โรงนาและขุนนางและคุณใช้ GetBooks () หากคุณมีรายการอื่นเช่นเอนทิตีภาพยนตร์ให้ใช้ GetMovies () ดังนั้นไม่ว่าคุณและทีมของคุณจะชอบอะไรและเสมอภาคกัน

ใน OO (C ++ / Java) ฉันมักจะใช้ getSomething และ setSomething เพราะบ่อยครั้งที่ฉันไม่ได้รับแอตทริบิวต์ส่วนตัวจากคลาสที่เป็นตัวแทนของออบเจ็กต์ข้อมูลนั้นหรือตั้งค่า - คู่ getter / setter ข้อดี Eclipse จะสร้างให้คุณ

ฉันมักจะใช้ Load ก็ต่อเมื่อฉันหมายถึงไฟล์ - เช่นเดียวกับ "โหลดลงในหน่วยความจำ" และโดยปกติจะหมายถึงการโหลดลงใน primitives, structs (C) หรืออ็อบเจกต์ ฉันใช้ส่ง / รับสำหรับเว็บ

ดังที่ได้กล่าวไว้ข้างต้นความสม่ำเสมอคือทุกสิ่งและรวมถึงผู้พัฒนาข้ามกลุ่มด้วย

ไม่ชัดเจนว่าคุณหมายถึงอะไรสำหรับ "การรับข้อมูล" จากฐานข้อมูล? ไฟล์? ความจำ?

มุมมองของฉันเกี่ยวกับการตั้งชื่อวิธีการคือบทบาทของมันคือการกำจัดความคลุมเครือและความจำเป็นในการค้นหาเอกสาร ฉันเชื่อว่าสิ่งนี้ควรทำได้แม้จะเสียชื่อเมธอดที่ยาวกว่าก็ตาม จากการศึกษาพบว่าผู้พัฒนาระดับกลาง + ส่วนใหญ่สามารถอ่านหลายคำในกรณีอูฐได้ ด้วย IDE และการกรอกอัตโนมัติการเขียนชื่อเมธอดแบบยาวก็ไม่ใช่ปัญหาเช่นกัน

ดังนั้นเมื่อฉันเห็น "fetchBooks" เว้นแต่บริบทจะชัดเจนมาก (เช่นคลาสที่ชื่อ BookFetcherFromDatabase) แสดงว่ามีความคลุมเครือ เอามาจากไหน? ความแตกต่างระหว่างการดึงและค้นหาคืออะไร? นอกจากนี้คุณยังเสี่ยงต่อปัญหาที่นักพัฒนาบางรายจะเชื่อมโยงความหมายกับคำหลักบางคำ ตัวอย่างเช่นดึงฐานข้อมูล (หรือหน่วยความจำ) เทียบกับโหลด (จากไฟล์) หรือดาวน์โหลด (จากเว็บ)

ฉันค่อนข้างจะเห็นบางอย่างเช่น "fetchBooksFromDatabase", "loadBookFromFile", "findBooksInCollection" เป็นต้นซึ่งเห็นได้น้อยกว่า แต่เมื่อคุณใช้งานเกินความยาวแล้วจะชัดเจน ทุกคนที่อ่านข้อความนี้จะเข้าใจทันทีว่าคุณกำลังพยายามทำอะไร