We want the code to read like a top

We want the code to read like a top-down narrative.5 We want every function to be followed
by those at the next level of abstraction so that we can read the program, descending
one level of abstraction at a time as we read down the list of functions. I call this The Stepdown
Rule.
To say this differently, we want to be able to read the program as though it were a set
of TO paragraphs, each of which is describing the current level of abstraction and referencing
subsequent TO paragraphs at the next level down.
To include the setups and teardowns, we include setups, then we include the test page content,
and then we include the teardowns.
To include the setups, we include the suite setup if this is a suite, then we include the
regular setup.
To include the suite setup, we search the parent hierarchy for the “SuiteSetUp” page
and add an include statement with the path of that page.
To search the parent. . .
It turns out to be very difficult for programmers to learn to follow this rule and write
functions that stay at a single level of abstraction. But learning this trick is also very
important. It is the key to keeping functions short and making sure they do “one thing.”
Making the code read like a top-down set of TO paragraphs is an effective technique for
keeping the abstraction level consistent.
Take a look at Listing 3-7 at the end of this chapter. It shows the whole
testableHtml function refactored according to the principles described here. Notice
how each function introduces the next, and each function remains at a consistent level
of abstraction.

ผลลัพธ์ (ไทย) 1:

เราต้องการให้รหัสการอ่านเช่น narrative.5 ลงด้านบนที่เราต้องการให้ทุกฟังก์ชั่นจะต้องปฏิบัติตามโดยผู้ที่อยู่ในระดับถัดไปของนามธรรมเพื่อให้เราสามารถอ่านโปรแกรม เรียงหนึ่งระดับของ abstraction ในเวลาเราอ่านลงรายการของฟังก์ชัน ผมเรียก Stepdown นี้กฎพูดแบบนี้แตกต่างกัน เราต้องการสามารถอ่านโปรแกรมเสมือนว่านี่คือชุดของการย่อหน้า ซึ่งแต่ละระดับปัจจุบันของนามธรรมที่อธิบาย และอ้างอิงต่อมาการย่อหน้าในระดับถัดลงการรวมการตั้งค่าและ teardowns เรารวมถึงการตั้งค่า แล้วเรารวมเนื้อหาหน้าทดสอบและเรารวม teardowns การการรวมการตั้งค่า เรารวมการตั้งค่าห้องถ้าเป็นห้องสวีท แล้วเรารวมตัวการตั้งค่าปกติการรวมการตั้งค่า suite เราค้นหาลำดับชั้นหลักของหน้า "SuiteSetUp"และเพิ่มคำสั่งรวมกับเส้นทางของเพจนั้นการค้นหาข้อมูลหลักมันเปิดออกจะยากมากสำหรับโปรแกรมเมอร์เพื่อเรียนรู้การทำตามกฎนี้ และเขียนฟังก์ชันที่พักเดียวระดับนามธรรม แต่การเรียนรู้เคล็ดลับนี้ก็มากสิ่งสำคัญการ มันเป็นคีย์ที่เก็บฟังก์ชันที่สั้น และแน่ใจว่าพวกเขาทำ "สิ่งหนึ่ง"ทำให้รหัสอ่านเหมือนกับบนลงกับย่อหน้าเป็นเทคนิคมีประสิทธิภาพสำหรับรักษาระดับนามธรรมสอดคล้องกันลองดูที่รายการ 3-7 ในตอนท้ายของบทนี้ แสดงทั้งหมดtestableHtml ฟังก์ชัน refactored ตามหลักการที่อธิบายไว้ที่นี่ แจ้งให้ทราบวิธีแต่ละฟังก์ชันแนะนำถัดไป และแต่ละฟังก์ชันยังคงอยู่ในระดับสม่ำเสมอของนามธรรม

ผลลัพธ์ (ไทย) 2:

เราต้องการรหัสเพื่ออ่านเช่นจากบนลงล่าง narrative.5 เราต้องการฟังก์ชั่นทุกคนที่จะต้องปฏิบัติตาม
โดยผู้ที่อยู่ในระดับต่อไปของนามธรรมเพื่อให้เราสามารถอ่านโปรแกรมลง
หนึ่งระดับของนามธรรมที่เวลาที่เราอ่านลง รายชื่อของฟังก์ชั่น ที่ผมเรียกนี้ Stepdown
กฎ.
จะพูดแบบนี้แตกต่างกันเราต้องการที่จะสามารถที่จะอ่านโปรแกรมราวกับว่ามันเป็นชุด
ของวรรคแต่ละที่จะอธิบายในระดับปัจจุบันของนามธรรมและการอ้างอิง
ภายหลังย่อหน้าในระดับต่อไป ลง.
รวมถึงการตั้งค่าและการ teardowns เรารวมถึงการตั้งค่าแล้วเรามีเนื้อหาหน้าทดสอบ
แล้วเรารวม teardowns ได้.
หากต้องการให้มีการตั้งค่าที่เราติดตั้งรวมถึงชุดว่านี้เป็นชุดแล้วเรารวมถึง
การติดตั้งปกติ .
ในการติดตั้งรวมถึงห้องสวีทที่เราค้นหาลำดับชั้นของผู้ปกครองสำหรับ "SuiteSetUp" หน้า
และเพิ่มคำสั่งการรวมกับเส้นทางของหน้านั้น.
ในการค้นหาผู้ปกครอง . .
มันจะออกมาเป็นเรื่องยากมากสำหรับโปรแกรมเมอร์ที่จะเรียนรู้ที่จะปฏิบัติตามกฎนี้และเขียน
ฟังก์ชั่นที่อยู่ในระดับเดียวของสิ่งที่เป็นนามธรรม แต่การเรียนรู้เคล็ดลับนี้ยังเป็น
สิ่งสำคัญ มันเป็นกุญแจสำคัญในการรักษาฟังก์ชั่นในระยะสั้นและทำให้แน่ใจว่าพวกเขาทำ "สิ่งหนึ่ง."
ทำรหัสชอบอ่านจากบนลงล่างชุดของวรรคเป็นเทคนิคที่มีประสิทธิภาพสำหรับ
การรักษาระดับนามธรรมที่สอดคล้องกัน.
ลองดูที่รายชื่อ 3-7 ในตอนท้ายของบทนี้ มันแสดงให้เห็นทั้ง
ฟังก์ชั่น testableHtml refactored ตามหลักการที่อธิบายที่นี่ ขอให้สังเกต
ว่าแต่ละฟังก์ชั่นแนะนำต่อไปและแต่ละฟังก์ชั่นยังอยู่ในระดับที่สอดคล้องกัน
ของนามธรรม

ผลลัพธ์ (ไทย) 3:

เราต้องการรหัสเพื่อที่ชอบอ่านจากบนลงล่าง การเล่าเรื่อง เราต้องการให้ทุกการทำงานต้องติดตามโดยผู้ที่ระดับถัดไปของนามธรรมเพื่อให้เราสามารถอ่านโปรแกรม ลงหนึ่งระดับนามธรรมที่เวลาเราอ่านลงในรายการของฟังก์ชัน ที่ผมเรียกนี้ stepdownกฎพูดแตกต่างออกไป เราต้องการให้สามารถอ่านโปรแกรม ราวกับว่ามันเป็นชุดของวรรคแต่ละที่อธิบายในระดับปัจจุบันของนามธรรมและการอ้างอิงย่อหน้าที่ตามมาเป็นระดับต่อไปลงรวมถึงการตั้งค่าและการ teardowns เรารวมถึงการตั้งค่า เราก็รวมหน้าทดสอบเนื้อหาและเราก็มี teardowns .รวมการตั้งค่า เรารวมชุดติดตั้งถ้านี้เป็นชุด เราก็รวมการติดตั้งปกติรวมถึงชุดติดตั้งเราค้นหาผู้ปกครองลำดับชั้นสำหรับ " suitesetup " หน้าและเพิ่มการรวมงบด้วยเส้นทางของหน้านั้นค้นหาแม่ . . . . . . .มันกลายเป็นเรื่องยากมากสำหรับโปรแกรมเมอร์ที่จะเรียนรู้ที่จะปฏิบัติตามกฎนี้ และเขียนฟังก์ชันนั้นอยู่ในระดับเดียวของนามธรรม แต่การเรียนรู้เคล็ดลับนี้ก็มากที่สำคัญ มันเป็นกุญแจสำคัญในการทำให้การทำงานสั้น และทำให้แน่ใจว่าพวกเขาทำ " สิ่งหนึ่ง "สร้างรหัสที่ชอบอ่านจากบนลงล่างชุดวรรคเป็นเทคนิคสำหรับการรักษาระดับนามธรรมที่สอดคล้องกันดูรายการ 3-7 ในตอนท้ายของบทนี้ มันแสดงให้เห็นทั้งหมดฟังก์ชัน testablehtml refactored ตามหลักการที่อธิบายไว้ที่นี่ สังเกตวิธีการของแต่ละฟังก์ชัน แนะนำต่อไป และแต่ละฟังก์ชันยังคงอยู่ในระดับที่สอดคล้องกันนามธรรม