Pilihan nama kaedah yang teliti:
- Nama mesti mengikut konvensyen (Item 68).
- Utamakan nama yang boleh difahami dan konsisten dengan pakej dan konsensus umum.
- Elakkan nama panjang.
Jangan berlebih-lebihan dalam kaedah mudah:
- Setiap kaedah mesti "melakukan bahagian kerjanya".
- Banyak kaedah menjadikan API sukar untuk digunakan, diselenggara dan didokumenkan.
- Tawarkan kaedah yang dipendekkan hanya jika ia kerap digunakan.
Elakkan senarai parameter yang panjang:
- Hadkan kepada empat atau kurang parameter.
- Senarai panjang sukar diingat dan terdedah kepada ralat.
- Parameter jenis yang sama dalam turutan boleh menyebabkan kekeliruan.
Tiga teknik untuk mengurangkan senarai parameter yang panjang:
- Bahagikan kaedah kepada beberapa kaedah yang lebih kecil.
- Buat kelas pembantu untuk kumpulan parameter.
- Gunakan corak Pembina untuk kaedah dengan banyak parameter, terutamanya yang pilihan.
Lebih suka antara muka daripada kelas dalam parameter:
- Gunakan antara muka seperti Peta dan bukannya kelas tertentu seperti HashMap untuk lebih fleksibiliti.
Lebih suka enum daripada boolean dalam parameter:
- Enum menjadikan kod lebih mudah dibaca dan memudahkan peluasan pilihan pada masa hadapan, seperti dalam contoh termometer dengan skala suhu.
- Amalan ini membantu mencipta API yang lebih mudah digunakan dan kurang terdedah kepada ralat.
Atas ialah kandungan terperinci Tandatangan kaedah Reka Bentuk Item dengan teliti. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!