Hex Artifact Content
Not logged in

Artifact c68677d586e72ce0c686a0759553ba21b41db693:

Wiki page [Embedding] by oehhar 2012-11-06 17:06:12.
0000: 44 20 32 30 31 32 2d 31 31 2d 30 36 54 31 37 3a  D 2012-11-06T17:
0010: 30 36 3a 31 32 2e 30 39 34 0a 4c 20 45 6d 62 65  06:12.094.L Embe
0020: 64 64 69 6e 67 0a 50 20 62 33 36 37 61 35 64 30  dding.P b367a5d0
0030: 32 33 61 36 61 61 32 36 34 39 63 63 34 35 31 65  23a6aa2649cc451e
0040: 63 30 37 37 37 62 36 37 66 30 33 35 37 37 31 61  c0777b67f035771a
0050: 0a 55 20 6f 65 68 68 61 72 0a 57 20 32 35 34 32  .U oehhar.W 2542
0060: 0a 3c 54 41 42 4c 45 20 63 6c 61 73 73 3d 74 6f  .<TABLE class=to
0070: 63 20 69 64 3d 74 6f 63 3e 0d 0a 20 20 3c 54 52  c id=toc>..  <TR
0080: 3e 0d 0a 20 20 20 20 3c 54 44 3e 0d 0a 20 20 20  >..    <TD>..   
0090: 20 20 20 3c 44 49 56 20 69 64 3d 74 6f 63 74 69     <DIV id=tocti
00a0: 74 6c 65 3e 0d 0a 20 20 20 20 20 20 3c 48 32 3e  tle>..      <H2>
00b0: 43 6f 6e 74 65 6e 74 73 3c 2f 48 32 3e 3c 2f 44  Contents</H2></D
00c0: 49 56 3e 0d 0a 20 20 20 20 20 20 3c 55 4c 3e 0d  IV>..      <UL>.
00d0: 0a 20 20 20 20 20 20 20 20 3c 4c 49 20 63 6c 61  .        <LI cla
00e0: 73 73 3d 74 6f 63 6c 65 76 65 6c 2d 31 3e 3c 41  ss=toclevel-1><A
00f0: 20 68 72 65 66 3d 22 23 4c 6f 61 64 69 6e 67 5f   href="#Loading_
0100: 74 68 65 5f 57 65 62 73 65 72 76 69 63 65 73 5f  the_Webservices_
0110: 45 6d 62 65 64 64 65 64 5f 50 61 63 6b 61 67 65  Embedded_Package
0120: 22 3e 3c 53 50 41 4e 0d 0a 20 20 20 20 20 20 20  "><SPAN..       
0130: 20 63 6c 61 73 73 3d 74 6f 63 6e 75 6d 62 65 72   class=tocnumber
0140: 3e 31 3c 2f 53 50 41 4e 3e 20 3c 53 50 41 4e 20  >1</SPAN> <SPAN 
0150: 63 6c 61 73 73 3d 74 6f 63 74 65 78 74 3e 4c 6f  class=toctext>Lo
0160: 61 64 69 6e 67 20 74 68 65 20 57 65 62 73 65 72  ading the Webser
0170: 76 69 63 65 73 0d 0a 20 20 20 20 20 20 20 20 45  vices..        E
0180: 6d 62 65 64 64 65 64 20 50 61 63 6b 61 67 65 3c  mbedded Package<
0190: 2f 53 50 41 4e 3e 3c 2f 41 3e 0d 0a 20 20 20 20  /SPAN></A>..    
01a0: 20 20 20 20 3c 4c 49 20 63 6c 61 73 73 3d 74 6f      <LI class=to
01b0: 63 6c 65 76 65 6c 2d 31 3e 3c 41 20 68 72 65 66  clevel-1><A href
01c0: 3d 22 23 4c 69 73 74 65 6e 22 3e 3c 53 50 41 4e  ="#Listen"><SPAN
01d0: 0d 0a 20 20 20 20 20 20 20 20 63 6c 61 73 73 3d  ..        class=
01e0: 74 6f 63 6e 75 6d 62 65 72 3e 32 3c 2f 53 50 41  tocnumber>2</SPA
01f0: 4e 3e 20 3c 53 50 41 4e 20 63 6c 61 73 73 3d 74  N> <SPAN class=t
0200: 6f 63 74 65 78 74 3e 53 70 65 63 69 66 79 20 61  octext>Specify a
0210: 20 50 6f 72 74 20 74 6f 20 52 65 63 65 69 76 65   Port to Receive
0220: 20 52 65 71 75 65 73 74 20 6f 6e 3c 2f 53 50 41   Request on</SPA
0230: 4e 3e 3c 2f 41 3e 0d 0a 20 20 20 20 20 20 20 20  N></A>..        
0240: 3c 4c 49 20 63 6c 61 73 73 3d 74 6f 63 6c 65 76  <LI class=toclev
0250: 65 6c 2d 31 3e 3c 41 20 68 72 65 66 3d 22 23 45  el-1><A href="#E
0260: 76 65 6e 74 51 75 65 75 65 22 3e 3c 53 50 41 4e  ventQueue"><SPAN
0270: 0d 0a 20 20 20 20 20 20 20 20 63 6c 61 73 73 3d  ..        class=
0280: 74 6f 63 6e 75 6d 62 65 72 3e 33 3c 2f 53 50 41  tocnumber>3</SPA
0290: 4e 3e 20 3c 53 50 41 4e 20 63 6c 61 73 73 3d 74  N> <SPAN class=t
02a0: 6f 63 74 65 78 74 3e 45 6e 74 65 72 20 74 68 65  octext>Enter the
02b0: 20 65 76 65 6e 74 20 71 75 65 75 65 3c 2f 53 50   event queue</SP
02c0: 41 4e 3e 3c 2f 41 3e 0d 0a 20 20 20 20 20 20 20  AN></A>..       
02d0: 20 3c 4c 49 20 63 6c 61 73 73 3d 74 6f 63 6c 65   <LI class=tocle
02e0: 76 65 6c 2d 31 3e 3c 41 20 68 72 65 66 3d 22 23  vel-1><A href="#
02f0: 53 74 6f 70 22 3e 3c 53 50 41 4e 0d 0a 20 20 20  Stop"><SPAN..   
0300: 20 20 20 20 20 63 6c 61 73 73 3d 74 6f 63 6e 75       class=tocnu
0310: 6d 62 65 72 3e 34 3c 2f 53 50 41 4e 3e 20 3c 53  mber>4</SPAN> <S
0320: 50 41 4e 20 63 6c 61 73 73 3d 74 6f 63 74 65 78  PAN class=toctex
0330: 74 3e 53 68 75 74 64 6f 77 6e 20 73 65 72 76 65  t>Shutdown serve
0340: 72 3c 2f 53 50 41 4e 3e 3c 2f 41 3e 0d 0a 20 20  r</SPAN></A>..  
0350: 20 20 20 20 3c 2f 55 4c 3e 0d 0a 20 20 20 20 3c      </UL>..    <
0360: 2f 54 44 3e 0d 0a 20 20 3c 2f 54 52 3e 0d 0a 3c  /TD>..  </TR>..<
0370: 2f 54 41 42 4c 45 3e 0d 0a 0d 0a 3c 41 20 6e 61  /TABLE>....<A na
0380: 6d 65 3d 4c 6f 61 64 69 6e 67 5f 74 68 65 5f 57  me=Loading_the_W
0390: 65 62 73 65 72 76 69 63 65 73 5f 45 6d 62 65 64  ebservices_Embed
03a0: 64 65 64 5f 50 61 63 6b 61 67 65 3e 3c 2f 41 3e  ded_Package></A>
03b0: 0d 0a 3c 48 32 3e 4c 6f 61 64 69 6e 67 20 74 68  ..<H2>Loading th
03c0: 65 20 57 65 62 73 65 72 76 69 63 65 73 20 53 65  e Webservices Se
03d0: 72 76 65 72 20 50 61 63 6b 61 67 65 20 3c 2f 48  rver Package </H
03e0: 32 3e 0d 0a 0d 0a 3c 50 3e 54 6f 20 6c 6f 61 64  2>....<P>To load
03f0: 20 74 68 65 20 77 65 62 73 65 72 76 69 63 65 73   the webservices
0400: 20 73 65 72 76 65 72 20 70 61 63 6b 61 67 65 2c   server package,
0410: 20 64 6f 3a 20 3c 2f 50 3e 3c 50 52 45 3e 20 70   do: </P><PRE> p
0420: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 57  ackage require W
0430: 53 3a 3a 45 6d 62 65 64 64 65 64 0d 0a 3c 2f 50  S::Embedded..</P
0440: 52 45 3e 0d 0a 3c 50 3e 54 68 69 73 20 63 6f 6d  RE>..<P>This com
0450: 6d 61 6e 64 20 77 69 6c 6c 20 6f 6e 6c 79 20 6c  mand will only l
0460: 6f 61 64 20 74 68 65 20 73 65 72 76 65 72 20 74  oad the server t
0470: 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 74  he first time it
0480: 20 69 73 20 75 73 65 64 2c 20 73 6f 20 69 74 0d   is used, so it.
0490: 0a 63 61 75 73 65 73 20 6e 6f 20 69 6c 6c 20 65  .causes no ill e
04a0: 66 66 65 63 74 73 20 74 6f 20 70 75 74 20 74 68  ffects to put th
04b0: 69 73 20 69 6e 20 65 61 63 68 20 66 69 6c 65 20  is in each file 
04c0: 64 65 63 6c 61 72 69 6e 67 20 61 20 73 65 72 76  declaring a serv
04d0: 69 63 65 20 6f 72 20 73 65 72 76 69 63 65 0d 0a  ice or service..
04e0: 70 72 6f 63 65 64 75 72 65 2e 20 3c 2f 50 3e 0d  procedure. </P>.
04f0: 0a 0d 0a 3c 48 52 20 2f 3e 0d 0a 0d 0a 3c 41 20  ...<HR />....<A 
0500: 6e 61 6d 65 3d 4c 69 73 74 65 6e 3e 3c 2f 41 3e  name=Listen></A>
0510: 0d 0a 3c 48 32 3e 53 70 65 63 69 66 79 20 61 20  ..<H2>Specify a 
0520: 50 6f 72 74 20 74 6f 20 52 65 63 65 69 76 65 20  Port to Receive 
0530: 52 65 71 75 65 73 74 20 6f 6e 3c 2f 48 32 3e 0d  Request on</H2>.
0540: 0a 0d 0a 3c 50 3e 3c 42 3e 50 72 6f 63 65 64 75  ...<P><B>Procedu
0550: 72 65 20 4e 61 6d 65 26 6e 62 73 70 3b 3a 20 3c  re Name&nbsp;: <
0560: 49 3e 3a 3a 57 53 3a 3a 45 6d 62 65 64 65 64 3a  I>::WS::Embeded:
0570: 3a 4c 69 73 74 65 6e 3c 2f 49 3e 3c 2f 42 3e 20  :Listen</I></B> 
0580: 3c 2f 50 3e 0d 0a 3c 50 3e 3c 42 3e 44 65 73 63  </P>..<P><B>Desc
0590: 72 69 70 74 69 6f 6e 3c 2f 42 3e 26 6e 62 73 70  ription</B>&nbsp
05a0: 3b 3a 20 49 6e 73 74 72 75 63 74 20 74 68 65 20  ;: Instruct the 
05b0: 6d 6f 64 75 6c 65 20 74 6f 20 6c 69 73 74 65 6e  module to listen
05c0: 20 6f 6e 20 61 20 50 6f 72 74 2c 20 73 65 63 75   on a Port, secu
05d0: 72 69 74 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  rity information
05e0: 2e 0d 0a 3c 50 3e 3c 42 3e 41 72 67 75 6d 65 6e  ...<P><B>Argumen
05f0: 74 73 3c 2f 42 3e 26 6e 62 73 70 3b 3a 20 74 68  ts</B>&nbsp;: th
0600: 69 73 20 70 72 6f 63 65 64 75 72 65 20 75 73 65  is procedure use
0610: 73 20 70 6f 73 69 74 69 6f 6e 20 64 65 70 65 6e  s position depen
0620: 64 65 6e 74 20 61 72 67 75 6d 65 6e 74 73 2c 0d  dent arguments,.
0630: 0a 74 68 65 79 20 61 72 65 3a 20 3c 2f 50 3e 0d  .they are: </P>.
0640: 0a 3c 50 52 45 3e 0d 0a 20 20 20 20 20 3c 49 3e  .<PRE>..     <I>
0650: 70 6f 72 74 20 20 20 20 3c 2f 49 3e 20 2d 2d 20  port    </I> -- 
0660: 50 6f 72 74 20 6e 75 6d 62 65 72 20 74 6f 20 6c  Port number to l
0670: 69 73 74 65 6e 20 6f 6e 2e 0d 0a 20 20 20 20 20  isten on...     
0680: 3c 49 3e 63 65 72 74 66 69 6c 65 3c 2f 49 3e 20  <I>certfile</I> 
0690: 2d 2d 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 63  -- Name of the c
06a0: 65 72 74 69 66 69 63 61 74 65 20 66 69 6c 65 2e  ertificate file.
06b0: 20 44 65 66 61 75 6c 74 73 20 74 6f 20 7b 7d 2e   Defaults to {}.
06c0: 0d 0a 20 20 20 20 20 3c 49 3e 6b 65 79 66 69 6c  ..     <I>keyfil
06d0: 65 20 3c 2f 49 3e 20 2d 2d 20 4e 61 6d 65 20 6f  e </I> -- Name o
06e0: 66 20 74 68 65 20 6b 65 79 20 66 69 6c 65 2e 20  f the key file. 
06f0: 44 65 66 61 75 6c 74 73 20 74 6f 20 7b 7d 2e 0d  Defaults to {}..
0700: 0a 20 20 20 20 20 3c 49 3e 75 73 65 72 70 77 64  .     <I>userpwd
0710: 73 3c 2f 49 3e 20 2d 2d 20 41 20 6c 69 73 74 20  s</I> -- A list 
0720: 6f 66 20 75 73 65 72 6e 61 6d 65 3a 70 61 73 73  of username:pass
0730: 77 6f 72 64 2e 20 44 65 66 61 75 6c 74 73 20 74  word. Defaults t
0740: 6f 20 7b 7d 2e 0d 0a 20 20 20 20 20 3c 49 3e 72  o {}...     <I>r
0750: 65 61 6c 6d 20 20 20 3c 2f 49 3e 20 2d 2d 20 54  ealm   </I> -- T
0760: 68 65 20 73 65 75 63 72 69 74 79 20 72 65 61 6c  he seucrity real
0770: 6d 2e 20 44 65 66 61 75 6c 74 73 20 74 6f 20 7b  m. Defaults to {
0780: 7d 2e 0d 0a 3c 2f 50 52 45 3e 0d 0a 3c 50 3e 3c  }...</PRE>..<P><
0790: 42 3e 52 65 74 75 72 6e 73 3c 2f 42 3e 26 6e 62  B>Returns</B>&nb
07a0: 73 70 3b 3a 20 48 61 6e 64 6c 65 20 6f 66 20 73  sp;: Handle of s
07b0: 6f 63 6b 65 74 20 3c 2f 50 3e 0d 0a 3c 50 3e 3c  ocket </P>..<P><
07c0: 42 3e 53 69 64 65 2d 45 66 66 65 63 74 73 3c 2f  B>Side-Effects</
07d0: 42 3e 26 6e 62 73 70 3b 3a 20 4e 6f 6e 65 20 3c  B>&nbsp;: None <
07e0: 2f 50 3e 0d 0a 3c 50 3e 3c 42 3e 45 78 63 65 70  /P>..<P><B>Excep
07f0: 74 69 6f 6e 20 43 6f 6e 64 69 74 69 6f 6e 73 3c  tion Conditions<
0800: 2f 42 3e 26 6e 62 73 70 3b 3a 20 26 6e 62 73 70  /B>&nbsp;: &nbsp
0810: 3b 3a 20 4e 6f 6e 65 20 3c 2f 50 3e 0d 0a 3c 50  ;: None </P>..<P
0820: 3e 3c 42 3e 50 72 65 2d 72 65 71 75 69 73 69 74  ><B>Pre-requisit
0830: 65 20 43 6f 6e 64 69 74 69 6f 6e 73 3c 2f 42 3e  e Conditions</B>
0840: 26 6e 62 73 70 3b 3a 20 4e 6f 6e 65 20 3c 2f 50  &nbsp;: None </P
0850: 3e 0d 0a 3c 48 52 20 2f 3e 0d 0a 0d 0a 3c 41 20  >..<HR />....<A 
0860: 6e 61 6d 65 3d 45 76 65 6e 74 51 75 65 75 65 3e  name=EventQueue>
0870: 3c 2f 41 3e 0d 0a 3c 48 32 3e 45 6e 74 65 72 20  </A>..<H2>Enter 
0880: 74 68 65 20 65 76 65 6e 74 20 71 75 65 75 65 3c  the event queue<
0890: 2f 48 32 3e 0d 0a 0d 0a 3c 50 3e 54 6f 20 73 65  /H2>....<P>To se
08a0: 72 76 65 20 61 6e 79 20 72 65 71 75 65 73 74 73  rve any requests
08b0: 2c 20 74 68 65 20 69 6e 74 65 72 70 72 65 74 65  , the interprete
08c0: 72 20 6d 75 73 74 20 65 6e 74 65 72 20 74 68 65  r must enter the
08d0: 20 65 76 65 6e 74 20 71 75 65 75 65 20 75 73 69   event queue usi
08e0: 6e 67 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 3a  ng, for example:
08f0: 3c 2f 50 3e 0d 0a 3c 50 52 45 3e 0d 0a 20 20 20  </P>..<PRE>..   
0900: 20 20 76 77 61 69 74 20 77 61 69 74 56 61 72 69    vwait waitVari
0910: 61 62 6c 65 0d 0a 3c 2f 50 52 45 3e 0d 0a 3c 48  able..</PRE>..<H
0920: 52 20 2f 3e 0d 0a 0d 0a 3c 41 20 6e 61 6d 65 3d  R />....<A name=
0930: 53 74 6f 70 3e 3c 2f 41 3e 0d 0a 3c 48 32 3e 53  Stop></A>..<H2>S
0940: 74 6f 70 20 74 68 65 20 73 65 72 76 65 72 3c 2f  top the server</
0950: 48 32 3e 0d 0a 0d 0a 3c 50 3e 54 6f 20 73 74 6f  H2>....<P>To sto
0960: 70 20 73 65 72 76 69 6e 67 20 72 65 71 75 65 73  p serving reques
0970: 74 73 2c 20 74 68 65 20 73 65 72 76 65 72 20 73  ts, the server s
0980: 6f 63 6b 65 74 20 6d 61 79 20 62 65 20 63 6c 6f  ocket may be clo
0990: 73 65 64 2e 0d 0a 54 68 65 20 73 6f 63 6b 65 74  sed...The socket
09a0: 20 68 61 6e 64 6c 65 20 77 61 73 20 72 65 74 75   handle was retu
09b0: 72 6e 65 64 20 62 79 20 3c 49 3e 3a 3a 57 53 3a  rned by <I>::WS:
09c0: 3a 45 6d 62 65 64 65 64 3a 3a 4c 69 73 74 65 6e  :Embeded::Listen
09d0: 3c 2f 49 3e 2e 0d 0a 4f 70 74 69 6f 6e 61 6c 6c  </I>...Optionall
09e0: 79 2c 20 74 68 65 20 65 76 65 6e 74 20 71 75 65  y, the event que
09f0: 75 65 20 6d 61 79 20 62 65 20 73 74 6f 70 70 65  ue may be stoppe
0a00: 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 3c 2f 50  d as follows:</P
0a10: 3e 0d 0a 3c 50 52 45 3e 0d 0a 20 20 20 20 20 63  >..<PRE>..     c
0a20: 6c 6f 73 65 20 24 68 61 6e 64 6c 65 0d 0a 20 20  lose $handle..  
0a30: 20 20 20 73 65 74 20 77 61 69 74 56 61 72 69 61     set waitVaria
0a40: 62 6c 65 20 31 0d 0a 3c 2f 50 52 45 3e 0d 0a 0a  ble 1..</PRE>...
0a50: 5a 20 33 35 37 30 37 38 66 30 30 64 36 35 30 36  Z 357078f00d6506
0a60: 31 31 31 32 33 64 61 65 65 62 66 66 30 36 36 66  11123daeebff066f
0a70: 61 33 0a                                         a3.