Item Semak kesahihan parameter

Bab: Reka Bentuk Kaedah

• Fokus: Kebolehgunaan, keteguhan dan fleksibiliti dalam reka bentuk kaedah.
• Liputan: Parameter dan pengendalian nilai pulangan, reka bentuk tandatangan kaedah dan dokumentasi.

Item 49: Semak Kesahan Parameter

- Sekatan pada Parameter:
Kaedah dan pembina biasanya mempunyai sekatan pada nilai parameter (cth. indeks bukan negatif, rujukan bukan nol).
Kekangan ini mesti didokumenkan dan disemak pada permulaan kaedah.

- Kepentingan Pengesahan:
Kesan ralat seawal mungkin untuk mengelakkan kegagalan yang tidak dijangka atau tingkah laku yang tidak betul dalam kaedah.
Kaedah yang tidak menyemak parameternya boleh menyebabkan ranap pepijat yang sukar untuk dinyahpepijat.

- Dokumentasi Pengecualian:
Gunakan teg Javadoc @throws untuk mendokumentasikan pengecualian yang dilemparkan sekiranya berlaku pelanggaran kekangan.
Pengecualian biasa: IllegalArgumentException, IndexOutOfBoundsException, NullPointerException.

Contoh Semakan Parameter:

public static int mod(int x, int y) { if (y <= 0) { throw new IllegalArgumentException("Divisor deve ser positivo."); } return x % y; }

- Penggunaan Objek.requireNonNull:
Diperkenalkan dalam Java 7, ia digunakan untuk menyemak kebolehbatalan objek.
Mengembalikan nilai yang diluluskan selepas pengesahan:

this.m = Objects.requireNonNull(m, "Parâmetro 'm' não pode ser nulo");

- Semakan Julat (Java 9):
kaedah checkFromIndexSize, checkFromToIndex dan checkIndex untuk menyemak indeks dalam senarai dan tatasusunan.
Kurang fleksibel, digunakan terutamanya untuk koleksi.
**

• Semakan Parameter dalam Kaedah Bukan Awam:** Untuk kaedah yang tidak dieksport, gunakan penegasan untuk menyemak parameter:

assert x > 0 : "Valor de x deve ser positivo";

- Kes Khas:
Pembina hendaklah sentiasa menyemak kesahihan parameter yang disimpan untuk kegunaan kemudian.
Pengecualian boleh dibuat untuk cek yang mahal, yang cek itu tersirat semasa pengiraan.

- Contoh Pengesahan Tersirat:
Collections.sort(List) menganggap bahawa objek adalah setanding. Pengesahan berlaku semasa proses pengisihan.

- Terjemahan Pengecualian:
Apabila semakan tersirat membuang pengecualian yang salah, gunakan "terjemahan pengecualian" untuk membuang pengecualian yang betul.

- Fleksibiliti dalam Sekatan:
Kaedah hendaklah direka bentuk seumum mungkin, mengenakan sekatan sesedikit yang perlu.

- Kesimpulan:
Dokumen dan laksanakan semakan kesahihan parameter pada kaedah dan pembina. Latihan adalah penting untuk mengelakkan ralat masa hadapan dan memudahkan penyahpepijatan.

Atas ialah kandungan terperinci Item Semak kesahihan parameter. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!