home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _6c60f5696a1520e76606e6b39a347fbf < prev    next >
Text File  |  2000-03-23  |  4KB  |  113 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>SOAP::Transport::HTTP::CGI - Generic SOAP CGI handler</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> SOAP::Transport::HTTP::CGI - Generic SOAP CGI handler</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <UL>
  26.  
  27.         <LI><A HREF="#handler(safeclasshash, optionaldispatcher)">handler(SafeClassHash, OptionalDispatcher)</A></LI>
  28.     </UL>
  29.  
  30.     <LI><A HREF="#dependencies">DEPENDENCIES</A></LI>
  31.     <LI><A HREF="#author">AUTHOR</A></LI>
  32. </UL>
  33. <!-- INDEX END -->
  34.  
  35. <HR>
  36. <P>
  37. <H1><A NAME="name">NAME</A></H1>
  38. <P>SOAP::Transport::HTTP::CGI - Generic SOAP CGI handler</P>
  39. <P>
  40. <HR>
  41. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  42. <UL>
  43. <LI>Linux</LI>
  44. <LI>Solaris</LI>
  45. <LI>Windows</LI>
  46. </UL>
  47. <HR>
  48. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  49. <P>Use this class to expose SOAP endpoints using vanilla CGI.
  50. Here's an example SOAP endpoint exposed using this class:</P>
  51. <PRE>
  52.     package ServerDemo;
  53.     use strict;
  54.     use SOAP::Transport::HTTP::CGI;</PRE>
  55. <PRE>
  56.     sub handler {
  57.         my $safe_classes = {
  58.             Calculator => undef,
  59.         };
  60.       SOAP::Transport::HTTP::CGI->handler($safe_classes);
  61.     }</PRE>
  62. <PRE>
  63.     1;</PRE>
  64. <P>(I leave it up to you to figure out how to get Perl scripts
  65. to run as CGI scripts - please see your Perl docs for details)</P>
  66. <P>
  67. <HR>
  68. <H1><A NAME="description">DESCRIPTION</A></H1>
  69. <P>This class encapsulates the details of hooking up to CGI,
  70. and then calls SOAP::Transport::HTTP::Server to do the SOAP-specific
  71. stuff. This way the Server class can be reused with any web server
  72. configuration (including mod_perl), by simply composing it with a different
  73. front-end (for instance, SOAP::Transport::HTTP::Apache, for instance.</P>
  74. <P>
  75. <H2><A NAME="handler(safeclasshash, optionaldispatcher)">handler(SafeClassHash, OptionalDispatcher)</A></H2>
  76. <P>This is the only method on the class, and you must pass a
  77. hash reference whose keys contain the collection of classes
  78. that may be invoked at this endpoint. If you specify class
  79. FooBar in this list, for instance, and a client sends a SOAP
  80. request to <A HREF="http://yourserver/soap?class=FooBar,">http://yourserver/soap?class=FooBar,</A> then the
  81. SOAP::Transport::HTTP::Server class will eventually attempt
  82. to load FooBar.pm, instatiate a FooBar, and call
  83. its handle_request function (see SOAP::Transport::HTTP::Server
  84. for more detail). If you don't include a class in this hash,
  85. SOAP/Perl won't run it. I promise.</P>
  86. <P>By the way, only the keys in this hash are important, the
  87. values are ignored.</P>
  88. <P>Also, nothing is stopping you from messing around with the response
  89. yourself if you'd like to add some headers or whatever;
  90. you can always call <A HREF="../../../../../lib/Pod/perlfunc.html#item_print"><CODE>print()</CODE></A> dump more headers to STDOUT.
  91. Just make sure you finish what you're doing before you
  92. return to SOAP::Transport::HTTP::Server, because at that
  93. point the response is marshaled and sent back.</P>
  94. <P>See SOAP::Transport::HTTP::Server for details on the
  95. OptionalDispatcher parameter.</P>
  96. <P>
  97. <HR>
  98. <H1><A NAME="dependencies">DEPENDENCIES</A></H1>
  99. <P>SOAP::Transport::HTTP::Server</P>
  100. <P>
  101. <HR>
  102. <H1><A NAME="author">AUTHOR</A></H1>
  103. <P>Keith Brown</P>
  104. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  105. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  106. <STRONG><P CLASS=block> SOAP::Transport::HTTP::CGI - Generic SOAP CGI handler</P></STRONG>
  107. </TD></TR>
  108. </TABLE>
  109.  
  110. </BODY>
  111.  
  112. </HTML>
  113.