Node Beginner Handboook

7KH 1RGH %HJLQQHU %RRN$ FRPSUHKHQVLYH 1RGH�MV WXWRULDO

0DQXHO .LHVVOLQJ

7KLV ERRN LV IRU VDOH DW KWWS��OHDQSXE�FRP�QRGHEHJLQQHU

7KLV YHUVLRQ ZDV SXEOLVKHG RQ ��

7KLV LV D /HDQSXE ERRN� /HDQSXE HPSRZHUV DXWKRUV DQGSXEOLVKHUV ZLWK WKH /HDQ 3XEOLVKLQJ SURFHVV� /HDQ 3XEOLVKLQJ LVWKH DFW RI SXEOLVKLQJ DQ LQ�SURJUHVV HERRN XVLQJ OLJKWZHLJKWWRROV DQG PDQ\ LWHUDWLRQV WR JHW UHDGHU IHHGEDFN� SLYRW XQWLO\RX KDYH WKH ULJKW ERRN DQG EXLOG WUDFWLRQ RQFH \RX GR�

k�� 0DQXHO .LHVVOLQJ

http://leanpub.com/nodebeginner

http://leanpub.com

http://leanpub.com/manifesto

7ZHHW 7KLV %RRN�3OHDVH KHOS 0DQXHO .LHVVOLQJ E\ VSUHDGLQJ WKH ZRUG DERXW WKLVERRN RQ 7ZLWWHU�

7KH VXJJHVWHG KDVKWDJ IRU WKLV ERRN LV �QRGHEHJLQQHU�

)LQG RXW ZKDW RWKHU SHRSOH DUH VD\LQJ DERXW WKH ERRN E\ FOLFNLQJRQ WKLV OLQN WR VHDUFK IRU WKLV KDVKWDJ RQ 7ZLWWHU�

KWWSV��WZLWWHU�FRP�VHDUFK��QRGHEHJLQQHU

http://twitter.com

https://twitter.com/search/#nodebeginner

https://twitter.com/search/#nodebeginner

&RQWHQWV

$ERXW � � � � � � � � � � � � � � � � � � � � � � � � � � � � �6WDWXV � � � � � � � � � � � � � � � � � � � � � � � � � � �,QWHQGHG DXGLHQFH � � � � � � � � � � � � � � � � � � � �6WUXFWXUH RI WKLV GRFXPHQW � � � � � � � � � � � � � � � �

-DYD6FULSW DQG 1RGH�MV � � � � � � � � � � � � � � � � � � �-DYD6FULSW DQG <RX � � � � � � � � � � � � � � � � � � � �$ ZRUG RI ZDUQLQJ � � � � � � � � � � � � � � � � � � � �6HUYHU�VLGH -DYD6FULSW � � � � � � � � � � � � � � � � � � �٪+HOOR :RUOG٫ � � � � � � � � � � � � � � � � � � � � � � �

$ IXOO EORZQ ZHE DSSOLFDWLRQ ZLWK 1RGH�MV � � � � � � � �7KH XVH FDVHV � � � � � � � � � � � � � � � � � � � � � � �7KH DSSOLFDWLRQ VWDFN � � � � � � � � � � � � � � � � � � �

%XLOGLQJ WKH DSSOLFDWLRQ VWDFN � � � � � � � � � � � � � � ��$ EDVLF +773 VHUYHU � � � � � � � � � � � � � � � � � � ��$QDO\]LQJ RXU +773 VHUYHU � � � � � � � � � � � � � � ��3DVVLQJ IXQFWLRQV DURXQG � � � � � � � � � � � � � � � � ��+RZ IXQFWLRQ SDVVLQJ PDNHV RXU +773 VHUYHU ZRUN � ��(YHQW�GULYHQ DV\QFKURQRXV FDOOEDFNV � � � � � � � � � ��+RZ RXU VHUYHU KDQGOHV UHTXHVWV � � � � � � � � � � � � ��

&217(176

)LQGLQJ D SODFH IRU RXU VHUYHU PRGXOH � � � � � � � � � ��:KDW٧V QHHGHG WR ٪URXWH٫ UHTXHVWV" � � � � � � � � � � ��([HFXWLRQ LQ WKH NLQJGRP RI YHUEV � � � � � � � � � � � ��5RXWLQJ WR UHDO UHTXHVW KDQGOHUV � � � � � � � � � � � � ��0DNLQJ WKH UHTXHVW KDQGOHUV UHVSRQG � � � � � � � � � ��6HUYLQJ VRPHWKLQJ XVHIXO � � � � � � � � � � � � � � � � ��+DQGOLQJ 3267 UHTXHVWV � � � � � � � � � � � � � � � � ��+DQGOLQJ ILOH XSORDGV � � � � � � � � � � � � � � � � � � ��

&RQFOXVLRQ DQG RXWORRN � � � � � � � � � � � � � � � � � ��

$ERXW7KH DLP RI WKLV GRFXPHQW LV WR JHW \RX VWDUWHG ZLWK GHYHORSLQJDSSOLFDWLRQV IRU 1RGH�MV� WHDFKLQJ \RX HYHU\WKLQJ \RX QHHG WRNQRZ DERXW ٪DGYDQFHG٫ -DYD6FULSW DORQJ WKH ZD\� ,W JRHV ZD\EH\RQG \RXU W\SLFDO ٪+HOOR :RUOG٫ WXWRULDO�

6WDWXV

<RX DUH UHDGLQJ WKH ILQDO YHUVLRQ RI WKLV ERRN� L�H�� XSGDWHV DUHRQO\ GRQH WR FRUUHFW HUURUV RU WR UHIOHFW FKDQJHV LQ QHZ YHUVLRQVRI 1RGH�MV� ,W ZDV ODVW XSGDWHG RQ $SULO ��

7KH FRGH VDPSOHV LQ WKLV ERRN DUH WHVWHG WR ZRUN ZLWK 1RGH�MVYHUVLRQ ��

ΖQWHQGHG DXGLHQFH

7KLV GRFXPHQW ZLOO SUREDEO\ ILW EHVW IRU UHDGHUV WKDW KDYH DEDFNJURXQG VLPLODU WR P\ RZQ� H[SHULHQFHG ZLWK DW OHDVW RQHREMHFW�RULHQWHG ODQJXDJH OLNH 5XE\� 3\WKRQ� 3+3 RU -DYD� RQO\OLWWOH H[SHULHQFH ZLWK -DYD6FULSW� DQG FRPSOHWHO\ QHZ WR 1RGH�MV�

$LPLQJ DW GHYHORSHUV WKDW DOUHDG\ KDYH H[SHULHQFH ZLWK RWKHUSURJUDPPLQJ ODQJXDJHV PHDQV WKDW WKLV GRFXPHQW ZRQ٧W FRYHUUHDOO\ EDVLF VWXII OLNH GDWD W\SHV� YDULDEOHV� FRQWURO VWUXFWXUHV DQGWKH OLNHV� <RX DOUHDG\ QHHG WR NQRZ DERXW WKHVH WR XQGHUVWDQGWKLV GRFXPHQW�

�

$ERXW �

+RZHYHU� EHFDXVH IXQFWLRQV DQG REMHFWV LQ -DYD6FULSW DUH GLIIHU�HQW IURP WKHLU FRXQWHUSDUWV LQ PRVW RWKHU ODQJXDJHV� WKHVH ZLOOEH H[SODLQHG LQ PRUH GHWDLO�

6WUXFWXUH RI WKLV GRFXPHQW

8SRQ ILQLVKLQJ WKLV GRFXPHQW� \RX ZLOO KDYH FUHDWHG D FRPSOHWHZHE DSSOLFDWLRQ ZKLFK DOORZV WKH XVHUV RI WKLV DSSOLFDWLRQ WRYLHZ ZHE SDJHV DQG XSORDG ILOHV�

:KLFK� RI FRXUVH� LV QRW H[DFWO\ ZRUOG�FKDQJLQJ� EXW ZH ZLOOJR VRPH H[WUD PLOHV DQG QRW RQO\ FUHDWH WKH FRGH WKDW LV ٪MXVWHQRXJK٫ WR PDNH WKHVH XVH FDVHV SRVVLEOH� EXW FUHDWH D VLPSOH�\HW FRPSOHWH IUDPHZRUN WR FOHDQO\ VHSDUDWH WKH GLIIHUHQW DVSHFWVRI RXU DSSOLFDWLRQ� <RX ZLOO VHH ZKDW , PHDQ LQ D PLQXWH�

:H ZLOO VWDUW ZLWK ORRNLQJ DW KRZ -DYD6FULSW GHYHORSPHQW LQ1RGH�MV LV GLIIHUHQW IURP -DYD6FULSW GHYHORSPHQW LQ D EURZVHU�

1H[W� ZH ZLOO VWD\ ZLWK WKH JRRG ROG WUDGLWLRQ RI ZULWLQJ D ٪+HOOR:RUOG٫ DSSOLFDWLRQ� ZKLFK LV D PRVW EDVLF 1RGH�MV DSSOLFDWLRQWKDW ٪GRHV٫ VRPHWKLQJ�

7KHQ� ZH ZLOO GLVFXVV ZKDW NLQG RI ٪UHDO٫ DSSOLFDWLRQ ZH ZDQW WREXLOG� GLVVHFW WKH GLIIHUHQW SDUWV ZKLFK QHHG WR EH LPSOHPHQWHGWR DVVHPEOH WKLV DSSOLFDWLRQ� DQG VWDUW ZRUNLQJ RQ HDFK RI WKHVHSDUWV VWHS�E\�VWHS�

$V SURPLVHG� DORQJ WKHZD\ZHZLOO OHDUQ DERXW VRPH RI WKHPRUHDGYDQFHG FRQFHSWV RI -DYD6FULSW� KRZ WR PDNH XVH RI WKHP� DQGORRN DW ZK\ LW PDNHV VHQVH WR XVH WKHVH FRQFHSWV LQVWHDG RI WKRVHZH NQRZ IURP RWKHU SURJUDPPLQJ ODQJXDJHV�

-DYD6FULSW DQG 1RGH�MV

-DYD6FULSW DQG <RX

%HIRUH ZH WDON DERXW DOO WKH WHFKQLFDO VWXII� OHW٧V WDNH D PRPHQWDQG WDON DERXW \RX DQG \RXU UHODWLRQVKLS ZLWK -DYD6FULSW� 7KLVFKDSWHU LV KHUH WR DOORZ \RX WR HVWLPDWH LI UHDGLQJ WKLV GRFXPHQWDQ\ IXUWKHU PDNHV VHQVH IRU \RX�

,I \RX DUH OLNH PH� \RX VWDUWHG ZLWK +70/ ٪GHYHORSPHQW٫ ORQJDJR� E\ ZULWLQJ +70/ GRFXPHQWV� <RX FDPH DORQJ WKLV IXQQ\WKLQJ FDOOHG -DYD6FULSW� EXW \RX RQO\ XVHG LW LQ D YHU\ EDVLF ZD\�DGGLQJ LQWHUDFWLYLW\ WR \RXU ZHE SDJHV HYHU\ QRZ DQG WKHQ�

:KDW \RX UHDOO\ ZDQWHG ZDV ٪WKH UHDO WKLQJ٫� \RX ZDQWHG WRNQRZ KRZ WR EXLOG FRPSOH[ ZHE VLWHV � \RX OHDUQHG D SUR�JUDPPLQJ ODQJXDJH OLNH 3+3� 5XE\� -DYD� DQG VWDUWHG ZULWLQJ٪EDFNHQG٫ FRGH�

1HYHUWKHOHVV� \RX NHSW DQ H\H RQ -DYD6FULSW� \RX VDZ WKDW ZLWKWKH LQWURGXFWLRQ RI M4XHU\� 3URWRW\SH DQG WKH OLNHV� WKLQJV JRWPRUH DGYDQFHG LQ -DYD6FULSW ODQG� DQG WKDW WKLV ODQJXDJH UHDOO\ZDV DERXW PRUH WKDQ ZLQGRZ�RSHQ��

+RZHYHU� WKLV ZDV DOO VWLOO IURQWHQG VWXII� DQG DOWKRXJK LW ZDV QLFHWR KDYH M4XHU\ DW \RXU GLVSRVDO ZKHQHYHU \RX IHOW OLNH VSLFLQJ XSD ZHE SDJH� DW WKH HQG RI WKH GD\ \RX ZHUH� DW EHVW� D -DYD6FULSWXVHU� EXW QRW D -DYD6FULSW GHYHORSHU�

$QG WKHQ FDPH 1RGH�MV� -DYD6FULSW RQ WKH VHUYHU� KRZ FRRO LVWKDW"

�

-DYD6FULSW DQG 1RGH�MV �

<RX GHFLGHG WKDW LW٧V DERXW WLPH WR FKHFN RXW WKH ROG� QHZ-DYD6FULSW� %XW ZDLW� ZULWLQJ 1RGH�MV DSSOLFDWLRQV LV WKH RQHWKLQJ� XQGHUVWDQGLQJ ZK\ WKH\ QHHG WR EH ZULWWHQ WKH ZD\ WKH\DUH ZULWWHQ PHDQV � XQGHUVWDQGLQJ -DYD6FULSW� $QG WKLV WLPH IRUUHDO�

+HUH LV WKH SUREOHP� %HFDXVH -DYD6FULSW UHDOO\ OLYHV WZR� PD\EHHYHQ WKUHH OLYHV �WKH IXQQ\ OLWWOH '+07/ KHOSHU IURP WKH PLG��٧V� WKH PRUH VHULRXV IURQWHQG VWXII OLNH M4XHU\ DQG WKH OLNHV�DQG QRZ VHUYHU�VLGH�� LW٧V QRW WKDW HDV\ WR ILQG LQIRUPDWLRQ WKDWKHOSV \RX WR OHDUQ -DYD6FULSW WKH ٪ULJKW٫ ZD\� LQ RUGHU WR ZULWH1RGH�MV DSSOLFDWLRQV LQ D IDVKLRQ WKDW PDNHV \RX IHHO \RX DUH QRWMXVW XVLQJ -DYD6FULSW� \RX DUH DFWXDOO\ GHYHORSLQJ LW�

%HFDXVH WKDW٧V WKH FDWFK� \RX DOUHDG\ DUH DQ H[SHULHQFHG GHYHO�RSHU� \RX GRQ٧W ZDQW WR OHDUQ D QHZ WHFKQLTXH E\ MXVW KDFNLQJDURXQG DQG PLV�XVLQJ LW� \RX ZDQW WR EH VXUH WKDW \RX DUHDSSURDFKLQJ LW IURP WKH ULJKW DQJOH�

7KHUH LV� RI FRXUVH� H[FHOOHQW GRFXPHQWDWLRQ RXW WKHUH� %XWGRFXPHQWDWLRQ DORQH VRPHWLPHV LVQ٧W HQRXJK� :KDW LV QHHGHGLV JXLGDQFH�

0\ JRDO LV WR SURYLGH D JXLGH IRU \RX�

$ ZRUG RI ZDUQLQJ

7KHUH DUH VRPH UHDOO\ H[FHOOHQW -DYD6FULSW SHRSOH RXW WKHUH� ,٧PQRW RQH RI WKHP�

,٧P UHDOO\ MXVW WKH JX\ , WDONHG DERXW LQ WKH SUHYLRXV SDUDJUDSK� ,NQRZ D WKLQJ RU WZR DERXW GHYHORSLQJ EDFNHQG ZHE DSSOLFDWLRQV�EXW ,٧P VWLOO QHZ WR ٪UHDO٫ -DYD6FULSW DQG VWLOO QHZ WR 1RGH�MV� ,


OHDUQHG VRPH RI WKH PRUH DGYDQFHG DVSHFWV RI -DYD6FULSW MXVWUHFHQWO\� ,٧P QRW H[SHULHQFHG�

:KLFK LV ZK\ WKLV LV QR ٪IURP QRYLFH WR H[SHUW٫ ERRN� ,W٧V PRUHOLNH ٪IURP QRYLFH WR DGYDQFHG QRYLFH٫�

,I , GRQ٧W IDLO� WKHQ WKLV ZLOO EH WKH NLQG RI GRFXPHQW , ZLVK , KDGZKHQ VWDUWLQJ ZLWK 1RGH�MV�

6HUYHU�VLGH -DYD6FULSW

7KH ILUVW LQFDUQDWLRQV RI -DYD6FULSW OLYHG LQ EURZVHUV� %XW WKLV LVMXVW WKH FRQWH[W� ,W GHILQHV ZKDW \RX FDQ GR ZLWK WKH ODQJXDJH�EXW LW GRHVQ٧W VD\ PXFK DERXW ZKDW WKH ODQJXDJH LWVHOI FDQ GR�-DYD6FULSW LV D ٪FRPSOHWH٫ ODQJXDJH� \RX FDQ XVH LW LQ PDQ\FRQWH[WV DQG DFKLHYH HYHU\WKLQJ ZLWK LW \RX FDQ DFKLHYH ZLWKDQ\ RWKHU ٪FRPSOHWH٫ ODQJXDJH�

1RGH�MV UHDOO\ LV MXVW DQRWKHU FRQWH[W� LW DOORZV \RX WR UXQ-DYD6FULSW FRGH LQ WKH EDFNHQG� RXWVLGH D EURZVHU�

,Q RUGHU WR H[HFXWH WKH -DYD6FULSW \RX LQWHQG WR UXQ LQ WKHEDFNHQG� LW QHHGV WR EH LQWHUSUHWHG DQG� ZHOO� H[HFXWHG� 7KLV LVZKDW 1RGH�MV GRHV� E\ PDNLQJ XVH RI *RRJOH٧V 9� 90� WKH VDPHUXQWLPH HQYLURQPHQW IRU -DYD6FULSW WKDW *RRJOH &KURPH XVHV�

3OXV� 1RGH�MV VKLSVZLWK D ORW RI XVHIXO PRGXOHV� VR \RX GRQ٧W KDYHWRZULWH HYHU\WKLQJ IURP VFUDWFK� OLNH IRU H[DPSOH VRPHWKLQJ WKDWRXWSXWV D VWULQJ RQ WKH FRQVROH�

7KXV� 1RGH�MV LV UHDOO\ WZR WKLQJV� D UXQWLPH HQYLURQPHQW DQG DOLEUDU\�


,Q RUGHU WR PDNH XVH RI WKHVH� \RX QHHG WR LQVWDOO 1RGH�MV� ,QVWHDGRI UHSHDWLQJ WKH SURFHVV KHUH� , NLQGO\ DVN \RX WR YLVLW WKH RIILFLDOLQVWDOODWLRQ LQVWUXFWLRQV{� 3OHDVH FRPH EDFN RQFH \RX DUH XS DQGUXQQLQJ�

Ȋ+HOOR :RUOGȋ

2N� OHW٧V MXVW MXPS LQ WKH FROG ZDWHU DQG ZULWH RXU ILUVW 1RGH�MVDSSOLFDWLRQ� ٪+HOOR :RUOG٫�

2SHQ \RXU IDYRULWH HGLWRU DQG FUHDWH D ILOH FDOOHG KHOORZRUOG�MV�:H ZDQW LW WR ZULWH ٪+HOOR :RUOG٫ WR 67'287� DQG KHUH LV WKHFRGH QHHGHG WR GR WKDW�

DPOTPMF�MPHá)FMMP 8PSMEá�

6DYH WKH ILOH� DQG H[HFXWH LW WKURXJK 1RGH�MV�

OPEF IFMMPXPSME�KT

7KLV VKRXOG RXWSXW +HOOR :RUOG RQ \RXU WHUPLQDO�

2N� WKLV VWXII LV ERULQJ� ULJKW" /HW٧V ZULWH VRPH UHDO VWXII�

{KWWSV��JLWKXE�FRP�MR\HQW�QRGH�ZLNL�,QVWDOODWLRQ

https://github.com/joyent/node/wiki/Installation



$ IXOO EORZQ ZHEDSSOLFDWLRQ ZLWK 1RGH�MV

7KH XVH FDVHV

/HW٧V NHHS LW VLPSOH� EXW UHDOLVWLF�

7KH XVHU VKRXOG EH DEOH WR XVH RXU DSSOLFDWLRQ ZLWK D ZHEEURZVHU

7KH XVHU VKRXOG VHH D ZHOFRPH SDJH ZKHQ UHTXHVWLQJKWWS��GRPDLQ�VWDUW ZKLFK GLVSOD\V D ILOH XSORDG IRUP

%\ FKRRVLQJ DQ LPDJH ILOH WR XSORDG DQG VXEPLWWLQJ WKHIRUP� WKLV LPDJH VKRXOG WKHQ EH XSORDGHG WR KWWS��GRPDLQ�XSORDG�ZKHUH LW LV GLVSOD\HG RQFH WKH XSORDG LV ILQLVKHG

)DLU HQRXJK� 1RZ� \RX FRXOG DFKLHYH WKLV JRDO E\ JRRJOLQJ DQGKDFNLQJ WRJHWKHU VRPHWKLQJ� %XW WKDW٧V QRW ZKDW ZH ZDQW WR GRKHUH�

)XUWKHUPRUH� ZH GRQ٧W ZDQW WR ZULWH RQO\ WKH PRVW EDVLF FRGHWR DFKLHYH WKH JRDO� KRZHYHU HOHJDQW DQG FRUUHFW WKLV FRGH PLJKWEH� :H ZLOO LQWHQWLRQDOO\ DGG PRUH DEVWUDFWLRQ WKDQ QHFHVVDU\LQ RUGHU WR JHW D IHHOLQJ IRU EXLOGLQJ PRUH FRPSOH[ 1RGH�MVDSSOLFDWLRQV�

�

$ IXOO EORZQ ZHE DSSOLFDWLRQ ZLWK 1RGH�MV �

7KH DSSOLFDWLRQ VWDFN

/HW٧V GLVVHFW RXU DSSOLFDWLRQ� :KLFK SDUWV QHHG WR EH LPSOH�PHQWHG LQ RUGHU WR IXOILOO WKH XVH FDVHV"

:H ZDQW WR VHUYH ZHE SDJHV� WKHUHIRUH ZH QHHG DQ +773VHUYHU

2XU VHUYHU ZLOO QHHG WR DQVZHU GLIIHUHQWO\ WR UHTXHVWV�GHSHQGLQJ RQ ZKLFK 85/ WKH UHTXHVW ZDV DVNLQJ IRU� WKXVZH QHHG VRPH NLQG RI URXWHU LQ RUGHU WR PDS UHTXHVWV WRUHTXHVW KDQGOHUV

7R IXOOILOO WKH UHTXHVWV WKDW DUULYHG DW WKH VHUYHU DQG KDYHEHHQ URXWHG XVLQJ WKH URXWHU� ZH QHHG DFWXDO UHTXHVWKDQGOHUV

7KH URXWHU SUREDEO\ VKRXOG DOVR WUHDW DQ\ LQFRPLQJ 3267GDWD DQG JLYH LW WR WKH UHTXHVW KDQGOHUV LQ D FRQYHQLHQWIRUP� WKXV ZH QHHG UHTXHVW GDWD KDQGOLQJ

:H QRW RQO\ ZDQW WR KDQGOH UHTXHVWV IRU 85/V� ZH DOVRZDQW WR GLVSOD\ FRQWHQW ZKHQ WKHVH 85/V DUH UHTXHVWHG�ZKLFKPHDQV ZH QHHG VRPH NLQG RI YLHZ ORJLF WKH UHTXHVWKDQGOHUV FDQ XVH LQ RUGHU WR VHQG FRQWHQW WR WKH XVHU٧VEURZVHU

/DVW EXW QRW OHDVW� WKH XVHU ZLOO EH DEOH WR XSORDG LPDJHV�VR ZH DUH JRLQJ WR QHHG VRPH NLQG RI XSORDG KDQGOLQJZKLFK WDNHV FDUH RI WKH GHWDLOV

/HW٧V WKLQN D PRPHQW DERXW KRZ ZH ZRXOG EXLOG WKLV VWDFN ZLWK3+3� ,W٧V QRW H[DFWO\ D VHFUHW WKDW WKH W\SLFDO VHWXS ZRXOG EH DQ$SDFKH +773 VHUYHU ZLWK PRGBSKS� LQVWDOOHG�:KLFK LQ WXUQ PHDQV WKDW WKH ZKROH ٪ZH QHHG WR EH DEOH WR VHUYH

$ IXOO EORZQ ZHE DSSOLFDWLRQ ZLWK 1RGH�MV �

ZHE SDJHV DQG UHFHLYH +773 UHTXHVWV٫ VWXII GRHVQ٧W KDSSHQZLWKLQ 3+3 LWVHOI�

:HOO� ZLWK QRGH� WKLQJV DUH D ELW GLIIHUHQW� %HFDXVH ZLWK 1RGH�MV�ZH QRW RQO\ LPSOHPHQW RXU DSSOLFDWLRQ� ZH DOVR LPSOHPHQW WKHZKROH +773 VHUYHU� ,Q IDFW� RXU ZHE DSSOLFDWLRQ DQG LWV ZHEVHUYHU DUH EDVLFDOO\ WKH VDPH�

7KLV PLJKW VRXQG OLNH D ORW RI ZRUN� EXW ZH ZLOO VHH LQ D PRPHQWWKDW ZLWK 1RGH�MV� LW٧V QRW�

/HW٧V MXVW VWDUW DW WKH EHJLQQLQJ DQG LPSOHPHQW WKH ILUVW SDUW RIRXU VWDFN� WKH +773 VHUYHU�

%XLOGLQJ WKH DSSOLFDWLRQVWDFN

$ EDVLF +773 VHUYHU

:KHQ , DUULYHG DW WKH SRLQW ZKHUH , ZDQWHG WR VWDUW ZLWK P\ ILUVW٪UHDO٫ 1RGH�MV DSSOLFDWLRQ� , ZRQGHUHG QRW RQO\ KRZ WR DFWXDOO\FRGH LW� EXW DOVR KRZ WR RUJDQL]H P\ FRGH�'R , QHHG WR KDYH HYHU\WKLQJ LQ RQH ILOH" 0RVW WXWRULDOV RQ WKHZHE WKDW WHDFK \RX KRZ WR ZULWH D EDVLF +773 VHUYHU LQ 1RGH�MVKDYH DOO WKH ORJLF LQ RQH SODFH� :KDW LI , ZDQW WR PDNH VXUH WKDWP\ FRGH VWD\V UHDGDEOH WKH PRUH VWXII , LPSOHPHQW"

7XUQV RXW� LW٧V UHODWLYHO\ HDV\ WR NHHS WKH GLIIHUHQW FRQFHUQV RI\RXU FRGH VHSDUDWHG� E\ SXWWLQJ WKHP LQ PRGXOHV�

7KLV DOORZV \RX WR KDYH D FOHDQ PDLQ ILOH� ZKLFK \RX H[HFXWHZLWK 1RGH�MV� DQG FOHDQ PRGXOHV WKDW FDQ EH XVHG E\ WKH PDLQILOH DQG DPRQJ HDFK RWKHU�

6R� OHW٧V FUHDWH D PDLQ ILOH ZKLFK ZH XVH WR VWDUW RXU DSSOLFDWLRQ�DQG D PRGXOH ILOH ZKHUH RXU +773 VHUYHU FRGH OLYHV�

0\ LPSUHVVLRQ LV WKDW LW٧V PRUH RU OHVV D VWDQGDUG WR QDPH \RXUPDLQ ILOH LQGH[�MV� ,W PDNHV VHQVH WR SXW RXU VHUYHU PRGXOH LQWRD ILOH QDPHG VHUYHU�MV�

/HW٧V VWDUW ZLWK WKH VHUYHU PRGXOH� &UHDWH WKH ILOH VHUYHU�MV LQ WKHURRW GLUHFWRU\ RI \RXU SURMHFW� DQG ILOO LW ZLWK WKH IROORZLQJ FRGH�

��

%XLOGLQJ WKH DSSOLFDWLRQ VWDFN ��

WBS IUUQ � SFRVJSFáIUUQá�

IUUQ�DSFBUF4FSWFSGVODUJPOSFRVFTU SFTQPOTF \

SFTQPOTF�XSJUF)FBE�� \á$POUFOU�5ZQFá� áUFYU�QMBJOá^�

SFTQPOTF�XSJUFá)FMMP 8PSMEá�

SFTQPOTF�FOE�

^�MJTUFO��

7KDW٧V LW� <RX MXVW ZURWH D ZRUNLQJ +773 VHUYHU� /HW٧V SURYH LWE\ UXQQLQJ DQG WHVWLQJ LW� )LUVW� H[HFXWH \RXU VFULSW ZLWK 1RGH�MV�

OPEF TFSWFS�KT

1RZ� RSHQ \RXU EURZVHU DQG SRLQW LW DW KWWS��ORFDOKRVW��t�7KLV VKRXOG GLVSOD\ D ZHE SDJH WKDW VD\V ٪+HOOR :RUOG٫�

7KDW٧V TXLWH LQWHUHVWLQJ� LVQ٧W LW� +RZ DERXW WDONLQJ DERXW ZKDW٧VJRLQJ RQ KHUH DQG OHDYLQJ WKH TXHVWLRQ RI KRZ WR RUJDQL]H RXUSURMHFW IRU ODWHU" , SURPLVH ZH٧OO JHW EDFN WR LW�

$QDO\]LQJ RXU +773 VHUYHU

:HOO� WKHQ� OHW٧V DQDO\]H ZKDW٧V DFWXDOO\ JRLQJ RQ KHUH�

7KH ILUVW OLQH UHTXLUHV WKH KWWS PRGXOH WKDW VKLSV ZLWK 1RGH�MVDQG PDNHV LW DFFHVVLEOH WKURXJK WKH YDULDEOH KWWS�

:H WKHQ FDOO RQH RI WKH IXQFWLRQV WKH KWWS PRGXOH RIIHUV� FUH�DWH6HUYHU� 7KLV IXQFWLRQ UHWXUQV DQ REMHFW� DQG WKLV REMHFW KDV D

tKWWS��ORFDOKRVW��

http://localhost:8888/



PHWKRG QDPHG OLVWHQ� DQG WDNHV D QXPHULF YDOXH ZKLFK LQGLFDWHVWKH SRUW QXPEHU RXU +773 VHUYHU LV JRLQJ WR OLVWHQ RQ�

3OHDVH LJQRUH IRU D VHFRQG WKH IXQFWLRQ GHILQLWLRQ WKDW IROORZVWKH RSHQLQJ EUDFNHW RI KWWS�FUHDWH6HUYHU�

:H FRXOG KDYH ZULWWHQ WKH FRGH WKDW VWDUWV RXU VHUYHU DQG PDNHVLW OLVWHQ DW SRUW �� OLNH WKLV�


WBS TFSWFS � IUUQ�DSFBUF4FSWFS�

TFSWFS�MJTUFO��

7KDW ZRXOG VWDUW DQ +773 VHUYHU OLVWHQLQJ DW SRUW �� DQG GRLQJQRWKLQJ HOVH �QRW HYHQ DQVZHULQJ DQ\ LQFRPLQJ UHTXHVWV��

7KH UHDOO\ LQWHUHVWLQJ �DQG� LI \RXU EDFNJURXQG LV D PRUH FRQ�VHUYDWLYH ODQJXDJH OLNH 3+3� RGG ORRNLQJ� SDUW LV WKH IXQFWLRQGHILQLWLRQ ULJKW WKHUH ZKHUH \RXZRXOG H[SHFW WKH ILUVW SDUDPHWHURI WKH FUHDWH6HUYHU�� FDOO�

7XUQV RXW� WKLV IXQFWLRQ GHILQLWLRQ ,6 WKH ILUVW �DQG RQO\� SDUDPH�WHU ZH DUH JLYLQJ WR WKH FUHDWH6HUYHU�� FDOO� %HFDXVH LQ -DYD6FULSW�IXQFWLRQV FDQ EH SDVVHG DURXQG OLNH DQ\ RWKHU YDOXH�

3DVVLQJ IXQFWLRQV DURXQG

<RX FDQ� IRU H[DPSOH� GR VRPHWKLQJ OLNH WKLV�


GVODUJPO TBZXPSE \

DPOTPMF�MPHXPSE�

^

GVODUJPO FYFDVUFTPNF'VODUJPO WBMVF \

TPNF'VODUJPOWBMVF�

^

FYFDVUFTBZ á)FMMPá�

5HDG WKLV FDUHIXOO\� :KDW ZH DUH GRLQJ KHUH LV� ZH SDVV WKHIXQFWLRQ VD\ DV WKH ILUVW SDUDPHWHU WR WKH H[HFXWH IXQFWLRQ� 1RWWKH UHWXUQ YDOXH RI VD\� EXW VD\ LWVHOI�

7KXV� VD\ EHFRPHV WKH ORFDO YDULDEOH VRPH)XQFWLRQ ZLWKLQ H[H�FXWH� DQG H[HFXWH FDQ FDOO WKH IXQFWLRQ LQ WKLV YDULDEOH E\ LVVXLQJVRPH)XQFWLRQ�� DGGLQJ EUDFNHWV��

2I FRXUVH� EHFDXVH VD\ WDNHV RQH SDUDPHWHU� H[HFXWH FDQ SDVVVXFK D SDUDPHWHU ZKHQ FDOOLQJ VRPH)XQFWLRQ�

:H FDQ� DV ZH MXVW GLG� SDVV D IXQFWLRQ DV D SDUDPHWHU WR DQRWKHUIXQFWLRQ E\ LWV QDPH� %XW ZH GRQ٧W KDYH WR WDNH WKLV LQGLUHFWLRQ RIILUVW GHILQLQJ� WKHQ SDVVLQJ LW � ZH FDQ GHILQH DQG SDVV D IXQFWLRQDV D SDUDPHWHU WR DQRWKHU IXQFWLRQ LQ�SODFH�

GVODUJPO FYFDVUFTPNF'VODUJPO WBMVF \

TPNF'VODUJPOWBMVF�

^

FYFDVUFGVODUJPOXPSE\ DPOTPMF�MPHXPSE ^ á)FMMPá�


:H GHILQH WKH IXQFWLRQ ZH ZDQW WR SDVV WR H[HFXWH ULJKW WKHUH DWWKH SODFH ZKHUH H[HFXWH H[SHFWV LWV ILUVW SDUDPHWHU�

7KLV ZD\� ZH GRQ٧W HYHQ QHHG WR JLYH WKH IXQFWLRQ D QDPH� ZKLFKLV ZK\ WKLV LV FDOOHG DQ DQRQ\PRXV IXQFWLRQ�

7KLV LV D ILUVW JOLPSVH DW ZKDW , OLNH WR FDOO ٪DGYDQFHG٫ -DYD6FULSW�EXW OHW٧V WDNH LW VWHS E\ VWHS� )RU QRZ� OHW٧V MXVW DFFHSW WKDW LQ-DYD6FULSW� ZH FDQ SDVV D IXQFWLRQ DV D SDUDPHWHU ZKHQ FDOOLQJDQRWKHU IXQFWLRQ� :H FDQ GR WKLV E\ DVVLJQLQJ RXU IXQFWLRQ WR DYDULDEOH� ZKLFK ZH WKHQ SDVV� RU E\ GHILQLQJ WKH IXQFWLRQ WR SDVVLQ�SODFH�

+RZ IXQFWLRQ SDVVLQJ PDNHV RXU +773VHUYHU ZRUN

:LWK WKLV NQRZOHGJH� OHW٧V JHW EDFN WR RXU PLQLPDOLVWLF +773VHUYHU�


IUUQ�DSFBUF4FSWFSGVODUJPOSFRVFTU SFTQPOTF \



SFTQPOTF�FOE�

^�MJTUFO��

%\ QRZ LW VKRXOG EH FOHDU ZKDW ZH DUH DFWXDOO\ GRLQJ KHUH� ZHSDVV WKH FUHDWH6HUYHU IXQFWLRQ DQ DQRQ\PRXV IXQFWLRQ�

:H FRXOG DFKLHYH WKH VDPH E\ UHIDFWRULQJ RXU FRGH WR�



GVODUJPO PO3FRVFTUSFRVFTU SFTQPOTF \



SFTQPOTF�FOE�

^

IUUQ�DSFBUF4FSWFSPO3FRVFTU�MJTUFO��

0D\EH QRZ LV D JRRG PRPHQW WR DVN� :K\ DUH ZH GRLQJ LW WKDWZD\"

(YHQW�GULYHQ DV\QFKURQRXV FDOOEDFNV

7R XQGHUVWDQG ZK\ 1RGH�MV DSSOLFDWLRQV KDYH WR EH ZULWWHQ WKLVZD\� ZH QHHG WR XQGHUVWDQG KRZ 1RGH�MV H[HFXWHV RXU FRGH�1RGH٧V DSSURDFK LVQ٧W XQLTXH� EXW WKH XQGHUO\LQJ H[HFXWLRQPRGHO LV GLIIHUHQW IURP UXQWLPH HQYLURQPHQWV OLNH 3\WKRQ� 5XE\�3+3 RU -DYD�

/HW٧V WDNH D YHU\ VLPSOH SLHFH RI FRGH OLNH WKLV�

WBS SFTVMU � EBUBCBTF�RVFSZá4&-&$5 � '30. IVHFUBCMFá�


3OHDVH LJQRUH IRU QRZ WKDW ZH KDYHQ٧W DFWXDOO\ WDONHG DERXWFRQQHFWLQJ WR GDWDEDVHV EHIRUH � LW٧V MXVW DQ H[DPSOH� 7KH ILUVWOLQH TXHULHV D GDWDEDVH IRU ORWV RI URZV� WKH VHFRQG OLQH SXWV٪+HOOR :RUOG٫ WR WKH FRQVROH�


/HW٧V DVVXPH WKDW WKH GDWDEDVH TXHU\ LV UHDOO\ VORZ� WKDW LW KDV WRUHDG DQ DZIXO ORW RI URZV� ZKLFK WDNHV VHYHUDO VHFRQGV�

7KH ZD\ ZH KDYH ZULWWHQ WKLV FRGH� WKH -DYD6FULSW LQWHUSUHWHU RI1RGH�MV ILUVW KDV WR UHDG WKH FRPSOHWH UHVXOW VHW IURP WKH GDWDEDVH�DQG WKHQ LW FDQ H[HFXWH WKH FRQVROH�ORJ�� IXQFWLRQ�

,I WKLV SLHFH RI FRGH DFWXDOO\ ZDV� VD\� 3+3� LW ZRXOG ZRUN WKHVDPH ZD\� UHDG DOO WKH UHVXOWV DW RQFH� WKHQ H[HFXWH WKH QH[W OLQHRI FRGH� ,I WKLV FRGH ZRXOG EH SDUW RI D ZHE SDJH VFULSW� WKH XVHUZRXOG KDYH WR ZDLW VHYHUDO VHFRQGV IRU WKH SDJH WR ORDG�

+RZHYHU� LQ WKH H[HFXWLRQ PRGHO RI 3+3� WKLV ZRXOG QRW EHFRPHD ٪JOREDO٫ SUREOHP� WKH ZHE VHUYHU VWDUWV LWV RZQ 3+3 SURFHVV IRUHYHU\ +773 UHTXHVW LW UHFHLYHV� ,I RQH RI WKHVH UHTXHVWV UHVXOWV LQWKH H[HFXWLRQ RI D VORZ SLHFH RI FRGH� LW UHVXOWV LQ D VORZ SDJH ORDGIRU WKLV SDUWLFXODU XVHU� EXW RWKHU XVHUV UHTXHVWLQJ RWKHU SDJHVZRXOG QRW EH DIIHFWHG�

7KH H[HFXWLRQ PRGHO RI 1RGH�MV LV GLIIHUHQW � WKHUH LV RQO\ RQHVLQJOH SURFHVV� ,I WKHUH LV D VORZ GDWDEDVH TXHU\ VRPHZKHUH LQWKLV SURFHVV� WKLV DIIHFWV WKH ZKROH SURFHVV � HYHU\WKLQJ FRPHV WRD KDOW XQWLO WKH VORZ TXHU\ KDV ILQLVKHG�

7R DYRLG WKLV� -DYD6FULSW� DQG WKHUHIRUH 1RGH�MV� LQWURGXFHV WKHFRQFHSW RI HYHQW�GULYHQ� DV\QFKURQRXV FDOOEDFNV� E\ XWLOL]LQJ DQHYHQW ORRS�

:H FDQ XQGHUVWDQG WKLV FRQFHSW E\ DQDO\]LQJ D UHZULWWHQ YHUVLRQRI RXU SUREOHPDWLF FRGH�


EBUBCBTF�RVFSZá4&-&$5 � '30. IVHFUBCMFá GVODUJPOSPXT \

WBS SFTVMU � SPXT�

^�


+HUH� LQVWHDG RI H[SHFWLQJ GDWDEDVH�TXHU\�� WR GLUHFWO\ UHWXUQD UHVXOW WR XV� ZH SDVV LW D VHFRQG SDUDPHWHU� DQ DQRQ\PRXVIXQFWLRQ�

,Q LWV SUHYLRXV IRUP� RXU FRGH ZDV V\QFKURQRXV� ILUVW GR WKHGDWDEDVH TXHU\� DQG RQO\ ZKHQ WKLV LV GRQH� WKHQ ZULWH WR WKHFRQVROH�

1RZ� 1RGH�MV FDQ KDQGOH WKH GDWDEDVH UHTXHVW DV\QFKURQRXVO\�3URYLGHG WKDW GDWDEDVH�TXHU\�� LV SDUW RI DQ DV\QFKURQRXV OL�EUDU\� WKLV LV ZKDW 1RGH�MV GRHV� MXVW DV EHIRUH� LW WDNHV WKH TXHU\DQG VHQGV LW WR WKH GDWDEDVH� %XW LQVWHDG RI ZDLWLQJ IRU LW WR EHILQLVKHG� LW PDNHV D PHQWDO QRWH WKDW VD\V ٪:KHQ DW VRPH SRLQWLQ WKH IXWXUH WKH GDWDEDVH VHUYHU LV GRQH DQG VHQGV WKH UHVXOW RIWKH TXHU\� WKHQ , KDYH WR H[HFXWH WKH DQRQ\PRXV IXQFWLRQ WKDWZDV SDVVHG WR GDWDEDVH�TXHU\��٫

7KHQ� LW LPPHGLDWHO\ H[HFXWHV FRQVROH�ORJ�� DQG DIWHUZDUGV� LWHQWHUV WKH HYHQW ORRS� 1RGH�MV FRQWLQXRXVO\ F\FOHV WKURXJK WKLVORRS DJDLQ DQG DJDLQ ZKHQHYHU WKHUH LV QRWKLQJ HOVH WR GR�ZDLWLQJ IRU HYHQWV� (YHQWV OLNH� H�J�� D VORZ GDWDEDVH TXHU\ ILQDOO\GHOLYHULQJ LWV UHVXOWV�

7KLV DOVR H[SODLQV ZK\ RXU +773 VHUYHU QHHGV D IXQFWLRQ LW FDQFDOO XSRQ LQFRPLQJ UHTXHVWV � LI 1RGH�MV ZRXOG VWDUW WKH VHUYHUDQG WKHQ MXVW SDXVH� ZDLWLQJ IRU WKH QH[W UHTXHVW� FRQWLQXLQJ RQO\ZKHQ LW DUULYHV� WKDW ZRXOG EH KLJKO\ LQHIILFHQW� ,I D VHFRQG XVHUUHTXHVWV WKH VHUYHU ZKLOH LW LV VWLOO VHUYLQJ WKH ILUVW UHTXHVW� WKDW


VHFRQG UHTXHVW FRXOG RQO\ EH DQVZHUHG DIWHU WKH ILUVW RQH LV GRQH� DV VRRQ DV \RX KDYH PRUH WKDQ D KDQGIXO RI +773 UHTXHVWV SHUVHFRQG� WKLV ZRXOGQ٧W ZRUN DW DOO�

,W٧V LPSRUWDQW WR QRWH WKDW WKLV DV\QFKURQRXV� VLQJOH�WKUHDGHG�HYHQW�GULYHQ H[HFXWLRQ PRGHO LVQ٧W DQ LQILQLWHO\ VFDODEOH SHU�IRUPDQFH XQLFRUQ ZLWK VLOYHU EXOOHWV DWWDFKHG� ,W LV MXVW RQH RIVHYHUDO PRGHOV� DQG LW KDV LWV OLPLWDWLRQV� RQH EHLQJ WKDW DV RIQRZ� 1RGH�MV LV MXVW RQH VLQJOH SURFHVV� DQG LW FDQ UXQ RQ RQO\ RQHVLQJOH &38 FRUH� 3HUVRQDOO\� , ILQG WKLV PRGHO TXLWH DSSURDFK�DEOH� EHFDXVH LW DOORZV WR ZULWH DSSOLFDWLRQV WKDW KDYH WR GHDOZLWK FRQFXUUHQF\ LQ DQ HIILFLHQW DQG UHODWLYHO\ VWUDLJKWIRUZDUGPDQQHU�

<RX PLJKW ZDQW WR WDNH WKH WLPH WR UHDG )HOL[ *HLVHQGRHUIHU٧VH[FHOOHQW SRVW 8QGHUVWDQGLQJ QRGH�MVu IRU DGGLWLRQDO EDFNJURXQGH[SODQDWLRQ�

/HW٧V SOD\ DURXQG D ELW ZLWK WKLV QHZ FRQFHSW� &DQ ZH SURYHWKDW RXU FRGH FRQWLQXHV DIWHU FUHDWLQJ WKH VHUYHU� HYHQ LI QR+773 UHTXHVW KDSSHQHG DQG WKH FDOOEDFN IXQFWLRQ ZH SDVVHGLVQ٧W FDOOHG" /HW٧V WU\ LW�

uKWWS��GHEXJJDEOH�FRP�SRVWV�XQGHUVWDQGLQJ�QRGH�MV��EG��H��D�D��HI��I�HFEGG��FE

http://debuggable.com/posts/understanding-node-js:4bd98440-45e4-4a9a-8ef7-0f7ecbdd56cb






DPOTPMF�MPHá3FRVFTU SFDFJWFE�á�



SFTQPOTF�FOE�

^


DPOTPMF�MPHá4FSWFS IBT TUBSUFE�á�

1RWH WKDW , XVH FRQVROH�ORJ WR RXWSXW D WH[W ZKHQHYHU WKH RQ5H�TXHVW IXQFWLRQ �RXU FDOOEDFN� LV WULJJHUHG� DQG DQRWKHU WH[W ULJKWDIWHU VWDUWLQJ WKH +773 VHUYHU�

:KHQZH VWDUW WKLV �QRGH VHUYHU�MV� DV DOZD\V�� LW ZLOO LPPHGLDWHO\RXWSXW ٪6HUYHU KDV VWDUWHG�٫ RQ WKH FRPPDQG OLQH� :KHQHYHUZH UHTXHVW RXU VHUYHU �E\ RSHQLQJ KWWS��ORFDOKRVW�ڏ�� LQ RXUEURZVHU�� WKH PHVVDJH ٪5HTXHVW UHFHLYHG�٫ LV SULQWHG RQ WKHFRPPDQG OLQH�

(YHQW�GULYHQ DV\QFKURQRXV VHUYHU�VLGH -DYD6FULSW ZLWK FDOOEDFNVLQ DFWLRQ ��

�1RWH WKDW RXU VHUYHU ZLOO SUREDEO\ ZULWH ٪5HTXHVW UHFHLYHG�٫WR 67'287 WZR WLPHV XSRQ RSHQLQJ WKH SDJH LQ D EURZVHU�7KDW٧V EHFDXVH PRVW EURZVHU ZLOO WU\ WR ORDG WKH IDYLFRQ E\UHTXHVWLQJ KWWS��ORFDOKRVW��IDYLFRQ�LFR ZKHQHYHU \RX RSHQKWWS��ORFDOKRVW��

�KWWSڏ��ORFDOKRVW��




+RZ RXU VHUYHU KDQGOHV UHTXHVWV

2N� OHW٧V TXLFNO\ DQDO\]H WKH UHVW RI RXU VHUYHU FRGH� WKDW LV� WKHERG\ RI RXU FDOOEDFN IXQFWLRQ RQ5HTXHVW��

:KHQ WKH FDOOEDFN ILUHV DQG RXU RQ5HTXHVW�� IXQFWLRQ JHWV WULJ�JHUHG� WZR SDUDPHWHUV DUH SDVVHG LQWR LW� UHTXHVW DQG UHVSRQVH�

7KRVH DUH REMHFWV� DQG \RX FDQ XVH WKHLU PHWKRGV WR KDQGOH WKHGHWDLOV RI WKH +773 UHTXHVW WKDW RFFXUHG DQG WR UHVSRQG WR WKHUHTXHVW �L�H�� WR DFWXDOO\ VHQG VRPHWKLQJ RYHU WKH ZLUH EDFN WR WKHEURZVHU WKDW UHTXHVWHG \RXU VHUYHU��

$QG RXU FRGH GRHV MXVW WKDW� :KHQHYHU D UHTXHVW LV UHFHLYHG� LWXVHV WKH UHVSRQVH�ZULWH+HDG�� IXQFWLRQ WR VHQG DQ +773 VWDWXV�� DQG FRQWHQW�W\SH LQ WKH +773 UHVSRQVH KHDGHU� DQG WKHUHVSRQVH�ZULWH�� IXQFWLRQ WR VHQG WKH WH[W ٪+HOOR :RUOG٫ LQ WKH+773 UHVSRQVH ERG\�

$W ODVW� ZH FDOO UHVSRQVH�HQG�� WR DFWXDOO\ ILQLVK RXU UHVSRQVH�

$W WKLV SRLQW� ZH GRQ٧W FDUH IRU WKH GHWDLOV RI WKH UHTXHVW� ZKLFKLV ZK\ ZH GRQ٧W XVH WKH UHTXHVW REMHFW DW DOO�

)LQGLQJ D SODFH IRU RXU VHUYHU PRGXOH

2N� , SURPLVHG ZH ZLOO JHW EDFN WR KRZ WR RUJDQL]H RXU DS�SOLFDWLRQ� :H KDYH WKH FRGH IRU D YHU\ EDVLF +773 VHUYHU LQWKH ILOH VHUYHU�MV� DQG , PHQWLRQHG WKDW LW٧V FRPPRQ WR KDYH DPDLQ ILOH FDOOHG LQGH[�MV ZKLFK LV XVHG WR ERRWVWUDS DQG VWDUW RXUDSSOLFDWLRQ E\PDNLQJ XVH RI WKH RWKHUPRGXOHV RI WKH DSSOLFDWLRQ�OLNH WKH +773 VHUYHU PRGXOH WKDW OLYHV LQ VHUYHU�MV��


/HW٧V WDON DERXW KRZ WR PDNH VHUYHU�MV D UHDO 1RGH�MV PRGXOH WKDWFDQ EH XVHG E\ RXU \HW�WR�EH�ZULWWHQ LQGH[�MV PDLQ ILOH�

$V \RX PD\ KDYH QRWLFHG� ZH DOUHDG\ XVHG PRGXOHV LQ RXU FRGH�OLNH WKLV�


��

IUUQ�DSFBUF4FSWFS��

6RPHZKHUH ZLWKLQ 1RGH�MV OLYHV D PRGXOH FDOOHG ٪KWWS٫� DQG ZHFDQ PDNH XVH RI LW LQ RXU RZQ FRGH E\ UHTXLULQJ LW DQG DVVLJQLQJWKH UHVXOW RI WKH UHTXLUH WR D ORFDO YDULDEOH�

7KLV PDNHV RXU ORFDO YDULDEOH DQ REMHFW WKDW FDUULHV DOO WKH SXEOLFPHWKRGV WKH KWWS PRGXOH SURYLGHV�

,W٧V FRPPRQ SUDFWLFH WR FKRRVH WKH QDPH RI WKH PRGXOH IRU WKHQDPH RI WKH ORFDO YDULDEOH� EXW ZH DUH IUHH WR FKRRVH ZKDWHYHUZH OLNH�

WBS GPP � SFRVJSFáIUUQá�

��

GPP�DSFBUF4FSWFS��

)LQH� LW٧V FOHDU KRZ WRPDNH XVH RI LQWHUQDO 1RGH�MV PRGXOHV� +RZGR ZH FUHDWH RXU RZQ PRGXOHV� DQG KRZ GR ZH XVH WKHP"


/HW٧V ILQG RXW E\ WXUQLQJ RXU VHUYHU�MV VFULSW LQWR D UHDO PRGXOH�

7XUQV RXW� ZH GRQ٧W KDYH WR FKDQJH WKDW PXFK� 0DNLQJ VRPHFRGH D PRGXOH PHDQV ZH QHHG WR H[SRUW WKRVH SDUWV RI LWVIXQFWLRQDOLW\ WKDW ZH ZDQW WR SURYLGH WR VFULSWV WKDW UHTXLUH RXUPRGXOH�

)RU QRZ� WKH IXQFWLRQDOLW\ RXU +773 VHUYHU QHHGV WR H[SRUW LVVLPSOH� VFULSWV UHTXLULQJ RXU VHUYHU PRGXOH VLPSO\ QHHG WR VWDUWWKH VHUYHU�

7R PDNH WKLV SRVVLEOH� ZH ZLOO SXW RXU VHUYHU FRGH LQWR D IXQFWLRQQDPHG VWDUW� DQG ZH ZLOO H[SRUW WKLV IXQFWLRQ�


GVODUJPO TUBSU \


DPOTPMF�MPHá3FRVFTU SFDFJWFE�á�



SFTQPOTF�FOE�

^



^

FYQPSUT�TUBSU � TUBSU�

7KLV ZD\� ZH FDQ QRZ FUHDWH RXU PDLQ ILOH LQGH[�MV� DQG VWDUWRXU +773 WKHUH� DOWKRXJK WKH FRGH IRU WKH VHUYHU LV VWLOO LQ RXUVHUYHU�MV ILOH�


&UHDWH D ILOH LQGH[�MV ZLWK WKH IROORZLQJ FRQWHQW�

WBS TFSWFS � SFRVJSFá��TFSWFSá�

TFSWFS�TUBSU�

$V \RX FDQ VHH� ZH FDQ XVH RXU VHUYHU PRGXOH MXVW OLNH DQ\LQWHUQDO PRGXOH� E\ UHTXLULQJ LWV ILOH DQG DVVLJQLQJ LW WR DYDULDEOH� LWV H[SRUWHG IXQFWLRQV EHFRPH DYDLODEOH WR XV�

7KDW٧V LW� :H FDQ QRZ VWDUW RXU DSS YLD RXU PDLQ VFULSW� DQG LWVWLOO GRHV H[DFWO\ WKH VDPH�

OPEF JOEFY�KT

*UHDW� ZH QRZ FDQ SXW WKH GLIIHUHQW SDUWV RI RXU DSSOLFDWLRQ LQWRGLIIHUHQW ILOHV DQG ZLUH WKHP WRJHWKHU E\ PDNLQJ WKHP PRGXOHV�

:H VWLOO KDYH RQO\ WKH YHU\ ILUVW SDUW RI RXU DSSOLFDWLRQ LQ SODFH�ZH FDQ UHFHLYH+773 UHTXHVWV� %XWZH QHHG WR GR VRPHWKLQJZLWKWKHP � GHSHQGLQJ RQ ZKLFK 85/ WKH EURZVHU UHTXHVWHG IURP RXUVHUYHU� ZH QHHG WR UHDFW GLIIHUHQWO\�

)RU D YHU\ VLPSOH DSSOLFDWLRQ� \RX FRXOG GR WKLV GLUHFWO\ ZLWKLQWKH FDOOEDFN IXQFWLRQ RQ5HTXHVW�� %XW DV , VDLG� OHW٧V DGG D ELWPRUH DEVWUDFWLRQ LQ RUGHU WR PDNH RXU H[DPSOH DSSOLFDWLRQ D ELWPRUH LQWHUHVWLQJ�

0DNLQJ GLIIHUHQW +773 UHTXHVWV SRLQW DW GLIIHUHQW SDUWV RI RXUFRGH LV FDOOHG ٪URXWLQJ٫ � ZHOO� WKHQ� OHW٧V FUHDWH D PRGXOH FDOOHGURXWHU�


:KDWȇV QHHGHG WR ȊURXWHȋ UHTXHVWV"

:H QHHG WR EH DEOH WR IHHG WKH UHTXHVWHG 85/ DQG SRVVLEOHDGGLWLRQDO *(7 DQG 3267 SDUDPHWHUV LQWR RXU URXWHU� DQG EDVHGRQ WKHVH WKH URXWHU WKHQ QHHGV WR EH DEOH WR GHFLGH ZKLFK FRGH WRH[HFXWH �WKLV ٪FRGH WR H[HFXWH٫ LV WKH WKLUG SDUW RI RXU DSSOLFDWLRQ�D FROOHFWLRQ RI UHTXHVW KDQGOHUV WKDW GR WKH DFWXDO ZRUN ZKHQ DUHTXHVW LV UHFHLYHG��

6R� ZH QHHG WR ORRN LQWR WKH +773 UHTXHVWV DQG H[WUDFW WKHUHTXHVWHG 85/ DV ZHOO DV WKH *(7�3267 SDUDPHWHUV IURP WKHP�,W FRXOG EH DUJXHG LI WKDW VKRXOG EH SDUW RI WKH URXWHU RU SDUW RIWKH VHUYHU �RU HYHQ D PRGXOH RI LWV RZQ�� EXW OHW٧V MXVW DJUHH RQPDNLQJ LW SDUW RI RXU +773 VHUYHU IRU QRZ�

$OO WKH LQIRUPDWLRQ ZH QHHG LV DYDLODEOH WKURXJK WKH UHTXHVWREMHFW ZKLFK LV SDVVHG DV WKH ILUVW SDUDPHWHU WR RXU FDOOEDFNIXQFWLRQ RQ5HTXHVW�� %XW WR LQWHUSUHW WKLV LQIRUPDWLRQ� ZH QHHGVRPH DGGLWLRQDO 1RGH�MV PRGXOHV� QDPHO\ XUO DQG TXHU\VWULQJ�

7KH XUO PRGXOH SURYLGHV PHWKRGV ZKLFK DOORZ XV WR H[WUDFW WKHGLIIHUHQW SDUWV RI D 85/ �OLNH H�J� WKH UHTXHVWHG SDWK DQG TXHU\VWULQJ�� DQG TXHU\VWULQJ FDQ LQ WXUQ EH XVHG WR SDUVH WKH TXHU\VWULQJ IRU UHTXHVW SDUDPHWHUV�


VSM�QBSTFTUSJOH�RVFSZ

]

VSM�QBSTFTUSJOH�QBUIOBNF ]

] ]

] ]

��

IUUQ��MPDBMIPTU��TUBSU GPP�CBS�IFMMP�XPSME

��

] ]

] ]

RVFSZTUSJOHTUSJOH<áGPPá> ]

]

RVFSZTUSJOHTUSJOH<áIFMMPá>

:H FDQ� RI FRXUVH� DOVR XVH TXHU\VWULQJ WR SDUVH WKH ERG\ RI D3267 UHTXHVW IRU SDUDPHWHUV� DV ZH ZLOO VHH ODWHU�

/HW٧V QRZ DGG WR RXU RQ5HTXHVW�� IXQFWLRQ WKH ORJLF QHHGHG WRILQG RXW ZKLFK 85/ SDWK WKH EURZVHU UHTXHVWHG�


WBS VSM � SFRVJSFáVSMá�

GVODUJPO TUBSU \


WBS QBUIOBNF � VSM�QBSTFSFRVFTU�VSM�QBUIOBNF�

DPOTPMF�MPHá3FRVFTU GPS á � QBUIOBNF � á SFDFJWFE�á�



SFTQPOTF�FOE�

^




^


)LQH� 2XU DSSOLFDWLRQ FDQ QRZ GLVWLQJXLVK UHTXHVWV EDVHG RQWKH 85/ SDWK UHTXHVWHG � WKLV DOORZV XV WR PDS UHTXHVWV WR RXUUHTXHVW KDQGOHUV EDVHG RQ WKH 85/ SDWK XVLQJ RXU �\HW WR EHZULWWHQ� URXWHU�

,Q WKH FRQWH[W RI RXU DSSOLFDWLRQ� LW VLPSO\ PHDQV WKDW ZH ZLOOEH DEOH WR KDYH UHTXHVWV IRU WKH �VWDUW DQG �XSORDG 85/V KDQGOHGE\ GLIIHUHQW SDUWV RI RXU FRGH� :H ZLOO VHH KRZ HYHU\WKLQJ ILWVWRJHWKHU VRRQ�

2N� LW٧V WLPH WR DFWXDOO\ ZULWH RXU URXWHU� &UHDWH D QHZ ILOH FDOOHGURXWHU�MV� ZLWK WKH IROORZLQJ FRQWHQW�

GVODUJPO SPVUFQBUIOBNF \

DPOTPMF�MPHá"CPVU UP SPVUF B SFRVFTU GPS á � QBUIOBNF�

^

FYQPSUT�SPVUF � SPVUF�

2I FRXUVH� WKLV FRGH EDVLFDOO\ GRHV QRWKLQJ� EXW WKDW٧V RN IRU QRZ�/HW٧V ILUVW VHH KRZ WR ZLUH WRJHWKHU WKLV URXWHU ZLWK RXU VHUYHUEHIRUH SXWWLQJ PRUH ORJLF LQWR WKH URXWHU�

2XU +773 VHUYHU QHHGV WR NQRZ DERXW DQG PDNH XVH RI RXUURXWHU� :H FRXOG KDUG�ZLUH WKLV GHSHQGHQF\ LQWR WKH VHUYHU�


EXW EHFDXVH ZH OHDUQHG WKH KDUG ZD\ IURP RXU H[SHULHQFH ZLWKRWKHU SURJUDPPLQJ ODQJXDJHV� ZH DUH JRLQJ WR ORRVHO\ FRXSOHVHUYHU DQG URXWHU E\ LQMHFWLQJ WKLV GHSHQGHQF\ �\RX PD\ ZDQWWR UHDG 0DUWLQ )RZOHUV H[FHOOHQW SRVW RQ 'HSHQGHQF\ ,QMHFWLRQڐIRU EDFNJURXQG LQIRUPDWLRQ��

/HW٧V ILUVW H[WHQG RXU VHUYHU٧V VWDUW�� IXQFWLRQ LQ RUGHU WR HQDEOHXV WR SDVV WKH URXWH IXQFWLRQ WR EH XVHG E\ SDUDPHWHU�



GVODUJPO TUBSUSPVUF \




SPVUFQBUIOBNF�



SFTQPOTF�FOE�

^



^


�KWWSڐ��PDUWLQIRZOHU�FRP�DUWLFOHV�LQMHFWLRQ�KWPO

http://martinfowler.com/articles/injection.html

http://martinfowler.com/articles/injection.html


$QG OHW٧V H[WHQG RXU LQGH[�MV DFFRUGLQJO\� WKDW LV� LQMHFWLQJ WKHURXWH IXQFWLRQ RI RXU URXWHU LQWR WKH VHUYHU�


WBS SPVUFS � SFRVJSFá��SPVUFSá�

TFSWFS�TUBSUSPVUFS�SPVUF�

$JDLQ� ZH DUH SDVVLQJ D IXQFWLRQ� ZKLFK E\ QRZ LVQ٧W DQ\ QHZVIRU XV�

,I ZH VWDUW RXU DSSOLFDWLRQ QRZ �QRGH LQGH[�MV� DV DOZD\V�� DQGUHTXHVW DQ 85/� \RX FDQ QRZ VHH IURP WKH DSSOLFDWLRQ٧V RXWSXWWKDW RXU +773 VHUYHU PDNHV XVH RI RXU URXWHU DQG SDVVHV LW WKHUHTXHVWHG SDWKQDPH�

CBTI� OPEF JOEFY�KT

3FRVFTU GPS �GPP SFDFJWFE�

"CPVU UP SPVUF B SFRVFTU GPS �GPP

�, RPLWWHG WKH UDWKHU DQQR\LQJ RXWSXW IRU WKH �IDYLFRQ�LFR UH�TXHVW��

([HFXWLRQ LQ WKH NLQJGRP RI YHUEV

0D\ , RQFH DJDLQ VWUD\ DZD\ IRU D ZKLOH DQG WDON DERXW IXQF�WLRQDO SURJUDPPLQJ DJDLQ"

3DVVLQJ IXQFWLRQV LV QRW RQO\ D WHFKQLFDO FRQVLGHUDWLRQ� :LWKUHJDUG WR VRIWZDUH GHVLJQ� LW٧V DOPRVW SKLORVRSKLFDO� -XVW WKLQN


DERXW LW� LQ RXU LQGH[ ILOH� ZH FRXOG KDYH SDVVHG WKH URXWHU REMHFWLQWR WKH VHUYHU� DQG WKH VHUYHU FRXOG KDYH FDOOHG WKLV REMHFW٧VURXWH IXQFWLRQ�

7KLV ZD\� ZH ZRXOG KDYH SDVVHG D WKLQJ� DQG WKH VHUYHU ZRXOGKDYH XVHG WKLV WKLQJ WR GR VRPHWKLQJ� +H\� URXWHU WKLQJ� FRXOG\RX SOHDVH URXWH WKLV IRU PH"

%XW WKH VHUYHU GRHVQ٧W QHHG WKH WKLQJ� ,W RQO\ QHHGV WR JHWVRPHWKLQJ GRQH� DQG WR JHW VRPHWKLQJ GRQH� \RX GRQ٧W QHHGWKLQJV DW DOO� \RX QHHG DFWLRQV� <RX GRQ٧W QHHG QRXQV� \RX QHHGYHUEV�

8QGHUVWDQGLQJ WKH IXQGDPHQWDO PLQG�VKLIW WKDW٧V DW WKH FRUHRI WKLV LGHD LV ZKDW PDGH PH UHDOO\ XQGHUVWDQG IXQFWLRQDOSURJUDPPLQJ�

$QG , GLG XQGHUVWDQG LW ZKHQ UHDGLQJ 6WHYH <HJJH٧V PDVWHUSLHFH([HFXWLRQ LQ WKH .LQJGRP RI 1RXQVڑ� *R UHDG LW QRZ� UHDOO\� ,W٧VRQH RI WKH EHVW ZULWLQJV UHODWHG WR VRIWZDUH , HYHU KDG WKH SOHDVXUHWR HQFRXQWHU�

5RXWLQJ WR UHDO UHTXHVW KDQGOHUV

%DFN WR EXVLQHVV� 2XU +773 VHUYHU DQG RXU UHTXHVW URXWHU DUHQRZ EHVW IULHQGV DQG WDON WR HDFK RWKHU DV ZH LQWHQGHG�

2I FRXUVH� WKDW٧V QRW HQRXJK� ٪5RXWLQJ٫ PHDQV� ZH ZDQW WRKDQGOH UHTXHVWV WR GLIIHUHQW 85/V GLIIHUHQWO\� :H ZRXOG OLNH WRKDYH WKH ٪EXVLQHVV ORJLF٫ IRU UHTXHVWV WR �VWDUW KDQGOHG LQ DQRWKHUIXQFWLRQ WKDQ UHTXHVWV WR �XSORDG�

�KWWSڑ��VWHYH�\HJJH�EORJVSRW�FRP��H[HFXWLRQ�LQ�NLQJGRP�RI�QRXQV�KWPO

http://steve-yegge.blogspot.com/2006/03/execution-in-kingdom-of-nouns.html

http://steve-yegge.blogspot.com/2006/03/execution-in-kingdom-of-nouns.html


5LJKW QRZ� WKH URXWLQJ ٪HQGV٫ LQ WKH URXWHU� DQG WKH URXWHU LV QRWWKH SODFH WR DFWXDOO\ ٪GR٫ VRPHWKLQJ ZLWK WKH UHTXHVWV� EHFDXVHWKDW ZRXOGQ٧W VFDOH ZHOO RQFH RXU DSSOLFDWLRQ EHFRPHV PRUHFRPSOH[�

/HW٧V FDOO WKHVH IXQFWLRQV� ZKHUH UHTXHVWV DUH URXWHG WR� UHTXHVWKDQGOHUV� $QG OHW٧V WDFNOH WKRVH QH[W� EHFDXVH XQOHVV ZH KDYHWKHVH LQ SODFH WKHUH LVQ٧W PXFK VHQVH LQ GRLQJ DQ\WKLQJ ZLWK WKHURXWHU IRU QRZ�

1HZ DSSOLFDWLRQ SDUW� QHZPRGXOH � QR VXUSULVH KHUH� /HW٧V FUHDWHD PRGXOH FDOOHG UHTXHVW+DQGOHUV� DGG D SODFHKROGHU IXQFWLRQIRU HYHU\ UHTXHVW KDQGOHU� DQG H[SRUW WKHVH DV PHWKRGV RI WKHPRGXOH�

GVODUJPO TUBSU \

DPOTPMF�MPHá3FRVFTU IBOEMFS �TUBSU� XBT DBMMFE�á�

^

GVODUJPO VQMPBE \

DPOTPMF�MPHá3FRVFTU IBOEMFS �VQMPBE� XBT DBMMFE�á�

^


FYQPSUT�VQMPBE � VQMPBE�

7KLV DOORZV XV WR ZLUH WKH UHTXHVW KDQGOHUV LQWR WKH URXWHU� JLYLQJRXU URXWHU VRPHWKLQJ WR URXWH WR�

$W WKLV SRLQW ZH QHHG WR PDNH D GHFLVLRQ� GR ZH KDUG�FRGHXVDJH RI WKH UHTXHVW+DQGOHUV PRGXOH LQWR WKH URXWHU� RU GR ZHZDQW D ELW PRUH GHSHQGHQF\ LQMHFWLRQ" $OWKRXJK GHSHQGHQF\


LQMHFWLRQ� OLNH HYHU\ RWKHU SDWWHUQ� VKRXOGQ٧W EH XVHG RQO\ IRU WKHVDNH RI XVLQJ LW� LQ WKLV FDVH LW PDNHV VHQVH WR ORRVHO\ FRXSOH WKHURXWHU DQG LWV UHTXHVW KDQGOHUV� DQG WKXV PDNLQJ WKH URXWHU UHDOO\UHXVDEOH�

7KLV PHDQV ZH QHHG WR SDVV WKH UHTXHVW KDQGOHUV IURP RXU VHUYHULQWR RXU URXWHU� EXW WKLV IHHOV HYHQ PRUH ZURQJ� ZKLFK LV ZK\ ZHVKRXOG JR WKH ZKROH ZD\ DQG SDVV WKHP WR WKH VHUYHU IURP RXUPDLQ ILOH� DQG SDVVLQJ LW RQ WR WKH URXWHU IURP WKHUH�

+RZ DUH ZH JRLQJ WR SDVV WKHP" 5LJKW QRZ ZH KDYH WZRKDQGOHUV� EXW LQ D UHDO DSSOLFDWLRQ� WKLV QXPEHU LV JRLQJ WRLQFUHDVH DQG YDU\� DQG ZH VXUH GRQ٧W ZDQW WR ILGGOH DURXQGPDSSLQJ UHTXHVWV WR KDQGOHUV LQ WKH URXWHU DQ\WLPH D QHZ 85/ �UHTXHVW KDQGOHU LV DGGHG� $QG KDYLQJ VRPH LI UHTXHVW [ WKHQFDOO KDQGOHU \ LQ WKH URXWHU ZRXOG EH PRUH WKDQ XJO\�

$ YDU\LQJ QXPEHU RI LWHPV� HDFK PDSSHG WR D VWULQJ �WKH UH�TXHVWHG 85/�" :HOO� VRXQGV OLNH DQ DVVRFLDWLYH DUUD\ ZRXOG EH DSHUIHFW ILW�

:HOO� WKLV ILQGLQJ LV VOLJKWO\ GLVDSSRLQWHG E\ WKH IDFW WKDW -DYD6FULSWGRHVQ٧W SURYLGH DVVRFLDWLYH DUUD\ � RU GRHV LW" 7XUQV RXW� LW٧VDFWXDOO\ REMHFWV WKDW ZH ZDQW WR XVH LI ZH QHHG DQ DVVRFLDWLYHDUUD\�

7KHUH٧V D QLFH LQWURGXFWLRQ WR WKLV DW KWWS��PVGQ�PLFURVRIW�FRP�HQ�XV�PDJD]LQH�FF��DVS[ڒ� OHW PH TXRWH WKH UHOHYDQW SDUW�

,Q &�� RU &�� ZKHQ ZH¤ێڷUH WDONLQJ DERXW REMHFWV�ZH٧UH UHIHUULQJ WR LQVWDQFHV RI FODVVHV RU VWUXFWV�

�KWWSڒ��PVGQ�PLFURVRIW�FRP�HQ�XV�PDJD]LQH�FF��DVS[

http://msdn.microsoft.com/en-us/magazine/cc163419.aspx




2EMHFWV KDYH GLIIHUHQW SURSHUWLHV DQG PHWKRGV� GH�SHQGLQJ RQ ZKLFK WHPSODWHV �WKDW LV� FODVVHV� WKH\DUH LQVWDQWLDWHG IURP� 7KDW٧V QRW WKH FDVHZLWK -DYD6FULSWREMHFWV� ,Q -DYD6FULSW� REMHFWV DUH MXVW FROOHFWLRQV RIQDPH�YDOXH SDLUV � WKLQN RI D -DYD6FULSW REMHFW DV DGLFWLRQDU\ ZLWK VWULQJ NH\V�

,I -DYD6FULSW REMHFWV DUH MXVW FROOHFWLRQV RI QDPH�YDOXH SDLUV� KRZFDQ WKH\ KDYH PHWKRGV" :HOO� WKH YDOXHV FDQ EH VWULQJV� QXPEHUVHWF� � RU IXQFWLRQV�

2N� QRZ ILQDOO\ EDFN WR WKH FRGH� :H GHFLGHG ZH ZDQW WR SDVVWKH OLVW RI UHTXHVW+DQGOHUV DV DQ REMHFW� DQG LQ RUGHU WR DFKLHYHORRVH FRXSOLQJ ZH ZDQW WR LQMHFW WKLV REMHFW LQWR WKH URXWH��

/HW٧V VWDUW ZLWK SXWWLQJ WKH REMHFW WRJHWKHU LQ RXU PDLQ ILOHLQGH[�MV�



WBS SFRVFTU)BOEMFST � SFRVJSFá��SFRVFTU)BOEMFSTá�

WBS IBOEMF � \^

IBOEMF<á�á> � SFRVFTU)BOEMFST�TUBSU�

IBOEMF<á�TUBSUá> � SFRVFTU)BOEMFST�TUBSU�

IBOEMF<á�VQMPBEá> � SFRVFTU)BOEMFST�VQMPBE�

TFSWFS�TUBSUSPVUFS�SPVUF IBOEMF�

$OWKRXJK KDQGOH LV PRUH RI D ٪WKLQJ٫ �D FROOHFWLRQ RI UHTXHVWKDQGOHUV�� , SURSRVH ZH QDPH LW OLNH D YHUE� EHFDXVH WKLV ZLOOUHVXOW LQ D IOXHQW H[SUHVVLRQ LQ RXU URXWHU� DV ZH ZLOO VHH VRRQ�


$V \RX FDQ VHH� LW٧V UHDOO\ VLPSOH WR PDS GLIIHUHQW 85/V WR WKHVDPH UHTXHVW KDQGOHU� E\ DGGLQJ D NH\�YDOXH SDLU RI ٣�٣ DQGUHTXHVW+DQGOHUV�VWDUW� ZH FDQ H[SUHVV LQ D QLFH DQG FOHDQ ZD\WKDW QRW RQO\ UHTXHVWV WR �VWDUW� EXW DOVR UHTXHVWV WR � VKDOO EHKDQGOHG E\ WKH VWDUW KDQGOHU�

$IWHU GHILQLQJ RXU REMHFW� ZH SDVV LW LQWR WKH VHUYHU DV DQDGGLWLRQDO SDUDPHWHU� /HW٧V FKDQJH RXU VHUYHU�MV WR PDNH XVH RILW�



GVODUJPO TUBSUSPVUF IBOEMF \




SPVUFIBOEMF QBUIOBNF�



SFTQPOTF�FOE�

^



^


:H٧YH DGGHG WKH KDQGOH SDUDPHWHU WR RXU VWDUW�� IXQFWLRQ� DQG


SDVV WKH KDQGOH REMHFW RQ WR WKH URXWH�� FDOOEDFN� DV LWV ILUVWSDUDPHWHU�

/HW٧V FKDQJH WKH URXWH�� IXQFWLRQ DFFRUGLQJO\� LQ RXU URXWHU�MV ILOH�

GVODUJPO SPVUFIBOEMF QBUIOBNF \


JG UZQFPG IBOEMF<QBUIOBNF> �� GVODUJPO� \

IBOEMF<QBUIOBNF>�

^ FMTF \

DPOTPMF�MPHá/P SFRVFTU IBOEMFS GPVOE GPS á � QBUIOBNF�

^

^


:KDW ZH GR KHUH LV� ZH FKHFN LI D UHTXHVW KDQGOHU IRU WKH JLYHQSDWKQDPH H[LVWV� DQG LI LW GRHV� ZH VLPSO\ FDOO WKH DFFRUGLQJIXQFWLRQ� %HFDXVH ZH FDQ DFFHVV RXU UHTXHVW KDQGOHU IXQFWLRQVIURP RXU REMHFW MXVW DV ZH ZRXOG DFFHVV DQ HOHPHQW RI DQDVVRFLDWLYH DUUD\� ZH KDYH WKLV QLFH IOXHQW KDQGOH>SDWKQDPH@��H[SUHVVLRQ , WDONHG DERXW HDUOLHU� ٪3OHDVH� KDQGOH WKLV SDWKQDPH٫�

2N� WKDW٧V DOO ZH QHHG WR ZLUH VHUYHU� URXWHU� DQG UHTXHVW KDQ�GOHUV WRJHWKHU� :KHQ VWDUWLQJ RXU DSSOLFDWLRQ DQG UHTXHVWLQJKWWS��ORFDOKRVW��VWDUWړ LQ RXU EURZVHU� ZH FDQ SURYH WKDW WKHFRUUHFW UHTXHVW KDQGOHU ZDV LQGHHG FDOOHG�

�KWWSړ��ORFDOKRVW��VWDUW

http://localhost:8888/start



4FSWFS IBT TUBSUFE�

3FRVFTU GPS �TUBSU SFDFJWFE�

"CPVU UP SPVUF B SFRVFTU GPS �TUBSU

3FRVFTU IBOEMFS �TUBSU� XBT DBMMFE�

$QG RSHQLQJ KWWS��ORFDOKRVW�ڔ�� LQ RXU EURZVHU SURYHV WKDWWKHVH UHTXHVWV� WRR� DUH LQGHHG KDQGOHG E\ WKH VWDUW UHTXHVWKDQGOHU�

3FRVFTU GPS � SFDFJWFE�

"CPVU UP SPVUF B SFRVFTU GPS �

3FRVFTU IBOEMFS �TUBSU� XBT DBMMFE�

0DNLQJ WKH UHTXHVW KDQGOHUV UHVSRQG

%HDXWLIXO� 1RZ LI RQO\ WKH UHTXHVW KDQGOHUV FRXOG DFWXDOO\ VHQGVRPHWKLQJ EDFN WR WKH EURZVHU� WKDW ZRXOG EH HYHQ EHWWHU� ULJKW"

5HPHPEHU� WKH ٪+HOOR :RUOG٫ \RXU EURZVHU GLVSOD\V XSRQ UH�TXHVWLQJ D SDJH VWLOO FRPHV IURP WKH RQ5HTXHVW IXQFWLRQ LQ RXUVHUYHU�MV ILOH�

٪+DQGOLQJ UHTXHVW٫PHDQV ٪DQVZHULQJ UHTXHVWV٫ DIWHU DOO� WKXVZHQHHG WR HQDEOH RXU UHTXHVW KDQGOHUV WR VSHDN ZLWK WKH EURZVHUMXVW OLNH RXU RQ5HTXHVW IXQFWLRQ GRHV�

+RZ WR QRW GR LW

7KH VWUDLJKW�IRUZDUG DSSURDFK ZH � DV GHYHORSHUV ZLWK D EDFN�JURXQG LQ 3+3 RU 5XE\ � PLJKW ZDQW WR IROORZ LV DFWXDOO\ YHU\

�KWWSڔ��ORFDOKRVW��




GHFHLWIXO� LW ZRUNV OLNH D FKDUP� VHHPV WR PDNH D ORW RI VHQVH� DQGWKHQ VXGGHQO\ VFUHZV WKLQJV XS ZKHQ ZH GRQ٧W H[SHFW LW�

:KDW , PHDQ E\ ٪VWUDLJKW�IRUZDUG DSSURDFK٫ LV WKLV� PDNH WKHUHTXHVW KDQGOHUV UHWXUQ�� WKH FRQWHQW WKH\ ZDQW WR GLVSOD\ WR WKHXVHU� DQG VHQG WKLV UHVSRQVH GDWD LQ WKH RQ5HTXHVW IXQFWLRQ EDFNWR WKH XVHU�

/HW٧V MXVW GR WKLV� DQG WKHQ VHH ZK\ LW٧V QRW VXFK DQ RYHUO\ JRRGLGHD�

:H VWDUW ZLWK WKH UHTXHVW KDQGOHUV DQG PDNH WKHP UHWXUQ ZKDWZH ZRXOG OLNH WR GLVSOD\ LQ WKH EURZVHU� :H QHHG WR FKDQJHUHTXHVW+DQGOHUV�MV WR WKLV�

GVODUJPO TUBSU \


SFUVSO á)FMMP 4UBSUá�

^

GVODUJPO VQMPBE \


SFUVSO á)FMMP 6QMPBEá�

^



*RRG� /LNHZLVH� WKH URXWHU QHHGV WR UHWXUQ WR WKH VHUYHU ZKDWWKH UHTXHVW KDQGOHUV UHWXUQ WR KLP� :H WKHUHIRUH QHHG WR HGLWURXWHU�MV OLNH WKLV�


GVODUJPO SPVUFIBOEMF QBUIOBNF \



SFUVSO IBOEMF<QBUIOBNF>�

^ FMTF \


SFUVSO á�� /PU GPVOEá�

^

^


$V \RX FDQ VHH� ZH DOVR UHWXUQ VRPH WH[W LI WKH UHTXHVW FRXOG QRWEH URXWHG�

$QG ODVW EXW QRW OHDVW� ZH QHHG WR UHIDFWRU RXU VHUYHU WR PDNHLW UHVSRQG WR WKH EURZVHU ZLWK WKH FRQWHQW WKH UHTXHVW KDQGOHUVUHWXUQHG YLD WKH URXWHU� WUDQVIRUPLQJ VHUYHU�MV LQWR�








WBS DPOUFOU � SPVUFIBOEMF QBUIOBNF

SFTQPOTF�XSJUFDPOUFOU�

SFTQPOTF�FOE�


^



^


,I ZH VWDUW RXU UHZULWWHQ DSSOLFDWLRQ� HYHU\WKLQJ ZRUNV OLNH DFKDUP� UHTXHVWLQJ KWWS��ORFDOKRVW��VWDUW{ڍ UHVXOWV LQ ٪+HOOR6WDUW٫ EHLQJ GLVSOD\HG LQ WKH EURZVHU� UHTXHVWLQJ KWWS��ORFDOKRVW��XSORDG{{JLYHV XV ٪+HOOR 8SORDG٫� DQG KWWS��ORFDOKRVW��IRR{t SURGXFHV٪�� 1RW IRXQG٫�

2N� WKHQ ZK\ LV WKDW D SUREOHP" 7KH VKRUW DQVZHU� EHFDXVH ZHZLOO UXQ LQWR SUREOHPV LI RQH WKH UHTXHVW KDQGOHUV ZDQWV WR PDNHXVH RI D QRQ�EORFNLQJ RSHUDWLRQ LQ WKH IXWXUH�

/HW٧V WDNH D ELW PRUH WLPH IRU WKH ORQJ DQVZHU�

%ORFNLQJ DQG QRQ�EORFNLQJ

$V VDLG� WKH SUREOHPV ZLOO DULVH ZKHQ ZH LQFOXGH QRQ�EORFNLQJRSHUDWLRQV LQ WKH UHTXHVW KDQGOHUV� %XW OHW٧V WDON DERXW EORFNLQJRSHUDWLRQV ILUVW� WKHQ DERXW QRQ�EORFNLQJ RSHUDWLRQV�

$QG LQVWHDG RI WU\LQJ WR H[SODLQ ZKDW ٪EORFNLQJ٫ DQG ٪QRQ�EORFNLQJ٫ PHDQV� OHW٧V GHPRQVWUDWH RXUVHOYHV ZKDW KDSSHQV LI ZHDGG D EORFNLQJ RSHUDWLRQ WR RXU UHTXHVW KDQGOHUV�

�KWWSڍ}��ORFDOKRVW��VWDUW{{KWWS��ORFDOKRVW��XSORDG{tKWWS��ORFDOKRVW��IRR


http://localhost:8888/upload

http://localhost:8888/foo



http://localhost:8888/foo


7R GR WKLV� ZH ZLOO PRGLI\ RXU VWDUW UHTXHVW KDQGOHU WR PDNH LWZDLW �� VHFRQGV EHIRUH UHWXUQLQJ LWV ٪+HOOR 6WDUW٫ VWULQJ� %HFDXVHWKHUH LV QR VXFK WKLQJ DV VOHHS�� LQ -DYD6FULSW� ZH ZLOO XVH D FOHYHUKDFN IRU WKDW�

3OHDVH PRGLI\ UHTXHVW+DQGOHUV�MV DV IROORZV�

GVODUJPO TUBSU \


GVODUJPO TMFFQNJMMJ4FDPOET \

WBS TUBSU5JNF � OFX %BUF�HFU5JNF�

XIJMF OFX %BUF�HFU5JNF � TUBSU5JNF � NJMMJ4FDPOET�

^

TMFFQ��

SFUVSO á)FMMP 4UBSUá�

^

GVODUJPO VQMPBE \



^



-XVW WR PDNH FOHDU ZKDW WKDW GRHV� ZKHQ WKH IXQFWLRQ VWDUW�� LVFDOOHG� 1RGH�MV ZDLWV �� VHFRQGV DQG RQO\ WKHQ UHWXUQV ٪+HOOR6WDUW٫� :KHQ FDOOLQJ XSORDG�� LW UHWXUQV LPPHGLDWHO\� MXVW OLNHEHIRUH�


�2I FRXUVH� \RX VKRXOG LPDJLQH WKDW LQVWHDG RI VOHHSLQJ IRU ��VHFRQGV� WKHUH ZRXOG EH D UHDO OLIH EORFNLQJ RSHUDWLRQ LQ VWDUW��OLNH VRPH VRUW RI ORQJ�UXQQLQJ FRPSXWDWLRQ��

/HW٧V VHH ZKDW WKLV FKDQJH GRHV�

$V DOZD\V� ZH QHHG WR UHVWDUW RXU VHUYHU� 7KLV WLPH� , DVN \RXWR IROORZ D VOLJKWO\ FRPSOH[ ٪SURWRFRO٫ LQ RUGHU WR VHH ZKDWKDSSHQV� )LUVW� RSHQ WZR EURZVHU ZLQGRZV RU WDEV� ,Q WKH ILUVWEURZVHU ZLQGRZ� SOHDVH HQWHU KWWS��ORFDOKRVW��VWDUW{u LQWRWKH DGGUHVV EDU� EXW GR QRW \HW RSHQ WKLV XUO�

,Q WKH VHFRQG EURZVHUZLQGRZ٧V DGGUHVV EDU� HQWHU KWWS��ORFDOKRVW��XSORDG{ڏ�DQG DJDLQ� SOHDVH GR QRW \HW KLW HQWHU�

1RZ� GR DV IROORZV� KLW HQWHU RQ WKH ILUVW ZLQGRZ �٪�VWDUW٫�� WKHQTXLFNO\ FKDQJH WR WKH VHFRQG ZLQGRZ �٪�XSORDG٫� DQG KLW HQWHU�WRR�

:KDW \RX ZLOO QRWLFH LV WKLV� 7KH �VWDUW 85/ WDNHV �� VHFRQGVWR ORDG� DV ZH ZRXOG H[SHFW� %XW WKH �XSORDG 85/ DOVR WDNHV�� VHFRQGV WR ORDG� DOWKRXJK WKHUH LV QR VOHHS�� LQ WKH DFFRUGLQJUHTXHVW KDQGOHU�

:K\" %HFDXVH VWDUW�� FRQWDLQV D EORFNLQJ RSHUDWLRQ� :H DOUHDG\WDONHG DERXW 1RGH٧V H[HFXWLRQ PRGHO � H[SHQVLYH RSHUDWLRQV DUHRN� EXW ZH PXVW WDNH FDUH WR QRW EORFN WKH 1RGH�MV SURFHVV ZLWKWKHP� ,QVWHDG� ZKHQHYHU H[SHQVLYH RSHUDWLRQV PXVW EH H[HFXWHG�WKHVH PXVW EH SXW LQ WKH EDFNJURXQG� DQG WKHLU HYHQWV PXVW EHKDQGOHG E\ WKH HYHQW ORRS�

$QG ZH ZLOO QRZ VHH ZK\ WKH ZD\ ZH FRQVWUXFWHG WKH ٪UHTXHVWKDQGOHU UHVSRQVH KDQGOLQJ٫ LQ RXU DSSOLFDWLRQ GRHVQ٧W DOORZ XV

{uKWWS��ORFDOKRVW��VWDUW�KWWSڏ}��ORFDOKRVW��XSORDG






WR PDNH SURSHU XVH RI QRQ�EORFNLQJ RSHUDWLRQV�

2QFH DJDLQ� OHW٧V WU\ WR H[SHULHQFH WKH SUREOHP ILUVW�KDQG E\PRGLI\LQJ RXU DSSOLFDWLRQ�

:H DUH JRLQJ WR XVH RXU VWDUW UHTXHVW KDQGOHU IRU WKLV DJDLQ�3OHDVH PRGLI\ LW WR UHIOHFW WKH IROORZLQJ �ILOH UHTXHVW+DQGOHUV�MV��

WBS FYFD � SFRVJSFáDIJME@QSPDFTTá�FYFD�

GVODUJPO TUBSU \


WBS DPOUFOU � áFNQUZá�

FYFDáMT �MBIá GVODUJPO FSSPS TUEPVU TUEFSS \

DPOUFOU � TUEPVU�

^�

SFUVSO DPOUFOU�

^

GVODUJPO VQMPBE \



^



$V \RX FDQ VHH� ZH MXVW LQWURGXFHG D QHZ1RGH�MV PRGXOH� FKLOGB�SURFHVV� :H GLG VR EHFDXVH LW DOORZV XV WR PDNH XVH RI D YHU\VLPSOH \HW XVHIXO QRQ�EORFNLQJ RSHUDWLRQ� H[HF��


:KDW H[HF�� GRHV LV� LW H[HFXWHV D VKHOO FRPPDQG IURP ZLWKLQ1RGH�MV� ,Q WKLV H[DPSOH� ZH DUH JRLQJ WR XVH LW WR JHW D OLVW RIDOO ILOHV LQ WKH FXUUHQW GLUHFWRU\ �٪OV �ODK٫�� DOORZLQJ XV WR GLVSOD\WKLV OLVW LQ WKH EURZVHU RI D XVHU UHTXHVWLQJ WKH �VWDUW 85/�

:KDW WKH FRGH GRHV LV VWUDLJKWIRUZDUG� FUHDWH D QHZ YDULDEOHFRQWHQW �ZLWK DQ LQLWLDO YDOXH RI ٪HPSW\٫�� H[HFXWH ٪OV �ODK٫� ILOOWKH YDULDEOH ZLWK WKH UHVXOW� DQG UHWXUQ LW�

$V DOZD\V� ZHZLOO VWDUW RXU DSSOLFDWLRQ� DQG YLVLW KWWS��ORFDOKRVW��VWDUW{ڐ�

:KLFK ORDGV D EHDXWLIXO ZHE SDJH WKDW GLVSOD\V WKH VWULQJ ٪HPSW\٫�:KDW٧V JRLQJ ZURQJ KHUH"

:HOO� DV \RX PD\ KDYH DOUHDG\ JXHVVHG� H[HF�� GRHV LWV PDJLF LQ DQRQ�EORFNLQJ IDVKLRQ� 7KDW٧V D JRRG WKLQJ� EHFDXVH WKLV ZD\ ZHFDQ H[HFXWH YHU\ H[SHQVLYH VKHOO RSHUDWLRQV �OLNH� H�J�� FRS\LQJKXJH ILOHV DURXQG RU VLPLODU VWXII� ZLWKRXW IRUFLQJ RXU DSSOLFDWLRQLQWR D IXOO VWRS DV WKH EORFNLQJ VOHHS RSHUDWLRQ GLG�

�,I \RX ZRXOG OLNH WR SURYH WKLV� UHSODFH ٪OV �ODK٫ ZLWK D PRUHH[SHQVLYH RSHUDWLRQ OLNH ٪ILQG �٫��

%XW ZH DUHQ٧W H[DFWO\ KDSS\ ZLWK RXU HOHJDQW QRQ�EORFNLQJRSHUDWLRQ� ZKHQ RXU EURZVHU GRHVQ٧W GLVSOD\ LWV UHVXOW� ULJKW"

:HOO� WKHQ� OHW٧V IL[ LW� $QG ZKLOH ZH DUH DW LW� OHW٧V WU\ WRXQGHUVWDQG ZK\ WKH FXUUHQW DUFKLWHFWXUH GRHVQ٧W ZRUN�

7KH SUREOHP LV WKDW H[HF�� LQ RUGHU WR ZRUN QRQ�EORFNLQJ� PDNHVXVH RI D FDOOEDFN IXQFWLRQ�

,Q RXU H[DPSOH� LW٧V DQ DQRQ\PRXV IXQFWLRQ ZKLFK LV SDVVHG DVWKH VHFRQG SDUDPHWHU WR WKH H[HF�� IXQFWLRQ FDOO�

�KWWSڐ}��ORFDOKRVW��VWDUW




GVODUJPO FSSPS TUEPVU TUEFSS \

DPOUFOU � TUEPVU�

^

$QG KHUHLQ OLHV WKH URRW RI RXU SUREOHP� RXU RZQ FRGH LV H[HFXWHGV\QFKURQRXV� ZKLFK PHDQV WKDW LPPHGLDWHO\ DIWHU FDOOLQJ H[HF��1RGH�MV FRQWLQXHV WR H[HFXWH UHWXUQ FRQWHQW�� $W WKLV SRLQW�FRQWHQW LV VWLOO ٪HPSW\٫� GXH WR WKH IDFW WKDW WKH FDOOEDFN IXQFWLRQSDVVHG WR H[HF�� KDV QRW \HW EHHQ FDOOHG � EHFDXVH H[HF�� RSHUDWHVDV\QFKURQRXV�

1RZ� ٪OV �ODK٫ LV D YHU\ LQH[SHQVLYH DQG IDVW RSHUDWLRQ �XQOHVVWKHUH DUH PLOOLRQV RI ILOHV LQ WKH GLUHFWRU\�� :KLFK LV ZK\ WKHFDOOEDFN LV FDOOHG UHODWLYHO\ H[SHGLWLRXV � EXW LW QHYHUWKHOHVVKDSSHQV DV\QFKURQRXVO\�

7KLQNLQJ DERXW D PRUH H[SHQVLYH FRPPDQG PDNHV WKLV PRUHREYLRXV� ٪ILQG �٫ WDNHV DERXW � PLQXWH RQ P\ PDFKLQH� EXW LI, UHSODFH ٪OV �ODK٫ ZLWK ٪ILQG �٫ LQ WKH UHTXHVW KDQGOHU� , VWLOOLPPHGLDWHO\ UHFHLYH DQ +773 UHVSRQVH ZKHQ RSHQLQJ WKH �VWDUW85/ � LW٧V FOHDU WKDW H[HF�� GRHV VRPHWKLQJ LQ WKH EDFNJURXQG�ZKLOH 1RGH�MV LWVHOI FRQWLQXHV ZLWK WKH DSSOLFDWLRQ� DQG ZH PD\DVVXPH WKDW WKH FDOOEDFN IXQFWLRQ ZH SDVVHG LQWR H[HF�� ZLOO EHFDOOHG RQO\ ZKHQ WKH ٪ILQG �٫ FRPPDQG KDV ILQLVKHG UXQQLQJ�

%XW KRZ FDQ ZH DFKLHYH RXU JRDO� L�H� VKRZLQJ WKH XVHU D OLVW RIILOHV LQ WKH FXUUHQW GLUHFWRU\"

:HOO� DIWHU OHDUQLQJ KRZ WR QRW GR LW� OHW٧V GLVFXVV KRZ WR PDNHRXU UHTXHVW KDQGOHUV UHVSRQG WR EURZVHU UHTXHVWV WKH ULJKW ZD\�


5HVSRQGLQJ UHTXHVW KDQGOHUV ZLWKQRQ�EORFNLQJ RSHUDWLRQV

,٧YH MXVW XVHG WKH SKUDVH ٪WKH ULJKW ZD\٫� 'DQJHURXV VWXII� 4XLWHRIWHQ� WKHUH LV QR VLQJOH ٪ULJKW ZD\٫�

%XW RQH SRVVLEOH VROXWLRQ IRU WKLV LV� DV RIWHQ ZLWK 1RGH�MV� WR SDVVIXQFWLRQV DURXQG� /HW٧V H[DPLQH WKLV�

5LJKW QRZ� RXU DSSOLFDWLRQ LV DEOH WR WUDQVSRUW WKH FRQWHQW �ZKLFKWKH UHTXHVW KDQGOHUV ZRXOG OLNH WR GLVSOD\ WR WKH XVHU� IURP WKHUHTXHVW KDQGOHUV WR WKH +773 VHUYHU E\ UHWXUQLQJ LW XS WKURXJKWKH OD\HUV RI WKH DSSOLFDWLRQ �UHTXHVW KDQGOHU �! URXWHU �! VHUYHU��

2XU QHZ DSSURDFK LV DV IROORZV� LQVWHDG RI EULQJLQJ WKH FRQ�WHQW WR WKH VHUYHU� ZH ZLOO EULQJ WKH VHUYHU WR WKH FRQWHQW� 7REH PRUH SUHFLVH� ZH ZLOO LQMHFW WKH UHVSRQVH REMHFW �IURP RXUVHUYHU٧V FDOOEDFN IXQFWLRQ RQ5HTXHVW�� WKURXJK WKH URXWHU LQWRWKH UHTXHVW KDQGOHUV� 7KH KDQGOHUV ZLOO WKHQ EH DEOH WR XVH WKLVREMHFW٧V IXQFWLRQV WR UHVSRQG WR UHTXHVWV WKHPVHOYHV�

(QRXJK H[SODQDWLRQ� KHUH LV WKH VWHS E\ VWHS UHFLSH RQ KRZ WRFKDQJH RXU DSSOLFDWLRQ�

/HW٧V VWDUW ZLWK RXU VHUYHU�MV�








SPVUFIBOEMF QBUIOBNF SFTQPOTF�

^



^


,QVWHDG RI H[SHFWLQJ D UHWXUQ YDOXH IURP WKH URXWH�� IXQFWLRQ�ZH SDVV LW D WKLUG SDUDPHWHU� RXU UHVSRQVH REMHFW� )XUWKHUPRUH�ZH UHPRYHG DQ\ UHVSRQVH PHWKRG FDOOV IURP WKH RQ5HTXHVW��KDQGOHU� EHFDXVH ZH QRZ H[SHFW URXWH WR WDNH FDUH RI WKDW�

1H[W FRPHV URXWHU�MV�


GVODUJPO SPVUFIBOEMF QBUIOBNF SFTQPOTF \



IBOEMF<QBUIOBNF>SFTQPOTF�

^ FMTF \



SFTQPOTF�XSJUFá�� /PU GPVOEá�

SFTQPOTF�FOE�

^

^


6DPH SDWWHUQ� LQVWHDG RI H[SHFWLQJ D UHWXUQ YDOXH IURP RXUUHTXHVW KDQGOHUV� ZH SDVV WKH UHVSRQG REMHFW RQ�

,I QR UHTXHVW KDQGOHU FDQ EH XVHG� ZH QRZ WDNH FDUH RI UHVSRQGLQJZLWK D SURSHU ٪��٫ KHDGHU DQG ERG\ RXUVHOYHV�

$QG ODVW EXW QRW OHDVW� ZH PRGLI\ UHTXHVW+DQGOHUV�MV�


GVODUJPO TUBSUSFTQPOTF \


FYFDáMT �MBIá GVODUJPO FSSPS TUEPVU TUEFSS \


SFTQPOTF�XSJUFTUEPVU�

SFTQPOTF�FOE�

^�


^

GVODUJPO VQMPBESFTQPOTF \



SFTQPOTF�XSJUFá)FMMP 6QMPBEá�

SFTQPOTF�FOE�

^



2XU KDQGOHU IXQFWLRQV QHHG WR DFFHSW WKH UHVSRQVH SDUDPHWHU�DQG KDYH WR PDNH XVH RI WKHP LQ RUGHU WR UHVSRQG WR WKH UHTXHVWGLUHFWO\�

7KH VWDUW KDQGOHU ZLOO UHVSRQG IURP ZLWKLQ WKH DQRQ\PRXVH[HF�� FDOOEDFN� DQG WKH XSORDG KDQGOHU VWLOO VLPSO\ UHSOLHV ZLWK٪+HOOR 8SORDG٫� EXW QRZ E\ PDNLQJ XVH RI WKH UHVSRQVH REMHFW�

,I ZH VWDUW RXU DSSOLFDWLRQ DJDLQ �QRGH LQGH[�MV�� WKLV VKRXOG ZRUNDV H[SHFWHG�

,I \RX ZRXOG OLNH WR SURYH WKDW DQ H[SHQVLYH RSHUDWLRQ EHKLQG�VWDUW ZLOO QR ORQJHU EORFN UHTXHVWV IRU �XSORDG IURP DQVZHULQJLPPHGLDWHO\� WKHQ PRGLI\ \RXU UHTXHVW+DQGOHUV�MV DV IROORZV�





FYFDáGJOE �á

\ UJNFPVU� �� NBY#VGGFS� �� ^

GVODUJPO FSSPS TUEPVU TUEFSS \


SFTQPOTF�XSJUFTUEPVU�

SFTQPOTF�FOE�

^�

^





SFTQPOTF�FOE�

^



7KLV ZLOO PDNH +773 UHTXHVWV WR KWWS��ORFDOKRVW��VWDUW{ڑWDNH DW OHDVW �� VHFRQGV� EXW UHTXHVWV WR KWWS��ORFDOKRVW��XSORDG{ڒZLOO EH DQVZHUHG LPPHGLDWHO\� HYHQ LI �VWDUW LV VWLOO FRPSXWLQJ�

�KWWSڑ}��ORFDOKRVW��VWDUW�KWWSڒ}��ORFDOKRVW��XSORDG






6HUYLQJ VRPHWKLQJ XVHIXO

8QWLO QRZ� ZKDW ZH KDYH GRQH LV DOO ILQH DQG GDQG\� EXW ZHKDYHQ٧W FUHDWHG DQ\ YDOXH IRU WKH FXVWRPHUV RI RXU DZDUG�ZLQQLQJ ZHEVLWH�

2XU VHUYHU� URXWHU� DQG UHTXHVW KDQGOHUV DUH LQ SODFH� WKXV QRZZH FDQ EHJLQ WR DGG FRQWHQW WR RXU VLWH ZKLFK DOORZV RXU XVHUVWR LQWHUDFW DQG ZDON WKURXJK WKH XVH FDVH RI FKRRVLQJ D ILOH�XSORDGLQJ WKLV ILOH� DQG YLHZLQJ WKH XSORDGHG ILOH LQ WKH EURZVHU�)RU WKH VDNH RI VLPSOLFLW\ ZH ZLOO DVVXPH WKDW RQO\ LPDJH ILOHVDUH JRLQJ WR EH XSORDGHG DQG GLVSOD\HG WKURXJK WKH DSSOLFDWLRQ�

2N� OHW٧V WDNH LW VWHS E\ VWHS� EXW ZLWK PRVW RI WKH WHFKQLTXHV DQGSULQFLSOHV RI -DYD6FULSW H[SODLQHG E\ QRZ� OHW٧V DW WKH VDPH WLPHDFFHOHUDWH D ELW� 7KLV DXWKRU OLNHV WR KHDU KLPVHOI WDONLQJ ZD\ WRRPXFK DQ\ZD\V�

+HUH� VWHS E\ VWHS PHDQV URXJKO\ WZR VWHSV� :H ZLOO ILUVW ORRNDW KRZ WR KDQGOH LQFRPLQJ 3267 UHTXHVWV �EXW QRW ILOH XSORDGV��DQG LQ D VHFRQG VWHS� ZH ZLOO PDNH XVH RI DQ H[WHUQDO 1RGH�MVPRGXOH IRU WKH ILOH XSORDG KDQGOLQJ� ,٧YH FKRVHQ WKLV DSSURDFKIRU WZR UHDVRQV�

)LUVW� KDQGOLQJ EDVLF 3267 UHTXHVWV LV UHODWLYHO\ VLPSOH ZLWK1RGH�MV� EXW VWLOO WHDFKHV XV HQRXJK WR EH ZRUWK H[HUFLVLQJ LW�6HFRQG� KDQGOLQJ ILOH XSORDGV �L�H�� PXOWLSDUW 3267 UHTXHVWV� LVQRW VLPSOH ZLWK 1RGH�MV� DQG WKHUHIRUH LV EH\RQG WKH VFRSH RIWKLV WXWRULDO� EXW XVLQJ DQ H[WHUQDO PRGXOH LV LWVHOI D OHVVRQ WKDWPDNHV VHQVH WR EH LQFOXGHG LQ D EHJLQQHU٧V WXWRULDO�


+DQGOLQJ 3267 UHTXHVWV

/HW٧V NHHS WKLV EDQDOO\ VLPSOH� :H ZLOO SUHVHQW D WH[WDUHD WKDWFDQ EH ILOOHG E\ WKH XVHU DQG VXEPLWWHG WR WKH VHUYHU LQ D3267 UHTXHVW� 8SRQ UHFHLYLQJ DQG KDQGOLQJ WKLV UHTXHVW� ZH ZLOOGLVSOD\ WKH FRQWHQW RI WKH WH[WDUHD�

7KH +70/ IRU WKLV WH[WDUHD IRUP QHHGV WR EH VHUYHG E\ RXU�VWDUW UHTXHVW KDQGOHU� VR OHW٧V DGG LW ULJKW DZD\� LQ ILOH UH�TXHVW+DQGOHUV�MV�



WBS CPEZ � ��IUNM��

��IFBE��

��NFUB IUUQ�FRVJW�á$POUFOU�5ZQFá DPOUFOU�áUFYU�IUNM� ��

�DIBSTFU�65'��á ��

��IFBE��

��CPEZ��

��GPSN BDUJPO�á�VQMPBEá NFUIPE�áQPTUá��

��UFYUBSFB OBNF�áUFYUá SPXT�á��á DPMT�á��á��UFYUBSFB��

��JOQVU UZQF�áTVCNJUá WBMVF�á4VCNJU UFYUá ��

��GPSN��

��CPEZ��

��IUNM��

SFTQPOTF�XSJUF)FBE�� \á$POUFOU�5ZQFá� áUFYU�IUNMá^�

SFTQPOTF�XSJUFCPEZ�

SFTQPOTF�FOE�

^






SFTQPOTF�FOE�

^



1RZ LI WKLV LVQ٧W JRLQJ WR ZLQ WKH :HEE\ $ZDUGV� WKHQ , GRQ٧WNQRZ ZKDW FRXOG� <RX VKRXOG VHH WKLV YHU\ VLPSOH IRUP ZKHQUHTXHVWLQJ KWWS��ORFDOKRVW��VWDUW{ړ LQ \RXU EURZVHU� ,I QRW�\RX SUREDEO\ GLGQ٧W UHVWDUW WKH DSSOLFDWLRQ�

, KHDU \RX� KDYLQJ YLHZ FRQWHQW ULJKW LQ WKH UHTXHVW KDQGOHULV XJO\� +RZHYHU� , GHFLGHG WR QRW LQFOXGH WKDW H[WUD OHYHO RIDEVWUDFWLRQ �L�H�� VHSDUDWLQJ YLHZ DQG FRQWUROOHU ORJLF� LQ WKLVWXWRULDO� EHFDXVH , WKLQN WKDW LW GRHVQ٧W WHDFK XV DQ\WKLQJ ZRUWKNQRZLQJ LQ WKH FRQWH[W RI -DYD6FULSW RU 1RGH�MV�

/HW٧V UDWKHU XVH WKH UHPDLQLQJ VFUHHQ VSDFH IRU D PRUH LQWHUHVWLQJSUREOHP� WKDW LV� KDQGOLQJ WKH 3267 UHTXHVW WKDW ZLOO KLW RXU�XSORDG UHTXHVW KDQGOHU ZKHQ WKH XVHU VXEPLWV WKLV IRUP�

1RZ WKDW ZH DUH EHFRPLQJ H[SHUW QRYLFHV� ZH DUH QR ORQJHUVXUSULVHG E\ WKH IDFW WKDW KDQGOLQJ 3267 GDWD LV GRQH LQ D QRQ�EORFNLQJ IDVKLRQ� E\ XVLQJ DV\QFKURQRXV FDOOEDFNV�

:KLFK PDNHV VHQVH� EHFDXVH 3267 UHTXHVWV FDQ SRWHQWLDOO\ EHYHU\ ODUJH � QRWKLQJ VWRSV WKH XVHU IURP HQWHULQJ WH[W WKDW LV

�KWWSړ}��ORFDOKRVW��VWDUW




PXOWLSOH PHJDE\WHV LQ VL]H� +DQGOLQJ WKH ZKROH EXON RI GDWD LQRQH JR ZRXOG UHVXOW LQ D EORFNLQJ RSHUDWLRQ�

7RPDNH WKHZKROH SURFHVV QRQ�EORFNLQJ� 1RGH�MV VHUYHV RXU FRGHWKH 3267 GDWD LQ VPDOO FKXQNV� FDOOEDFNV WKDW DUH FDOOHG XSRQFHUWDLQ HYHQWV� 7KHVH HYHQWV DUH GDWD �DQ QHZ FKXQN RI 3267GDWD DUULYHV� DQG HQG �DOO FKXQNV KDYH EHHQ UHFHLYHG��

:H QHHG WR WHOO 1RGH�MV ZKLFK IXQFWLRQV WR FDOO EDFN WR ZKHQWKHVH HYHQWV RFFXU� 7KLV LV GRQH E\ DGGLQJ OLVWHQHUV WR WKH UHTXHVWREMHFW WKDW LV SDVVHG WR RXU RQ5HTXHVW FDOOEDFN ZKHQHYHU DQ+773 UHTXHVW LV UHFHLYHG�

7KLV EDVLFDOO\ ORRNV OLNH WKLV�

SFRVFTU�BEE-JTUFOFSáEBUBá GVODUJPODIVOL \

�� DBMMFE XIFO B OFX DIVOL PG EBUB XBT SFDFJWFE

^�

SFRVFTU�BEE-JTUFOFSáFOEá GVODUJPO \

�� DBMMFE XIFO BMM DIVOLT PG EBUB IBWF CFFO SFDFJWFE

^�

7KH TXHVWLRQ DULVHV ZKHUH WR LPSOHPHQW WKLV ORJLF� :H FXUUHQWO\FDQ DFFHVV WKH UHTXHVW REMHFW LQ RXU VHUYHU RQO\ � ZH GRQ٧W SDVVLW RQ WR WKH URXWHU DQG WKH UHTXHVW KDQGOHUV� OLNH ZH GLG ZLWK WKHUHVSRQVH REMHFW�

,Q P\ RSLQLRQ� LW٧V DQ +773 VHUYHUV MRE WR JLYH WKH DSSOLFDWLRQDOO WKH GDWD IURP D UHTXHVWV LW QHHGV WR GR LWV MRE� 7KHUHIRUH� ,VXJJHVW ZH KDQGOH WKH 3267 GDWD SURFHVVLQJ ULJKW LQ WKH VHUYHUDQG SDVV WKH ILQDO GDWD RQ WR WKH URXWHU DQG WKH UHTXHVW KDQGOHUV�ZKLFK WKHQ FDQ GHFLGH ZKDW WR GR ZLWK LW�


7KXV� WKH LGHD LV WR SXW WKH GDWD DQG HQG HYHQW FDOOEDFNV LQ WKHVHUYHU� FROOHFWLQJ DOO 3267 GDWD FKXQNV LQ WKH GDWD FDOOEDFN� DQGFDOOLQJ WKH URXWHU XSRQ UHFHLYLQJ WKH HQG HYHQW� ZKLOH SDVVLQJWKH FROOHFWHG GDWD FKXQNV RQ WR WKH URXWHU� ZKLFK LQ WXUQ SDVVHVLW RQ WR WKH UHTXHVW KDQGOHUV�

+HUH ZH JR� VWDUWLQJ ZLWK VHUYHU�MV�





WBS QPTU%BUB � áá�



SFRVFTU�TFU&ODPEJOHáVUG�á�

SFRVFTU�BEE-JTUFOFSáEBUBá GVODUJPOQPTU%BUB$IVOL \

QPTU%BUB �� QPTU%BUB$IVOL�

DPOTPMF�MPHá3FDFJWFE 1045 EBUB DIVOL �á�

QPTU%BUB$IVOL � á��á�

^�

SFRVFTU�BEE-JTUFOFSáFOEá GVODUJPO \

SPVUFIBOEMF QBUIOBNF SFTQPOTF QPTU%BUB�

^�

^




^


:H EDVLFDOO\ GLG WKUHH WKLQJV KHUH� )LUVW� ZH GHILQHG WKDW ZHH[SHFW WKH HQFRGLQJ RI WKH UHFHLYHG GDWD WR EH 87)�� ZH DGGHGDQ HYHQW OLVWHQHU IRU WKH ٪GDWD٫ HYHQW ZKLFK VWHS E\ VWHS ILOOVRXU QHZ SRVW'DWD YDULDEOH ZKHQHYHU D QHZ FKXQN RI 3267 GDWDDUULYHV� DQG ZH PRYHG WKH FDOO WR RXU URXWHU LQWR WKH HQG HYHQWFDOOEDFN WR PDNH VXUH LW٧V RQO\ FDOOHG ZKHQ DOO 3267 GDWD LVJDWKHUHG� :H DOVR SDVV WKH 3267 GDWD LQWR WKH URXWHU� EHFDXVHZH DUH JRLQJ WR QHHG LW LQ RXU UHTXHVW KDQGOHUV�

$GGLQJ WKH FRQVROH ORJJLQJ RQ HYHU\ FKXQN WKDW LV UHFHLYHGSUREDEO\ LV D EDG LGHD IRU SURGXFWLRQ FRGH �PHJDE\WHV RI 3267GDWD� UHPHPEHU"�� EXW PDNHV VHQVH WR VHH ZKDW KDSSHQV�

, VXJJHVW SOD\LQJ DURXQG ZLWK WKLV D ELW� 3XW VPDOO DPRXQWV RIWH[W LQWR WKH WH[WDUHD DV ZHOO DV ORWV RI WH[W� DQG \RX ZLOO VHH WKDWIRU WKH ODUJHU WH[WV� WKH GDWD FDOOEDFN LV LQGHHG FDOOHG PXOWLSOHWLPHV�

/HW٧V DGG HYHQ PRUH DZHVRPH WR RXU DSS� 2Q WKH �XSORDG SDJH�ZH ZLOO GLVSOD\ WKH UHFHLYHG FRQWHQW� 7R PDNH WKLV SRVVLEOH� ZHQHHG WR SDVV WKH SRVW'DWD RQ WR WKH UHTXHVW KDQGOHUV� LQ URXWHU�MV�


GVODUJPO SPVUFIBOEMF QBUIOBNF SFTQPOTF QPTU%BUB \



IBOEMF<QBUIOBNF>SFTQPOTF QPTU%BUB�

^ FMTF \




SFTQPOTF�FOE�

^

^


$QG LQ UHTXHVW+DQGOHUV�MV� ZH LQFOXGH WKH GDWD LQ RXU UHVSRQVHRI WKH XSORDG UHTXHVW KDQGOHU�

GVODUJPO TUBSUSFTQPOTF QPTU%BUB \



��IFBE��



��IFBE��

��CPEZ��




��GPSN��

��CPEZ��


��IUNM��



SFTQPOTF�FOE�

^

GVODUJPO VQMPBESFTQPOTF QPTU%BUB \



SFTQPOTF�XSJUFá:PV�WF TFOU� á � QPTU%BUB�

SFTQPOTF�FOE�

^



7KDW٧V LW� ZH DUH QRZ DEOH WR UHFHLYH 3267 GDWD DQG XVH LW LQ RXUUHTXHVW KDQGOHUV�

2QH ODVW WKLQJ IRU WKLV WRSLF� ZKDWZH SDVV RQ WR WKH URXWHU DQG WKHUHTXHVW KDQGOHUV LV WKH FRPSOHWH ERG\ RI RXU 3267 UHTXHVW� :HZLOO SUREDEO\ ZDQW WR FRQVXPH WKH LQGLYLGXDO ILHOGV WKDW PDNHXS WKH 3267 GDWD� LQ WKLV FDVH� WKH YDOXH RI WKH WH[W ILHOG�

:H DOUHDG\ UHDG DERXW WKH TXHU\VWULQJ PRGXOH� ZKLFK DVVLVWV XVZLWK WKLV�


WBS RVFSZTUSJOH � SFRVJSFáRVFSZTUSJOHá�




��IFBE��



��IFBE��

��CPEZ��




��GPSN��

��CPEZ��

��IUNM��



SFTQPOTF�FOE�

^




SFTQPOTF�XSJUFá:PV�WF TFOU UIF UFYU� á�

RVFSZTUSJOH�QBSTFQPTU%BUB�UFYU�

SFTQPOTF�FOE�

^




:HOO� IRU D EHJLQQHU٧V WXWRULDO� WKDW٧V DOO WKHUH LV WR VD\ DERXWKDQGOLQJ 3267 GDWD�

+DQGOLQJ ILOH XSORDGV

/HW٧V WDFNOH RXU ILQDO XVH FDVH� 2XU SODQ ZDV WR DOORZ XVHUV WRXSORDG DQ LPDJH ILOH� DQG GLVSOD\ WKH XSORDGHG LPDJH LQ WKHEURZVHU�

%DFN LQ WKH ��٧V WKLV ZRXOG KDYH TXDOLILHG DV D EXVLQHVV PRGHOIRU DQ ,32� WRGD\ LW PXVW VXIILFH WR WHDFK XV WZR WKLQJV� KRZ WRLQVWDOO H[WHUQDO 1RGH�MV OLEUDULHV� DQG KRZ WR PDNH XVH RI WKHPLQ RXU RZQ FRGH�

7KH H[WHUQDO PRGXOH ZH DUH JRLQJ WR XVH LV QRGH�IRUPLGDEOH E\)HOL[ *HLVHQGRHUIHU� ,W QLFHO\ DEVWUDFWV DZD\ DOO WKH QDVW\ GHWDLOVRI SDUVLQJ LQFRPLQJ ILOH GDWD� $W WKH HQG RI WKH GD\� KDQGOLQJLQFRPLQJ ILOHV LV ٪RQO\٫ DERXW KDQGOLQJ 3267 GDWD � EXW WKH GHYLOUHDOO\ LV LQ WKH GHWDLOV KHUH� DQG XVLQJ D UHDG\�PDGH VROXWLRQPDNHV D ORW RI VHQVH LQ WKLV FDVH�

,Q RUGHU WR PDNH XVH RI )HOL[٧ FRGH� WKH DFFRUGLQJ 1RGH�MVPRGXOH QHHGV WR EH LQVWDOOHG� 1RGH�MV VKLSV ZLWK LWV RZQ SDFNDJHPDQDJHU� GXEEHG 130� ,W DOORZV XV WR LQVWDOO H[WHUQDO 1RGH�MVPRGXOHV LQ D YHU\ FRQYHQLHQW IDVKLRQ� *LYHQ D ZRUNLQJ 1RGH�MVLQVWDOODWLRQ� LW ERLOV GRZQ WR LVVXLQJ


OQN JOTUBMM GPSNJEBCMF

RQ RXU FRPPDQG OLQH� ,I WKH IROORZLQJ RXWSXW HQGV ZLWK

OQN JOGP CVJME 4VDDFTT� GPSNJEBCMF!��

OQN PL

WKHQ ZH DUH JRRG WR JR�

7KH IRUPLGDEOH PRGXOH LV QRZ DYDLODEOH WR RXU RZQ FRGH � DOOZH QHHG WR GR LV UHTXLULQJ LW MXVW OLNH RQH RI WKH EXLOW�LQ PRGXOHVZH XVHG HDUOLHU�

WBS GPSNJEBCMF � SFRVJSFáGPSNJEBCMFá�

7KH PHWDSKRU IRUPLGDEOH XVHV LV WKDW RI D IRUP EHLQJ VXEPLWWHGYLD +773 3267� PDNLQJ LW SDUVHDEOH LQ 1RGH�MV� $OO ZH QHHGWR GR LV FUHDWH D QHZ ,QFRPLQJ)RUP� ZKLFK LV DQ DEVWUDFWLRQ RIWKLV VXEPLWWHG IRUP� DQG ZKLFK FDQ WKHQ EH XVHG WR SDUVH WKHUHTXHVW REMHFW RI RXU +773 VHUYHU IRU WKH ILHOGV DQG ILOHV WKDWZHUH VXEPLWWHG WKURXJK WKLV IRUP�

7KH H[DPSOH FRGH IURP WKH QRGH�IRUPLGDEOH SURMHFW SDJH VKRZVKRZ WKH GLIIHUHQW SDUWV SOD\ WRJHWKHU�


WBS GPSNJEBCMF � SFRVJSF�GPSNJEBCMF�

IUUQ � SFRVJSF�IUUQ�

TZT � SFRVJSF�TZT��

IUUQ�DSFBUF4FSWFSGVODUJPOSFR SFT \

JG SFR�VSM �� VQMPBE� �� SFR�NFUIPE�UP-PXFS$BTF �� QPTU� \

�� QBSTF B GJMF VQMPBE

WBS GPSN � OFX GPSNJEBCMF�*ODPNJOH'PSN�

GPSN�QBSTFSFR GVODUJPOFSSPS GJFMET GJMFT \

SFT�XSJUF)FBE�� \�DPOUFOU�UZQF�� UFYU�QMBJO�^�

SFT�XSJUF�SFDFJWFE VQMPBE�=O=O��

SFT�FOETZT�JOTQFDU\GJFMET� GJFMET GJMFT� GJMFT^�

^�

SFUVSO�

^

�� TIPX B GJMF VQMPBE GPSN

SFT�XSJUF)FBE�� \�DPOUFOU�UZQF�� UFYU�IUNM�^�

SFT�FOE

��GPSN BDUJPO�á�VQMPBEá FODUZQF�áNVMUJQBSU�GPSN�EBUBá ��

�NFUIPE�áQPTUá��

��JOQVU UZQF�áUFYUá OBNF�áUJUMFá��CS��

��JOQVU UZQF�áGJMFá OBNF�áVQMPBEá NVMUJQMF�áNVMUJQMFá��CS��

��JOQVU UZQF�áTVCNJUá WBMVF�á6QMPBEá��

��GPSN��

�

^�MJTUFO��

,I ZH SXW WKLV FRGH LQWR D ILOH DQG H[HFXWH LW WKURXJK QRGH� ZHDUH DEOH WR VXEPLW D VLPSOH IRUP� LQFOXGLQJ D ILOH XSORDG� DQG VHHKRZ WKH ILOHV REMHFW� ZKLFK LV SDVVHG WR WKH FDOOEDFN GHILQHG LQ


WKH IRUP�SDUVH FDOO� LV VWUXFWXUHG�

SFDFJWFE VQMPBE�

\ GJFMET� \ UJUMF� �)FMMP 8PSME� ^

GJMFT�

\ VQMPBE�

\ TJ[F� ��

QBUI� ��UNQ��D��B��B��F��G��C�

OBNF� �VT�GMBH�QOH�

UZQF� �JNBHF�QOH�

MBTU.PEJGJFE%BUF� 5VF �� +VO �� (.5

@XSJUF4USFBN� <0CKFDU>

MFOHUI� <(FUUFS>

GJMFOBNF� <(FUUFS>

NJNF� <(FUUFS> ^ ^ ^

,Q RUGHU WR PDNH RXU XVH FDVH KDSSHQ� ZKDW ZH QHHG WR GR LVWR LQFOXGH WKH IRUP�SDUVLQJ ORJLF RI IRUPLGDEOH LQWR RXU FRGHVWUXFWXUH� SOXV ZH ZLOO QHHG WR ILQG RXW KRZ WR VHUYH WKH FRQWHQWRI WKH XSORDGHG ILOH �ZKLFK LV VDYHG LQWR WKH �WPS IROGHU� WR DUHTXHVWLQJ EURZVHU�

/HW٧V WDFNOH WKH ODWWHU RQH ILUVW� LI WKHUH LV DQ LPDJH ILOH RQ RXUORFDO KDUGULYH� KRZ GR ZH VHUYH LW WR D UHTXHVWLQJ EURZVHU"

:H DUH REYLRXVO\ JRLQJ WR UHDG WKH FRQWHQWV RI WKLV ILOH LQWR RXU1RGH�MV VHUYHU� DQG XQVXUSULVLQJO\� WKHUH LV D PRGXOH IRU WKDW �LW٧V FDOOHG IV�

/HW٧V DGG DQRWKHU UHTXHVW KDQGOHU IRU WKH 85/ �VKRZ� ZKLFK ZLOOKDUGFRGLQJO\ GLVSOD\ WKH FRQWHQWV RI WKH ILOH �WPS�WHVW�SQJ� ,W RI


FRXUVH PDNHV D ORW RI VHQVH WR VDYH D UHDO SQJ LPDJH ILOH WR WKLVORFDWLRQ ILUVW�

:H DUH JRLQJ WR PRGLI\ UHTXHVW+DQGOHUV�MV DV IROORZV�

WBS RVFSZTUSJOH � SFRVJSFáRVFSZTUSJOHá

GT � SFRVJSFáGTá�




��IFBE��

��NFUB IUUQ�FRVJW�á$POUFOU�5ZQFá ��

�DPOUFOU�áUFYU�IUNM� DIBSTFU�65'��á ��

��IFBE��

��CPEZ��




��GPSN��

��CPEZ��

��IUNM��



SFTQPOTF�FOE�

^







SFTQPOTF�FOE�

^

GVODUJPO TIPXSFTQPOTF QPTU%BUB \

DPOTPMF�MPHá3FRVFTU IBOEMFS �TIPX� XBT DBMMFE�á�

GT�SFBE'JMFá�UNQ�UFTU�QOHá áCJOBSZá GVODUJPOFSSPS GJMF \

JG FSSPS \


SFTQPOTF�XSJUFFSSPS � á=Oá�

SFTQPOTF�FOE�

^ FMTF \

SFTQPOTF�XSJUF)FBE�� \á$POUFOU�5ZQFá� áJNBHF�QOHá^�

SFTQPOTF�XSJUFGJMF áCJOBSZá�

SFTQPOTF�FOE�

^

^�

^



FYQPSUT�TIPX � TIPX�

:H DOVR QHHG WR PDS WKLV QHZ UHTXHVW KDQGOHU WR WKH 85/ �VKRZLQ ILOH LQGH[�MV�




WBS SFRVFTU)BOEMFST � SFRVJSFá��SFRVFTU)BOEMFSTá�

WBS IBOEMF � \^

IBOEMF<á�á> � SFRVFTU)BOEMFST�TUBSU�

IBOEMF<á�TUBSUá> � SFRVFTU)BOEMFST�TUBSU�

IBOEMF<á�VQMPBEá> � SFRVFTU)BOEMFST�VQMPBE�

IBOEMF<á�TIPXá> � SFRVFTU)BOEMFST�TIPX�

TFSWFS�TUBSUSPVUFS�SPVUF IBOEMF�

%\ UHVWDUWLQJ WKH VHUYHU DQG RSHQLQJ KWWS��ORFDOKRVW��VKRZ{ڔLQ WKH EURZVHU� WKH LPDJH ILOH VDYHG DW �WPS�WHVW�SQJ VKRXOG EHGLVSOD\HG�

)LQH� $OO ZH QHHG WR GR QRZ LV

DGG D ILOH XSORDG HOHPHQW WR WKH IRUP ZKLFK LV VHUYHG DW�VWDUW�

LQWHJUDWH QRGH�IRUPLGDEOH LQWR WKH XSORDG UHTXHVW KDQ�GOHU� LQ RUGHU WR VDYH WKH XSORDGHG ILOH WR �WPS�WHVW�SQJ�

HPEHG WKH XSORDGHG LPDJH LQWR WKH +70/ RXWSXW RI WKH�XSORDG 85/�

6WHS � LV VLPSOH�:H QHHG WR DGG DQ HQFRGLQJ W\SH RIPXOWLSDUW�IRUP�GDWD WR RXU +70/ IRUP� UHPRYH WKH WH[WDUHD� DGG D ILOH XSORDGLQSXW ILHOG� DQG FKDQJH WKH VXEPLW EXWWRQ WH[W WR ٪8SORDG ILOH٫�/HW٧V GR MXVW WKDW LQ ILOH UHTXHVW+DQGOHUV�MV�

�KWWSڔ}��ORFDOKRVW��VKRZ

http://localhost:8888/show

http://localhost:8888/show



GT � SFRVJSFáGTá�




��IFBE��



��IFBE��

��CPEZ��



��JOQVU UZQF�áGJMFá OBNF�áVQMPBEá��

��JOQVU UZQF�áTVCNJUá WBMVF�á6QMPBE GJMFá ��

��GPSN��

��CPEZ��

��IUNM��



SFTQPOTF�FOE�

^






SFTQPOTF�FOE�


^

GVODUJPO TIPXSFTQPOTF QPTU%BUB \



JG FSSPS \



SFTQPOTF�FOE�

^ FMTF \



SFTQPOTF�FOE�

^

^�

^




*UHDW� 7KH QH[W VWHS LV D ELW PRUH FRPSOH[ RI FRXUVH� 7KH ILUVWSUREOHP LV� ZH ZDQW WR KDQGOH WKH ILOH XSORDG LQ RXU XSORDGUHTXHVW KDQGOHU� DQG WKHUH� ZH ZLOO QHHG WR SDVV WKH UHTXHVWREMHFW WR WKH IRUP�SDUVH FDOO RI QRGH�IRUPLGDEOH�

%XW DOO ZH KDYH LV WKH UHVSRQVH REMHFW DQG WKH SRVW'DWD DUUD\� 6DGSDQGD� /RRNV OLNH ZH ZLOO KDYH WR SDVV WKH UHTXHVW REMHFW DOO WKHZD\ IURP WKH VHUYHU WR WKH URXWHU WR WKH UHTXHVW KDQGOHU� 7KHUHPD\ EH PRUH HOHJDQW VROXWLRQV� EXW WKLV DSSURDFK VKRXOG GR WKHMRE IRU QRZ�


$QG ZKLOH ZH DUH DW LW� OHW٧V UHPRYH WKH ZKROH SRVW'DWD VWXIILQ RXU VHUYHU DQG UHTXHVW KDQGOHUV � ZH ZRQ٧W QHHG LW IRUKDQGOLQJ WKH ILOH XSORDG� DQG LW HYHQ UDLVHV D SUREOHP� ZH DOUHDG\٪FRQVXPHG٫ WKH GDWD HYHQWV RI WKH UHTXHVW REMHFW LQ WKH VHUYHU�ZKLFKPHDQV WKDW IRUP�SDUVH� ZKLFK DOVR QHHGV WR FRQVXPH WKRVHHYHQWV� ZRXOGQ٧W UHFHLYH DQ\ PRUH GDWD IURP WKHP �EHFDXVH1RGH�MV GRHVQ٧W EXIIHU DQ\ GDWD��

/HW٧V VWDUW ZLWK VHUYHU�MV � ZH UHPRYH WKH SRVW'DWD KDQGOLQJDQG WKH UHTXHVW�VHW(QFRGLQJ OLQH �ZKLFK LV JRLQJ WR EH KDQGOHGE\ QRGH�IRUPLGDEOH LWVHOI�� DQG ZH SDVV UHTXHVW WR WKH URXWHULQVWHDG�







SPVUFIBOEMF QBUIOBNF SFTQPOTF SFRVFTU�

^



^


1H[W FRPHV URXWHU�MV � ZH GRQ٧W QHHG WR SDVV SRVW'DWD RQDQ\PRUH� DQG LQVWHDG SDVV UHTXHVW �


GVODUJPO SPVUFIBOEMF QBUIOBNF SFTQPOTF SFRVFTU \



IBOEMF<QBUIOBNF>SFTQPOTF SFRVFTU�

^ FMTF \




SFTQPOTF�FOE�

^

^


1RZ� WKH UHTXHVW REMHFW FDQ EH XVHG LQ RXU XSORDG UHTXHVWKDQGOHU IXQFWLRQ� QRGH�IRUPLGDEOH ZLOO KDQGOH WKH GHWDLOV RIVDYLQJ WKH XSORDGHG ILOH WR D ORFDO ILOH ZLWKLQ �WPS� EXW ZH QHHGWR PDNH VXUH WKDW WKLV ILOH LV UHQDPHG WR �WPS�WHVW�SQJ RXUVHOYHV�<HV� ZH NHHS WKLQJV UHDOO\ VLPSOH DQG DVVXPH WKDW RQO\ 31*LPDJHV ZLOO EH XSORDGHG�

7KHUH LV D ELW RI H[WUD�FRPSOH[LW\ LQ WKH UHQDPH ORJLF� WKH:LQGRZV LPSOHPHQWDWLRQ RI QRGH GRHVQ٧W OLNH LW ZKHQ \RX WU\ WRUHQDPH D ILOH RQWR WKH SRVLWLRQ RI DQ H[LVWLQJ ILOH� ZKLFK LV ZK\ZH QHHG WR GHOHWH WKH ILOH LQ FDVH RI DQ HUURU�

/HW٧V SXW WKH SLHFHV RI PDQDJLQJ WKH XSORDGHG ILOH DQG UHQDPLQJLW WRJHWKHU QRZ� LQ ILOH UHTXHVW+DQGOHUV�MV�



GT � SFRVJSFáGTá

GPSNJEBCMF � SFRVJSFáGPSNJEBCMFá�




��IFBE��



��IFBE��

��CPEZ��



��JOQVU UZQF�áGJMFá OBNF�áVQMPBEá NVMUJQMF�áNVMUJQMFá��

��JOQVU UZQF�áTVCNJUá WBMVF�á6QMPBE GJMFá ��

��GPSN��

��CPEZ��

��IUNM��



SFTQPOTF�FOE�

^

GVODUJPO VQMPBESFTQPOTF SFRVFTU \


WBS GPSN � OFX GPSNJEBCMF�*ODPNJOH'PSN�

DPOTPMF�MPHáBCPVU UP QBSTFá�


GPSN�QBSTFSFRVFTU GVODUJPOFSSPS GJFMET GJMFT \

DPOTPMF�MPHáQBSTJOH EPOFá�

�� 1PTTJCMF FSSPS PO 8JOEPXT TZTUFNT�

USJFE UP SFOBNF UP BO BMSFBEZ FYJTUJOH GJMF ��

GT�SFOBNFGJMFT�VQMPBE�QBUI á�UNQ�UFTU�QOHá GVODUJPOFSSPS \

JG FSSPS \

GT�VOMJOLá�UNQ�UFTU�QOHá�

GT�SFOBNFGJMFT�VQMPBE�QBUI á�UNQ�UFTU�QOHá�

^

^�


SFTQPOTF�XSJUFáSFDFJWFE JNBHF��CS��á�

SFTQPOTF�XSJUFá�JNH TSD��TIPX� ��á�

SFTQPOTF�FOE�

^�

^

GVODUJPO TIPXSFTQPOTF \



JGFSSPS \



SFTQPOTF�FOE�

^ FMTF \



SFTQPOTF�FOE�

^

^�


^




$QG WKDW٧V LW� 5HVWDUW WKH VHUYHU� DQG WKH FRPSOHWH XVH FDVH ZLOO EHDYDLODEOH� 6HOHFW D ORFDO 31* LPDJH IURP \RXU KDUGULYH� XSORDGLW WR WKH VHUYHU� DQG KDYH LW GLVSOD\HG LQ WKH ZHE SDJH�

&RQFOXVLRQ DQG RXWORRN&RQJUDWXODWLRQV� RXU PLVVLRQ LV DFFRPSOLVKHG� :H ZURWH D VLP�SOH \HW IXOO�IOHGJHG 1RGH�MV ZHE DSSOLFDWLRQ� :H WDONHG DERXWVHUYHU�VLGH -DYD6FULSW� IXQFWLRQDO SURJUDPPLQJ� EORFNLQJ DQGQRQ�EORFNLQJ RSHUDWLRQV� FDOOEDFNV� HYHQWV� FXVWRP� LQWHUQDO DQGH[WHUQDO PRGXOHV� DQG D ORW PRUH�

2I FRXUVH� WKHUH٧V D ORW RI VWXII ZH GLG QRW WDON DERXW� KRZ WRWDON WR D GDWDEDVH� KRZ WR ZULWH XQLW WHVWV� KRZ WR FUHDWH H[WHUQDOPRGXOHV WKDW DUH LQVWDOODEOH YLD 130� RU HYHQ VRPHWKLQJ VLPSOHOLNH KRZ WR KDQGOH *(7 UHTXHVWV�

%XW WKDW٧V WKH IDWH RI HYHU\ ERRN DLPHG DW EHJLQQHUV � LW FDQ٧W WDONDERXW HYHU\ VLQJOH DVSHFW LQ HYHU\ VLQJOH GHWDLO�

7KH JRRG QHZV LV� WKH 1RGH�MV FRPPXQLW\ LV H[WUHPO\ YLEUDQW�WKLQN RI DQ $'+' NLG RQ FDIIHLQH� EXW LQ D SRVLWLYH ZD\�� ZKLFKPHDQV WKHUH DUH D ORW RI UHVRXUFHV RXW WKHUH� DQG D ORW RI SODFHV WRJHW \RXU TXHVWLRQV DQVZHUHG� 7KH 1RGH�MV FRPPXQLW\ ZLNLtڍ DQGWKH 1RGH&ORXG GLUHFWRU\t{ DUH SUREDEO\ WKH EHVW VWDUWLQJ SRLQWVIRU PRUH LQIRUPDWLRQ�

tڍKWWSV��JLWKXE�FRP�MR\HQW�QRGH�ZLNLt{KWWS��ZZZ�QRGHFORXG�RUJ�

��

https://github.com/joyent/node/wiki

http://www.nodecloud.org/

https://github.com/joyent/node/wiki

http://www.nodecloud.org/

Node Beginner Handboook

Documents