Java'da bir sınıfın değiştirilemez olduğunu nasıl ekleyebilirim?

Son zamanlarda, değişmez nesnelerin ne kadar yararlı olduğuna ve örneğin bir kurucuya öğeleri iletirseniz ve sınıfınız değişmezse, tökezleyemezlerse, bu öğeleri kopyalamanız gerekir.

Bu, projem hakkında çok fazla kontrol veya bilgi gerektiriyor, çünkü eğer

public A(B foo)

ve Bdeğişmez değil, Akopyalamak zorundayım B. Şimdi hayal Bedilemez gibi görünüyor, ama yapıcıda değişebilir sınıfları var vb.

Bir sınıfın Java'da değiştirilemez olup olmadığını belgelemek için standart veya en iyi uygulama var mı? @immutableJavadoc'da anahtar kelime yok gibi görünüyor .

@Immutable açıklama tamamen otomatik sınıfı nesil için farklı ve standart Java parçası değil bir şey gibi görünüyor.

StringSınıfın belgelerine bakarken (kalın metin yaptığım bir şeydir):

String sınıfı karakter dizelerini temsil eder. Java programlarındaki "abc" gibi tüm dize değişmezleri bu sınıfın örnekleri olarak uygulanır. Dizeler sabittir; değerleri oluşturulduktan sonra değiştirilemez. Dize arabellekleri değiştirilebilir dizeleri destekler. Dize nesneleri değiştirilemez olduğundan paylaşılabilirler.

Gördüğünüz gibi, belirli bir etiketleme veya başka işaretçiler yoktur, ancak bunlar JavaDoc'da Stringsınıfın sabit, değişmez bir nesneyi temsil ettiği sınıfı açıklarlar.

Bu nedenle, değişmez bir sınıf oluşturmak için bu Oracle eğitiminde verilen talimatları izlediğinizi varsayarsak, sınıfın değişmezliğinin belgelendiğinden emin olmak için, JavaDoc'ta sınıfı ve neyi tanımladığını belirttiğinizden emin olmalısınız. yapar.

Bu hala ihtiyacınız olana uymuyorsa, burada özel JavaDoc etiketlerini nasıl oluşturabileceğinize bir göz atabilirsiniz .

Ek açıklamaları kullanabilirsiniz:

@ javax.annotation.concurrent.Immutable gelen JSR-305

veya @ net.jcip.annotations.Immutable gelen Java eşzamanlılık In Uygulama