home *** CD-ROM | disk | FTP | other *** search
/ Netrunner 2004 October / NETRUNNER0410.ISO / regular / ActivePerl-5.8.4.810-MSWin32-x86.msi / _a3353a68153b0f4461592ce3c768f47d < prev    next >
Text File  |  2004-06-01  |  4KB  |  132 lines
  1. # ======================================================================
  2. #
  3. # Copyright (C) 2000-2001 Paul Kulchenko (paulclinger@yahoo.com)
  4. # SOAP::Lite is free software; you can redistribute it
  5. # and/or modify it under the same terms as Perl itself.
  6. #
  7. # $Id: Lite.pm,v 1.3 2001/08/11 19:09:57 paulk Exp $
  8. #
  9. # ======================================================================
  10.  
  11. package Apache::XMLRPC::Lite;
  12.  
  13. use strict;
  14. use vars qw(@ISA $VERSION);
  15. use XMLRPC::Transport::HTTP;
  16.  
  17. @ISA = qw(XMLRPC::Transport::HTTP::Apache);
  18. $VERSION = sprintf("%d.%s", map {s/_//g; $_} q$Name: release-0_55-public $ =~ /-(\d+)_([\d_]+)/);
  19.  
  20. my $server = __PACKAGE__->new;
  21.  
  22. sub handler {
  23.   $server->configure(@_);
  24.   $server->SUPER::handler(@_);
  25. }
  26.  
  27. # ======================================================================
  28.  
  29. 1;
  30.  
  31. __END__
  32.  
  33. =head1 NAME
  34.  
  35. Apache::XMLRPC::Lite - mod_perl-based XML-RPC server with minimum configuration
  36.  
  37. =head1 SYNOPSIS
  38.  
  39. =over 4
  40.  
  41. =item httpd.conf (Location), directory-based access
  42.  
  43.   <Location /mod_xmlrpc>
  44.     SetHandler perl-script
  45.     PerlHandler Apache::XMLRPC::Lite
  46.     PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
  47.     PerlSetVar options "compress_threshold => 10000"
  48.   </Location>
  49.  
  50. =item httpd.conf (Files), file-based access
  51.  
  52.   <FilesMatch "\.xmlrpc$">
  53.     SetHandler perl-script
  54.     PerlHandler Apache::XMLRPC::Lite
  55.     PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
  56.     PerlSetVar options "compress_threshold => 10000"
  57.   </FilesMatch>
  58.  
  59. =item .htaccess, directory-based access
  60.  
  61.   SetHandler perl-script
  62.   PerlHandler Apache::XMLRPC::Lite
  63.   PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
  64.   PerlSetVar options "compress_threshold => 10000"
  65.  
  66. =back
  67.  
  68. =head1 DESCRIPTION
  69.  
  70. This Apache Perl module provides the ability to add support for XML-RPC 
  71. protocol with easy configuration (either in .conf or in .htaccess file). 
  72. This functionality should give you lightweight option
  73. for hosting SOAP services and greatly simplify configuration aspects. This
  74. module inherites functionality from XMLRPC::Transport::HTTP::Apache component
  75. of XMLRPC::Lite module.
  76.  
  77. =head1 CONFIGURATION
  78.  
  79. The module can be placed in <Location>, <Directory>, <Files>, <FilesMatch>
  80. directives in main server configuration areas or directly in .htaccess file.
  81.  
  82. All parameters should be quoted and can be separated with commas or spaces 
  83. for lists ("a, b, c") and with 'wide arrows' and commas for hash parameters 
  84. ("key1 => value1, key2 => value2").
  85.  
  86. All options that you can find in XMLRPC::Transport::HTTP::Apache component
  87. are available for configuration. Here is the description of most important
  88. ones.
  89.  
  90. =over 4
  91.  
  92. =item dispatch_to (LIST)
  93.  
  94. Specifies path to directory that contains Perl modules you'd like to give 
  95. access to, or just list of modules (for preloaded modules).
  96.  
  97.   PerlSetVar dispatch_to "/Your/Path/To/Deployed/Modules, Module::Name, Module::method"
  98.  
  99. =item options (HASH)
  100.  
  101. Specifies list of options for your module, for example threshold for 
  102. compression. Future versions will support more options. See 
  103. XMLRPC::Transport::HTTP documentation for other options.
  104.  
  105.   PerlSetVar options "compress_threshold => 10000"
  106.  
  107. =back
  108.  
  109. =head1 DEPENDENCIES
  110.  
  111.  XMLRPC::Lite
  112.  mod_perl
  113.  
  114. =head1 SEE ALSO
  115.  
  116.  XMLRPC::Transport::HTTP::Apache for implementation details,
  117.  XMLRPC::Lite for general information, and
  118.  F<examples/server/mod_xmlrpc.htaccess> for .htaccess example
  119.  
  120. =head1 COPYRIGHT
  121.  
  122. Copyright (C) 2000-2001 Paul Kulchenko. All rights reserved.
  123.  
  124. This library is free software; you can redistribute it and/or modify
  125. it under the same terms as Perl itself.
  126.  
  127. =head1 AUTHOR
  128.  
  129. Paul Kulchenko (paulclinger@yahoo.com)
  130.  
  131. =cut
  132.