Item Dokumenkan keselamatan benang

Kepentingan mendokumentasikan keselamatan benang

• Sebahagian daripada kontrak kelas: Cara kelas mengendalikan akses serentak adalah penting kepada pelanggannya.

Risiko andaian yang salah:

• Penyegerakan yang lemah atau berlebihan (Item 78 dan 79).
• Ralat serius dalam tingkah laku program.

Masalah menggunakan disegerakkan sebagai penunjuk

• Butiran pelaksanaan: Bukan sebahagian daripada API awam.
• Pandangan ringkas: Keselamatan benang bukan sifat binari (semua atau tiada); terdapat tahap yang berbeza.

Tahap keselamatan benang
Tidak boleh berubah:

• Mereka berkelakuan seperti pemalar.
• Tiada penyegerakan luaran diperlukan.
• Contoh: Rentetan, Panjang, Integer Besar.

Selamat benang tanpa syarat:

• Kejadian boleh ubah, tetapi dengan penyegerakan dalaman yang mencukupi.
• Penggunaan serentak selamat tanpa penyegerakan tambahan.
• Contoh: AtomicLong, ConcurrentHashMap.

Selamat benang bersyarat:

• Serupa dengan tanpa syarat, tetapi sesetengah kaedah memerlukan penyegerakan luaran.
• Contoh: Collections.synchronized, yang memerlukan penyegerakan apabila lelaran:

Map<String, String> syncMap = Collections.synchronizedMap(new HashMap<>());
synchronized (syncMap) {
    for (String key : syncMap.keySet()) {
        // Iteração segura
    }
}

Tiada keselamatan benang:

• Perlu melibatkan kaedah dengan penyegerakan luaran.
• Contoh: ArrayList, HashMap.

Bermusuhan dengan urutan:

• Ia tidak selamat walaupun dengan penyegerakan luaran.
• Biasanya hasil daripada ralat, seperti mengubah suai data statik tanpa penyegerakan.

Cara mendokumenkan keselamatan benang
Kosongkan dokumentasi dalam Javadoc:

• Tahap keselamatan yang ditawarkan.
• Kaedah atau urutan yang memerlukan penyegerakan luaran.
• Kunci khusus untuk digunakan.

Contoh dokumentasi penyegerakan untuk lelaran:

/**
 * É necessário sincronizar manualmente ao iterar sobre as views deste mapa.
 * Exemplo:
 * synchronized (map) {
 *     for (Object key : map.keySet()) {
 *         // Iteração segura
 *     }
 * }
 */

Penggunaan objek kunci peribadi
Kelebihan:

• Mengelakkan gangguan daripada pelanggan dan subkelas.
• Membenarkan kawalan serentak yang lebih canggih pada masa hadapan.

Contoh:

private final Object lock = new Object();

public void threadSafeMethod() {
    synchronized (lock) {
        // Código protegido
    }
}

Medan akhir: Lindungi daripada perubahan tidak sengaja pada objek kunci.

Berhati-hati semasa mereka bentuk kelas untuk warisan

• Menggunakan kunci yang sama dalam subkelas dan kelas asas boleh menyebabkan gangguan.
• Pilih kunci peribadi untuk mengelakkan konflik.

Ringkasan akhir

• Sentiasa dokumen keselamatan urutan kelas (dengan teks atau nota).
• Jangan hanya bergantung pada pengubah suai yang disegerakkan untuk mendokumenkan.
• Untuk kelas selamat benang tanpa syarat, pertimbangkan untuk menggunakan objek mengunci peribadi.
• Kelas selamat benang bersyarat mesti menyatakan kunci yang hendak digunakan dan bila.

Atas ialah kandungan terperinci Item Dokumenkan keselamatan benang. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!