$T[5%fVԕD /Zr-FcՋp}*Tߤ)JhjnVAB]=_2Jό=+XJ(Fs5Tf
[ܤGщw؏
q8\,MY2 l\ \}Za8 ve#HՊPHZQH,8f_Yc̞RП*0)JF) ?A/`#<0ik!XvQ'D xHO
+ @Ї՟]D}܍뼩g~1kDcVR]){n*LiW0 GvF DBr_MUJ+Plwd)' C==n *ٌA(ӳiÿ6f=ť/UuO}2A 謮6H<,(a/jDY4 lJŖ Ltv%?_R?Th:1Rt*0.|B?Ik'V Womw9 n/,__WvY| ]Vms~}j^~ -Ln}QU &L6CdK}roTf$0b{[Hq- hSPUq,]v.k
Pނ((ߵ'1kv'eaPSI^]oTPvnQS0
_OP^
+2AǭÊpw-)V6
N nP- n./iwrX0eTj@KS n!wQC/Ξ(h곈>WUZ|~t
+Vw0Yݧ{ܣqrݜ,g6o<̌틢 c t-]SNkR, F֯X/SL` Es7Y3 $hz˾[cOwN ŕG.^18T - ̶Z=?f}ofw(ѺhIDȴ$`tӻ&$B) 6V(7 ^ lsIbX.ypw0" kmtqA҈WVq G8|;- (<8J~H%
;; #!r
bC9 EQnWQ\/r;yጼ4Ft
+ q/%{])B BM!iTU Jm p3k#%,9u6 qQO]{TRQ?Vj]B"L{}z藑Pnzo$g$3םXjrnmnVd0 4+Ui4]~| YKT F6žw(U!sn>VcTHhTF %#d =6NRu֯YT>p1}f:0T~\#u _)fE *HÁ2`_Ǥ`QW)7zip̠;蘙z
`\!4OڭJf7By(=@!5]%J5]Ӡ
+ZQc),r7.zWlw|,dv
+Q>r[h a G FyD) g0.@x6-
?:yڇڈYV0<g3E8\jiAѰŝ&&"7"ߓwĝ%}-j".{@IO ;j P>]\e3l65͕ 69V0X#*@I$)ɈDh4 ρj@𫥃 ?eXbA "
TqSV 4as{0O\B]o(}?!yϱ?R"DR HL
0ntLl>e%*JIue ʄt+vn{Om8َ4km=J9@I%\h}C4ȕfNv[''&+.]eIKAzP 4؍QB]@+3blR4-({ ? ިoY%qz^dbmpZ?:wfd{`]-b>U\ yONe{ah!ObR^zML`aa, +:cWgYqw/Y D8g? ~3&!d,*,ɴaϙrNP86%sE2H .Ɠ&[-f*'}ZDF0JRBC-\JF5& r*|or N[6 &?\3v"F"&,u+u.JIPHBzFnO,,GzKL{
+̆Q `
X><#<2$eZ% VIgBBE?%R3T5*aDkQ J<Α!J8W"TɘDXlK""F $AhaF^MZB+B555}C7Y\ 6MgJ6L8OZ#*JE HDipj㜂eqbb2\@vPՈ CNHP(@bF&^%E()]((%0GiTL$TrRpHS!BB%(8!!2Erj1+`p"CydB!8D!^ 11XPEQ((9!$&3p6@D
+2Lc004mݶBVZ(͇+P`˖l`k>N`;m
+k҂K(3P.36bqx
+1 ^Ra>SÔbE Զsʆ&{a{RpLR
+Ub",&4TT*"CU&<1֤7aՃP0Jae)
+UI*V3XB)3aBhB?
8aZ2HRлYpWL 2 CfEMh@sB Pa(xEJs WЌ^W98 ;M3/ϴBS z\ixA4 v$
+uh蟅Z4q[xqEJ[M>iUDһ QAjp7c)8K2=>S'iѝ[ʔOz$ XI$,"E#QR j%F rWC+F)HSPI}ZH,̨R\ "YK ! B!rL^8DC
+2$GoJWpUV>pdn'??zoId&)mP=scAh2~\2ItMg?̜qIX®i 5\hre݊,&⪶)^#*.\VxfATeFUWMJbO֒ ɧBG,2$.Xf%pу7Ɲ-2-
+"$?2$ $Bdc&(0욷0lۢZ
ҔuM.+jAh*ZD0:OLЅTb:ZP'EثG].$&t{[%Hm}DErFؙD*EK[7}
+Y!qЭѫa*
+M9K*Oуxd
+tE&NQ,44!NI 㐛LSA.2gF@
+Oc(
+r< ߥL±p!MX2ti> k+k%Ep%TdfNáxCC551!^D
qy_6GBdJJQ$zWw j
5J%z/ɾBau"j
++FÊYڶS2lyi,D0<8|F $N)"<ETmDg%o( iYe2aJ,DPRU"$$U231BlT*QT<a\i(L<ϭNߏwz&0'#h<3%1A""""B1Db)ū7LsigVщhg qQ}6# fPEUE EE· Q쮐,N!sȊjOeAqnEKT0]l9LUNMY}Qc{/pF9\p˄v .ȑb"wd'duF~_QjSGԈdLXRMbkFِѮ^}\XPB<#q\Ñ\*6)ܼ."Ti>j 'hxx,0P@y8NMY U j.;ԣ%YU@f! 1<Á
+ ̳'f),Q'ROh:`2X`@ X+jr%fxT/ \QTʹQ/ L 1 D ( Ͷr >IØs88hV3u)ř=4j.3nQxD cHk g#"$l43c &SbT) 8XC{c!1,`Raaeшł %~H^G,>QɌ4rG?ReEk餛VD*kX|=ZԄSM ġ֩.o.ܘ{^C'S]D& _5TeEyrƏ.s(*7D8?$sP߷?kWS|oýOGB($f3 /qy+1#o\Y:vus|h*/$IsB\VHD.b r>k[)0|ӦJrͳZ;l!J:q,1gtF"Ȑ!gԉ~UFg:uj
5hUGڦ.83 Mj}$Ea٬${]ĞQ1%fE[Ѩj"Q>ZT O!sF+RԈMmj%\ <1 R5
+&3ʨksܕ{73 Y_ѓ?S}"5j$/'IKhGecܙ٥Q}K.Ǭ_g4+dِfE7bJH+Cl_#<3qA2<-ohUB tGd!$S?N-L-4І$쪙kR qlۮ&!k:!Htc3ddY*Sq+%u錋3a kbYK4O]:~v"d1U'E6+ 8sNEc5AaԘN㒑:EJ qb?pQTDQS}f3w\Y"^R5xUV&I./Ⓕ$g.t7DgU-VcCeyVۼPDdP켉PV+ &[WaڨW+TF/ZN4<OzO:KڰUfvHj4Ӥb6s
+3m/ʴb .AB
+U8$CG zQb.iq̌,Pl-q Yd<8@ (XSA0j " `
+(^i -n#y8p p3J+F$R2iI>5 Ӟ塣3F;h
@
+v#9EF5M6ĂT#AdP`ɠɳ K!BH5T/R뻄\UAKSSS*)YjQG%3BpZpP*PF ¨ u$T
d\ɧC}fE~*H4hA 4" й c n fE^B2py,P&4M thhbZBCtk_};H" V@~bQ AW+T2wC
+4Cga`*/
LP(Q 4"~Qo @:I9L
+ aHY.(*'S(U4: p@ Ctx8FCBA(* " T')$!]\L\̛ ds)J`EQ^b硻!!pƭ?C̨4 &xJT#8އm*poPr6w 1n!;~|iLL)[.bS/9佃,!kae@r K61LJxPp[bwkMyu5#t' so$fm(A sF'\M?h&.hnzOP!a?^d6{Egn I}ӏd!=wcOpz2Ii{#-*hv딏߬dRJbļNסI6CwC8\G>A8~e"p b+ݯAGP9'Z-'_LL+ Pd%AeĉJ n/lD ڧfX8Y56; pBx~s#t\)_HFi6"0\D)Qx ^wy1,@H8qcYlI~#
%|) *'I쭗Gj:^Tюo/BKɀ-7keE b3 G*x u> 0 g_c)N =!r^ =Uv/p&NPm
Z>|+(
KLf8QFK$uue?");Kl+ aoLj^|lt4K}l8ͦ 12ͦ4k`. 5#qs{4sμn\>ahʐ!1$\wwQpU,FurZȶ0!1+e4MHx+2 Y}HFu|ON/ҩ`G{rcm<8Xt@p!dJw/T̖CzST[|aLޚ WE?v( @IHРuI!# T8;.'Q14 6L
В%@?s,ܾ)NH}Z)0ӠZi'ĤG`XO>Lij4O @?D6sB %:cǢ&5%K13xrpNbHV(jLViOUϼ.Ttc*A:iDm5!8$Thn*?MJQĚit|d 4-#>h^j+#Vua_ݍ}lxeArU]HTKv h:}V3RmcGfyMCl[Sm {ٕQƏӀ5
+nx!FVĪ"ܭ"ʺrSE+R_N} 843,i2"9mbIw@}^68C c*4 >=Np婅+4v=DajX 5
+ `f13Y7p]2aEŇN DҼ!efV''vJ1I[:1zk7d5O:2MZw?Aq4mfn$&|gpfOᑅCҰ0p4Z&NzjB|$Lc 5f+2} G`p6
+"db|g27\{Fʄ~]H2FI9JGCh
Dt4_ UfTnI z]ET乡
LʒK%,,e"AG=pB*gL"4'0M/L21,̧ .C܊tqk!~,ETsHd]ܳ#ь:I@a ]UH}/dVfPlu9/O0ZZ[@ `JÆ^eEz_Dux=f8Zt]*NZb T0nY1bąw9P2wN =M"R#]9|bQq\otdԻϢpZB8ƈMD
+ ]&f&FAy*o l Wb.7'Ϝ!-I5C&0ќ j*zr[t53T$)~nX$ 5y rxt.HSl'7\3%
+@{e0
+eu'D tYIFSk#A覐^4#TlY@9e#F?^k 0Wk hdW7őMm+j'dS lcdPяs1>
bߤ
㈧yvn:;c '8\hDD,a70Dp%|;< v* O8}:Nj#o%ԣ!fcB< jzbរIף|.ƭيVe@|U
8zq+?~GH97aND` 6|Þ/@U^Vvy}!4H>ٳN=Uтh&)wM`jZ0 ?r5"f"25J ]6"ijMycL!DtqSf?fWXWte®{# d{KW14fMuPyE"NwKУ= :{UI8l/
+Hm(]z j2ӊQ 4&k_aaV =clUѶPq,( F7
g;+3-PyGߔ:5 O&!r# eØHy M){K2o 㪓=4mF\}Q)V̡&lYW}z_.0aaA`ꮨ0~fn㐔X?1ɼ/`F}:!
+%-> :{h0$ a1;68éyfVJ8NAÉbi<$$xwl>d ㈒&q|I"m6^>iJ%@24V 8l|E<" CRAQby5LTW千Gut2|vQ(&!g35Jw+s .۬1.!v!Ν ;T|FxmiQfܽQY =&<
+Ie}O,@ 3I+>e|;
+ d*&ʺǸ(ƓLPѮ/6ՉDZ9İBF.dp3~NA)簒oe{HҊ
BKh 0+ #G}dоj_pLGpi̴Ѝh)>W9mnV ^ I0=8{9;bnZ_ NyyI Ԯ}#& "_Z%ޚߓrn(}bG͡B1$
=r6zr=VboEAk(
+4W""q{~B$LX, <څ2Bë3n1A$/s wdzXC)N 7D}PH0
+ڤP>Ǚ@#Ŧ\%X1,(%kt- ,y0\ȈZΗ*V/RZ%}~]![l'DD&r o浝G,ZT2 OtS4ʙ9fF kY+ P:Zm5NM -z "Rޥn)= 쮈?{fK%CK/H 0G`A{TyTD~"0uz|b1; #zE A'ڡhJ$Ř[ИYAyIS
+ ,t8JxTs yI\A1_e]-k]sL _fDaV6e.!KB%9?ao5A4*i*#bu6(ŻJea0eI \p\$9 sfjf7G:$$ K }z<AH~,HO).^ЭA^1Q|2T6 @α+p FTC&%Im?[~" {E8$tߣ-*.Jl4Y.N֛rZ"]6.Wc q SBKȐj*?XoO)wMa E tX O[BaxkY-Ɲ ߡK8=\`_;+7qkxsIo۴;Bɧ5OC %!IXc\v7y*(3z shvSA=~q#/B(EO9lv87=d"?jD#YN]r"`OT6
+f:?Xc!Tp 20d9rtmS ^ J-Ox82 ]sU{㐛"hI)U{ܲ(S@a$ɬ;u 7v \iY)U۱( vFRaQPK X*1Y`Ȧ]m \?g U
l-Kd gD_ Z0OӇ3k|
ꐤT-1" n7@%n]+}#-%aܓ>_ M IRO d I--SoQ81 L6*fpfE{ Fculj |@؞}7ZXdVa)ٶWаR[9}KcUT%3ơyK8;T%D9rHAq]^/v2N崰9` !3D3}?;+Us-ahki]=X ZuabVL[F$0U(6)V3?O,_l5FZKXK&"-\D牶_&VE
U1Φz'Ŗd)HaY*Bh5IF.=FH(}tb(%TM?>m?73L)U "3x`z{$Y}/ ZzVi |
$́,`x"EBD`L m}5;cKR=F~Dw#-"-j2 LYCe 1 P?4\ a fq@ߥ"9,uƀiՍ_DQT 0G"]Pnp^`0 GZY
C%Ѱ MD^C/\R4݊ ^? UtjU'{+TՕѭZ
{;4_sv'b95i\KX˟.(R:Ld*
+6w!W
+p1_Njî2,2H
l ya^B0D Jd+Nq rkC6
+K6 *%7ٓ抴=mpJHG
^l [i6k c G\Ҡ 0tt{="YAa싥,! ƊYV~CY?m z{bgN:4f1XTň>=]W. ԶĈ0]S
0b^PM0R0q@E` k/2 vr{;3 J0]1H:4(c@Q xP.2XÀZ!d8DFao
Uq'
i[D4$J
@rp V( 5-65#HD w+p8VEȄC%2V OםὊ a (с: Q̬/v͐r]; 5;>E'xk"H' i HL45_ c|aGaO#`gD4g:"@X5D\ G& D#D! ҟC@i ۂ Cm@ `Ct8
+ACh!_1~ܐ#;!@ؐ<
i gWd"dQ @`PDZ\ IW! fSHuVH )8V>)#<("AV0">Q++ 䣃B>*0|@ů߃eq7=zg{FZ v0d-Lh!Cz-,TpߪG78zP#ӃCzp'CJxym G 8<]8[ n)!,/:lPBqƃeq頤g\tp%4B
̠FH Jc"4&j (953tѸj_@_
DrAk ׀?9(
%lٰ4rφ S6=v eqmq*X &qFKsCA8xLJ#qp4o, EqgoF8$yCPGu#C & < Ȑc"wѤCE^E
87qlZR!r)oorlX9Zq7/qnTqFr2KL2A
+$SJǗaͲ:
3MŴNu!haN :PpP
1TvW)ԝm u뀻6` jзƹc&p ic~uā6l8]dmnlFxL NGH 9 y{14ծO.
+ p:<=k6 5xt2f^# |S
Bՠ$ џ' 9K
Q50$ !~i8#:N6AC ш_Ѐi3 3|``3i/\) ܧxbsPn`j30Y3" f: ȅq_엁Qsl7'2 2V2j 쌟 #nqd RspR"22 # hclmc(d914G+Ƶ0r "k| J FҊBA :b9p qaa@/ * ?\" r i Ua5%5$1FdG7 Kto9FCC9
+^ yr; h9&x:X@X :0a.`\s)߀^g+c!BUj? /˫/)/#wqQN{^^t0/͏H~FGwtb~tj!vAj.:ӅWaj7SĞ 5Ӭg: b;;;pJ[4 kow|2An!-@)maY<d ׂCym-eKG&<@W联xYz hqw=wfA #e,p|SސGdaS>A.8 ` GB?GX8 iWH+^ds I+S@B,<Ѵ M &h"oV@ b3 VL1 Ŭ ?V! b&DV.
+SZ(
+dm>$mBY4n
+>h & >=,SO2Or'0\ ĕB4 rB@d{-%C$h%x0&ȆHk.jM"CĜhnegBZ
+GfHD3dBB cG"q"L /A%r 6@/[1 nDj u/HY%W"x9"ÒHкDz7d aRD%KEy[ NBH$TDmll Ķ=ȔAa$TG `DDhHX#0rO6# }#q
+:nG`dG O* p=b@T>b G $ 6 O#^Hg A$<8F@ # $@K!x"lak&"os)8B.%CBC'BW1&% %B)|DMۤi+C\d R -?%(pϸ҉]!K_8l8&*
+1B 64!7!42` %k&(uيA&J4y;PDrjMfM$qmrP}o3 ǜ d;u T @AӸ'I 2}O"I|(>/
|ғd9z{{o; d'T=eۀ|UCr(U{h%G7u}y^ J
+S[p Lq f'N!(}uF_= N=[#{"-oRyQ_\H
+˕sqDžf \0-
+$
+`# .FT A G X0;; lD?rx|JʋPB 'l;/r&]/_iə _0rUL\ Lܾ̘!pK~ ˗+XÙgyPf||Tg\|9mޙI%B tP q 4 _9 &tDS L\!2A8 XiAWIs7P7
|)k3n@U
nm|
kH
j 0Ҁgd
k5QWǚ̜&j pd&062 2z ~+kzGHݏA~"6rAI ka.B0@/ dɈit7x1)4G&:`W UQBP4FXBgE Y vy1d4TNH\gLzhQR&£ 0943PWT+CQKa0w +5@[nMr[BǙ{-T -, o>@~WiaK?C%/0b$O ,0|yƩGE.4*ܛy 4IAZ G (">|վ3 N} !/
+3j_'y~yۼt˕-rJ&~(oiNwxl +XRf$sS#?+B%j0f^f0&=J0>UwG*` k_^T@Y :|1o5ZiϏgEn
eL~-j&gϏB% }4:VI-S;/?6 +Cv#5a|-K{
+9 .=cBU ^)Qb.T珎@]哐VJT0*:-?aS-;dȐ`'N~B!N>YԊ"kY2KO\Mގ$5a|UQEAᎯ.n|bžd3RN [9˴+(^Auϊ40euȀ./9k0PY=eㅚ0~|~`\@>zj/ /c<l{ 6_vwSk7j{:xsK7g;M玉-8w h=u>>C G~z
+ Ek[S6{T
bD3Ds~F]# {wKIEuGT-7 op2!Cyت4!5R}m0#nV$G^MRxjU*(m<Q aE r{ ,^ =&X
oUɳMb謑S2!>-2a4wI5٦>Ʌ:J[>lqHOI1FC3r=3 xP}35]h}yf6HQ瓳Y#*&]@/wX/9'vKa<㓶& iy~ hE{% c^M>/?fduN[N١0Ikc7ISr$^Bow9҈0V ld=g37|drl>nPw B@L>sb;NN~ nUy%@6lAwxN21 tg2[4]Ҟ"K'i8nh Ccq<0WOoWBBzvN؞w"}lDZf ;R30W~U?! @:"@O l#l?ԇx-
p<:;trvP6U/4X>%ِylއ= _Zt XK,Z㰧IWrw` ;$*e>-ya%߉xGeNȢ`N ?P T (]c$ 7)ۻ/9hN#Mx,9@]& ],Z 3p4)uΝ?}
+ٶ8#]$e^ 8"ր;|tJ<
y)J'a)xG.qrw
+{* \P>iҀjSڽAf|)]+s- ,0qq{\[;`ں30P's {yxNK `Bq"w+7 ; j=Ř~%wp
Ӝp3` y&l ,`X daªhlG+rwF sЙ0+b)i{N k9TAv!>^]R p45\3fgdv 8֞N,ۧ°OT-9D짽35FҎbWb'v, v!7F;
u/|~T.-Mܢ{O\ԙb-m3a5{ J"̾W ŲS5Z ZHMOFflw ś5ޜRp[=&p4v zg.|Uj# F ^i-GO3xFQ+ߒ`_Jd
XE v/YP!.WSKwvn=["uZF70ce-A̤A:/ t.y +Ǥ߀ p k-u~-w̌HiY@a SֹWJ<$=j0% ;Ul>^eBKfdxtEY]mMtRC6W9Feީ([ʱ/
+H[\`]}#:A~n0NnI~2=r`UOS˶'
+l
+h ãzHK=LO ^7 l Za^ɵtA t^ Ufz^
+IBBzAܥ{g{Uq+K/RIv2_x*t&T:(]>G5P(`rIWz ,HBݻwA/Ǡkr*чf Bw 4@>_H%@۳2oEG)
\YD/*zGݩ(aCDZ ~R ǭ_& й&BxR?>6Q0lprBk `D9 t)T9]'30D;@習4k,zI'ܝ}7,?C;A= (SӫV|P;! 60K
+F=:`c- :'%U\rz Bm ~t K>l~13aM8| R>$]4Ҩ_&k -w/ps ey[sqkWLKQKTQ c.]S{b VGT?e#U1^oco`:d_Dfv^^$uH7*.vc]~ww)\EH? К,e{#ʕ)JZ#*nNxHVΎ_bT9 Ev_+\VPb) ;#,70$NEp&+ztړ)VNJ#B&̂{uI
熯Ю ǖ)Nr ?H~d˫(H wcA_kX(0>+T-\
+JᩮZg GG E' u ︑WhSNmw`SYY=h
+7/EQX3
SM[E`[dOᡓyMQ ) jqOŌTS8NC6i)^e-=t˹Y!<9yʙ
}ЊO;r b^a>øc&p6L C*i/VףH`ˡ.zD{C3s^s21yYghm |% 4C D;[LpO$DJ8?
+е5
+/8Y
endstream
endobj
25 0 obj
<>stream
+٩w<+c4P x[ G~ Wiҁ;
O/y =8l
+\\nnOzIX1/+a &!o__(EMӘ t)Qr Vж7*iI. = sb
؞y ,<QEf
, =Ic8N%Q|Pu4oMuK/:
+_{z@uE,i2u˜`U;% EY7"@~Voz5T4N?JX:o6E tMoBH]7>?
+ȃ2Y# thx
YۿnC,7L3DC=Q%bǩ:ɋft7s TU8Jt8nemG&$rtP)Z ?Gz;^v{1g76yM 3 GdaT_ 4snm_f[ FAVTbZ)=+;§;Ԓn<`#StGlDO|qYktPNeP y\Ӎfm\dX %~\oOm]f\}ArpjMzϺyQ.uqKmRzTw
=^nr_w 0 &:.cPkԉ.nm
+g=Rp.80u{j%ҳ^ ޕjm
+]HknCd` Y`ݍ5ʹmE37^º_4 ~u{mMlXRZLy|t>
+VC]֭L\nh[ @\w[h&\wY]5jO4ֆ^dXw+aМ
+;haݹ 4뫩[7}=Sw7W$*zuP# eՓB^݃O5q
xWC *W7 h3nDu;!5M'Mܛ ;Z[[-ࠌlMݗ#VR-`h\7[s݊$ւ݄Xn|z"Xuo =\ZÎ >ZCtu@1wS VB٦'m nLkz`u BI0XJ!p}gn fJ< tܗl?fT_Ͻk$31N3# :ns>H(-MN x( ?R{<(6K 7ʂ
niWP
Cc2uze;$dPpeߩJ9x{66pE Ň"k}mZ|q ;!X:m5yZ0l7d 䤏ǖD=^~|I ˶ $EyjЉ a{bH L赋R`-sɵcަ/ ? ȷm֡+Y{ Ev?[N/h<
+"5#ìZL^~0v-~#m< kVHʼZ0]&}݈0gn=8Yٯ r,ف @Fa`@v՜ư 0 S(̞e5B+U!f#u" =Z!.םEqS +nePkYݠln9= ʑ-9l)F
+ge|A<sl=cȯ{ǷXcY2}_R )g,vwMppMs ]i܈
`mWCkQv<>fTp
gyQ{h0`'×lCo8рqVlMʮ|<60~-ռK~Y}-1h& jQhk(]5/A~)E^YaNf!l}fk''v/{Gџ(ِt!]W='=["K8ĵs 03''O78K[s3us mk߱5Sڊ]ɤ-\ZKÈ&ɲ j m(%j ֹ
+@< Y~
+P`eaX%;α6qv%'֍
v;q-:)?`=#\5ECWO~<
5w5 /\h
+@s~bzi5IwíKҟ7ՂpB+[s氌:)jRw%cN& IP)%pV BqPXKj,P|8 in12 t 9b.u&g49jPӚתd8}KiEid$-tfI06n
4Gaz1 +{HEaL |!`T~t4NNCH5{ډGtJP%07nқ&:H%JOlD :w~'MP&
֯
+)i;2%=oXHhP~hӅzQ;[!ű`)4lX4Ѡd.0ŖIA `d@l
+D8{ʚc 4Hk|r1e\ݫ}k*Ӣ9*c/UtR7ǯsUY>>FT bsT 8G4j?Rه1
rBVi Pg>5zb9!uSE)4C7`rY㕷Z _@4mt2DEB" cEfldpw
%ш23Ot8- 1@"hu@<怶t0 ݍvHx|=;^I\)ԅȿ\\(, )YK'iI>N>T9fM,؞¿1U&%Mz1\uͳ$*JùCY#e2)dn\zqNȺEF#5ʩPjk;S@Q(tx%;k(N 63uY hI tn&7ioO!ҧX]h.Hڗ55@oɅ#i_֞fQ`
+,;H)ٞymfp?5kk={j:'XfA#ÎXsR͌^`yFXlO աTWlLM+/]s IkƚI1BŮu 㔅JhbhfR3,AYA5LRKͧ]S I(>1fXXM!֒.
+J} \[.nж͌? |W7@:axlfO/3$iw 3bJ?a2ܻ!\DÝ i#B?>Y3çBۘ)bU s|?S `yG(jB#@P,:Dđ LRf~.?vzM_mm?)% Q˖&qtG͞JoHSרpm+[ι/__|םEj_NEM~'bYX OX$'
+OF91XWOע_8F9{JP kҋ#~6
+$MݾϮOӭc1u3? SDjkS4MP@ea (Ä'~h.S=k`
v)Ah TŢO(pY ^wh$ѣl#U
+cBʙ8Qyk0%ݼ{E 9@D1=h8qtѬ QG,7k?
U ۇ
XZ\H' [%u f4x8ƈi:8sT\)]rccӧm,8¥.u[*Ժ>g`Ss-11%.^& j3];
ij܀6h`Mmb5"LtpsNUyN%2Br}
+ejS4@<B <ى
P7-` cMkEF@"JZGC!TI [a Kt q6iVq^S 9!1XVMUWÆ}A=aތ8%U:kV YZMOr|3"PzU-utrOu2`%V:.ĂjG4ur| ~YYM$FFSPDn^ִn f
+^Pu\%c@u
Nn+Y YYrZrNK%/ km8TbjYvOOɳj$ϊy"5Y
+YhfuU^z}̓6X`ZR94P={Zj'UѻZWP&xlom0t^kcLPZ-4[{6-Z-bzk?n;So[QNp'moۜ~֧Ht@(p'ᤕLn Mi[[+"eFbw.p;
wrP)xdq{ոI4h#W\^ssmŹh X[9EmLYVt]ѷ1u6Y. ,Y yEn6
Gڍ|t* w͉HݞmzfA^[.!S^I"<2/@%ӲޥkRMN:k ^yGChȽ-yи{/ciP}yG.`?-/?^C"\o]w ZAGw׀
+09D㯈w=> p[]R;zKwS}kӤ |eNhe[T)3m@Tc;xN ]d8v쌐):`l1}oŔ pY9$BΗSyӔd+ rJ/gRbJXA";%Th M\kw&e*0<FJ$-˖Yz[@w!1ƈvHP[ {~
+;`8fY0_3;`[q٧Q pP9}(`s(rԇ1:"}Y3'hz+t}'' 3eR* `rѩ/l:^ *x}on.Le+A |R#jkM|~˨^
+5sV®_ (Ue\40o!j$r\t4 곕kh$y~+Y` %XZ Ǚy%Gш'-@6~P
+ ͨ }izI ]
+K>14ƯY zt9m#lqrL;~1DS[_y7e~Vpރ
P''xcA|%B $S6 I*?At D'Ĝj_JJw8cHNN~9d|f:A]8 ;)s0;T^ou(&-/s,FgD 7:M`Dl[I)
T3 ?%' eє&'5_e<~ wGB:̈́X8F8%"#[
Nzv 0`m^"0 !vw%2FO@K/!
"Vt S`慉ў^e"y{ I #x>(D } _ .? TiI鰽rH *ZV?& AYd '^iFxS/,z̖Sy V&^t$i0se\`#Y!v ebZkߝvF4maǫB s Pð&Աq5R <|*ÛnXBlW1"!$L'"Z Y?Ո~+yClG#vG\q7wW:P0 dW,Ɨ2^bQ uvDѦ 4tcIK&vD ֱ1Z2`[sKE;(Kx85?P+|Pi¤?%rg xq I!Ğnԉ|+JG>[I,`J=)h,g6KS2\8jmԐ ]&9^v969>n:s`< eMK\Y9xK|Hqi24YL H |L4S.kf1\Wu?!bI[N6 -8d3 _!V1[Aa4y$&ѓs(&'SЂE2'HFOA~&p]~AcAɈazj?'* *ॣ'\n6;~rk6!aD=:{%$xW;S d@efb1Q6([eգL+ ~>nI jiɤ6c>/EæEV~h<'<埁{NsNY-SQ+77\嬱[9EݶdXK H h[nM
G\oH-y,.g cƤ˼mٷu\ _5e ;53 vXţ&*w_.,ܮ9-aΟ_tǼM6 |f2` /Aq HG=+dF˷ZsRP _\ 6*`8ů 7hrFS+6Tni*$ZXd^ϴsC2Fltpj::]%RΏZC ҂8P1N0B$=XI+>]!eCG#G"$DK|L]qiؠ4fLE6XF/ }4
+dK Ϡ.Ƥ{}QLMJJGLrz~KM1 KM JET+6q@u~OO Ȏ ]c9Om>?uaꌕ O uW#NfjW X'[ UȂ?u~ -S^Mø~jhvPMVfwCyܥg ^Y#s%WxTg7 jBWEjWHXvB &QM 4F l+^jmV>SrT
+|$WT@(GRuM5:zd?8TYVt!i{QǬ9@} C5{?x0j b( ~RݽNU[ѾMp3K 7e6#V[CAԘ ,(= uThn`v)Qc j$muFUv ET~
Ǐ9Ow@4yjQvpp+><%x>zPUeS9gҴ35d o3bq2)/ oO /Qb
+4]:',M=&S$m$S{_)P E=v:Z@ѐE џX1m c^Υcoy;eGjB[ 53e\{+:\ x$zGQ( )Q6+&#ΆʵKf7e
+|5*C6%rB*`W*Lo jK.Oאp\}kU`#-EO+]KzbNDX^CX ۮ4k$VFЭ2[*hL/ٵ0-܉*
+>u*sOܒ{bJ>ZV&T vsGaR&([8
ޥ%NjJZ_N#ar%K 'o.TyW
+L7ye;oiʴa%%fq-?EBq9P+=A/Z@mLWCۗQ_
!&5[F
9k]U=uv!m=ngϋ/f(!R7""!22[mn5Ȋ,p/0UrJ[G {7]٫Bix*1m}%%s }~ fgh[pSD̜Za >~l}et! _GpSgOPQ'
<1װ? GYIi{.
+}eg{j=6!#"
h I/a~Q~:%<5uh7 3qcLX{s7RcwL)k!>^;i&b>t2wlY
+g]$K>k$@{;߹^wV̝A{ 0s*ANw*4lOQY+pX#Mn{>8ӕA{i3l'`xFgKT7 bܳ47@C|~;yw_'P}'<ǘg||^O)?WjЮ4rf=fl=˿8 ^<t3 5b- єVGe F4N2nPCgHYW8KܦNAShg3vb4O'Mj4C|7
mebes =CG}6l3`luYNgiŤahв>uu؏P.u!Hi:WFH7qut&eW9l<
+`$+^t&C{64l3uk2i H2%rkA$L Fd&]%2q
bb_ No S'L5|hУv kKyj {5wl5 \u:[8n;hs i4IhMcHguY GcPC\3i%LޏD?vZn\P_ F;\9?a_O/ ¾k:ݸSׅloV uZ0Zc1iJ$z1S&?u
+@k
M:-')fό|H ND;}roznl&M] U:2_op
tyfh.}Y&n` **tGf[ѴNV upFm f8 V=,U~ B^"ȿt|L\[7H[騤 Ȁ
+|jl*TC*6 F}E/ԸwpP ?u_hq!?v6N`g/4{gY0[BH[%UUx0'?+ɧ:5AzQ
+57|lR_jt ZܳoؼY,Q%Xƻun#iy(Ұgz-]gcȲa>r}Ⱦ 'ݠDBzh+XG!I/XK1IGs:W(Q: H F jԳs>s<8mvQ`e ,+ s)a7KbSAYSqIK!Y7i~sm^Fn,;S76<AI4yg H۟#]G&-UZh'Yv)O% L]YMa@-jX:l:M HMZMSW6lOpW0cv㱾9W9/@N
+-DT&
+m+ԩgŽXy"
+~ϝW~ͯ
R"6ԧ)x'MAy&Z컑$o#G?[jAvPؙeknZeqMotFy G wtGp
ZH eJةN ɾ{g M]-ڧ;ivvmy/fgʲD|2bF_ OG~>mJ= op> j p u9o1$5zj^
dQ Q$˸2nb3[M_Y=s'Fȕ9[1~fTfh
n0.ezУoz,}uy7'QW?]C9CM+IDL?v C<65P,(5 Mu%u+=Е8]6:?
+
d8*NEbo n]ԫnC=/ׇ *=ÑιGo W8
^<(R:\9 xg;}~P 25 R csN
+L L QKb}g }E;aFc/6iZl01,$ Ki+YˀM3wl L_sw&[k_2sX>v#3W R/+.*&h 8*inBRB>AdolM ;'<#mjw5Ҷ yC'NBo@4l?vm&@[q(Hhg6Iݛ7Zn,{6QyNO$q z [P^#hG7j݇p']n=9J>"hm#rg;}w>t;إLP ;!<(Hr)}<{Q.z䳇F{+i蚻~ֿs= W<2 =9{p&r2Q~K[I̵"7Xl 4uj3Mݙ Ĉ#xV<ĴOb] c:,d_CpbP"ŴΰS>r;ݹ Q8e
N6P{}
ߚK7l]fy.3'#ɲa3K&Y> جoj -}_p6 ZMAqm Yvf.Mq#gd n[C}P^O b4-?3>Wj-[lZZn쌝Mg&1dW J>v];G,u"H>m>4'Ѝu@yuu!'B{}+0\yF8mu ,&; G@=r#9H~rt>_Sk /]}@IgւM(aN ADh=y ӍAyH ">a~V ?s^[?"k?O丷㍳m<#708otϠ]?M]|z h>>
+/ir?S/8cXݔ/0ٔLqذV; H6F?Í?xC|6Pu zAvNXKlZumnWZ÷&Bz='6[:6f; Hs&NC|5Q_mDX ]P`c=u 9-H=sG*BMz:A ÞBOSWVĉeeL}0k[}ט4V_c(QB;y$1'4ziY1,NuEn$4Km=5qG*(9=u=' Z16A)q :
]\&Cz>ʴ@
y/ u Ƽz[O0HH _RGbg =ezp ̐`dN$z2^B9{s,>}$Az;gt㼎 \!Czg|<ϗ="?D4߉{C^ 8{o-%J%N@x&/ˬ=9kK
+j,lû/w:]gf=Ch7 X4Ⱦ/\{aVC 'u(ӯ!G b=H%cm%݀7yugtE~)B:->u g in!
+Mv p]m{"'rܳ&>B;I:<\ZL>jP z'а?JT ؑ2{U
: ^W@Pd ҥS(H Q#qO&ͯ
:Böe-Azy_:m(O; C;Dh3Y~$@[HQ%J][jt6 $o!<'w E|Qc}$wt:[) >eMgx7.E}?2N"ɾ_4g+Unˮ]Ål"ƽ{*Vm -v4tcηxZУ/Cz~ k?uzŠB?I3u;3HRW X v'Q)id<3Ə!G@twhϭsm:k:ܹnV[lv7|l/;1zFlٶ?:hk
Mm< 'jelyfLEtxq ?/FbAShׅP^5zjM[m$@ZN{v0ñK~_ʴ#MrNwxj&ίgB%L\ 0Q? =E7 Ā%">?p|O'N{
+SHb/{s/ܳ 8 dw7qvv E{JfL[JvD2m6UVr 웽~փ>ӥV~%ˮb̳snSTQlqТ7xl>"̳*6{V19ǫf}-s Hp;x}| mBy',Wj Ź#(,P:;`N76ݲ̜6>w5Cgu~megf6l
Y}mLmUִ;KSg62r>˵\]| em3rd4riZִ INS;\{qlX-#wq?QpNw}/7 FI0Wپ;`:gpAy
+o O~R;\2үv)^Na e
+Q L ~A[I̵P*5M_ )}!OBy7
4Q$W
+J$Sd
ֻups
+: |;^9CH}/]ck?F A; ǻt)h'QD}_H)M7H &lɼoFܱAw3XΟK[-?9 ^w6">-ލf Au7㞭m3rbUYpۿselLY+ &#w8۶:oӼܥV fmWUBy '[:6͇Ũa1g2̝6vwh>3f{Vԕel7֚\+Ř=fcȲaޫ3wZyN̜Xk}!@Z BX< \W4oimB|_HQB齃} ?N 3ef5L3w&ؑ3rfr!EPޭWw i"Ğ2Z̯j3 8>tM[ً5tj G#1no߂dqܾk'e5zl3[nKh ZԻ*ӧV Mٝo\/N_mVpnn]FLeKcd0]$daַ f;a0>:ſDxKK, ѮXҲi2m,'I~Yf,S& 7]69 ƹ@de]ؚ>,+ֵƳ#?WW f}벌ݍgnmŐ]b¾ VYn0kYMl;ݹ3Hg?wue AnP"Osm$@_$;ܹ.#Gvnj$_@wu! Ps{!}ú{wo6?J wpόanj'mhy<&)ؘ,֚& 8nmKi<9u72wj=5uhЩ4tg
ڟq+f_٘[ӇFy9%>uwO8N[col"=$m'Om us y {tS~ТFz7|k>#]y A?CW6|? |?e~Ivf@v7uo&c()5b-;8/maac\\2vwP0~
1ű!F;LK,lkfojFܙam}uqM W`[6 '̑ء]k7_$8X< BXݲ^V:W{|D +Jg]k Ӳ5iYm\EƬeoi+oI1 !e˪FYh3lHY&1"DsE dwd g 6 4%ǖ5T
+*B $a#U '1}! @@%mK :$ 9e̘IR .\"7(J!Q92,DT bB JID3qIe+lV[T?8Eo k80cLa4v
+ 9]9OBRHq#}88|p N4sĥxԑI];P=Ժ050H
Pb8Ț`)zS<6 YlKa!bA!( *. tn>*\TbIji)sr;F_- ?.ANC!ğxȒ%]8F%9&pp%YO3G<Ëdx8H\/Qq:A+M Tt'.ē_E܉OK
+#p@(|VV@QY'd $= sCl6 KJED1 n"BjrBdQeM21D.]<KF$> =0+HRy4!:ZI`1~Lj fleށǢ{@o`ŵ!60$ep1EE4Qq7
W
+7Ȋ/Et@Zp62 k"Q |'O`I U\L%
+A! TLbب$ ?n,W1K% 0!,q5e6vrS 9q S%&j^i[$#o` 4) Ds54 [$|b%3
+d7ȌJJ8't;G9Fr<Vt(~QɖS RNC$L-!.a2J>+@YUJ.{<@: auc t/Z~e ٲ\YВV)$,56K IUOWPgS
E
+zmw|x": +Z00 /f*5.Q nR |h oy%.e,mʁQ Y fD*7+.3G \6O(uP,) RRh^ *YĜ\ue{x+\}`dEr4/I&-&HD'LPL)$_ NwGx?$Q%,i)̕hdXq#
+)pXt f'Fl*>|&ZBU+~q6p*kE%
. b#:&4& \B2p
+I&"&*X,ȗt '%&g_%-gP `O2f٣٤.c)}zJuPWP8Z8!QBtA,:ir%ΓF2Ϊ fD1
+2&bdnm]%XcT,#`~ JA$#_%]#0&܀sIH(@ #ωqa&S,ShQde-hBܕd9#5]=DP /aU[ _rC l`)XIH#_V\АH!|Wt)Y|j;KpQYP, |`2,3"*&| ,L eh9LFoj65$#}JD-I}c䑯ȿ$?"qԓ
+db/IB%P)bqFYY*le$&b#2/uxA|e8NW&h!;T2q$Ө=K
+Fܵ
+F $-Ow-7dݮ2&[Bl X7Zڹ#9yHtE)u9Qo`brv~$RrnA]IB7 `_В1Jh-$ٴ `Kv #ؿ+TE)[U/Pċ-!*_͋9ll㚕M0S/M۠˲ӰuRzsN9':n"ǒ#w! " n\MLRĶب0/h5.;|Z csRr 0͢8U܌S"[0_\QsTb{ fLed&#U9)6T0v zb< +xF#al"]f
+#{$3D
+hS@"I|Y^Bi[Dg]Hi)>*&8?#=@} m[҂Lb%_PKeK XL
F@GvKR`pC8ѼrHC侱 `ʀI䕨ϖ"%V?(!4e }d ܈I PbF£C ʜ6nrf%|#T@T}~Յz!g eF]kQ`puXwWrZvX-C: zZ/9Y k,WIѻ `!k LV'¦]XLaZT
cjIfhXJ-*u⢓ưm+2:Eݫ 5TI9\XdW
+(E܇U9-Gj~> Y1xh1!RbVF;GVG7R^f.76-=<] ^M`E Y(96'9* :e-hEegY C`!LP)QAeBS=^SLҞA&m ,wIךbpf0L\tDfQw$X{
+_E
+mK_ m yPɓ{3G5,cPhlOؗ(]p9s$*K`uK|gt3 X*q(UW _4X b?lI\ ZVD" ACgHIS "8E~]kKibVC=
J
+[!)@ćXٞ9y,LJg #bl h92 = UAt&ŴZEJXqCl
1$ƣ= pc U3G!{ F /$^)2z٪ [ %~_%_㲣tY]Feˀ3r4 /40% h T;[B-tU9D'Aj/+DZʨ`tP~ SET"*gp
aE S"1v$mʌ҂a`Xa BB*-ʉ!h9ybU՞eVnt?FU`/(/+'jSF E2
M:
+@. 9(k
+<$T)X,n 16)8f@4P!t X*݁JgF$!If
B Zy_j͘sbCmA05.8I[0G㒄 06&@6# H6M 4 ȷ:lnd. <3cPvBLQ'_M墰Pd&%= Z0rI3+d CSٙDF/qfA'ݠ_c? H (Ƅؙb V= HS0fIp)&%Y
+o$ݳĠ9 pzR~0r`rcR`|JګY] Gyk*)|MEzÆ]ŶܨC,p*_%+_iQ(/u5Epet`t9W(rI_P)g`9_`)g`9k){X/?B:{2*S(RI;IO X ~6 = R |d^OL?&jgMb)et*;- ɜR/
,,4 H6i
M:g
M:gU<,/Ӛizcg`9W 9K78Ѭ30!7!G[ 9TP2IhGrJ6?A~ hV+&O7?[N;Y(aeęTmX-*zt.3,٫ 0Y 0 q YBXv*:gH<OBJ
+p:!_ C
+6(|wNx G;D*P E: a ܥ:=TL#οzr$jXC
+ȺC M\21$ՏKYJj,!Gd!Ifwj B 8.
G>g&>h@N.5&i E8g,'z_О*Ah&-!d*-:N_ Ţ
+I#I@
+?&;v*"=+q7R6,t x䟝$sB"XD J[D !c_#an{# 2pcXk,#t 5ӧ|4OM5zhf-;#g&Kz̓m]춤 60Jؗ2(r/2p#Pah MAw_W0k^FN;@wB,-JtvP^W P2=R&`j&:OYJ
+"Jb
C- ٔ- ɜXODh xXNa EZP ^4 ?*g+ B^B+]vxkJ>eQ< ?*2 Ti]4g# ~Q!& tgl;Og,Ęg+e|<_=UGz6 BF;DH I v*TPa Ax_)3 dl8GPn)4 PX[qOo&[ĮV &7v) 4tlXys{FxZMcw6 uMWbQH#˿. 5I1IO1ٯ~rLFd=uj<`ŠRAlTD|{+Un@1ЬPBy '9RrTt\X$(} D(QA27i~m Kz
+Ea wq fg)*
ʺʞD$D{wQޭTaO"/enNwB{
+GlGO{I}Fly$1 /U
+>#HW$~*Š0䒁 ~4}lܺ
Z3g8>#GF y9,f`oI|D=/7CQpL f0z"yofN%N?`BX +7+y7Ā]1/mnԉc
Fd2 6(=~ F 2͇RT|'5`-$ΫP>R:L`SC2%NDiJ:%6"5U)bOU' 4> o7YmMpOb/hV KZMO_e$3[G Fw [9H`U'yr5Q$7B{=IQ Odœb"ZgU %訤`FveOVMݙҢc ͈ -USYjW8bHv_gxƌ Ġ@Z$IǐVz,%(Z
+<.ľd2_E$@g IT_B/eB 85}tvQ6*#(hO~$1Ϡ!EbN4סF_E7nȑ/Ibݍm;< g蘲ws_ZZC}PBMhw@a_z ]mW7H/Hcq)q=[2QlnpLMuѯ!w@h4 N5xg5^VZ[ F'X[h9/!9S0 YkpIc~f5XJ<{ 5^jtvϯ tw5Rʚ_e;im*SCtQ'QX GI)4\Wp/bU!('}K I|z!:ݸ$Mz4lHnD( E=zxK[;M:O
+!nkֲ6۵KL {)/ӯeop9G1YK(Ju]IAD{R* b @Z
j<lLLa7z^Cj,)̀d tf7ty+C֯bc+ü8ܪxQES-VC(g^DAz2 6B+Xd-4HIMR>Qu(/-'5U ?NʏO{1{@ )69jDU&;)֔ӺCOzCP)ltF ICjfm SgEz(~A
>47Yݴי:kܼ4uhY3_H@p 2 fBϫTLųa[4ujYN f!g=|AvP$*unX (q5&rg!E01%̆qa1=Q`3%1n%*_VN#Y3 -DF
+EI4\ YrÖ{
+ =bhaIhC*<"Ip Zֲ̕3Vňu/J/47s 8p ,p Xֶlfo,Kgv^T6"0~:tg`۵KW8I)# [[}4{ĻL`ߨtTt CXb?(`zE@, C5$j(#in#M@Zsۉ$f CR&JIU;y r
+D/wlI~e hUSW1h R/K@3lc(Pe t ^pv IXW1 / @ fAjf P `VO>X f>sҦlġ$6., wfwBz2"lDMr *־)aAU3UH{P jL
+Tp篎LL^Y$ XKD 4V :p D{p ʼo0A3.)(]*Hthxxc%]~q) `d6AGBk9 X
+ZgҙPER˞o)1ڑ}C+
+ʨ F# ' S&e+ X0 'P S#n izq-,K*:E)Ὢq <ŶFzJT{c/Hޅ'"t. F` c$
&M | *`1$G8AH[Xb *pB&D}6-bpzXQ q){C`3T饑2)!agȒ7U(}E>e%Gn+91Əm5zg3WW S \ -093\ד
Gq>&55 55# @kEąVc\pBJx 1FaK I:!1DM8qQ ! '+2\^C(p"KWYJ(L
ZN"(!_ĐǠc0l @:?OL{;18/.!`ZU5
+Ip dy
+Ԡ ~[ hvŬ"xW{$*aXHč 7. 61] "U:
YB&VS0 aGTLشJ
l@h R,D|_HS3Ua}E"]Q)/ii
WFp?:t=ů&Y dn` =S'e lDfy4ykaC\0zYЀzE X5G=P:EF?qB
H9Ct &)tVX<&=.#b<}1q :3y~k(CoWyQR*Oౙ0r %V)SiV`ךwi] YćBy蟌 G#/+'_R*&@àP ÊH^9w"RCPq͒0~!bø
c "Y0jYfɰ p
+lEŵ X^^8( x}PZ!=!FؗS:,Mfk=t(b "̌ $KʊRR RXf V+ - &IbU Bg%"eTxFKˡ+"FdRwȐ(S/lCPò/*$
+@%.@ t7#t9 tPo6%ܰhN2̜UUd8Iq.Ph0?f- 2)@\*iYRwU-t u-> bakh>w3 ؎dǷ)+!x \I*WˋŮYǮa a "AEp ]c&`~hZEP0v&\>Hq335X=ء2B; "|RV`8'8BR OL2bvDs er\f^Z!z\fB{OM0 fy-y $VQlѻ7X;. M 'txʗ~cKd0dPU 0^)@V;ֆ1 8TvYV٫\W43\
+ ueء
+ 1bkC'K5(4ӧd2φmԉa.dX
BܘG`
IX@;:gt1@j`@ '1`St
+]w?ˋ09/.C T?}< FYPfq0{%6U7F L;6`X [ng ,G3A|(S; 81] ?`10 4L/*UTw?K _dMWi˒( yLy%Ģ,p>(E ኊQ3Y2L% vFy :x /W(# #4u?0V )2 1Iv P|BQ L7?|IƇzxd˽CVQ; X_%AdYjE P !1~X4 2# f=y D0
+(6rrB j 0*bc ^}|m%o &k65.%xc'\q-^s +C D*bVOU>C܇pN#ţ",aL22B "0[8bt=Pd4!쐤;H +m:
++Hyu2@od
h 0Y+X+ Wc !x6 0W,s{xIژ ]Y-YG.U=: k #0X +hv]qëe@ů6 ) Nبg(%l8"kwyq*sUܼ_ac#]
+(u6>iL3 qXKWX \x_B ŧjk d $6va`qB$ 4D 8[aÉ$Lq
+JJ\JGC $!u0 , Rp>.dmPE|`ЋV :Yrer:Dɒ\鱑/qj-Z `:l ,
+` #QXI.L66~a$zg]EUU[)lp A߮(~}j8M OY;xmRMa1dd a (ѱ 2yM# -*!`U\LFG-z^\1aL . nIj1g!RkS6
+@O1`aÄqLc =MdLI/pBpU,"ȈW0"tFÁ=!IE+ ٫&{"H%]JpSq7J La~Uc(["ND P!jC 4<$ _Gfv ;rNɱu0ScM"j 2G }so)0 -q%# ąfpft?& gr4&CXDUHvH 4 4&@lLr̰DLukJsᅌPH^n| X01$jga
+B]c XU &4y0Nŷ8!Dčhь_!L4CAGGLjqA^FPhB%w/%.dq<:1
wbJ| \dUA/\۸W8 _3*` sc͊c
8W^E(N/_x%.AH7R x & "fWS/DaXR |x Oҩ4xv06n%L^yEָRJt>A3I&Y6KV-BX~}QYCSRQ!7 j+8 1(dXEa8'>2XIF\KJ{%P&~Gh^RI|K
+`2rcědB|q q3RIN@>-XG kj~YL~RoweN|CBtx"^cėCg >{xUCq#nMA05β f`*[$Z.U*DR+AhTrȠYBRdH$="]hTDx`awfG"$q/)$) DF|GV ~dN $3ędU'q$kЌ)
c' "brSxB]R%t'IMnjT&] P.>`s@X &"5^Dhx]^ # Gp >E#ĝ?\q!Ëb|8 ?:\ .gd" P5NzTL Vb),"J٘DrɖrV<#G]">l~}r0JD )bj%px
+:I܇^e89@a* lV~Ԩa
r{f M(]!O,?l
+hB E0RTI )h|-Yc!hT]n?E82fp 9|XL Zel -1 /f_'||MD-A2-R X\
+%e?KE#B0-$bB"WFlXyLԱi,%
|/De )Xp u!ĸط>6H {2K.(^ 4 6(B^?tTw 4I9CrG N01U6YF%V\1cYDT;
+8
9| c211<2 O H\]723] ֓UxȮ#j ;2gqYSSc1 Bz
+Ea\F @8oM1]WP
VPCfNH AI( ܫXpJ
x "- X,6qv"G?[)۔) ~ϡ\@yԉD/ i%.C)ĿDMUK~=lד/G%*k#~AFOLIB nUOXl$ؠ!̀اP
Q+Yv!B?v<9-7E}HSq%O"˽?W2=JtОE<hhL~* 838כ:ia
YyvC{
+ <`?VFsƯ[_4siRf "%%ήw
+BzЮMxN )})?bw/mnQ%96okcO~ >8 s[)/ 锫P0IJfB2!NOޛIL2
+%YnUH!/p,I3l/h8j G}e-[}D*^ E
+ySih ?zGPO?HܠƢ %JhG~1 cnksV;}
+ @, 9&(\{rfluV E$mmb$ AOp:T o±3qnmL
ǂY{@"J%)զQa6W#FZdX&)O E̙KBju%tT' ?"} Co`T^$j>(;(Wz ~ae}z7hf%
+T,~*B/\x*h[#䈬
z$mgBD_9o]w4%u,0^gx y }0ه >7Fv YΜ_Q7 ^$x(Д;]MH}frCRz+@ih˾D
+"
't 9KɧJUM\-VQϞ"=vX 5&)AC}0
KLA
+D&L#8w0W@:EM/ZhO}**!A,Knt?v( F> f(%BQ qj[Sh<ִ_]_9|pm5 ID#v E8G4=o:Y3P""Fo C\ :."HJ
=i: 6wުF7k/x(^,ڙbM7S&RG}wU
+CIM*%݀# eZ؇&:c mdW@
\>zOLu2,-ºngoJ.' IB5G7
YSw1e0^b`X֊Vcq'PzOYJC٣@W}}7S"VqIwpY_Kۻ.a+oV. F{
+3UvGIhU@Sk3qf
#_*@+8؟2#@[k3HhO}fh7l2͞f6xiTu[E[XF&!*(e_jsڴ3ofРbՄԖ0c/xho)c(9G!م'
L>e
+;0
C8$>Ð
+*D~hҏlC B2(Ĥ>b L43pbs|!b
+l+
+- 'hȵJTG+i|W0 \,L0R֮:M"m=:lY[<bKK۟cG 3ugHg;yui\y6ht||we̛VQ}<)--%j >(gKVtJ %X
+`,ֵ9e1&O-]vmɮ6P>r FvՉD`Egu8[ղ m'w-MZ)P;s N Y3vUZ-#Lʄ)R2:M) m]eh+E!Mt%V!BکJP^_v* A
+?aG%6yx売`8"YG>= -O"}C~ġMD}U E:۸O#wV̝y >f{̳n4i\&Q3]v83w:#VV^.-/!-K!Ip9!clDv/BMJQJ<e-Ջ\] ,P[!,; m5&/实#u:*ou`C\O7W_\L}/4
+Cʭ$ x1&
+>-- @_k|XOXΦ!G}7cIE .&ͯ]w16xj}N[y9:1S( _RJKHi)?NPNL]mP"AJe`CR;q Bt鵓&6{kάyНec毘2f_ursP#^kZjԲNh}*-ZP&%^K6ɴR;ŨDo=㕫\;
IT%r@N[yR&ݴٵ;(1%%e7~l=8gSZM@=8;/s㾍Z/0#[ONk&I @9ntݴ}8~p53- hHEb I2ټN8>5L!(/R;B
q} 5W1P$H@10S('6g=D{rT*Yv=[ic}&n o=gj8.S&Fˬݵ< +,{|-5j,6w5*6i
+@<]yqx~ݙ5tkg6֚f2nbM 5L= ;H$UM:v5'쨤` ̛JõTB)'vW3Uw,JcA
+'aA%2곖t~+]A n]:E d,ƜX[}SJ T>=&Rmqj= ;}
+~'O'jIb U:w引gp/mA@Ѵih"I$m9|r{ A65zJd; ij0YW@;
+^h@@:j4l/avKBKFn,KSyѷ;
AU*ERƍ-IK>.' G:&ήCd2=3pdF =aVgez-;gaHj]1g)* OJ,Φ38lJi3l-ɥ=sc?'%keB hJۯ}ho]/ez;_# !̉Z;w(2uzF!
!H䬁
+2p쌝=L߳'2l**h :,í=_2?*Hd=bɧ͡ g >"^" >x+]7~m ;˪V_{ jQ'^Hk䘵 \YXn1 #M@AYL
P:
+N}CP9Q
+"(G~>D7HdYJ:?T l {2kZά1i7$ VAkW@iP<
tgүfD4't7k
O7 Ѭ= !pdPOb mM} (S'Jh?&5йExW[k_Z6)ԯ*!`J]4
+ `4M_Õ{wO>z58oVñsrx"J_Yk)ԱhqϖqCz -KY'6YG}"v&MA6fΌv`v <,}:9 WK)mѰR1c=˻bf,] t*ڧήvr+F֭k m E'FǨ^ oMY$f ølS .ɦge2aw
+
+C2߶GY58٤, }3$JB D8g(_w;$1+@-6 L X+az;O}0~%!OauSEtAnM>2^!+z lbTh-,&f'Ͱ3`;AqO B9/iv}U
+~ "=ifڌ3'MA-cȲ`l?kô8؈"!3wciήCp!,ue.ûه^BzLXVl b
+X!l Dm3vL"TKkmb|7p(,Ą-!v0ñ3pAd dR RAg)Rn$;^>#gu͟
ĈGec/cq fkڿZݴW Eǐ+uז_*hm Yΰpb`>y3>6}iu }aV5dWWH
{>86&˰ewuK
+ZIgp
+?2
PB' !<ꨳTaX
+ee8@Qo c@0 PҮ<A&B UӖC
WMܜ|R5XMfY ec' (L̳1}:Bլ6MKjei6߿*vlkM6a& IހjЎ$MR֦զUxSxo15 oNyt,̊@n7.Kx=ٺ}D٪ڜ$/ `.W. 1J"\)V<ߧUtz vu"fHK R̟#!yHwHXe9;d~ q1OU2O|_YJS=: !{y[ c \#~wO_ ^O.sk{X*. b5U B?Y;v՜+<=z{ÅvgRa;ҝ4%z|yNq
+5E}`ת8a)|T^<|es<1Ѝ*[_~`p a/G̵7xzcdpaMHJD%OܲģeO,ݒkU[T~Gn+~r2 =}q^绯 )vϏgsxO= 2 3y> bJtϪ ga
+1 }v5urz~g2Գf YL=Gatszo/xa{~
( 9o?5\>VoۀQXz#gm?-q-#~àjB8
m` kݚQq3k`ˑz5{,p!MОY~B+ {?DuN[e5qիL+K&>
+`YpK꼍}Y7c:'ܫOKι_lHh ᕇQ*U#bV̇LyL9[87 :٧!{ОNo?39py?-pYHrڙZ`;hsbk t]yv @Oi|0Aga)$c
WLsëI
}h^DZ9OʠrތtO\9ќmݪ Z%[51< Tg_ɹV̻Ow({| In rU,O|6] Zj +k#d7]aTӺMkM)mԑxsKힿÆtn.%ǟ*f
r&h,fk mU vas;AjWels쑸o!>Bj[#*𢡄 jd3k&ϖ0 Xlh=ltLYz,~YL}3P,B5fpR~Lb= sy:9w}kH㽵:
; p\푿F/ua "=1 ?,sh'u,%9t3٤ڨt$iAP). CC۸?Ufݾe 3~O(?:9UT_UӃ(b!i'w8l9hwÌCW0=7Ю)&樎 6?jj8}f5{| a [B8(4T=訵9px}ͷu8^. ,a[Lp? Gn:+nc=ҍCb+*?UY {E!\{a R |g* 9dk/' .Kzə7,@枳aAY;;zz8Az(8]De^ݸd$nGDMmtxOSb:ug)0: E킣F=4J j$S6
Zb`Wߛ~ 註(=>1;"aiVSbw̾(N
+ϰ%7)&6. $%t;r*8i"|8]ދXe In5#,*O*tJ(( mAm[|jm.=#PѬ}@Bxahё)݂IS\~ntsEh+ "j4FՔ pP /afYܹAVW ߔ wo54@=y?VFq !+WJD̳C s؋l*eZj.6(K:`1 `qm|/?{& F7-I2]vXʣlυ;
3qN&69& <ڦe"/Yn
+K@nX]ŷ`tvPq Jl=- Of2.*";!
+ K?Tqpo 8pftFE
!38'Xg`g_QM;2}5_='AfԂ 4T:魦lzB[-A.g+H)O^ q| [`Q}]ĉ1}3fUlXV? }gT>#HȊ B$!&% / HQe{3LI̝$AF0/ -csO ʷanw/?4 d@R, 2_ $+((k&R`ߟy<<=nWdaFYWUUqXU8 RݘnU9 V+QXq9s r2ThH$TEnLߏx$8.5$l¸P$oseHP9 k 8#% gp,kLF tt+@0۽%Kg2 ~3y` ,>v1Qde23& B* >yKLJtoL+/gʞ{-RIMΌ f;U0M]ՐPˊHhH&e=wf` yS:|(:)ؓ:vk vM':no4UvkuW]ӝŤ5mb6iwM?dZǓJ9_HW㛮n&>, e0H `\a)P`Ѐ
+ @(Z0厀+RIҴa)Z瑡$˺d( )˸Sũ&=>}t쭩B #%m ݾ)ilZ3=[j;|?'k#k2=\% Wg9JsIOԞq_u|յǣc, H|B(S> Э;nZ tӗ)qRRVNrkpJQ)ennw5 cwך6aZ:awo6Lۄ?Ws5;#T@ ,0bT3\#ϦMx8α;v~Jt:pOߵgM;~~_k j($P(bx('|zkcVh-jMW[~>gٮ5l?JRݳBQI[@
+(BZ%F1$B6n
lGFpئP
W-}0OkO_}Rk3ll3NZc C @pH%CI;@Q@ A0 H @Q1 GG>(:tm('ĢW6s<1Tz;re-rl vElA\ʋ_|@?D ͊NL # L)tMV4.8wdhُm`hZ _kͤ
+jL3SE?Tdl/ &bUTHxb+yT>1c$!4,W 5Dd ai2FAL|ߏ P ݻ2 .l8`N˪њ#~^ a
[/{3emt%,gDn+F\m*Q?}Oa{JJ
A˘- |bu?7oNo190<oSVH\V (zyW HǕnbM|N"_ M :bs"B}s D#"LM tQyQE;jn]o^IKoȎ##HiAΉ GϤ893ʡ09k> 7M٢s:߸ ;Y~)1 ۿ C|(%י?
,
+Ad"y<I6qcREһFx&J,QD; !0 $dJfs~h4cebT+6:$!#1,/2yW6nr t G;=M;[bL]\%( fa M
+mK5AFkf<-70&yGpqC?04"`р'~, T_[H/k R(yT-۠dDn2P|yB Jnaq7w5p7фDYT-U3]J@-ޛk G? gUWzw:2˜/>, pDdv Zh ~GL= z6g"KOLF
zx؏wIHگ\'@ui6EGHEeGPLl2ol3}v$J-6ީ}M!%dQ@EH U#\EJ$ ]yhd+8nulx~pHZ"K TWULt60xѡo#_v$tw:`dNrG
PZX9EH(oCʚt;ۆýi)_%oX̹` n\ŕy11N =%N fk WO)Zs)۴-lO j =SI/m66]3]|RmC}O!WKahG)z(_މZ'a7{<_dLg #|
O`:SHb
+usGN 9 +a MaS$˅H2PP (<=
^2}Rm/;7~.(}v'/؝Uƀx} -u.~۬sQh+"fŸgi+*WY`D`-|*2x0,V )#k;}L4N涉BO, K%Ҳp<%6Ѫ Բ;03SJ!,8)o.J C$w-$$,xL3g)?;1Lvx3nKΥ wÀ˚0qZZ*XPZbaP.8_,jE-ljnSs^H.cހXTO' vs A>/}5
+Leugig1Ħ誌wuARckXF\s_b}a3`;2yVp4])*_hh0ŴJ pl%7!_jYG!m<1%}ȤRQZҢ0?9˰ʢ%cH'U9@?Yħ\ QXzEhS2ÄDWV *X5QegX=KyU 1fB3rNR (fF@gI Z2vpPG:bxe\#B}1w.y8 567F/Wb BIC
1LG =Z
T{,ب~6 Z!sIL+|4\ST#= xvsI9z%+6:0V?p6{ 6 7uU FoMLvvi/,^,w ĵ-C? pgj_Q+КF\VaQ0&L @6S.3Lܠ Y%4&QD3
+kZ;JSEG㼭O:-I՛1] \o"/S0(SR&8b^&v;LŦy'jO\dl.8@*6{U
+ʱyD^vBCqފ/\'Z:lPH%7_*2!yp 4 R%;s m[',=խyaQȦ 7]- TGQZiNpZ vK5Cy0F ' W4 =Y%(8-1_ Cʔ\-
+W9eBIo 3Pwp(Ӂ ш2;imQc 5EǭfQ(zK9o\MփNX^EVyQZL3_l WS ?4_ C^GHUoƅC=KSIYpPpޕ}"S㢻%8t|tP >nN X غzp/{Zkm4
}e!x3kLba_(Xg$;Wzw)
+J\:byT99HL'ٷnzN-.A^5P qIb
'N LEd\fy;A!vP1&gZ.gu;V`0r8݊ #rv$`$]2,rtFʙ<EФ:;`
-\}KcK%O8Y t Qehb9È-F6h__:Z|kY80 .:ﭵi1]F<X0j1]FgSu3g1Wl_
+o+mmUt_u
+_m?_i|Wj㏑+w۸W_Y+tt *o]2+WռC6ff_ Œf̍]d%9ggΌ7b_{ZDϵZ8A|v=9FvN4ڧDvpy78uW] ' | " _ޙk]߶~Ws}ZSsaAoՂmWFQljub3wAlTV݂FeY+xckډZ C
+Ld(Pb}(ևB>סX >'⼲> ͵w"SkT'BuNԉP"n{i Չ}ZmZkuP(c9+ jw"m)Cu"QNf~ cZۯ=J-~c[jyRwPsߌbbQhkkѷ}QU+ou~ͷr9
+Kaօl h@Wb}>
+h"Z+$e:P/ El`}32L*Tȕfg} A !|,^gCX_ hb}|a0)u~ݟmֽ֚֭~L{Wz͚z]^s1|)cko\ ^m{ͻz~v{7Y͵_1-Xo)qԵkmW2MPdx4sݟ>߫C]9Cuz{ ͳ;SX c}>X c}>X c}>'v=3gl{Sι>Nį_ `'z/ݟXJwvf}^n Ps;R7Wib};9S;W8_;TM9ݕϮ vji~liڂ]; ,@ jP X zs^iV|V|E ڵfշOq~s5;g `H .!l7v[p^wZ1v{w|5{o~sZs]Zbyjwz֊kZ{kZ{u{sfjOSPXwm/8-8qUߌqƺ됭=1Y5385ܥ&z= jjpj
nkW7kkw;cX` P >knD(t
+T~ׯ+sWվ<.cV a XXA.$~y4&oAL'>ݗ^RމZ{͜V/8DvL+辥x[R++Ԃ3cp>ZkL/8smWNduM9h>}pޘfmI9X jucY;nZ}-8k--} ^iszck`GOZzAřT5+6[˩Vl9 C"p'CՂ ޚ&B58D?vYE|;vv(6wi1L;((յwF=g\\wYE@~r 9} |NjpK[Nt78V@.p;_kVXͷCͮ6Vk584upQF_7$G q8хˑG\.FR .[lL0ΕF1Vn0L, q _# v{"EgܬҚ G N3d 1biњF{kHZ`[IG gFH`-ȀX 0t$ p 1_8܋JҺ( iT, k2:pب46 !8Mtͷ'H-'{ h)+myuXb cGrhk9BB|,mn~-ֶZtJlT$ &+ JHroq$4\8Ud#nEFY5H_S{ڭqi4Q+i{y Qh i,FlaG
\)M$dۨzIVMT1T@3$m2ZU(%2ZØ%6Y?J
-W:fRl1[xxMMD&,<0e_xJg QbI)%|n&Aup]a _L[￥K6ipCuC(6* %LD2%M epJ[ڞ@FNkpv2ʸmČ}3@\A0`X_jiyu%-<FLDr81n4S6:X,%bI+Zpeb#',Gqr1E (A( n 8 +,0eBڭ,oTk$%d4Ҏ #m)jFX#v+ɜKV(1"XYuaX 1E,RKM
+Kً4Kč)i e}7Wpn8/X2Kp1đp,g?^6֚bnLFQą[ޜ9_cxkc8?\2mfi;?>g4LB|wqƶn{;gwTomr[y7U9뻹ǯ| ft!&dN-3-~Oh> ZN|kv^
&ioV˷wg-~}۽-{ ߞ~~n}}ij'_jy{}̿Zmݽv [߯ߛ-6~}ouk_};{BfOVUg}7f\sϵmk~sOhմ32` 0v.U".U\.H 'b n+oo7[1MZc~iw:Ͽ5>?ֶ-Usf:ky{;ߝsｘc/j[ijm{[~5M+n~{ՙռ|//9מдc_lloו_\{Bwif{߬_cy8cZil9{so1z_~M묷ﮱxy6KZ}mo;-Ϝb7x7\ͻ'44yίic\o{g3r[1lo_{zB3ci~㛯>߸mżͿzB~YWՕXsyycijy~~ys k'4 ]5x_-jmsjlo6l{;gOh+uzoq9f57klk]c߮ۿ\oͷ^q>[i|?w9/fmc[Vo~?滳[ugq{ǜ ;Vmݸ[|?yϞf^uZl/[g+~Ŵj[}q֝os[4-lT&DN͉)DL_ȜL# &O3E1-J=y(& HM##)!c4R$(!2bDZ\+00`"}P]}5BSh$4V\E!% /& GEB x ܬ>nDtё!nqJa
+->3FXp2vsTX|DZ#g0q>7S<
,+Zx2/# =$`'!N
+Bf"Lapx=DFe4z(DFhxgC怋
+G)98`4 "
"I0:
+K\TD[<|(p UpH z[s_{Q1b_Wzex~iZK426F'T$눐Fsk ʙGD"SlKlɆKbDeS6 ز!M洓El|d
+FQ|d^3ʐS#
+3qKR*1hqƢa|FDăq]c>:b<YyaPD.Xn<.Ҹ8]"tY=`<\H|tDzGYf bjhi0(X< ˆ6HY*:uLbU\B-ł×g`OE2h#GI$2È>
X
} ķ[]reaΓ{>j*q
9dHB*aj09Ph T
;5xO kj ^n0x
1ȦDĹ4".(
% Y2l3xJMD*Pp]rT@*d1Vg恪DbT`!Q=@TȰ+krmeBk,SE`KaԠT4ǥ|݉p\F9Q L|Eay,
+ZQ
+B(9(6 Z^B;(bDȈ(' "|(+s
+LZ^C)5Bp|0K%dB
+%Thc P0qݐ>![ *U h8|l8)LCFid>'+)XbA)da Jhʴ2}6 vկÁD+|V$a iba@
+/P#+ Y*2#b8TQܓ~s6
R2KQ(lDrt:0'S(KH G
#%vbODE%sN3%ԦSJ;<ɸ0QDU ܈g 3}6&sOQB[(nFH#q@H#ɒFH_w"Yo h. |(G!\)HFiDHWe
+;hŇU:z*U*U*>B|vx.ṼH,gda ` \
endstream
endobj
26 0 obj
<>stream
+8VTS4E SbOVE 7&Jh/ 8H nfX;PwFau:8>n d^:oym|l|l|d2$dH&HXV(TaH&.z CU*y_Wx8"*p#V4_} T9Dl(Io7Ga#[Io 舸_w
R,{)j a"1dr`2_wٔ_w29UJRO&F˫Lh:S8X^U}W) Up'J2$Lf2m}6?QbHS!G>B)?00}\`2:DrBVfN!_gza0-ĥ!WɄsPg'qBE<[ϭDb8)/9֩>y | gV(*13Ztq )V҈2},T%
+RNJTr@,ِ: F>4baU1}ۚ +r j忮2co$:!Hco)G|6!Q>B2QU )]T͈nhyd5JhX^UEE`dhNmHpC8c%D!WJ G
+?8x
z n
+ }`Xpk%
+W9}RhjIr5h` fz@>X,HhFU|ibPPME'$hHTeGB(6@JF ;b$ FIDɆ2"/gpy m6^
(2 @O`>\<J
HTK3 {sQP0*F4b J+$b\vdufU}3{QCC
+
+G
+`IGx<:BAObCT
+6(&_7 dž =j* %b:HHǃڨ>R;H6tJ$;mxjVP.wҨVL AQN!
+yW48*n[^4'ƚА @f+Rze]0qD`ظ* $"U4١QTS9}RaQ{؈dי%s!G8cƃ-6Nɋ# .!2Z \T|]]|HaťQfdD!1BPTă4ܘp=l>2ö1>_#EqT2! Mgdly &>*b xeM
ܩ0$jbyկg-"#Z^c~VHd4gs(6$p~H."p"68 s؇|6^G]
+bq<94JB^,}]%1FFe6gK5$2 TzG]\Y0qum0q
ŋ ? 6
+=Fr#>`\ M2SN:"6$6]Ia2 =d`bek%"9b.[*DFǑH/C5vPQ)$HQxU. >NPJ97Ol+{!. sQ~VӀ}j hs 4A8rAًf3ϩgR۬4LN.6 & q=dVX63ZQ l7Y ˢqQrKl}x\\' !
+ +3! X]/~+Ē(-+[WGKxhaNPC%A!萈WSC*CFHf&"ɝpdpŜX$lw1R! ٴJC` u*|pՊ<'F^!#%"DCl*CQ9p6(Db`У?D!2
$WjV\|L6zP>NV:x,'갞1{90$4(p8T8* .
G Vl\` T|cxňF+cఈ
+ZFDwdlQU LFFo`_aV9Q,UnqRUث.3'G :2x(hQdYJ{^ƱdTg3)J
+ds(t" 0h$ (uh cT0rRD,P R HqQda
+apزQ3OY}ݒNZi[uv:[3ګ,tnQr+Q<{k/ ԙA.a{O[ZJQ++;ݞ'l}Xs j5/J0:5}i Bl!lNhuU Oˠ "E6enkGgg\hc5܆y9а|wy31҉ĭǯƭQs1+ }Zl0[d5 {Y .u X2xd7oXR= .ËJF
+AG>hT .
+gpK \ bxg1oh M##Us/dYǀ ,3~RK.k6e
+ޣ
+ H= T~1Z6r~1CAQԲ1銣&hKN ޑZU Ej
shy(}qBM j.ceLd ~Oq2a96-VBѰl g)s2/j?eJ@̽6JxB r'D `) 5iC
+֢b&a /?xS=h_25Mл^Β!/6W)$컩>6E:qK4@!=HlW]ĭ,fz.w'Qtv9x]@\ FʫoI(HD3jr:I15@zc=qBc
5.P3v5D09 N e8j, hQ7*h>Y Ԇx"gmVhpQ T%v!r6Tzxѧ ҐnuVێlM!Dlݽ?S )Z@zz Zue( 1cVjv xNX V%}9!9P?W: >EJ2 mdЉ(#Ǫ=-@B]Sc mH*R;PIiqo]&2&Ya$AXH!r+[;|m3Huə ,Didؓ){Ü(!0H\%8JBZvс5,ِnq^exR5"LK!73|x5 ;RX/s%wƐm/A\BLdy,⽼~- n$ث?fay Bq3 AWP{V wI kHv붚C :]^5ݳY<)OOy\J j8ls#z) rV!f
Rޖ./~.+#e@clE|%J2mh1Lt=
+B^1, zɴ&Wc&*\gDe5{#ϪRb8E}B iclGba0O \!Ζ} AB,#t3IIs'./s~^<5PԈ=ӦxMD?r)[y2ڵ̦9tyᘹ@>qkO pkD$~L>PCImF>?=cPu!/+@1 D0W)RL/)0@[);eJ <68<\z5#0YI$hd]X2k@'[n1
܇H)C{[䔨R5ePHd4Qɪ椛
+cߌYoB@ڑ5%^؛,9t I0Ŀ%5xHdШ4qGPNΦE aZE3g%=uAda2̓
+q\A;kV qY jG d,,5 ڽ&sƵ@/ [$B:g,Oۛz ,Ui>PBɜvh/)leЭ?ze1N[q(c`g!s|M@i#;EjF N-jbU+`P¾35
+%2"JB3}5TI8*Iܚ ptMibhvr, \}uU x4Eӫ+[dCE\>MوFCaGձ*DLЩOyp Q!X ۰TtEn` :璩+v,Jrx@Wapa$~㥀
+oa |,½3"'Z7' _܌I!mqOp ZwQ('R%gvHq蕳{)cSӆ7RJ9-HKcx_!?eDwl?Mm0ؿ lU7ej?ʡ0 G a , fEc
xiEؤ ) rچ8ohL ";ejo1,HZوӇiSၞBom %_sCSmfW %
؏Kd`{=ufe`dJ8n]72B7{h"mZ!̗xCo#Hgbg EY`"<@ ?8igW)3|00Qy:I`~X84_ [pKMvd{EI
5u!0. #w2ݤϯ|9DJ
=>NCP\K5雉6qC(V츲9ټ
+ I][i(
+*8Zc챍YH^` 쁦^#LJ;
+Z agsm1{'JEv\b>ikO&\>,]FTZ\C*#_j0L?~H'qΞ45 ,rmץ3^CY 5*(!m= F2Yȱev o.0Zv
#JrcdL|alVD~zuU=WSo0jßD/QDb9А@ CeOQC [5B&'xU+{"8KMV[1ӫ>( N"M#xJoZ;
Nղ_[튯UM: ./
+5g4 9 e4E'-9r
0Ba:
̰B=:
+O sn<'MNƐ8sN_ 8HɟjlEy\BMQҵť48`DSC0oM3jlx[eOz
+Jz5=J.9Yá̊7a/.SaчuKzQۣ1#x b-d8Ҩ7| sECjZA.ӌyWLҵ0fiJ} ?=Edsru ?@Ј#}",.jē Lydfu8;|l" `CdCPbC'g;X+ k.d`CD(Csi=ݥťblNpi-<T28 %#YRş:ў|-^*n( UH^-}%;Jsy|&pzIPuIJlX.SO19F(.zۅ J.U'Yح$4o/3ʥ 6dǨx:7 oo7"
u7[{pUS
;xԗaX.641YժiԷ\43&[pqdFv74"ebQxb6&Uai= -cVDϪ ]*I5:{ @OY5#M'u
+A/H,!rV-딱¨33 *f[Yp2aK@H\Ax&V~+\r8PYl9HUe9{.q, a 2]c8W~O5-$ kF.t9]iJdB! :}pj1T(rh BggH쨩/4뼗UiG5Ek;"'Wɣ1Vg \UNJ/f( HOl尿zc;km6^MV=Q ބR_J:UOT$_QZa+u --]elbPou:Y)@Aq%FR}T4
}:MۢS ׁ.L*0_Hˋ!=*[>ի 5qN(6+ \nDK;Йv
+&
X!#sG%Y郠a p9 \Mn0 +r R)}CxS+RL,;듙DX c;1Ŕ?o8pxr[w@_z56Pwԗs? >oWaJYbŇv(p+&oz$Rfzl~ "rizxGqVTҕ$DbFM(O DFS*3ZDŽb} 1R)f>p~O Hf#Ĉ~L" |D 盛P#*R~Z;g~k I#Z3 b2Lr+o"H^$&Qs}^A~\\3I&7qEXzYc}2o z)9 ސkxJF1.D>- cf~Uj?pHZ%Ka#'2!:$E>uxhř(ioKE^i.
oȈbwֲ&b9^~5V1092LM=ܭR+'W9Dm,HIpB p'D(Ft|9%g*u$
+ <m5= _+YVo~v6xà˻dCՏ7251sN#'
+a5`y)].X^pzH nԃ ) RpY9h l~o3e Qjȭĸ+yv2rL.`&uDŽ5!DH3ȁL7qC=^+RxBdRwtkPԈH;dNT
+3*UJfv
P6݂$g 3a,軍m+7;?#2#<)eUJ WDh}
+q:.l
:TJ{p@K|U^ .ҀdP|]tzKp?C BW^;ɝ4
i_%O .Br%*(_WIb #1@%R)00G8w Ea*4J(ڜEhKB
+5y $=Id{DM""$B(?Dlb| [ $%u5O@W ?1"P h ;G ^=0[<3\ G\c;;&t$@W_[^G|o^4H3p!!DF9GxUi0*ErA'%`<eV
+LGָ9QOo[q/h+Aދdy:: TAd0)29$&Eo 2Pɉ̖%hVfyc $8yf2CQ66ll pL:b^E
+nc72!+p5 <;flg =2,o`md~n\_)rq!~e.ϑwa{Fݐ~n E
+VٮCct-e%r! >̚%=,<5q5?KXEcR/|_>mb ",<brcb Nrsۍ%OcL6Mx#%e6HU*m,c `@"P"
+DhZ+3Ц#Z!*ցNvTS[.(!SOy^S7Eu+ ;y̙ٞM;xlg (Ax1*wP0:;u- ɓ6c c4m;Tk5,¥T3H=*n8w7%xЧQ (<Q^4
fNOvQ)1z.\Â ITd[]KF:%1cKX>ڴG'< 5?
+uEa`&lY%W .gQ q$T?YJV@d }MJV%1 %p;t$mNzIH:̠/uto$l| )JDtbwMpo i*='5pBu{83媸}}nϩSNe%E*pdd/Ҡ0.`u bc[j sc𨩉~y7|LoKSӉRjwv:tq>}L: pa[mJ =U!! j;;PCW҈4؋%FyKu`ŮL ӭ&+"Sj֓ {QWCθ nRbR5dRr ̮N
+uC<
0]WHn'o, a&cWLTX[ɓj $|ʍ.}`]zRcN8++= ?uyb£R?q H 5Bg0#d Δ(7GkxN[9 XD{ x(i3%ae O,Dş/iBeS^D3qk
{}HǗR{Zo[\-fM>G-&,L4SoW"+m.8/@O mRo.gXN*k-ЃIӟ8KFM|e_Kk 6j9c>˕"=NEq503ͻz#5MjcpԦb7$XRQ FHdH/oYopCm߰d,TiDXddʼxuhq dWMј [#o-&h(=V_$I>rսGkTv f"/ wvp> lD998SMEn~Ff,/523N F9m'2BV}
C_IdIpϜs,rSCgMw+N% QEWP,$|r2& I܃<$oST?
YH]lkonŊ3dʨp
"y#-9NE(r74͂W,f (
Z,ؔ71RdIGP(A%ȣ²7-òM+7@]*QzR8Tz$L H=>֤tO0^8n&C6\ ^f vfq
+ ĺa[T Z z(w.U1Z{Jy" 2
Zσ ?Xtm]D?
+K?(VVX V ޱւȹ ɓ"@ ?(t0#DU.@VORkyzhPU8~El ʜ}vR743yWϸmՋL3jRG)?? ;XwD(̅|L6P4>&O#5t
+s}z-l# ޅ_|~#af%8߫$AJqM8+O\ S 3]4t"KX?'a{:nDs{@ ,'u &k@g)[Z ?#CIy.cTOZ~gA!ِS!8XMqd! b\<Ĵci6+"\\@AE M$-E;!v-0+. $ l^Z*(YLOϩdէ P-7w>S :xK'Kz.zY5hoۤ&UeluVRߵ|<^쳺xUղ#9>b$`m9l
28pާQ~8ۇ&S
jmOusE#7@P̈'֒z,T|O|0Ѫ"ӉHۑA4z3Pˬƺn\]]W6*&ɝq6rR@xҪ%5$kƫ
LAJb2<MS Y,Dpl1 / ؉^z Ѓ`iw8>28J+ax(~3J&Вg~9pׇ#j/!{ #Zޅ`5;EѪ?6+!j7{2fg u mCtI1@ʢ%f5{<6"`K8eKVO"kٚY:T^p 'rTgh2y_I 5L^oϟ W%]~^N$?Pa썝\sPҔ .U\T+*F&r!9V(P fd :^e}t}[K/HYq ͮrܿD& ylAfX.`療ܷ=Ɣ6oV)5ŵ~ґMNj W!>'\Z #!}ڥ 3n 'hX3H|1\P "H5 @]Z+rB8gbn=έ@2EAx%ӇXҤЮ|H
(pWf6
+% \L
3C 5[Z Uoq2UƔ\3qy &2HAUjmDn:7٘6%qY艈?զR &nџMS`z!6 $ˡj l
v)况rT~kS^v\WPDq$w)ߤT2 ܟ>T&-G.vup
H9H8nosE x+MO\{JczNABW)1uni+ 3n[fGX6{XG3/`f{oDo dLDX. >(*ڀ $l@"`>\Np5Xfa48Yl۱*ı؎m Ta86Zφ#2Jzyl"B٬p0Hی$< H` lDJ :,BRDžBy&<$gֳi0JrQ zi
2pjȘՀ|@@z@P٨g(TB`J!%" $LD<]#Hɦ%d I, Yp$! ay )tl}tlLgL g3&n yM4 E@fL: u
+
+3`PDDDJ$(@F.1r" 9PD L@1p qA Ȉa 1J -+ 2""(6l6,<z6"
+')"3w1J0'Bιi>`tt:)>3q"
.Lh:Q@cf]\xAG#Jz@IEtG8h9Qa #4
+htDVlH$tS $L*PR hT
+8
+!ٰ :24(gF3QABAՃZqi8yEJe;P
`@!˄
+BG#ڱCCPŘF`nf41h4Ba Hd2A 111&!i`#011bDld4$\@,;9a# %}La
+tEE:88B˄*63`Abi$L 4y@iF)! 6`@~*d:xF$aH٠@`
+FI"~.)itr>t ( ( !e /2"gAI2" p--8r !÷|fŃ rUR#H6 LL $pё1qKJBü̘4H@gA CCIHci*(IBG x2`x`/ =ZH8xq yXVN܃BCE+6 efP1=2舺у$hN4 QhO
+
QQYltB5H@N@">`AĐr `p./ BP %g4l`L(DD& ^B@ $2(!>%d) hJ" XD.R#Q(((.%%xy iyd 1 $$xP e6".b(0*J0( ``DCK7+K_^}iؾ7MWי_jW^ 3#wS^>e}3_MkV3v*6/7O46˼Uij=i sOMMsj5yw>MۮyZMyhjt[/-
Ws'gf>o~Dw[L~Ux8Ond}w>[ɆϨkݹ츹ɞu[wS
Y_۽ֳ::K^x̆կCG[眬pO|}m
cgū\MǾ5W Wk/=sn[My&muvram۸6xq-/u>dt^'Lڛ N֛ry97IE^B^}6T䥿hLJk\bj7]rjz{i~Քl&]ݍWSrߓ>-s,q]~5b[oՕ'}&6]s۟Z>~gڿfqllI<{iWz+Wߴ x_Mqy{5:klյޘ֫37uJ ]~gw]Ml.J \\=_k&P Tv$X`8N((( B& B !0b;V DEJyP]H%tU $C v <|Rf6HN6R@Bc,vX9Y6*U,
]3t :B!
+ $ :MY&еl0|csM6 abB LPRk@ 1P8)ԇs2Aj}6 6`(XTL EG %Q:$LJ.x(8: " thAi@UQ%# 4!12M_ :;;
H"5r,VM8Ѣ #G%$1!7
BT(QA"bANXZh@ Si<.$4 .$8LD8f: LP|`lv"` s HHLtȬRYaE` Dfe<P PIjLP%Y< bbZHZ:vŪ-BIұ
+ 4Q9* P9#Q鈨T *)p" c, D N@)jQPlAȄHH .ht@B:6aH9p U; % - u̅ʈ0!)B$8̨49V6 6J!t|ACI-fSi@t0t4( #ԩH `AI(cFc$hF X`DH#yCI{d*0*$Xap蠤 > /#`BC""*5OmG2>2 !
+hYXAA1!夕4=o1ۗ ueI+ϖk r}a:f/~js pB}sQUtݲ7?j:-z{KVeh抹ߘkߌڦˉvȜ;/f^{r.ۿ&'#n߹+gcggK^D3<[ZNq*w[S=uoSsxu*sRts7yJ^h15ٗ嚦wiTIՏשz:I SLܧn܇~!z2W{{Nx x+=m1|~Ny̗Sz|&Ϗ 3E˵q_>~vZa/sgo_> VO'l^6^OzskU]ʓj.ze{NϽPw_=]uN\kɭ]n%%s[ٺ_Y oU^Nw·:=:ޟ3v=^wؼQuVZO ߖ6ol^vا^{isWi{~_wӳk ۺ{]z?7MV_|?!5
+ s\kKÛ
/54$u)OzO"0 NL"'|v$NӏOr=W7^UswfwyӦsf'5$Z:N8N儊8Mk[;ur.m<ůlujFTk^;enϔSfz~hkǎl֬Yϻ#/G]vL3[s4չ!J+bn#oBVO<[ݏc}\DO[:᯳vZ2Nm9ZݲlMV~[=v1J+S^oiVclm YOgz>V5GTcꋘ:ݭmNnvsTI:uM S=نy:Fվ\ۻ̌V_&Ncnd)&cړfD3^YMlz~8jV2B?^C|;Ʃ_vy_5?.t5\'L|8q}2_~c/}o}Ce]5=_ poOcVʷ9F|N2BB2
+(8 -=en,?дq!o.dCieBk|ͻ|k81 REQ$b
+b&ѨLhaEH ID H D.RF j$
+@&ۚI++nnf&}y+YVvf~kRV[ei~ﻲ{6ϻ [zӖvDls[o[C}ujV{/Lӳ<[߿uW.!d Xqsuz{u~wSϳlWwd|+?q Yn5]&Tf\i[ڱˤ~,.ltv|v}w3̥gy=/5WZѼ{[ٙm缯owח>w3w)w:k}[؝fiKW+sc5&6ͳ -oWZܝp{67u:u^kKN3M ?'yg|̸~2yi}j 9qˊxkilK]l-I5UOU oyͲXuu-ۻeZj_x;2 }lIyWLhyƧ~:aR{]^kʸxvTLjk3<|Wng7?LRVѲrVt][|Ũ&z[FDScNu_k_ɵs}[ cj.}&ec6{{eKSƼ劋jnK7S1?zzfvǬ˹,їsY[]m7הU>NxɎݬGuOM]W't[][]?.fŸ }yVӲzlnjV^;VS.UxͱUqZn5q-kj⡷?I/M}J kV<4FSɷ}z{^O}LOi3:j͝,VSr[Njؚ謎 7Qn=ݭ}}}=˝Ѽ\W?#3:i
u%ڿcsw>[S}ͥku'ttӭ&Exq.txy{Y.eƵe-Ut
m}7uO m=woy9Vwޣ{k1+kVӾ*5;$9geܵ9顴lȷoiu~\[M+wXVJ)$fؖkܟiyk$raI QP,HP )#.)d&xp~ϵy֨TQ&ũX$TJ& 0@$
eHY\,HD4"` (!0 2
+!
ȡ )vN}a/&+ @(;DXnoIjpT|aL?bo]2d3&:v8#<%i MDZb} &'CUq&rc<+ٸ;N0H(C # ZH
c+Cl Zy?9J+ŭA
+^n|;8|T!+-2t6-ZtD/)
IN -KEUM̕? !mf ?!Ѐ 2{}_2 X}#K2gPцǞjQmR?%v^ ugؤ'{P,l+"W W:7dq4^^?@3= }Dᱵ̱b;xs2r2qb ٝY6{ch&C_>' 0RLpU|T(ۢ Z2`m?̮D=3SN`-ǭBMN B.0$h $fjm6/ˢpݙE}w%Z}r["J~" FtbkL$`2mek$ GuKC䱂f4T?'W SD
+:<8Q BJ>PuC$5 TK3T-$F% /$*Xz^Zy!@7y9c̎A6QwAsMp|Dp4aFE~KSbxGq2mf a^wOwgWʘTF
+;su,Bpn%=+2B#KE1|a w5i⋥QJpmFd:թ!Yב(!tjVuŨ+\Q LQv\&f}D&q 0r=h lxHkk\db\fyۀfOm\%K#(ݩ#-5(U| 2׆="GN__i,_dR¦yڷ$Q a`s3b
+2͢i#bB /2 %k |X-AS
+ UˠU;V5\ ĚWbpE4 A,~`9Qt\\˪7ZNY~Ǵ7;$DlZ"}Ko+\Ŝr d
+;x$.P EmQ'ƳD0b bSuYĂO
h2Arb`T<"[*ۮ-3dE7b )s-)Jja#b4rb+EO{ns\c5b?!b?v.LGrDlB$OǩIE4Heb[vጥU?=n/I$:Z2vu exb=ւt@lڜdU<{D / e5B?ѾfP<1c
X4-zߑ*|J1{];q(M/#$|ez=qPMdևPǞAbQ})Hѿ^bO3 W
+mB rc 9 $941x@`gTvI[\eە p$;J) PX_o!
HUV5\҇oH#;ۂ:>'O7C "zpϜiC9I Դ8_b'P!oE!F2d9O9HBp"L ސf^wgme=`<I;Q|4[k,i0
o$J LdՍ8C} /J O\ D#Y*f_P$O6.{ͷӑ,c + nG 9C\unVߜ
34PRpE;Y/Q
+ -R2 YvQsB _ ( 5H\ 쩛
&՚gƅN(}f I+ROhfuF'5sU1%Q0$L4i7T0.ޏa3h\" ֑ l1xFÊpgGN 3LIJB s3qN4 (^u]UZMN={`Kg@t=ӮvFE:[z'g-#OK.iaC-a<K&n X)S9
+Ou\ vw{ʪGBMZ7i*UB-f<h;}+n9_9 NM xƲ3N6FCٹȂDK PH&K ]a@ !ȟʾ]ו!? i Sף6DX${v7(hi<%B *ujTrt`!I3NSܺ;.#4tBaHK
8Qҡ{|&Kot7- sha'v ANdK.a3 . Sb]_ /8(Fq{F] T!K 1ɀ=u(
+f cb. ; ^ :^VPc.˦O>>u e*k>bf#ꝷ"XP>b@0< '(LQk2u'hId X(Fl=y, 5ZT*E U8rM, @DVȆV>vV%Vy'SD5 [lg*&>'0z{ZS$1+e loKؤ GF
pFcw( P;_
;%J{,U )Yp҉VE g*,>7)"SrTHQi U!롚e45y$N ;8Xo-69*mI7()IL#^,6jC %ކZjBCѷBep7:Q5W9@ ?;!iZ.' +S^^D3.ReFJH9Pȟ lpCF0-y >ZVPp~
J Xޕ7YML _IQ= sbP!.VrUb~ߍ5 1G~
+(Q4q b &! Wdw Uߒj,u[IUTVk˽ Nol2<EH6#Lʙ 72Qƽ93 1AJ'*`Ƹײe#
:QзmW,ڠ ~vx J#+ 0uqdUYǔ\0#@M,o9'صZ;YFH8I#*lx0t?q@ۜ|!fm7+ۓ5*3B\aNe˓ mqƇ@t
f_ t˔fu㪚(VJ.9Ul[6oZJ
+O.m>RI . K|v<*Nw.h >^x/^ 8/~
sSXK9A
+Br.]:
+'
żi?4?R< ~D
S[gV!cc?Hp/|ye* (\
+իd2★unDMt 3Rf9:'hC !x}TGxy5sȸR#E9 f 1YҀM\jWԮ'3*:- sF˅h
+[0}6C7݉Aj~`JL`*0HEbyw{RG4̉W'2A2~~ C@QFkC+NpAn L3x)KCSҀTU@y[ [yEʙWH ccX*3=2Gx\"S/ţ4o6J&W4YRQ[~
+荭&~̱>60fhN1=)QCͨ:%T6E ̍c\:!@5
*xӅf[dNT.)@s}!N Z' +>Hfo8kcGN8NEԉxPOp>$ R Ѣ= %#c!P% NwZaYb.Vp\kK5i-p
,e% L p45IiF+dRCgg*-`H Ini ַ=v#0u!ƀK2ybցOY̑zh^u9(8#5;n(SVSCIzb K7@=: ]LNɃ
ơ/%rbC5 ˓ ʬnHf`aQv2Ύ ?{A*?SFHtĿǯDL0brCDyh@" :&_?T_^)Ģ$,y4%)8&6Tf)W&c.eE/"<(ftm+jv514! (pѓu|d~w *4+3{SpjɫoxFV+|?| !: ɿc`Xf'v旯` 0㦚iڅtئ<)\vvBuo
+TOnd{U9]*<=3(+Ofc!maF
Zɾ1BP]3պN齿Xzb1pkX;L_Se|WlEYfjjuvDp]dmv()Kh I~ EGyIN(vw .O 8>By|'7c\(.MXsL-0690c ?b`N˰Q>X# G q >=.5B84RʼYX1r]Sݔyd3wӘ. TسBex)M
+}oy/}tD۫/SB)un$CNC6^VjN1j@% w5mVPЄJ~b+.N2?aJ'iy]Gn96VfrǨ60Μc"l1o&=;Ѿ `wWKEɕf;`,EGH 320$<~W'ł!"ՌL ,tob1HU\
H=6Ĺ! ae:
i(EF>cK*#3L}C1b#PmO\* I `Vf?j# xVT _Z 7
/ % 0
3R
+ҬS @}%&7~l8D/|`vV7LLK\!}~5LDHMFMԯ 0_b.:%tڗ7>GiΥԠ CbR )hYpDCr{;2~&:mM+^9/Y]sz#GEJT6 sLW G/Wd G9عioWП2;!%ot;R~Jǰ3m 9Ssa: ^@R..ը94̶ܮ^h-0WTӖ,jFvT3랏3afinƫ0%2QPgۤak~)Rޱ *$)vi
yS|BtҜC1<(5hWC of_ 栢o.}`a*/qtz[fh; cKr;]U`e@ bRgSJj"/NVuB>_Zkueb!K~OMReQr%
+1UZf~?%a̮(uwM"&SԒ
J 5CM'I:JcޔQxdLl6Rj7{|~o|Z9Ok (g
ۯ
+[ }oeQ~f?oerd}!~PC
_we)W*&<XIŴC vlTы^fYNa_H0+Ҝx~ĴuX_(Lb3vllE4?.-"is~sسl4TDכOc="'[2熗~u~7C+R;7JwgM ~n
+)R/ػPz :뽂uR9ye.dMqm/8⦌K~j pEc6 7.%Wn#Hh8|k 3Vo\(&Wں Gx'3+otD'wdzݪpd֙VoTBR*/ӝ` >em}IW;(Ls֪" dYۥF0DŰ̂_Gh̿ey-ӑ7oWýh8Yg|Y
+o ;ִjnߝ)\4ol|(f+MCOf՞~s]rheB,ڡ[!&8 {B[l _G'wl29&j˼}q 5@9a
+k0ߩ{#8L0N
+0˩D` z#Y9$g {k #;<+oo>^-iUUoAIʵ`S .Ysj{+ZU px&J}/'l(_ F)J0\7
̈рbR~ _=
G/C&$vM}! 3)X FȤGܛAU%g_HKL KS=ec3!6GdH|5Pۚx
+dX XvL%?A(VS lv˕OBȄ!\+0?=t&oJ
_>Eӂ53=I fŶ aʄnSP?;&yKש߂U{OiN!Ҵj!:
8[` P״
+-4ڳ;
,Y(7
+ :glz}
}_eZ!L& ~'cW6zIܥ yN
+u\bɝP! b34Uw_SOIjYd<o'h:ۘ n@@6npk$7 =; ?p<]ĉ5ܟ\O /?*u?ܒyҎQC|;P McO.#T|,A OETi>w$*f5eiE@RGA4-͜ EqH%%l%p@bO(<;?,&ݒҭC3rkOi.ph1 |dڿW`:Ra,Ξteć[F. =s +%QniU@U7* 4>I-}ll( Ip6g)QrJL?qHO!*J5 (w_ s+{~L}V2Δ ؖK\0ĕ+wtB!ɌwjN"foV>"39M} @&h)ZSړ iR0ot܄PqKuf[WRpaM {-ji-)4)oҁ t՟Usm
# f1 x]e9yT=iy][ C 8F"( fX$!VJS
+!%=
#/e ?Nm< n$xO#s
+RXt}2^20_cBCV:Rag]c0$>~ڮ}؊V 9 4V VP*QQז;-lx]uI˵syt($D]Cc*tﲨOxuDݭ?H\B;ӭtu }
+bqJL& 3Rvmz'Xjucw-,kDruEKaK bfU hf[1"k5ʶGkpFEoZsԝs1N!%٨+p evz Qw5 +o/Zn1Y;) P u*}kԍf2 9t{dG
M/MݮG]d Y *!u|[.~u!Dk6B*E it5펺֘iTLp9G!.pg+6Ԏ=Uz! 9wQ 3txnxyngNǺ=c2fVi肌~W ٢Òayjs": oRj/QOE3T 9G E8EoeW(K 6\^cw[?Qq3hr | KA8- ޕ_۰Pw<
endstream
endobj
29 0 obj
[28 0 R]
endobj
39 0 obj
<>
endobj
xref
+0 40
+0000000004 65535 f
+0000000016 00000 n
+0000000147 00000 n
+0000040637 00000 n
+0000000000 00000 f
+0000040688 00000 n
+0000000000 00000 f
+0000046158 00000 n
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000000000 00000 f
+0000046231 00000 n
+0000046427 00000 n
+0000047598 00000 n
+0000113186 00000 n
+0000178774 00000 n
+0000000000 00000 f
+0000043171 00000 n
+0000215111 00000 n
+0000041070 00000 n
+0000043475 00000 n
+0000043362 00000 n
+0000042257 00000 n
+0000042610 00000 n
+0000042658 00000 n
+0000043246 00000 n
+0000043277 00000 n
+0000043510 00000 n
+0000215136 00000 n
+trailer
<]>>
startxref
215352
%%EOF
\ No newline at end of file
diff --git a/okhttps-doc/docs/.vuepress/config.js b/okhttps-doc/docs/.vuepress/config.js
new file mode 100644
index 00000000..16f328c7
--- /dev/null
+++ b/okhttps-doc/docs/.vuepress/config.js
@@ -0,0 +1,106 @@
+module.exports = {
+ title: 'OkHttps',
+ locales: {
+ '/': {
+ lang: 'zh-CN',
+ description: 'OkHttps 官网 比 Retrofit 更好用的网络框架！ OkHttp3 轻量封装 ，开箱即用、Java领域前后端处理 Http问题的新选择。',
+ },
+ '/en/': {
+ lang: 'en-US',
+ description: 'A very lightweight and powerful HTTP client for Java and Android.',
+ }
+ },
+ head: [
+ ['link', { rel: 'icon', href: '/logo.png' }]
+ ],
+ themeConfig: {
+ logo: '/logo.png',
+ locales: {
+ '/': {
+ nav: [
+ {
+ text: '教程',
+ ariaLabel: '版本',
+ items: [
+ { text: 'v1.x', link: '/v1/' },
+ { text: 'v2.x', link: '/v2/' }
+ ]
+ },
+ { text: '历史版本', link: 'https://gitee.com/ejlchina-zhxu/okhttps/releases' },
+ { text: 'Grails 中文', link: 'http://grails.ejlchina.com' },
+ { text: '码云', link: 'https://gitee.com/ejlchina-zhxu/okhttps' }
+ ],
+ sidebar: {
+ '/v1/': [
+ '',
+ 'foundation',
+ 'configuration',
+ 'features',
+ 'updown',
+ 'android'
+ ],
+ '/v2/': [
+ '',
+ 'getstart',
+ 'foundation',
+ 'configuration',
+ 'updownload',
+ 'websocket',
+ 'stomp',
+ 'android'
+ ]
+ },
+ lastUpdated: '上次更新',
+ editLinkText: '在 GitHub 上编辑此页'
+ },
+ '/en/': {
+ nav: [
+ { text: 'Guide', link: '/en/v2/' },
+ { text: 'History Verions', link: 'https://github.com/ejlchina/okhttps/releases' },
+ { text: 'Grails Chinese', link: 'http://grails.ejlchina.com' },
+ { text: 'Gitee', link: 'https://gitee.com/ejlchina-zhxu/okhttps' }
+ ],
+ sidebar: {
+ '/en/v2/': [
+ '',
+ 'getstart',
+ 'foundation',
+ 'configuration',
+ 'updownload',
+ 'android'
+ ]
+ },
+ lastUpdated: 'Last Updated',
+ editLinkText: 'Edit this page on GitHub',
+ }
+ },
+ sidebarDepth: 2,
+ smoothScroll: true,
+ repo: 'ejlchina/okhttps',
+ repoLabel: 'Github',
+ docsBranch: 'dev',
+ docsDir: 'docs',
+ editLinks: true,
+ author: 'Troy Zhou'
+ },
+ // 若全局使用 vuepress，back-to-top 就会失效
+ plugins: [
+ '@vuepress/back-to-top',
+ '@vuepress/medium-zoom',
+ 'baidu-autopush', 'seo',
+ ['baidu-tongji', {hm: '6eb41c0ab450d5a4ae8769682ecb0ab2'}],
+ ['@vssue/vuepress-plugin-vssue', {
+ // 设置 `platform` 而不是 `api`
+ platform: 'github-v4',
+ // 其他的 Vssue 配置
+ owner: 'ejlchina',
+ repo: 'okhttps',
+ clientId: '4e308eb78d3a64abd2a8',
+ clientSecret: '17bf99c60a396b66e8ac841e3dc7a6256ab6cbcf',
+ autoCreateIssue: true
+ }]
+ ],
+ markdown: {
+ lineNumbers: true
+ }
+}
diff --git a/okhttps-doc/docs/.vuepress/public/code_temp.png b/okhttps-doc/docs/.vuepress/public/code_temp.png
new file mode 100644
index 00000000..b6f96b5a
Binary files /dev/null and b/okhttps-doc/docs/.vuepress/public/code_temp.png differ
diff --git a/okhttps-doc/docs/.vuepress/public/logo.png b/okhttps-doc/docs/.vuepress/public/logo.png
new file mode 100644
index 00000000..3b3b2845
Binary files /dev/null and b/okhttps-doc/docs/.vuepress/public/logo.png differ
diff --git a/okhttps-doc/docs/.vuepress/public/spi_config.png b/okhttps-doc/docs/.vuepress/public/spi_config.png
new file mode 100644
index 00000000..82db9123
Binary files /dev/null and b/okhttps-doc/docs/.vuepress/public/spi_config.png differ
diff --git a/okhttps-doc/docs/.vuepress/public/wx_discuss.png b/okhttps-doc/docs/.vuepress/public/wx_discuss.png
new file mode 100644
index 00000000..fb8d810e
Binary files /dev/null and b/okhttps-doc/docs/.vuepress/public/wx_discuss.png differ
diff --git a/okhttps-doc/docs/.vuepress/styles/index.styl b/okhttps-doc/docs/.vuepress/styles/index.styl
new file mode 100644
index 00000000..bde6de32
--- /dev/null
+++ b/okhttps-doc/docs/.vuepress/styles/index.styl
@@ -0,0 +1,3 @@
+.home .hero img {
+ height: 200px;
+}
\ No newline at end of file
diff --git a/okhttps-doc/docs/README.md b/okhttps-doc/docs/README.md
new file mode 100644
index 00000000..05a0cb23
--- /dev/null
+++ b/okhttps-doc/docs/README.md
@@ -0,0 +1,60 @@
+---
+home: true
+heroImage: /logo.png
+heroText: OkHttps V2
+tagline: 强大轻量 且 前后端通用的 HTTP 客户端
+actionText: 极速上手 →
+actionLink: /v2/getstart.html
+features:
+- title: 轻量纯粹优雅
+ details: OkHttps 非常轻量，体积仅是 Retrofit 的一半不到，并且不依赖于特定平台，API 语义简洁舒适。
+- title: 开箱即用的功能
+ details: 异步预处理器、回调执行器、全局监听器、回调阻断机制、文件上传下载、过程控制、进度监听。
+- title: 更多实用特性
+ details: URL 占位符、Lambda 回调、JSON自动封装解析、OkHttp 的特性：拦截器、连接池、CookieJar 等。
+
+footer: Apache Licensed | Copyright © 2020-present ejlchina
+---
+
+### 如艺术一般优雅，像 1、2、3 一样简单
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.example.com")
+ .addMsgConvertor(new GsonMsgConvertor());
+ .build();
+
+// 同步 HTTP
+List users = http.sync("/users")
+ .get() // GET请求
+ .getBody() // 响应报文体
+ .toList(User.class); // 自动反序列化 List
+
+// 异步 HTTP
+http.async("/users/1")
+ .setOnResponse((HttpResult res) -> {
+ // // 自动反序列化 Bean
+ User user = res.getBody().toBean(User.class);
+ })
+ .get(); // GET请求
+
+// WebSocket
+http.webSocket("/chat")
+ .setOnMessage((WebSocket ws, Message msg) -> {
+ // 从服务器接收消息
+ Chat chat = msg.toBean(Chat.class);
+ // 向服务器发送消息
+ ws.send(chat);
+ })
+ .listen(); // 启动监听
+```
+
+
+
+### 有问必答微信交流群
+
+ 
+
+
+
+### [ 了解更多 ](/v2/)
diff --git a/okhttps-doc/docs/en/README.md b/okhttps-doc/docs/en/README.md
new file mode 100644
index 00000000..70f91ba6
--- /dev/null
+++ b/okhttps-doc/docs/en/README.md
@@ -0,0 +1,52 @@
+---
+home: true
+heroImage: /logo.png
+heroText: OkHttps V2
+tagline: A lightweight and powerful HTTP client on top of OkHttp
+actionText: Get Started →
+actionLink: /en/v2/
+features:
+- title: Lightweight Elegant Easy
+ details: OkHttps is very lightweight, less than half the size of Retrofit, and does not depend on a specific platform. The API semantics are simple and comfortable.
+- title: Out of the box features
+ details: Asynchronous preprocessor, callback executor, global listener, callback prevent mechanism, file upload and download, process control, progress monitoring.
+- title: More practical features
+ details: URL placeholder, lambda callback, JSON auto encapsulation parsing, okhttp features like interceptor, connection pool, cookiejar, etc.
+
+footer: Apache Licensed | Copyright © 2020-present ejlchina
+---
+
+#### As Elegant as Art, As Easy as 1, 2, 3
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.example.com")
+ .addMsgConvertor(new GsonMsgConvertor());
+ .build();
+
+// Synchronous HTTP
+List users = http.sync("/users")
+ .get() // GET method
+ .getBody() // response body
+ .toList(User.class); // Automatic deserialization
+
+// Asynchronous HTTP
+http.async("/users/1")
+ .setOnResponse((HttpResult res) -> {
+ // Automatic deserialization
+ User user = res.getBody().toBean(User.class);
+ })
+ .get(); // GET method
+
+// WebSocket
+http.webSocket("/chat")
+ .setOnMessage((WebSocket ws, Message msg) -> {
+ // Automatic deserialization
+ Chat chat = msg.toBean(Chat.class);
+ // Automatic Serialization
+ ws.send(chat);
+ })
+ .listen(); // Start listening
+```
+
+[ Lean More ](/en/v2/)
\ No newline at end of file
diff --git a/okhttps-doc/docs/en/v2/README.md b/okhttps-doc/docs/en/v2/README.md
new file mode 100644
index 00000000..a220001d
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/README.md
@@ -0,0 +1,50 @@
+---
+description: OkHttps 安装 构建实例 HTTP build 同步请求 异步请求 sync async BaseUrl request webSocket gradle maven ejlchina
+---
+
+# 介绍
+
+## OkHttps 简介
+
+ OkHttps 是近期开源的对 OkHttp3 轻量封装的框架，它独创的异步预处理器，特色的标签，灵活的上传下载进度监听与过程控制功能，在轻松解决很多原本另人头疼问题的同时，设计上也力求纯粹与优雅。
+
+ * 链式调用，一点到底
+ * BaseURL、URL占位符、HTTP、WebSocket
+ * JSON、Xml 等自动封装与解析，且支持与任意格式的数据解析框架集成
+ * 同步拦截器、异步预处理器、回调执行器、全局监听、回调阻断
+ * 文件上传下载（过程控制、进度监听）
+ * 单方法回调，充分利用 Lambda 表达式
+ * TCP连接池、Http2
+
+::: tip
+* OkHttps 非常轻量（77Kb，Retrofit：124Kb），除 Okhttp 无第三方依赖，并且更加的开箱即用，API 也更加自然和语义化。
+* OkHttps 是一个纯粹的 Java 网络开发包，并不依赖 Android，这一点和 Retrofit 不同
+* OkHttps 用起来很优美，可以像 RxJava 那样链式用，却比 RxJava 更简单。
+:::
+
+### 项目组成
+
+项目 | 最新版本 | 描述
+-|-|-
+okhttps | 2.0.0 | OkHttps 核心模块
+okhttps-fastjson | 2.0.0 | 扩展包：与 fastjson 集成
+okhttps-gson | 2.0.0 | 扩展包：与 gson 集成
+okhttps-jackson | 2.0.0 | 扩展包：与 jackson 集成
+
+以上是官方维护的与三大 JSON 框架集成的案例，后续将提供 xml 和 protobuf 的集成。
+
+## v2.x 的新特性
+
+* HTTP 任务新增`patch()`方法，可发起 PATCH 请求，目前直接支持的 HTTP 方法有：GET、POST、PUT、PATCH、DELETE，并且暴露了`request(String method)`方法，可自定义发起任何请求，如：HEAD、OPTIONS、TRACE、CONNECT 等；
+
+* HTTP 任务新增`skipPreproc()`和`skipSerialPreproc()`方法，具体请求可跳过 所有 或只跳过 串行 预处理器；
+
+* 新增`MsgConvertor`接口，实现 OkHttps 与 fastjson 解耦，且不再依赖某个具体 json 框架、甚至不依赖 json，它可以与 **任何格式** 的数据解析框架集成，如：json 、xml 、protobuf 等;
+
+* 构建`HTTP`实例时支持注入多个`MsgConvertor`，可实现同一个`HTTP`实例下，既有 json 解析，又有 xml 解析等强大特性，同时还可以让表单（form）请求参数 同 json、xml 一样，支持序列化功能。
+
+* `HTTP`接口新增`webSocket(String url)`方法，与`sync(String url)`和`async(String url)`一样，支持 Lamda 编程、预处理器机制、消息数据自动序列化和反序列化机制；
+
+* 新增`OkHttps`工具类，支持 SPI 方式注入配置，`OkHttps`和`HttpUtils`默认自动以 SPI 方式寻找依赖中的`MsgConvertor`；
+
+* 新增可自定义默认编码（不自定义依然默认为 utf-8）、具体请求可指定特殊编码功能。
\ No newline at end of file
diff --git a/okhttps-doc/docs/en/v2/android.md b/okhttps-doc/docs/en/v2/android.md
new file mode 100644
index 00000000..123fcf11
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/android.md
@@ -0,0 +1,181 @@
+---
+description: OkHttps 安卓 生命周期 UI线程 主线程 IO线程 自由 灵活 切换 生命周期绑定 配置预处理器 定义生命周期监视器 配置全局回调监听
+---
+
+# 安卓
+
+## 回调线程切换
+
+ 在 Android 开发中，经常会把某些代码放到特点的线程去执行，比如网络请求响应后的页面更新在主线程（UI线程）执行，而保存文件则在IO线程操作。OkHttps 为这类问题提供了良好的方案。
+
+ 在 **默认** 情况下，**所有回调** 函数都会 **在 IO 线程** 执行。为什么会设计如此呢？这是因为 OkHttps 只是纯粹的 Java 领域 Http工具包，本身对 Android 不会有任何依赖，因此也不知 Android 的 UI 线程为何物。这么设计也让它在 Android 之外有更多的可能性。
+
+### 配置
+
+ 但是在 Android 里使用 OkHttps 的话，UI线程的问题能否优雅的解决呢？当然可以！简单粗暴的方法就是配置一个 回调执行器：
+
+ ```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ // 实际编码中可以吧 Handler 提出来，不需要每次执行回调都重新创建
+ new Handler(Looper.getMainLooper()).post(run); // 在主线程执行
+ })
+ .build();
+```
+
+### 用例
+
+ 上述代码便实现了让 **所有** 的 **回调函数** 都在 **主线程（UI线程）** 执行的目的，如：
+
+```java
+http.async("/users")
+ .addBodyPara("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .setOnResponse((HttpResult result) -> {
+ // 在主线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行
+ })
+ .setOnComplete((State state) -> {
+ // 在主线程执行
+ })
+ .post();
+```
+ 但是，如果同时还想让某些回调放在IO线程，实现 **自由切换**，怎么办呢？OkHttps 给出了非常灵活的方法，如下：
+
+```java
+http.async("/users")
+ .addBodyPara("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnResponse((HttpResult result) -> {
+ // 在 IO 线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行（没有指明 nextOnIO 则在回调执行器里执行）
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnComplete((State state) -> {
+ // 在 IO 线程执行
+ })
+ .post();
+```
+ 无论是哪一个回调，都可以使用`nextOnIO()`方法自由切换。同样，对于文件下载也是一样：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .toFolder("D:/download/")
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnSuccess((File file) -> {
+ // 在 IO 线程执行
+ })
+ .setOnFailure((Failure failure) -> {
+ // 在主线程执行
+ })
+ .start();
+```
+
+## 生命周期绑定
+
+ 由于 OkHttps 并不依赖于 Android，所以它并没有提供关于生命周期绑定的直接实现，但它的一些扩展机制让我们很容易就可以实现这个需求。在开始之前，我们首先要理解何为生命周期绑定：
+
+::: tip HTTP 请求的生命周期绑定
+所谓的生命周期绑定：即是让 HTTP 任务感知其所属的 Activity 或 Fragment 的生命周期，当 Activity 或 Fragment 将被销毁时，框架应自动的把由它们发起的但尚未完成的 HTTP 任务全部取消，以免导致程序出错！
+:::
+
+ 现在我们需要对`HTTP`实例进行配置，配置后的`HTTP`实例具有生命周期绑定的功能，在`Activity`或`Fragment`里，它的使用效果如下：
+
+```java
+// 在 Activity 或 Fragment 内发起请求
+http.async("http://www.baidu.com")
+ .bind(getLifecycle()) // 绑定生命周期
+ .setOnResponse((HttpResult result) -> {
+ Log.i("FirstFragment", "收到请求：" + result.toString());
+ })
+ .get();
+```
+ 上述代码中的`getLifecycle()`是`Activity`或`Fragment`自带的方法，而`bind()`是`HttpTask`的现有方法。在配置好`HTTP`实例后，上述代码发起的请求便可以感知`Activity`或`Fragment`的生命周期。
+
+ 那`HTTP`实例到底该如何配置呢？
+
+### 第一步：配置预处理器
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .addPreprocessor((Preprocessor.PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了 Lifecycle 对象
+ if (bound instanceof Lifecycle) {
+ // 重新绑定一个 生命周期监视器（LCObserver）对象，它的定义见下一步
+ task.bind(new LCObserver(task, (Lifecycle) bound));
+ }
+ chain.proceed();
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+### 第二步：定义生命周期监视器
+
+```java
+public class LCObserver implements LifecycleObserver {
+
+ HttpTask task;
+ Lifecycle lifecycle;
+
+ LCObserver(HttpTask task, Lifecycle lifecycle) {
+ this.task = task;
+ this.lifecycle = lifecycle;
+ lifecycle.addObserver(this);
+ }
+
+ @OnLifecycleEvent(Lifecycle.Event.ON_STOP)
+ public void onStop() {
+ task.cancel(); // 在 ON_STOP 事件中，取消对应的 HTTP 任务
+ }
+
+ public void unbind() {
+ // 在请求完成之后移除监视器
+ lifecycle.removeObserver(this);
+ }
+
+}
+```
+
+### 第三步：配置全局回调监听
+
+ 以上两步其实已经实现了生命周期绑定的功能，但是在请求完成之后，我们需要在`lifecycle`中移除`LCObserver`对象：
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .completeListener((HttpTask task, HttpResult.State state) -> {
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了生命周期监视器（LCObserver）对象
+ if (bound instanceof LCObserver) {
+ // 解绑监视器
+ ((LCObserver) bound).unbind();
+ }
+ return true;
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+**以上三步便在Android中实现了生命周期与HTTP请求绑定的功能**
+
+::: tip 提示
+以上三步实现的生命周期绑定，不仅对 HTTP 请求有作用，对 WebSocket 连接也同样有效哦。
+:::
diff --git a/okhttps-doc/docs/en/v2/configuration.md b/okhttps-doc/docs/en/v2/configuration.md
new file mode 100644
index 00000000..8b136e9d
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/configuration.md
@@ -0,0 +1,382 @@
+---
+description: OkHttps 配置 BaseUrl 回调执行器 主线程 UI线程 OkHttpClient 预处理器 TOKEN问题最佳解决方案 刷新TOKEN 全局 回调监听 下载监听 回调阻断 拦截器 CookieJar、SSL、缓存、代理、事件监听
+---
+
+# 配置
+
+## 设置 BaseUrl
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.demo.com") // 设置 BaseUrl
+ .build();
+```
+ 该配置全局生效，在配置了`BaseUrl`之后，具体的请求便可以省略`BaseUrl`部分，使得代码更加简洁，例如：
+
+```java
+http.sync("/users").get() // http://api.demo.com/users
+
+http.sync("/auth/signin") // http://api.demo.com/auth/signin
+ .addBodyPara("username", "Jackson")
+ .addBodyPara("password", "xxxxxx")
+ .post(); // POST请求
+```
+ 在配置了`BaseUrl`之后，如有特殊请求任务，仍然可以使用全路径的方式，一点都不妨碍：
+
+```java
+http.sync("https://www.baidu.com").get();
+```
+
+::: tip 支持动态 BaseUrl 吗？
+有些同学可能在网上看到某些网络封装框架声明支持 **动态 BaseUrl** 或者说 **动态域名**，那 OkHttps 支持吗？
+
+答：OkHttps 是 **不会** 提供在同一个`HTTP`实例上可以动态设置`BaseUrl`的功能的。
+
+为什么呢？
+
+答：因为这完全是一种缺陷设计，我们都知道在 Java 中多线程开发很常见，如果 A 线程正兴高采烈的准备向某个地址发起请求时，而 B 线程突然修改了`BaseUrl`，那 A 线程不就悲剧了么。所以类似 Retrofit 这些设计成熟的框架都不会提供这种功能的。
+
+那我的应用中确实要用到多个域名，该怎么办呢？
+
+答：可以构建多个`HTTP`实例，不同的实例负责不同的域名，如果每个域名的请求都比较少，就是域名多，那便只用一个`HTTP`实例，请求较少的域名使用全路径访问即可。
+:::
+
+## 回调执行器
+
+ OkHttps 默认所有回调都在 **IO线程** 执行，如何想改变执行回调的线程时，可以配置回调执行器。例如在Android里，让所有的回调函数都在UI线程执行，则可以在构建`HTTP`时配置如下：
+
+```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ runOnUiThread(run); // 在UI线程执行
+ })
+ .build();
+```
+ 该配置默认 **影响所有回调**，更多实现细节可参考 [安卓-回调线程切换](/v2/android.html#回调线程切换) 章节。
+
+## 预处理器
+
+ 预处理器（`Preprocessor`）可以让我们在请求发出之前对请求本身做一些改变，但与`OkHttp`的拦截器（`Interceptor`）不同：预处理器可以让我们 **异步** 处理这些问题。
+
+### 并行预处理器
+
+ 例如，当我们想为请求任务自动添加`Token`头信息，而`Token`只能通过异步方法`requestToken`获取时，这时使用`Interceptor`就很难处理了，但可以使用预处理器轻松解决：
+
+```java
+HTTP http = HTTP.builder()
+ .addPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();// 获得当前的HTTP任务
+ if (!task.isTagged("Auth")) { // 根据标签判断该任务是否需要Token
+ chain.proceed();
+ return;
+ }
+ requestToken((String token) -> { // 异步获取 Token
+ task.addHeader("Token", token);// 为任务添加头信息
+ chain.proceed(); // 继续当前的任务
+ });
+ })
+ .build();
+```
+ 和`Interceptor`一样，`Preprocessor`也可以添加多个。他们之间的区别如下:
+
+::: tip 拦截器与预处理器的区别
+* 拦截器只能处理同步操作，预处理器支持处理异步操作
+* 拦截器都是并行处理请求，预处理器支持串行处理（详见6.5章节）
+* 拦截器处理时机在请求前和响应后，预处理器只在请求前，并且先于拦截器执行。关于响应后，OkHttps还提供了全局回调监听（详见6.6章节）
+:::
+
+### 串行预处理器（TOKEN问题最佳解决方案）
+
+ 普通预处理器都是可并行处理的，然而有时我们希望某个预处理器同时只处理一个任务。比如 当`Token`过期时我们需要去刷新获取新`Token`，而刷新`Token`这个操作只能有一个任务去执行，因为如果`n`个任务同时执行的话，那么必有`n-1`个任务刚刷新得到的`Token`可能就立马失效了，而这是我们所不希望的。
+
+ 为了解决这个问题，OkHttps 提供了串行预处理器，它可以让 HTTP 任务排好队，一个一个地进入预处理器：
+
+```java
+HTTP http = HTTP.builder()
+ .addSerialPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ if (!task.isTagged("Auth")) {
+ chain.proceed();
+ return;
+ }
+ // 检查过期，若需要则刷新Token
+ requestTokenAndRefreshIfExpired((String token) -> {
+ task.addHeader("Token", token);
+ chain.proceed(); // 调用此方法前，不会有其它任务进入该处理器
+ });
+ })
+ .build();
+```
+ 串行预处理器实现了让HTTP任务排队串行处理的功能，但值得一提的是：它并没有因此而阻塞任何线程！
+
+::: warning 注意
+由于 串行预处理器 只能一个一个的处理任务，所以在上述中的`requestTokenAndRefreshIfExpired`方法里，若发起网络请求，一定要跳过串行预处理器 [可使用`skipSerialPreproc()`方法]，例如：
+
+```java
+http.async("/oauth/refresh-token")
+ .skipSerialPreproc() // 跳过串行预处理器
+ .addBodyPara("refreshToken", "xxxxxx")
+ .setOnResponse((HttpResult result) -> {
+
+ })
+ .post();
+```
+否则就会发生两个 HTTP 任务相互等待谁也执行不了的问题。
+
+如果你使用的是 v1.x 的版本，则可以使用`HTTP`实例的`request(Request request)`方法发起原生请求，这样则不经过任何预处理器。
+:::
+
+## 消息转换器
+
+OkHttps 自 2.0 版本器支持自定义消息转换器，并且可以添加多个，例如：
+
+```java
+HTTP http = HTTP.builder()
+ .addMsgConvertor(new MyJsonMsgConvertor());
+ .addMsgConvertor(new MyXmlMsgConvertor());
+ .build();
+```
+
+配置了消息转换器后，`HTTP`实例便具有了序列化和反序列化这些格式数据的能力。
+
+### 反序列化
+
+例如下例中，无论该接口响应的是 JSON 还是 XML，都可以反序列化成功：
+
+```java
+// 无论该接口响应的是 JSON 还是 XML，都可以反序列化成功
+List orders = http.sync('/orders')
+ .get().getBody().toList(Order.class);
+```
+
+在 Websocket 通讯中，也是如此：
+
+```java
+http.webSocket("/redpacket/status") // 监听红包的领取状态
+ .setOnMessage((WebSocket ws，Message msg) -> {
+ // 无论该接口响应的是 JSON 还是 XML，都可以反序列化成功
+ Status status = msg.toBean(Status.class);
+ })
+ .listen();
+```
+
+### 正序列化
+
+另外，如果要在请求发出阶段正向序列化参数，则需要指定`bodyType`参数告诉 OkHttps 你想使用哪一个消息转换器，如：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("json")
+ .setBodyPara(order) // 以 JSON 格式序列化 Order 对象
+ .post();
+```
+
+或者 XML：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("xml")
+ .setBodyPara(order) // 以 XML 格式序列化 Order 对象
+ .post();
+```
+
+在 Websocket 里，也是同样的方法：
+
+```java
+http.webSocket("/chat")
+ .bodyType("json")
+ .setOnOpen((WebSocket ws，HttpResult res) -> {
+ Hello hello = getHello();
+ ws.send(hello); // 以 JSON 格式序列化 Hello 对象
+ })
+ .listen();
+```
+
+但如果你在 Websocket 通讯到某一个阶段后，突然想换另外一种格式来发送数据了，你还可以这样：
+
+```java
+http.webSocket("/chat")
+ .bodyType("json")
+ .setOnOpen((WebSocket ws，HttpResult res) -> {
+ Hello hello = getHello();
+ ws.send(hello); // 以 JSON 格式序列化 Hello 对象
+
+ ws.msgType("xml") // 切换为 XML 格式
+ ws.send(hello); // 以 XML 格式序列化 Hello 对象
+ })
+ .listen();
+```
+
+### 默认序列化类型
+
+然而大多数情况下，我们都使用一种消息转换器，比如 json，这时候你可以为`bodyType`配置一个默认值：
+
+```java
+HTTP http = HTTP.builder()
+ // 修改 bodyType 的默认值为 json，若不修改，则默认是 form
+ .bodyType("json");
+ .addMsgConvertor(new MyJsonMsgConvertor());
+ .build();
+```
+::: tip 提示
+只有请求报文体的正向序列化才会收到`bodyType`的影响，对于响应报文体的反向序列化不受其影响。
+:::
+
+### 表单序列化
+
+OkHttps 不但能做 JSON 或 XML 的序列化，并且还能做表单参数的序列化，并且自带了一个`FormConvertor`，它可以给任意`MsgConvertor`赋予表单序列化的能力，例如你已经实现了一个`MyJsonMsgConvertor`，可以这么做：
+
+```java
+// 这里并不要求是一个 JSON 转换器，XML 也可以
+// 有啥就给啥，效果是一样的
+MsgConvertor convertor = new MyJsonMsgConvertor();
+
+HTTP http = HTTP.builder()
+ .addMsgConvertor(new MsgConvertor.FormConvertor(convertor));
+ .build();
+```
+
+这样，你再做表单请求时，就可以直接扔进一个对象，它将自动完成序列化的事情：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("form")
+ .setBodyPara(order) // 以 表单 格式序列化 Order 对象
+ .post();
+```
+
+一般情况下，如果你有实现了一个`MsgConvertor`，我们推荐把它和`FormConvertor`都添加进去，例如：
+
+```java
+MsgConvertor convertor = new MyJsonMsgConvertor();
+
+HTTP http = HTTP.builder()
+ .addMsgConvertor(convertor);
+ .addMsgConvertor(new MsgConvertor.FormConvertor(convertor));
+ .build();
+```
+
+如果你添加了官方提供的`MsgConvertor`依赖包（例如：`okhttps-jackson`等），在构建实例时，还可以这样直接注入：
+
+```java
+HTTP.Builder builder = HTTP.builder()
+// 自动完成依赖中的 MsgConvertor 和 FormConvertor 的注入
+ConvertProvider.inject(builder);
+HTTP http = builder.build();
+```
+
+::: tip
+如果你使用的是[`OkHttps`或`HttpUtils`工具类](/v2/getstart.html#工具类)，它们都会自动配置`MsgConvertor`和`FormConvertor`，无需手动配置
+
+在 v2.0.0.RC 版本中`FormConvertor`的名字是`MsgConvertor.FormMsgConvertor`
+:::
+
+## 全局监听
+
+### 全局回调监听
+
+ 全局回调是实际开发中经常需要的功能，比如对服务器响应的状态码进行统一处理等，同时 OkHttps 的全局回调还具有 **回调阻断** 的功能：
+
+```java
+HTTP http = HTTP.builder()
+ .responseListener((HttpTask task, HttpResult result) -> {
+ // 所有请求响应后都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnResponse 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .completeListener((HttpTask task, State state) -> {
+ // 所有请求执行完都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnComplete 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求发生异常都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnException 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .build();
+```
+
+**回调阻断** 其实是日常开发中比较常见的需求，比如：
+
+只有当接口响应的状态码在 [200, 300) 之间时，应用才做具体的业务处理，其它则一律向用户提示接口返回的错误信息，则可以这么做：
+
+```java
+HTTP http = HTTP.builder()
+ .responseListener((HttpTask task, HttpResult result) -> {
+ if (result.isSuccessful()) {
+ return true; // 继续接口的业务处理
+ }
+ showApiMsgToUser(result); // 向用户展示接口的错误信息
+ return false; // 阻断
+ })
+ .build();
+```
+
+然后具体的请求，就可以专注于业务处理，而不需担心接口的状态出错，比如：
+
+```java
+Order order = newOrder(); // 订单信息
+
+http.async('/orders') // 提交订单
+ .setBodyPara(order)
+ .setOnResponse((HttpResult result) -> {
+ // 进入该回调，则表示订单已提交成功，就可以放心的做接下来的业务处理
+ // 比如去发起支付：
+ startPay(result.getBody().toBean(PayInfo.class));
+ })
+ .post();
+```
+
+
+::: tip 全局回调监听与拦截器的异同：
+* 拦截器可以添加多个，全局回调监听分三种，每种最多添加一个
+* 拦截器处的理时机在请求前和响应后，全局回调监听只在响应后，并且晚于拦截器
+* 全局回调监听可以 **阻断**（return false）某个请求的具体回调，而拦截器不能
+:::
+
+### 全局下载监听
+
+```java
+HTTP http = HTTP.builder()
+ .downloadListener((HttpTask task, Download download) -> {
+ // 所有下载在开始之前都会先走这里
+ Ctrl ctrl = download.getCtrl(); // 下载控制器
+
+ })
+ .build();
+```
+
+## 配置 OkHttpClient
+
+ 与其他封装 OkHttp3 的框架不同，OkHttps 并不会遮蔽 OkHttp3 本身就很好用的功能，如下：
+
+```java
+HTTP http = HTTP.builder()
+ .config((OkHttpClient.Builder builder) -> {
+ // 配置连接池 最小10个连接（不配置默认为 5）
+ builder.connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES));
+ // 配置连接超时时间（默认10秒）
+ builder.connectTimeout(20, TimeUnit.SECONDS);
+ // 配置 WebSocket 心跳间隔（默认没有心跳）
+ builder.pingInterval(60, TimeUnit.SECONDS);
+ // 配置拦截器
+ builder.addInterceptor((Chain chain) -> {
+ Request request = chain.request();
+ // 必须同步返回，拦截器内无法执行异步操作
+ return chain.proceed(request);
+ });
+ // 其它配置: CookieJar、SSL、缓存、代理、事件监听...
+ // 所有 OkHttp 能配置的，都可以在这里配置
+ })
+ .build();
+```
\ No newline at end of file
diff --git a/okhttps-doc/docs/en/v2/foundation.md b/okhttps-doc/docs/en/v2/foundation.md
new file mode 100644
index 00000000..f95778ab
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/foundation.md
@@ -0,0 +1,726 @@
+---
+description: OkHttps 请求方法 回调函数 HttpResult cache 多次 消费报文体 HttpCall 构建HTTP任务 请求参数 JSON 使用标签 发起请求 取消请求
+---
+
+# 基础
+
+## 请求方法
+
+OkHttps 使用`sync()`和`async()`方式发起的请求，支持的 HTTP 方法有：
+
+HTTP 请求方法 | 实现方法 | Restful 释义 | 起始版本
+-|-|-|-
+GET | `get()` | 获取资源 | 1.0.0
+HEAD | `head()` | 获取资源头信息 | 2.0.0
+POST | `post()` | 提交资源 | 1.0.0
+PUT | `put()` | 更新资源 | 1.0.0
+PATCH | `patch()` | 部分更新资源 | 2.0.0.RC
+DELETE | `delete()` | 删除资源 | 1.0.0
+其它 | `request(String method)` | 任何 HTTP 请求方法 | 2.0.0.RC
+
+例如，修改 ID 为 100 的书的标题，可以这样请求：
+
+```java
+http.async("/books/100")
+ .addBodyPara("title", "新标题")
+ .patch(); // 发起 PATCH 请求
+```
+
+再如，删除 ID 为 100 的书，可以发起这样的请求：
+
+```java
+http.async("/books/100").delete(); // 发起 DELETE 请求
+```
+
+再如，使用 HEAD 请求获取服务器上文件的大小：
+
+```java
+HttpResult res = http.sync("/download/file.zip").head();
+// // HttpResult#getContentLength() 新增于 2.0.0 版本
+System.out.println("size = " + res.getContentLength());
+```
+
+你还可以自定义一些请求方法，例如：
+
+```java
+http.async("/somethings")
+ .setOnResponse((HttpResult result) -> {
+ System.out.println(result);
+ })
+ .request("OPTIONS"); // 发起 OPTIONS 请求
+```
+
+另外，同步请求的所有这些方法都会返回一个[`HttpResult`](#httpresult)，而异步请求则会返回一个[`HttpCall`](#httpcall)：
+
+```java
+HttpResult res1 = http.sync("/books").get(); // 同步 GET
+HttpResult res2 = http.sync("/books").post(); // 同步 POST
+
+HttpCall call1 = http.async("/books").get(); // 异步 GET
+HttpCall call2 = http.async("/books").post(); // 异步 POST
+```
+
+## 回调函数
+
+OkHttps 的回调函数全部使用单方法模式，这样可以充分利用 Java8 或 Kotlin 中的 Lambda 表达式，使你的代码更加简洁优雅：
+
+### 普通回调
+
+```java
+http.async("/users") // http://api.demo.com/users
+ .setOnResponse((HttpResult result) -> {
+ // 响应回调
+ })
+ .setOnException((IOException e) -> {
+ // 异常回调
+ })
+ .setOnComplete((State state) -> {
+ // 完成回调，无论成功失败都会执行，并且在 响应|异常回调 之前执行
+ // 可以根据 state 枚举判断执行状态:
+ // State.CANCELED` 请求被取消
+ // State.RESPONSED` 已收到响应
+ // State.TIMEOUT` 请求超时
+ // State.NETWORK_ERROR` 网络错误
+ // State.EXCEPTION` 其它请求异常
+ })
+ .get();
+```
+
+OkHttps 同时还支持 **全局回调** 和 **回调阻断** 机制，详见 [全局回调监听](/v2/configuration.html#全局回调监听)。
+
+::: tip
+* 只有异步请求才可以设置这三种（响应|异常|完成）回调
+* 同步请求直接返回结果，无需使用回调
+:::
+
+### 进度回调
+
+上传进度回调：
+
+```java
+http.sync("/upload")
+ .addFilePara("avatar", "D:/image/avatar.jpg")
+ .setOnProcess((Process process) -> {
+ long doneBytes = process.getDoneBytes(); // 已上传字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已上传的比例
+ boolean isDone = process.isDone(); // 是否上传完成
+ })
+ .post();
+```
+
+关于上传的更多细节请参考 [文件上传](/v2/updown.html#文件上传) 章节。
+
+下载进度回调：
+
+```java
+http.sync("/download/test.zip").get().getBody()
+ .setOnProcess((Process process) -> {
+ long doneBytes = process.getDoneBytes(); // 已下载字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已下载的比例
+ boolean isDone = process.isDone(); // 是否下载完成
+ })
+ .toFolder("D:/download/") // 指定下载的目录，文件名将根据下载信息自动生成
+ .start();
+```
+
+#### 还有下载成功或失败的回调：
+
+```java
+http.sync("/download/test.zip").get().getBody()
+ .toFile("D:/download/test.zip") // 下载到文件
+ .setOnSuccess((File file) -> {
+ // 下载成功
+ })
+ .setOnFailure((Failure failure) -> {
+ // 下载失败
+ })
+ .start();
+```
+
+关于下载的更多内容，请参考 [文件下载](/v2/updown.html#文件下载) 章节。
+
+### WebSocket 回调
+
+```java
+http.webSocket("/websocket-endpoint")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ // WebSocket 连接建立回调
+ })
+ .setOnMessage((WebSocket ws, Message msg) -> {
+ // 服务器下发消息回调
+ })
+ .setOnException((WebSocket ws, Throwable thr) -> {
+ // 连接发生异常回调
+ })
+ .setOnClosing((WebSocket ws, WebSocket.Close close) -> {
+ // 连接正在关闭回调
+ })
+ .setOnClosed((WebSocket ws, WebSocket.Close close) -> {
+ // 连接已关闭（v2.0.0 之后包含连接被取消 和 连接发生异常）
+ boolean isCanceled = close.isCanceled(); // from v2.0.0
+ boolean isException = close.isException(); // from v2.0.0
+ int code = close.getCode();
+ String reason = close.getReason();
+ })
+ .listen();
+```
+
+::: tip
+OkHttps 的所有回调函数都默认在 IO 线程执行，若要切换默认线程（例如 Android 中切换到 UI 线程）请参见 [回调线程切换](/v2/android.html#回调线程切换)。
+:::
+
+## HttpResult
+
+ `HttpResult`是HTTP请求执行完后的结果，它是同步请求方法`get()`、`post()`等的返回值，也是异步请求响应回调`OnResponse`的参数，它定义了如下方法：
+
+* `getState()` 得到请求执行状态枚举，它有以下取值：
+ * `State.CANCELED` 请求被取消
+ * `State.RESPONSED` 已收到响应
+ * `State.TIMEOUT` 请求超时
+ * `State.NETWORK_ERROR` 网络错误
+ * `State.EXCEPTION` 其它请求异常
+* `getStatus()` 得到 HTTP 状态码
+* `isSuccessful()` 是否响应成功，状态码在 [200..300) 之间
+* `getHeaders()` 得到HTTP响应头
+* `getHeaders(String name)` 得到HTTP响应头
+* `getHeader(String name)` 得到HTTP响应头
+* `getContentLength();` 解析响应头中的 Content-Length 长度信息（v2.0.0 新增）
+* `getBody()` 得到响应报文体`Body`实例，它定义了如下方法（对同一个`Body`实例，以下的`toXXX()`类方法只能使用一个且仅能调用一次，除非先使用 cache 方法）：
+ * `toBytes()` 报文体转换为字节数组
+ * `toByteStream()` 报文体转换为字节输入流
+ * `toCharStream()` 报文体转换为字符输入流
+ * `toString()` 报文体转换为字符串文本
+ * `toBean(Class type)` 报文体根据`type`自动反序列化为 JavaBean（依赖`MsgConvertor`）
+ * `toList(Class type)` 报文体根据`type`自动反序列化为 JavaBean 列表（依赖`MsgConvertor`）
+ * `toMapper()` 报文体自动反序列化为映射结构的对象（依赖`MsgConvertor`，v2.0.0.RC 之前是`toJsonObject()`）
+ * `toArray()` 报文体自动反序列化为数组结构的对象（依赖`MsgConvertor`，v2.0.0.RC 之前是`toJsonArray()`）
+ * `toFile(String filePath)` 下载到指定路径
+ * `toFile(File file)` 下载到指定文件
+ * `toFolder(String dirPath)` 下载到指定目录
+ * `toFolder(File dir)` 下载到指定目录
+ * `getType()` 返回报文体的媒体类型（v2.0.0 新增，不再推荐`getContentType()`方法）
+ * `getLength()` 返回报文体的字节长度（v2.0.0 新增，不再推荐`getContentLength()`方法）
+ * `cache()` 缓存报文体，开启缓存后可重复使用`toXXX()`类方法
+ * `close()` 关闭报文体，未对报文体做任何消费时使用，比如只读取报文头
+* `getError()` 执行中发生的异常，自动捕获执行请求时发生的 网络超时、网络错误 和 其它IO异常
+* `close()` 关闭报文，未对报文体做任何消费时使用，比如只读取长度
+
+示例，请求结果自动反序列化为 Bean 和 List：
+
+```java
+// 自动转Bean
+Order order = http.sync("/orders/1").get()
+ .getBody().toBean(Order.class);
+
+// 自动转List
+List orders = http.sync("/orders")
+ .get().getBody().toList(Order.class);
+```
+
+上例中，为了获取订单列表，必须先定义一个`Order`类，如果你不想定义它，可以直接使用`toMapper()`和`toArray()`方法：
+
+```java
+Mapper order = http.sync("/orders/1")
+ .get().getBody().toMapper();
+
+long orderId = order.getLong("id"); // 订单ID
+long orderNo = order.getString("orderNo"); // 订单号
+
+Array orders = http.sync("/orders")
+ .get().getBody().toArray();
+
+int size = orders.size(); // 订单个数
+Mapper o1 = orders.getMapper(0) // 第1个订单
+```
+
+关于 Mapper 和 Array 的更多信息，请参考 [Mapper 接口](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Mapper.java) 和 [Array 接口](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Array.java)。
+
+示例，使用 `cache()` 方法：
+
+```java
+Body body = http.sync("/orders").get().getBody().cache();
+
+// 使用 cache 后，可以多次使用 toXXX() 方法
+System.out.println(body.toString());
+System.out.println(body.toArray());
+System.out.println(body.toList(Order.class));
+```
+
+示例，获取下载文件的大小：
+
+```java
+long size = http.sync("/download/test.zip").get().getBody()
+ .close() // 只是想获得文件大小，不消费报文体，所以直接关闭
+ .getLength(); // 获得待下载文件的大小
+// 由于未消费报文体，所以本次请求不会消耗下载报文体的时间和网络流量
+System.out.println("size = " + size);
+```
+
+上述代码等同于：
+
+```java
+long size = http.sync("/download/test.zip").get().close().getContentLength();
+System.out.println("size = " + size);
+```
+
+还等效于：
+
+```java
+long size = http.sync("/download/test.zip").head().getContentLength();
+// 因为 HEAD 请求没有响应报文体，所以就不需要关闭啦
+System.out.println("size = " + size);
+```
+
+## HttpCall
+
+[`HttpCall`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/HttpCall.java)是异步请求方法`get()`、`post()`等的返回值，它是一个接口，继承自[`Cancelable`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Cancelable.java)，与`java`的`Future`接口很像，它有如下方法：
+
+* `cancel()` 取消本次请求，返回取消结果
+* `isCanceled()` 返回请求是否被取消
+* `isDone()` 返回是否执行完成，包含取消和失败
+* `getResult()` 返回执行结果`HttpResult`对象，若请求未执行完，则挂起当前线程直到执行完成再返回
+
+例如，取消一个异步请求：
+
+```java
+HttpCall call = http.async("/users/1").get();
+
+System.out.println(call.isCanceled()); // false
+
+boolean success = call.cancel(); // 取消请求
+
+System.out.println(success); // true
+System.out.println(call.isCanceled()); // true
+```
+
+## 构建请求
+
+ `HTTP`接口的`sync(String url)`、`async(String url)`和`webSocket(String url)`方法返回一个`HttpTask`对象，它实现了[`Cancelable`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Cancelable.java)接口，同时也提供了可链式调用的`addXXX`与`setXXX`等系列方法用于构建请求报文。
+
+### 请求头
+
+* `addHeader(String name, String value)` 添加请求头
+* `addHeader(Map headers)` 添加请求头
+
+### 路径参数
+
+* `addPathPara(String name, Object value)` 添加路径参数：替换 URL 里的`{name}`占位符
+* `addPathPara(Map params)` 添加路径参数：替换 URL 里的`{name}`占位符
+
+路径参数可以存在于 URL 中的任何位置，例如：
+
+```java
+final String BOOKS_QUERY_URL = "/authors/{authorId}/books?type={type}";
+
+http.async(BOOKS_QUERY_URL) // /authors/1/books?bookType=2
+ .addPathPara("authorId", 1)
+ .addPathPara("type", 2)
+ .setOnResponse((HttpResult res) -> {
+
+ })
+ .get();
+```
+
+### 查询参数
+
+* `addUrlPara(String name, Object value)` 添加 URL 参数：拼接在 URL 的`?`之后（查询参数）
+* `addUrlPara(Map params)` 添加 URL 参数：拼接在 URL 的`?`之后（查询参数）
+
+::: warning
+方法`addXxxPara`在 v2.0.0.RC 之前名为`addXxxParam`, v2.0.0.RC 之后推荐使用简洁版的方法，老方法将在 v2.1.0 中移除。
+:::
+
+### 报文体类型
+
+* `bodyType(String type)` 结合报文体参数使用，用于设置本次的请求报文体类型，可以是`form`、`json`、`xml`、`protobuf`等，默认为`form`（表单类型）,可以在构建`HTTP`实例时修改默认的类型
+
+::: tip 解析
+`bodyType`对应于`MsgConvertor`的`mediaType()`方法的返回值，OkHttps 会按照既定的规则 [`mediaType().contain(bodyType)`] 去匹配出对应的`MsgConvertor`去序列化报文体参数。
+:::
+
+### 报文体参数（表单、JSON、XML等）
+
+OkHttps 信仰统一与一致更加优雅，所以自 v2.0.0.RC 开始、它便统一了报文体参数的 API，无论是表单、还是 JSON、XML 或是 protobuf 等等，只要这些参数是放在请求报文体中，那么就可以通过一套 API 轻松搞定！
+
+* `addBodyPara(String name, Object value)` 添加 Body 参数
+* `addBodyPara(Map params)` 添加 Body 参数
+* `setBodyPara(Object object)` 设置 Body 参数体
+
+::: warning 注意
+添加报文体参数后，不可使用 GET、HEAD 请求方法
+
+方法`setBodyPara`在 v2.0.0.RC 之前名为`setRequestJson`, v2.0.0.RC 之后推荐使用统一 API，老方法将在 v2.1.0 中移除。
+:::
+
+#### 表单请求
+
+默认的请求报文体类型就是`form`表单，所以可以直接使用`addBodyPara`方法：
+
+```java
+http.async("/projects")
+ .addBodyPara("name", "OkHttps")
+ .addBodyPara("desc", "最好用的网络框架")
+ .post();
+```
+
+或者是传入一个 Map 对象：
+
+```java
+Map params = new HashMap<>();
+params.put("name", "OkHttps");
+params.put("desc", "最好用的网络框架");
+
+http.async("/projects")
+ .addBodyPara(params)
+ .post();
+```
+
+甚至可以用`setBodyPara`传入一个`String`：
+
+```java
+http.async("/projects")
+ .setBodyPara("name=OkHttps&desc=最好用的网络框架")
+ .post();
+```
+
+如果你配置了`FormConvertor`（请参考 [配置-表单序列化](/v2/configuration.html#表单序列化) 章节），那你还可以直接传入一个 POJO（自定义的一个 Java 类）：
+
+```java
+Proejct project = new Proejct();
+project.setName("OkHttps");
+project.setDesc("最好用的网络框架");
+
+http.async("/projects")
+ .setBodyPara(project) // 将自动序列化为表单格式
+ .post();
+```
+
+以上 **4** 种方式具有相同的效果，但如果你修改了默认的报文体序列化类型（请参考 [默认序列化类型](/v2/configuration.html#默认序列化类型) 章节），那还需在请求时指定当前的请求报文体类型：
+
+```java
+http.async("/projects")
+ .bodyType("form") // 指明请求体类型是表单
+ ...
+```
+
+或使用`OkHttps.FORM`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.FORM) // 指明请求体类型是表单
+ ...
+```
+
+#### JSON 请求
+
+JSON 请求要求默认的请求`bodyType`为`json` 或者 在具体请求中显式指明`bodyType`为`json`，其它用法和表单请求一模一样。
+
+单个添加
+
+```java
+http.async("/projects")
+ .addBodyPara("name", "OkHttps")
+ .addBodyPara("desc", "最好用的网络框架")
+ .post();
+```
+
+Map 方式：
+
+```java
+Map params = new HashMap<>();
+params.put("name", "OkHttps");
+params.put("desc", "最好用的网络框架");
+
+http.async("/projects")
+ .addBodyPara(params)
+ .post();
+```
+
+POJO 方式：
+
+```java
+Proejct project = new Proejct();
+project.setName("OkHttps");
+project.setDesc("最好用的网络框架");
+
+http.async("/projects")
+ .setBodyPara(project) // 自动序列化
+ .post();
+```
+
+字符串方式：
+
+```java
+http.async("/projects")
+ .setBodyPara("{\"name\":\"OkHttps\",\"desc\":\"最好用的网络框架\"}")
+ .post();
+```
+
+唯一的不同是，如果默认的`bodyType`不是`json`，那需要显式指定当前请求的`bodyType`为`json`：
+
+```java
+http.async("/projects")
+ .bodyType("json") // 指明请求体类型是 JSON
+ ...
+```
+
+或使用`OkHttps.JSON`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.JSON) // 指明请求体类型是 JSON
+ ...
+```
+
+#### XML 请求
+
+若默认不是 XML，则显式指定当前请求的报文体类型
+
+```java
+http.async("/projects")
+ .bodyType("xml") // 指明请求体类型是 XML
+ ...
+```
+
+或使用`OkHttps.XML`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.XML) // 指明请求体类型是 XML
+ ...
+```
+
+其它与 表单和 JSON，完全一致，不再赘述。
+
+#### 其它数据格式的请求
+
+只需要扩展了相应的`MsgConvertor`，OkHttps 支持任意数据格式的请求。
+
+### 文件参数
+
+文件参数是一个特殊的报文体参数，当使用以下方法上传文件时，OkHttps 会强制报文体使用`form`模式。
+
+* `addFilePara(String name, String filePath)` 上传文件
+* `addFilePara(String name, File file)` 上传文件
+* `addFilePara(String name, String type, byte[] content)` 上传文件
+* `addFilePara(String name, String type, String fileName, byte[] content)` 上传文件
+
+文件参数和报文体参数，还可以混用，例如：
+
+```java
+http.sync("/upload")
+ .addBodyPara("title", "头像")
+ .addFilePara("image", "D:/image/avatar.jpg")
+ .post();
+```
+
+::: warning
+如果你使用的是 v2.0.0.RC 版本中，以上代码会报 **“方法 addFilePara 只能使用 form 方式请求”** 错误，可以用以下方式解决该问题：
+```java
+http.async("/upload")
+ .bodyType("multipart/form")
+ .addBodyPara("title", "头像")
+ .addFilePara("test", "D:/image/avatar.jpg")
+ .post();
+```
+详见 ISSUE: [https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9](https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9)
+:::
+
+无论当前的默认`bodyType`是什么，和文件参数一起添加的`Body`参数都将以`form`（表单）模式提交。
+
+### 其它
+
+* `tag(String tag)` 为 HTTP 任务添加标签
+* `setRange(long rangeStart)` 设置 Range 头信息，`addHeader`的便捷方法，用于[断点续传](/v1/updown.html#实现断点续传)
+* `setRange(long rangeStart, long rangeEnd)` 设置 Range 头信息，可用于[分块下载](/v1/updown.html#实现分块下载)
+* `bind(Object object)` 绑定一个对象，可用于实现 Android 里的[生命周期绑定](/v1/android.html#生命周期绑定)
+* `nothrow()` 一种发生异常时的处理方式，请参考 [异常处理](/v2/features.html#异常处理) 章节
+* `skipPreproc()` 设置本次请求跳过所有预处理器，请参考 [预处理器](/v2/configuration.html#并行预处理器) 章节
+* `skipSerialPreproc()` 设置本次请求只跳过所有串行预处理器，请参考 [串行预处理器](/v2/configuration.html#串行预处理器（token问题最佳解决方案）) 章节
+
+## 使用标签
+
+有时候我们想对 HTTP 任务加以分类，这时候可以使用标签功能：
+
+```java
+http.async("/users") //（1）
+ .tag("A")
+ .get();
+
+http.async("/users") //（2）
+ .tag("A.B")
+ .get();
+
+http.async("/users") //（3）
+ .tag("B")
+ .get();
+
+http.async("/users") //（4）
+ .tag("B")
+ .tag("C") // 从 v1.0.4 标签将以追加模式添加，等效于 setTag("B.C")
+ .get();
+
+http.async("/users") //（5）
+ .tag("C")
+ .get();
+
+http.webSocket("/websocket")
+ .tag("B") // (6) 标签同样可以作用在 WebSocket 连接上
+ .listen();
+```
+
+当使用标签后，就可以按标签批量的对HTTP任务进行取消：
+
+```java
+int count = http.cancel("B"); //（2）（3）（4）（6）被取消（取消标签包含"B"的任务）
+System.out.println(count); // 输出 4
+```
+
+标签除了可以用来取消任务，在预处理器中它也可以发挥作用，请参见 [并行预处理器](/v2/configuration.html#并行预处理器) 与 [串行预处理器（token问题最佳解决方案）](/v2/configuration.html#串行预处理器（token问题最佳解决方案）)。
+
+## 异常处理
+
+ 使用 OkHttps 时，**异常处理不是必须的**，但相比其它的 HTTP 开发包，它还提供一个特别的处理方法：`nothrow()`，以满足不同的异常处理需求。
+
+### 同步请求的异常
+
+ 默认情况下，当同步请求执行异常时，会直接向外抛出，我们可以用 `try catch` 来捕获，例如：
+
+```java
+try {
+ HttpResult result = http.sync("/users/1").get();
+} catch (HttpException e) {
+ Throwable cause = e.getCause(); // 得到异常原因
+ if (cause instanceof ConnectException) {
+ // 当没网络时，会抛出连接异常
+ }
+ if (cause instanceof SocketTimeoutException) {
+ // 当接口长时间未响应，会抛出超时异常
+ }
+ if (cause instanceof UnknownHostException) {
+ // 当把域名或IP写错，会抛出 UnknownHost 异常
+ }
+ // ...
+}
+```
+ 这种传统的异常处理方式，当然可以解决问题，但 OkHttps 有更佳的方案：
+
+```java
+// 方法 nothrow() 让异常不直接抛出
+HttpResult result = http.sync("/users/1").nothrow().get();
+// 判断执行状态
+switch (result.getState()) {
+ case RESPONSED: // 请求已正常响应
+ break;
+ case CANCELED: // 请求已被取消
+ break;
+ case NETWORK_ERROR: // 网络错误，说明用户没网了
+ break;
+ case TIMEOUT: // 请求超时
+ break;
+ case EXCEPTION: // 其它异常
+ break;
+}
+// 还可以获得具体的异常信息
+IOException error = result.getError();
+```
+
+### 异步请求的异常
+
+ 异步请求最常用的异常处理方式就是设置一个异常回调：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnException((IOException e) -> {
+ // 这里处理请求异常
+ })
+ .get();
+```
+ 当然，还有一个全局异常监听（`ExceptionListener`，请参考 [全局回调监听](/v2/configuration.html#全局回调监听) 章节）：
+
+```java
+HTTP http = HTTP.builder()
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求执行完都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnComplete 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .build();
+```
+ 如果不设置`OnException`回调，也没有`ExceptionListener`，发生异常时会在 **IO 线程** 中向上抛出，外层无法捕获：
+
+```java
+try {
+ http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+} catch (HttpException e) {
+ // 这种方式是捕获不到异常的！！！！！！
+}
+```
+ 即使没有`OnException`回调，发生异常时，依然会走`OnComplete`回调，如果设置了的话：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnComplete((State state) -> {
+ // 发生异常，会先执行这里，可以根据 state 判断发生了什么
+ // 但执行完后依然会在IO线程中向上抛出
+ })
+ .get();
+```
+ 如果就是想 **不处理异常，也不向上抛出**，发生错误完全无视，可以做到吗？可以！还是使用`nothrow()`方法：
+
+```java
+http.async("/users/1")
+ .nothrow() // 告诉 OkHttps 发生异常时不向外抛出
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+```
+
+## 取消请求
+
+ 在 OkHttps 里取消请求共有 **4 种** 方式可选：
+
+**1、** 使用`HttpCall#cancel()`取消单个请求（适用于异步请求，[详见 3.3 章节](#33-httpcall)）
+
+**2、** 使用`HttpTask#cancel()`取消单个请求（适用于所有请求）（since v1.0.4）
+
+```java
+HttpTask task = http.async("/users")
+ .setOnResponse((HttpResult result) -> {
+ // 响应回调
+ });
+
+task.get(); // 发起 GET 请求
+
+// 取消请求，并返回是否取消成功
+boolean canceled = task.cancel();
+```
+
+**3、** 使用`HTTP#cancel(String tag)`按标签批量取消请求（适用于所有请求，[详见第 5 章节](#5-使用标签)）
+
+**4、** 使用`HTTP#cancelAll()`取消所有请求（适用于所有请求）（since v1.0.2）
+
+```java
+http.cancelAll(); // 取消所有请求
+```
+
+::: tip 提示
+以上四种方式都对所有类型的请求有效，包括：同步 HTTP、异步 HTTP 和 WebSocket 连接。
+:::
+
+除了以上的 4 种方式，OkHttps 里还可以实现自动取消，请参考 [安卓-生命周期绑定](/v2/android.html#生命周期绑定) 章节。
diff --git a/okhttps-doc/docs/en/v2/getstart.md b/okhttps-doc/docs/en/v2/getstart.md
new file mode 100644
index 00000000..5b9324e5
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/getstart.md
@@ -0,0 +1,280 @@
+---
+description: OkHttps 安装 构建实例 HTTP build 同步请求 异步请求 sync async BaseUrl request webSocket gradle maven ejlchina
+---
+
+# 起步
+
+## 安装
+
+### Maven
+
+#### 单独使用 OkHttps
+
+```xml
+
+ com.ejlchina
+ okhttps
+ 2.0.0
+
+```
+
+单独使用 OkHttps 需要自定义[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)，否则无法使用 **自动正反序列化** 相关功能，后文会详细讲解哪些功能会受到此影响。
+
+#### 与 fastjson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-fastjson
+ 2.0.0
+
+```
+
+#### 与 gson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-gson
+ 2.0.0
+
+```
+
+#### 与 jackson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-jackson
+ 2.0.0
+
+```
+
+::: tip
+以上依赖四选一即可
+:::
+
+### Gradle
+
+#### 单独使用 OkHttps
+
+```groovy
+implementation 'com.ejlchina:okhttps:2.0.0'
+```
+
+单独使用 OkHttps 需要自定义[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)，否则无法使用 **自动正反序列化** 相关功能，后文会详细讲解哪些功能会受到此影响。
+
+#### 与 fastjson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-fastjson:2.0.0'
+```
+
+#### 与 gson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-gson:2.0.0'
+```
+
+#### 与 jackson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-jackson:2.0.0'
+```
+
+::: tip
+以上依赖四选一即可
+:::
+
+
+#### JDK 版本
+
+安卓中使用需要把 JDK 版本调成 1.8，在 app 模块的 build.gradle 中加入以下配置即可：
+
+```groovy
+android {
+ // 省略其它配置..
+ compileOptions {
+ sourceCompatibility = 1.8
+ targetCompatibility = 1.8
+ }
+}
+```
+
+## 使用
+
+### 构建 HTTP
+
+```java
+HTTP http = HTTP.builder().build();
+```
+
+以上代码构建了一个最简单的`HTTP`实例，它拥有以下方法：
+
+* `sync(String url)` 开始一个同步 HTTP 请求
+* `async(String url)` 开始一个异步 HTTP 请求
+* `webSocket(String url)` 开始一个 WebSocket 连接
+* `cancel(String tag)` 按标签取消（同步 | 异步 | WebSocket）连接
+* `cancelAll()` 取消所有（同步 | 异步 | WebSocket）连接
+* `request(Request request)` OkHttp 原生 HTTP 请求
+* `webSocket(Request request, WebSocketListener listener)` OkHttp 原生 WebSocket 连接
+* `newBuilder()` 用于重新构建一个 HTTP 实例
+
+为了使用方便，在构建的时候，我们更愿意指定一个`BaseUrl`和[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)（详见 [设置 BaseUrl](/v1/configuration.html#设置-baseurl) 和 [消息转换器](/v2/configuration.html#消息转换器)）:
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.example.com")
+ .addMsgConvertor(new GsonMsgConvertor());
+ .build();
+```
+
+上例中的[`GsonMsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMsgConvertor.java)来自[`okhttps-gson`](https://gitee.com/ejlchina-zhxu/okhttps/tree/master/okhttps-gson)。为了简化文档，下文中出现的`http`均是在构建时设置了`BaseUrl`和`MsgConvertor`的`HTTP`实例。
+
+
+### 同步请求
+
+ 使用方法`sync(String url)`开始一个同步请求：
+
+```java
+List users = http.sync("/users") // http://api.example.com/users
+ .get() // GET请求
+ .getBody() // 获取响应报文体
+ .toList(User.class); // 得到目标数据
+```
+
+ 方法`sync`返回一个同步`HttpTask`，可链式使用。
+
+### 异步请求
+
+ 使用方法`async(String url)`开始一个异步请求：
+
+```java
+http.async("/users/1") // http://api.example.com/users/1
+ .setOnResponse((HttpResult result) -> {
+ // 得到目标数据
+ User user = result.getBody().toBean(User.class);
+ })
+ .get(); // GET请求
+```
+ 方法`async`返回一个异步`HttpTask`，可链式使用。
+
+### WebSocket
+
+ 使用方法`webSocket(String url)`开始一个 WebSocket 通讯：
+
+```java
+http.webSocket("/chat")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ ws.send("向服务器问好");
+ })
+ .setOnMessage((WebSocket ws，Message msg) -> {
+ // 从服务器接收消息（自动反序列化）
+ Chat chat = msg.toBean(Chat.class);
+ // 相同的消息发送给服务器（自动序列化 Chat 对象）
+ ws.send(chat);
+ })
+ .listen(); // 启动监听
+```
+ 方法`webSocket`返回一个支持 WebSocket 的`HttpTask`，也可链式使用。
+
+
+### 工具类
+
+OkHttps 提供了两个开箱即用的工具类，让你从此告别封装工具类的烦恼：
+
+工具类 | 起始版本 | 功能特点
+-|-|-
+`OkHttps` | `2.0.0.RC` | 支持自动注入`MsgConvertor`，支持 [SPI 方式注入配置](#配置okhttps)，推荐用于主应用中的网络开发
+`HttpUtils` | `1.0.0` | 自`2.0.0.RC`开始支持自动注入`MsgConvertor`，不建议再做其它配置，推荐用于第三方依赖包中的网络开发
+
+这两个工具都类会自动以 SPI 方式注入依赖中的`MsgConvertor`（在第一次使用的时候），只要你的项目中添加了相关依赖（如：okhttps-fastjson 等）。并且它们和`HTTP`接口拥有几乎一样的方法，并且这些方法都是静态的：
+
+* `sync(String url)` 开始一个同步 HTTP 请求
+* `async(String url)` 开始一个异步 HTTP 请求
+* `webSocket(String url)` 开始一个 WebSocket 连接
+* `cancel(String tag)` 按标签取消（同步 | 异步 | WebSocket）连接
+* `cancelAll()` 取消所有（同步 | 异步 | WebSocket）连接
+* `request(Request request)` OkHttp 原生 HTTP 请求
+* `webSocket(Request request, WebSocketListener listener)` OkHttp 原生 WebSocket 连接
+
+例如，使用`OkHttps`，无需考虑构造`HTTP`实例，你可以这样发起一个请求：
+
+```java
+OkHttps.async("https://api.example.com/auth/login")
+ .addBodyPara("username", "jack")
+ .addBodyPara("password", "xxxx")
+ .setOnResponse((HttpResult result) -> {
+ // 得到返回数据，使用 Mapper 可省去定义一个实体类
+ Mapper mapper = result.getBody().toMapper();
+ // 登录是否成功
+ boolean success = mapper.getBool("success");
+ })
+ .post();
+```
+
+### 配置`OkHttps`
+
+工具类`OkHttps`还支持以 SPI 方式注入自定义配置，分以下两步：
+
+#### 第一步、新建一个配置类，实现[`com.ejlchina.okhttps.Config`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Config.java)接口
+
+例如：
+
+```java
+package com.example.okhttps;
+
+import com.ejlchina.okhttps.Config;
+import com.ejlchina.okhttps.HTTP;
+
+public class OkHttpsConfig implements Config {
+
+ @Override
+ public void with(HTTP.Builder builder) {
+ // 在这里对 HTTP.Builder 做一些自定义的配置
+ builder.baseUrl("https://api.domo.com");
+ // 如果项目中添加了 okhttps-fastjson 或 okhttps-gson 或 okhttps-jackson 依赖
+ // OkHttps 会自动注入它们提供的 MsgConvertor
+ // 所以这里就不需要再配置 MsgConvertor 了 (内部实现自动注入的原理也是 SPI)
+ // 但如果没有添加这些依赖，那还需要自定义一个 MsgConvertor
+ builder.addMsgConvertor(new MyMsgConvertor());
+ }
+
+}
+```
+
+#### 第二步、在项目的`/src/main`目录下新建`resources/META-INF/services/com.ejlchina.okhttps.Config`文件，文件内容是上一步自定义的配置类的全名
+
+例如：
+
+
+
+以上两步就完成了对`OkHttps`工具类的自定义配置，接下来你便可以体验它神奇的能力了：
+
+```java
+List users = OkHttps.sync("/users") // http://api.example.com/users
+ .get().getBody().toList(User.class);
+```
+
+#### 为什么要这样呢？
+
+有同学可能会疑问，为什么要这样配置呢，不能直接给`OkHttps`设置一个`HTTP`实例吗，像这样：
+
+```java
+HTTP http = HTTP.builder()
+ // 自定义配置...
+ .build();
+
+OkHttps.set(http);
+```
+
+这样做在一般情况下确实可以，但是在某些 Java 虚拟机上（特别在 Android）中，有一个致命的缺陷：那就是系统在某些情况下会回收静态变量，而`OkHttps`内部持有的`HTTP`实例一旦被回收后，上述方式自定义的配置就会丢失，这样在后续的逻辑处理中就可能会造成严重的问题！
+
+而 SPI 注入的方式则可以很好的解决这个问题：即使`OkHttps`内部的`HTTP`实例被回收，在下次使用时，`OkHttps`又会自动加载注入的配置重新构建一个`HTTP`实例，这样就保证了用户自定义的配置不会丢失。
+
+所以我们推荐在 Android 应用开发中，直接使用`OkHttps`，自定义配置通过 SPI 方式注入。
+
+而在开发具有网络请求需求的依赖项目时，直接使用`HttpUtils`并且不做自定义的配置，如果一定要自定义配置，那就使用`HTTP.Builder`重新构建一个`HTTP`实例使用吧。
+
+
+**至此，你已轻松学会了 OkHttps 95% 的常规用法！但别急，后面还有更精彩的。**
\ No newline at end of file
diff --git a/okhttps-doc/docs/en/v2/updownload.md b/okhttps-doc/docs/en/v2/updownload.md
new file mode 100644
index 00000000..eb528473
--- /dev/null
+++ b/okhttps-doc/docs/en/v2/updownload.md
@@ -0,0 +1,240 @@
+---
+description: OkHttps 文件 上传 下载 进度监听 过程控制 断点续传 分块下载
+---
+
+# 上传下载
+
+## 文件下载
+
+ OkHttps 并没有把文件的下载排除在常规的请求之外，同一套API，它优雅的设计使得下载与常规请求融合的毫无违和感，一个最简单的示例：
+
+```java
+http.sync("/download/test.zip")
+ .get() // 使用 GET 方法（其它方法也可以，看服务器支持）
+ .getBody() // 得到报文体
+ .toFile("D:/download/test.zip") // 下载到指定的路径
+ .start(); // 启动下载
+
+http.sync("/download/test.zip").get().getBody()
+ .toFolder("D:/download") // 下载到指定的目录，文件名将根据下载信息自动生成
+ .start();
+```
+ 或使用异步连接方式：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ result.getBody().toFolder("D:/download").start();
+ })
+ .get();
+```
+ 这里要说明一下：`sync`与`async`的区别在于连接服务器并得到响应这个过程的同步与异步（这个过程的耗时在大文件下载中占比极小），而`start`方法启动的下载过程则都是异步的。
+
+### 下载进度监听
+
+ 就直接上代码啦，诸君一看便懂：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .stepBytes(1024) // 设置每接收 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .stepRate(0.01) // 设置每接收 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 下载进度回调
+ long doneBytes = process.getDoneBytes(); // 已下载字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已下载的比例
+ boolean isDone = process.isDone(); // 是否下载完成
+ })
+ .toFolder("D:/download/") // 指定下载的目录，文件名将根据下载信息自动生成
+ // .toFile("D:/download/test.zip") // 指定下载的路径，若文件已存在则覆盖
+ .setOnSuccess((File file) -> { // 下载成功回调
+
+ })
+ .start();
+```
+ 值得一提的是：由于 OkHttps 并没有把下载做的很特别，这里设置的进度回调不只对下载文件起用作，即使对响应JSON的常规请求，只要设置了进度回调，它也会告诉你报文接收的进度（提前是服务器响应的报文有`Content-Length`头），例如：
+
+```java
+List users = http.sync("/users")
+ .get()
+ .getBody()
+ .stepBytes(2)
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toList(User.class);
+```
+
+::: warning
+方法`stepBytes`和`stepRate`在 v2.0.0 正式版之前名为`setStepBytes`和`setStepRate`, v2.0.0 之后推荐使用简洁版的方法，老方法将在 v2.1.0 中移除。
+:::
+
+### 下载过程控制
+
+ 过于简单：还是直接上代码：
+
+```java
+Ctrl ctrl = http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toFolder("D:/download/")
+ .start(); // 该方法返回一个下载过程控制器
+
+ctrl.status(); // 下载状态
+ctrl.pause(); // 暂停下载
+ctrl.resume(); // 恢复下载
+ctrl.cancel(); // 取消下载（同时会删除文件，不可恢复）
+```
+ 无论是同步还是异步发起的下载请求，都可以做以上的控制：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ // 拿到下载控制器
+ Ctrl ctrl = result.getBody().toFolder("D:/download/").start();
+ })
+ .get();
+```
+
+### 实现断点续传
+
+ OkHttps 对断点续传并没有再做更高层次的封装，因为这是app该去做的事情，它在设计上使各种网络问题的处理变简单的同时力求纯粹。下面的例子可以看到，OkHttps 通过一个失败回调拿到 **断点**，便将复杂的问题变得简单：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .toFolder("D:/download/")
+ .setOnFailure((Failure failure) -> { // 下载失败回调，以便接收诸如网络错误等失败信息
+ IOException e = failure.getException(); // 具体的异常信息
+ long doneBytes = failure.getDoneBytes(); // 已下载的字节数（断点），需要保存，用于断点续传
+ File file = failure.getFile(); // 下载生成的文件，需要保存 ，用于断点续传（只保存路径也可以）
+ })
+ .start();
+```
+ 下面代码实现续传：
+
+```java
+long doneBytes = ... // 拿到保存的断点
+File file = ... // 待续传的文件
+
+http.sync("/download/test.zip")
+ .setRange(doneBytes) // 设置断点（已下载的字节数）
+ .get()
+ .getBody()
+ .toFile(file) // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+
+ })
+ .setOnFailure((Failure failure) -> {
+
+ })
+ .start();
+```
+
+### 实现分块下载
+
+ 当文件很大时，有时候我们会考虑分块下载，与断点续传的思路是一样的，示例代码：
+
+```java
+static String url = "http://api.demo.com/download/test.zip"
+
+public static void main(String[] args) {
+ long totalSize = OkHttps.sync(url).get().getBody()
+ .close() // 因为这次请求只是为了获得文件大小，不消费报文体，所以直接关闭
+ .getContentLength(); // 获得待下载文件的大小（由于未消费报文体，所以该请求不会消耗下载报文体的时间和网络流量）
+ download(totalSize, 0); // 从第 0 块开始下载
+ sleep(50000); // 等待下载完成（不然本例的主线程就结束啦）
+}
+
+static void download(long totalSize, int index) {
+ long size = 3 * 1024 * 1024; // 每块下载 3M
+ long start = index * size;
+ long end = Math.min(start + size, totalSize);
+ OkHttps.sync(url)
+ .setRange(start, end) // 设置本次下载的范围
+ .get().getBody()
+ .toFile("D:/download/test.zip") // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+ if (end < totalSize) { // 若未下载完，则继续下载下一块
+ download(totalSize, index + 1);
+ } else {
+ System.out.println("下载完成");
+ }
+ })
+ .start();
+}
+```
+
+本例中用到了`OkHttps`工具类，在应用的开发者我们推荐使用它，请参考 [工具类](/v2/getstart.html#工具类) 章节。
+
+## 文件上传
+
+ 一个简单文件上传的示例：
+
+```java
+http.sync("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .post(); // 上传发法一般使用 POST 或 PUT，看服务器支持
+```
+ 异步上传也是完全一样：
+
+```java
+http.async("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .post();
+```
+
+::: warning
+如果你使用的是 v2.0.0.RC 版本中，以上代码会报 **“方法 addFilePara 只能使用 form 方式请求”** 错误，可以用以下方式解决该问题：
+```java
+http.async("/upload")
+ .bodyType("multipart/form")
+ .addFilePara("test", "D:/download/test.zip")
+ .post();
+```
+详见 ISSUE: [https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9](https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9)
+:::
+
+### 上传进度监听
+
+ OkHttps 的上传进度监听，监听的是所有请求报文体的发送进度，示例代码：
+
+```java
+http.sync("/upload")
+ .addBodyPara("name", "Jack")
+ .addBodyPara("age", 20)
+ .addFilePara("avatar", "D:/image/avatar.jpg")
+ .stepBytes(1024) // 设置每发送 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .stepRate(0.01) // 设置每发送 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 上传进度回调
+ long doneBytes = process.getDoneBytes(); // 已发送字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已发送的比例
+ boolean isDone = process.isDone(); // 是否发送完成
+ })
+ .post();
+```
+ 咦！怎么感觉和下载的进度回调的一样？没错！OkHttps 还是使用同一套API处理上传和下载的进度回调，区别只在于上传是在`get/post`方法之前使用这些API，下载是在`getBody`方法之后使用。很好理解：`get/post`之前是准备发送请求时段，有上传的含义，而`getBody`之后，已是报文响应的时段，当然是下载。
+
+### 上传过程控制
+
+ 上传文件的过程控制就很简单，和常规请求一样，只有异步发起的上传可以取消：
+
+```java
+HttpCall call = http.async("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .post();
+
+call.cancel(); // 取消上传
+```
+ 上传就没有暂停和继续这个功能啦，应该没人有这个需求吧?
\ No newline at end of file
diff --git a/okhttps-doc/docs/v1/README.md b/okhttps-doc/docs/v1/README.md
new file mode 100644
index 00000000..84a45c42
--- /dev/null
+++ b/okhttps-doc/docs/v1/README.md
@@ -0,0 +1,103 @@
+---
+description: OkHttps 安装 构建实例 HTTP build 同步请求 异步请求 sync async BaseUrl request webSocket gradle maven ejlchina
+---
+
+# 起步
+
+ OkHttps 是近期开源的对 OkHttp3 轻量封装的框架，它独创的异步预处理器，特色的标签，灵活的上传下载进度监听与过程控制功能，在轻松解决很多原本另人头疼问题的同时，设计上也力求纯粹与优雅。
+
+ * 链式调用，一点到底
+ * BaseURL、URL占位符、JSON自动封装与解析
+ * 同步拦截器、异步预处理器、回调执行器、全局监听、回调阻断
+ * 文件上传下载（过程控制、进度监听）
+ * 单方法回调，充分利用 Lambda 表达式
+ * TCP连接池、Http2
+
+::: tip
+* OkHttps 非常轻量（59Kb），仅是 Retrofit（124Kb）的一半，并且更加的开箱即用，API 也更加自然和语义化。
+* OkHttps 是一个纯粹的 Java 网络开发包，并不依赖 Android，这一点和 Retrofit 不同
+* OkHttps 用起来很优美，可以像 RxJava 那样链式用，却比 RxJava 更简单。
+:::
+
+## 安装
+
+### Maven
+
+```xml
+
+ com.ejlchina
+ okhttps
+ 1.0.5
+
+```
+### Gradle
+
+```groovy
+implementation 'com.ejlchina:okhttps:1.0.5'
+```
+
+安卓中使用需要把 JDK 版本调成 1.8，在 app 模块的 build.gradle 中加入以下配置即可：
+
+```groovy
+android {
+ // 省略其它配置..
+ compileOptions {
+ sourceCompatibility = 1.8
+ targetCompatibility = 1.8
+ }
+}
+```
+
+## 使用
+
+### 构建实例
+
+```java
+HTTP http = HTTP.builder().build();
+```
+ 以上代码构建了一个最简单的`HTTP`实例，它拥有以下方法：
+
+* `sync(String url)` 开始一个同步请求
+* `async(String url)` 开始一个异步请求
+* `cancel(String tag)` 按标签取消请求
+* `cancelAll()` 取消所有HTTP任务，包括同步和异步
+* `request(Request request)` OkHttp 原生请求
+* `webSocket(Request request, WebSocketListener listener)` WebSocket通讯
+
+ 为了使用方便，在构建的时候，我们更愿意指定一个`BaseUrl`（详见 [设置 BaseUrl](/v1/configuration.html#设置-baseurl)）:
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.demo.com")
+ .build();
+```
+ 为了简化文档，下文中出现的`http`均是在构建时设置了`BaseUrl`的`HTTP`实例。
+
+### 同步请求
+
+ 使用方法`sync(String url)`开始一个同步请求：
+
+```java
+List users = http.sync("/users") // http://api.demo.com/users
+ .get() // GET请求
+ .getBody() // 获取响应报文体
+ .toList(User.class); // 得到目标数据
+```
+ 方法`sync`返回一个同步`HttpTask`，可链式使用。
+
+### 异步请求
+
+ 使用方法`async(String url)`开始一个异步请求：
+
+```java
+http.async("/users/1") // http://api.demo.com/users/1
+ .setOnResponse((HttpResult result) -> {
+ // 得到目标数据
+ User user = result.getBody().toBean(User.class);
+ })
+ .get(); // GET请求
+```
+ 方法`async`返回一个异步`HttpTask`，可链式使用。
+
+
+**至此，你已轻松学会了 OkHttps 95% 的常规用法！但别急，后面还有更精彩的。**
\ No newline at end of file
diff --git a/okhttps-doc/docs/v1/android.md b/okhttps-doc/docs/v1/android.md
new file mode 100644
index 00000000..73c7fde5
--- /dev/null
+++ b/okhttps-doc/docs/v1/android.md
@@ -0,0 +1,181 @@
+---
+description: OkHttps 安卓 生命周期 UI线程 主线程 IO线程 自由 灵活 切换 生命周期绑定 配置预处理器 定义生命周期监视器 配置全局回调监听
+---
+
+# 安卓
+
+## 回调线程切换
+
+ 在 Android 开发中，经常会把某些代码放到特点的线程去执行，比如网络请求响应后的页面更新在主线程（UI线程）执行，而保存文件则在IO线程操作。OkHttps 为这类问题提供了良好的方案。
+
+ 在 **默认** 情况下，**所有回调** 函数都会 **在 IO 线程** 执行。为什么会设计如此呢？这是因为 OkHttps 只是纯粹的 Java 领域 Http工具包，本身对 Android 不会有任何依赖，因此也不知 Android 的 UI 线程为何物。这么设计也让它在 Android 之外有更多的可能性。
+
+### 配置
+
+ 但是在 Android 里使用 OkHttps 的话，UI线程的问题能否优雅的解决呢？当然可以！简单粗暴的方法就是配置一个 回调执行器：
+
+ ```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ // 实际编码中可以吧 Handler 提出来，不需要每次执行回调都重新创建
+ new Handler(Looper.getMainLooper()).post(run); // 在主线程执行
+ })
+ .build();
+```
+
+### 用例
+
+ 上述代码便实现了让 **所有** 的 **回调函数** 都在 **主线程（UI线程）** 执行的目的，如：
+
+```java
+http.async("/users")
+ .addBodyParam("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .setOnResponse((HttpResult result) -> {
+ // 在主线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行
+ })
+ .setOnComplete((State state) -> {
+ // 在主线程执行
+ })
+ .post();
+```
+ 但是，如果同时还想让某些回调放在IO线程，实现 **自由切换**，怎么办呢？OkHttps 给出了非常灵活的方法，如下：
+
+```java
+http.async("/users")
+ .addBodyParam("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnResponse((HttpResult result) -> {
+ // 在 IO 线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行（没有指明 nextOnIO 则在回调执行器里执行）
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnComplete((State state) -> {
+ // 在 IO 线程执行
+ })
+ .post();
+```
+ 无论是哪一个回调，都可以使用`nextOnIO()`方法自由切换。同样，对于文件下载也是一样：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .toFolder("D:/download/")
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnSuccess((File file) -> {
+ // 在 IO 线程执行
+ })
+ .setOnFailure((Failure failure) -> {
+ // 在主线程执行
+ })
+ .start();
+```
+
+## 生命周期绑定
+
+ 由于 OkHttps 并不依赖于 Android，所以它并没有提供关于生命周期绑定的直接实现，但它的一些扩展机制让我们很容易就可以实现这个需求。在开始之前，我们首先要理解何为生命周期绑定：
+
+::: tip HTTP 请求的生命周期绑定
+所谓的生命周期绑定：即是让 HTTP 任务感知其所属的 Activity 或 Fragment 的生命周期，当 Activity 或 Fragment 将被销毁时，框架应自动的把由它们发起的但尚未完成的 HTTP 任务全部取消，以免导致程序出错！
+:::
+
+ 现在我们需要对`HTTP`实例进行配置，配置后的`HTTP`实例具有生命周期绑定的功能，在`Activity`或`Fragment`里，它的使用效果如下：
+
+```java
+// 在 Activity 或 Fragment 内发起请求
+http.async("http://www.baidu.com")
+ .bind(getLifecycle()) // 绑定生命周期
+ .setOnResponse((HttpResult result) -> {
+ Log.i("FirstFragment", "收到请求：" + result.toString());
+ })
+ .get();
+```
+ 上述代码中的`getLifecycle()`是`Activity`或`Fragment`自带的方法，而`bind()`是`HttpTask`的现有方法。在配置好`HTTP`实例后，上述代码发起的请求便可以感知`Activity`或`Fragment`的生命周期。
+
+ 那`HTTP`实例到底该如何配置呢？
+
+### 第一步：配置预处理器
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .addPreprocessor((Preprocessor.PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了 Lifecycle 对象
+ if (bound instanceof Lifecycle) {
+ // 重新绑定一个 生命周期监视器（LCObserver）对象，它的定义见下一步
+ task.bind(new LCObserver(task, (Lifecycle) bound));
+ }
+ chain.proceed();
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+### 第二步：定义生命周期监视器
+
+```java
+public class LCObserver implements LifecycleObserver {
+
+ HttpTask task;
+ Lifecycle lifecycle;
+
+ LCObserver(HttpTask task, Lifecycle lifecycle) {
+ this.task = task;
+ this.lifecycle = lifecycle;
+ lifecycle.addObserver(this);
+ }
+
+ @OnLifecycleEvent(Lifecycle.Event.ON_STOP)
+ public void onStop() {
+ task.cancel(); // 在 ON_STOP 事件中，取消对应的 HTTP 任务
+ }
+
+ public void unbind() {
+ // 在请求完成之后移除监视器
+ lifecycle.removeObserver(this);
+ }
+
+}
+```
+
+### 第三步：配置全局回调监听
+
+ 以上两步其实已经实现了生命周期绑定的功能，但是在请求完成之后，我们需要在`lifecycle`中移除`LCObserver`对象：
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .completeListener((HttpTask task, HttpResult.State state) -> {
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了生命周期监视器（LCObserver）对象
+ if (bound instanceof LCObserver) {
+ // 解绑监视器
+ ((LCObserver) bound).unbind();
+ }
+ return true;
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+**以上三步便在Android中实现了生命周期与HTTP请求绑定的功能**
+
+ 非常简单，懒得敲代码的同学还可以 [点这里 OkHttps.java](https://gitee.com/ejlchina-zhxu/okhttps-android-demo/blob/master/app/src/main/java/com/flower/myapplication/http/OkHttps.java) 直接下载封装好的源码，其中不仅编写了生命周期绑定的配置，还有在UI线程执行回调的配置。
+
+ 有需要的同学，可以直接下载下来使用，还可以基于它再次扩展，比如实现自动添加 TOKEN 的功能，具体可以参考[6.5 串行预处理器（TOKEN问题最佳解决方案）](#65-串行预处理器token问题最佳解决方案)，再比如扩展实现生命周期与下载事件绑定的功能，都非常简单。
diff --git a/okhttps-doc/docs/v1/configuration.md b/okhttps-doc/docs/v1/configuration.md
new file mode 100644
index 00000000..30bf60e9
--- /dev/null
+++ b/okhttps-doc/docs/v1/configuration.md
@@ -0,0 +1,158 @@
+---
+description: OkHttps 配置 BaseUrl 回调执行器 主线程 UI线程 OkHttpClient 预处理器 TOKEN问题最佳解决方案 刷新TOKEN 全局 回调监听 下载监听 回调阻断 拦截器 CookieJar、SSL、缓存、代理、事件监听
+---
+
+# 配置
+
+## 设置 BaseUrl
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.demo.com") // 设置 BaseUrl
+ .build();
+```
+ 该配置全局生效，在配置了`BaseUrl`之后，具体的请求便可以省略`BaseUrl`部分，使得代码更加简洁，例如：
+
+```java
+http.sync("/users").get() // http://api.demo.com/users
+
+http.sync("/auth/signin") // http://api.demo.com/auth/signin
+ .addBodyParam("username", "Jackson")
+ .addBodyParam("password", "xxxxxx")
+ .post(); // POST请求
+```
+ 在配置了`BaseUrl`之后，如有特殊请求任务，仍然可以使用全路径的方式，一点都不妨碍：
+
+```java
+http.sync("https://www.baidu.com").get();
+```
+
+## 回调执行器
+
+ OkHttps 默认所有回调都在 **IO线程** 执行，如何想改变执行回调的线程时，可以配置回调执行器。例如在Android里，让所有的回调函数都在UI线程执行，则可以在构建`HTTP`时配置如下：
+
+```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ runOnUiThread(run); // 在UI线程执行
+ })
+ .build();
+```
+ 该配置默认 **影响所有回调**。
+
+## 配置 OkHttpClient
+
+ 与其他封装 OkHttp3 的框架不同，OkHttps 并不会遮蔽 OkHttp3 本身就很好用的功能，如下：
+
+```java
+HTTP http = HTTP.builder()
+ .config((Builder builder) -> {
+ // 配置连接池 最小10个连接（不配置默认为 5）
+ builder.connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES));
+ // 配置连接超时时间（默认10秒）
+ builder.connectTimeout(20, TimeUnit.SECONDS);
+ // 配置拦截器
+ builder.addInterceptor((Chain chain) -> {
+ Request request = chain.request();
+ // 必须同步返回，拦截器内无法执行异步操作
+ return chain.proceed(request);
+ });
+ // 其它配置: CookieJar、SSL、缓存、代理、事件监听...
+ })
+ .build();
+```
+
+## 并行预处理器
+
+ 预处理器（`Preprocessor`）可以让我们在请求发出之前对请求本身做一些改变，但与`OkHttp`的拦截器（`Interceptor`）不同：预处理器可以让我们 **异步** 处理这些问题。
+
+ 例如，当我们想为请求任务自动添加`Token`头信息，而`Token`只能通过异步方法`requestToken`获取时，这时使用`Interceptor`就很难处理了，但可以使用预处理器轻松解决：
+
+```java
+HTTP http = HTTP.builder()
+ .addPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();// 获得当前的HTTP任务
+ if (!task.isTagged("Auth")) { // 根据标签判断该任务是否需要Token
+ chain.proceed();
+ return;
+ }
+ requestToken((String token) -> { // 异步获取 Token
+ task.addHeader("Token", token);// 为任务添加头信息
+ chain.proceed(); // 继续当前的任务
+ });
+ })
+ .build();
+```
+ 和`Interceptor`一样，`Preprocessor`也可以添加多个。他们之间的区别如下:
+
+::: tip 拦截器与预处理器的区别
+* 拦截器只能处理同步操作，预处理器支持处理异步操作
+* 拦截器都是并行处理请求，预处理器支持串行处理（详见6.5章节）
+* 拦截器处理时机在请求前和响应后，预处理器只在请求前，并且先于拦截器执行。关于响应后，OkHttps还提供了全局回调监听（详见6.6章节）
+:::
+
+## 串行预处理器（TOKEN问题最佳解决方案）
+
+ 普通预处理器都是可并行处理的，然而有时我们希望某个预处理器同时只处理一个任务。比如 当`Token`过期时我们需要去刷新获取新`Token`，而刷新`Token`这个操作只能有一个任务去执行，因为如果`n`个任务同时执行的话，那么必有`n-1`个任务刚刷新得到的`Token`可能就立马失效了，而这是我们所不希望的。
+
+ 为了解决这个问题，OkHttps 提供了串行预处理器，它可以让 HTTP 任务排好队，一个一个地进入预处理器：
+
+```java
+HTTP http = HTTP.builder()
+ .addSerialPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ if (!task.isTagged("Auth")) {
+ chain.proceed();
+ return;
+ }
+ // 检查过期，若需要则刷新Token
+ requestTokenAndRefreshIfExpired((String token) -> {
+ task.addHeader("Token", token);
+ chain.proceed(); // 调用此方法前，不会有其它任务进入该处理器
+ });
+ })
+ .build();
+```
+ 串行预处理器实现了让HTTP任务排队串行处理的功能，但值得一提的是：它并没有因此而阻塞任何线程！
+
+## 全局回调监听
+
+ 全局回调是实际开发中经常需要的功能，比如对服务器响应的状态码进行统一处理等，同时 OkHttps 的全局回调还具有 **回调阻断** 的功能：
+
+```java
+HTTP http = HTTP.builder()
+ .responseListener((HttpTask task, HttpResult result) -> {
+ // 所有请求响应后都会走这里
+
+ return true; // 返回 true 表示继续执行 task 的 OnResponse 回调，false 表示不再执行
+ })
+ .completeListener((HttpTask task, State state) -> {
+ // 所有请求执行完都会走这里
+
+ return true; // 返回 true 表示继续执行 task 的 OnComplete 回调，false 表示不再执行
+ })
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求发生异常都会走这里
+
+ return true; // 返回 true 表示继续执行 task 的 OnException 回调，false 表示不再执行
+ })
+ .build();
+```
+
+::: tip 全局回调监听与拦截器的异同：
+* 拦截器可以添加多个，全局回调监听分三种，每种最多添加一个
+* 拦截器处的理时机在请求前和响应后，全局回调监听只在响应后，并且晚于拦截器
+* 全局回调监听可以 **阻断**（return false）某个请求的具体回调，而拦截器不能
+:::
+
+## 全局下载监听
+
+```java
+HTTP http = HTTP.builder()
+ .downloadListener((HttpTask task, Download download) -> {
+ // 所有下载在开始之前都会先走这里
+ Ctrl ctrl = download.getCtrl(); // 下载控制器
+
+ })
+ .build();
+```
\ No newline at end of file
diff --git a/okhttps-doc/docs/v1/features.md b/okhttps-doc/docs/v1/features.md
new file mode 100644
index 00000000..56771574
--- /dev/null
+++ b/okhttps-doc/docs/v1/features.md
@@ -0,0 +1,170 @@
+---
+description: OkHttps 使用 HttpUtils 类 WebSocket 异常处理 nothrow 异常回调 多种方式 取消请求 标签 批量取消 cancelAll
+---
+
+# 特色
+
+## 使用 HttpUtils 类
+
+ 类`HttpUtils`本是 [前身 HttpUtils](https://gitee.com/ejlchina-zhxu/httputils) 的 1.x 版本里的最重要的核心类，由于在后来的版本里抽象出了`HTTP`接口，使得它的重要性已不如往昔。但合理的使用它，仍然可以带来不少便利，特别是在没有IOC容器的环境里，比如在Android开发和一些工具项目的开发中。
+
+ 类`HttpUtils`共定义了四个静态方法：
+
+* `of(HTTP http)` 配置`HttpUtils`持有的`HTTP`实例（不调用此方法前默认使用一个没有没有经过任何配置的`HTTP`懒实例）
+* `sync(String url)` 开始一个同步请求 （内部通过一个`HTTP`单例实现）
+* `async(String url)` 开始一个异步请求 （内部通过一个`HTTP`单例实现）
+* `cancel(String tag)` 按标签取消请求（内部通过一个`HTTP`单例实现）
+* `cancelAll()` 取消所有HTTP任务，包括同步和异步（内部通过一个`HTTP`单例实现）
+* `request(Request request)` OkHttp 原生请求 （该请求不经过 预处理器）
+* `webSocket(Request request, WebSocketListener listener)` WebSocket通讯
+ 也就是说，能使用`http`实例的地方，都可以使用`HttpUtils`类，例如：
+
+```java
+// 在配置HTTP实例之前，只能使用全路径方式
+List roles = HttpUtils.sync("http://api.demo.com/roles")
+ .get().getBody().toList(Role.class);
+
+// 配置HTTP实例,全局生效
+HttpUtils.of(HTTP.builder()
+ .baseUrl("http://api.demo.com")
+ .build());
+
+// 内部使用新的HTTP实例
+List users = HttpUtils.sync("/users")
+ .get().getBody().toList(User.class);
+```
+
+## 异常处理
+
+ 使用 OkHttps 时，**异常处理不是必须的**，但相比其它的 HTTP 开发包，它还提供一个特别的处理方法：`nothrow()`，以满足不同的异常处理需求。
+
+### 同步请求的异常
+
+ 默认情况下，当同步请求执行异常时，会直接向外抛出，我们可以用 `try catch` 来捕获，例如：
+
+```java
+try {
+ HttpResult result = http.sync("/users/1").get();
+} catch (HttpException e) {
+ Throwable cause = e.getCause(); // 得到异常原因
+ if (cause instanceof ConnectException) {
+ // 当没网络时，会抛出连接异常
+ }
+ if (cause instanceof SocketTimeoutException) {
+ // 当接口长时间未响应，会抛出超时异常
+ }
+ if (cause instanceof UnknownHostException) {
+ // 当把域名或IP写错，会抛出 UnknownHost 异常
+ }
+ // ...
+}
+```
+ 这种传统的异常处理方式，当然可以解决问题，但 OkHttps 有更佳的方案：
+
+```java
+// 方法 nothrow() 让异常不直接抛出
+HttpResult result = http.sync("/users/1").nothrow().get();
+// 判断执行状态
+switch (result.getState()) {
+ case RESPONSED: // 请求已正常响应
+ break;
+ case CANCELED: // 请求已被取消
+ break;
+ case NETWORK_ERROR: // 网络错误，说明用户没网了
+ break;
+ case TIMEOUT: // 请求超时
+ break;
+ case EXCEPTION: // 其它异常
+ break;
+}
+// 还可以获得具体的异常信息
+IOException error = result.getError();
+```
+
+### 异步请求的异常
+
+ 异步请求最常用的异常处理方式就是设置一个异常回调：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnException((IOException e) -> {
+ // 这里处理请求异常
+ })
+ .get();
+```
+ 当然，还有一个全局异常监听（`ExceptionListener`）：
+
+```java
+HTTP http = HTTP.builder()
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求发生异常都会走这里
+
+ return true; // 返回 true 表示继续执行 task 的 OnException 回调，false 表示不再执行
+ })
+ .build();
+```
+ 如果不设置`OnException`回调，也没有`ExceptionListener`，发生异常时会在 **IO 线程** 中向上抛出，外层无法捕获：
+
+```java
+try {
+ http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+} catch (HttpException e) {
+ // 这种方式是捕获不到异常的！！！！！！
+}
+```
+ 即使没有`OnException`回调，发生异常时，依然会走`OnComplete`回调，如果设置了的话：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnComplete((State state) -> {
+ // 发生异常，会先执行这里，可以根据 state 判断发生了什么
+ // 但执行完后依然会在IO线程中向上抛出
+ })
+ .get();
+```
+ 如果就是想 **不处理异常，也不向上抛出**，发生错误完全无视，可以做到吗？可以！还是使用`nothrow()`方法：
+
+```java
+http.async("/users/1")
+ .nothrow() // 告诉 OkHttps 发生异常时不向外抛出
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+```
+
+## 取消请求
+
+ 在 OkHttps 里取消请求共有 **4 种** 方式可选：
+
+* 使用`HttpCall#cancel()`取消单个请求（适用于异步请求，[详见 3.3 章节](#33-httpcall)）
+* 使用`HttpTask#cancel()`取消单个请求（适用于所有请求）（since v1.0.4）
+
+```java
+HttpTask task = http.async("/users")
+ .setOnResponse((HttpResult result) -> {
+ // 响应回调
+ });
+
+task.get(); // 发起 GET 请求
+
+// 取消请求，并返回是否取消成功
+boolean canceled = task.cancel();
+```
+
+* 使用`HTTP#cancel(String tag)`按标签批量取消请求（适用于所有请求，[详见第 5 章节](#5-使用标签)）
+* 使用`HTTP#cancelAll()`取消所有请求（适用于所有请求）（since v1.0.2）
+
+```java
+http.cancelAll(); // 取消所有请求
+```
\ No newline at end of file
diff --git a/okhttps-doc/docs/v1/foundation.md b/okhttps-doc/docs/v1/foundation.md
new file mode 100644
index 00000000..e48cd8af
--- /dev/null
+++ b/okhttps-doc/docs/v1/foundation.md
@@ -0,0 +1,209 @@
+---
+description: OkHttps 请求方法 回调函数 HttpResult cache 多次 消费报文体 HttpCall 构建HTTP任务 请求参数 JSON 使用标签 发起请求 取消请求
+---
+
+# 基础
+
+## 请求方法
+
+ 同步与异步的`HttpTask`都拥有`get`、`post`、`put`与`delete`方法。不同的是：同步`HttpTask`的这些方法返回一个`HttpResult`，而异步`HttpTask`的这些方法返回一个`HttpCall`。
+
+```java
+HttpResult res1 = http.sync("/users").get(); // 同步 GET
+HttpResult res2 = http.sync("/users").post(); // 同步 POST
+HttpResult res3 = http.sync("/users/1").put(); // 同步 PUT
+HttpResult res4 = http.sync("/users/1").delete();// 同步 DELETE
+HttpCall call1 = http.async("/users").get(); // 异步 GET
+HttpCall call2 = http.async("/users").post(); // 异步 POST
+HttpCall call3 = http.async("/users/1").put(); // 异步 PUT
+HttpCall call4 = http.async("/users/1").delete();// 异步 DELETE
+```
+
+## 回调函数
+
+ OkHttps 的回调函数全部使用单方法模式，这样可以充分利用 Java8 或 Kotlin 中的 Lambda 表达式，使你的代码更加简洁优雅：
+
+```java
+http.async("/users/{id}") // http://api.demo.com/users/1
+ .addPathParam("id", 1)
+ .setOnResponse((HttpResult result) -> {
+ // 响应回调
+ })
+ .setOnException((IOException e) -> {
+ // 异常回调
+ })
+ .setOnComplete((State state) -> {
+ // 完成回调，无论成功失败都会执行
+ // 并且在 响应|异常回调 之前执行
+ })
+ .get();
+```
+
+ OkHttps 同时还支持 **全局回调** 和 **回调阻断** 机制，详见 [全局回调监听](/v1/configuration.html#全局回调监听)。
+
+::: tip
+* 只有异步请求才可以设置这三种（响应|异常|完成）回调
+* 同步请求直接返回结果，无需使用回调
+:::
+
+## HttpResult
+
+ `HttpResult`是HTTP请求执行完后的结果，它是同步请求方法（ `get`、`post`、`put`、`delete`）的返回值，也是异步请求响应回调（`OnResponse`）的参数，它定义了如下方法：
+
+* `getState()` 得到请求执行状态枚举，它有以下取值：
+ * `State.CANCELED` 请求被取消
+ * `State.RESPONSED` 已收到响应
+ * `State.TIMEOUT` 请求超时
+ * `State.NETWORK_ERROR` 网络错误
+ * `State.EXCEPTION` 其它请求异常
+* `getStatus()` 得到HTTP状态码
+* `isSuccessful()` 是否响应成功，状态码在 [200..300) 之间
+* `getHeaders()` 得到HTTP响应头
+* `getHeaders(String name)` 得到HTTP响应头
+* `getHeader(String name)` 得到HTTP响应头
+* `getBody()` 得到响应报文体`Body`实例，它定义了如下方法（对同一个`Body`实例，以下的`toXXX()`类方法只能使用一个且仅能调用一次，除非先使用 cache 方法）：
+ * `toBytes()` 返回字节数组
+ * `toByteStream()` 返回字节输入流
+ * `toCharStream()` 返回字符输入流
+ * `toString()` 返回字符串
+ * `toJsonObject()` 返回Json对象
+ * `toJsonArray()` 返回Json数组
+ * `toBean(Class type)` 返回根据type自动json解析后的JavaBean
+ * `toList(Class type)` 返回根据type自动json解析后的JavaBean列表
+ * `toFile(String filePath)` 下载到指定路径
+ * `toFile(File file)` 下载到指定文件
+ * `toFolder(String dirPath)` 下载到指定目录
+ * `toFolder(File dir)` 下载到指定目录
+ * `getContentType()` 返回报文体的媒体类型
+ * `getContentLength()` 返回报文体的字节长度
+ * `cache()` 缓存报文体，开启缓存后可重复使用`toXXX()`类方法
+ * `close()` 关闭报文体，未对报文体做任何消费时使用，比如只读取报文头
+* `getError()` 执行中发生的异常，自动捕获执行请求时发生的 网络超时、网络错误 和 其它IO异常
+* `close()` 关闭报文，未对报文体做任何消费时使用，比如只读取长度
+
+ 示例，请求结果自动转Bean和List：
+
+```java
+// 自动转Bean
+Order order = http.sync("/orders/1")
+ .get().getBody().toBean(Order.class);
+
+// 自动转List
+List orders = http.sync("/orders")
+ .get().getBody().toList(Order.class);
+```
+
+ 示例，使用 cache 方法：
+
+```java
+Body body = http.sync("/orders").get().getBody().cache();
+
+// 使用 cache 后，可以多次使用 toXXX() 方法
+System.out.println(body.toString());
+System.out.println(body.toJsonArray());
+System.out.println(body.toList(Order.class));
+```
+
+ 示例，获取下载文件的大小：
+
+```java
+long size = http.sync("/download/test.zip")
+ .get().getBody()
+ .close() // 只是想获得文件大小，不消费报文体，所以直接关闭
+ .getContentLength(); // 获得待下载文件的大小
+
+// 由于未消费报文体，所以本次请求不会消耗下载报文体的时间和网络流量
+
+System.out.println("size = " + size);
+```
+
+## HttpCall
+
+ `HttpCall`对象是异步请求方法（`get`、`post`、`put`、`delete`）的返回值，与`java`的`Future`接口很像，它有如下方法：
+
+* `cancel()` 取消本次请求，返回取消结果
+* `isCanceled()` 返回请求是否被取消
+* `isDone()` 返回是否执行完成，包含取消和失败
+* `getResult()` 返回执行结果`HttpResult`对象，若请求未执行完，则挂起当前线程直到执行完成再返回
+
+ 取消一个异步请求示例：
+
+```java
+HttpCall call = http.async("/users/1").get();
+
+System.out.println(call.isCanceled()); // false
+
+boolean success = call.cancel(); // 取消请求
+
+System.out.println(success); // true
+System.out.println(call.isCanceled()); // true
+```
+
+## 构建HTTP任务
+
+ `HTTP`对象的`sync`与`async`方法返回一个`HttpTask`对象，该对象提供了可链式调用的`addXXX`与`setXXX`等系列方法用于构建任务本身。
+
+* `addHeader(String name, String value)` 添加请求头
+* `addHeader(Map headers)` 添加请求头
+
+* `addPathParam(String name, Object value)` 添加路径参数：替换URL里的{name}占位符
+* `addPathParam(Map params)` 添加路径参数：替换URL里的{name}占位符
+
+* `addUrlParam(String name, Object value)` 添加URL参数：拼接在URL的?之后（查询参数）
+* `addUrlParam(Map params)` 添加URL参数：拼接在URL的?之后（查询参数）
+
+* `addBodyParam(String name, Object value)` 添加Body参数：以表单key=value&的形式放在报文体内（表单参数）
+* `addBodyParam(Map params)` 添加Body参数：以表单key=value&的形式放在报文体内（表单参数）
+
+* `addJsonParam(String name, Object value)` 添加Json参数：请求体为Json（支持多层结构）
+* `addJsonParam(Map params)` 添加Json参数：请求体为Json（支持多层结构）
+
+* `setRequestJson(Object json)` 设置请求体的Json字符串 或待转换为 Json的 JavaBean
+* `setRequestJson(Object bean, String dateFormat)` 设置请求体的Json字符串 或待转换为 Json的 JavaBean
+
+* `addFileParam(String name, String filePath)` 上传文件
+* `addFileParam(String name, File file)` 上传文件
+* `addFileParam(String name, String type, InputStream inputStream)` 上传文件
+* `addFileParam(String name, String type, String fileName, InputStream input)` 上传文件
+* `addFileParam(String name, String type, byte[] content)` 上传文件
+* `addFileParam(String name, String type, String fileName, byte[] content)` 上传文件
+
+* `setTag(String tag)` 为HTTP任务添加标签
+* `setRange(long rangeStart)` 设置Range头信息，用于[断点续传](/v1/updown.html#实现断点续传)
+* `setRange(long rangeStart, long rangeEnd)` 设置Range头信息，可用于[分块下载](/v1/updown.html#实现分块下载)
+
+* `bind(Object object)` 绑定一个对象，可用于实现Android里的[生命周期绑定](/v1/android.html#生命周期绑定)
+
+## 使用标签
+
+ 有时候我们想对HTTP任务加以分类，这时候可以使用标签功能：
+
+```java
+http.async("/users") //（1）
+ .setTag("A")
+ .get();
+
+http.async("/users") //（2）
+ .setTag("A.B")
+ .get();
+
+http.async("/users") //（3）
+ .setTag("B")
+ .get();
+
+http.async("/users") //（4）
+ .setTag("B")
+ .setTag("C") // 从 v1.0.4 标签将以追加模式添加，等效于 setTag("B.C")
+ .get();
+
+http.async("/users") //（5）
+ .setTag("C")
+ .get();
+```
+ 当使用标签后，就可以按标签批量的对HTTP任务进行取消：
+
+```java
+int count = http.cancel("B"); //（2）（3）（4）被取消（取消标签包含"B"的任务）
+System.out.println(count); // 输出 3
+```
+ 标签除了可以用来取消任务，在预处理器中它也可以发挥作用，请参见 [并行预处理器](/v1/configuration.html#并行预处理器) 与 [串行预处理器（token问题最佳解决方案）](/v1/configuration.html#串行预处理器（token问题最佳解决方案）)。
diff --git a/okhttps-doc/docs/v1/updown.md b/okhttps-doc/docs/v1/updown.md
new file mode 100644
index 00000000..73486bac
--- /dev/null
+++ b/okhttps-doc/docs/v1/updown.md
@@ -0,0 +1,223 @@
+---
+description: OkHttps 文件 上传 下载 进度监听 过程控制 断点续传 分块下载
+---
+
+# 上传下载
+
+## 文件下载
+
+ OkHttps 并没有把文件的下载排除在常规的请求之外，同一套API，它优雅的设计使得下载与常规请求融合的毫无违和感，一个最简单的示例：
+
+```java
+http.sync("/download/test.zip")
+ .get() // 使用 GET 方法（其它方法也可以，看服务器支持）
+ .getBody() // 得到报文体
+ .toFile("D:/download/test.zip") // 下载到指定的路径
+ .start(); // 启动下载
+
+http.sync("/download/test.zip").get().getBody()
+ .toFolder("D:/download") // 下载到指定的目录，文件名将根据下载信息自动生成
+ .start();
+```
+ 或使用异步连接方式：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ result.getBody().toFolder("D:/download").start();
+ })
+ .get();
+```
+ 这里要说明一下：`sync`与`async`的区别在于连接服务器并得到响应这个过程的同步与异步（这个过程的耗时在大文件下载中占比极小），而`start`方法启动的下载过程则都是异步的。
+
+### 下载进度监听
+
+ 就直接上代码啦，诸君一看便懂：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setStepBytes(1024) // 设置每接收 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .setStepRate(0.01) // 设置每接收 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 下载进度回调
+ long doneBytes = process.getDoneBytes(); // 已下载字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已下载的比例
+ boolean isDone = process.isDone(); // 是否下载完成
+ })
+ .toFolder("D:/download/") // 指定下载的目录，文件名将根据下载信息自动生成
+ // .toFile("D:/download/test.zip") // 指定下载的路径，若文件已存在则覆盖
+ .setOnSuccess((File file) -> { // 下载成功回调
+
+ })
+ .start();
+```
+ 值得一提的是：由于 OkHttps 并没有把下载做的很特别，这里设置的进度回调不只对下载文件起用作，即使对响应JSON的常规请求，只要设置了进度回调，它也会告诉你报文接收的进度（提前是服务器响应的报文有`Content-Length`头），例如：
+
+```java
+List users = http.sync("/users")
+ .get()
+ .getBody()
+ .setStepBytes(2)
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toList(User.class);
+```
+
+### 下载过程控制
+
+ 过于简单：还是直接上代码：
+
+```java
+Ctrl ctrl = http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toFolder("D:/download/")
+ .start(); // 该方法返回一个下载过程控制器
+
+ctrl.status(); // 下载状态
+ctrl.pause(); // 暂停下载
+ctrl.resume(); // 恢复下载
+ctrl.cancel(); // 取消下载（同时会删除文件，不可恢复）
+```
+ 无论是同步还是异步发起的下载请求，都可以做以上的控制：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ // 拿到下载控制器
+ Ctrl ctrl = result.getBody().toFolder("D:/download/").start();
+ })
+ .get();
+```
+
+### 实现断点续传
+
+ OkHttps 对断点续传并没有再做更高层次的封装，因为这是app该去做的事情，它在设计上使各种网络问题的处理变简单的同时力求纯粹。下面的例子可以看到，OkHttps 通过一个失败回调拿到 **断点**，便将复杂的问题变得简单：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .toFolder("D:/download/")
+ .setOnFailure((Failure failure) -> { // 下载失败回调，以便接收诸如网络错误等失败信息
+ IOException e = failure.getException(); // 具体的异常信息
+ long doneBytes = failure.getDoneBytes(); // 已下载的字节数（断点），需要保存，用于断点续传
+ File file = failure.getFile(); // 下载生成的文件，需要保存 ，用于断点续传（只保存路径也可以）
+ })
+ .start();
+```
+ 下面代码实现续传：
+
+```java
+long doneBytes = ... // 拿到保存的断点
+File file = ... // 待续传的文件
+
+http.sync("/download/test.zip")
+ .setRange(doneBytes) // 设置断点（已下载的字节数）
+ .get()
+ .getBody()
+ .toFile(file) // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+
+ })
+ .setOnFailure((Failure failure) -> {
+
+ })
+ .start();
+```
+
+### 实现分块下载
+
+ 当文件很大时，有时候我们会考虑分块下载，与断点续传的思路是一样的，示例代码：
+
+```java
+static String url = "http://api.demo.com/download/test.zip"
+
+public static void main(String[] args) {
+ long totalSize = HttpUtils.sync(url).get().getBody()
+ .close() // 因为这次请求只是为了获得文件大小，不消费报文体，所以直接关闭
+ .getContentLength(); // 获得待下载文件的大小（由于未消费报文体，所以该请求不会消耗下载报文体的时间和网络流量）
+ download(totalSize, 0); // 从第 0 块开始下载
+ sleep(50000); // 等待下载完成（不然本例的主线程就结束啦）
+}
+
+static void download(long totalSize, int index) {
+ long size = 3 * 1024 * 1024; // 每块下载 3M
+ long start = index * size;
+ long end = Math.min(start + size, totalSize);
+ HttpUtils.sync(url)
+ .setRange(start, end) // 设置本次下载的范围
+ .get().getBody()
+ .toFile("D:/download/test.zip") // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+ if (end < totalSize) { // 若未下载完，则继续下载下一块
+ download(totalSize, index + 1);
+ } else {
+ System.out.println("下载完成");
+ }
+ })
+ .start();
+}
+```
+
+## 文件上传
+
+ 一个简单文件上传的示例：
+
+```java
+http.sync("/upload")
+ .addFileParam("test", "D:/download/test.zip")
+ .post(); // 上传发法一般使用 POST 或 PUT，看服务器支持
+```
+ 异步上传也是完全一样：
+
+```java
+http.async("/upload")
+ .addFileParam("test", "D:/download/test.zip")
+ .post();
+```
+
+### 上传进度监听
+
+ OkHttps 的上传进度监听，监听的是所有请求报文体的发送进度，示例代码：
+
+```java
+http.sync("/upload")
+ .addBodyParam("name", "Jack")
+ .addBodyParam("age", 20)
+ .addFileParam("avatar", "D:/image/avatar.jpg")
+ .setStepBytes(1024) // 设置每发送 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .setStepRate(0.01) // 设置每发送 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 上传进度回调
+ long doneBytes = process.getDoneBytes(); // 已发送字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已发送的比例
+ boolean isDone = process.isDone(); // 是否发送完成
+ })
+ .post();
+```
+ 咦！怎么感觉和下载的进度回调的一样？没错！OkHttps 还是使用同一套API处理上传和下载的进度回调，区别只在于上传是在`get/post`方法之前使用这些API，下载是在`getBody`方法之后使用。很好理解：`get/post`之前是准备发送请求时段，有上传的含义，而`getBody`之后，已是报文响应的时段，当然是下载。
+
+### 上传过程控制
+
+ 上传文件的过程控制就很简单，和常规请求一样，只有异步发起的上传可以取消：
+
+```java
+HttpCall call = http.async("/upload")
+ .addFileParam("test", "D:/download/test.zip")
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .post();
+
+call.cancel(); // 取消上传
+```
+ 上传就没有暂停和继续这个功能啦，应该没人有这个需求吧?
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/README.md b/okhttps-doc/docs/v2/README.md
new file mode 100644
index 00000000..ddbc1d71
--- /dev/null
+++ b/okhttps-doc/docs/v2/README.md
@@ -0,0 +1,84 @@
+---
+description: OkHttps 安装 构建实例 HTTP build 同步请求 异步请求 sync async BaseUrl request webSocket gradle maven ejlchina
+---
+
+# 介绍
+
+## OkHttps 简介
+
+ OkHttps 是近期开源的对 OkHttp3 轻量封装的框架，它独创的异步预处理器，特色的标签，灵活的上传下载进度监听与过程控制功能，在轻松解决很多原本另人头疼问题的同时，设计上也力求纯粹与优雅。
+
+ * 链式调用，一点到底
+ * BaseURL、URL占位符、HTTP、WebSocket
+ * JSON、Xml 等自动封装与解析，且支持与任意格式的数据解析框架集成
+ * 同步拦截器、异步预处理器、回调执行器、全局监听、回调阻断
+ * 文件上传下载（过程控制、进度监听）
+ * 单方法回调，充分利用 Lambda 表达式
+ * TCP连接池、Http2
+
+::: tip
+* OkHttps 非常轻量（77Kb，Retrofit：124Kb），除 Okhttp 无第三方依赖，并且更加的开箱即用，API 也更加自然和语义化。
+* OkHttps 是一个纯粹的 Java 网络开发包，并不依赖 Android，这一点和 Retrofit 不同
+* OkHttps 用起来很优美，可以像 RxJava 那样链式用，却比 RxJava 更简单。
+:::
+
+### 项目组成
+
+项目 | 最新版本 | 描述
+-|-|-
+okhttps | 2.3.0 | OkHttps 核心模块
+[okhttps-fastjson](https://gitee.com/ejlchina-zhxu/okhttps/tree/master/okhttps-fastjson) | 2.3.0 | 与 fastjson 集成
+[okhttps-gson](https://gitee.com/ejlchina-zhxu/okhttps/tree/master/okhttps-gson) | 2.3.0 | 与 gson 集成
+[okhttps-jackson](https://gitee.com/ejlchina-zhxu/okhttps/tree/master/okhttps-jackson) | 2.3.0 | 与 jackson 集成
+[okhttps-stomp](https://gitee.com/ejlchina-zhxu/okhttps-stomp) | 1.0.1 | 超级轻量的 Stomp 客户端
+
+
+## v2.3 的新特性
+
+重新实现 WebSocket 心跳机制
+使用者可以选择使用 OkHttp 自带的新桃模式，也可以选择使用 OkHttps 提供的增强型新增机制，它具有如下特性
+
+1. 客户端发送的任何消息都具有一次客户端心跳作用
+2. 服务器发送的任何消息都具有一次服务器心跳作用
+3. 若服务器超过 3 * pongSeconds 秒没有回复心跳，才判断心跳超时
+
+## v2.2 的新特性
+
+1. 增强泛型反序列化，支持复合泛型
+2. HttpCall 接口新增 getTask 方法，可获取当前任务
+3. OkHttps 工具类 新增 newBuilder 方法，可用于复制 SPI 方式注入的配置信息
+4. HttpTask 类 新增 isAsyncHttp 和 isSyncHttp 方法（v2.1.0 新增了 isWebsocket 方法）可用于判断 HttpTask 的任务类型
+5. 优化在 Android 端的异步请求性能
+
+## v2.1 的新特性
+
+* 对异步请求的响应提供了 6 种便捷回调方法，在不关心具体状态时（与全局响应监听组合使用），使用非常方便；
+ - `setOnResBody` 在回调里直接取得`Body`对象，无需再使用`res.getBody()`
+ - `setOnResBean` 在回调里直接取得 Java Bean 对象，无需再使用`res.getBody().toBean(Class)`
+ - `setOnResList` 在回调里直接取得 Java List 列表，无需再使用`res.getBody().toList(Class)`
+ - `setOnResMapper` 在回调里直接取得 Mapper 对象，无需再使用`res.getBody().toMapper()`
+ - `setOnResArray` 在回调里直接取得 Array 对象，无需再使用`res.getBody().toArray()`
+ - `setOnResString` 在回调里直接取得 String 对象，无需再使用`res.getBody().toString()`
+
+* 优化性能：使用`HTTP#newBuilder()`方法克隆`HTTP`实例时，新实例与旧实例之间资源共享最大化。
+
+
+## v2.0 的新特性
+
+* HTTP 任务新增`patch()`和`head()`方法，可发起 PATCH 和 HEAD 请求，目前直接支持的 HTTP 方法有：GET、POST、PUT、PATCH、DELETE，并且暴露了`request(String method)`方法，可自定义发起任何请求，如：HEAD、OPTIONS、TRACE、CONNECT 等；
+
+* HTTP 任务新增`skipPreproc()`和`skipSerialPreproc()`方法，具体请求可跳过 所有 或只跳过 串行 预处理器；
+
+* 新增`MsgConvertor`接口，实现 OkHttps 与 fastjson 解耦，且不再依赖某个具体 json 框架、甚至不依赖 json，它可以与 **任何格式** 的数据解析框架集成，如：json 、xml 、protobuf 等;
+
+* 构建`HTTP`实例时支持注入多个`MsgConvertor`，可实现同一个`HTTP`实例下，既有 json 解析，又有 xml 解析等强大特性，同时还可以让表单（form）请求参数 同 json、xml 一样，支持序列化功能。
+
+* `HTTP`接口新增`webSocket(String url)`方法，与`sync(String url)`和`async(String url)`一样，支持 Lamda 编程、预处理器机制、消息数据自动序列化和反序列化机制；
+
+* 新增`OkHttps`工具类，支持 SPI 方式注入配置，`OkHttps`和`HttpUtils`默认自动以 SPI 方式寻找依赖中的`MsgConvertor`；
+
+* 新增可自定义默认编码（不自定义依然默认为 utf-8）、具体请求可指定特殊编码功能。
+
+
+
+
diff --git a/okhttps-doc/docs/v2/android.md b/okhttps-doc/docs/v2/android.md
new file mode 100644
index 00000000..41bb8d88
--- /dev/null
+++ b/okhttps-doc/docs/v2/android.md
@@ -0,0 +1,720 @@
+---
+description: OkHttps 安卓 生命周期 UI线程 主线程 IO线程 自由 灵活 切换 生命周期绑定 配置预处理器 定义生命周期监视器 配置全局回调监听
+---
+
+# 安卓
+
+## 回调线程切换
+
+ 在 Android 开发中，经常会把某些代码放到特点的线程去执行，比如网络请求响应后的页面更新在主线程（UI线程）执行，而保存文件则在IO线程操作。OkHttps 为这类问题提供了良好的方案。
+
+ 在 **默认** 情况下，**所有回调** 函数都会 **在 IO 线程** 执行。为什么会设计如此呢？这是因为 OkHttps 只是纯粹的 Java 领域 Http工具包，本身对 Android 不会有任何依赖，因此也不知 Android 的 UI 线程为何物。这么设计也让它在 Android 之外有更多的可能性。
+
+### 配置
+
+ 但是在 Android 里使用 OkHttps 的话，UI线程的问题能否优雅的解决呢？当然可以！简单粗暴的方法就是配置一个 回调执行器：
+
+```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ // 实际编码中可以吧 Handler 提出来，不需要每次执行回调都重新创建
+ new Handler(Looper.getMainLooper()).post(run); // 在主线程执行
+ })
+ .build();
+```
+
+::: warning 注意
+在 Android 7+（SDK 24 以上）中使用 v2.0.0 及以前版本，当在主线程里消费报文体时（调用`Body#toXxx()`方法），会引发`android.os.NetworkOnMainThreadException`异常。可以通过添加一个拦截器来解决：
+
+```java
+HTTP http = HTTP.builder()
+ .config( builder -> builder.addInterceptor(chain -> {
+ Response res = chain.proceed(chain.request());
+ ResponseBody body = res.body();
+ ResponseBody newBody = null;
+ if (body != null) {
+ newBody = ResponseBody.create(body.contentType(), body.bytes());
+ }
+ return res.newBuilder().body(newBody).build();
+ }))
+ // 省略其它...
+ .build();
+```
+:::
+
+### 用例
+
+ 上述代码便实现了让 **所有** 的 **回调函数** 都在 **主线程（UI线程）** 执行的目的，如：
+
+```java
+http.async("/users")
+ .addBodyPara("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .setOnResponse((HttpResult result) -> {
+ // 在主线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行
+ })
+ .setOnComplete((State state) -> {
+ // 在主线程执行
+ })
+ .post();
+```
+ 但是，如果同时还想让某些回调放在IO线程，实现 **自由切换**，怎么办呢？OkHttps 给出了非常灵活的方法，如下：
+
+```java
+http.async("/users")
+ .addBodyPara("name", "Jack")
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnResponse((HttpResult result) -> {
+ // 在 IO 线程执行
+ })
+ .setOnException((Exception e) -> {
+ // 在主线程执行（没有指明 nextOnIO 则在回调执行器里执行）
+ })
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnComplete((State state) -> {
+ // 在 IO 线程执行
+ })
+ .post();
+```
+ 无论是哪一个回调，都可以使用`nextOnIO()`方法自由切换。同样，对于文件下载也是一样：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ // 在主线程执行
+ })
+ .toFolder("D:/download/")
+ .nextOnIO() // 指定下一个回调在 IO 线程执行
+ .setOnSuccess((File file) -> {
+ // 在 IO 线程执行
+ })
+ .setOnFailure((Failure failure) -> {
+ // 在主线程执行
+ })
+ .start();
+```
+
+## 生命周期绑定
+
+ 由于 OkHttps 并不依赖于 Android，所以它并没有提供关于生命周期绑定的直接实现，但它的一些扩展机制让我们很容易就可以实现这个需求。在开始之前，我们首先要理解何为生命周期绑定：
+
+::: tip HTTP 请求的生命周期绑定
+所谓的生命周期绑定：即是让 HTTP 任务感知其所属的 Activity 或 Fragment 的生命周期，当 Activity 或 Fragment 将被销毁时，框架应自动的把由它们发起的但尚未完成的 HTTP 任务全部取消，以免导致程序出错！
+:::
+
+ 现在我们需要对`HTTP`实例进行配置，配置后的`HTTP`实例具有生命周期绑定的功能，在`Activity`或`Fragment`里，它的使用效果如下：
+
+```java
+// 在 Activity 或 Fragment 内发起请求
+http.async("http://www.baidu.com")
+ .bind(getLifecycle()) // 绑定生命周期
+ .setOnResponse((HttpResult result) -> {
+ Log.i("FirstFragment", "收到请求：" + result.toString());
+ })
+ .get();
+```
+ 上述代码中的`getLifecycle()`是`Activity`或`Fragment`自带的方法，而`bind()`是`HttpTask`的现有方法。在配置好`HTTP`实例后，上述代码发起的请求便可以感知`Activity`或`Fragment`的生命周期。
+
+ 那`HTTP`实例到底该如何配置呢？
+
+### 第一步：配置预处理器
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .addPreprocessor((Preprocessor.PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了 Lifecycle 对象
+ if (bound instanceof Lifecycle) {
+ // 重新绑定一个 生命周期监视器（LCObserver）对象，它的定义见下一步
+ task.bind(new LCObserver(task, (Lifecycle) bound));
+ }
+ chain.proceed();
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+### 第二步：定义生命周期监视器
+
+```java
+public class LCObserver implements LifecycleObserver {
+
+ HttpTask task;
+ Lifecycle lifecycle;
+
+ LCObserver(HttpTask task, Lifecycle lifecycle) {
+ this.task = task;
+ this.lifecycle = lifecycle;
+ lifecycle.addObserver(this);
+ }
+
+ @OnLifecycleEvent(Lifecycle.Event.ON_STOP)
+ public void onStop() {
+ task.cancel(); // 在 ON_STOP 事件中，取消对应的 HTTP 任务
+ }
+
+ public void unbind() {
+ // 在请求完成之后移除监视器
+ lifecycle.removeObserver(this);
+ }
+
+}
+```
+
+### 第三步：配置全局回调监听
+
+ 以上两步其实已经实现了生命周期绑定的功能，但是在请求完成之后，我们需要在`lifecycle`中移除`LCObserver`对象：
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .completeListener((HttpTask task, HttpResult.State state) -> {
+ Object bound = task.getBound();
+ // 判断 task 是否绑定了生命周期监视器（LCObserver）对象
+ if (bound instanceof LCObserver) {
+ // 解绑监视器
+ ((LCObserver) bound).unbind();
+ }
+ return true;
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+### 总结
+
+上述实现生命周期绑定的过程，关键在于对`HttpTask`的`bind(Object object)`方法传入一个`LifeCycle`对象，然后在预处理器和全局监听里做了相关处理。实际上，我们还可以在调用`bind`方法时传入一个`Activity`或`Fragment`对象，这样在预处理器和全局监听里，就不仅可以得到`LifeCycle`，还可以得到`Context`对象，可参考下文的 [安卓-最佳实践](/v2/android.html#最佳实践)。
+
+::: tip 提示
+以上三步实现的生命周期绑定，不仅对 HTTP 请求有作用，对 WebSocket 连接也同样有效哦。
+:::
+
+
+## 自动加载框
+
+在调用一个耗时较长的接口时，我们往往需要显示一个加载框，以便让用户知道我们的 APP 正在工作而不是卡死。
+
+一般的做法，是这样实现：
+
+```java
+showLoading(); // 在请求开始之前显示加载框
+
+http.async('/api/...')
+ ...
+ .setOnComplete(state -> {
+ // 在请求结束（成功|失败|异常）之后关闭加载框
+ hideLoading();
+ })
+ .post();
+```
+
+这样当然可以解决问题，但是一个应用开发下来至少涉及到有三四十个接口请求，多的甚至到成百上千个，如果每个加载框的逻辑都这么写，会造成很多冗余代码，很不优雅。
+
+那可不可以，在请求接口时，我们只给一个标签，如果有这个标签，请求时就自动显示加载框，结束后就自动关闭加载框呢？像这样：
+
+```java
+http.async('/api/...')
+ .tag("LOADING") // 自动显示和关闭加载框
+ ...
+ .post();
+```
+
+当然可以！OkHttps 扩展机制的强大，一不小心又体现了。来，我们直接看实现代码！
+
+### 第一步：配置预处理器
+
+预处理器是在网络请求开始之前执行，我们可以再这里显示加载框：
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .addPreprocessor(chain -> {
+ HttpTask task = chain.getTask();
+ // 根据标签判断是否显示加载框
+ if (task.isTagged("LOADING")) {
+ showLoading(context(task)); // 显示加载框
+ }
+ chain.proceed();
+ })
+ ... // 省略其它配置项
+ .build();
+```
+
+其中第9行使用了一个`context(HttpTask task)`方法，它的作用是从`HttpTask`的绑定对象中取得一个`Context`对象，用于创建加载框。
+
+### 第二步：配置全局监听
+
+```java
+HTTP http = HTTP.builder()
+ ... // 省略其它配置项
+ .completeListener((HttpTask task, HttpResult.State state) -> {
+ if (task.isTagged("LOADING")) {
+ hideLoading(); // 关闭加载框
+ }
+ return true;
+ });
+ ... // 省略其它配置项
+ .build();
+```
+
+### 总结
+
+以上两步变实现了网络请求时的自动显示与关闭加载框的功能，是不是很简单呢，全部代码可参考下文的 [安卓-最佳实践](/v2/android.html#最佳实践)。
+
+## 最佳实践
+
+本章节，将以源码的方式为你呈现使用 OkHttps 的正确姿势，包括：
+
+* 默认回调线程
+* 生命周期绑定
+* 加载框自动显示关闭
+* TOKEN 自动添加与刷新
+* 错误码统一处理与回调阻断
+
+### 标签常量
+
+由于或多或少需要用到一些标签，我们最好把它定义成常量：
+
+```java
+public class Tags {
+
+ /**
+ * 用于标记某接口需要 Token 头信息
+ * 如果没有办法得到合法的 Token，则跳转登录
+ */
+ public static final String TOKEN = "TOKEN";
+
+ /**
+ * 用于标记某接口是否开启自动加载框功能
+ */
+ public static final String LOADING = "LOADING";
+
+ // 若有其它的想法，还可以定义其它的标签
+ // ...
+}
+```
+
+### 接口路径常量
+
+由于同一个接口可能会在多处使用，所以我们可以把它们定义为常量（这一步可选）：
+
+```java
+public class Urls {
+
+ /**
+ * BaseUrl 还可以根据 build.gradle 的配置来取
+ * 打出不同环境的包，自动使用不同的 BaseUrl，这里便不再示例
+ */
+ public static final String BASE_URL = "https://api.example.com";
+
+ /**
+ * 当 Token 快过期时，调用该接口来刷新 Token
+ */
+ public static final String TOKEN_REFRESH = "/oauth/access-token";
+
+ // 其它接口 ...
+}
+```
+
+### 配置 OkHttps
+
+由于我们推荐在主应用中直接使用`OkHttps`类，所以我们在`OkHttpsConfig`中配置，可参考 [起步-配置 OkHttps](/v2/getstart.html#配置okhttps) 章节。
+
+#### 主干配置
+
+```java
+public class OkHttpsConfig implements Config {
+
+ // 绑定到主线程的 Handler
+ private Handler mainHandler = new Handler(Looper.getMainLooper());
+
+ @Override
+ public void with(HTTP.Builder builder) {
+
+ builder.baseUrl(Urls.BASE_URL) // 配置 BaseURL
+
+ // 如果默认请求体是JSON，则开启，否则默认为表单
+ //.bodyType("json")
+
+ // 配置默认回调在主线程执行
+ .callbackExecutor(run -> mainHandler.post(run))
+
+ // 加载框预处理（在 TOKEN 处理之前）
+ .addPreprocessor(chain -> {
+ HttpTask task = chain.getTask();
+ // 根据标签判断是否显示加载框
+ if (task.isTagged(Tags.LOADING)) {
+ showLoading(context(task));
+ }
+ chain.proceed();
+ })
+
+ // 实现生命周期绑定
+ .addPreprocessor(chain -> {
+ HttpTask task = chain.getTask();
+ Object bound = task.getBound();
+ task.bind(new BoundWrapper(task, bound));
+ chain.proceed();
+ })
+
+ // TOKEN 处理（串行预处理）
+ .addSerialPreprocessor(chain -> {
+ HttpTask task = chain.getTask();
+ // 根据标签判断是否需要 Token
+ if (!task.isTagged(Tags.TOKEN)) {
+ chain.proceed();
+ return;
+ }
+ Context ctx = context(task);
+ requestTokenAndRefreshIfExpired(ctx, chain.getHttp(),
+ (String token) -> {
+ if (token != null) {
+ // 添加 Token 头信息，名字需要和后端商定
+ task.addHeader("Access-Token", token);
+ } else if (ctx != null) {
+ // 若没有得到 Token, 则跳转登录页面
+ ctx.startActivity(new Intent(ctx, LoginActivity.class));
+ } else {
+ Log.e("OkHttps", "没有 Context 无法跳转登录页面！");
+ }
+ // 无论如何，这行代码一定要执行到，不然后续接口会一直在排队中
+ chain.proceed();
+ });
+ })
+
+ // 错误码统一处理
+ .responseListener((HttpTask task, HttpResult result) -> {
+ // 刷新 Token 的接口可以例外
+ if (task.getUrl().contains(Urls.TOKEN_REFRESH)
+ || result.isSuccessful()) {
+ // 这里演示的是 HTTP 状态码的处理，如果有自定义的 code, 也可以进行深层次的判断
+ return true; // 继续接口的业务处理
+ }
+ // 向用户展示接口的错误信息
+ showMsgToUser(task, result.getBody().toString());
+ return false; // 阻断
+ })
+
+ // 生命周期绑定：第三步
+ .completeListener((HttpTask task, HttpResult.State state) -> {
+ Object bound = task.getBound();
+ if (bound instanceof BoundWrapper) {
+ ((BoundWrapper) bound).unbind();
+ }
+ // 网络错误统一处理
+ switch (state) {
+ case TIMEOUT:
+ showMsgToUser(task, "网络连接超时");
+ break;
+ case NETWORK_ERROR:
+ showMsgToUser(task, "网络错误，请检查WIFI或数据是否开启");
+ break;
+ case EXCEPTION:
+ showMsgToUser(task, "接口请求异常: " + task.getUrl());
+ break;
+ }
+ if (task.isTagged(Tags.LOADING)) {
+ hideLoading(); // 关闭加载框
+ }
+ return true;
+ });
+ }
+
+ // 其它 ...
+}
+```
+
+上述是一个主干配置，其中涉及到`showLoading`方法、`hideLoading`方法、`BoundWrapper`类、`context`方法、`showMsgToUser`方法 和 `requestTokenAndRefreshIfExpired`方法，下面依次给出它们的实现：
+
+#### `showLoading`和`hideLoading`方法
+
+``` java
+public class OkHttpsConfig implements Config {
+
+ // 省略其它...
+
+ private ProgressDialog loading = null;
+ private AtomicInteger loadings = new AtomicInteger(0);
+
+ // 显示加载框
+ private void showLoading(Context ctx) {
+ if (loading == null) {
+ // 这里就用 ProgressDialog 来演示了，当然可以替换成你喜爱的加载框
+ loading = new ProgressDialog(ctx);
+ loading.setMessage("正在加载，请稍等...");
+ }
+ // 增加加载框显示计数
+ loadings.incrementAndGet();
+ loading.show();
+ }
+
+ // 关闭加载框
+ private void hideLoading() {
+ // 判断是否所有显示加载框的接口都已完成
+ if (loadings.decrementAndGet() <= 0
+ && loading != null) {
+ loading.dismiss();
+ loading = null;
+ }
+ }
+
+ // 其它 ...
+}
+```
+
+#### `BoundWrapper`类
+
+它可以单独做为一个类，也可以写成内部类：
+
+```java
+public class OkHttpsConfig implements Config {
+
+ // 省略其它...
+
+ static class BoundWrapper implements LifecycleObserver {
+
+ HttpTask task;
+ Lifecycle lifecycle;
+ Object bound;
+
+ BoundWrapper(HttpTask task, Object bound) {
+ this.task = task;
+ if (bound instanceof LifecycleOwner) {
+ lifecycle = ((LifecycleOwner) bound).getLifecycle();
+ lifecycle.addObserver(this);
+ }
+ this.bound = bound;
+ }
+
+ @OnLifecycleEvent(Lifecycle.Event.ON_STOP)
+ public void onStop() {
+ task.cancel(); // 在 ON_STOP 事件中，取消对应的 HTTP 任务
+ }
+
+ void unbind() {
+ if (lifecycle != null) {
+ lifecycle.removeObserver(this);
+ }
+ }
+
+ }
+
+ // 其它 ...
+}
+```
+
+#### `context`方法
+
+```java
+public class OkHttpsConfig implements Config {
+
+ // 省略其它...
+
+ /**
+ * 获取 Context 对象
+ **/
+ private Context context(HttpTask task) {
+ Object bound = task.getBound();
+ if (bound instanceof BoundWrapper) {
+ bound = ((BoundWrapper) bound).bound;
+ }
+ if (bound instanceof Context) {
+ return (Context) bound;
+ }
+ if (bound instanceof Fragment) {
+ return ((Fragment) bound).getActivity();
+ }
+ // 还可以添加更多获取 Context 的策略，比如从全局 Application 里取
+ return null;
+ }
+
+ // 其它 ...
+}
+```
+
+#### `showMsgToUser`方法
+
+```java
+public class OkHttpsConfig implements Config {
+
+ // 省略其它...
+
+ /**
+ * 向用户展示信息
+ **/
+ private void showMsgToUser(HttpTask task, String message) {
+ Context ctx = context(task);
+ if (ctx != null) {
+ // 这里就简单用 Toast 示例一下，有更高级的实现可以替换
+ Toast.makeText(ctx, message, Toast.LENGTH_LONG).show();
+ }
+ }
+
+ // 其它 ...
+}
+```
+
+#### `requestTokenAndRefreshIfExpired`方法
+
+```java
+public class OkHttpsConfig implements Config {
+
+ // 省略其它...
+
+ /**
+ * 获取TOKEN，若过期则刷新（代码中的字符串可以替换为常量）
+ **/
+ private void requestTokenAndRefreshIfExpired(Context ctx, HTTP http,
+ OnCallback callback) {
+ if (ctx == null) {
+ callback.on(null);
+ return;
+ }
+ // 这里演示使用 Preference 存储，也可以使用数据库存储
+ SharedPreferences token = ctx.getSharedPreferences("token",
+ Context.MODE_PRIVATE);
+ long now = System.currentTimeMillis();
+ // 刷新令牌
+ String refreshToken = token.getString("refreshToken", null);
+ // 判断有效期可以提前 60 秒，以防在接下来的网络延迟中过期了
+ if (token.getLong("refreshTokenExpiresAt", 0) < now + 60000
+ || refreshToken == null) {
+ // 刷新令牌已过期，说明长时间未使用，需要重新登录
+ callback.on(null);
+ return;
+ }
+ // 访问令牌
+ String accessToken = token.getString("accessToken", null);
+ if (token.getLong("accessTokenExpiresAt", 0) > now + 60000
+ && accessToken != null) {
+ // 访问令牌未过期，则回调令牌
+ callback.on(accessToken);
+ return;
+ }
+ // 访问令牌已过期，刷新令牌未过期，则调接口刷新当前令牌
+ http.async(Urls.TOKEN_REFRESH)
+ .skipPreproc() // 跳过所有预处理器
+ .addBodyPara("refreshToken", refreshToken)
+ .setOnResponse(res -> {
+ if (!res.isSuccessful()) {
+ callback.on(null);
+ return;
+ }
+ Mapper mapper = res.getBody().toMapper();
+ String newRefreshToken = mapper.getString("refreshToken");
+ String newAccessToken = mapper.getString("accessToken");
+ int refreshTokenExpiresIn = mapper.getInt("refreshTokenExpiresIn");
+ int accessTokenExpiresIn = mapper.getInt("accessTokenExpiresIn");
+ // 因为发生了请求，当前时间已经变化，所有重新获取时间
+ long now2 = System.currentTimeMillis();
+ // 保存到 SharedPreferences
+ token.edit()
+ .putString("refreshToken", newRefreshToken)
+ .putString("accessToken", newAccessToken)
+ .putLong("refreshTokenExpiresAt", refreshTokenExpiresIn * 1000 + now2)
+ .putLong("accessTokenExpiresAt", accessTokenExpiresIn * 1000 + now2)
+ .commit();
+ // 回调令牌
+ callback.on(newAccessToken);
+ })
+ .setOnException(e -> callback.on(null))
+ .post();
+ }
+
+}
+```
+
+### 使用效果
+
+#### 在 Activity 或 Fragment 中使用
+
+```java
+OkHttps.async(Urls.SOME_URL)
+ .bind(this) // 绑定（生命周期|Context获取）
+ .tag(Tags.TOKEN) // 自动添加 TOEKN
+ .tag(Tags.LOADING) // 自动显示加载框
+ // 请求参数设置...
+ .setOnResponse(res -> {
+ // TODO: 正确响应处理
+ })
+ .post();
+```
+
+::: tip
+上述中的`this`得指向 Activity 或 Fragment 本身，如果是在按钮的点击事件中请求，需要指明为`YourActivity.this`或者`YourFragment.this`
+:::
+
+#### 在其它能获得 Context 对象的环境里使用
+
+```java
+OkHttps.async(Urls.SOME_URL)
+ .bind(context) // 绑定（生命周期|Context获取）
+ .tag(Tags.TOKEN) // 自动添加 TOEKN
+ .tag(Tags.LOADING) // 自动显示加载框
+ // 请求参数设置...
+ .setOnResponse(res -> {
+ // TODO: 正确响应处理
+ })
+ .post();
+```
+
+### 类 Retrofit 方式
+
+如果你是 Retrofit 用户，喜欢像 Retrofit 那样把网络接口分类归到不同的Java文件中，完全没有问题，比如你可以这样：
+
+#### 定义 UserService
+
+```java
+public class UserService {
+
+ private Context context;
+
+ public UserService(Context context) {
+ this.context = context;
+ }
+
+ /**
+ * 获取我的信息
+ **/
+ public AsyncHttpTask updatePasswrod(String passwrod) {
+ return OkHttps.async("/mine/passwrod")
+ .bind(context)
+ .tag(Tags.TOKEN) // 自动添加 TOEKN
+ .tag(Tags.LOADING) // 自动显示加载框
+ .addBodyPara("passwrod", passwrod);
+ }
+
+ // 其它接口...
+}
+```
+
+#### 使用 UserService
+
+```java
+UserService userService = new UserService(this)
+
+String newPassword = "123456";
+
+userService.updatePasswrod(newPassword)
+ .setOnResponse(res -> {
+ // 密码更新成功
+ })
+ .put();
+
+```
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/configuration.md b/okhttps-doc/docs/v2/configuration.md
new file mode 100644
index 00000000..70320e33
--- /dev/null
+++ b/okhttps-doc/docs/v2/configuration.md
@@ -0,0 +1,414 @@
+---
+description: OkHttps 配置 BaseUrl 回调执行器 主线程 UI线程 OkHttpClient 预处理器 TOKEN问题最佳解决方案 刷新TOKEN 全局 回调监听 下载监听 回调阻断 拦截器 CookieJar、SSL、缓存、代理、事件监听
+---
+
+# 配置
+
+## 设置 BaseUrl
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.demo.com") // 设置 BaseUrl
+ .build();
+```
+ 该配置全局生效，在配置了`BaseUrl`之后，具体的请求便可以省略`BaseUrl`部分，使得代码更加简洁，例如：
+
+```java
+http.sync("/users").get() // http://api.demo.com/users
+
+http.sync("/auth/signin") // http://api.demo.com/auth/signin
+ .addBodyPara("username", "Jackson")
+ .addBodyPara("password", "xxxxxx")
+ .post(); // POST请求
+```
+ 在配置了`BaseUrl`之后，如有特殊请求任务，仍然可以使用全路径的方式，一点都不妨碍：
+
+```java
+http.sync("https://www.baidu.com").get();
+```
+
+::: tip 支持动态 BaseUrl 吗？
+有些同学可能在网上看到某些网络封装框架声明支持 **动态 BaseUrl** 或者说 **动态域名**，那 OkHttps 支持吗？
+
+答：OkHttps 是 **不会** 提供在同一个`HTTP`实例上可以动态设置`BaseUrl`的功能的。
+
+为什么呢？
+
+答：因为这完全是一种缺陷设计，我们都知道在 Java 中多线程开发很常见，如果 A 线程正兴高采烈的准备向某个地址发起请求时，而 B 线程突然修改了`BaseUrl`，那 A 线程不就悲剧了么。所以类似 Retrofit 这些设计成熟的框架都不会提供这种功能的。
+
+那我的应用中确实要用到多个域名，该怎么办呢？
+
+答：可以构建多个`HTTP`实例，不同的实例负责不同的域名，如果每个域名的请求都比较少，就是域名多，那便只用一个`HTTP`实例，请求较少的域名使用全路径访问即可。
+:::
+
+## 回调执行器
+
+ OkHttps 默认所有回调都在 **IO线程** 执行，如何想改变执行回调的线程时，可以配置回调执行器。例如在Android里，让所有的回调函数都在 UI 线程执行，则可以在构建`HTTP`时配置如下：
+
+```java
+HTTP http = HTTP.builder()
+ .callbackExecutor((Runnable run) -> {
+ runOnUiThread(run); // 在UI线程执行
+ })
+ .build();
+```
+ 该配置默认 [**影响所有回调**](/v2/foundation.html#回调函数)，另 [**全局监听**](/v2/configuration.html#全局监听) 不受此影响，更多实现细节可参考 [安卓-回调线程切换](/v2/android.html#回调线程切换) 章节。
+
+::: warning 注意
+在 Android 7+（SDK 24 以上）中使用 v2.0.0 及以前版本，当在主线程里消费报文体时（调用`Body#toXxx()`方法），会引发`android.os.NetworkOnMainThreadException`异常。可以通过添加一个拦截器来解决：
+
+```java
+HTTP http = HTTP.builder()
+ .config( builder -> builder.addInterceptor(chain -> {
+ Response res = chain.proceed(chain.request());
+ ResponseBody body = res.body();
+ ResponseBody newBody = null;
+ if (body != null) {
+ newBody = ResponseBody.create(body.contentType(), body.bytes());
+ }
+ return res.newBuilder().body(newBody).build();
+ }))
+ // 省略其它...
+ .build();
+```
+:::
+
+## 预处理器
+
+ 预处理器（`Preprocessor`）可以让我们在请求发出之前对请求本身做一些改变，但与`OkHttp`的拦截器（`Interceptor`）不同：预处理器可以让我们 **异步** 处理这些问题。
+
+### 并行预处理器
+
+ 例如，当我们想为请求任务自动添加`Token`头信息，而`Token`只能通过异步方法`requestToken`获取时，这时使用`Interceptor`就很难处理了，但可以使用预处理器轻松解决：
+
+```java
+HTTP http = HTTP.builder()
+ .addPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();// 获得当前的HTTP任务
+ if (!task.isTagged("Auth")) { // 根据标签判断该任务是否需要Token
+ chain.proceed();
+ return;
+ }
+ requestToken((String token) -> { // 异步获取 Token
+ task.addHeader("Token", token);// 为任务添加头信息
+ chain.proceed(); // 继续当前的任务
+ });
+ })
+ .build();
+```
+
+和`Interceptor`一样，`Preprocessor`也可以添加多个。他们之间的区别如下:
+
+::: tip 拦截器与预处理器的区别
+* 拦截器只能处理同步操作，预处理器支持处理异步操作
+* 拦截器都是并行处理请求，预处理器支持串行处理（详见6.5章节）
+* 拦截器处理时机在请求前和响应后，预处理器只在请求前，并且先于拦截器执行。关于响应后，OkHttps还提供了全局回调监听（详见6.6章节）
+:::
+
+并行预处理器还可以实现更多功能，比如 [安卓-生命周期绑定](/v2/android.html#生命周期绑定)、[安卓-自动加载框](/v2/android.html#自动加载框) 等。
+
+### 串行预处理器（TOKEN问题最佳解决方案）
+
+ 普通预处理器都是可并行处理的，然而有时我们希望某个预处理器同时只处理一个任务。比如 当`Token`过期时我们需要去刷新获取新`Token`，而刷新`Token`这个操作只能有一个任务去执行，因为如果`n`个任务同时执行的话，那么必有`n-1`个任务刚刷新得到的`Token`可能就立马失效了，而这是我们所不希望的。
+
+ 为了解决这个问题，OkHttps 提供了串行预处理器，它可以让 HTTP 任务排好队，一个一个地进入预处理器：
+
+```java
+HTTP http = HTTP.builder()
+ .addSerialPreprocessor((PreChain chain) -> {
+ HttpTask task = chain.getTask();
+ if (!task.isTagged("Auth")) {
+ chain.proceed();
+ return;
+ }
+ // 检查过期，若需要则刷新Token
+ requestTokenAndRefreshIfExpired((String token) -> {
+ task.addHeader("Token", token);
+ chain.proceed(); // 调用此方法前，不会有其它任务进入该处理器
+ });
+ })
+ .build();
+```
+
+串行预处理器实现了让HTTP任务排队串行处理的功能，但值得一提的是：它并没有因此而阻塞任何线程！
+
+::: warning 注意
+由于 串行预处理器 只能一个一个的处理任务，所以在上述中的`requestTokenAndRefreshIfExpired`方法里，若发起网络请求，一定要跳过串行预处理器 [可使用`skipSerialPreproc()`方法]，例如：
+
+```java
+http.async("/oauth/refresh-token")
+ .skipSerialPreproc() // 跳过串行预处理器
+ .addBodyPara("refreshToken", "xxxxxx")
+ .setOnResponse((HttpResult result) -> {
+
+ })
+ .post();
+```
+否则就会发生两个 HTTP 任务相互等待谁也执行不了的问题。
+
+如果你使用的是 v1.x 的版本，则可以使用`HTTP`实例的`request(Request request)`方法发起原生请求，这样也不经过任何预处理器。
+:::
+
+关于 TOKEN 的更多处理细节，请参考 [安卓-最佳实践](/v2/android.html#最佳实践) 章节。
+
+## 消息转换器
+
+OkHttps 自 2.0 版本器支持自定义消息转换器，并且可以添加多个，例如：
+
+```java
+HTTP http = HTTP.builder()
+ .addMsgConvertor(new MyJsonMsgConvertor());
+ .addMsgConvertor(new MyXmlMsgConvertor());
+ .build();
+```
+
+配置了消息转换器后，`HTTP`实例便具有了序列化和反序列化这些格式数据的能力。
+
+### 反序列化
+
+例如下例中，无论该接口响应的是 JSON 还是 XML，都可以反序列化成功：
+
+```java
+// 无论该接口响应的是 JSON 还是 XML，都可以反序列化成功
+List orders = http.sync('/orders')
+ .get().getBody().toList(Order.class);
+```
+
+在 Websocket 通讯中，也是如此：
+
+```java
+http.webSocket("/redpacket/status") // 监听红包的领取状态
+ .setOnMessage((WebSocket ws，Message msg) -> {
+ // 无论该接口响应的是 JSON 还是 XML，都可以反序列化成功
+ Status status = msg.toBean(Status.class);
+ })
+ .listen();
+```
+
+### 正序列化
+
+另外，如果要在请求发出阶段正向序列化参数，则需要指定`bodyType`参数告诉 OkHttps 你想使用哪一个消息转换器，如：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("json")
+ .setBodyPara(order) // 以 JSON 格式序列化 Order 对象
+ .post();
+```
+
+或者 XML：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("xml")
+ .setBodyPara(order) // 以 XML 格式序列化 Order 对象
+ .post();
+```
+
+在 Websocket 里，也是同样的方法：
+
+```java
+http.webSocket("/chat")
+ .bodyType("json")
+ .setOnOpen((WebSocket ws，HttpResult res) -> {
+ Hello hello = getHello();
+ ws.send(hello); // 以 JSON 格式序列化 Hello 对象
+ })
+ .listen();
+```
+
+但如果你在 Websocket 通讯到某一个阶段后，突然想换另外一种格式来发送数据了，你还可以这样：
+
+```java
+http.webSocket("/chat")
+ .bodyType("json")
+ .setOnOpen((WebSocket ws，HttpResult res) -> {
+ Hello hello = getHello();
+ ws.send(hello); // 以 JSON 格式序列化 Hello 对象
+
+ ws.msgType("xml") // 切换为 XML 格式
+ ws.send(hello); // 以 XML 格式序列化 Hello 对象
+ })
+ .listen();
+```
+
+### 默认序列化类型
+
+然而大多数情况下，我们都使用一种消息转换器，比如 json，这时候你可以为`bodyType`配置一个默认值：
+
+```java
+HTTP http = HTTP.builder()
+ // 修改 bodyType 的默认值为 json，若不修改，则默认是 form
+ .bodyType("json");
+ .addMsgConvertor(new MyJsonMsgConvertor());
+ .build();
+```
+::: tip 提示
+只有请求报文体的正向序列化才会收到`bodyType`的影响，对于响应报文体的反向序列化不受其影响。
+:::
+
+### 表单序列化
+
+OkHttps 不但能做 JSON 或 XML 的序列化，并且还能做表单参数的序列化，并且自带了一个`FormConvertor`，它可以给任意`MsgConvertor`赋予表单序列化的能力，例如你已经实现了一个`MyJsonMsgConvertor`，可以这么做：
+
+```java
+// 这里并不要求是一个 JSON 转换器，XML 也可以
+// 有啥就给啥，效果是一样的
+MsgConvertor convertor = new MyJsonMsgConvertor();
+
+HTTP http = HTTP.builder()
+ .addMsgConvertor(new MsgConvertor.FormConvertor(convertor));
+ .build();
+```
+
+这样，你再做表单请求时，就可以直接扔进一个对象，它将自动完成序列化的事情：
+
+```java
+Order order = newOrder();
+http.async('/orders') // 提交订单
+ .bodyType("form")
+ .setBodyPara(order) // 以 表单 格式序列化 Order 对象
+ .post();
+```
+
+一般情况下，如果你有实现了一个`MsgConvertor`，我们推荐把它和`FormConvertor`都添加进去，例如：
+
+```java
+MsgConvertor convertor = new MyJsonMsgConvertor();
+
+HTTP http = HTTP.builder()
+ .addMsgConvertor(convertor);
+ .addMsgConvertor(new MsgConvertor.FormConvertor(convertor));
+ .build();
+```
+
+如果你添加了官方提供的`MsgConvertor`依赖包（例如：`okhttps-jackson`等），在构建实例时，还可以这样直接注入：
+
+```java
+HTTP.Builder builder = HTTP.builder()
+// 自动完成依赖中的 MsgConvertor 和 FormConvertor 的注入
+ConvertProvider.inject(builder);
+HTTP http = builder.build();
+```
+
+::: tip
+如果你使用的是[`OkHttps`或`HttpUtils`工具类](/v2/getstart.html#工具类)，它们都会自动配置`MsgConvertor`和`FormConvertor`，无需手动配置
+
+在 v2.0.0.RC 版本中`FormConvertor`的名字是`MsgConvertor.FormMsgConvertor`
+:::
+
+## 全局监听
+
+### 全局回调监听
+
+ 全局回调是实际开发中经常需要的功能，比如对服务器响应的状态码进行统一处理等，同时 OkHttps 的全局回调还具有 **回调阻断** 的功能：
+
+```java
+HTTP http = HTTP.builder()
+ .responseListener((HttpTask task, HttpResult result) -> {
+ // 所有请求响应后都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnResponse 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .completeListener((HttpTask task, State state) -> {
+ // 所有请求执行完都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnComplete 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求发生异常都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnException 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .build();
+```
+
+**回调阻断** 其实是日常开发中比较常见的需求，比如：
+
+只有当接口响应的状态码在 [200, 300) 之间时，应用才做具体的业务处理，其它则一律向用户提示接口返回的错误信息，则可以这么做：
+
+```java
+HTTP http = HTTP.builder()
+ .responseListener((HttpTask task, HttpResult result) -> {
+ if (result.isSuccessful()) {
+ return true; // 继续接口的业务处理
+ }
+ showApiMsgToUser(result); // 向用户展示接口的错误信息
+ return false; // 阻断
+ })
+ .build();
+```
+
+然后具体的请求，就可以专注于业务处理，而不需担心接口的状态出错，比如：
+
+```java
+Order order = newOrder(); // 订单信息
+
+http.async('/orders') // 提交订单
+ .setBodyPara(order)
+ .setOnResponse((HttpResult result) -> {
+ // 进入该回调，则表示订单已提交成功，就可以放心的做接下来的业务处理
+ // 比如去发起支付：
+ startPay(result.getBody().toBean(PayInfo.class));
+ })
+ .post();
+```
+
+::: tip 全局回调监听与拦截器的异同：
+* 拦截器可以添加多个，全局回调监听分三种，每种最多添加一个
+* 拦截器处的理时机在请求前和响应后，全局回调监听只在响应后，并且晚于拦截器
+* 全局回调监听可以 **阻断**（return false）某个请求的具体回调，而拦截器不能
+:::
+
+::: warning
+如果你开发的是安卓应用，我们强烈建议你添加 [全局异常监听](/v2/configuration.html#全局回调监听)，这样当你在某个请求中忘记使用`OnException`或`nothrow`，而它又发生了超时或网络异常时，不至于让程序崩溃。
+:::
+
+### 全局下载监听
+
+```java
+HTTP http = HTTP.builder()
+ .downloadListener((HttpTask task, Download download) -> {
+ // 所有下载在开始之前都会先走这里
+ Ctrl ctrl = download.getCtrl(); // 下载控制器
+
+ })
+ .build();
+```
+
+## 配置 OkHttpClient
+
+ 与其他封装 OkHttp3 的框架不同，OkHttps 并不会遮蔽 OkHttp3 本身就很好用的功能，如下：
+
+```java
+HTTP http = HTTP.builder()
+ .config((OkHttpClient.Builder builder) -> {
+ // 配置连接池 最小10个连接（不配置默认为 5）
+ builder.connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES));
+ // 配置连接超时时间（默认10秒）
+ builder.connectTimeout(20, TimeUnit.SECONDS);
+ // 配置 WebSocket 心跳间隔（默认没有心跳）
+ builder.pingInterval(60, TimeUnit.SECONDS);
+ // 配置拦截器
+ builder.addInterceptor((Chain chain) -> {
+ Request request = chain.request();
+ // 必须同步返回，拦截器内无法执行异步操作
+ return chain.proceed(request);
+ });
+ // 其它配置: CookieJar、SSL、缓存、代理、事件监听...
+ // 所有 OkHttp 能配置的，都可以在这里配置
+ })
+ .build();
+```
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/discuss.md b/okhttps-doc/docs/v2/discuss.md
new file mode 100644
index 00000000..e69de29b
diff --git a/okhttps-doc/docs/v2/foundation.md b/okhttps-doc/docs/v2/foundation.md
new file mode 100644
index 00000000..5e7ce347
--- /dev/null
+++ b/okhttps-doc/docs/v2/foundation.md
@@ -0,0 +1,847 @@
+---
+description: OkHttps 请求方法 回调函数 HttpResult cache 多次 消费报文体 HttpCall 构建HTTP任务 请求参数 JSON 使用标签 发起请求 取消请求
+---
+
+# 基础
+
+## 请求方法
+
+OkHttps 使用`sync(String url)`和`async(String url)`方法发起 同步和异步的 HTTP 请求，它们支持的方法有：
+
+HTTP 请求方法 | 实现方法 | Restful 释义 | 起始版本
+-|-|-|-
+GET | `get()` | 获取资源 | 1.0.0
+HEAD | `head()` | 获取资源头信息 | 2.0.0
+POST | `post()` | 提交资源 | 1.0.0
+PUT | `put()` | 更新资源 | 1.0.0
+PATCH | `patch()` | 部分更新资源 | 2.0.0.RC
+DELETE | `delete()` | 删除资源 | 1.0.0
+其它 | `request(String method)` | 任何 HTTP 请求方法 | 2.0.0.RC
+
+例如，修改 ID 为 100 的书的标题，可以这样请求：
+
+```java
+http.async("/books/100")
+ .addBodyPara("title", "新标题")
+ .patch(); // 发起 PATCH 请求
+```
+
+再如，删除 ID 为 100 的书，可以发起这样的请求：
+
+```java
+http.async("/books/100").delete(); // 发起 DELETE 请求
+```
+
+再如，使用 HEAD 请求获取服务器上文件的大小：
+
+```java
+HttpResult res = http.sync("/download/file.zip").head();
+// // HttpResult#getContentLength() 新增于 2.0.0 版本
+System.out.println("size = " + res.getContentLength());
+```
+
+你还可以自定义一些请求方法，例如：
+
+```java
+http.async("/somethings")
+ .setOnResponse((HttpResult result) -> {
+ System.out.println(result);
+ })
+ .request("OPTIONS"); // 发起 OPTIONS 请求
+```
+
+另外，同步请求的所有这些方法都会返回一个[`HttpResult`](#httpresult)，而异步请求则会返回一个[`HttpCall`](#httpcall)：
+
+```java
+HttpResult res1 = http.sync("/books").get(); // 同步 GET
+HttpResult res2 = http.sync("/books").post(); // 同步 POST
+
+HttpCall call1 = http.async("/books").get(); // 异步 GET
+HttpCall call2 = http.async("/books").post(); // 异步 POST
+```
+
+## 回调函数
+
+OkHttps 的回调函数全部使用单方法模式，这样可以充分利用 Java8 或 Kotlin 中的 Lambda 表达式，使你的代码更加简洁优雅：
+
+### 普通回调
+
+```java
+http.async("/users") // http://api.demo.com/users
+ .setOnResponse((HttpResult res) -> {
+ // 响应回调
+ int status = res.getStatus(); // 状态码
+ Headers headers = res.getHeaders(); // 响应头
+ Body body = res.getBody(); // 报文体
+ })
+ .setOnException((IOException e) -> {
+ // 异常回调
+ })
+ .setOnComplete((State state) -> {
+ // 完成回调，无论成功失败都会执行，并且在 响应|异常回调 之前执行
+ // 可以根据 state 枚举判断执行状态:
+ // State.CANCELED` 请求被取消
+ // State.RESPONSED` 已收到响应
+ // State.TIMEOUT` 请求超时
+ // State.NETWORK_ERROR` 网络错误
+ // State.EXCEPTION` 其它请求异常
+ })
+ .get();
+```
+
+OkHttps 同时还支持 **全局回调** 和 **回调阻断** 机制，详见 [全局回调监听](/v2/configuration.html#全局回调监听)。
+
+::: tip
+* 只有异步请求才可以设置这三种（响应|异常|完成）回调
+* 同步请求直接返回结果，无需使用回调
+:::
+
+### 便捷回调
+
+OkHttps 自 v2.1.0 起，对异步请求提供了 **6** 种便捷回调方法，它们都是`OnResponse`回调的简化版，当在具体请求中不关心状态码和响应头信息时，使用起来非常方便：
+
+```java
+http.async("/users") // http://api.demo.com/users
+ .setOnResBody(Body body -> {
+ // 得到响应报文体 Body 对象
+ })
+ .setOnResMapper(Mapper mapper -> {
+ // 得到响应报文体反序列化后的 Mapper 对象
+ })
+ .setOnResArray(Array array -> {
+ // 得到响应报文体反序列化后的 Array 对象
+ })
+ .setOnResBean(Bean.class, User bean -> {
+ // 得到响应报文体根据 Bean.class 反序列化后的 Java Bean 对象
+ })
+ .setOnResBean(new TypeRef>(){}, Result result -> {
+ // 得到响应报文体根据 TypeRef 反序列化后的 复合泛型 对象
+ })
+ .setOnResList(Bean.class, List list -> {
+ // 得到响应报文体根据 Bean.class 反序列化后的 Java Bean 列表
+ })
+ .setOnResString(String str -> {
+ // 得到响应报文体的字符串 String 对象
+ })
+ .get();
+```
+
+以上的便捷回调里，无法像`OnResponse`那样获得响应的状态码和头信息，所以最好和 [全局回调监听](/v2/configuration.html#全局回调监听) 配合使用。在全局回调里对错误码先做统一处理。
+
+
+### 进度回调
+
+上传进度回调：
+
+```java
+http.sync("/upload")
+ .addFilePara("avatar", "D:/image/avatar.jpg")
+ .setOnProcess((Process process) -> {
+ long doneBytes = process.getDoneBytes(); // 已上传字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已上传的比例
+ boolean isDone = process.isDone(); // 是否上传完成
+ })
+ .post();
+```
+
+关于上传的更多细节请参考 [文件上传](/v2/updown.html#文件上传) 章节。
+
+下载进度回调：
+
+```java
+http.sync("/download/test.zip").get().getBody()
+ .setOnProcess((Process process) -> {
+ long doneBytes = process.getDoneBytes(); // 已下载字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已下载的比例
+ boolean isDone = process.isDone(); // 是否下载完成
+ })
+ .toFolder("D:/download/") // 指定下载的目录，文件名将根据下载信息自动生成
+ .start();
+```
+
+#### 还有下载成功或失败的回调：
+
+```java
+http.sync("/download/test.zip").get().getBody()
+ .toFile("D:/download/test.zip") // 下载到文件
+ .setOnSuccess((File file) -> {
+ // 下载成功
+ })
+ .setOnFailure((Failure failure) -> {
+ // 下载失败
+ })
+ .start();
+```
+
+关于下载的更多内容，请参考 [文件下载](/v2/updown.html#文件下载) 章节。
+
+### WebSocket 回调
+
+```java
+http.webSocket("/websocket-endpoint")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ // WebSocket 连接建立回调
+ })
+ .setOnMessage((WebSocket ws, Message msg) -> {
+ // 服务器下发消息回调
+ })
+ .setOnException((WebSocket ws, Throwable thr) -> {
+ // 连接发生异常回调
+ })
+ .setOnClosing((WebSocket ws, WebSocket.Close close) -> {
+ // 连接正在关闭回调
+ })
+ .setOnClosed((WebSocket ws, WebSocket.Close close) -> {
+ // 连接已关闭（v2.0.0 之后包含连接被取消 和 连接发生异常）
+ boolean isCanceled = close.isCanceled(); // from v2.0.0
+ boolean isException = close.isException(); // from v2.0.0
+ int code = close.getCode();
+ String reason = close.getReason();
+ })
+ .listen();
+```
+
+::: tip
+OkHttps 的所有回调函数都默认在 IO 线程执行，若要切换默认线程（例如 Android 中切换到 UI 线程）请参见 [回调线程切换](/v2/android.html#回调线程切换)。
+:::
+
+## HttpResult
+
+ `HttpResult`是HTTP请求执行完后的结果，它是同步请求方法`get()`、`post()`等的返回值，也是异步请求响应回调`OnResponse`的参数，它定义了如下方法：
+
+* `getState()` 得到请求执行状态枚举，它有以下取值：
+ * `State.CANCELED` 请求被取消
+ * `State.RESPONSED` 已收到响应
+ * `State.TIMEOUT` 请求超时
+ * `State.NETWORK_ERROR` 网络错误
+ * `State.EXCEPTION` 其它请求异常
+* `getStatus()` 得到 HTTP 状态码
+* `isSuccessful()` 是否响应成功，状态码在 [200..300) 之间
+* `getHeaders()` 得到HTTP响应头
+* `getHeaders(String name)` 得到HTTP响应头
+* `getHeader(String name)` 得到HTTP响应头
+* `getContentLength();` 解析响应头中的 Content-Length 长度信息（v2.0.0 新增）
+* `getBody()` 得到响应报文体`Body`实例，它定义了如下方法（对同一个`Body`实例，以下的`toXXX()`类方法只能使用一个且仅能调用一次，除非先使用 cache 方法）：
+ * `toBytes()` 报文体转换为字节数组
+ * `toByteStream()` 报文体转换为字节输入流
+ * `toCharStream()` 报文体转换为字符输入流
+ * `toString()` 报文体转换为字符串文本
+ * `toBean(Class type)` 报文体根据`type`自动反序列化为 JavaBean（依赖`MsgConvertor`）
+ * `toBean(Type type)` 报文体根据`type`自动反序列化为 JavaBean（依赖`MsgConvertor`）(支持复合泛型)
+ * `toBean(TypeRef type)` 报文体根据`type`自动反序列化为 JavaBean（依赖`MsgConvertor`）(支持复合泛型)
+ * `toList(Class type)` 报文体根据`type`自动反序列化为 JavaBean 列表（依赖`MsgConvertor`）
+ * `toMapper()` 报文体自动反序列化为映射结构的对象（依赖`MsgConvertor`，v2.0.0.RC 之前是`toJsonObject()`）
+ * `toArray()` 报文体自动反序列化为数组结构的对象（依赖`MsgConvertor`，v2.0.0.RC 之前是`toJsonArray()`）
+ * `toFile(String filePath)` 下载到指定路径
+ * `toFile(File file)` 下载到指定文件
+ * `toFolder(String dirPath)` 下载到指定目录
+ * `toFolder(File dir)` 下载到指定目录
+ * `getType()` 返回报文体的媒体类型（v2.0.0 新增，不再推荐`getContentType()`方法）
+ * `getLength()` 返回报文体的字节长度（v2.0.0 新增，不再推荐`getContentLength()`方法）
+ * `cache()` 缓存报文体，开启缓存后可重复使用`toXXX()`类方法
+ * `close()` 关闭报文体，未对报文体做任何消费时使用，比如只读取报文头
+* `getError()` 执行中发生的异常，自动捕获执行请求时发生的 网络超时、网络错误 和 其它IO异常
+* `close()` 关闭报文，未对报文体做任何消费时使用，比如只读取长度
+
+示例，请求结果自动反序列化为 Bean 和 List：
+
+```java
+// 自动转Bean
+Order order = http.sync("/orders/1").get()
+ .getBody().toBean(Order.class);
+
+// 自动转List
+List orders = http.sync("/orders")
+ .get().getBody().toList(Order.class);
+```
+
+上例中，为了获取订单列表，必须先定义一个`Order`类，如果你不想定义它，可以直接使用`toMapper()`和`toArray()`方法：
+
+```java
+Mapper order = http.sync("/orders/1")
+ .get().getBody().toMapper();
+
+long orderId = order.getLong("id"); // 订单ID
+long orderNo = order.getString("orderNo"); // 订单号
+
+Array orders = http.sync("/orders")
+ .get().getBody().toArray();
+
+int size = orders.size(); // 订单个数
+Mapper o1 = orders.getMapper(0) // 第1个订单
+```
+
+关于 Mapper 和 Array 的更多信息，请参考 [Mapper 接口](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Mapper.java) 和 [Array 接口](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Array.java)。
+
+示例，使用 `cache()` 方法：
+
+```java
+Body body = http.sync("/orders").get().getBody().cache();
+
+// 使用 cache 后，可以多次使用 toXXX() 方法
+System.out.println(body.toString());
+System.out.println(body.toArray());
+System.out.println(body.toList(Order.class));
+```
+
+示例，获取下载文件的大小：
+
+```java
+long size = http.sync("/download/test.zip").get().getBody()
+ .close() // 只是想获得文件大小，不消费报文体，所以直接关闭
+ .getLength(); // 获得待下载文件的大小
+// 由于未消费报文体，所以本次请求不会消耗下载报文体的时间和网络流量
+System.out.println("size = " + size);
+```
+
+上述代码等同于：
+
+```java
+long size = http.sync("/download/test.zip").get().close().getContentLength();
+System.out.println("size = " + size);
+```
+
+还等效于：
+
+```java
+long size = http.sync("/download/test.zip").head().getContentLength();
+// 因为 HEAD 请求没有响应报文体，所以就不需要关闭啦
+System.out.println("size = " + size);
+```
+
+## HttpCall
+
+[`HttpCall`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/HttpCall.java)是异步请求方法`get()`、`post()`等的返回值，它是一个接口，继承自[`Cancelable`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Cancelable.java)，与`java`的`Future`接口很像，它有如下方法：
+
+* `cancel()` 取消本次请求，返回取消结果
+* `isCanceled()` 返回请求是否被取消
+* `isDone()` 返回是否执行完成，包含取消和失败
+* `getResult()` 返回执行结果`HttpResult`对象，若请求未执行完，则挂起当前线程直到执行完成再返回
+
+例如，取消一个异步请求：
+
+```java
+HttpCall call = http.async("/users/1").get();
+
+System.out.println(call.isCanceled()); // false
+
+boolean success = call.cancel(); // 取消请求
+
+System.out.println(success); // true
+System.out.println(call.isCanceled()); // true
+```
+
+## 构建请求
+
+ `HTTP`接口的`sync(String url)`、`async(String url)`和`webSocket(String url)`方法返回一个`HttpTask`对象，它实现了[`Cancelable`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Cancelable.java)接口，同时也提供了可链式调用的`addXXX`与`setXXX`等系列方法用于构建请求报文。
+
+### 请求头
+
+* `addHeader(String name, String value)` 添加请求头
+* `addHeader(Map headers)` 添加请求头
+
+### 路径参数
+
+* `addPathPara(String name, Object value)` 添加路径参数：替换 URL 里的`{name}`占位符
+* `addPathPara(Map params)` 添加路径参数：替换 URL 里的`{name}`占位符
+
+路径参数可以存在于 URL 中的任何位置，例如：
+
+```java
+final String BOOKS_QUERY_URL = "/authors/{authorId}/books?type={type}";
+
+http.async(BOOKS_QUERY_URL) // /authors/1/books?bookType=2
+ .addPathPara("authorId", 1)
+ .addPathPara("type", 2)
+ .setOnResponse((HttpResult res) -> {
+
+ })
+ .get();
+```
+
+### 查询参数
+
+* `addUrlPara(String name, Object value)` 添加 URL 参数：拼接在 URL 的`?`之后（查询参数）
+* `addUrlPara(Map params)` 添加 URL 参数：拼接在 URL 的`?`之后（查询参数）
+
+::: warning
+方法`addXxxPara`在 v2.0.0.RC 之前名为`addXxxParam`, v2.0.0.RC 之后推荐使用简洁版的方法，老方法将在 v2.1.0 中移除。
+:::
+
+### 报文体类型
+
+* `bodyType(String type)` 结合报文体参数使用，用于设置本次的请求报文体类型，可以是`form`、`json`、`xml`、`protobuf`等，默认为`form`（表单类型）,可以在构建`HTTP`实例时修改默认的类型
+
+::: tip 解析
+`bodyType`对应于`MsgConvertor`的`mediaType()`方法的返回值，OkHttps 会按照既定的规则 [`mediaType().contain(bodyType)`] 去匹配出对应的`MsgConvertor`去序列化报文体参数。
+:::
+
+### 报文体参数（表单、JSON、XML等）
+
+OkHttps 信仰统一与一致更加优雅，所以自 v2.0.0.RC 开始、它便统一了报文体参数的 API，无论是表单、还是 JSON、XML 或是 protobuf 等等，只要这些参数是放在请求报文体中，那么就可以通过一套 API 轻松搞定！
+
+* `addBodyPara(String name, Object value)` 添加 Body 参数
+* `addBodyPara(Map params)` 添加 Body 参数
+* `setBodyPara(Object object)` 设置 Body 参数体
+
+::: warning 注意
+添加报文体参数后，不可使用 GET、HEAD 请求方法
+
+方法`setBodyPara`在 v2.0.0.RC 之前名为`setRequestJson`, v2.0.0.RC 之后推荐使用统一 API，老方法将在 v2.1.0 中移除。
+:::
+
+#### 表单请求
+
+默认的请求报文体类型就是`form`表单，所以可以直接使用`addBodyPara`方法：
+
+```java
+http.async("/projects")
+ .addBodyPara("name", "OkHttps")
+ .addBodyPara("desc", "最好用的网络框架")
+ .post();
+```
+
+或者是传入一个 Map 对象：
+
+```java
+Map params = new HashMap<>();
+params.put("name", "OkHttps");
+params.put("desc", "最好用的网络框架");
+
+http.async("/projects")
+ .addBodyPara(params)
+ .post();
+```
+
+甚至可以用`setBodyPara`传入一个`String`：
+
+```java
+http.async("/projects")
+ .setBodyPara("name=OkHttps&desc=最好用的网络框架")
+ .post();
+```
+
+如果你配置了`FormConvertor`（请参考 [配置-表单序列化](/v2/configuration.html#表单序列化) 章节），那你还可以直接传入一个 POJO（自定义的一个 Java 类）：
+
+```java
+Proejct project = new Proejct();
+project.setName("OkHttps");
+project.setDesc("最好用的网络框架");
+
+http.async("/projects")
+ .setBodyPara(project) // 将自动序列化为表单格式
+ .post();
+```
+
+以上 **4** 种方式具有相同的效果，但如果你修改了默认的报文体序列化类型（请参考 [默认序列化类型](/v2/configuration.html#默认序列化类型) 章节），那还需在请求时指定当前的请求报文体类型：
+
+```java
+http.async("/projects")
+ .bodyType("form") // 指明请求体类型是表单
+ ...
+```
+
+或使用`OkHttps.FORM`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.FORM) // 指明请求体类型是表单
+ ...
+```
+
+#### JSON 请求
+
+JSON 请求要求默认的请求`bodyType`为`json` 或者 在具体请求中显式指明`bodyType`为`json`，其它用法和表单请求一模一样。
+
+单个添加
+
+```java
+http.async("/projects")
+ .addBodyPara("name", "OkHttps")
+ .addBodyPara("desc", "最好用的网络框架")
+ .post();
+```
+
+Map 方式：
+
+```java
+Map params = new HashMap<>();
+params.put("name", "OkHttps");
+params.put("desc", "最好用的网络框架");
+
+http.async("/projects")
+ .addBodyPara(params)
+ .post();
+```
+
+POJO 方式：
+
+```java
+Proejct project = new Proejct();
+project.setName("OkHttps");
+project.setDesc("最好用的网络框架");
+
+http.async("/projects")
+ .setBodyPara(project) // 自动序列化
+ .post();
+```
+
+字符串方式：
+
+```java
+http.async("/projects")
+ .setBodyPara("{\"name\":\"OkHttps\",\"desc\":\"最好用的网络框架\"}")
+ .post();
+```
+
+唯一的不同是，如果默认的`bodyType`不是`json`，那需要显式指定当前请求的`bodyType`为`json`：
+
+```java
+http.async("/projects")
+ .bodyType("json") // 指明请求体类型是 JSON
+ ...
+```
+
+或使用`OkHttps.JSON`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.JSON) // 指明请求体类型是 JSON
+ ...
+```
+
+#### XML 请求
+
+若默认不是 XML，则显式指定当前请求的报文体类型
+
+```java
+http.async("/projects")
+ .bodyType("xml") // 指明请求体类型是 XML
+ ...
+```
+
+或使用`OkHttps.XML`常量
+
+```java
+http.async("/projects")
+ .bodyType(OkHttps.XML) // 指明请求体类型是 XML
+ ...
+```
+
+其它与 表单和 JSON，完全一致，不再赘述。
+
+#### 其它数据格式的请求
+
+只需要扩展了相应的`MsgConvertor`，OkHttps 支持任意数据格式的请求。
+
+### 文件参数
+
+文件参数是一个特殊的报文体参数，当使用以下方法上传文件时，OkHttps 会强制报文体使用`form`模式。
+
+* `addFilePara(String name, String filePath)` 上传文件
+* `addFilePara(String name, File file)` 上传文件
+* `addFilePara(String name, String type, byte[] content)` 上传文件
+* `addFilePara(String name, String type, String fileName, byte[] content)` 上传文件
+
+文件参数和报文体参数，还可以混用，例如：
+
+```java
+http.sync("/upload")
+ .addBodyPara("title", "头像")
+ .addFilePara("image", "D:/image/avatar.jpg")
+ .post();
+```
+
+::: warning
+如果你使用的是 v2.0.0.RC 版本中，以上代码会报 **“方法 addFilePara 只能使用 form 方式请求”** 错误，可以用以下方式解决该问题：
+```java
+http.async("/upload")
+ .bodyType("multipart/form")
+ .addBodyPara("title", "头像")
+ .addFilePara("test", "D:/image/avatar.jpg")
+ .post();
+```
+详见 ISSUE: [https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9](https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9)
+:::
+
+无论当前的默认`bodyType`是什么，和文件参数一起添加的`Body`参数都将以`form`（表单）模式提交。
+
+### 其它
+
+* `tag(String tag)` 为 HTTP 任务添加标签
+* `setRange(long rangeStart)` 设置 Range 头信息，`addHeader`的便捷方法，用于[断点续传](/v1/updown.html#实现断点续传)
+* `setRange(long rangeStart, long rangeEnd)` 设置 Range 头信息，可用于[分块下载](/v1/updown.html#实现分块下载)
+* `bind(Object object)` 绑定一个对象，可用于实现 Android 里的[生命周期绑定](/v1/android.html#生命周期绑定)
+* `nothrow()` 一种发生异常时的处理方式，请参考 [异常处理](/v2/features.html#异常处理) 章节
+* `skipPreproc()` 设置本次请求跳过所有预处理器，请参考 [预处理器](/v2/configuration.html#并行预处理器) 章节
+* `skipSerialPreproc()` 设置本次请求只跳过所有串行预处理器，请参考 [串行预处理器](/v2/configuration.html#串行预处理器（token问题最佳解决方案）) 章节
+
+## 使用标签
+
+有时候我们想对 HTTP 任务加以分类，这时候可以使用标签功能：
+
+```java
+http.async("/users") //（1）
+ .tag("A")
+ .get();
+
+http.async("/users") //（2）
+ .tag("A.B")
+ .get();
+
+http.async("/users") //（3）
+ .tag("B")
+ .get();
+
+http.async("/users") //（4）
+ .tag("B")
+ .tag("C") // 从 v1.0.4 标签将以追加模式添加，等效于 setTag("B.C")
+ .get();
+
+http.async("/users") //（5）
+ .tag("C")
+ .get();
+
+http.webSocket("/websocket")
+ .tag("B") // (6) 标签同样可以作用在 WebSocket 连接上
+ .listen();
+```
+
+### 预处理器中访问标签
+
+在 [预处理器](/v2/configuration.html#并行预处理器) 中可以通过`chain`对象获得当前的请求任务`HttpTask`，然后使用`isTagged`或`getTag`方法获取标签信息：
+
+```java
+HTTP http = HTTP.builder()
+ // 添加预处理器
+ .addPreprocessor(chain -> {
+
+ // 获得当前的HTTP任务
+ HttpTask task = chain.getTask();
+ // 判断该任务是否添加了 "A" 标签
+ boolean tagged = task.isTagged("A");
+ // 得到整个标签串
+ String tag = task.getTag();
+
+ // ...
+ })
+ // ...
+```
+
+在 [串行预处理器](/v2/configuration.html#串行预处理器（token问题最佳解决方案）) 中也是同样的方法访问标签。
+
+### 全局监听中访问标签
+
+在 [全局监听](/v2/configuration.html#全局监听) 中，访问标签就加简单一点，因为`HttpTask`正是形参之一，例如全局响应监听：
+
+```java
+HTTP http = HTTP.builder()
+ // 全局响应监听
+ .responseListener((HttpTask task, HttpResult result) -> {
+
+ // 判断该任务是否添加了 "A" 标签
+ boolean tagged = task.isTagged("A");
+ // 得到整个标签串
+ String tag = task.getTag();
+
+ // ...
+ })
+ // ...
+```
+
+其它类型的全局监听也是同样的方法访问标签。
+
+### 拦截器中访问标签
+
+自 v2.0.1 起，OkHttps 支持在拦截器内访问标签，可通过`Request`对象拿到整个标签串：
+
+```java
+HTTP http = HTTP.builder()
+ // OkHttpClient 原生配置
+ .config(b -> {
+ // 添加拦截器
+ b.addInterceptor(chain -> {
+
+ // 拿到 Request 对象
+ Request request = chain.request();
+ // 拿到整个标签串
+ String tag = request.tag(String.class);
+
+ // ...
+ });
+ })
+ // ...
+```
+
+拦截器的配置，可参见 [配置 OkHttpClient](/v2/configuration.html#配置-okhttpclient) 章节。
+
+### 使用标签取消请求
+
+当使用标签后，还可以按标签批量的对HTTP任务进行取消：
+
+```java
+int count = http.cancel("B"); //（2）（3）（4）（6）被取消（取消标签包含"B"的任务）
+System.out.println(count); // 输出 4
+```
+
+取消请求任务，只是标签的一个附带功能。
+
+标签 真正的强大之处在于：它可以和 [预处理器](/v2/configuration.html#并行预处理器) 和 [全局监听](/v2/configuration.html#全局监听) 及 拦截器 配合使用，以此来扩展很多功能。可参考 [串行预处理器（token问题最佳解决方案）](/v2/configuration.html#串行预处理器（token问题最佳解决方案）)和 [安卓-自动加载框](/v2/android.html#自动加载框) 等章节。
+
+另外，请求任务的取消，还有更多的方式，可参考 [取消请求](/v2/foundation.html#取消请求) 章节
+
+## 异常处理
+
+ 使用 OkHttps 时，**异常处理不是必须的**，但相比其它的 HTTP 开发包，它还提供一个特别的处理方法：`nothrow()`，以满足不同的异常处理需求。
+
+### 同步请求的异常
+
+ 默认情况下，当同步请求执行异常时，会直接向外抛出，我们可以用 `try catch` 来捕获，例如：
+
+```java
+try {
+ HttpResult result = http.sync("/users/1").get();
+} catch (HttpException e) {
+ Throwable cause = e.getCause(); // 得到异常原因
+ if (cause instanceof ConnectException) {
+ // 当没网络时，会抛出连接异常
+ }
+ if (cause instanceof SocketTimeoutException) {
+ // 当接口长时间未响应，会抛出超时异常
+ }
+ if (cause instanceof UnknownHostException) {
+ // 当把域名或IP写错，会抛出 UnknownHost 异常
+ }
+ // ...
+}
+```
+ 这种传统的异常处理方式，当然可以解决问题，但 OkHttps 有更佳的方案：
+
+```java
+// 方法 nothrow() 让异常不直接抛出
+HttpResult result = http.sync("/users/1").nothrow().get();
+// 判断执行状态
+switch (result.getState()) {
+ case RESPONSED: // 请求已正常响应
+ break;
+ case CANCELED: // 请求已被取消
+ break;
+ case NETWORK_ERROR: // 网络错误，说明用户没网了
+ break;
+ case TIMEOUT: // 请求超时
+ break;
+ case EXCEPTION: // 其它异常
+ break;
+}
+// 还可以获得具体的异常信息
+IOException error = result.getError();
+```
+
+### 异步请求的异常
+
+ 异步请求最常用的异常处理方式就是设置一个异常回调：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnException((IOException e) -> {
+ // 这里处理请求异常
+ })
+ .get();
+```
+ 当然，还有一个全局异常监听（`ExceptionListener`，请参考 [全局回调监听](/v2/configuration.html#全局回调监听) 章节）：
+
+```java
+HTTP http = HTTP.builder()
+ .exceptionListener((HttpTask task, IOException error) -> {
+ // 所有请求执行完都会走这里
+
+ // 返回 true 表示继续执行 task 的 OnComplete 回调，
+ // 返回 false 则表示不再执行，即 阻断
+ return true;
+ })
+ .build();
+```
+ 如果不设置`OnException`回调，也没有`ExceptionListener`，发生异常时会在 **IO 线程** 中向上抛出，外层无法捕获：
+
+```java
+try {
+ http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+} catch (HttpException e) {
+ // 这种方式是捕获不到异常的！！！！！！
+}
+```
+ 即使没有`OnException`回调，发生异常时，依然会走`OnComplete`回调，如果设置了的话：
+
+```java
+http.async("/users/1")
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .setOnComplete((State state) -> {
+ // 发生异常，会先执行这里，可以根据 state 判断发生了什么
+ // 但执行完后依然会在IO线程中向上抛出
+ })
+ .get();
+```
+ 如果就是想 **不处理异常，也不向上抛出**，发生错误完全无视，可以做到吗？可以！还是使用`nothrow()`方法：
+
+```java
+http.async("/users/1")
+ .nothrow() // 告诉 OkHttps 发生异常时不向外抛出
+ .setOnResponse((HttpResult result) -> {
+ // 当发生异常时就不会走这里
+ })
+ .get();
+```
+
+::: warning
+如果你开发的是安卓应用，我们强烈建议你添加 [全局异常监听](/v2/configuration.html#全局回调监听)，这样当你在某个请求中忘记使用`OnException`或`nothrow`，而它又发生了超时或网络异常时，不至于让程序崩溃。
+:::
+
+
+## 取消请求
+
+ 在 OkHttps 里取消请求共有 **4 种** 方式可选：
+
+**1、** 使用`HttpCall#cancel()`取消单个请求（适用于异步请求，[详见`HttpCall`章节](/v2/foundation.html#httpcall)）
+
+**2、** 使用`HttpTask#cancel()`取消单个请求（适用于所有请求）（since v1.0.4）
+
+```java
+HttpTask task = http.async("/users")
+ .setOnResponse((HttpResult result) -> {
+ // 响应回调
+ });
+
+task.get(); // 发起 GET 请求
+
+// 取消请求，并返回是否取消成功
+boolean canceled = task.cancel();
+```
+
+**3、** 使用`HTTP#cancel(String tag)`按标签批量取消请求（适用于所有请求，[详见 标签 章节](/v2/foundation.html#使用标签)）
+
+**4、** 使用`HTTP#cancelAll()`取消所有请求（适用于所有请求）（since v1.0.2）
+
+```java
+http.cancelAll(); // 取消所有请求
+```
+
+::: tip 提示
+以上四种方式都对所有类型的请求有效，包括：同步 HTTP、异步 HTTP 和 WebSocket 连接。
+:::
+
+除了以上的 4 种方式，OkHttps 里还可以实现自动取消，请参考 [安卓-生命周期绑定](/v2/android.html#生命周期绑定) 章节。
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/getstart.md b/okhttps-doc/docs/v2/getstart.md
new file mode 100644
index 00000000..58fc6efd
--- /dev/null
+++ b/okhttps-doc/docs/v2/getstart.md
@@ -0,0 +1,339 @@
+---
+description: OkHttps 安装 构建实例 HTTP build 同步请求 异步请求 sync async BaseUrl request webSocket gradle maven ejlchina
+---
+
+# 起步
+
+## 安装
+
+### Maven
+
+#### 单独使用 OkHttps
+
+```xml
+
+ com.ejlchina
+ okhttps
+ 2.3.0
+
+```
+
+单独使用 OkHttps 需要自定义[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)，否则无法使用 **自动正反序列化** 相关功能，后文会详细讲解哪些功能会受到此影响。
+
+#### 与 fastjson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-fastjson
+ 2.3.0
+
+```
+
+#### 与 gson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-gson
+ 2.3.0
+
+```
+
+#### 与 jackson 一起使用
+
+```xml
+
+ com.ejlchina
+ okhttps-jackson
+ 2.3.0
+
+```
+
+::: tip
+以上依赖四选一即可
+:::
+
+#### 使用 Stomp 客户端
+
+```xml
+
+ com.ejlchina
+ okhttps-stomp
+ 1.0.1
+
+```
+
+### Gradle
+
+#### 单独使用 OkHttps
+
+```groovy
+implementation 'com.ejlchina:okhttps:2.3.0'
+```
+
+单独使用 OkHttps 需要自定义[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)，否则无法使用 **自动正反序列化** 相关功能，后文会详细讲解哪些功能会受到此影响。
+
+#### 与 fastjson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-fastjson:2.3.0'
+```
+
+#### 与 gson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-gson:2.3.0'
+```
+
+#### 与 jackson 一起使用
+
+```groovy
+implementation 'com.ejlchina:okhttps-jackson:2.3.0'
+```
+
+::: tip
+以上依赖四选一即可
+:::
+
+#### 使用 Stomp 客户端
+
+```groovy
+implementation 'com.ejlchina:okhttps-stomp:1.0.1'
+```
+
+#### JDK 版本
+
+安卓中使用需要把 JDK 版本调成 1.8，在 app 模块的 build.gradle 中加入以下配置即可：
+
+```groovy
+android {
+ // 省略其它配置..
+ compileOptions {
+ sourceCompatibility = 1.8
+ targetCompatibility = 1.8
+ }
+}
+```
+
+## 使用
+
+### 构建 HTTP
+
+```java
+HTTP http = HTTP.builder().build();
+```
+
+以上代码构建了一个最简单的`HTTP`实例，它拥有以下方法：
+
+* `sync(String url)` 开始一个同步 HTTP 请求
+* `async(String url)` 开始一个异步 HTTP 请求
+* `webSocket(String url)` 开始一个 WebSocket 连接
+* `cancel(String tag)` 按标签取消（同步 | 异步 | WebSocket）连接
+* `cancelAll()` 取消所有（同步 | 异步 | WebSocket）连接
+* `request(Request request)` OkHttp 原生 HTTP 请求
+* `webSocket(Request request, WebSocketListener listener)` OkHttp 原生 WebSocket 连接
+* `newBuilder()` 用于重新构建一个 HTTP 实例
+
+为了使用方便，在构建的时候，我们更愿意指定一个`BaseUrl`和[`MsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/MsgConvertor.java)（详见 [设置 BaseUrl](/v1/configuration.html#设置-baseurl) 和 [消息转换器](/v2/configuration.html#消息转换器)）:
+
+```java
+HTTP http = HTTP.builder()
+ .baseUrl("http://api.example.com")
+ .addMsgConvertor(new GsonMsgConvertor())
+ .build();
+```
+
+上例中的[`GsonMsgConvertor`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMsgConvertor.java)来自[`okhttps-gson`](https://gitee.com/ejlchina-zhxu/okhttps/tree/master/okhttps-gson)。为了简化文档，下文中出现的`http`均是在构建时设置了`BaseUrl`和`MsgConvertor`的`HTTP`实例。
+
+### 同步请求
+
+ 使用方法`sync(String url)`开始一个同步请求：
+
+```java
+List users = http.sync("/users") // http://api.example.com/users
+ .get() // GET请求
+ .getBody() // 获取响应报文体
+ .toList(User.class); // 得到目标数据
+```
+
+ 方法`sync`返回一个同步`HttpTask`，可链式使用。
+
+### 异步请求
+
+ 使用方法`async(String url)`开始一个异步请求：
+
+```java
+http.async("/users/1") // http://api.example.com/users/1
+ .setOnResponse((HttpResult res) -> {
+ // 得到目标数据
+ User user = res.getBody().toBean(User.class);
+ })
+ .get(); // GET请求
+```
+ 方法`async`返回一个异步`HttpTask`，可链式使用。
+
+### WebSocket
+
+ 使用方法`webSocket(String url)`开始一个 WebSocket 通讯：
+
+```java
+http.webSocket("/chat")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ ws.send("向服务器问好");
+ })
+ .setOnMessage((WebSocket ws，Message msg) -> {
+ // 从服务器接收消息（自动反序列化）
+ Chat chat = msg.toBean(Chat.class);
+ // 相同的消息发送给服务器（自动序列化 Chat 对象）
+ ws.send(chat);
+ })
+ .listen(); // 启动监听
+```
+ 方法`webSocket`返回一个支持 WebSocket 的`HttpTask`，也可链式使用。
+
+### 请求三步曲
+
+#### 第一步、确定请求方式
+
+同步 HTTP（`sync`）、异步 HTTP（`async`）或 WebSocket（`webSocket`）
+
+#### 第二步、构建请求任务
+
+* `addXxxPara` - 添加请求参数
+* `setOnXxxx` - 设置回调函数
+* `tag` - 添加标签
+* ...
+
+#### 第三步、调用请求方法
+
+HTTP 请求方法：
+
+* `get()` - GET 请求
+* `post()` - POST 请求
+* `put()` - PUT 请求
+* `delete()` - DELETE 请求
+* ...
+
+Websocket 方法：
+
+* `listen()` - 启动监听
+
+#### 任意请求，都遵循请求三部曲！
+
+### 工具类
+
+OkHttps 提供了两个开箱即用的工具类，让你从此告别封装工具类的烦恼：
+
+工具类 | 起始版本 | 功能特点
+-|-|-
+`OkHttps` | `2.0.0.RC` | 支持自动注入`MsgConvertor`，支持 [SPI 方式注入配置](#配置okhttps)，推荐用于主应用中的网络开发
+`HttpUtils` | `1.0.0` | 自`2.0.0.RC`开始支持自动注入`MsgConvertor`，不建议再做其它配置，推荐用于第三方依赖包中的网络开发
+
+这两个工具都类会自动以 SPI 方式注入依赖中的`MsgConvertor`（在第一次使用的时候），只要你的项目中添加了相关依赖（如：okhttps-fastjson 等）。并且它们和`HTTP`接口拥有几乎一样的方法，并且这些方法都是静态的：
+
+* `sync(String url)` 开始一个同步 HTTP 请求
+* `async(String url)` 开始一个异步 HTTP 请求
+* `webSocket(String url)` 开始一个 WebSocket 连接
+* `cancel(String tag)` 按标签取消（同步 | 异步 | WebSocket）连接
+* `cancelAll()` 取消所有（同步 | 异步 | WebSocket）连接
+* `request(Request request)` OkHttp 原生 HTTP 请求
+* `webSocket(Request request, WebSocketListener listener)` OkHttp 原生 WebSocket 连接
+
+例如，使用`OkHttps`，无需考虑构造`HTTP`实例，你可以这样发起一个请求：
+
+```java
+OkHttps.async("https://api.example.com/auth/login")
+ .addBodyPara("username", "jack")
+ .addBodyPara("password", "xxxx")
+ .setOnResponse((HttpResult result) -> {
+ // 得到返回数据，使用 Mapper 可省去定义一个实体类
+ Mapper mapper = result.getBody().toMapper();
+ // 登录是否成功
+ boolean success = mapper.getBool("success");
+ })
+ .post();
+```
+
+### 配置`OkHttps`
+
+工具类`OkHttps`还支持以 SPI 方式注入自定义配置，分以下两步：
+
+#### 第一步、新建一个配置类，实现[`com.ejlchina.okhttps.Config`](https://gitee.com/ejlchina-zhxu/okhttps/blob/master/okhttps/src/main/java/com/ejlchina/okhttps/Config.java)接口
+
+例如：
+
+```java
+package com.example.okhttps;
+
+import com.ejlchina.okhttps.Config;
+import com.ejlchina.okhttps.HTTP;
+
+public class OkHttpsConfig implements Config {
+
+ @Override
+ public void with(HTTP.Builder builder) {
+ // 在这里对 HTTP.Builder 做一些自定义的配置
+ builder.baseUrl("https://api.domo.com");
+ // 如果项目中添加了 okhttps-fastjson 或 okhttps-gson 或 okhttps-jackson 依赖
+ // OkHttps 会自动注入它们提供的 MsgConvertor
+ // 所以这里就不需要再配置 MsgConvertor 了 (内部实现自动注入的原理也是 SPI)
+ // 但如果没有添加这些依赖，那还需要自定义一个 MsgConvertor
+ builder.addMsgConvertor(new MyMsgConvertor());
+ }
+
+}
+```
+
+以上做简单的演示，更多配置案例可参考 [安卓-最佳实践](/v2/android.html#最佳实践) 章节。
+
+#### 第二步、在项目的`/src/main`目录下新建`resources/META-INF/services/com.ejlchina.okhttps.Config`文件，文件内容是上一步自定义的配置类的全名
+
+例如：
+
+
+
+以上两步就完成了对`OkHttps`工具类的自定义配置，接下来你便可以体验它神奇的能力了：
+
+```java
+List users = OkHttps.sync("/users") // http://api.example.com/users
+ .get().getBody().toList(User.class);
+```
+
+#### 为什么要这样呢？
+
+有同学可能会疑问，为什么要这样配置呢，不能直接给`OkHttps`设置一个`HTTP`实例吗，像这样：
+
+```java
+HTTP http = HTTP.builder()
+ // 自定义配置...
+ .build();
+
+OkHttps.set(http);
+```
+
+这样做在一般情况下确实可以，但是在某些 Java 虚拟机上（特别在 Android）中，有一个致命的缺陷：那就是系统在某些情况下会回收静态变量，而`OkHttps`内部持有的`HTTP`实例一旦被回收后，上述方式自定义的配置就会丢失，这样在后续的逻辑处理中就可能会造成严重的问题！
+
+而 SPI 注入的方式则可以很好的解决这个问题：即使`OkHttps`内部的`HTTP`实例被回收，在下次使用时，`OkHttps`又会自动加载注入的配置重新构建一个`HTTP`实例，这样就保证了用户自定义的配置不会丢失。
+
+所以我们推荐在 Android 应用开发中，直接使用`OkHttps`，自定义配置通过 SPI 方式注入。
+
+而在开发具有网络请求需求的依赖项目时，直接使用`HttpUtils`并且不做自定义的配置，如果一定要自定义配置，那就使用`HTTP.Builder`重新构建一个`HTTP`实例使用吧。
+
+### IDEA 小技巧
+
+由于 OkHttps 遵循请求三部曲，所以我们在 IDEA 中设置一个代码模板（Android Studio 一样设置）
+
+* 菜单 File -> Settings 打开 Settings 设置框
+* 展开 Editor -> Live Templates
+
+
+
+如图设置好后，写代码时，输入`oks`，按回车键，就会自动生成模版，赶快尝试一下吧。
+
+
+**至此，你已轻松学会了 OkHttps 90% 的常规用法！但别急，后面还有更加精彩的。**
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/stomp.md b/okhttps-doc/docs/v2/stomp.md
new file mode 100644
index 00000000..932a7e1e
--- /dev/null
+++ b/okhttps-doc/docs/v2/stomp.md
@@ -0,0 +1,144 @@
+---
+description: OkHttps WebSocket Stomp OkHttp
+---
+
+# Stomp
+
+项目 [OkHttps Stomp](https://gitee.com/ejlchina-zhxu/okhttps-stomp) 基于 OkHttps 的 [WebSocket](/v2/websocket.html) 功能实现了一个非常轻量的 Stomp 客户端协议，它可以让你轻松实现 **广播发布与订阅** 和 **队列发布与订阅** 的客户端功能。
+
+## 添加依赖
+
+要开启 Stomp 功能，需要添加以下依赖：
+
+### Maven
+
+```xml
+
+ com.ejlchina
+ okhttps-stomp
+ 1.0.1
+
+```
+
+### Gradle
+
+```groovy
+implementation 'com.ejlchina:okhttps-stomp:1.0.1'
+```
+
+## 构建 Stomp 实例
+
+类`Stomp`提供静态方法`over`来构建`Stomp`实例：
+
+* `over(WebSocketTask task)` 基于 OkHttps 的 WebSocket 构建一个 Stomp 实例，并自动确认消息
+* `over(WebSocketTask task, boolean autoAck)` 构建一个 Stomp 实例，并可指定是否自动确认消息
+
+例如：
+
+```java
+// 使用一个 Websocket 连接构建一个 Stomp 实例，同时设置心跳间隔为 20 秒
+Stomp stomp = Stomp.over(OkHttps.webSocket("wss://...").heatbeat(20, 20));
+```
+
+以上代码构建了一个简单的 Stomp 客户端，并默认在收到消息时会**自动确认**，如果需要收到确认，可以使用下面的方式：
+
+```java
+Stomp stomp = Stomp.over(
+ OkHttps.webSocket("wss://...").heatbeat(20, 20),
+ false // 参数设置 autoAck 为 false，将需要手动确认消息
+ );
+```
+
+## 连接 Stomp 服务
+
+得到一个`Stomp`实例后，可使用以下两个方法连接 Stomp 服务器：
+
+* `connect()` 直接连接 Stomp 服务器
+* `connect(List headers)` 携带一些 Stomp 头信息连接 Stomp 服务器
+
+例如：
+
+```java
+stomp.connect();
+```
+
+如果服务器在连接时需要指令一些额外信息，比如连接 RabbitMQ 时需要指定`login`、`passcode` 和 `vhost`:
+
+```java
+List headers = new ArrayList<>();
+headers.add(new Header("login", "username"));
+headers.add(new Header("passcode", "xxxxxxx"));
+headers.add(new Header("host", "your_vhost"));
+
+stomp.connect(headers);
+```
+
+## 连接状态监听
+
+```java
+Stomp.over(OkHttps.webSocket("wss://...").heatbeat(20, 20))
+ .setOnConnected(stomp -> {
+ // 服务器连接成功回调
+ })
+ .setOnDisconnected(close -> {
+ // 连接已断开回调
+ })
+ .connect();
+```
+
+## 消息订阅与退订
+
+### 订阅广播
+
+```java
+stomp.topic("/your-topic", (Message msg) -> {
+ // 得到消息负载
+ String payload = msg.getPayload();
+
+ // 如果需要手动确认消息,调用此方法确认
+ stomp.ack(msg)
+});
+```
+
+### 退订广播
+
+```java
+stomp.untopic("/your-topic");
+```
+
+### 订阅队列
+
+```java
+stomp.queue("/your-queue", (Message msg) -> {
+ // 得到消息负载
+ String payload = msg.getPayload();
+
+ // 如果需要手动确认消息,调用此方法确认
+ stomp.ack(msg)
+});
+```
+
+### 退订队列
+
+```java
+stomp.unqueue("/your-queue");
+```
+
+## 发送消息
+
+```java
+// 发送到广播
+stomp.sendTo("/topic/your-topic", "Hello World");
+// 发送到队列
+stomp.sendTo("/queue/your-queue", "Hello World");
+```
+
+## 断开服务
+
+```java
+stomp.disconnect();
+```
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/updownload.md b/okhttps-doc/docs/v2/updownload.md
new file mode 100644
index 00000000..c2ebd739
--- /dev/null
+++ b/okhttps-doc/docs/v2/updownload.md
@@ -0,0 +1,244 @@
+---
+description: OkHttps 文件 上传 下载 进度监听 过程控制 断点续传 分块下载
+---
+
+# 上传下载
+
+## 文件下载
+
+ OkHttps 并没有把文件的下载排除在常规的请求之外，同一套API，它优雅的设计使得下载与常规请求融合的毫无违和感，一个最简单的示例：
+
+```java
+http.sync("/download/test.zip")
+ .get() // 使用 GET 方法（其它方法也可以，看服务器支持）
+ .getBody() // 得到报文体
+ .toFile("D:/download/test.zip") // 下载到指定的路径
+ .start(); // 启动下载
+
+http.sync("/download/test.zip").get().getBody()
+ .toFolder("D:/download") // 下载到指定的目录，文件名将根据下载信息自动生成
+ .start();
+```
+ 或使用异步连接方式：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ result.getBody().toFolder("D:/download").start();
+ })
+ .get();
+```
+ 这里要说明一下：`sync`与`async`的区别在于连接服务器并得到响应这个过程的同步与异步（这个过程的耗时在大文件下载中占比极小），而`start`方法启动的下载过程则都是异步的。
+
+### 下载进度监听
+
+ 就直接上代码啦，诸君一看便懂：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .stepBytes(1024) // 设置每接收 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .stepRate(0.01) // 设置每接收 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 下载进度回调
+ long doneBytes = process.getDoneBytes(); // 已下载字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已下载的比例
+ boolean isDone = process.isDone(); // 是否下载完成
+ })
+ .toFolder("D:/download/") // 指定下载的目录，文件名将根据下载信息自动生成
+ // .toFile("D:/download/test.zip") // 指定下载的路径，若文件已存在则覆盖
+ .setOnSuccess((File file) -> { // 下载成功回调
+
+ })
+ .start();
+```
+ 值得一提的是：由于 OkHttps 并没有把下载做的很特别，这里设置的进度回调不只对下载文件起用作，即使对响应JSON的常规请求，只要设置了进度回调，它也会告诉你报文接收的进度（提前是服务器响应的报文有`Content-Length`头），例如：
+
+```java
+List users = http.sync("/users")
+ .get()
+ .getBody()
+ .stepBytes(2)
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toList(User.class);
+```
+
+::: warning
+方法`stepBytes`和`stepRate`在 v2.0.0 正式版之前名为`setStepBytes`和`setStepRate`, v2.0.0 之后推荐使用简洁版的方法，老方法将在 v2.1.0 中移除。
+:::
+
+### 下载过程控制
+
+ 过于简单：还是直接上代码：
+
+```java
+Ctrl ctrl = http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .toFolder("D:/download/")
+ .start(); // 该方法返回一个下载过程控制器
+
+ctrl.status(); // 下载状态
+ctrl.pause(); // 暂停下载
+ctrl.resume(); // 恢复下载
+ctrl.cancel(); // 取消下载（同时会删除文件，不可恢复）
+```
+ 无论是同步还是异步发起的下载请求，都可以做以上的控制：
+
+```java
+http.async("/download/test.zip")
+ .setOnResponse((HttpResult result) -> {
+ // 拿到下载控制器
+ Ctrl ctrl = result.getBody().toFolder("D:/download/").start();
+ })
+ .get();
+```
+
+### 实现断点续传
+
+ OkHttps 对断点续传并没有再做更高层次的封装，因为这是app该去做的事情，它在设计上使各种网络问题的处理变简单的同时力求纯粹。下面的例子可以看到，OkHttps 通过一个失败回调拿到 **断点**，便将复杂的问题变得简单：
+
+```java
+http.sync("/download/test.zip")
+ .get()
+ .getBody()
+ .toFolder("D:/download/")
+ .setOnFailure((Failure failure) -> { // 下载失败回调，以便接收诸如网络错误等失败信息
+ IOException e = failure.getException(); // 具体的异常信息
+ long doneBytes = failure.getDoneBytes(); // 已下载的字节数（断点），需要保存，用于断点续传
+ File file = failure.getFile(); // 下载生成的文件，需要保存 ，用于断点续传（只保存路径也可以）
+ })
+ .start();
+```
+ 下面代码实现续传：
+
+```java
+long doneBytes = ... // 拿到保存的断点
+File file = ... // 待续传的文件
+
+http.sync("/download/test.zip")
+ .setRange(doneBytes) // 设置断点（已下载的字节数）
+ .get()
+ .getBody()
+ .toFile(file) // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+
+ })
+ .setOnFailure((Failure failure) -> {
+
+ })
+ .start();
+```
+
+### 实现分块下载
+
+ 当文件很大时，有时候我们会考虑分块下载，与断点续传的思路是一样的，示例代码：
+
+```java
+static String url = "http://api.demo.com/download/test.zip"
+
+public static void main(String[] args) {
+ long totalSize = OkHttps.sync(url).get().getBody()
+ .close() // 因为这次请求只是为了获得文件大小，不消费报文体，所以直接关闭
+ .getContentLength(); // 获得待下载文件的大小（由于未消费报文体，所以该请求不会消耗下载报文体的时间和网络流量）
+ download(totalSize, 0); // 从第 0 块开始下载
+ sleep(50000); // 等待下载完成（不然本例的主线程就结束啦）
+}
+
+static void download(long totalSize, int index) {
+ long size = 3 * 1024 * 1024; // 每块下载 3M
+ long start = index * size;
+ long end = Math.min(start + size, totalSize);
+ OkHttps.sync(url)
+ .setRange(start, end) // 设置本次下载的范围
+ .get().getBody()
+ .toFile("D:/download/test.zip") // 下载到同一个文件里
+ .setAppended() // 开启文件追加模式
+ .setOnSuccess((File file) -> {
+ if (end < totalSize) { // 若未下载完，则继续下载下一块
+ download(totalSize, index + 1);
+ } else {
+ System.out.println("下载完成");
+ }
+ })
+ .start();
+}
+```
+
+本例中用到了`OkHttps`工具类，在应用的开发者我们推荐使用它，请参考 [工具类](/v2/getstart.html#工具类) 章节。
+
+## 文件上传
+
+ 一个简单文件上传的示例：
+
+```java
+http.sync("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .post(); // 上传发法一般使用 POST 或 PUT，看服务器支持
+```
+ 异步上传也是完全一样：
+
+```java
+http.async("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .post();
+```
+
+::: warning
+如果你使用的是 v2.0.0.RC 版本中，以上代码会报 **“方法 addFilePara 只能使用 form 方式请求”** 错误，可以用以下方式解决该问题：
+```java
+http.async("/upload")
+ .bodyType("multipart/form")
+ .addFilePara("test", "D:/download/test.zip")
+ .post();
+```
+详见 ISSUE: [https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9](https://gitee.com/ejlchina-zhxu/okhttps/issues/I1H8G9)
+:::
+
+### 上传进度监听
+
+ OkHttps 的上传进度监听，监听的是所有请求报文体的发送进度，示例代码：
+
+```java
+http.sync("/upload")
+ .addBodyPara("name", "Jack")
+ .addBodyPara("age", 20)
+ .addFilePara("avatar", "D:/image/avatar.jpg")
+ .stepBytes(1024) // 设置每发送 1024 个字节执行一次进度回调（不设置默认为 8192）
+ // .stepRate(0.01) // 设置每发送 1% 执行一次进度回调（不设置以 StepBytes 为准）
+ .setOnProcess((Process process) -> { // 上传进度回调
+ long doneBytes = process.getDoneBytes(); // 已发送字节数
+ long totalBytes = process.getTotalBytes(); // 总共的字节数
+ double rate = process.getRate(); // 已发送的比例
+ boolean isDone = process.isDone(); // 是否发送完成
+ })
+ .post();
+```
+ 咦！怎么感觉和下载的进度回调的一样？没错！OkHttps 还是使用同一套API处理上传和下载的进度回调，区别只在于上传是在`get/post`方法之前使用这些API，下载是在`getBody`方法之后使用。很好理解：`get/post`之前是准备发送请求时段，有上传的含义，而`getBody`之后，已是报文响应的时段，当然是下载。
+
+### 上传过程控制
+
+ 上传文件的过程控制就很简单，和常规请求一样，只有异步发起的上传可以取消：
+
+```java
+HttpCall call = http.async("/upload")
+ .addFilePara("test", "D:/download/test.zip")
+ .setOnProcess((Process process) -> {
+ System.out.println(process.getRate());
+ })
+ .post();
+
+call.cancel(); // 取消上传
+```
+ 上传就没有暂停和继续这个功能啦，应该没人有这个需求吧?
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/docs/v2/websocket.md b/okhttps-doc/docs/v2/websocket.md
new file mode 100644
index 00000000..a749536c
--- /dev/null
+++ b/okhttps-doc/docs/v2/websocket.md
@@ -0,0 +1,162 @@
+---
+description: OkHttps WebSocket Heatbeat 心跳 OkHttp
+---
+
+# WebSocket
+
+OkHttps 使用`webSocket(String url)`方法发起 WebSocket 连接，并使用`listen()`方法启动监听。
+
+## 连接参数
+
+如果在连接时需要向服务器传递参数，处理方式和 HTTP 请求一样，例如需要用户名和密码才能连接 WebSocket 服务：
+
+```java
+http.webSocket("/chat")
+ .addUrlPara("username", "Jack")
+ .addUrlPara("password", "xxxxxxxx")
+ .setOnMessage((WebSocket ws，Message msg) -> {
+
+ })
+ .listen(); // 启动监听
+```
+
+::: warning 注意
+WebSocket 连接只能添加 **请求头**、 **Url 参数**（查询参数）和 **Path 参数**, 报文体参数（Body）和 文件参数是不允许添加的。
+:::
+
+## 心跳机制
+
+OkHttps 自带两种心跳机制
+
+### 全局心跳配置
+
+在构建`HTTP`实例时，可以配置一个全局心跳时间间隔：
+
+```java
+HTTP http = HTTP.builder()
+ .config((OkHttpClient.Builder builder) -> {
+
+ // 配置 WebSocket 心跳间隔（默认没有心跳）
+ builder.pingInterval(10, TimeUnit.SECONDS);
+ })
+ .build();
+```
+
+如上配置，当使用这个`HTTP`实例发起 WebSocket 连接时，客户端会每隔 10秒 向服务器发送一次 PING 消息，同时服务器必须在客户端发送心跳后的 10秒 内回复 PONG 消息，否则就会触发`SocketTimeoutException`异常
+
+### 单次心跳配置（since V2.3.0）
+
+自 V2.3.0 起 OkHttps 提供了另外一种心跳机制，它在发起具体的 WebSocket 连接时通过方法`heatbeat(int pingSeconds, int pongSeconds)`分别指定客户端与服务器的心跳时间间隔：
+
+```java
+http.webSocket("/chat")
+ .heatbeat(10, 10)
+ .setOnMessage((WebSocket ws，Message msg) -> {
+
+ })
+ .listen(); // 启动监听
+```
+
+如上配置，客户端仍会每隔 10秒 向服务器发送一次 PING 消息，并期望服务器回复 PONG 消息的间隔也是 10 秒一次，但如果服务器或网络由于某些未知原因导致客户端未能正确收到 PONG 消息，客户端还会容忍两次失败，当第三个 10 秒后还未收到服务器的任何消息时，则会触发`SocketTimeoutException`异常
+
+::: tip OkHttps 的心跳机制相对于 OkHttp 主要有以下特点
+* 客户端发送的任何消息都具有一次心跳作用
+* 服务器发送的任何消息都具有一次心跳作用
+* 若服务器超过 3 * pongSeconds 秒没有回复心跳，才触发心跳超时
+:::
+
+## 消息收发
+
+### 接收消息
+
+发起 WebSocket 连接是，设置一个`OnMessage`回调，便可接收到服务器的消息：
+
+```java
+http.webSocket("/chat")
+ .setOnMessage((WebSocket ws，Message msg) -> {
+ // 接收到消息 msg
+ })
+ .listen(); // 启动监听
+```
+
+在该回调内接收到一个`Message`类型的消息对象，它和`HttpReault.Body`都继承自`Toable`接口，他共有如下一些方法：
+
+* `isText()` 判断是文本消息还是二进制消息
+* `toByteStream()` 消息体转字节流
+* `toBytes()` 消息体转字数组
+* `toByteString()` 消息体转字数组
+* `toCharStream()` 消息体转字符流
+* `toString()` 消息体转字符串
+* `toMapper()` 消息体转 Mapper 对象（不想定义 Java Bean 时使用）
+* `toArray()` 消息体转 Array 数组（不想定义 Java Bean 时使用）
+* `toBean(Class type)` 报文体Json文本转JavaBean
+* `toBean(Type type)` 报文体Json文本转JavaBean
+* `toBean(TypeRef type)` 报文体Json文本转JavaBean
+* `toList(Class type)` 报文体Json文本转JavaBean列表
+
+### 发送消息
+
+向服务器发送消息，首先要获得一个`WebSocket`实例，该实例可以通过`listen()`方法的返回值或回调方法的参数获取，如:
+
+```java
+WebSocket ws = http.webSocket("/chat").listen(); // 启动监听，并返回一个 WebSocket 实例
+```
+
+接口`WebSocket`继承自`Cancelable`，它共定义了如下方法：
+
+* `cancel()` 取消连接（连接成功前可以取消）
+* `queueSize()` 排队待发送消息的数量
+* `send(Object object)` 发送消息，参数是待发送的对象，可以是 String | ByteString | byte[] | Java Bean
+* `close(int code, String reason)` 关闭连接（连接成功后可以关闭）
+* `msgType(String type)` 设置消息传输类型，类似于`bodyType`
+
+一个发送消息的例子
+
+```java
+WebSocket ws = http.webSocket("/chat").listen();
+ws.send("Hello World!") // 该消息会先进入排队等待状态，当连接成功时发送给服务器
+```
+
+或者
+
+```java
+http.webSocket("/chat")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ // 当连接成功时发送给服务器
+ ws.send("Hello World!")
+ })
+ .listen();
+```
+
+## 回调方法
+
+WebSocket 连接共可设置 **5** 种回调方法：
+
+```java
+http.webSocket("/websocket-endpoint")
+ .setOnOpen((WebSocket ws, HttpResult res) -> {
+ // WebSocket 连接成功时回调
+ })
+ .setOnMessage((WebSocket ws, Message msg) -> {
+ // 收到服务器下发的消息时回调
+ })
+ .setOnException((WebSocket ws, Throwable thr) -> {
+ // 连接发生异常时回调
+ })
+ .setOnClosing((WebSocket ws, WebSocket.Close close) -> {
+ // 连接正在关闭时回调
+ })
+ .setOnClosed((WebSocket ws, WebSocket.Close close) -> {
+ // 连接已关闭（v2.0.0 之后包含连接被取消 和 连接发生异常）时回调
+ })
+ .listen();
+```
+
+::: tip 需要注意的是
+如果设置了 [全局回调监听](/v2/configuration.html#全局回调监听), 它们对 WebSocket 连接 同样起作用
+:::
+
+
+
+
+
\ No newline at end of file
diff --git a/okhttps-doc/package.json b/okhttps-doc/package.json
new file mode 100644
index 00000000..3e309bcb
--- /dev/null
+++ b/okhttps-doc/package.json
@@ -0,0 +1,18 @@
+{
+ "scripts": {
+ "dev": "vuepress dev docs",
+ "build": "vuepress build docs"
+ },
+ "devDependencies": {
+ "@vuepress/plugin-back-to-top": "^1.5.0",
+ "@vuepress/plugin-medium-zoom": "^1.5.0",
+ "vuepress": "^1.5.0",
+ "vuepress-plugin-baidu-autopush": "^1.0.1",
+ "vuepress-plugin-baidu-tongji": "^1.0.1",
+ "vuepress-plugin-seo": "^0.1.2"
+ },
+ "dependencies": {
+ "@vssue/api-github-v4": "^1.4.0",
+ "@vssue/vuepress-plugin-vssue": "^1.4.4"
+ }
+}
diff --git a/okhttps-fastjson/.gitignore b/okhttps-fastjson/.gitignore
new file mode 100644
index 00000000..b83d2226
--- /dev/null
+++ b/okhttps-fastjson/.gitignore
@@ -0,0 +1 @@
+/target/
diff --git a/okhttps-fastjson/README.md b/okhttps-fastjson/README.md
deleted file mode 100644
index bbf641f0..00000000
--- a/okhttps-fastjson/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps FastJson
-
-#### 介绍
-
-基于 OkHttps 与 FastJson 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-fastjson
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-fastjson:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-fastjson/pom.xml b/okhttps-fastjson/pom.xml
index 219950e4..7c02e0bb 100644
--- a/okhttps-fastjson/pom.xml
+++ b/okhttps-fastjson/pom.xml
@@ -6,26 +6,26 @@
jar
- cn.zhxu
+ com.ejlchina
okhttps-parent
- 4.1.0
+ 2.3.0
- cn.zhxu
+ com.ejlchina
okhttps
- ${project.version}
+ ${okhttps.version}
- cn.zhxu
- data-fastjson
- ${data.version}
+ com.alibaba
+ fastjson
+ ${fastjson.version}
- cn.zhxu
+ com.ejlchina
okhttps-test
- ${project.version}
+ ${okhttps.version}
test
diff --git a/okhttps-fastjson/src/main/java/cn/zhxu/okhttps/fastjson/FastjsonMsgConvertor.java b/okhttps-fastjson/src/main/java/cn/zhxu/okhttps/fastjson/FastjsonMsgConvertor.java
deleted file mode 100644
index 1ed65148..00000000
--- a/okhttps-fastjson/src/main/java/cn/zhxu/okhttps/fastjson/FastjsonMsgConvertor.java
+++ /dev/null
@@ -1,19 +0,0 @@
-package cn.zhxu.okhttps.fastjson;
-
-import cn.zhxu.data.fastjson.FastjsonDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-
-public class FastjsonMsgConvertor extends FastjsonDataConvertor implements MsgConvertor, ConvertProvider {
-
- @Override
- public String mediaType() {
- return "application/json";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new FastjsonMsgConvertor();
- }
-
-}
diff --git a/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonArray.java b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonArray.java
new file mode 100644
index 00000000..0755c484
--- /dev/null
+++ b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonArray.java
@@ -0,0 +1,77 @@
+package com.ejlchina.okhttps;
+
+import com.alibaba.fastjson.JSONArray;
+import com.alibaba.fastjson.JSONObject;
+
+public class FastjsonArray implements Array {
+
+ private JSONArray json;
+
+ public FastjsonArray(JSONArray json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.isEmpty();
+ }
+
+ @Override
+ public Mapper getMapper(int index) {
+ JSONObject subJson = json.getJSONObject(index);
+ if (subJson != null) {
+ return new FastjsonMapper(subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(int index) {
+ JSONArray subJson = json.getJSONArray(index);
+ if (subJson != null) {
+ return new FastjsonArray(subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(int index) {
+ return json.getBooleanValue(index);
+ }
+
+ @Override
+ public int getInt(int index) {
+ return json.getIntValue(index);
+ }
+
+ @Override
+ public long getLong(int index) {
+ return json.getLongValue(index);
+ }
+
+ @Override
+ public float getFloat(int index) {
+ return json.getFloatValue(index);
+ }
+
+ @Override
+ public double getDouble(int index) {
+ return json.getDoubleValue(index);
+ }
+
+ @Override
+ public String getString(int index) {
+ return json.getString(index);
+ }
+
+ @Override
+ public String toString() {
+ return json.toJSONString();
+ }
+
+}
diff --git a/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMapper.java b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMapper.java
new file mode 100644
index 00000000..7e5aa6d4
--- /dev/null
+++ b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMapper.java
@@ -0,0 +1,89 @@
+package com.ejlchina.okhttps;
+
+import com.alibaba.fastjson.JSONArray;
+import com.alibaba.fastjson.JSONObject;
+
+import java.util.Set;
+
+public class FastjsonMapper implements Mapper {
+
+ private JSONObject json;
+
+ public FastjsonMapper(JSONObject json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.isEmpty();
+ }
+
+ @Override
+ public Mapper getMapper(String key) {
+ JSONObject subJson = json.getJSONObject(key);
+ if (subJson != null) {
+ return new FastjsonMapper(subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(String key) {
+ JSONArray subJson = json.getJSONArray(key);
+ if (subJson != null) {
+ return new FastjsonArray(subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(String key) {
+ return json.getBooleanValue(key);
+ }
+
+ @Override
+ public int getInt(String key) {
+ return json.getIntValue(key);
+ }
+
+ @Override
+ public long getLong(String key) {
+ return json.getLongValue(key);
+ }
+
+ @Override
+ public float getFloat(String key) {
+ return json.getFloatValue(key);
+ }
+
+ @Override
+ public double getDouble(String key) {
+ return json.getDoubleValue(key);
+ }
+
+ @Override
+ public String getString(String key) {
+ return json.getString(key);
+ }
+
+ @Override
+ public boolean has(String key) {
+ return json.containsKey(key);
+ }
+
+ @Override
+ public Set keySet() {
+ return json.keySet();
+ }
+
+ @Override
+ public String toString() {
+ return json.toJSONString();
+ }
+
+}
diff --git a/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMsgConvertor.java b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMsgConvertor.java
new file mode 100644
index 00000000..d8040572
--- /dev/null
+++ b/okhttps-fastjson/src/main/java/com/ejlchina/okhttps/FastjsonMsgConvertor.java
@@ -0,0 +1,58 @@
+package com.ejlchina.okhttps;
+
+import com.alibaba.fastjson.JSON;
+import com.ejlchina.okhttps.internal.HttpException;
+import okio.Okio;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.lang.reflect.Type;
+import java.nio.charset.Charset;
+import java.util.List;
+
+public class FastjsonMsgConvertor implements MsgConvertor, ConvertProvider {
+
+ @Override
+ public String mediaType() {
+ return "application/json";
+ }
+
+ @Override
+ public Mapper toMapper(InputStream in, Charset charset) {
+ return new FastjsonMapper(JSON.parseObject(toString(in, charset)));
+ }
+
+ @Override
+ public Array toArray(InputStream in, Charset charset) {
+ return new FastjsonArray(JSON.parseArray(toString(in, charset)));
+ }
+
+ @Override
+ public byte[] serialize(Object object, Charset charset) {
+ return JSON.toJSONString(object).getBytes(charset);
+ }
+
+ @Override
+ public T toBean(Type type, InputStream in, Charset charset) {
+ return JSON.parseObject(toString(in, charset), type);
+ }
+
+ @Override
+ public List toList(Class type, InputStream in, Charset charset) {
+ return JSON.parseArray(toString(in, charset), type);
+ }
+
+ @Override
+ public MsgConvertor getConvertor() {
+ return new FastjsonMsgConvertor();
+ }
+
+ private String toString(InputStream in, Charset charset) {
+ try {
+ return Okio.buffer(Okio.source(in)).readString(charset);
+ } catch (IOException e) {
+ throw new HttpException("读取文本异常", e);
+ }
+ }
+
+}
diff --git a/okhttps-fastjson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-fastjson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 5ae917c7..00000000
--- a/okhttps-fastjson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.fastjson.FastjsonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-fastjson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider b/okhttps-fastjson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
new file mode 100644
index 00000000..88f3b11d
--- /dev/null
+++ b/okhttps-fastjson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
@@ -0,0 +1 @@
+com.ejlchina.okhttps.FastjsonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-fastjson/src/test/java/cn/zhxu/okhttps/fastjson/TestCase.java b/okhttps-fastjson/src/test/java/com/ejlchina/okhttps/TestCase.java
similarity index 51%
rename from okhttps-fastjson/src/test/java/cn/zhxu/okhttps/fastjson/TestCase.java
rename to okhttps-fastjson/src/test/java/com/ejlchina/okhttps/TestCase.java
index 2f0cc7e6..b47d6741 100644
--- a/okhttps-fastjson/src/test/java/cn/zhxu/okhttps/fastjson/TestCase.java
+++ b/okhttps-fastjson/src/test/java/com/ejlchina/okhttps/TestCase.java
@@ -1,15 +1,15 @@
-package cn.zhxu.okhttps.fastjson;
+package com.ejlchina.okhttps;
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
+import com.ejlchina.okhttps.test.JsonMsgConvertorTest;
import org.junit.Test;
+
public class TestCase {
@Test
public void doTest() throws Exception {
MsgConvertor msgConvertor = new FastjsonMsgConvertor();
- new JsonTestCases(msgConvertor).run();
+ new JsonMsgConvertorTest(msgConvertor).run();
}
}
diff --git a/okhttps-fastjson2-jsonb/README.md b/okhttps-fastjson2-jsonb/README.md
deleted file mode 100644
index 56d4f135..00000000
--- a/okhttps-fastjson2-jsonb/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps FastJson
-
-#### 介绍
-
-基于 OkHttps 与 Fastjson2Jsonb 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-fastjson2-jsonb
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-fastjson2-jsonb:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-fastjson2-jsonb/pom.xml b/okhttps-fastjson2-jsonb/pom.xml
deleted file mode 100644
index dc2a91c0..00000000
--- a/okhttps-fastjson2-jsonb/pom.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-
- 4.0.0
-
- okhttps-fastjson2-jsonb
- OkHttps Fastjson2 JSONB
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- data-fastjson2-jsonb
- ${data.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
-
-
- okhttps-fastjson2-jsonb
-
-
\ No newline at end of file
diff --git a/okhttps-fastjson2-jsonb/src/main/java/cn/zhxu/okhttps/fastjson2/jsonb/Fastjson2JsonbMsgConvertor.java b/okhttps-fastjson2-jsonb/src/main/java/cn/zhxu/okhttps/fastjson2/jsonb/Fastjson2JsonbMsgConvertor.java
deleted file mode 100644
index 17867cd8..00000000
--- a/okhttps-fastjson2-jsonb/src/main/java/cn/zhxu/okhttps/fastjson2/jsonb/Fastjson2JsonbMsgConvertor.java
+++ /dev/null
@@ -1,19 +0,0 @@
-package cn.zhxu.okhttps.fastjson2.jsonb;
-
-import cn.zhxu.data.fastjson2.jsonb.Fastjson2JsonbDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-
-public class Fastjson2JsonbMsgConvertor extends Fastjson2JsonbDataConvertor implements MsgConvertor, ConvertProvider {
-
- @Override
- public String mediaType() {
- return "application/jsonb";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new Fastjson2JsonbMsgConvertor();
- }
-
-}
diff --git a/okhttps-fastjson2-jsonb/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-fastjson2-jsonb/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 3683502a..00000000
--- a/okhttps-fastjson2-jsonb/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.fastjson2.jsonb.Fastjson2JsonbMsgConvertor
\ No newline at end of file
diff --git a/okhttps-fastjson2-jsonb/src/test/java/cn/zhxu/okhttps/fastjson2/jsonb/TestCase.java b/okhttps-fastjson2-jsonb/src/test/java/cn/zhxu/okhttps/fastjson2/jsonb/TestCase.java
deleted file mode 100644
index 835408ba..00000000
--- a/okhttps-fastjson2-jsonb/src/test/java/cn/zhxu/okhttps/fastjson2/jsonb/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.fastjson2.jsonb;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor msgConvertor = new Fastjson2JsonbMsgConvertor();
-// new JsonTestCases(msgConvertor).run();
- }
-
-}
diff --git a/okhttps-fastjson2/README.md b/okhttps-fastjson2/README.md
deleted file mode 100644
index cdaa2cf2..00000000
--- a/okhttps-fastjson2/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps FastJson
-
-#### 介绍
-
-基于 OkHttps 与 Fastjson2 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-fastjson2
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-fastjson2:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-fastjson2/pom.xml b/okhttps-fastjson2/pom.xml
deleted file mode 100644
index dd971348..00000000
--- a/okhttps-fastjson2/pom.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-
- 4.0.0
-
- okhttps-fastjson2
- OkHttps Fastjson2
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- data-fastjson2
- ${data.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
-
-
- okhttps-fastjson2
-
-
\ No newline at end of file
diff --git a/okhttps-fastjson2/src/main/java/cn/zhxu/okhttps/fastjson2/Fastjson2MsgConvertor.java b/okhttps-fastjson2/src/main/java/cn/zhxu/okhttps/fastjson2/Fastjson2MsgConvertor.java
deleted file mode 100644
index a7199847..00000000
--- a/okhttps-fastjson2/src/main/java/cn/zhxu/okhttps/fastjson2/Fastjson2MsgConvertor.java
+++ /dev/null
@@ -1,19 +0,0 @@
-package cn.zhxu.okhttps.fastjson2;
-
-import cn.zhxu.data.fastjson2.Fastjson2DataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-
-public class Fastjson2MsgConvertor extends Fastjson2DataConvertor implements MsgConvertor, ConvertProvider {
-
- @Override
- public String mediaType() {
- return "application/json";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new Fastjson2MsgConvertor();
- }
-
-}
diff --git a/okhttps-fastjson2/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-fastjson2/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 37efd499..00000000
--- a/okhttps-fastjson2/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.fastjson2.Fastjson2MsgConvertor
\ No newline at end of file
diff --git a/okhttps-fastjson2/src/test/java/cn/zhxu/okhttps/fastjson2/TestCase.java b/okhttps-fastjson2/src/test/java/cn/zhxu/okhttps/fastjson2/TestCase.java
deleted file mode 100644
index cc5051ad..00000000
--- a/okhttps-fastjson2/src/test/java/cn/zhxu/okhttps/fastjson2/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.fastjson2;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor msgConvertor = new Fastjson2MsgConvertor();
- new JsonTestCases(msgConvertor).run();
- }
-
-}
diff --git a/okhttps-gson/.gitignore b/okhttps-gson/.gitignore
new file mode 100644
index 00000000..b83d2226
--- /dev/null
+++ b/okhttps-gson/.gitignore
@@ -0,0 +1 @@
+/target/
diff --git a/okhttps-gson/README.md b/okhttps-gson/README.md
deleted file mode 100644
index 938f5181..00000000
--- a/okhttps-gson/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Gson
-
-#### 介绍
-
-基于 OkHttps 与 Gson 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-gson
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-gson:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-gson/pom.xml b/okhttps-gson/pom.xml
index ef0d2ad7..659ea07a 100644
--- a/okhttps-gson/pom.xml
+++ b/okhttps-gson/pom.xml
@@ -6,26 +6,26 @@
jar
- cn.zhxu
+ com.ejlchina
okhttps-parent
- 4.1.0
+ 2.3.0
- cn.zhxu
+ com.ejlchina
okhttps
- ${project.version}
+ ${okhttps.version}
+
+ com.google.code.gson
+ gson
+ ${gson.version}
+
- cn.zhxu
- data-gson
- ${data.version}
-
-
- cn.zhxu
+ com.ejlchina
okhttps-test
- ${project.version}
+ ${okhttps.version}
test
diff --git a/okhttps-gson/src/main/java/cn/zhxu/okhttps/gson/GsonMsgConvertor.java b/okhttps-gson/src/main/java/cn/zhxu/okhttps/gson/GsonMsgConvertor.java
deleted file mode 100644
index 15272f4b..00000000
--- a/okhttps-gson/src/main/java/cn/zhxu/okhttps/gson/GsonMsgConvertor.java
+++ /dev/null
@@ -1,40 +0,0 @@
-package cn.zhxu.okhttps.gson;
-
-import cn.zhxu.data.gson.GsonDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-import com.google.gson.Gson;
-
-public class GsonMsgConvertor extends GsonDataConvertor implements MsgConvertor, ConvertProvider {
-
- public GsonMsgConvertor() { }
-
- public GsonMsgConvertor(Gson gson) {
- super(gson);
- }
-
- @Override
- public String mediaType() {
- return "application/json";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new GsonMsgConvertor();
- }
-
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonArray.java b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonArray.java
new file mode 100644
index 00000000..99795e4b
--- /dev/null
+++ b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonArray.java
@@ -0,0 +1,101 @@
+package com.ejlchina.okhttps;
+
+import com.google.gson.JsonArray;
+import com.google.gson.JsonElement;
+
+public class GsonArray implements Array {
+
+ private JsonArray json;
+
+ public GsonArray(JsonArray json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.size() == 0;
+ }
+
+ @Override
+ public Mapper getMapper(int index) {
+ JsonElement subJson = json.get(index);
+ if (subJson != null) {
+ return new GsonMapper(subJson.getAsJsonObject());
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(int index) {
+ JsonElement subJson = json.get(index);
+ if (subJson != null) {
+ return new GsonArray(subJson.getAsJsonArray());
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsBoolean();
+ }
+ return false;
+ }
+
+ @Override
+ public int getInt(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsInt();
+ }
+ return 0;
+ }
+
+ @Override
+ public long getLong(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsLong();
+ }
+ return 0;
+ }
+
+ @Override
+ public float getFloat(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsFloat();
+ }
+ return 0;
+ }
+
+ @Override
+ public double getDouble(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsDouble();
+ }
+ return 0;
+ }
+
+ @Override
+ public String getString(int index) {
+ JsonElement val = json.get(index);
+ if (val != null) {
+ return val.getAsString();
+ }
+ return null;
+ }
+
+ @Override
+ public String toString() {
+ return json.toString();
+ }
+
+}
diff --git a/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMapper.java b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMapper.java
new file mode 100644
index 00000000..90ea3f90
--- /dev/null
+++ b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMapper.java
@@ -0,0 +1,113 @@
+package com.ejlchina.okhttps;
+
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+
+import java.util.Set;
+
+public class GsonMapper implements Mapper {
+
+ private JsonObject json;
+
+ public GsonMapper(JsonObject json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.size() == 0;
+ }
+
+ @Override
+ public Mapper getMapper(String key) {
+ JsonElement subJson = json.get(key);
+ if (subJson != null) {
+ return new GsonMapper(subJson.getAsJsonObject());
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(String key) {
+ JsonElement subJson = json.get(key);
+ if (subJson != null) {
+ return new GsonArray(subJson.getAsJsonArray());
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsBoolean();
+ }
+ return false;
+ }
+
+ @Override
+ public int getInt(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsInt();
+ }
+ return 0;
+ }
+
+ @Override
+ public long getLong(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsLong();
+ }
+ return 0;
+ }
+
+ @Override
+ public float getFloat(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsFloat();
+ }
+ return 0;
+ }
+
+ @Override
+ public double getDouble(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsDouble();
+ }
+ return 0;
+ }
+
+ @Override
+ public String getString(String key) {
+ JsonElement val = json.get(key);
+ if (val != null) {
+ return val.getAsString();
+ }
+ return null;
+ }
+
+ @Override
+ public boolean has(String key) {
+ return json.has(key);
+ }
+
+ @Override
+ public Set keySet() {
+ return json.keySet();
+ }
+
+ @Override
+ public String toString() {
+ return json.toString();
+ }
+
+}
diff --git a/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMsgConvertor.java b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMsgConvertor.java
new file mode 100644
index 00000000..99ebd955
--- /dev/null
+++ b/okhttps-gson/src/main/java/com/ejlchina/okhttps/GsonMsgConvertor.java
@@ -0,0 +1,88 @@
+package com.ejlchina.okhttps;
+
+import com.google.gson.Gson;
+import com.google.gson.JsonArray;
+import com.google.gson.JsonObject;
+import com.google.gson.reflect.TypeToken;
+
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.lang.reflect.Type;
+import java.nio.charset.Charset;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public class GsonMsgConvertor implements MsgConvertor, ConvertProvider {
+
+ private Gson gson;
+
+ public GsonMsgConvertor() {
+ this(new Gson());
+ }
+
+ public GsonMsgConvertor(Gson gson) {
+ this.gson = gson;
+ }
+
+ @Override
+ public String mediaType() {
+ return "application/json";
+ }
+
+ @Override
+ public Mapper toMapper(InputStream in, Charset charset) {
+ return new GsonMapper(gson.fromJson(new InputStreamReader(in), JsonObject.class));
+ }
+
+ @Override
+ public Array toArray(InputStream in, Charset charset) {
+ return new GsonArray(gson.fromJson(new InputStreamReader(in), JsonArray.class));
+ }
+
+ @Override
+ public byte[] serialize(Object object, Charset charset) {
+ return gson.toJson(object).getBytes(charset);
+ }
+
+ @Override
+ public T toBean(Type type, InputStream in, Charset charset) {
+ return gson.fromJson(new InputStreamReader(in), type);
+ }
+
+ @Override
+ public List toList(Class type, InputStream in, Charset charset) {
+ T[] beans = gson.fromJson(new InputStreamReader(in), TypeToken.getArray(type).getType());
+ List list = new ArrayList<>();
+ Collections.addAll(list, beans);
+ return list;
+ }
+
+ @Override
+ public MsgConvertor getConvertor() {
+ return new GsonMsgConvertor();
+ }
+
+ public Gson getGson() {
+ return gson;
+ }
+
+ public void setGson(Gson gson) {
+ this.gson = gson;
+ }
+
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/okhttps-gson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-gson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 122472d4..00000000
--- a/okhttps-gson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.gson.GsonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-gson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider b/okhttps-gson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
new file mode 100644
index 00000000..5eb90888
--- /dev/null
+++ b/okhttps-gson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
@@ -0,0 +1 @@
+com.ejlchina.okhttps.GsonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-gson/src/test/java/cn/zhxu/okhttps/gson/TestCase.java b/okhttps-gson/src/test/java/com/ejlchina/okhttps/TestCase.java
similarity index 51%
rename from okhttps-gson/src/test/java/cn/zhxu/okhttps/gson/TestCase.java
rename to okhttps-gson/src/test/java/com/ejlchina/okhttps/TestCase.java
index 71406abe..a1fa060c 100644
--- a/okhttps-gson/src/test/java/cn/zhxu/okhttps/gson/TestCase.java
+++ b/okhttps-gson/src/test/java/com/ejlchina/okhttps/TestCase.java
@@ -1,7 +1,6 @@
-package cn.zhxu.okhttps.gson;
+package com.ejlchina.okhttps;
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
+import com.ejlchina.okhttps.test.JsonMsgConvertorTest;
import org.junit.Test;
@@ -10,7 +9,7 @@ public class TestCase {
@Test
public void doTest() throws Exception {
MsgConvertor msgConvertor = new GsonMsgConvertor();
- new JsonTestCases(msgConvertor).run();
+ new JsonMsgConvertorTest(msgConvertor).run();
}
}
diff --git a/okhttps-jackson-xml/README.md b/okhttps-jackson-xml/README.md
deleted file mode 100644
index e2505225..00000000
--- a/okhttps-jackson-xml/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Jackson
-
-#### 介绍
-
-基于 OkHttps 与 JacksonXml 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-jackson-xml
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-jackson-xml:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-jackson-xml/pom.xml b/okhttps-jackson-xml/pom.xml
deleted file mode 100644
index 54aa1fce..00000000
--- a/okhttps-jackson-xml/pom.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-
- 4.0.0
-
- okhttps-jackson-xml
- OkHttps Jackson Xml
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- data-jackson-xml
- ${data.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
-
-
- okhttps-jackson-xml
-
-
\ No newline at end of file
diff --git a/okhttps-jackson-xml/src/main/java/cn/zhxu/okhttps/jackson/xml/JacksonXmlMsgConvertor.java b/okhttps-jackson-xml/src/main/java/cn/zhxu/okhttps/jackson/xml/JacksonXmlMsgConvertor.java
deleted file mode 100644
index 44a29fca..00000000
--- a/okhttps-jackson-xml/src/main/java/cn/zhxu/okhttps/jackson/xml/JacksonXmlMsgConvertor.java
+++ /dev/null
@@ -1,26 +0,0 @@
-package cn.zhxu.okhttps.jackson.xml;
-
-import cn.zhxu.data.jackson.xml.JacksonXmlDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-import com.fasterxml.jackson.dataformat.xml.XmlMapper;
-
-public class JacksonXmlMsgConvertor extends JacksonXmlDataConvertor implements MsgConvertor, ConvertProvider {
-
- public JacksonXmlMsgConvertor() { }
-
- public JacksonXmlMsgConvertor(XmlMapper xmlMapper) {
- super(xmlMapper);
- }
-
- @Override
- public String mediaType() {
- return "application/xml";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new JacksonXmlMsgConvertor();
- }
-
-}
diff --git a/okhttps-jackson-xml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-jackson-xml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 344c3d0b..00000000
--- a/okhttps-jackson-xml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.jackson.xml.JacksonXmlMsgConvertor
\ No newline at end of file
diff --git a/okhttps-jackson-xml/src/test/java/cn/zhxu/okhttps/jackson/xml/TestCase.java b/okhttps-jackson-xml/src/test/java/cn/zhxu/okhttps/jackson/xml/TestCase.java
deleted file mode 100644
index 20af4b4c..00000000
--- a/okhttps-jackson-xml/src/test/java/cn/zhxu/okhttps/jackson/xml/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.jackson.xml;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.XmlTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor convertor = new JacksonXmlMsgConvertor();
-// new XmlTestCases(convertor).run();
- }
-
-}
diff --git a/okhttps-jackson-yaml/README.md b/okhttps-jackson-yaml/README.md
deleted file mode 100644
index dbd3b23f..00000000
--- a/okhttps-jackson-yaml/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Jackson
-
-#### 介绍
-
-基于 OkHttps 与 JacksonYamls 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-jackson-yaml
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-jackson-yaml:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-jackson-yaml/pom.xml b/okhttps-jackson-yaml/pom.xml
deleted file mode 100644
index c550aa50..00000000
--- a/okhttps-jackson-yaml/pom.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-
- 4.0.0
-
- okhttps-jackson-yaml
- OkHttps Jackson Yaml
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- data-jackson-yaml
- ${data.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
-
-
- okhttps-jackson-yaml
-
-
\ No newline at end of file
diff --git a/okhttps-jackson-yaml/src/main/java/cn/zhxu/okhttps/jackson/yaml/JacksonYamlMsgConvertor.java b/okhttps-jackson-yaml/src/main/java/cn/zhxu/okhttps/jackson/yaml/JacksonYamlMsgConvertor.java
deleted file mode 100644
index e0dc08e1..00000000
--- a/okhttps-jackson-yaml/src/main/java/cn/zhxu/okhttps/jackson/yaml/JacksonYamlMsgConvertor.java
+++ /dev/null
@@ -1,26 +0,0 @@
-package cn.zhxu.okhttps.jackson.yaml;
-
-import cn.zhxu.data.jackson.yaml.JacksonYamlDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-import com.fasterxml.jackson.dataformat.yaml.YAMLMapper;
-
-public class JacksonYamlMsgConvertor extends JacksonYamlDataConvertor implements MsgConvertor, ConvertProvider {
-
- public JacksonYamlMsgConvertor() { }
-
- public JacksonYamlMsgConvertor(YAMLMapper yamlMapper) {
- super(yamlMapper);
- }
-
- @Override
- public String mediaType() {
- return "application/yaml";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new JacksonYamlMsgConvertor();
- }
-
-}
diff --git a/okhttps-jackson-yaml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-jackson-yaml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index 8b8befc7..00000000
--- a/okhttps-jackson-yaml/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.jackson.yaml.JacksonYamlMsgConvertor
\ No newline at end of file
diff --git a/okhttps-jackson-yaml/src/test/java/cn/zhxu/okhttps/jackson/yaml/TestCase.java b/okhttps-jackson-yaml/src/test/java/cn/zhxu/okhttps/jackson/yaml/TestCase.java
deleted file mode 100644
index 9f781a72..00000000
--- a/okhttps-jackson-yaml/src/test/java/cn/zhxu/okhttps/jackson/yaml/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.jackson.yaml;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor convertor = new JacksonYamlMsgConvertor();
-// new JsonTestCases(convertor).run();
- }
-
-}
diff --git a/okhttps-jackson/.gitignore b/okhttps-jackson/.gitignore
new file mode 100644
index 00000000..b83d2226
--- /dev/null
+++ b/okhttps-jackson/.gitignore
@@ -0,0 +1 @@
+/target/
diff --git a/okhttps-jackson/README.md b/okhttps-jackson/README.md
deleted file mode 100644
index 54c1cf5e..00000000
--- a/okhttps-jackson/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Jackson
-
-#### 介绍
-
-基于 OkHttps 与 Jackson 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-jackson
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-jackson:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-jackson/pom.xml b/okhttps-jackson/pom.xml
index d9cef0e0..7494f9e5 100644
--- a/okhttps-jackson/pom.xml
+++ b/okhttps-jackson/pom.xml
@@ -6,26 +6,26 @@
jar
- cn.zhxu
+ com.ejlchina
okhttps-parent
- 4.1.0
+ 2.3.0
- cn.zhxu
+ com.ejlchina
okhttps
- ${project.version}
+ ${okhttps.version}
+
+ com.fasterxml.jackson.core
+ jackson-databind
+ ${jackson.version}
+
- cn.zhxu
- data-jackson
- ${data.version}
-
-
- cn.zhxu
+ com.ejlchina
okhttps-test
- ${project.version}
+ ${okhttps.version}
test
diff --git a/okhttps-jackson/src/main/java/cn/zhxu/okhttps/jackson/JacksonMsgConvertor.java b/okhttps-jackson/src/main/java/cn/zhxu/okhttps/jackson/JacksonMsgConvertor.java
deleted file mode 100644
index 1c0e561d..00000000
--- a/okhttps-jackson/src/main/java/cn/zhxu/okhttps/jackson/JacksonMsgConvertor.java
+++ /dev/null
@@ -1,26 +0,0 @@
-package cn.zhxu.okhttps.jackson;
-
-import cn.zhxu.data.jackson.JacksonDataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
-public class JacksonMsgConvertor extends JacksonDataConvertor implements MsgConvertor, ConvertProvider {
-
- public JacksonMsgConvertor() { }
-
- public JacksonMsgConvertor(ObjectMapper objectMapper) {
- super(objectMapper);
- }
-
- @Override
- public String mediaType() {
- return "application/json";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new JacksonMsgConvertor();
- }
-
-}
diff --git a/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonArray.java b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonArray.java
new file mode 100644
index 00000000..a42b88b1
--- /dev/null
+++ b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonArray.java
@@ -0,0 +1,105 @@
+package com.ejlchina.okhttps;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+
+public class JacksonArray implements Array {
+
+ private ArrayNode json;
+
+ public JacksonArray(ArrayNode json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.isEmpty();
+ }
+
+ @Override
+ public Mapper getMapper(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null && subJson.isObject()) {
+ return new JacksonMapper((ObjectNode) subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null && subJson.isArray()) {
+ return new JacksonArray((ArrayNode) subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null) {
+ return subJson.asBoolean(false);
+ }
+ return false;
+ }
+
+ @Override
+ public int getInt(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null) {
+ return subJson.asInt(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public long getLong(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null) {
+ return subJson.asLong(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public float getFloat(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null && subJson.isNumber()) {
+ return subJson.floatValue();
+ }
+ if (subJson != null) {
+ return (float) subJson.asDouble(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public double getDouble(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null) {
+ return subJson.asDouble(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public String getString(int index) {
+ JsonNode subJson = json.get(index);
+ if (subJson != null) {
+ return subJson.asText();
+ }
+ return null;
+ }
+
+ @Override
+ public String toString() {
+ return json.toString();
+ }
+
+}
diff --git a/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMapper.java b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMapper.java
new file mode 100644
index 00000000..c0a2c180
--- /dev/null
+++ b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMapper.java
@@ -0,0 +1,124 @@
+package com.ejlchina.okhttps;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.Set;
+
+public class JacksonMapper implements Mapper {
+
+ private ObjectNode json;
+
+ public JacksonMapper(ObjectNode json) {
+ this.json = json;
+ }
+
+ @Override
+ public int size() {
+ return json.size();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return json.isEmpty();
+ }
+
+ @Override
+ public Mapper getMapper(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null && subJson.isObject()) {
+ return new JacksonMapper((ObjectNode) subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public Array getArray(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null && subJson.isArray()) {
+ return new JacksonArray((ArrayNode) subJson);
+ }
+ return null;
+ }
+
+ @Override
+ public boolean getBool(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null) {
+ return subJson.asBoolean(false);
+ }
+ return false;
+ }
+
+ @Override
+ public int getInt(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null) {
+ return subJson.asInt(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public long getLong(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null) {
+ return subJson.asLong(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public float getFloat(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null && subJson.isNumber()) {
+ return subJson.floatValue();
+ }
+ if (subJson != null) {
+ return (float) subJson.asDouble(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public double getDouble(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null) {
+ return subJson.asDouble(0);
+ }
+ return 0;
+ }
+
+ @Override
+ public String getString(String key) {
+ JsonNode subJson = json.get(key);
+ if (subJson != null) {
+ return subJson.asText();
+ }
+ return null;
+ }
+
+ @Override
+ public boolean has(String key) {
+ return json.has(key);
+ }
+
+ @Override
+ public Set keySet() {
+ Iterator it = json.fieldNames();
+ Set set = new HashSet<>();
+ while (it.hasNext()) {
+ set.add(it.next());
+ }
+ return set;
+ }
+
+ @Override
+ public String toString() {
+ return json.toString();
+ }
+
+}
diff --git a/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMsgConvertor.java b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMsgConvertor.java
new file mode 100644
index 00000000..95863559
--- /dev/null
+++ b/okhttps-jackson/src/main/java/com/ejlchina/okhttps/JacksonMsgConvertor.java
@@ -0,0 +1,132 @@
+package com.ejlchina.okhttps;
+
+import com.ejlchina.okhttps.internal.HttpException;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import com.fasterxml.jackson.databind.type.CollectionType;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.lang.reflect.Type;
+import java.nio.charset.Charset;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public class JacksonMsgConvertor implements MsgConvertor, ConvertProvider {
+
+ private ObjectMapper objectMapper;
+
+ private final Map> cache = new HashMap<>();
+
+
+ public JacksonMsgConvertor() {
+ this(new ObjectMapper());
+ }
+
+ public JacksonMsgConvertor(ObjectMapper objectMapper) {
+ this.objectMapper = objectMapper;
+ }
+
+ @Override
+ public String mediaType() {
+ return "application/json";
+ }
+
+ @Override
+ public Mapper toMapper(InputStream in, Charset charset) {
+ try {
+ JsonNode json = objectMapper.readTree(in);
+ if (json.isObject()) {
+ return new JacksonMapper((ObjectNode) json);
+ }
+ if (json.isNull() || json.isMissingNode()) {
+ return null;
+ }
+ throw new HttpException("不是 一个 json 对象：" + json);
+ } catch (IOException e) {
+ throw new HttpException("Jackson 解析异常", e);
+ }
+ }
+
+ @Override
+ public Array toArray(InputStream in, Charset charset) {
+ try {
+ JsonNode json = objectMapper.readTree(in);
+ if (json.isArray()) {
+ return new JacksonArray((ArrayNode) json);
+ }
+ if (json.isNull() || json.isMissingNode()) {
+ return null;
+ }
+ throw new HttpException("不是 一个 json 数组：" + json);
+ } catch (IOException e) {
+ throw new HttpException("Jackson 解析异常", e);
+ }
+ }
+
+ @Override
+ public byte[] serialize(Object object, Charset charset) {
+ try {
+ return objectMapper.writeValueAsString(object).getBytes(charset);
+ } catch (JsonProcessingException e) {
+ throw new HttpException("Java Bean [" + object + "] Jackson 序列化异常", e);
+ }
+ }
+
+ private TypeReference toTypeRef(Type type) {
+ TypeReference typeRef;
+ synchronized (cache) {
+ //noinspection unchecked
+ typeRef = (TypeReference) cache.get(type);
+ if (typeRef == null) {
+ typeRef = new TypeReference() {
+ @Override
+ public Type getType() {
+ return type;
+ }
+ };
+ cache.put(type, typeRef);
+ }
+ }
+ return typeRef;
+ }
+
+ @Override
+ public T toBean(Type type, InputStream in, Charset charset) {
+ try {
+ return objectMapper.readValue(in, toTypeRef(type));
+ } catch (IOException e) {
+ throw new HttpException("Jackson 解析异常", e);
+ }
+ }
+
+ @Override
+ public List toList(Class type, InputStream in, Charset charset) {
+ CollectionType javaType = objectMapper.getTypeFactory().constructCollectionType(ArrayList.class, type);
+ try {
+ return objectMapper.readValue(in, javaType);
+ } catch (IOException e) {
+ throw new HttpException("Jackson 解析异常", e);
+ }
+ }
+
+ @Override
+ public MsgConvertor getConvertor() {
+ return new JacksonMsgConvertor();
+ }
+
+ public ObjectMapper getObjectMapper() {
+ return objectMapper;
+ }
+
+ public void setObjectMapper(ObjectMapper objectMapper) {
+ this.objectMapper = objectMapper;
+ }
+
+}
diff --git a/okhttps-jackson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-jackson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index dd5ee602..00000000
--- a/okhttps-jackson/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.jackson.JacksonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-jackson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider b/okhttps-jackson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
new file mode 100644
index 00000000..ddfa7bde
--- /dev/null
+++ b/okhttps-jackson/src/main/resources/META-INF/services/com.ejlchina.okhttps.ConvertProvider
@@ -0,0 +1 @@
+com.ejlchina.okhttps.JacksonMsgConvertor
\ No newline at end of file
diff --git a/okhttps-jackson/src/test/java/cn/zhxu/okhttps/jackson/TestCase.java b/okhttps-jackson/src/test/java/cn/zhxu/okhttps/jackson/TestCase.java
deleted file mode 100644
index 74ea88f9..00000000
--- a/okhttps-jackson/src/test/java/cn/zhxu/okhttps/jackson/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.jackson;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor convertor = new JacksonMsgConvertor();
- new JsonTestCases(convertor).run();
- }
-
-}
diff --git a/okhttps-jackson/src/test/java/com/ejlchina/okhttps/TestCase.java b/okhttps-jackson/src/test/java/com/ejlchina/okhttps/TestCase.java
new file mode 100644
index 00000000..d9783489
--- /dev/null
+++ b/okhttps-jackson/src/test/java/com/ejlchina/okhttps/TestCase.java
@@ -0,0 +1,15 @@
+package com.ejlchina.okhttps;
+
+import com.ejlchina.okhttps.test.JsonMsgConvertorTest;
+import org.junit.Test;
+
+
+public class TestCase {
+
+ @Test
+ public void doTest() throws Exception {
+ MsgConvertor msgConvertor = new JacksonMsgConvertor();
+ new JsonMsgConvertorTest(msgConvertor).run();
+ }
+
+}
diff --git a/okhttps-snack3/README.md b/okhttps-snack3/README.md
deleted file mode 100644
index 22af945b..00000000
--- a/okhttps-snack3/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Gson
-
-#### 介绍
-
-基于 OkHttps 与 Gson 集成扩展
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-snack3
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-snack3:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/](https://ok.zhxu.cn/)
diff --git a/okhttps-snack3/pom.xml b/okhttps-snack3/pom.xml
deleted file mode 100644
index 364fdeae..00000000
--- a/okhttps-snack3/pom.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-
- 4.0.0
-
- okhttps-snack3
- OkHttps Snack3
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- data-snack3
- ${data.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
-
-
- okhttps-snack3
-
-
\ No newline at end of file
diff --git a/okhttps-snack3/src/main/java/cn/zhxu/okhttps/snack3/Snack3MsgConvertor.java b/okhttps-snack3/src/main/java/cn/zhxu/okhttps/snack3/Snack3MsgConvertor.java
deleted file mode 100644
index 2c56dd55..00000000
--- a/okhttps-snack3/src/main/java/cn/zhxu/okhttps/snack3/Snack3MsgConvertor.java
+++ /dev/null
@@ -1,33 +0,0 @@
-package cn.zhxu.okhttps.snack3;
-
-import cn.zhxu.data.snack3.Snack3DataConvertor;
-import cn.zhxu.okhttps.ConvertProvider;
-import cn.zhxu.okhttps.MsgConvertor;
-
-public class Snack3MsgConvertor extends Snack3DataConvertor implements MsgConvertor, ConvertProvider {
-
- @Override
- public String mediaType() {
- return "application/json";
- }
-
- @Override
- public MsgConvertor getConvertor() {
- return new Snack3MsgConvertor();
- }
-
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/okhttps-snack3/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider b/okhttps-snack3/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
deleted file mode 100644
index a546ae29..00000000
--- a/okhttps-snack3/src/main/resources/META-INF/services/cn.zhxu.okhttps.ConvertProvider
+++ /dev/null
@@ -1 +0,0 @@
-cn.zhxu.okhttps.snack3.Snack3MsgConvertor
\ No newline at end of file
diff --git a/okhttps-snack3/src/test/java/cn/zhxu/okhttps/snack3/TestCase.java b/okhttps-snack3/src/test/java/cn/zhxu/okhttps/snack3/TestCase.java
deleted file mode 100644
index 9ebb192f..00000000
--- a/okhttps-snack3/src/test/java/cn/zhxu/okhttps/snack3/TestCase.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package cn.zhxu.okhttps.snack3;
-
-import cn.zhxu.okhttps.MsgConvertor;
-import cn.zhxu.okhttps.test.JsonTestCases;
-import org.junit.Test;
-
-
-public class TestCase {
-
- @Test
- public void doTest() throws Exception {
- MsgConvertor msgConvertor = new Snack3MsgConvertor();
- new JsonTestCases(msgConvertor).run();
- }
-
-}
diff --git a/okhttps-stomp/README.md b/okhttps-stomp/README.md
deleted file mode 100644
index ccc3ce2c..00000000
--- a/okhttps-stomp/README.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# OkHttps Stomp
-
-#### 介绍
-
-基于 OkHttps 的 Stomp 协议实现
-
-
-##### Maven
-
-```xml
-
- cn.zhxu
- okhttps-stomp
- 3.5.3
-
-```
-
-##### Gradle
-
-```groovy
-implementation 'cn.zhxu:okhttps-stomp:3.5.3'
-```
-
-#### 更多请参阅 [https://ok.zhxu.cn/v2/stomp.html](https://ok.zhxu.cn/v2/stomp.html)
diff --git a/okhttps-stomp/pom.xml b/okhttps-stomp/pom.xml
deleted file mode 100644
index 3ccaa125..00000000
--- a/okhttps-stomp/pom.xml
+++ /dev/null
@@ -1,38 +0,0 @@
-
- 4.0.0
-
- okhttps-stomp
- OkHttps Stomp
- jar
-
-
- cn.zhxu
- okhttps-parent
- 4.1.0
-
-
-
-
- cn.zhxu
- okhttps
- ${project.version}
-
-
- cn.zhxu
- okhttps-test
- ${project.version}
- test
-
-
- org.jetbrains
- annotations
- 13.0
- compile
-
-
-
-
- okhttps-stomp
-
-
-
\ No newline at end of file
diff --git a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Commands.java b/okhttps-stomp/src/main/java/cn/zhxu/stomp/Commands.java
deleted file mode 100644
index 9a59bb4c..00000000
--- a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Commands.java
+++ /dev/null
@@ -1,63 +0,0 @@
-package cn.zhxu.stomp;
-
-/**
- * 命令
- */
-public class Commands {
-
- /**
- * 发起连接
- */
- public static final String CONNECT = "CONNECT";
-
- /**
- * 已连接
- */
- public static final String CONNECTED = "CONNECTED";
-
- /**
- * 断开连接
- */
- public static final String DISCONNECT = "DISCONNECT";
-
- /**
- * 发送消息
- */
- public static final String SEND = "SEND";
-
- /**
- * 收到消息
- */
- public static final String MESSAGE = "MESSAGE";
-
- /**
- * 收到凭据
- */
- public static final String RECEIPT = "RECEIPT";
-
- /**
- * 发起订阅
- */
- public static final String SUBSCRIBE = "SUBSCRIBE";
-
- /**
- * 发起退订
- */
- public static final String UNSUBSCRIBE = "UNSUBSCRIBE";
-
- /**
- * 确认消息
- */
- public static final String ACK = "ACK";
-
- /**
- * 收到错误
- */
- public static final String ERROR = "ERROR";
-
- /**
- * 未知命令
- */
- public static final String UNKNOWN = "UNKNOWN";
-
-}
diff --git a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Header.java b/okhttps-stomp/src/main/java/cn/zhxu/stomp/Header.java
deleted file mode 100644
index e3441c96..00000000
--- a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Header.java
+++ /dev/null
@@ -1,78 +0,0 @@
-package cn.zhxu.stomp;
-
-public class Header {
-
- /**
- * 订阅者 ID
- */
- public static final String ID = "id";
-
- /**
- * 接受版本
- */
- public static final String VERSION = "accept-version";
-
- /**
- * 心跳
- */
- public static final String HEART_BEAT = "heart-beat";
-
- /**
- * 目的地
- */
- public static final String DESTINATION = "destination";
-
- /**
- * 内容类型
- */
- public static final String CONTENT_TYPE = "content-type";
-
- /**
- * 消息 ID
- */
- public static final String MESSAGE_ID = "message-id";
-
- /**
- * 凭据
- */
- public static final String RECEIPT = "receipt";
-
- /**
- * 凭据 ID
- */
- public static final String RECEIPT_ID = "receipt-id";
-
- /**
- * 订阅者
- */
- public static final String SUBSCRIPTION = "subscription";
-
- /**
- * 确认
- */
- public static final String ACK = "ack";
-
-
- private final String key;
- private final String value;
-
-
- public Header(String key, String value) {
- this.key = key;
- this.value = value;
- }
-
- public String getKey() {
- return key;
- }
-
- public String getValue() {
- return value;
- }
-
- @Override
- public String toString() {
- return key + ':' + value;
- }
-
-}
diff --git a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Message.java b/okhttps-stomp/src/main/java/cn/zhxu/stomp/Message.java
deleted file mode 100644
index 6df8a05a..00000000
--- a/okhttps-stomp/src/main/java/cn/zhxu/stomp/Message.java
+++ /dev/null
@@ -1,57 +0,0 @@
-package cn.zhxu.stomp;
-
-import java.util.List;
-
-
-public class Message {
-
- private final String command;
- private final List headers;
- private final String payload;
-
- public Message(String command, List headers) {
- this(command, headers, null);
- }
-
- public Message(String command, List headers, String payload) {
- this.command = command;
- this.headers = headers;
- this.payload = payload;
- }
-
- public List getHeaders() {
- return headers;
- }
-
- public String getPayload() {
- return payload;
- }
-
- public String getCommand() {
- return command;
- }
-
-
- public String headerValue(String key) {
- Header header = header(key);
- if (header != null) {
- return header.getValue();
- }
- return null;
- }
-
- public Header header(String key) {
- if (headers != null) {
- for (Header header : headers) {
- if (header.getKey().equals(key)) return header;
- }
- }
- return null;
- }
-
- @Override
- public String toString() {
- return "Message {command='" + command + "', headers=" + headers +", payload='" + payload + "'}";
- }
-
-}
diff --git a/okhttps-stomp/src/main/java/cn/zhxu/stomp/MsgCodec.java b/okhttps-stomp/src/main/java/cn/zhxu/stomp/MsgCodec.java
deleted file mode 100644
index 1f83addd..00000000
--- a/okhttps-stomp/src/main/java/cn/zhxu/stomp/MsgCodec.java
+++ /dev/null
@@ -1,25 +0,0 @@
-package cn.zhxu.stomp;
-
-import java.util.function.Consumer;
-
-/**
- * Stomp 消息编解码器
- * @since v3.1.0
- */
-public interface MsgCodec {
-
- /**
- * 编码
- * @param input Stomp 消息
- * @return 编码后的文本
- */
- String encode(Message input);
-
- /**
- * 解码
- * @param input 输入
- * @param out 输出
- */
- void decode(String input, Consumer
- 
- 
+ 
+ 
-* 由于近期交流群的二维码被爬，扫码入群方式已被关闭
-库的使用上若有疑问，可先加微信【18556739726】（请备注 OkHttps）再入群交流
-
-## 友情链接
+* 邮箱：zhou.xu@ejlchina.com
-[**[ Bean Searcher ]** 比 MyBatis 效率快 100 倍的条件检索引擎，天生支持联表，使一行代码实现复杂列表检索成为可能！](https://github.com/ejlchina/bean-searcher)
+## 后续计划
-[**[ SA Token ]** 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！](https://github.com/dromara/Sa-Token)
-
-[**[ hrun4j ]** 接口自动化测试解决方案 --工具选得好，下班回家早；测试用得对，半夜安心睡 ](https://github.com/lematechvip/hrun4j)
-
-[**[ Json Kit ]** 超轻量级 JSON 门面工具，用法简单，不依赖具体实现，让业务代码与 Jackson、Gson、Fastjson 等解耦！](https://gitee.com/troyzhxu/jsonkit)
+* 在 WebSocket 基础上扩展支持 Stomp 协议【已发布 v1.0.1】
+* 在 Android 上通过 Kotlin 扩展使异步请求与 LiveData 集成（即将发布、敬请期待）
## 参与贡献
@@ -128,4 +114,3 @@ Websocket 方法：
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request
-
diff --git a/okhttps-doc/.gitignore b/okhttps-doc/.gitignore
new file mode 100644
index 00000000..e2a59199
--- /dev/null
+++ b/okhttps-doc/.gitignore
@@ -0,0 +1,5 @@
+/package-lock.json
+/node_modules/
+/docs/.vuepress/dist/
+/docs/.vuepress/dist/*
+docs/.vuepress/dist/*
\ No newline at end of file
diff --git a/okhttps-doc/OkHttps.logo.ai b/okhttps-doc/OkHttps.logo.ai
new file mode 100644
index 00000000..e9a96afc
--- /dev/null
+++ b/okhttps-doc/OkHttps.logo.ai
@@ -0,0 +1,1327 @@
+%PDF-1.5
%
+1 0 obj
<>/OCGs[28 0 R]>>/Pages 3 0 R/Type/Catalog>>
endobj
2 0 obj
<>stream
+
+