Local reference — JNI kabi native interfeysda joriy native chaqiruv doirasida managed obyektni vaqtincha tirik va murojaat qilinadigan holatda ushlab turuvchi reference.
Kriptografik asos
JVM native metodga obyekt berganda yoki JNI funksiyasi yangi obyekt qaytarganda local reference yaratiladi. U faqat tegishli threadda va joriy native frame davomida yaroqli. Metod qaytgach runtime bunday referencelarni avtomatik ozod qiladi, shu sabab uni global o‘zgaruvchida keyin ishlatish xatodir
Platformadagi qo‘llanish
Ko‘p elementli loopda minglab local reference yaratish jadvalni to‘ldirishi mumkin. DeleteLocalRef keraksiz obyektni erta bo‘shatadi; PushLocalFrame va PopLocalFrame esa guruhni boshqaradi. Bu obyektning o‘zini majburan o‘chirmaydi, faqat native rootni olib tashlaydi
Kalitlarni boshqarish
Local reference xom pointer emas va uning ichki ko‘rinishi implementatsiyaga bog‘liq. Uni boshqa threadga uzatish, chaqiruvdan keyin saqlash yoki identityni pointer qiymati bilan solishtirish mumkin emas. Uzoq muddat yoki threadlararo foydalanish uchun NewGlobalRef orqali global reference yaratiladi
Release nazorati
Har bir JNI chaqiruvidan keyin pending exception ehtimoli ko‘riladi. Native kod reference lifecycle bilan birga exception va thread attachment qoidalariga amal qiladi. Stress test, CheckJNI va heap diagnostikasi jadval overflowi, leak yoki yaroqsiz reference muammosini ochadi
Arxitekturadagi o‘rni
Local reference alohida ishlamaydi: build tizimi, operatsion tizim, kutubxonalar va backend bilan bog‘lanish nuqtalari mavjud. Har bir chegarada ma’lumot formati, identifikator, xato kodi va amal qilish muddati yozib qo‘yiladi. Tashqi komponent vaqtincha ishlamasa, dastur qayta urinish, foydalanuvchiga tushunarli xabar yoki cheklangan fallbackdan birini tanlaydi. Bu tanlov ma’lumotni takror yuborish va yarim bajarilgan operatsiya xavfini ham hisobga oladi.
Nosozliklarni aniqlash
Local reference uchun unit test ichki qoidalarni, integration test esa haqiqiy platforma bilan shartnomani tekshiradi. Qurilma yoki OSga bog‘liq xatti-harakat emulator bilangina cheklanmay, kamida qo‘llab-quvvatlanadigan eng eski va yangi versiyalarda ko‘riladi. Error path, bekor qilish, process qayta yaratilishi hamda ketma-ket yangilanishlar alohida ssenariydir. Regression test avval topilgan nuqsonni qayta paydo bo‘lishdan saqlaydi va natija build raqami bilan bog‘lanadi.
Ishlash ko‘rsatkichlari
Local reference samaradorligi faqat o‘rtacha vaqt bilan baholanmaydi. Startupga ta’sir, p95 kechikish, xotira, disk, tarmoq va energiya sarfi vazifaga mos ravishda o‘lchanadi. Profil releasega yaqin optimallashtirilgan buildda olinadi, chunki debug instrumentlari natijani o‘zgartirishi mumkin. Kuzatuvning o‘zi maxfiy ma’lumot yig‘masligi va tizimga sezilarli yuk bermasligi kerak.
O‘zgarishlarni chiqarish
Local referencega tegishli contract o‘zgarganda semantic yoki platformaga xos versiya qoidasi qo‘llanadi. Eski mijoz va yangi server bir muddat birga ishlashi mumkinligi hisobga olinadi. Migratsiya atomik bo‘lmasa, oldinga va orqaga mos o‘tish bosqichlari belgilanadi. Release kichik auditoriyada boshlanib, xato va performance chegaralari kuzatiladi; muammo aniqlansa artefakt, konfiguratsiya hamda bog‘liq ma’lumot sxemasi birga rollback qilinadi.
Amaliy boshqaruv
Local reference bilan ishlaydigan tizimlarda amaliy tizimda bu qatlam boshqa modullardan aniq shartnoma bilan ajratiladi. kirish va chiqish turlari, timeout, ownership hamda lifecycle qoidalari test qilinadigan shaklda yoziladi. monitoring faqat muvaffaqiyat sonini emas, kechikish, xato turi, resurs sarfi va versiyalar bo‘yicha farqni ham ko‘rsatadi.
Local reference bo‘yicha texnik hujjat mas’ul komponent, qo‘llab-quvvatlanadigan platformalar va ma’lum cheklovlarni aniq sanab o‘tadi; bu ma’lumot keyingi release tekshiruviga kiradi.
Bog‘liq tushunchalar
JNI, Global reference, Garbage collector, Native method, Object lifetime, Thread attachment