[ Afficher l'Explorateur ] [ Cacher la Barre de Navigation ]
title
[fermer]
[Sommaire] [Imprimer]
1 <html> 2 <head> 3 <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4 <title>SimpleTest for PHP partial mocks documentation</title> 5 <link rel="stylesheet" type="text/css" href="docs.css" title="Styles"> 6 </head> 7 <body> 8 <div class="menu_back"> 9 <div class="menu"> 10 <h2> 11 <a href="index.html">SimpleTest</a> 12 </h2> 13 <ul> 14 <li> 15 <a href="overview.html">Overview</a> 16 </li> 17 <li> 18 <a href="unit_test_documentation.html">Unit tester</a> 19 </li> 20 <li> 21 <a href="group_test_documentation.html">Group tests</a> 22 </li> 23 <li> 24 <a href="mock_objects_documentation.html">Mock objects</a> 25 </li> 26 <li> 27 <span class="chosen">Partial mocks</span> 28 </li> 29 <li> 30 <a href="reporter_documentation.html">Reporting</a> 31 </li> 32 <li> 33 <a href="expectation_documentation.html">Expectations</a> 34 </li> 35 <li> 36 <a href="web_tester_documentation.html">Web tester</a> 37 </li> 38 <li> 39 <a href="form_testing_documentation.html">Testing forms</a> 40 </li> 41 <li> 42 <a href="authentication_documentation.html">Authentication</a> 43 </li> 44 <li> 45 <a href="browser_documentation.html">Scriptable browser</a> 46 </li> 47 </ul> 48 </div> 49 </div> 50 <h1>Partial mock objects documentation</h1> 51 <div class="content"> 52 53 <p> 54 A partial mock is simply a pattern to alleviate a specific problem 55 in testing with mock objects, 56 that of getting mock objects into tight corners. 57 It's quite a limited tool and possibly not even a good idea. 58 It is included with SimpleTest because I have found it useful 59 on more than one occasion and has saved a lot of work at that point. 60 </p> 61 62 <p> 63 <a class="target" name="inject"> 64 <h2>The mock injection problem</h2> 65 </a> 66 </p> 67 <p> 68 When one object uses another it is very simple to just pass a mock 69 version in already set up with its expectations. 70 Things are rather tricker if one object creates another and the 71 creator is the one you want to test. 72 This means that the created object should be mocked, but we can 73 hardly tell our class under test to create a mock instead. 74 The tested class doesn't even know it is running inside a test 75 after all. 76 </p> 77 <p> 78 For example, suppose we are building a telnet client and it 79 needs to create a network socket to pass its messages. 80 The connection method might look something like... 81 <pre> 82 <strong><?php 83 require_once('socket.php'); 84 85 class Telnet { 86 ... 87 function &connect($ip, $port, $username, $password) { 88 $socket = &new Socket($ip, $port); 89 $socket->read( ... ); 90 ... 91 } 92 } 93 ?></strong> 94 </pre> 95 We would really like to have a mock object version of the socket 96 here, what can we do? 97 </p> 98 <p> 99 The first solution is to pass the socket in as a parameter, 100 forcing the creation up a level. 101 Having the client handle this isop">:0at is vn a gapproachvel. n isf isorforcing the creatfromvel. :vel. C on mood m>:0foconMdirst solusevel. 10 lt;/pre> 11class Telnet { connect$socket, $username, $password) { $socket->read( ... ); 21 ?&> 22 </pre> Cion ypicalTest ide a ckevol Ha> 25 lt;/pre> 26class $socket = &>new Socket(Telnet = & Telnet(); Telnet->connect($socket, 'Me', 'Secrsock/a>); 35 36 </pre> $ed> 46 lt;/pre> 47class Telnet { 52 function &connect$ip, $port, $username, $password, $socket) { 53 t"> !a>, $socket) { 54 a>, $socket = &new Socket($ip, $port); 55 }> 56 a>, $socket->read( ..;gt;</strong> 57 ... 58 t=\'reta>, $socketg> 59 }> 60 }> :0n a genough ... :0l">$ed ... 66 lt;/pre> 67class 68 ... 69 funct;gt; 70 a>, $socket = &>new Socket( 71 ... 72 ket(Telnet = & Telnet(); 73 ket(Telnet->connect<'127.0.0.1', 21, 'Me', 'Secrsoc,tion &$socket); 74 ;gt;</strong> 75 }> 76 78 ion proting wdle tapproach It tclastids="sj ... 79 T tion er t x">Cinn of ="dospan ctool a a parameal">$ed> 80 inn of er t rel t we ne isjectstead. 83 </p> 84 lt;/p> 85 nor_tion metion is to p sf isoryated obj isdocing the crea ... 88 require_once('socket.php'); 89 p'); 90 class Telnet <strong ... 91 funct;gt;Telnet(ion &61345" onMouseOver="hili i6e(31)" onMouseOut="lolite()" onClick="logVariabe a netcket')" href="../../../../../_variabe a netcket.htme a netcket) { 92 ket(61345" onMouseOver="hili i6e(31)" onMouseOut="lolite()" onClick="logVariabe a netcket')" href="../../../../../_variabe a netcket.htme a netcketg ... 95 function &connect$ip, $port, $username, $password <strong ... 96 amp;$socketw=tion &$ip, $port); 97 amp;$socket->read( ..;gt;</strong> 98 > 99 t=\'reta>, $socketg> 100 }> 101 }> te a sass="span c.> class $socket = &>new Socket(61345" onMouseOver="hili i6e(31)" onMouseOut="lolite()" onClick="logVariabe a netcket')" href="../../../../../_variabe a netcket.htme a netcket = &>N a netcket(61345" onMouseOver="hili i6e(31)" onMouseOut="lolite()" onClick="logVariabe a netcket')" href="../../../../../_variabe a netcket.htme a netcket->$socket); Telnet = & Telnet(amp;61345" onMouseOver="hili i6e(31)" onMouseOut="lolite()" onClick="logVariabe a netcket')" href="../../../../../_variabe a netcket.htme a netcket); Telnet->connect<'127.0.0.1', 21, 'Me', 'Secrsoc); 21 </pre> $uildind a ofsf isorfreatrve fowhich willead. 33 &lpan class="target" name=&qthe creaject"> 34 lt;/h2Protconedti isoryaion meblem</h2> 35 </a> 36 </a> 42 lt;/pre> 43class Telnetconnect$ip, $port, $username, $password <strong ... $socketw=tion &$ip, $port$socket->read( ..> 52 }a> <strong ... 53 ... 54 function &$ip, $port< 55 t=\'retamp;new Socket($ip, $port); 56 };gt;</strong> 57 }> 58 ?&> 59 </pre> 60 Tle thisass only changpposemak hhocing pplhentica todctead. 66 lt;/strongt./_c ss('TempleVct vers Telnet 68 > 69 funct;gt;81854" onMouseOver="hilite81345)" onMouseOut="lolite()" onClick="logVariab be port')" href="../../../../../_variab be port.htm be cket< 70 a>, 81854" onMouseOver="hilite81345)" onMouseOut="lolite()" onClick="logVariab be port')" href="../../../../../_variab be port.htm be cketg> 71 a>, Telnet(); 72 }> 73 > 74 function & 75 t=\'reta>, 79 eranIe to hl">$ed of =oe winn of Thelt;uisorcked, a> 80 ste er yt sho vsedone jur tas bullevel. 83 Tle thisnecessarycket rel Thelt;uisoracallc> 84 a> l">connect<);gt;&l"> 85 Oassrwisetifi x shogsoce nullje.luetfromvel. 88 lt;/p> 89 Af er Thmplefunctofs ll ofwdle textra netw nd the 90 isop" in t rel e tfairly easytead. 91 We jur t in tnertamp;t./_c ieltns/r..> class 95 funct;gt; 96 a>, $socket = &>new Socket( 97 r..> 98 ket(Telnet = &;gt;$socket); 99 ket(Telnet->connect<'127.0.0.1', 21, 'Me', 'Secrsoc); 100 ;gt;</strong> 101 }> class $socket = &>new Socket(Telnet = &;gt;Telnet->$socket); Telnet->Telnet(); Telnet->connect<'127.0.0.1', 21, 'Me', 'Secrsoc); 43 52 a> lt;/a> 53 Instantia test of resul testock obc ionslighflyctronCypead. 54 Tof only chelt;uisoras a paramtofs s atialvebe ioead. 55 tletuot; The tr referencrread. 56 Asting wdletaormalvebe ock obc tle thisneededtiorasendrHa> 57 ter tresul p resphel hhds hee mo exp obpectations. 60 Tlf originalvchelt;uisorahisen trun ytel> 68 </a> 69 lt;/a> 70 As attfrom Thelt;uisver,s ll ofwdlec be mosion meso vs> 71 ass t 72 ion mesobe vseas befon tead. 73 Wut we ssocexp obpectat is veasihar..> 75class $socket = &>new Socket( 79 r..> 80 ket(Telnet = &;gt;Telnet->$socket <strong ... Telnet-> 83 ket(Telnet->Telnet(); 84 ket(Telnet->connect<'127.0.0.1', 21, 'Me', 'Secrsoc); 85 ;gt;lt;/strong> Telnet-> 88 90 </a> 91 > 97 lt;/p> 98 Tlec be mosout ion mesoderlte to hhdsbeti isoryaion mes,> 99 theyi x shobecany sora ofsion me.> 100 In tle twaycs atialvebe s illow uawant ak h')"t;/l ofwany s attof> 101 &lpan c exceptpass Thelt;uisor.> FUNC_DATA={ etpleche connecl: [etpleche connecl, 'l, [[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',128],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',169],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',211],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',295],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',334],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',377]], 0], ent,'r: [ent,'r, 'Rt,'sodatatfrom ass the so. Tlecprrorasuplt;sreatcs is nettrve fofor PHP4 ilwayawa')owuildinwarntestwng wa securs the so. l, [[etpletitple_tools/ery sitplel,'ce('socket.,122],[efa pa net/I18N/corel,'IMessageSourcecket.,52],[efa pa net/I18N/corel,'MessageSourcecket.,210]], 9], eexp oboncrl: [eexp oboncrl, 'Cono riencraion meofor inernglraion meocall. l, [[etpletitple_tools/ery sitplel,' be _ock obc.ket.,769]], 12], egenerat s atialp: [egenerat s atialp, 'Generat s isect ver ofw&lpan c wng wselconedtion mes be mosonly. Inssritisass oshopan c ent chas=scing =oe wion mes ofwan aggreganedtibe ock ob. l, [[etpletitple_tools/ery sitplel,' be _ock obc.ket.,954],[etpletitple_tools/ery sitplel,' be _ock obc.ket.,1039]], 3], etp,'te er ect verl: [etp,'te er ect verl, 'l, [[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',269]], 3], earrayn: [earrayn, 'l, [[efa pa net/Web/Javascripttiextral,'json.js',203]], 4307], ent,'conn: [ent,'conn, 'Conn ob ising MySQLodatasource l, [[efa pa net/I18N/corel,'MessageSource_MySQL.ket.,81]], 9], esett=\'rereferencrl: [esett=\'rereferencrl, 'Sebc e t=\'retfor ins a paramte sa ans twill b hl">$ed by referencrtfor ill callc. l, [[etpletitple_tools/ery sitplel,' be _ock obc.ket.,603]], 10], e_the crles/son: [e_the crles/son, 'F isoryaiorashe so. l, [[etpletitple_tools/ery sitplel,'http.ket.,90]], 3], etp,'tel: [etp,'tel, 'l, [[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',191]], 6], etallyn: [etallyn, 'l, [[etpletitple_tools/ery sitplel,' be _ock obc.ket.,804]], 5]}; CLASS_DATA={ e be p: [e be p, 'Seanncwion mes only servicenpan c ioraThde generatver ofw=oe wock obc. l, [[etpletitple_tools/ery sitplel,' be _ock obc.ket.,918]], 20], etp,'te er l: [etp,'te er l, 'l, [[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',126],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',167],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',209],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',293],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',332],[etpletitple_tools/ery sitple/docs/ rl,'s atial_ be s_docump(eannecread.',375]], 0], euot;tplecasrl: [euot;tplecasrl, 'Seandardtuot; The npan c ioradasi isdasi in tes ofwPHPaThde XPtstyle. Addc som honMfultstandard