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 : <
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> 
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> : 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> : 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> :  
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 : 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.