From 6af169a3a24e278aeba4951ea860b543d25fe20e Mon Sep 17 00:00:00 2001 From: upcloudrabbit <1814876440@qq.com> Date: Tue, 11 Feb 2025 22:28:43 +0800 Subject: [PATCH] change home page and add jni article --- README.md | 8 +- README.zh-CN.md | 6 +- docs/.vuepress/config.ts | 6 +- docs/README.md | 5 + docs/images/java/jni/1.png | Bin 0 -> 93517 bytes docs/images/java/wait_notify/1.png | Bin 0 -> 28290 bytes docs/java/jni.md | 1503 +++++++++++++++++ docs/{Java => java}/test.md | 8 +- docs/{Java => java}/wait_notify.md | 7 +- .../custom-component.example.md | 0 docs/{Other => other}/markdown.md | 0 11 files changed, 1527 insertions(+), 16 deletions(-) create mode 100644 docs/README.md create mode 100644 docs/images/java/jni/1.png create mode 100644 docs/images/java/wait_notify/1.png create mode 100644 docs/java/jni.md rename docs/{Java => java}/test.md (95%) rename docs/{Java => java}/wait_notify.md (97%) rename docs/{Other => other}/custom-component.example.md (100%) rename docs/{Other => other}/markdown.md (100%) diff --git a/README.md b/README.md index fef8f1d..7cbea4c 100644 --- a/README.md +++ b/README.md @@ -12,11 +12,11 @@ npm i ```sh # start dev server -npm run Other:dev +npm run other:dev # build for production -npm run Other:build -# Other production build in local -npm run Other:Other +npm run other:build +# other production build in local +npm run other:other # update vuepress and theme npm run vp-update ``` diff --git a/README.zh-CN.md b/README.zh-CN.md index 0d0426c..0e12248 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -12,11 +12,11 @@ npm i ```sh # 启动开发服务 -npm run Other:dev +npm run other:dev # 构建生产包 -npm run Other:build +npm run other:build # 本地预览生产服务 -npm run Other:Other +npm run other:other # 更新 vuepress 和主题 npm run vp-update ``` diff --git a/docs/.vuepress/config.ts b/docs/.vuepress/config.ts index 4b63708..f46814a 100644 --- a/docs/.vuepress/config.ts +++ b/docs/.vuepress/config.ts @@ -18,11 +18,11 @@ export default defineUserConfig({ theme: plumeTheme({ /* 添加您的部署域名, 有助于 SEO, 生成 sitemap */ - hostname: 'https://upcloudrabbit.github.com/blog', + hostname: 'https://upcloudrabbit.github.io/blog/', /* 文档仓库配置,用于 editLink */ // docsRepo: '', - // docsDir: 'Other', + // docsDir: 'other', // docsBranch: '', /* 页内信息 */ @@ -38,7 +38,7 @@ export default defineUserConfig({ // blog: false, // 禁用博客 blog: { link: '/', - postList: true, // 是否启用文章列表页 + postList: false, // 是否启用文章列表页 tags: true, // 是否启用标签页 tagsLink: '/tags/', archives: true, // 是否启用归档页 diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..2a53a37 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,5 @@ +--- +pageLayout: home +config: + - type: blog +--- \ No newline at end of file diff --git a/docs/images/java/jni/1.png b/docs/images/java/jni/1.png new file mode 100644 index 0000000000000000000000000000000000000000..47d2851e0e7b335f8a201fedf59a2f351f08cbc4 GIT binary patch literal 93517 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ΣWcc5;)IZNq_m*m&}X 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 literal 0 HcmV?d00001 diff --git a/docs/images/java/wait_notify/1.png b/docs/images/java/wait_notify/1.png new file mode 100644 index 0000000000000000000000000000000000000000..84d8b929a7716acc3c9fd7386d4bc6c9949e70fb GIT binary patch literal 28290 zcmeFZXH*nj*Dcy6P!xC!pyWpZkt{hVU;=CqkStk2augbnjH04MZIa|nlbV(+*$4uX zLrV@yY%(-C+*Q8sH_or~@7{67z2p87J5}wfz4uyk%{f=Sxv#27O~pusLZPV9ckgJR zP)FoYs6+F|Dc~K6>z`CnsDDxDJ2$nSCd>`Fdv}w^8kRSPCY<{s?7k@7`1c!%sz_1$ zPRe~n`~%*wUY$Ihjv$@yHa*gLI?VQd3pS-;mz3mhL|?jnli>vW36Yb+KdS#=2Zt8J zr+XrzZhVo5@seSqWu;y8+GwevRbOefj2(0+H-J;4+P}w!(jfmq;SNtw!XJN=lwIWI z(#c3R^s4dkN^Wi;^$zuSvq{+e_V)V$XAh%L z>FU0t=NXxpN_`Xy#2xxG2;$!9)w@PK0#Ye){rc(YsR2hRDY-Ao8mqrMJ=;|kqi{-2 zQzT1eIpiO>(FbPERYMNxw^1xPS!FtYTO^n5$Bn{0-MzU5tzH-|ad8F9Q;ixaV)r{n z!dO3TFkj)1;^>Jz^n(m*69qpg>Dz{#dMCU>-7CqooXgCI|>i7huk*bSJv2)pc z`|804Hd?@dJEl4F^^z0y^oUwSYf`peOj~5*V`1sbs_*LS6(;8U@$Lu3H+Xe?3ev{U zh>45yz&)wkpNNVRo?-sp(7?cQ7KKVU9La{^7Kl+M)efe}$*pIUP1;3pgfhu!OeMP) z)Q7R={K>czaQ4d;SGTG%iz%y_qA2~^S(o|#8pYJq)Hvs1sW|egvY68izjXG)D1RCS zxDQ2k6PBK9Z*Zj|f+nZO#wxuhIV=C9G0eV;v%!dB&XksxZhLmo?~U*hY+EV?%}Xh) zmS$orf0xBa#R|1gKSiNZj;Q;#oAa4$RX9}a(dHK9s6T!1p4DS1JWkRf#7;cEqocj? zqoDvDUCeZA#fB|8&Q&mONB($|H8eX(WeAZS#o< zB~_(vHiu+9_f(=S48?h3f-Y_cCucje5@lm!)45rgPHy*c=jDDk^A3f=$XlczL2-SZ zaJK#}5s%sMq0P;&HdI%CS4no4xbNN0Q&=ce>9@eP_M1Dxyi~vR(Qk?Esk&ixpW6W) z9VpZd%9PztxTxqT5}RO6F3U9+PPDF}TaLi{Rt5p9nqTj&hMo=)L?6vr_4M}4luC?r z8Z1^jV)$U-hhX4(5LVa(jdR%_Wlv0?!UNjh)!@a~1m7^PHgz)_JK7`Mjt5{$Z&^)%5g3D1WzGThG+=t1+?SjxEtG7F}!H5ir0X(|4y2 zUt<5_`qi;O8^)cB$9EOc29L{~nn7k&BiC1V1Wk^JL3 z9~~-|rO};PEe53v&4lis(-19}la zt;%T`*(Y|u{N1>QOaL<Kqkctpdm8hD7YZvaRsj& zNiOvMK9!p-nGtemPYk}1{`(VchMQW)2a#7lY)X0jhz|3^#l-2mkV-i2!+>N>iWRV; zDSmSDii!*g6#Jj-#BH5=|LwDTmYbhzIt$@gHVlsHH2N?nny_n#jqJshf4L<^q{P+# zD1OB&Bx~H#qDps;KKJw3Rp~P*l;q7ww#^qClY(zK*kdz3ew5_o_{NlQ9Qo!uX&I5*Vh}7WR&^k*GX6a*s)<&*=1bZov1^Gz zA+OuBPk((Z92*jLRPHQ<&G+vt8|U441^r@pcxd7N!!Z7SU&d>rdBT}nRP@df)oU%& zl1rLLC{MlRm>)1nnayPk=z?T@_U6`2Tsgah8ic}|H*e1Ni+v*TAV2`;3dtQe*`nf88y!~R2gy>ytC60qB zA#gpJlSPC)ak34KJjk@?lTqHo1f9Ikzee4UM(&U_l-Mf!21zXT3Mbq=A*4 zO8Xtv3PV-2&TSFc17)eZDVn@|JUT7qnGZ)%zui6a3JQ7yXl1j_o1P;&}w-bz=} z+MftD9yz&#b6K`5#eEqc+V7(^o}k|t3QX1*5yzIpSN1vd{* z=UiWLRDAqEF41wQQoC-uhp-k?w<{kT8_R;t@!D9J?ZwA8H8oui-yxHT7Z-czRa8`( z8XG$l*?cnScy+EwN^WMSOTgXK|LBy8+}x<>XvVi?u6*>tX_weJ(bUv5Xaos*Q^T6j z@$m_;?B?Q>YHa7Dq+xDvkr?s*_4-ANg=U@aUSxE1mQj@(x1gY!Th-92x4itzg{no_ zJu<;h+u3=Cpr@p!Mr;1o^t+BC3xj8x7kJR66XKe@}+uG^~Y$*PiW=>0&=In6(tL-0{A@dMw z*5h=Sg&?UO?5?`*%$M`>@%?le8gsH5uJ-UG;mfagjk_%l<8jHp`n1=V{PTO)P1vys z3Hc;KUF}d^fx4-gnYNJ;J}ax$Jvyw*wXojKub-n zeXzer$HKxN(TLIL^IV_Hu_e^#pwZ~ct;zUn=36IDozlAN^nr&rPfN%65r!EyrUC>g z{m{_R+=GJMZ+94?&1O0?bF()`Br4y$c@rmQ+pB&upvR`CN7n=o>mn~Z`>saw^8@WX z9hUOlbM*AHNnQ&bSt{|>1zen*Gsp`)%fty+nQPY!BnF)Vh-*dcc>EJd=51o#ex|Om zhrF1Wm~q?7z(7(HFJ!$~5%X(J7mGMKIXzbzxk|maoZA@l7ps=OoOC4`xz9|*nDkbA ztcGn?TvkisLkGQn-3~7!-@UtthM`4Uv?bxQv#+#SLJpZe&aClFwHboW)_}F+O$vLr z`z9uYmUsy-qid@_MWW*3Jb&(BBO=5w)AtFsQc_Y$!tNXprnZL`ecc}{zta~#_HiQG zpae71DW2h|uBn+`;W9NFYnddKzv;cPE7Ep79d^Rn>vVoz-2!CbrSMI5dbXTQ!^G^8 z5>d6~nYriB?Wj)L_ATQx{-k`ih74^0IM2Fb$f078pJY*MVEH7sr?=NL@jE*jwp~Nw zxVdmF&45GYhYw5dEw_Fq%b8TUFY4UA`x?T_xzne|$kkuR+7I?d4m?6{v8VwyPV$&! zAaq7zv1ta5HQMDPzE#_6TO-f+j-8}`s?rmY!EaDD{fv@zDTL35>(ZrLut$P|gKcAG zp4NV`6K^(k*ed?j-EHN>hy>(&Ubk@*PLkIxe?dkn4$yOTEoEe6tS)dR_2RWRSRFCb zflv$x)U0U?Ien!r>a%mMF!bD-h#|vvd@8Q?qpgiN*%B}I=*tTopO(2fJAVC=AFGn= z?6=iq$dRU|rX1+0B(H*kx_wW`nN1VUGj#`h1enJBr6s4nc{drD6k~Hm9x1zY7MJmH^t*`-M-CH%KYghgqGlg-5>O_T%Q<6^#U|} zUd-s@;KQ%n22bT4|M4jf?QemiH=j)SKH_4UkJBiIIVU<=t05e%w7qN$I7sW8>i9&{NY8 zH}1yq^%b=y%qLMSz9lO^pAWBBTA(VSZfJj9w_vBejav`(Lq| zdU`qa_4U7_lef1$A(nf}$abpQDXxCq_1RgMS@42Ag|UD|!ey~?kKkN2_=@9oNXYg4 zNV~z0%de}ld`whSLd6{hr(OAFWcEJ1OFVm;jxO_)4)gY`b46I?H3QpSrx(HF>^($@ zr~5-(TwDOskoz{$lF~)>;lbn5vfb0A#DUPpfBs1s`x;2z_nph|2$&P;X=n6mkaj>1VOz2Wh;-R9kp$~@J8h2~_3Q5L{?oT7 z*ss`n8E);t?X5#$?Be1&L}M>Ju|GK|h-wJar4lD%8AdN?oL}R$VY58`9eG($v#w8= zPc<_&#k7bKnakX!1Ecv3vfy_unsGL^wqlOM*XR3+8&>1~{COP8ELEgkaRfj%ToK{$ zYNxWGN9bK29Au8>7{Lus!q1=g$O}UQs~;;X^#N{_i`(~elvkNErVY&N`1;n;^F0_P zlb=6-{l z*cksc8#;Qr=6N@^4X2JU=k-3zyp)t1ZL&N0xCF^WReqz&ZW5}44FU;rRl*`7;XAAV zM%!dI5{x}2=peD>R973)1b!unO(nV~L8vxJ^!oW;i1GT<50-oCfYKl+@Q`PFlmjTJ zv3+*PaNQOLx#L?VOE2ECv&%2|I8KE?sH8T-2M@CI2(|jBPoJiurPYOn3Xnm}byf=! z@Q{n6p<%+AvuCx9jRhchwq`ETjhh!%6Ss}ufxK6*~71Q<|dAD z%=7T@Nat^cFp4P^TeR3{9y&!!OJs2$Ol6hvd|FUpC@|k&s(g~3uN^QzDWJly!=!7P zS@${|{dNoh{t`$%Jv}^pd~5xOcXuvby7YHWZB=oakS>h}EO)TLMA6ZgB|L*%;qc%z zkaApMD*>wf+!t>?8gZaC($R6SqA%{tZx*P!w^+RzmZg^L+ih(pBqUTh9>go^x9=Uw za;>b#p1%Si6>kuH5Al`!Z-{Eq;wYV|4p9 z1q(khxp8mkk59_k{#p@TiGzLB`JXLBFAT31h>D5=jH7FAo(axJ6%I0AG_jGR zW2BiL@8^fp$=Ap83MS{s4ayF1DMPf~52>r@$l?6fz%80#{)bD@Z{vxvk4ly8IFTW1( zeAG07>*vpHyKcS9I6_JDw5(vicKLUM?dH-L1;+}l)PVcnqK^|Hv+&j(4D}{iT*E|0qQj) z+0`>>ez}(fNz4y8^!de>gZrgorBqZ!*1uwJhlU}=I6?=RwSPK<&3OLh5`JW<^t1IS zEyBcbUQ-NJQK33+bSHt#T3PKu7$uIG zB4q(n;QUbD%y49O@yq&MxFo{p=tKL)){ejfqsJHy%pWxp%qN znynEW_Wjk`Y<@*|pm?Rg-O^PzFu=uIw7ugt>yreL^`Wy2f*@T`fyR+sWy}=N#BXUNAsQ6=|=uf@<%q zxcK-|)1E2)s(s#c_RoP3>PU`)wYh`UMgT`Dm$z-Bl6o7a9{@+p0xPQ+I4I24Pi2JX zLYUU19agRNvU!Du=d?CfR_(k8yD{|q#yk<|IJbQc6{$tT*cN6RD%1^KgsvpL>o=0v zpVZIf;F@`89b0fPWZxfG(=z>FNhq1mDC;lP6?)zFW75;jLjh-Ds={EutDQW4ygmGK zNY{jjAR=v0Q3YeBYBorDp(7VqsAb3J-4D_OS$#ApX`*NIA6ZVX8#o9f>w5a%Xu196 za6eJ$qfWv=32bNK8XXA4dPniR>grntE@e6Hgd`=jDz@=kHz#vJS%E5{b~!pJZljuq zhNbhXCSX(K2g_SD-^{WUPexQ*u!mGFlT^C{iC+aBC@pzYJu6%q!4 zRr&%VP-tpKM0;1>I`AfqY&(A?!Z2rt@^D#dGA3pUiJ6~qmMdL8a^o0j*U{0NNM?gA z()~p~m=padHC1|Xu$WA;wJ6LK1G((^N`OF4VGep{1^Oh&jACa%*!iCtS3ky41Di-TcR=+^3#{EU(Yd~N&EKV=*z&DJTC1w z&>E1FzTCPU5)yLukDGF)xp~n5DXQ2f5C|b{b-f%&mt9lXPrs zxVNJZ12m7I{59XK9I1OqAP^ujeAf{yM}c1=k8){a`Qyzex?S6g^5ejfy|j>E-sA-ny3V-|4-|m z{~Ou%kOC#j$wpgO*A`MKfNTkAs@=Ch?|FJwe);kxB2@UBr?xquRn=s-GJaZ6 z_&%9EcJ%1C+!T_gLVXGsnn48Y|9kc9i=U?9kOk&rUta2e zc=(Jc22>s(*1OnVyaA5Mv0B}tc%y9u5P3n4CN8Nc;Xf52sw59sf+4TP8VD?k-n9T? z>FDT;iJ;5?Xj;%bO^X_Bc)w18veM;!*-QUFUVz5NM%bt}T{3!ldP->YOv)Xov=Mc_ zKMGVWU^)gcZSXI!P109Rqfq=Xr~Yp6N))&-K!K&RWOa3QMrq6yz+vrUe?N_R`!>aQ zZ@YB16e?=XTeogef=~mw88waS=;&Y+wQ7H&=mNtM78X9o!r~KzJ%ri?bq>|O0L7!| z!%rxH!_2F$P-`$sI;FsSs_Mchf4OuRl=PisS)Z_~00SkZAkU2jpP)1FTiCm(_KQ&T z0TXdK_`CDBDSrCk&d$zXT`vH`+I>3XUPNt=y=^gzXKzHH7)1V0W zJstAhyFa0rZIHjy{q0OtSCH^;`t7)2~Xh^0bi^~|pPpr^6C zL=NE;aajf1_!!Fp2}&hSv~d(U=^f;xA7M5@iB`sr|NafB-rVUD+=Dda9vD7+n4%EQ z%8zE0@f5Y(0fqhM-yeMXbR+bF&@JFK7==thj6pp-4nB&MuW;zhtSp<|&1HyI1K!gN8rLfao^W6Ogr!`x|8fzsN=C! zrKM#!PWHZcuVlQ^RrCH^m0r|7aW2?UAZB)sU%uC&98q)E=LOqq_l_Y(g_@P^cxkig zhbqaQwUEWN8qsekxF}EuUq?Qm+MhAT$E~&b?HMHVZE5ullr`_qOEi>yxZ{j=ru@+nG297Fr4tV2ko0@ARxB2{eMhq6JJ+!Cc}w*J!ErWcqDZqF)kh z){w9hC?k60h;INcfyznV>{^YCsZ$<%^r+Id6)){I{`7nO9VQmq#5*ZHx%pj`GX)Ff zHlzMsYd>B5h+%`*Wmb3PIMCMqFDjl*R|wAWWY0;Y__CS-Um#-+Pl z4wI0km(BsZz}|RKGWVtHhHcjm+~)qnw+lW=uQJGo8HFWK5aG-mV5ECLT7`#Pjalqr;VG!c5K;PKBp2d+=t+4P*f|&r($NmFvvwi#EqV_t6A%30wG#h znh}NJhUFxA6L_0sym2~GzXYbMTdFbR3>>PBhfJY!P^SZLbHS&|vPP+{ zCJt}AW<-$#F#J7$x%q_W7FhxV$nyIgMbc-lMV)(?NJxQSP1DjbUF13)PklB-2ow4hZud1cGsWy@xBx#@0H1l1hBlB|60td;`m;Y|KOpR{nqV_P z*JTtl{RmaV=bZMa2YmFQj6#O73`aQ8$mcwKJP6|2l!Z80(s6CEO}Ft`0M*HpJr#0s zDH-4HAl0Oj(!Flv<%bXVqnIVL-G`GMF&wBR54dku0YhHvHjPD5&eDlcgmFMZl zkeAq!x(|0j)pvw|zGRP_B{MEg-=}n$2_%fX18W~K`=-ZG-_hQS7uEyohmBP>G0A5~ z+hpV+GA_NpzevNLnV6ga3&wTxBEa6%;5GP%o-y}?nPOf=Uyc~5*OthdReR{u8;Gkn zc;`n!Ihvc(Xn+r<*QeqpFs$IB7>$4p(N0AZc-x@J1vYBS`^$L{{4Q;t4gQ{X5r`WO zy#C%xFmNFTjS)y@{yM)(Jn~jn+?BDH!`SltQ8Z%TbIhPnha4iWD9{R}}bd?@%zZeBuI_mqG{h zk`h*x6kqV`{RMCluz{}w;d3~w$#JEKuKJ%rJgD*w;6Q50prAhwH4{87BJ}7XPB%kX z1fPSyBa(xj{F--*ii%Ojf|HHz!Ve2dN%Hf6fXIFsdGUA^FgrkELzW@vNPyAW`|OAN zi<%9zv@*_|J#$L6%h%b(Ma+G{5V%(~lDEmz>ES$Cp671+nZ5~ zdjI~{>34hjkW$Z_9j9YFlOF_Sq{;o1j}COiF7r=DtGX|w zKH%Il{0??Tw!!Iuu+X4RgFKXx!J+d0>do^e-i25!Hf&oAEP&b?8fmk$Hf>_KuD(gW zV0!*eplK(ZD>%@3x`bYrHW}jN8FLQsB!Zkiv$ruq1XWb){{4S(UEDB@vOe2ZO_AJ{ zpr%45u&`>~{OAA@>izGjO7;V_n&2p6h@%9(zH1mYD!IM@&X<=jUh(hTF`2aBZB4e$rBY$w@+ zcLZt!uJQq&UoIfBR<1Phx`OXw8ecw)aJVv@?XW~8By`o}_DTdQr!SdXS|-m<8+&GC zc`A765R5FX=uu1Zu#P0d$R?$BZteV+^@pmsnBvSqo~~S|B$c=?F1L9=k?0BPy(=j8 zxmj6RUxmqwBPQbUEvu3;GDb3H5Go}RU z6u3dw^&t$e)Mz6z1Zy{MfvLnc&&08~Pt;*hGL%6?0dQw-Zf@tb#p>VMA&3cqR(A6S zh~Y+xcVr6y9v(YdvfHyal&p-pL4u7ldI1PQSQ3xHs>4d}@E{D7q#BrUO-a@>u-9@!vX#j>t_Qp2LG)Z1v;q#W-<${lGt@k-EC=jm43RCROPOf=!TAFCTIn zc*Gd&j7mgtcAdR3pL z0AwH>=yv%>ln`QaJ^jb@4yi!~cb z_2F!UrKR67A7RGke-+*anIkADNJBy471SU76UCz9;x^!VK$alFFs;w$0j4J$cIShw z+F#{PP*T!wtwi6u2O?bmi76&=yY~R*UB9Upg5pfgCOeq7E1B5JUce%)efS7oIQAaY zST=SxqI{I7%}WsSnQwb|yfjqB@zEEXnuYe&c$$rDO=|^Gffq*$vHsEkA|8f3tZR~cd!gb29&}-5d`Fh5wp^HPC^QldCv=JG&4VKU_sq zGw(Ul?W);B{v8PPIR*NHbCp4sLf_#d)Q$JGwEmQSe%5E#y9Hw&BwxE7NCVcJA}T6< z`g$Uf$b0SDPWD6t$PH1t#vN6QwWLz7_-^6;<BN8s+P8oK8(F* zQDNxNHy^lYOo@_|R)C}x0ik2nllk1a?p(*sfPet7;SjSnpak!@O)HaeGk^jOkaGan zS8VBpXVEWu{3c5^v42)f9I=qZnE1|kc!NwzQuEu6u=JWcarW|bdEFi!pc`;tYh!_I zHorbRqB?&3zN%`Nu@70BFfIZyq9sB^#cLr`Z*ze~Pr(^-L{X`TY5_aJ)h9Znt|8w+AFWA%F`F_W|((_TjS#PD>A! z8ZBXOo8FQIH3$}Dqoy}Uj$$}#C3s@0vwnfVjOz(}FD@=V3&P;~x!3IgpLeI^Hl)vI z>k^D%$Sc=}%k1MVGi>{c%ySD0)~`zdxquALxT*+(0eFYhtgWr>cfTo4!o|ULs?f@; zy(RW%Ksq3;4>)c#IlP#jzM}V&9z3_&%%)YgD65ljk4G>}=rY{{H>J6S1*@A31p6mXo+N#hnRlxqidLKDK>SRS@w$$Lot2dp%+lyh0+D5V zSYjE9a2{@MAhusSJ3Ch!OPJM%h!Z4ifGTr)1WDnI&<1DuCz3InSK( zOYg#4N|Y6p=>BG}gF=9XR5#O1hcF%PcbgJy5o-ygOQq*t0`v9Tm))U!KxW{kAI^Po zSkcEvL!3~z1?77>1o3?azm~E04L~2ke^<5X={HpZ< zA#~3T61HansER7F!tySYKdsC0wQ8^_N&!9`#y<-R3K5m2L2aJ<8@8;hUf;8bFcc^U zj`mbzdzHH*B$*l5nppj&1~3bTRhXA@K%gD4?fwn|&L{svT!~zgk{^5GPl-xMBrnBE zg8rq7>stNwSlIQK!V!ZqyACi5YOAY{RnVV4ohs!rISquH2qpkH^&O-X5<1#vCmas} z)W~M@bDt)p%eA6)AKmrt64}~BI4Qt=ds$H49VA=J)#X|nho$T6L zV_>P0-n|Dvgk%i{1_r$6VlR>_VM#7%dqcWUZD8}O9_l?^ifhW{kxCSZwYQL0aQmt1 zj%wEy(z}2PoAHucmMc6I5NV$x71HoW1Sz!TA zB7i`=($d@6i<-v93t}2;iC}yKo5J9#q=10x^71miiItgoj+_MR3I?KKXgH|u_r1Qp z2^`DUukU`a_GI&3x>@CjT3&8o^Rl;01Q!l?3M)0~+0dX@C^M_QiIZ3|T);?fwLQ>CwV;vrm_7MjK zG3&Txl1CQUtGs`1Was5|B_Hfs&I9+V(Ogf3U`0qzGvrDLG0eqxe2{pm5XL;?VF(sE zkJU*JeBM?V#LYl9-|4=4pC1cbcV?iCGabQngM^kE1?#xDxDva*qOUafsi~+|DkT8A zfo&Bu{^Je}LB+@?LF$z`oM|W)4!S=X@z~t>2cwLLNrK1K0|!djzb( z$kZ!;-YDbOuV2ylNWc4=U=N_>ebgZ0vyI_5uKuN&TU1=^`uW)TY`=s3*@1EbjIPXn z;IG$INJt$VJWGSuyf>Xf0oEwT2#^h7p~vdvKNw@U$Rj8i175qcYS+iewL?|zy7%sd zSXMp+Pn_>+{K%EdmldGI_uSu_0>>Nx>`~Vdz(l1_e%Gh_CIJYkfjn$4dpoBFsAYtO zwiD(CUFq#9)My^)jF7|9k-N-t_jSS8o%4x1RUbZFZBw-^Ev>hEx|9g$L}uj&yXVqp z%2K$;I(z3%#aNf5n&v6 z55gv(Xf|>E)!X2gLQHjF4k~q<*Kc!;X?Fb?y!-`H43G61;0CbEgQ_8--KFz)c6%whDE4h1R zqPfQH$&M;mcLb{DgyrQu*e)|cXsX+t5cE9Q+aN>!XDwX&2GvK|n_EziIn-`h04!wD zp$8sWE$N*mR3nN3Pc#?)_A@wXA>Ks5n~s=MCFw8$ke&!#3A*FFp5)n7{yr(#oFH&F zPD=tzl>QwevIfV`Ei6`K_p^@{lBzWalKXnSR>1@9U)Hv%S{w z@yYLyutOIde*P$48~Y;91KJv}4&5@GePFBsVNpp{RR;{#7J#Zdv(?k}$^DCLraYyQ z31(4*h(YJPcm`Dj2heGfWPw0p`eFHS_G09-3VixWqq zu_f4gqCQ)Pl-m!8BT04^fCaKg2L}z?ToAPY2=-?)m1O~x%G%mJ8ot65YyUYhlIaw0 zc_*m0{cNA)@9Qsitb@Bl$I5Df;rj~BQbdOe$qf-dKu58=ule247<(gfj@#e&`f}-#}5WJAe25(Yl3=ALGdKsmh zGr%4m8rGZ1lAEu!UoeEtsGYI?UlhiVCOfH-tPdaVR(Mo(*O{2qv5b8HQ{2@@&oAG5 z{}6MoZp^u2ttE>eoL^XuP!_Sy(L1QoctrKVw@cK7Q<$H6n_j4HV*e|9lAXEp1SS$} zUh{FmJ>Sq<@h|SYv8G+dRW;8Q0u1*lmX}Jdj>ON9>|Gs9Tye z{)uNneL8{Av%E)-9=*aTr3b+SnC}v3_EAuL&W3a%C@D9eJNLK?y2s8jGlNIuzYNbY zu$J9Cvcvm(Ab|6{Z_zKrAk(%#FONp#e4z>Izy1}JKDQJ%dT+Zd;ZgBQaSxCqRxpHs zT+p#UEY)E%y0*#MN*dVDZ&07y5gI58485YGCB8uLMGYAfUIt&-yV>A1wYLR=G~L;= zc#%LF#Fl{2MwWlS4|N989#!K-j^sdy@d}SE#Q343uTvl~;tPH%V45FUo)VHg{kQuG zRdRD9^07+db@ZV_hhX;+o7!~p3JW`?A51?7D7;@h%Fe>auL%((OEoEDfxGc9j{^#l zzxZ}zI4)Pw#=Vb30t*LVkg7K5|9Xya%Fy)nxO|`oq!Hhh-#LhpC0P;q36TC-CPqFl zkwi2q#o}@Ix1IIVrRip0^8Dax}$FT(`OCnxeH{Ge2`nUzv&PB z(S4+K555KVYUrr@AKDtiKKrZW95yv6HOQezvs2Adc#M{Tt|dlvGo`;$T4r}M0`XD+ z>CzdFOTfXdi|qSp(t~O@-jw4(CA>&U`M0IgJL?sVtPwRe_4dZjDtSBJk%{G`tkq{l zHruV-HlUltOn)(K4>|g!!?!_=x)FnLZxP-6;yP+_`yaqCpk*?WVtKIc=eauX-ZMC8 z2WR((o#V6A;YaQ+7R(0k1$Sd(lQ9nwq#o6cgA%;Rz* zsV!U%8iDr0=hi);758lM0EyhukUTxskPO{A6%+}*YJxROAz*)DV4+4;azNNBiGcOj zkznA5tDW)D($&QUvUzE!wRjoBA`k-;ODgsVB^lmawTpbRopNeOY)U5+M;1bef4z{L zBR8%I#omjP^v#F-OKwm1>i~77W`A;^zgo<|y`@4Mi1N^|*Q%zc!5uvj#JEsCos_V}-G2CMsdeX+G zt!o+6JTESN`P8U$1-u}()YWN<_-?x(Di#!%$P|RjtZ`Ax%4i-s1Z{?gZ^R(c9pnFg z+Dc|)?X3RhGFRNj7dcFJk<%%q|`21kO_o>;hkH38J;>x8atHcXp_UH{3;IjtQ!Z9DOut8sN+3M-O;fWpu~p0SV9CFw97E`~ z%p+!l?}bpkFUYT7bZ@V-D>CwZ3S6@u{@E-&6FVBLag%oE*`TeCFYxO{FP|E!lffWG zrp?(8ltL36v^qm#S9%@Zm3`p2*!ne{r>i>rAXfvO$%8gGYoxgN_UPT?*M!n2tPasJ zF=h0e_CnoMpMHHZNaQ@eL^555r}oE{`SyOEOJ7pNmCAqK3ziPG<4O59p6}6#7jNIb zJ$e{z?s4$rkElHT8IBx|shzE_%DJuRq3^B}PQGoc2|MU21vw_S0EO`F*m7kGl;%Z< zzalH8eQT=*4xM7RDXg0%3`*^HXz(K+)C0p=yWX7b!)AmNy?KBq9(@?Y(Ks?9koR(_ zi#|#>GB5w<_n7`4|KkO~pUljJxVHLKkVEppSBDF^CSeCJJvlF5***9ofJ&M82iA1# z*5>AwG#AUg-RO8x=Wk9b$>Mr)bN%U|2DQEQEhePV)O%1xHJq~Sj z~ArPwJXqZp$33@Lm27?$C$$@EGMX_Gyu#130`ePr7!da zTnF--o11sBtw}O@naVMq6^y9)4xqEdEL)kOfy=AvT#3dDHq?#cVtqWM>n6n@G z!91ad&#$I%a!rtSRf0mVskvEGUH$YJB^ee8DlQSM(1A289B2fw0#nCTHMB61iz+$K ztCQc3bn46tw^JbV$Nz;$)W!aBu84g9{)(TUpP=s1l$wWGl%e0_z`}|`W!>0B=KLWQ z4C4Rf%ZICOhn8qSgaIeXH1H;@1U6ak2hdJ}%>Y){hFD<4x;S7bF0Y^fT~MVD@TmUi zy`2rxpT-DQ0x;#!9R<2qqI4!yOHIJN{(cXN0w)JY$%8~xe-c8!SGwnT80FUX{+XC) z9CLbF?N~lQcjnBc;P0K6T+_%!NFCu(b-V;>?Mu*vbr-0Nj) zA_6>jS{fQy@S(yXf#m@@srR1tAuC!iR&~RwxSZIPseB$3K2c41RDUp3q;Q?$GYN0s z{sV9Rp!o1Sasq zU?N&)hN{Yej*ZK?R3i3*?JQ}y1`PdaahO&p3gdEMA-)7=9QqPQrc22xGOYd;AXwO| zNY?_5Hv6m4Ohh}N?A4N)DIjvBS){JcFFj06O-=W~g9jqI$5Lcozj>n$gd3x)9nu_d z_H5TrxD8Y4^QhIIB!IH1RaE5_2@UDz6^0D)IM6adL6-UcLI^ z^Y6n)jv#0HGs%nkX}>i38K95N(gij)HkfzOtu2cZM>uWqz&td<*3CT$t@weuK@Get zY{%wd%pC;<9$8sq9o_@xLsr$W-N>-$KAQm#1NNs|>6f35nlM>?dwrUE_$g@VunwOr zquM!!DqXAQimyY7RnkV;{uubS82j+W#YFL z(C9z|tZmIO+;q;%mwP=P9rABpUR}*A&ryQdw!6El{}E>D<&c9e^dZkC7^$kMS)%!8 z?`%HHm}QED7A^fY@*PFRJYc?!bE$54UG?5v(x=u0>lD(Vm>C3N3id9cC$!hJ&@C)s!L}}NR>DWal$zQ+DebRnntr_(yE+2J6(@;A2I`lPe?d*8vFqXKz zV7mYW^Yx^~6V%jrvADx1-AnxZEmj`$PLeIW(zUg;_}JnJG^|Z)Zc_GP$;ruJTDjnAgBx6Mo=9j?x3&f( zWbN|Y@H4^)z#nPvKiTEY)-HeT%3uCCA2Zs2Sc0~sI_bKNsYMQY>(n84$7h6U2)9{?enTW$2M$8Gds*06Dzq1=Mp=)6XM2G->}k9*Yw z)rnO%ZhI`SewqinFUG5gHHGZ`1!-xfcs-EjNtJ>S_r~X)`x922%UhGL@haX(u@g6O zjOm)(-25dvTR&F06E+YlWgA%LSEt!LY?5Q9*HB}m6c6DzGwpfTiaW)Rg|-Z}}&S&L3v@B%l?JpkwDmK~V zy*IBjkIMxC7M}p# z&MYgkuDCH=eG@~!UsdLCFg#$Ma_o+xyv=NeS9d_q5vxOfJ2vU?fw5&<9Q)>7j2Dvd zAD;O?oaq0b!y5>M$R2seu83KiR)<*FNFzs&smwW(TrD5M4dr**+un@Hhm>fRd1VO03&JU6K zO{P3hKk?wm0mf5TUq242O44-;F!^pn-yS?I;`8S?Ve=p$EY|1x(m~||>80dx<5h+) zYP^6mGB-y2O!9Q_8u#zN1-2?>rVB@;5&<)H7c?kypyAO9pc!<5e;Eh;sVZQYMWkTh zVke~?HDEhxL1QL}KP=au-fswF=_)X)DzR*1h1dYnt$fqZpP~ZyL$%L-L6xY&O+fTg z#3}>VZ!_DSQ@OW3U|zhpm;3@84)(u3+=S;!yyXC!@fCi4m6PWMy5Z3oJ?VjNk1Zu8rBLA<)`hGMVk>gq15CS*@fPbcrk zpi=bgMrw^#CtEaum@TN7WR%(Z69JUQvLqs0fR+-?0oEiEJh7s;HSrqxmsvQn_!%V} z5)fYZ)2C0;a_Mk;0e*EgMsT_Q`EeSdCcW0@)OB>CS$#JjAfKft$IPY8`YVq^E{unMdR|(L5C-M{#m3VP( zP&PpRgzT*jz4u}kKQ9dV?#z>i?;iRn4Pzwl?<|6aUl|Lg5z?-E&7^NeJv@e?1cnZN z2xTnN8&0U*Rzhq;6tt{-Iolh%5_Mal`=q-4yw8lV&X^GC6MD%(yi`xOC7gJ49vt=E z;5JEtM_E{PWg(9=0Tw^g+uIv(Upj0#p zE*P=~JU~Mqq$1F9LWyB)as{vef42dd6%-O;w=|`tqhkZJt-DD*JLOhIo{~GztK0l8 z2zr@tcqK}-4i-FKzqIM2)C{Ns$X-xLyk`3CI5b3Sfk+B-mzb^RX25>&;#iR!7cXz~ z$J#w0|MZY;xKO>Siaf(cF^pNLfER8YvWXG<72*_w9`#C|gwx>GG4us^`?baWM%h@nvJJrb+~wxM87*ZSR7v zQnRyAr4J4xaKW6ES^9KD+WF6GP+ha5A0R)7*kKgY>U*iaepw4gnPI;fe!+N@6t z%~#0=H^)?&6wp&KS6h(=tj6ysoiduSauEwjFb8vDjbdS8YkNDXBJz1jhX>M?941qp z$_FcRchjc+zE!U0^vGfK@%Iz&n=)|PF%HP+lczlpJ46c5fs};I>Fe$6?6z7y&`AiK zN#B@`9EdpeQ%>>u=R-sJ&f2q9@g}d)6SAjv#%l-J(o(s=ql4ubBrBAKb^Lebf|f&7 z_0O<2Qt=(J$4~Q<&)g~}XMEyBPPL#H8~7HkT@agB9XSYLQ&n9(*4EgSlHzUUPdg4^ zrOL$85~IFH%sH^ zlpOCl3j_}y!i&$5tw+qtW~192)L74%30G`Y`88KI(Eau(8`agqG8Nu^ddpbU6W@j{ zI;|k1A&v}jfpV|v@la)M8Lk?P7^+!XYcn%rImws-RlPr0l70`?4eU%`qVeS+&W6W` zgSi~F=bOMb5%kb;s5B*VcVYQJ`(6~a)Xlej{|zx&2@bOW>rP0oN?VFSo9Mb^)K;oV zU^q~kuTZRgp9O(#26~~~=FO>lwb%YyiYO}UH-*PyOttoC9&J;B_Gk;zSI9X6+X{-r zH4SIyNXeb%%s&rB;E+q?)#r|-y@y}*uerGg?==q_PDbO`^N0az0f(3G)-1=%M;1la)}u>%Qh$&| z&%-^+I@RBx9|dh&Ca$9!Cf2qxKT@Y7_9k{yVT@O?H3nr0#Y*CP%{VvQQf#T@hFf#y zf(-XTCN(mx4n1e{O5_ezb~QqQAuFqoz!wf02x&>IM;jNvP^pfT=8{wojT8Z%q^`kO z)QmKpWI!tYjCsjytENs%h&gdMtCX(BS-Gaqq$Hy<84Jd^_-?;I`G9hozbn-#v?QJU zMtApwwWyz!ShFUH!!eB<0o8Swv$Q)E2`;Y?NMc|2a1)9G8ncGqSQ5krcjx9#m(PvW zM#MQ5-@qIS1`}hcDTPt6%uD)i_rC3Cp#n#=4j5>sB5euvs^s4AkK*Et{y{7%VSt(x z(RSG>qRp<6o*!8rxqMk}Zmue_9FDd=tQ0jAgX$4YoGrQ2yT+q%3pN?k=U0QAqe=z1 zm4PROTneuOcg=vAJmfZ+JI5rGTH}V_^O~9>xvos7J~<7IHqmcA+-BW{EV2NgD4+t| zo{U-cnFXMpJcsI40fJ_WDySbKnjnMldi&46Kq8_p@q`omVk=(1wghOz66H>V%mY%o zQ546Z0C_3(ajFK!UKYt+pND)bdP{Ax_8c)`bS!rH!c9RWm@?{&5>-Cg#w3V_R2UgE zH4iGDu>Ehv=?AHV3Lt*&0Tpqas{c<6;$m{tU(6!wL`-tC!u9xg_MhKx-XA5rQalOW zuR{G%Mwo%~Q{LORHw3O5=)qNPSm9Av+A?t*{DD(_Tr!4U*o1H%NLo{MAss|Ci^VFh zUr|=+l&hMtWKD2i&*0$TOHMbCUVdBUa@8C^b;4n3`pkOs@1KHj@~W2f8Gx{{yv^NnRm zZVQ}r0;?9M9rP%P-q+(8pg;YQ(LpB2FKsEKy~JxH&w*6I7Vi-uC*oUhHPdetgr zbyYQK2osbVw1MzFNkD*o-wd1`>$gW zJv^StaMTTPJb;;LUS$4}XWvB*(#)1~cztl@-(b{GR!T;zBycHGkkjLW`xTX;rd(fB za~ZiCP>m`cAA_v%J<`gm8hv}tubn`47iU&Xm79Sg%*2ETH2e~%0X17Do#j|Zl@Tq5 zkQl}$DgULa*R!*;F(PUS??X!*Y`@$J%N{~`SlwrqGdeCxsD$Go!*21JZ&6_k&2Fb( zza&j}#sW`1lC;*9c4UDhw)LKxn7IY;>5%vIqc;<&H-gZcXx|4Row3NXveeZTR@T+o z@*Uncpb;W22Yo7L<4-8#46VkHMj^wH%D;8=G0HZo7bN#>vTwYt1;zKV@@j6O_rgg$ z`G}jhN&xcsWH69knAVFljK+mmL6gv!l3g;=#F4jp1L4kg_t)#vSp`$T{0G4<22S@Z z$53NEx+^GVmmP$PT?7C8`MsBv|NNXElvVu~3%H^xE|-C$U#C5J10WC6N6;%gAr=2g zcla@tGTU{(31r-j-|54T_vutDQKE#Q0ZC~wF~8Pvn{6=|-Z;=bQcvtTK9E&9q_q9# z`#HF-kymWeOPVL~jP9U6*>)%_yJKcq=n?;|26$YlfQf@%L+w^kZuu9p4B&UCZ-bAE zJH7=$D5$$8Xd5~1SpbL9fzx+i3Jf!(+&^)HK3f21&s^N8VAFuvQvmU=Z`}n0V<@|A zPmk{9`7bV-p{)-xJ>!-)lwV`6B(cYnSj3*g4~yy zsJnG2%al6gP|!=HF*tN`mVh{vg}x4t&>SNR!DO%wq<6&F7`2f)Gzo>1_;xiAcUogG z!p|~+C*bAchxG9Q0;}u)G%df$!gviga=2Q~~!$-n^c3~Dw`(EJPw!&ixlfzxvXU{GM$Io@sKXl;09qe<&1ylp_g-;X9 za;v-*CWXGbSYD0_>2T>9A@tBH^lOz3pmm52SgDJ?p$ds28CEdgMPdHe@c!@%U?}Kf z>Z*Vr2|@G4N&H0@E$jl!AlwBFUsW}*cANDJ%3>OwEp@E@k@CQJjPTY3rJHy=*7*k1DBLBr3@$1fTzK zgio#i=p*xLaOhN;rEB-J+CL#zDLm+y!v#(M4yt*GR zdTJ!0Gwr$;08z6gO>Od4NXXI+>m;#V%&wR(F=sOz+i&cM{~hCMqsXqc$5I%%A;}|u zo+uC!S|vmON5Cdc0gfo2X>~8ybZkfr z7#2^SY+S~Ih#JaPh1pGln}J=9%agOqba&1I?~5Is`5v)cKv_U^7_wcvADSAA=zPE-kOh}50t+RBGRq?^2DUKYnvTA+jzr%Mqh7GJwnn8etOGL!AJb-V2 z77kyC(UT9czT`bUH8*{te7s?2l|RM+*3A1TuKAV&tTA=;CQLsi22 zYbRBYFBTWfj^|d(!0#|6t{qrb%{270|3;^F;8pS^j6RMlqB(h?WTJqfQ1wX7Wrl$c zCQ>SPc%u4I-XC7y1-20#_5tfe5yOaXbuIIr{9uLA>eI{&ze?g52heSEdP&D57RQi1 zW&x7nh!X@@x!n{4lCxWR0pLSqD?LC~UhZEAv)qzh_Np7lAuDTQ!ZTpvrCwEdIK;e1 zjwE4w8GY-Pb^oayh;yKjJXBAN9T@VDi4D_abX(I3*iQB71>h#IyfXTzk0n6n5hFYd ztu(XJKI3Z0(C6fO?D?^Y+=91=V8^Z@V`MA=$ylcS@>AG&@h11Nj` z8^|l5SyH27ad_^dHIv9TY$U7p-qppP%+|MOSpb?b3!7<7&hk8AXE2r;P$H7@nZX=4 zL0j@>3cr{{!rPasgQks>nyuT|ut`P+;+Tq-+#prMrPt-HATx0%{Vmp+FM<~>S%U`$ zNQu?7?=6Si)^H~|RN0wlUFk_l|5$D}*?{HZ?BvHL=$rYP)z~HB*Ypfnl64OXTna2D zVh0skqP;0q7wrpBKis=n6&;(V2*hQ43BVVG_R=^E*#kfRtu2gLb#1)Kv0`;eB!m>k{9Mx=T!h7Y^nYRaG=d~L5%mZY&@yaq*S2385m_ybvKj%`B)s1 zWK|Bf+fN{Xg|-}de^h>j?wQ;vNJf32l{11Ua}FZmPt|+f?>J_lkP^GQyM>u31gF`K zM^!YT_!t{INfP0kYR6h4wdXCFVPoRhxil@zH7*Rmd)hSAQ95YzH*ljY_(42;(ZTU^ zXU}r-nHCtW;hbk9o+Yh1>aqcL5B}~Cb;~-EpkJO|akxwx0miFP>dpRV4@G&HVg4NsnhR1#~|?3OU3C z$Hd65Y|=zRisMxuJwNYmTp#G_@|osl@;sdEeJ&j7$BR(opYFg!1}+3;mIU7iI9@F*Qp~5(t-gJ+dA5$Ne!w z7_E%Kb@CR1ep2=jL7j|fc?f&fm3pU4txfF4>%mM=lVcKF~m$c?c2PvR%%0yk&+c3=*z zM_)ul1iy4N$`+_iGTpU^wP3VGeN;i|0e5-1yD1bH{|aJVSzXX%V3s@xHnv(JACo9d zPl7?a1qKm{WSK(zD2 z7J0Ku!6~_|?)j5tMK{o+b#!#ttxlMmU^?Z~k%Lb#eXXtUlh;je@!lq<#Xz>R6_>QX zc*sqmr}Fm_{SuUIqJV%s2QMi+D*Dj4=*4LbFaE}uS~KVAbk}xI6a_}@xIY|HP{*ek zCG27i+zksilf#JLjFuL`1F8*==u8gHR!B8UXvuSJa@(3(YKq^~?Fg1WKz3L+a`(X0 z2y+}-I(fG-x6^b86HYTwq^{PRkd`n^gPwyehJdADIB91oyh8L2iYIxZ;1$MPxqy6> z6mn5vH82wvG`$?9veU8zt1mT*M~C~0!S0pASC@P&cq1As^jijebhIzRC=Q62iqf2c z-yb<#*YUIft0)AVHcJ?cKnsoe*7&p+ogh1Kj>3ydXox&43g^V{$_!!HQ2Yp|lgjM2y1xv%Y`H{m(a^zvvtTvYEwtWpN?=C@z3z~5=j z3?xQ)Y(0wfERW+B{F9Axi(S+qbE;VQJS<_|cN=M`h)u@F%xK_YdLt8+D>Ch=sA@Ib z)bu-Ix9-8_DXzD@G256fH+}+*F z*G692St0=K6-82$oI}dN1#HE}E}N_+aX1&K9bOoTnAn05*A7@?GdzB7t&eBs`y{fm z&W$(Py@UsE#!~)zt*zbZfB>j!-*l6EmxaYsbZl%oO@Z?AzkvW^PdVGQzudZG$7|mo zA3SnSJR=^G;Eg<3qdlQ3Tsb*jUY<*WXO?2QQ|#K4%;ygX3kh-nvJ2+YjBF%3f~$(= zR>hGX@WrbC10qmJHFZwW#y0lpzvG|R3%q52J=64Q*~!w{avNbrO>xwBSzBEc`}glJ zvsuiz@Wv(!e+d$Ag8rTI`SbY75pS`r88%@FPoJ(Y7Yv;YnCs8)+_r4f0Wej6>qW9k zSL9t*SSZ-77b!VKii|z6VdeN%H9d)Xf`$2j9C#uM4bJ@Q-P$#24<6LKam-8e77M(W zcn^^w`wax2|B^1VURjrR$o+nyfsV3>$Z@%i8!e+e-wh~As1*dbHYnva3yA370DaH4C>+i|^5T@*j%?xCy-+#4o<;#I98_H~iufZzeO + +//生成的头文件中方法定义是省略了参数名的,实现方法时需要加上参数名 +JNIEXPORT void JNICALL Java_org_example_me_HelloWorld_say + (JNIEnv * env, jclass arg, jstring instring) + { + //将java的String对象指向的字符串拷贝一份 + const jbyte *str = + (const jbyte *)env->GetStringUTFChars(instring, JNI_FALSE); + //打印字符串 + printf("Java_org_example_me_HelloWorld_say->%s\n",str); + //释放str指向的字符串内存 + env->ReleaseStringUTFChars(instring, (const char *)str); + return; + } +``` + +4. 编写完成后开始生成`dll`或`so`文件,这里需要 gcc/g++(Windows 下可使用 MingGW,Linux 下可使用 GCC)执行命令`g++ -m64 -shared -I $Env:JAVA_HOME/include -I $Env:JAVA_HOME/include/win32 HelloWorld.cpp -o HelloWorld.dll`(g++ 会判断 cpp 中需要的头文件自动将同一目录下的引入进来,由于头文件中需要`jni.h`而 jni.h 又需要`jni_md.h`因此需要指定这些文件所在的位置) +5. 生成最终文件后需要在对应类加载时就提前加载`dll、so`文件,可通过以下两组 API 加载(第一种方式严格要求库文件名称为`libxxx.dll / libxxx.so`) + +```java +// 该方法能加载的前提是在 JVM 启动参数上添加 -Djava.library.path=D:\WorkSpace\IDEA\codexperiment\jdk8\src\main\java +// 并且对应的库文件名称必须以 lib 开头 +System.loadLibrary("libHelloWorld"); +// 该方法需要使用绝对路径指定库位置 +System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\libHelloWorld.dll"); +``` + +通过 javah 生成的头文件中 C 函数名数固定的,还必须符合特定的规范。可以通过 JNIEnv 对象的`RegisterNatives`方法(`jdk/src/share/javavm/export/jni.h`) + +```c +jint (JNICALL *RegisterNatives) + (JNIEnv *env, jclass clazz, const JNINativeMethod *methods, + jint nMethods); +/* + * used in RegisterNatives to describe native method name, signature, + * and function pointer. + */ + +typedef struct { + char *name; + char *signature; + void *fnPtr; +} JNINativeMethod; +``` + +按照函数签名,主要是 JNINativeMethod 参数需要确认。其中 name 表示 Java 方法名字符串的指针,signature 表示方法描述符字符串的指针,fnPtr 是该 Java 方法对应的本地方法实现的函数指针。signature 如果自己推断会显得比较麻烦可通`javap -s class文件`找到对应的 signature。 + +![](../images/java/jni/1.png) + +RegisterNatives 有两种用法,一种是 JDK 的标准用法,在 Java 类中定义一个本地 registerNatives 方法,用javah 生成对应的本地方法头文件(这里指的是生成 registerNatives 方法头文件),在 registerNatives 方法中完成其他本地方法的注册,典型的如`java.lang.Object`,其定义的 registerNatives 方法如下: + +```java +private static native void registerNatives(); +static { + registerNatives(); +} +``` + +本地方法实现在`jdk/src/share/native/java/lang/Object.c`中(通过`Java_java_lang_Object_registerNatives`一连注册了 5 个 native 方法): + +```c +#include +#include +#include + +#include "jni.h" +#include "jni_util.h" +#include "jvm.h" + +#include "java_lang_Object.h" + +static JNINativeMethod methods[] = { + {"hashCode", "()I", (void *)&JVM_IHashCode}, + {"wait", "(J)V", (void *)&JVM_MonitorWait}, + {"notify", "()V", (void *)&JVM_MonitorNotify}, + {"notifyAll", "()V", (void *)&JVM_MonitorNotifyAll}, + {"clone", "()Ljava/lang/Object;", (void *)&JVM_Clone}, +}; + +JNIEXPORT void JNICALL +Java_java_lang_Object_registerNatives(JNIEnv *env, jclass cls) +{ + (*env)->RegisterNatives(env, cls, + methods, sizeof(methods)/sizeof(methods[0])); +} + +JNIEXPORT jclass JNICALL +Java_java_lang_Object_getClass(JNIEnv *env, jobject this) +{ + if (this == NULL) { + JNU_ThrowNullPointerException(env, NULL); + return 0; + } else { + return (*env)->GetObjectClass(env, this); + } +} +``` + +第二种不通过`javah`生成头文件, 利用 JVM 加载库文件会回调库文件中的 JNI_OnLoad 方法来实现本地方法的注册,JNI_OnLoad 方法的定义在`jdk/src/share/javavm/export/jni.h`。改造后的`HelloWorld.cpp`实现如下(不再需要头文件,其它照旧) + +```cpp + +#include "jni.h" +#include + +JNIEXPORT void JNICALL say_hello_world + (JNIEnv * env, jclass arg, jstring instring); + +JNIEXPORT jint JNICALL +JNI_OnLoad(JavaVM *vm, void *reserved){ + JNIEnv* env; + //判断当前JDK判断是否大于1.6 + if (vm->GetEnv((void **)&env, JNI_VERSION_1_6) != JNI_OK) { + return -1; + } + JNINativeMethod nm[1]; + nm[0].name = "say"; + nm[0].signature = "(Ljava/lang/String;)V"; + nm[0].fnPtr = (void*)say_hello_world; + //查找特定类 + jclass cls = env->FindClass("org/example/me/HelloWorld"); + if (cls == NULL){ + return JNI_ERR; + } + //注册本地方法 + if(env->RegisterNatives(cls, nm, 1)<0){ + return JNI_ERR; + } + //返回当前库文件要求的最低JDK版本 + return JNI_VERSION_1_6; +} + +JNIEXPORT void JNICALL say_hello_world + (JNIEnv * env, jclass arg, jstring instring) + { + //将java的String对象指向的字符串拷贝一份 + const jbyte *str = + (const jbyte *)env->GetStringUTFChars(instring, JNI_FALSE); + //打印字符串 + printf("Java_org_example_me_HelloWorld_say->%s\n",str); + //释放str指向的字符串内存 + env->ReleaseStringUTFChars(instring, (const char *)str); + return; + } +``` + +# JNI API +## Java 数据类型 +Java的数据类型分为基本类型(primitive type,又称原生类型或者原始类型)和引用类型(reference type),其中基本类型又分为数值类型,boolean 类型和 returnAddress 类型三类。returnAddress 类型在 Java 语言中没有对应的数据类型,由 JVM 使用表示指向某个字节码的指针。JVM 定义了 boolean 类型,但没有任何专供boolean 值使用的字节码指令,Java 语言表达式操作 boolea n值,都是使用 int 类型对应的字节码指令完成的,boolean 数组的访问修改共用 byte 数组的 baload 和 bstore 指令;JVM 规范中明确了 1 表示true,0 表示 false,但是未明确 boolean 类型的长度,Hotspot 使用 C++ 中无符号的 char 类型表示 boolean 类型,即boolean 类型占 8 位。数值类型分为整数类型和浮点数类型,如下: + +整数类型: + ++ byte 类型:值为 8 位有符号二进制补码整数 ++ short 类型:值为 16 位有符号二进制补码整数 ++ int 类型:值为 32 位有符号二进制补码整数 ++ long 类型:值为 64 位有符号二进制补码整数 ++ char 类型:值为 16 位无符号整数,用于表示指向多文种平面的 Unicode 码点,默认值是 Unicode 的 null码点(\u0000) + +浮点类型: + ++ float 类型:值为单精度浮点数集合中的元素(32 位) ++ double 类型:值为双精度浮点数集合中的元素(64 位) + +引用类型在 JVM 中有三种,类类型(class type),数组类型(array type)和接口类型(interface type),数组类型最外面的一维元素的类型称为该数组的组件类型,组件类型也可以是数组类型,如果组件类型不是元素类型则称为该数组的元素类型,引用类型其实就是 C++ 中的指针。默认开始压缩指针的情况下时 32 位,否则是 64 位。 + +JVM 规范中并没有强引用,软引用,弱引用和虚引用的概念,JVM 定义的引用就是强引用,软引用,弱引用和虚引用是 JDK 结合垃圾回收机制提供的功能支持而已。 + +## JNI 数据类型 +JNI 数据类型其实就是 Java 数据类型在 Hotspot 中的具体表示或者对应的 C/C++ 类型,类型的定义参考`hotspot/src/share/vm/prims/jni.h`中(从以下定义中可以看到所有的类型都继承自 _jobject) + +```c +/* + * JNI Types + */ + +#ifndef JNI_TYPES_ALREADY_DEFINED_IN_JNI_MD_H + +typedef unsigned char jboolean; +typedef unsigned short jchar; +typedef short jshort; +typedef float jfloat; +typedef double jdouble; + +typedef jint jsize; + +class _jobject {}; +class _jclass : public _jobject {}; +class _jthrowable : public _jobject {}; +class _jstring : public _jobject {}; +class _jarray : public _jobject {}; +class _jbooleanArray : public _jarray {}; +class _jbyteArray : public _jarray {}; +class _jcharArray : public _jarray {}; +class _jshortArray : public _jarray {}; +class _jintArray : public _jarray {}; +class _jlongArray : public _jarray {}; +class _jfloatArray : public _jarray {}; +class _jdoubleArray : public _jarray {}; +class _jobjectArray : public _jarray {}; + +typedef _jobject *jobject; +typedef _jclass *jclass; +typedef _jthrowable *jthrowable; +typedef _jstring *jstring; +typedef _jarray *jarray; +typedef _jbooleanArray *jbooleanArray; +typedef _jbyteArray *jbyteArray; +typedef _jcharArray *jcharArray; +typedef _jshortArray *jshortArray; +typedef _jintArray *jintArray; +typedef _jlongArray *jlongArray; +typedef _jfloatArray *jfloatArray; +typedef _jdoubleArray *jdoubleArray; +typedef _jobjectArray *jobjectArray; + +typedef jobject jweak; + +typedef union jvalue { + jboolean z; + jbyte b; + jchar c; + jshort s; + jint i; + jlong j; + jfloat f; + jdouble d; + jobject l; +} jvalue; + +struct _jfieldID; +typedef struct _jfieldID *jfieldID; + +struct _jmethodID; +typedef struct _jmethodID *jmethodID; + +/* Return values from jobjectRefType */ +typedef enum _jobjectType { + JNIInvalidRefType = 0, + JNILocalRefType = 1, + JNIGlobalRefType = 2, + JNIWeakGlobalRefType = 3 +} jobjectRefType; + + +#endif /* JNI_TYPES_ALREADY_DEFINED_IN_JNI_MD_H */ + +/* + * jboolean constants + */ + +#define JNI_FALSE 0 +#define JNI_TRUE 1 +``` + +对应关系如下表: + +| Java 数据类型 | JNI 数据类型 | x86 C++ 类型 | 长度 | +| --- | --- | --- | --- | +| boolean | jboolean | unsigned char | 8 | +| byte | jbyte | signed char | 8 | +| char | jchar | unsigned short | 16 | +| short | jshort | short | 16 | +| int | jint | int | 16 | +| long | jlong | long | 64 | +| float | jfloat | float | 32 | +| double | jdouble | double | 64 | +| String | jstring | _jstring * | 32/64(类指针,在64位机器上默认开启指针压缩,指针长度是32位,否则是64位,不过被压缩的指针仅限于指向堆对象的指针) | +| Class | jclass | _jclass * | | +| Throwable | jthrowable | _jthrowable * | | +| boolean[] | jbooleanArray | _jbooleanArray * | | +| byte[] | jbyteArray | _jbyteArray * | | +| char[] | jcharArray | _jcharArray * | | +| short[] | jshortArray | _jshortArray * | | +| int[] | jintArray | _jintArray * | | +| long[] | jlongArray | _jlongArray * | | +| float[] | jfloatArray | _jfloatArray * | | +| double[] | jdoubleArray | _jdoubleArray * | | +| Object[] | jobjectArray | _jobjectArray * | | + + +## API 定义 +本地代码调用 JNI API 的入口只有两个 JNIEnv 和 JavaVM 类,这两个都在`hotspot/src/share/vm/prims/jni.h`中定义。两者的实现其实是对结构体 JNINativeInterface_ 和 JNIInvokeInterface_ 的简单包装。注意 JVM 规范要求同一个线程内多次 JNI 调用接收的 JNIEnv 或者 JavaVM 指针都是同一个指针,且该指针只在该线程内有效,因此本地代码不能将该指针从当前线程传递到另一个线程中。 + +## 异常处理 +所有的 JNI 方法同大多数的 C 库函数一样不检查传入的参数的正确性,这点由调用方负责检查,如果参数错误可能导致 JVM 直接宕机。大多数情况下,JNI 方法通过返回一个特定的错误码或者抛出一个 Java 异常的方式报错,调用方可以通过`ExceptionOccurred()`方法判断是否发生了异常,如本地方法调用 Java 方法,判断 Java 方法执行期间是否发生了异常,并通过该方法获取异常的详细信息。 + +JNI 允许本地方法抛出或者捕获 Java 异常,未被本地方法捕获的异常会向上传递给方法的调用方。本地方法有两种方式处理异常,一种是直接返回,导致异常在调用本地方法的 Java 方法中被抛出;一种是调用`ExceptionClear()`方法清除这个异常,然后继续执行本地方法的逻辑。当异常产生,本地方法必须先清除该异常才能调用其他的JNI方法,当异常尚未处理时,只有下列方法可以被安全调用: + ++ ExceptionOccurred() ++ ExceptionDescribe() ++ ExceptionClear() ++ ExceptionCheck() ++ ReleaseStringChars() ++ ReleaseStringUTFChars() ++ ReleaseStringCritical() ++ Release<Type>ArrayElements() ++ ReleasePrimitiveArrayCritical() ++ DeleteLocalRef() ++ DeleteGlobalRef() ++ DeleteWeakGlobalRef() ++ MonitorExit() ++ PushLocalFrame() ++ PopLocalFrame() + +异常处理相关 API 如下: + ++ jint Throw(JNIEnv *env, jthrowable obj); 重新抛出Java异常 ++ jint ThrowNew(JNIEnv *env, jclass clazz,const char *message); 抛出一个指定类型和错误提示的异常 ++ jthrowable ExceptionOccurred(JNIEnv *env); 判断当前线程是否存在未捕获的异常,如果存在则返回该异常对象,不存在返回 NULL,仅限于 A 方法调用 B 方法接受后,A 方法调用此方法判断 B 方法是否抛出异常的场景,B 方法可以本地或者 Java 方法。 ++ void ExceptionDescribe(JNIEnv *env); 将当前线程的未捕获异常打印到系统标准错误输出流中如 stderr,如果该异常是 Throwable 的子类则实际调用该类的 printStackTrace 方法打印。注意执行过程中获取到异常实例 jthrowable 后就会调用 ExceptionClear 清除 ++ void ExceptionClear(JNIEnv *env); 清除当前线程的未捕获异常 ++ void FatalError(JNIEnv *env, const char *msg); 抛出一个致命异常,会直接导致 JVM 宕机 ++ jboolean ExceptionCheck(JNIEnv *env); 检查当前线程是否存在异常,不返回具体的异常对象,若存在返回 true + +以下是一个 JNI 异常示例测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +public class ThrowTest { + + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\ThrowTest.dll"); + } + + public static native void rethrowException(Exception e); + + public static native void handlerException(); + + public static void main(String[] args) { + handlerException(); + rethrowException(new UnsupportedOperationException("Unsurpported ThrowTest")); + } +} +``` + +```cpp +#include "ThrowTest.h" +#include + +JNIEXPORT void JNICALL Java_org_example_me_ThrowTest_rethrowException(JNIEnv * env, + jclass cls, jthrowable e) { + printf("Java_jni_ThrowTest_rethrowException\n"); + env->Throw(e); +} + +void throwNewException(JNIEnv * env) { + printf("throwNewException\n"); + jclass unsupportedExceptionCls = env->FindClass( + "java/lang/UnsupportedOperationException"); + env->ThrowNew(unsupportedExceptionCls, "throwNewException Test\n"); +} + +JNIEXPORT void JNICALL Java_org_example_me_ThrowTest_handlerException(JNIEnv * env, + jclass cls) { + throwNewException(env); + jboolean result = env->ExceptionCheck(); + printf("ExceptionCheck result->%d\n", result); + env->ExceptionDescribe(); + result = env->ExceptionCheck(); + printf("ExceptionCheck for ExceptionDescribe result->%d\n", result); + throwNewException(env); + jthrowable e = env->ExceptionOccurred(); + if (e) { + printf("ExceptionOccurred not null\n"); + } else { + printf("ExceptionOccurred null\n"); + } + env->ExceptionClear(); + printf("ExceptionClear\n"); + e = env->ExceptionOccurred(); + if (e) { + printf("ExceptionOccurred not null\n"); + } else { + printf("ExceptionOccurred null\n"); + } +} +``` + +## 引用类型操作 API +JNI 中关于引用只有一个枚举类型`hotspot/src/share/vm/prims/jni.h/_jobjectType`jobjectRefType 表示引用类型,仅限于本地方法使用,具体如下: + ++ JNIInvalidRefType 表示无效引用 ++ JNILocalRefType 表示本地引用,当本地方法返回后这些引用会自动回收掉,JVM在开始执行一个新的本地方法前会先执行 EnsureLocalCapacity 评估当前线程能否创建至少 16 个本地引用,然后调用 PushLocalFrame 创建一个新的用于保存该方法执行过程中的本地引用的 Frame,当本地方法结束调用 PopLocalFram 释放调用该 Frame,同时释放 Frame 中保存的即该本地方法执行过程中创建的所有本地引用。本地方法接受的 Java 对象类型参数或者返回值都是 JNILocalRefType 类型,JNI 允许开发者根据 JNILocalRefType 类型引用创建一个 JNIGlobalRefType 类型引用。大部分情形开发者依赖程序自动回收掉本地引用即可,但是部分情形下需要开发者手动显示释放本地引用,比如本地方法中访问了一个大的 Java 对象,这时会创建一个指向该对象的本地引用,如果本地方法已经不在使用该引用了,需要手动释放该引用,否则该引用会阻止垃圾回收器回收掉该对象;再比如通过本地方法遍历某个包含大量 Java 对象的数组,遍历的时候会为每个需要访问的 Java 对象创建一个本地引用,如果这些引用不手动释放而是等到方法结束才释放就会导致内存溢出问题。JNI 允许开发者在本地方法执行的任意时点删除本地引用从而允许垃圾回收器回收该引用指向的对象,为了确保这点,所有的 JNI 方法要求不能创建额外的本地引用,除非它是作为返回值。创建的本地引用只在当前线程内有效,因此不能将一个本地引用传递到另一个线程中 ++ JNIGlobalRefType 表示全局引用,必须通过 DeleteGlobalRef 方法删除才能释放该全局引用,从而允许垃圾回收器回收该引用指向的对象 ++ JNIWeakGlobalRefType 表示全局弱应用,只在 JVM 内部使用,跟 Java 中的弱引用一样,当垃圾回收器运行的时候,如果一个对象仅被弱全局引用所引用,则这个对象将会被回收,如果指向的对象被回收掉了,全局弱引用会指向 NULL,开发者可以通过 IsSameObject 方法判断弱引用是否等于 NULL 从而判断指向的对象是否被回收掉了。全局弱引用比 Java 中的 SoftReference 或者 WeakReference都要弱,如果都指向了同一个对象,则只有 SoftReference 或者 WeakReference 都被回收了,全局弱引用才会等于 NULL。全局弱应用跟 PhantomReferences 的交互不明确,应该避免两者间的交互 + +综上,这里的引用其实就是 Java 中 new 一个对象返回的引用,本地引用相当于 Java 方法中的局部变量对 Java 对象实例的引用,全局引用相当于 Java 类的静态变量对Java对象实例的引用,其本质跟 C++ 智能指针模板一样,是对象指针的二次包装,通过包装避免了该指针指向的对象被垃圾回收器回收掉,因此 JNI 中通过隐晦的引用访问 Java 对象的消耗比通过指针直接访问要高点,但是这是 JVM 对象和内存管理所必须的。 + +相关API如下: + ++ jobject NewGlobalRef(JNIEnv *env, jobject obj); 创建一个指向 obj 的全局引用,obj 可以是本地或者全局引用,全局引用只能通过显示调用 DeleteGlobalRef() 释放。 ++ void DeleteGlobalRef(JNIEnv *env, jobject globalRef); 删除一个全局引用 ++ jobject NewLocalRef(JNIEnv *env, jobject ref); 创建一个指向对象ref的本地引用 ++ void DeleteLocalRef(JNIEnv *env, jobject localRef); 删除一个本地引用 ++ jint EnsureLocalCapacity(JNIEnv *env, jint capacity); 评估当前线程是否能够创建指定数量的本地引用,如果可以返回 0,否则返回负数并抛出 OutOfMemoryError 异常。在执行本地方法前 JVM 会自动评估当前线程能否创建至少 16 个本地引用。JVM 允许创建超过评估数量的本地引用,如果创建过多导致 JVM 内存不足 JVM 会抛出一个 FatalError。 ++ jint PushLocalFrame(JNIEnv *env, jint capacity); 创建一个新的支持创建给定数量的本地引用的 Frame,如果可以返回 0,否则返回负数并抛出 OutOfMemoryError 异常。注意在之前的 Frame 中创建的本地引用在新的 Frame 中依然有效。 ++ jobject PopLocalFrame(JNIEnv *env, jobject result); POP 掉当前的本地引用 Frame,然后释放其中的所有本地引用,如果 result 不为 NULL,则返回该对象在前一个即当前 Frame 之前被 push 的 Frame 中的本地引用 ++ jweak NewWeakGlobalRef(JNIEnv *env, jobject obj); 创建一个指向对象 obj 的弱全局引用,jweak 是 jobject 的别名,如果 obj 是 null 则返回 NULL,如果内存不足则抛出 OutOfMemoryError 异常 ++ void DeleteWeakGlobalRef(JNIEnv *env, jweak obj); 删除弱全局引用 ++ jobjectRefType GetObjectRefType(JNIEnv* env, jobject obj); 获取某个对象引用的引用类型,JDK1.6 引入 + +PushLocalFrame 和 PopLocalFrame 两个都是配合使用,常见于 JNI 方法执行过程中产生的本地引用需要尽快释放掉。 NewGlobalRef 的使用场景通常是初始化 C/C++ 的全局属性,需要通过全局引用确保该属性指向的某个 Java 对象实例不被垃圾回收器回收掉,使用频次不多。 + +## 类和对象操作 API +类操作 API : + ++ jint GetVersion(JNIEnv *env); 获取当前 JVM 的 JNI 接口版本,该版本在 jni.cpp 中通过全局变量 CurrentVersion 指定 ++ jclass DefineClass(JNIEnv *env, const char *name, jobject loader,const jbyte *buf, jsize bufLen); 加载某个类,name 表示类名,loader 表示类加载器实例,buf 表示 class 文件的字节数据,bufLen 表示具体的字节数,此方法跟 ClassLoader 的实现基本一致 ++ jclass FindClass(JNIEnv *env, const char *name); 根据类名查找某个类,如果该类未加载则会调用合适的类加载器加载并链接该类。会优先使用定义了调用 FindClass 的本地方法的类的类加载器加载指定类名的类,如果是 JDK 标准类没有对应的类加载器则使用 ClassLoader.getSystemClassLoader 返回的系统类加载器加载。 ++ jclass GetSuperclass(JNIEnv *env, jclass clazz); 获取父类,如果该类是某个接口或者是 Object 则返回 NULL ++ jboolean IsAssignableFrom(JNIEnv *env, jclass clazz1,jclass clazz2); 判断 clazz1 能否安全的类型转换成 clazz2 + +对象操作 API: + ++ jobject AllocObject(JNIEnv *env, jclass clazz); 分配一个 Java 对象并返回该对象的本地引用,注意该方法并未调用任何构造方法 ++ jobject NewObject(JNIEnv *env, jclass clazz,jmethodID methodID, ...); 调用指定的构造方法创建一个 Java 对象并返回该对象的本地引用,最后的三个点表示该构造方法的多个参数 ++ jobject NewObjectA(JNIEnv *env, jclass clazz,jmethodID methodID, const jvalue *args); 同上,不过构造方法的入参是一个参数数组的指针 ++ jobject NewObjectV(JNIEnv *env, jclass clazz,jmethodID methodID, va_list args);同上,不过构造参数被放在va_list列表中 ++ jclass GetObjectClass(JNIEnv *env, jobject obj);获取Java对象所属的Java类 ++ jboolean IsInstanceOf(JNIEnv *env, jobject obj,jclass clazz); 判断某个对象是否是某个类的实例 ++ jboolean IsSameObject(JNIEnv *env, jobject ref1,jobject ref2); 判断两个引用是否引用相同的对象 + +以下是一个 JNI 类和对象测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + + +class A { + +} + +public class ObjTest extends A { + + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\ObjTest.dll"); + } + + public ObjTest() { + System.out.println("default"); + } + + public ObjTest(int age) { + System.out.println("param Construtor,age->" + age); + } + + public native static void test(Object a); + + public static void main(String[] args) { + test(new ObjTest()); + } +} +``` + +```cpp +#include "ObjTest.h" +#include + + +JNIEXPORT void JNICALL Java_org_example_me_ObjTest_test + (JNIEnv * env, jclass jcl,jobject obj){ + + jcl=env->GetObjectClass(obj); + jclass objACls=env->FindClass("org/example/me/A"); + jboolean result=env->IsAssignableFrom(jcl,objACls); + printf("IsAssignableFrom result->%d\n",result); + + jobject objTest=env->AllocObject(jcl); + printf("AllocObject succ \n"); + + jmethodID defaultConst=env->GetMethodID(jcl,"","()V"); + objTest=env->NewObject(jcl,defaultConst); + printf("default construct new succ \n"); + + jmethodID paramConst=env->GetMethodID(jcl,"","(I)V"); + objTest=env->NewObject(jcl,paramConst,12); + printf("param construct succ new \n"); + + jclass superCls=env->GetSuperclass(jcl); + jobject superObj=env->AllocObject(superCls); + result=env->IsInstanceOf(superObj,objACls); + printf("IsInstanceOf result->%d\n",result); + + jobject objTest2=env->NewLocalRef(objTest); + result=env->IsSameObject(objTest2,objTest); + printf("IsSameObject result->%d\n",result); + +} +``` + +## 字段和方法操作 API +JNI 中使用 jfieldID 来标识一个某个类的字段,jmethodID 来标识一个某个类的方法,jfieldID 和 jmethodID 都是根据他们的字段名(方法名)和描述符确定的,通过 jfieldID 读写字段或者通过 jmethodID 调用方法都会避免二次查找,但是这两个 ID 不能阻止该字段或者方法所属的类被卸载,如果类被卸载了则 jfieldID 和 jmethodID 失效了需要重新计算,因此如果希望长期使用 jfieldID 和 jmethodID 则需要保持对该类的持续引用,即建立对该类的全局引用,两者的定义在`hotspot/src/share/vm/prims/jni.h`中,这两个并非常规的字符串或者数字形式的 ID,而是一个指针,指向实际保存字段信息和方法的该类的 Klass,如下: + +```c +struct _jfieldID; +typedef struct _jfieldID *jfieldID; + +struct _jmethodID; +typedef struct _jmethodID *jmethodID; +``` + +相关的API如下: + ++ jfieldID GetFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取某个类的指定字段的jfieldID,如果该类未初始化则 GetFieldID 会触发其完成初始化,注意不能用该方法获取数组长度对应的jfieldID 进而获取数组长度而应该直接使用`GetArrayLength()`方法获取 ++ NativeType Get<type>Field(JNIEnv *env, jobject obj,jfieldID fieldID); 读取某个实例指定字段的值, NativeType 和 type 是一一对应的,具体如下: + +| Get<type>Field Routine Name | Native Type | +| --- | --- | +| GetObjectField() | jobject | +| GetBooleanField() | jboolean | +| GetByteField() | jbyte | +| GetCharField() | jchar | +| GetShortField() | jshort | +| GetIntField() | jint | +| GetLongField() | jlong | +| GetFloatField() | jfloat | +| GetDoubleField() | jdouble | + + ++ void Set<type>Field(JNIEnv *env, jobject obj, jfieldID fieldID,NativeType value); 改写某个实例指定字段的值,type 与 NativeType 的对应关系同上 ++ jmethodID GetMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取某个类的指定方法的 jmethodID,如果该类未初始化则此方法会触发该类完成初始化,获取的方法可以是该类从父类继承的方法。获取构造方法时,方法名必须是 ,返回类型必须是 void (V) ++ NativeType Call<type>Method(JNIEnv *env, jobject obj,jmethodID methodID, ...) ++ NativeType Call<type>MethodA(JNIEnv *env, jobject obj,jmethodID methodID, const jvalue *args) ++ NativeType Call<type>MethodV(JNIEnv *env, jobject obj,jmethodID methodID, va_list args); 上述三个都是调用指定实例对象的指定方法,不同的是方法入参的传递方法,同之前的 NewObject 系列方法。注意如果调用的方法是从父类继承的,无论是构造方法还是普通方法,使用的 jmethodID 都必须是从 obj 获取的,而不是从父类实例获取的。NativeType 和 type 是一一对应的,如下: + +| Call<type>Method Routine Name | Native Type | +| --- | --- | +| CallVoidMethod() CallVoidMethodA() CallVoidMethodV() | void | +| CalObjectMethod() CalObjectMethodA() CallObjectMethodV() | jobject | +| CallBooleanMethod() CallBooleanMethodA() CallBooleanMethodV() | jboolean | +| CallByteMethod() CalByteMethodA() CallByteMethodV() | jbyte | +| CallCharMethod() CallCharMethodA() CallCharMethodV() | jchar | +| CallShortMethod() CalShortMethodA() CallShortMethodV() | jshort | +| CallIntMethod() CallIntMethodA() CalIntMethodV() | jint | +| CallLongMethod() CallLongMethodA() CallLongMethodV() | jlong | +| CallFloatMethod() CallFloatMethodA() CallFloatMethodV() | jfloat | +| CallDoubleMethod() CallDoubleMethodA() CalDoubleMethodV() | jdouble | + + ++ NativeType CallNonvirtualMethod(JNIEnv *env, jobject obj,jclass clazz, jmethodID methodID, ...); ++ NativeType CallNonvirtualMethodA(JNIEnv *env, jobject obj,jclass clazz, jmethodID methodID, const jvalue *args); ++ NativeType CallNonvirtualMethodV(JNIEnv *env, jobject obj,jclass clazz, jmethodID methodID, va_list args); 同 Call<type>Method 都是调用指定类实例的指定方法,jmethodID 必须是从类实例的 jclass 获取,CallNonvirtualMethod 多了一个参数 jclass,但是 jclass 不一定是 obj 的 jclass,也可以是 obj 的父类的 jclass,无论哪一个,jmethodID 都是从指定的 jclass clazz获取的,最终调用的方法实现取决于 jmethodID。简单的说如果子类继承并改写了父类的方法,Call<type>Method 只能调用改写后的方法,而 CallNonvirtualMethod 即可以调用父类的原始方法,也可以调用子类的改写方法。这里的虚方法是 C++ 中的概念,C++ 中如果一个方法不是虚方法,子类继承并改写了该方法,则当子类实例向上强转成父类实例时调用的就是父类而非子类的改写方法。如果子类继承并改写的方法被定义成虚方法,则会通过虚函数表的方式保证当子类实例向上强转成父类实例时调用的依然是子类的改写方法,即所谓的多态。NativeType 和 type 的对应关系同 Call<type>Method + +注意上述方法和字段操作都是针对非静态的方法和字段的,对静态的方法和字段操作的 API 如下: + ++ jfieldID GetStaticFieldID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取指定静态方法的 ID,同上会触发未初始化类的初始化 ++ NativeType GetStaticField(JNIEnv *env, jclass clazz,jfieldID fieldID);读取指定静态字段的值, NativeType 和 type 的对应关系同 Get<type>Field ++ void SetStaticField(JNIEnv *env, jclass clazz,jfieldID fieldID, NativeType value); 改写指定静态字段的值,NativeType 和 type 的对应关系同 Set<type>Field ++ jmethodID GetStaticMethodID(JNIEnv *env, jclass clazz,const char *name, const char *sig); 获取指定静态方法的 ID,会导致未初始化类的初始化 ++ NativeType CallStaticMethod(JNIEnv *env, jclass clazz,jmethodID methodID, ...); ++ NativeType CallStaticMethodA(JNIEnv *env, jclass clazz,jmethodID methodID, jvalue *args); ++ NativeType CallStaticMethodV(JNIEnv *env, jclass clazz,jmethodID methodID, va_list args); 上述三个方法都是调用指定静态方法 + +注意在调用方法或者设置属性传参数时,需要密切关注参数类型,尤其是基本类型,只有字段或者方法声明明确使用了基本类型传参才能使用基本类型,否则必须通过 Integer 等包装类的构造方法将基本类型转换为对应包装类的对象;另一个需要注意的就是可变参数类型,Java 中可以传入数量可变的参数,这些参数最终会被编译器转换成一个数组,即这类参数类型实际是一个数组,因此传参时不能跟 Java 一样,而需要显示的传入一个数组类型。以下是一个 JNI 字段和方法测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + + +import java.util.Arrays; +import java.util.List; + +class SuperA { + + public void say() { + System.out.println("say SuperA"); + } + + public void add(int a, int b) { + System.out.println("SuperA add a->" + a + ",b->" + b + ",result->" + (a + b)); + } + +} + +public class FiledMethodTest extends SuperA { + + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\FiledMethodTest.dll"); + } + + private List list; + + private boolean boolField; + + private byte byteField; + + private char charField; + + private short shortField; + + private int intField; + + private long longField; + + private float floatField; + + private double doubleField; + + private static int staticFiled; + + public FiledMethodTest() { + list = Arrays.asList(1, 2); + boolField = false; + byteField = 11; + charField = 'c'; + shortField = 12; + intField = 13; + longField = 14; + floatField = 15.0f; + doubleField = 16.0; + staticFiled = 17; + } + + @Override + public void say() { + System.out.println("say FiledMethodTest"); + } + + + public List getList() { + return list; + } + + private static void printList(List list) { + if (list == null) { + System.out.println("list is null"); + } else { + System.out.println("list->" + list); + } + } + + private void printObj() { + System.out.println("FiledMethodTest{" + + "list=" + list + + ", boolField=" + boolField + + ", byteField=" + byteField + + ", charField=" + charField + + ", shortField=" + shortField + + ", intField=" + intField + + ", longField=" + longField + + ", floatField=" + floatField + + ", doubleField=" + doubleField + + ", staticFiled=" + staticFiled + + '}'); + } + + public native static void test(FiledMethodTest a); + + public static void main(String[] args) throws Exception { + FiledMethodTest a = new FiledMethodTest(); + System.out.println("start test"); + test(a); + } +} +``` + +```cpp +#include "FiledMethodTest.h" +#include + +JNIEXPORT void JNICALL Java_org_example_me_FiledMethodTest_test(JNIEnv * env, jclass jcl, + jobject obj) { + + // 注意字段和方法描述符中如果是其他的类,必须带上后面的分号 + jfieldID listId = env->GetFieldID(jcl, "list", "Ljava/util/List;"); + jfieldID boolFieldId = env->GetFieldID(jcl, "boolField", "Z"); + jfieldID byteFieldId = env->GetFieldID(jcl, "byteField", "B"); + jfieldID charFieldId = env->GetFieldID(jcl, "charField", "C"); + jfieldID shortFieldId = env->GetFieldID(jcl, "shortField", "S"); + jfieldID intFieldId = env->GetFieldID(jcl, "intField", "I"); + jfieldID longFieldId = env->GetFieldID(jcl, "longField", "J"); + jfieldID floatFieldId = env->GetFieldID(jcl, "floatField", "F"); + jfieldID doubleFieldId = env->GetFieldID(jcl, "doubleField", "D"); + jfieldID staticFiledId = env->GetStaticFieldID(jcl, "staticFiled", "I"); + + jmethodID printListId = env->GetStaticMethodID(jcl, "printList", + "(Ljava/util/List;)V"); + jmethodID printObjId = env->GetMethodID(jcl, "printObj", "()V"); + jmethodID getListId = env->GetMethodID(jcl, "getList", + "()Ljava/util/List;"); + jmethodID sayId=env->GetMethodID(jcl,"say","()V"); + jmethodID addId=env->GetMethodID(jcl,"add","(II)V"); + + jclass arrayListCls = env->FindClass("java/util/ArrayList"); + jmethodID list_costruct = env->GetMethodID(arrayListCls, "", "()V"); + jmethodID listAddId = env->GetMethodID(arrayListCls, "add", + "(Ljava/lang/Object;)Z"); + + jclass arraysCls=env->FindClass("java/util/Arrays"); + jmethodID asListId=env->GetStaticMethodID(arraysCls,"asList","([Ljava/lang/Object;)Ljava/util/List;"); + + jclass intergerCls = env->FindClass("java/lang/Integer"); + jmethodID interger_costruct = env->GetMethodID(intergerCls, "", + "(I)V"); + + // 如果找不到方法或者字段不会直接报错,需要手动执行异常检查 + if (env->ExceptionCheck()) { + jthrowable err = env->ExceptionOccurred(); + env->Throw(err); + } + + jobject listObj = env->GetObjectField(obj, listId); + env->CallStaticVoidMethod(jcl, printListId, listObj); + + jobject listObj2 = env->CallObjectMethod(obj, getListId); + jboolean issame = env->IsSameObject(listObj, listObj2); + printf("issame->%d\n", issame); + + jboolean boolField = env->GetBooleanField(obj, boolFieldId); + printf("boolField->%d\n", boolField); + + jbyte byteField = env->GetByteField(obj, byteFieldId); + printf("byteField->%d\n", byteField); + + jchar charField = env->GetCharField(obj, charFieldId); + printf("charField->%d\n", charField); + + jshort shortField = env->GetShortField(obj, shortFieldId); + printf("shortField->%d\n", shortField); + + jint intField = env->GetIntField(obj, intFieldId); + printf("intField->%d\n", intField); + + jlong longField = env->GetLongField(obj, longFieldId); + printf("longField->%d\n", longField); + + jfloat floatField = env->GetFloatField(obj, floatFieldId); + printf("floatField->%f\n", floatField); + + jdouble doubleField = env->GetDoubleField(obj, doubleFieldId); + printf("doubleField->%f\n", doubleField); + + jint staticFiled = env->GetStaticIntField(jcl, staticFiledId); + printf("staticFiled->%d\n", staticFiled); + + // JNI中没有对基本类型的自动装箱拆箱机制,必要时需要手动包装 + jobject intObj = env->NewObject(intergerCls, interger_costruct, 3); + jobject intObj2 = env->NewObject(intergerCls, interger_costruct, 4); + + // jobject newList = env->NewObject(arrayListCls, list_costruct); + // add方法接受的参数实际是一个对象,因此需要手动包装 + // env->CallBooleanMethod(newList, listAddId, intObj); + // env->CallBooleanMethod(newList, listAddId, intObj2); + // Arrays.asList方法在Java中是不可变参数,实际多个参数最终会被转变成数组,因此这里的入参必须是数组 + jobjectArray objArray=env->NewObjectArray(2,intergerCls,intObj); + env->SetObjectArrayElement(objArray,1,intObj2); + jobject newList=env->CallStaticObjectMethod(arraysCls,asListId,objArray); + + env->SetObjectField(obj, listId, newList); + env->SetBooleanField(obj, boolFieldId, 1); + env->SetByteField(obj, byteFieldId, 21); + env->SetCharField(obj, charFieldId, 'd'); + env->SetShortField(obj, shortFieldId, 22); + env->SetIntField(obj, intFieldId, 23); + env->SetLongField(obj, longFieldId, 24); + env->SetFloatField(obj, floatFieldId, 25.0); + env->SetDoubleField(obj, doubleFieldId, 26.0); + env->SetStaticIntField(jcl, staticFiledId, 27); + + env->CallVoidMethod(obj, printObjId); + + jclass superCls=env->GetSuperclass(jcl); + jmethodID superSayId=env->GetMethodID(superCls,"say","()V"); + // 如果子类没有覆写则使用父类的实现,否则使用子类覆写的实现 + env->CallVoidMethod(obj,sayId); + env->CallVoidMethod(obj,addId,3,4); + // 使用 jclass 的方法实现,可以是子类的也可以是父类的,取决于后面的 methodId + env->CallNonvirtualVoidMethod(obj,jcl,sayId); + env->CallNonvirtualVoidMethod(obj,jcl,superSayId); + env->CallNonvirtualVoidMethod(obj,superCls,sayId); + env->CallNonvirtualVoidMethod(obj,superCls,superSayId); + +} +``` + +上述示例中 printObj 和 printList 方法都是私有方法,但是通过 JNI 接口一样可以正常调用,说明 JNI 无视 Java的访问权限控制,可以访问任何方法和字段。 + +## 字符串 API +Java 内部使用 UTF-16 来表示字符,JNI 允许使用 UTF-16 的字符串构建 java.lang.String 对象,也允许使用 UTF-8 字符串构建 java.lang.String 对象。但是 JNI 使用改良版的 UTF-8 字符串,与标准 UTF-8 主要有两个不同,第一个表示 null 的 char 0 被编译成 2 个字节而非一个字节,这表示改良版的 UTF-8 编码不会有嵌入的 null 字符;第二个,改良版的 UTF-8 只使用 1 个,2 个或者 3个 字节形式的 UTF-8 字符编码,不支持 4 字节形式的,会使用替代的 1 或者 2 或者 3 字节形式的编码。 + +相关 API 如下: + ++ jstring NewString(JNIEnv *env, const jchar *unicodeChars,jsize len); 用 UTF-16 字符数组构建一个 jstringjsize ++ GetStringLength(JNIEnv *env, jstring string); 获取 UTF-16 字符串的字符数量 ++ const jchar * GetStringChars(JNIEnv *env, jstring string,jboolean *isCopy); 获取 UTF-16字 符串的字符数组,如果 isCopy 不是 NULL,则当 JVM 返回的字符数组是复制自字符串时,isCopy 被置为 TRUE,如果是返回指向字符串的一个指针时,则 isCopy 被置为 FALSE ++ void ReleaseStringChars(JNIEnv *env, jstring string,const jchar *chars); 通知 JVM 释放 chars 指向的字符数组 ++ void GetStringRegion(JNIEnv *env, jstring str, jsize start, jsize len, jchar *buf);将 str 中指定范围的字符复制到 buf 中 ++ const jchar * GetStringCritical(JNIEnv *env, jstring string, jboolean *isCopy); ++ void ReleaseStringCritical(JNIEnv *env, jstring string, const jchar *carray); 这两个方法的用途同 GetStringChars 和 ReleaseStringCritical,不同的是这两个方法的使用更严格。这两个方法中间的区域称为关键区,关键区内不能调用其他的 JNI 方法,不能执行类似读取文件这类会阻塞当前线程的操作 + +上面的 API 都是针对 UTF-16 字符串,针对通用的 UTF-8 字符串的 API 如下,函数的功能都一样,最大的变化就是从 jchar 换成了 char: + ++ jstring NewStringUTF(JNIEnv *env, const char *bytes); 使用 UTF-8 编码后的 char 数组构建一个新的 java.lang.String 对象 ++ jsize GetStringUTFLength(JNIEnv *env, jstring string); 返回一个字符串用 UTF-8 编码后的字符数组的长度,因为 UTF-8 是变长的,所以字符数组的长度不一定等于字符的长度 ++ const char * GetStringUTFChars(JNIEnv *env, jstring string,jboolean *isCopy); 获取一个字符串用 UTF-8 编码后的字符数组,同 GetStringChars,可以通过 isCopy 判断返回的字符数组是否复制自原数组 ++ void ReleaseStringUTFChars(JNIEnv *env, jstring string,const char *utf); 通知 JVM 释放 utf 指向的字符数组 ++ void GetStringUTFRegion(JNIEnv *env, jstring str, jsize start, jsize len, char *buf); 将 str 中指定范围的 UTF-16 字符用 UTF-8 编码后复制到 buf 中 + +以下是一个 JNI 字符串测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +public class StringTest { + + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\StringTest.dll"); + } + + public static native void stringTest(String test); + + public static void printStr(String test) { + System.out.println("str length:" + test.length()); + System.out.println("str:" + test); + } + + public static void main(String[] args) { + String test = "Hello World 中文测试"; + stringTest(test); + printStr(test); + } + +} +``` + +```cpp +#include "StringTest.h" +#include +#include + +typedef unsigned char u_char; + +int unicode_length(const char* str); + +void convert_to_unicode(const char* utf8_str, jchar* unicode_str, int unicode_length); + +char* next(const char* str, jchar* value); + +int utf8_length(const jchar* base, int length); + +u_char* utf8_write(u_char* base, jchar ch); + +char* convert_to_utf8(const jchar* base, u_char* result,int length); + + + +JNIEXPORT void JNICALL Java_org_example_me_StringTest_stringTest + (JNIEnv * env, jclass jcl, jstring jstr){ + + jsize size=env->GetStringLength(jstr); + printf("GetStringLength length->%d\n",size); + + jsize size2=env->GetStringUTFLength(jstr); + printf("GetStringUTFLength length->%d\n",size2); + + jboolean isCopy=1; + const jchar* jcharStr=env->GetStringChars(jstr, &isCopy); + jstring testStr=env->NewString(jcharStr+2, size-4); + const char* charStr=env->GetStringUTFChars(testStr,&isCopy); + printf("GetStringChars str->%s,isCopy->%d\n",charStr,isCopy); + + int utf8_len=utf8_length(jcharStr, (int)size)+1; + u_char * utf8Char=(u_char*)malloc(sizeof(u_char)*utf8_len); + convert_to_utf8(jcharStr, utf8Char, size); + printf("convert_to_utf8 Test str->%s\n",utf8Char); + free(utf8Char); + + //ReleaseStringChars底层调用的还是free,因此jcharStr不会变成NULL,只是其指向的内存被标记成释放了,继续访问结果不确定 + env->ReleaseStringChars(jstr, jcharStr); + printf("ReleaseStringChars str->%d\n",jcharStr==NULL); + + jstring testStr2=env->NewStringUTF(charStr+2); + //释放charStr原来指向的字符串 + env->ReleaseStringUTFChars(testStr, charStr); + //重新赋值 + charStr=env->GetStringUTFChars(testStr2,&isCopy); + printf("GetStringUTFChars str->%s,isCopy->%d\n",charStr,isCopy); + env->ReleaseStringUTFChars(testStr2, charStr); + printf("ReleaseStringUTFChars str->%s\n",charStr); + + jchar newJcharStr[4]={}; + env->GetStringRegion(jstr, 11, 4, newJcharStr); + testStr=env->NewString(newJcharStr, 4); + charStr=env->GetStringUTFChars(testStr,&isCopy); + printf("GetStringRegion str->%s,isCopy->%d\n",charStr,isCopy); + env->ReleaseStringUTFChars(testStr, charStr); + + char newCharStr[4]={}; + //注意底层实现不会校验newCharStr的长度是否够,调用方需要确保足够的容量 + env->GetStringUTFRegion(jstr, 11, 4, newCharStr); + printf("GetStringUTFRegion str->%s\n",newCharStr); + + jmethodID printTestId=env->GetStaticMethodID(jcl, "printStr", "(Ljava/lang/String;)V"); + + char* newStr="NewStringTest 中文测试"; + //创建新字符串,可执行编码必须是UTF-8,否则打印的是乱码 + jstring test=env->NewStringUTF(newStr); + env->CallStaticVoidMethod(jcl, printTestId,test); + int len=unicode_length(newStr); + jchar* unicodeChar=(jchar*)malloc(len*sizeof(jchar)); + convert_to_unicode(newStr, unicodeChar, len); + //使用NewString的话需要手动将UTF-8字符串转换成UTF-16字符串 + test=env->NewString(unicodeChar,(jsize)len); + printf("convert_to_unicode test\n"); + env->CallStaticVoidMethod(jcl, printTestId,test); + free(unicodeChar); + + + if(env->ExceptionCheck()){ + env->ExceptionDescribe(); + } +} + +int unicode_length(const char* str) { + int num_chars = 0; + for (const char* p = str; *p; p++) { + if (((*p) & 0xC0) != 0x80) { + num_chars++; + } + } + return num_chars; +} + +void convert_to_unicode(const char* utf8_str, jchar* unicode_str, int unicode_length) { + unsigned char ch; + const char *ptr = utf8_str; + int index = 0; + + /* ASCII case loop optimization */ + for (; index < unicode_length; index++) { + if((ch = ptr[0]) > 0x7F) { break; } + unicode_str[index] = ch; + ptr = (const char *)(ptr + 1); + } + + for (; index < unicode_length; index++) { + ptr = next(ptr, &unicode_str[index]); + } +} + +char* next(const char* str, jchar* value) { + unsigned const char *ptr = (const unsigned char *)str; + unsigned char ch, ch2, ch3; + int length = -1; /* bad length */ + jchar result; + switch ((ch = ptr[0]) >> 4) { + default: + result = ch; + length = 1; + break; + + case 0x8: case 0x9: case 0xA: case 0xB: case 0xF: + /* Shouldn't happen. */ + break; + + case 0xC: case 0xD: + /* 110xxxxx 10xxxxxx */ + if (((ch2 = ptr[1]) & 0xC0) == 0x80) { + unsigned char high_five = ch & 0x1F; + unsigned char low_six = ch2 & 0x3F; + result = (high_five << 6) + low_six; + length = 2; + break; + } + break; + + case 0xE: + /* 1110xxxx 10xxxxxx 10xxxxxx */ + if (((ch2 = ptr[1]) & 0xC0) == 0x80) { + if (((ch3 = ptr[2]) & 0xC0) == 0x80) { + unsigned char high_four = ch & 0x0f; + unsigned char mid_six = ch2 & 0x3f; + unsigned char low_six = ch3 & 0x3f; + result = (((high_four << 6) + mid_six) << 6) + low_six; + length = 3; + } + } + break; + } /* end of switch */ + + if (length <= 0) { + *value = ptr[0]; /* default bad result; */ + return (char*)(ptr + 1); // make progress somehow + } + + *value = result; + + // The assert is correct but the .class file is wrong + // assert(UNICODE::utf8_size(result) == length, "checking reverse computation"); + return (char *)(ptr + length); +} + +int utf8_length(const jchar* base, int length) { + int result = 0; + for (int index = 0; index < length; index++) { + jchar c = base[index]; + if ((0x0001 <= c) && (c <= 0x007F)) result += 1; + else if (c <= 0x07FF) result += 2; + else result += 3; + } + return result; +} + +u_char* utf8_write(u_char* base, jchar ch) { + if ((ch != 0) && (ch <=0x7f)) { + base[0] = (u_char) ch; + return base + 1; + } + + if (ch <= 0x7FF) { + /* 11 bits or less. */ + unsigned char high_five = ch >> 6; + unsigned char low_six = ch & 0x3F; + base[0] = high_five | 0xC0; /* 110xxxxx */ + base[1] = low_six | 0x80; /* 10xxxxxx */ + return base + 2; + } + /* possibly full 16 bits. */ + char high_four = ch >> 12; + char mid_six = (ch >> 6) & 0x3F; + char low_six = ch & 0x3f; + base[0] = high_four | 0xE0; /* 1110xxxx */ + base[1] = mid_six | 0x80; /* 10xxxxxx */ + base[2] = low_six | 0x80; /* 10xxxxxx */ + return base + 3; +} + +char* convert_to_utf8(const jchar* base, u_char* result,int length) { + u_char* p = result; + for (int index = 0; index < length; index++) { + p = utf8_write(p, base[index]); + } + *p = '\0'; + return (char*) result; +} +``` + +上述示例中 UTF-16 编码和 UTF-8 编码之间的转换的代码参考`hotspot/src/share/vm/utilities/utf8.cpp` + +## 数组操作 API +数组 API 说明如下: + ++ jsize GetArrayLength(JNIEnv *env, jarray array); 获取字符串长度,适用于所有元素类型的数组 ++ jobjectArray NewObjectArray(JNIEnv *env, jsize length,jclass elementClass, jobject initialElement); 创建一个指定长度 length 和指定类型 elementClass 的数组,initialElement 为该数组的 0 号元素 ++ jobject GetObjectArrayElement(JNIEnv *env,jobjectArray array, jsize index); 获取指定索引 index 处的数组元素 ++ void SetObjectArrayElement(JNIEnv *env, jobjectArray array,jsize index, jobject value); 将数组的指定索引 index 的元素设置为指定对象 value + +注意上述 API 除 GetArrayLength 外都是针对对象数组,对 int 等基本类型的数组的 API 如下: + ++ ArrayType NewArray(JNIEnv *env, jsize length); 创建一个指定长度 length 的基本类型数组,ArrayType 与 PrimitiveType 的对应关系如下: + +| NewArray Routine | Array type | +| --- | --- | +| NewBooleanArray() | jbooleanArray | +| NewByteArray() | jbyteArray | +| NewCharArray() | jcharArray | +| NewShortArray() | jhortArray | +| NewIntArray() | jntArray | +| NewLongArray() | jlongArray | +| NewFloatArray() | jfloatArray | +| NewDoubleArray() | jdoubleArray | + + ++ NativeType *Get<PrimitiveType>ArrayElements(JNIEnv *env,ArrayType array, jboolean *isCopy); 获取基本类型数组的元素数组,isCopy 表示返回的元素数组是否复制自原数组,如果是复制自原数组则 isCopy 被设置成 1,否则设置成 false。返回的数组指针一直是有效的,直到调用了Release<PrimitiveType>ArrayElements() 方法。对返回的数组元素的修改不会同步到原数组,除非调用了 Releas<PrimitiveType>ArrayElements 方法。NativeType,PrimitiveType 和 ArrayType 三者的对应关系如下: + +| NewArray Routine | Array type | Native type | +| --- | --- | --- | +| GetBooleanArrayElements() | jbooleanArray | jboolean | +| GetByteArrayElements() | jbyteArray | jbyte | +| GetCharArrayElements() | jcharArray | jchar | +| GetShortArrayElements() | jshortArray | jshort | +| GetIntArrayElements() | jntArray | jnt | +| GetLongArrayElements() | jlongArray | jlong | +| GetFloatArrayElements() | jfloatArray | jfloat | +| GetDoubleArrayElements() | jdoubleArray | jdouble | + + ++ void Release<PrimitiveType>ArrayElements(JNIEnv *env,ArrayType array, NativeType *elems, jint mode); 通知 JVM 本地代码不在需要 elems 指向的数组,如果 elems 不是原数组 array 的一份复制则后面的 mode 参数无效。mode 有三个取值,通常传递 0,这时程序会将 elems 指向的数组元素写回到原数组 array,即对 elems 的修改会同步到原数组 array,然后释放掉 elems 占用的内存。mode 另外两个选项分别是 JNI_COMMIT 和 JNI_ABORT,JNI_COMMIT 也会将 elems 写回到 array 中,但是不会释放 elems 占用的内存,JNI_ABORT 与之相反,会释放 elems 占用的内存,但是不会将 elems 写回到 array 中。NativeType,PrimitiveType 和 ArrayType 三者的对应关系同上。 ++ void Get<PrimitiveType>ArrayRegion(JNIEnv *env, ArrayType array,jsize start, jsize len, NativeType *buf); 将基本类型数组的一部分元素拷贝到对应的 JNI 元素类型数组中。NativeType,PrimitiveType 和ArrayType 三者的对应关系如下: + +| Get<PrimitiveType>ArrayRegion Routine | Array type | Native type | +| --- | --- | --- | +| GetBooleanArrayRegion() | jbooleanArray | jboolean | +| GetByteArrayRegion() | jbyteArray | jbyte | +| GetCharArrayRegion() | jcharArray | jchar | +| GetShortArrayRegion() | jshortArray | jshort | +| GetIntArrayRegion() | jntArray | jnt | +| GetLongArrayRegion() | jlongArray | jlong | +| GetFloatArrayRegion() | jfloatArray | jfloat | +| GetDoubleArrayRegion() | jdoubleArray | jdouble | + + ++ void Set<PrimitiveType>ArrayRegion(JNIEnv *env, ArrayType array,jsize start, jsize len, const NativeType *buf); 将与基本类型元素数组对应的 JNI 元素类型数组的值写回到基本类型元素数组中。 NativeType,PrimitiveType 和 ArrayType 三者的对应关系同上。 ++ void * GetPrimitiveArrayCritical(JNIEnv *env, jarray array, jboolean *isCopy); ++ void ReleasePrimitiveArrayCritical(JNIEnv *env, jarray array, void *carray, jint mode); 这两个函数的功能和 Get/Release<primitivetype>ArrayElements 基本一样,不过跟字符串操作 Get/ReleaseStringCritical 一样,这两个函数必须配合使用,这两个函数构成一个关键区,在关键区内的代码不能调用其他的 JNI 函数,也不能执行任何可能导致当前线程阻塞的操作,如读取文件等。 + +以下是一个 JNI 数组测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +public class ArrayTest { + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\ArrayTest.dll"); + } + + public native static void primArrayTest(int[] a); + + public native static void objArrayTest(String[] a); + + public static void main(String[] args) { + primArrayTest(new int[]{1, 2, 3, 4, 5, 6, 7, 8, 9}); + System.out.println("================================"); + objArrayTest(new String[]{"a", "b", "c", "d", "e"}); + } +} +``` + +```cpp +#include "ArrayTest.h" +#include + +JNIEXPORT void JNICALL Java_org_example_me_ArrayTest_primArrayTest + (JNIEnv * env, jclass jcl, jintArray intArray){ + + jboolean iscopy=1; + + jsize len=env->GetArrayLength(intArray); + printf("GetArrayLength len->%d\n",len); + + jint * intptr=env->GetIntArrayElements(intArray,&iscopy); + printf("GetIntArrayElements int[2]->%d,iscopy->%d\n",intptr[2],iscopy); + + intptr[2]=22; + jclass arraysCls=env->FindClass("java/util/Arrays"); + jmethodID convertIntArraysId=env->GetStaticMethodID(arraysCls,"toString","([I)Ljava/lang/String;"); + jstring result=(jstring)env->CallStaticObjectMethod(arraysCls,convertIntArraysId,intArray); + const char* resultStr=env->GetStringUTFChars(result,&iscopy); + printf("no release modify result->%s,iscopy->%d\n",resultStr,iscopy); + + //释放完后intptr对应的复制数组被释放了,但是依然可以通过intptr访问 + env->ReleaseIntArrayElements(intArray,intptr,0); + printf("ReleaseIntArrayElements int[2]->%d\n",intptr[2]); + + result=(jstring)env->CallStaticObjectMethod(arraysCls,convertIntArraysId,intArray); + resultStr=env->GetStringUTFChars(result,&iscopy); + printf("ReleaseIntArrayElements modify result->%s\n",resultStr); + + + jint intArrayTest[4]={}; + env->GetIntArrayRegion(intArray,3,4,intArrayTest); + jintArray jintArrayTest=env->NewIntArray(4); + env->SetIntArrayRegion(jintArrayTest,0,4,intArrayTest); + + result=(jstring)env->CallStaticObjectMethod(arraysCls,convertIntArraysId,jintArrayTest); + resultStr=env->GetStringUTFChars(result,&iscopy); + printf("SetIntArrayRegion result->%s\n",resultStr); +} + + +JNIEXPORT void JNICALL Java_org_example_me_ArrayTest_objArrayTest + (JNIEnv * env, jclass jcl, jobjectArray objArray){ + jboolean iscopy=1; + + jsize len=env->GetArrayLength(objArray); + printf("GetArrayLength len->%d\n",len); + + jobject obj=env->GetObjectArrayElement(objArray,0); + jclass stringCls=env->FindClass("java/lang/String"); + jboolean result=env->IsInstanceOf(obj,stringCls); + printf("IsInstanceOf result->%d\n",result); + + if(result){ + jstring str=(jstring)obj; + const char* charStr=env->GetStringUTFChars(str,&iscopy); + printf("str[0] result->%s,iscopy->%d\n",charStr,iscopy); + + jstring s=env->NewStringUTF("test"); + jstring s2=env->NewStringUTF("test2"); + env->SetObjectArrayElement(objArray,2,s); + env->SetObjectArrayElement(objArray,3,s2); + + jclass arraysCls=env->FindClass("java/util/Arrays"); + jmethodID convertIntArraysId=env->GetStaticMethodID(arraysCls,"toString","([Ljava/lang/Object;)Ljava/lang/String;"); + jstring result=(jstring)env->CallStaticObjectMethod(arraysCls,convertIntArraysId,objArray); + const char* resultStr=env->GetStringUTFChars(result,&iscopy); + printf("modify result->%s\n",resultStr); + + jobjectArray newObjArray=env->NewObjectArray(2,stringCls,s); + env->SetObjectArrayElement(newObjArray,1,s2); + result=(jstring)env->CallStaticObjectMethod(arraysCls,convertIntArraysId,newObjArray); + resultStr=env->GetStringUTFChars(result,&iscopy); + printf("newObjArray result->%s,iscopy->%d\n",resultStr,iscopy); + + } +} +``` + +## Monitor 操作 API +Monitor 相关 API 如下: + ++ jint MonitorEnter(JNIEnv *env, jobject obj); 获取一个对象监视锁,obj 不能为空,返回 0 表示获取成功,返回负数表示获取失败。如果 obj 的对象监视锁已经被占用,则当前线程会一直等待直到锁被释放并抢占成功。获取成功后可以重复获取,对象监视锁会维护一个成功获取次数,每次成功获取都会增加该次数,调用 MonitorExit 会减少该次数,当次数变成 0 会释放该对象监视锁。注意通过 MonitorEnter 获取的对象监视锁不能通过 monitorexit 指令(该指令对应 synchronized 关键字)释放,只能通过 MonitorExit 或者 DetachCurrentThread 释放。 ++ jint MonitorExit(JNIEnv *env, jobject obj); 减少当前线程成功获取对象监视锁的次数,当次数变成 0 时,释放当前线程占用的对象监视锁。注意不能使用 MonitorExit 释放通过 synchronized 关键字或者monitorenter 虚拟机指令获取的对象监视锁。 + +以下是一个 JNI Monitor 测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.CyclicBarrier; + +public class MonitorTest { + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\MonitorTest.dll"); + } + + public static native void monitorTest(Object test); + + public static void main(String[] args) throws Exception { + CyclicBarrier cyclicBarrier = new CyclicBarrier(5); + CountDownLatch countDownLatch = new CountDownLatch(5); + Object monitor = new Object(); + System.out.println("begin test"); + for (int i = 0; i < 5; i++) { + MonitorTest.Worker worker = new Worker(monitor, cyclicBarrier, countDownLatch); + worker.start(); + } + countDownLatch.await(); + System.out.println("end test"); + } + + static class Worker extends Thread { + + private Object monitor; + + private CyclicBarrier cyclicBarrier; + + private CountDownLatch countDownLatch; + + public Worker(Object monitor, CyclicBarrier cyclicBarrier, CountDownLatch countDownLatch) { + this.monitor = monitor; + this.cyclicBarrier = cyclicBarrier; + this.countDownLatch = countDownLatch; + } + + @Override + public void run() { + super.run(); + try { + System.out.println("等待执行,thread ID->" + Thread.currentThread().getName()); + cyclicBarrier.await(); + System.out.println("开始执行,thread ID->" + Thread.currentThread().getName()); + monitorTest(monitor); + System.out.println("执行完成,thread ID->" + Thread.currentThread().getName()); + } catch (Exception e) { + e.printStackTrace(); + } finally { + countDownLatch.countDown(); + } + } + } +} +``` + +```cpp +#include "MonitorTest.h" +#include + +JNIEXPORT void JNICALL Java_org_example_me_MonitorTest_monitorTest(JNIEnv * env, + jclass jcl, jobject obj) { + jclass threadJcl = env->FindClass("java/lang/Thread"); + jmethodID currentThreadId = env->GetStaticMethodID(threadJcl, + "currentThread", "()Ljava/lang/Thread;"); + jmethodID getNameId=env->GetMethodID(threadJcl, "getName", "()Ljava/lang/String;"); + jmethodID sleepId = env->GetStaticMethodID(threadJcl, "sleep", + "(J)V"); + jobject currentThreadObj=env->CallStaticObjectMethod(threadJcl, currentThreadId); + jstring threadName=(jstring)env->CallObjectMethod(currentThreadObj, getNameId); + const char * threadNameStr=env->GetStringUTFChars(threadName, NULL); + for (int i = 0; i < 5; i++) { + jint result = env->MonitorEnter(obj); + if (result == 0) { + printf("MonitorEnter succ,result->%d,threadName->%s\n", result,threadNameStr); + env->CallStaticVoidMethod(jcl, sleepId, 1000); + result = env->MonitorExit(obj); + printf("MonitorExit,result->%d,threadName->%s\n", result,threadNameStr); + break; + } + } +} +``` + +## NIO 操作 API +NIO 相关 API 一共 3 个,是 JDK1.4 引入的,所有 JVM 实现必须提供这三个方法,但是不一定实现了,如果未实现则返回 NULL 或者 -1。这三个方法只能操作 DirectByteBuffer,只有他才有保存对应内存地址的 address 属性,GetDirectBufferAddress 方法返回的实际就是该属性的值。具体如下: + ++ jobject NewDirectByteBuffer(JNIEnv* env, void* address, jlong capacity); 使用指定内存地址和内存大小的一块内存创建一个 java.nio.ByteBuffer 对象,该对象可以返回给 Java 代码,允许 Java 代码读写该内存。如果该块内存是无效的则 Java 代码读写该内存的行为是不确定的,有可能抛出异常,也可能无任何影响。该方法的底层实际 DirectByteBuffer(long addr, int cap) 构造方法。 ++ void* GetDirectBufferAddress(JNIEnv* env, jobject buf); 获取 java.nio.Buffer 对应内存的内存地址,此方法允许本地代码直接操作 Buffer 对应的内存,该方法的底层实际返回 DirectByteBuffer 的 address 的属性值。 ++ jlong GetDirectBufferCapacity(JNIEnv* env, jobject buf); 获取 java.nio.Buffer 对应内存的内存容量,此方法的底层实际返回 DirectByteBuffer 的 capacity 属性值。 + +以下是一个 JNI NIO 测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +import java.nio.Buffer; +import java.nio.ByteBuffer; +import java.nio.ByteOrder; + +public class NIOTest { + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\NIOTest.dll"); + } + + public static native void test(Buffer test); + + public static void print(ByteBuffer test) { + test.order(ByteOrder.LITTLE_ENDIAN); + System.out.println("position->" + test.position() + ",limit->" + test.limit()); + while (test.hasRemaining()) { + System.out.println(test.getInt()); + } + } + + public static void main(String[] args) { + ByteBuffer byteBuffer = ByteBuffer.allocateDirect(4 * 5); + //put时默认按照BIG_ENDIAN的方式存储,读取的时候必须保持一致,否则读取的值是错误的 + //这里为了跟本地代码的默认行为保持一致,使用LITTLE_ENDIAN存储 + byteBuffer.order(ByteOrder.LITTLE_ENDIAN); + byteBuffer.putInt(1); + byteBuffer.putInt(2); + byteBuffer.putInt(3); + byteBuffer.putInt(4); + byteBuffer.putInt(5); + byteBuffer.flip(); + print(byteBuffer); + byteBuffer.flip(); + test(byteBuffer); + } + +} +``` + +```cpp +#include +#include "NIOTest.h" + +JNIEXPORT void JNICALL Java_org_example_me_NIOTest_test + (JNIEnv * env, jclass jcl, jobject obj){ + jlong size=env->GetDirectBufferCapacity(obj); + printf("GetDirectBufferCapacity size->%d\n",size); + + //C/C++默认是按照小端的方式存储,而java.nio.ByteBuffer默认按照大端的方式存储,参考ByteBuffer的注释 + //为了确保两者一致,应该在Java中对ByteBuffer实例执行order(ByteOrder.LITTLE_ENDIAN); + int * test=(int *)env->GetDirectBufferAddress(obj); + test[0]=11; + test[1]=12; + test[2]=13; + test[3]=14; + test[4]=15; + jmethodID printId=env->GetStaticMethodID(jcl, "print", "(Ljava/nio/ByteBuffer;)V"); + printf("GetDirectBufferAddress\n"); + env->CallStaticVoidMethod(jcl, printId,obj); + + int test2[]={21,22,23,24}; + //底层调用的是DirectByteBuffer(long addr, int cap)构造方法,该方法自动将cap设置为limit,position设置为0 + jobject obj2=env->NewDirectByteBuffer(test2, sizeof(int)*4); + printf("NewDirectByteBuffer\n"); + env->CallStaticVoidMethod(jcl, printId,obj2); + +} +``` + +## 反射操作 API +这些API是提供给 Java 反射核心 API 使用的工具方法,用于将 Java 反射的类转换成 jmethodID 或者 jfieldID,具体如下: + ++ jmethodID FromReflectedMethod(JNIEnv *env, jobject method); 将 java.lang.reflect.Method 或者java.lang.reflect.Constructor 类实例转换成 jmethodID ++ jfieldID FromReflectedField(JNIEnv *env, jobject field); 将 java.lang.reflect.Field 转换成 jfieldID ++ jobject ToReflectedMethod(JNIEnv *env, jclass cls,jmethodID methodID, jboolean isStatic); 将某个类的 jmethodID 转换成 java.lang.reflect.Method 或者 java.lang.reflect.Constructor 类实例,如果该方法是静态方法则 isStatic 传 JNI_TRUE,否则传入 JNI_FALSE ++ jobject ToReflectedField(JNIEnv *env, jclass cls,jfieldID fieldID, jboolean isStatic); 将某个类的 jfieldID 转换成 java.lang.reflect.Field,如果该字段是静态字段则 isStatic 传 JNI_TRUE,否则传入 JNI_FALSE + +以下是一个 JNI 反射 测试,dll 生成参考上一节步骤。 + +```java +package org.example.me; + +import java.lang.reflect.Field; +import java.lang.reflect.Method; + +public class ReflectTest { + static { + System.load("D:\\WorkSpace\\IDEA\\codexperiment\\jdk8\\src\\main\\java\\ReflectTest.dll"); + } + + public int a; + public static int a2; + + public void say() { + System.out.println("say"); + } + + public static void say2() { + System.out.println("static say2"); + } + + public void print(ReflectTest test) { + System.out.println("ReflectTest a->" + test.a); + } + + public native Method test(Method test); + + public native Field test(Field test); + + public static void main(String[] args) throws Exception { + ReflectTest reflectTest = new ReflectTest(); + Method method = ReflectTest.class.getMethod("say"); + method = reflectTest.test(method); + method.invoke(null); + Field field = ReflectTest.class.getField("a"); + field = reflectTest.test(field); + field.setInt(null, 21); + System.out.println(ReflectTest.a2); + } + +} +``` + +```cpp +#include +#include "ReflectTest.h" + +JNIEXPORT jobject JNICALL Java_org_example_me_ReflectTest_test__Ljava_lang_reflect_Method_2 + (JNIEnv * env, jobject obj, jobject param){ + jmethodID sayId=env->FromReflectedMethod(param); + printf("FromReflectedMethod\n"); + env->CallVoidMethod(obj, sayId); + + jclass jcl=env->GetObjectClass(obj); + jmethodID say2Id=env->GetStaticMethodID(jcl, "say2", "()V"); + jobject result= env->ToReflectedMethod(jcl, say2Id, JNI_TRUE); + printf("ToReflectedMethod\n"); + + return result; +} + + +JNIEXPORT jobject JNICALL Java_org_example_me_ReflectTest_test__Ljava_lang_reflect_Field_2 + (JNIEnv *env, jobject obj, jobject param){ + + jfieldID aId=env->FromReflectedField(param); + env->SetIntField(obj, aId, 12); + printf("FromReflectedField\n"); + + jclass jcl=env->GetObjectClass(obj); + jmethodID printId=env->GetMethodID(jcl, "print", "(Lorg/example/me/ReflectTest;)V"); + env->CallVoidMethod(obj, printId,obj); + + jfieldID a2Id=env->GetStaticFieldID(jcl, "a2", "I"); + jobject result=env->ToReflectedField(jcl, a2Id, JNI_TRUE); + printf("ToReflectedField\n"); + + return result; +} +``` + diff --git a/docs/Java/test.md b/docs/java/test.md similarity index 95% rename from docs/Java/test.md rename to docs/java/test.md index 848f7ce..38b6ef7 100644 --- a/docs/Java/test.md +++ b/docs/java/test.md @@ -17,11 +17,11 @@ npm i ```sh # start dev server -npm run Other:dev +npm run other:dev # build for production -npm run Other:build -# Other production build in local -npm run Other:Other +npm run other:build +# other production build in local +npm run other:other # update vuepress and theme npm run vp-update ``` diff --git a/docs/Java/wait_notify.md b/docs/java/wait_notify.md similarity index 97% rename from docs/Java/wait_notify.md rename to docs/java/wait_notify.md index 1ae88a5..6def465 100644 --- a/docs/Java/wait_notify.md +++ b/docs/java/wait_notify.md @@ -1,5 +1,8 @@ --- -title: wait_notify +title: wait / notify 交替输出 100 以内的数 +tags: + - java + - interview createTime: 2025/02/10 22:30:53 permalink: /article/bdav8vie/ --- @@ -88,7 +91,7 @@ public class Test { -![](https://cdn.nlark.com/yuque/0/2024/png/29305717/1715416018482-a7c590ee-a043-4089-ad3d-f39a01d6e979.png) +![](../images/java/wait_notify/1.png) diff --git a/docs/Other/custom-component.example.md b/docs/other/custom-component.example.md similarity index 100% rename from docs/Other/custom-component.example.md rename to docs/other/custom-component.example.md diff --git a/docs/Other/markdown.md b/docs/other/markdown.md similarity index 100% rename from docs/Other/markdown.md rename to docs/other/markdown.md