View on
MetaCPAN
Olaf Alders > LWP-Protocol-GHTTP-6.17 > LWP::Protocol::GHTTP

Download:
LWP-Protocol-GHTTP-6.17.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 6.17   Source  

NAME ^

LWP::Protocol::GHTTP - (DEPRECATED) Provide GHTTP support for LWP::UserAgent via HTTP::GHTTP.

SYNOPSIS ^

    use strict;
    use warnings;
    use LWP::UserAgent;

    # create a new object
    LWP::Protocol::implementor('http', 'LWP::Protocol::GHTTP');
    my $ua = LWP::UserAgent->new();
    my $res = $ua->get('http://www.example.com');
    # note that we can only support the GET HEAD and POST verbs.

DESCRIPTION ^

This module depends on the GNOME libghttp http://ftp.gnome.org/pub/gnome/sources/libghttp project. That project is no longer in development. If you are trying to use this module, you'd likely do better to just use LWP::Protocol::http or LWP::Protocol::https.

LWP::Protocol::GHTTP is only capable of dispatching requests using the GET, POST, or HEAD verbs.

You have been warned.

The LWP::Protocol::GHTTP module provides support for using HTTP schemed URLs with LWP. This module is a plug-in to the LWP protocol handling, but since it takes over the HTTP scheme, you have to tell LWP we want to use this plug-in by calling LWP::Protocol's implementor function.

This module used to be bundled with libwww-perl, but it was unbundled in v6.16 in order to be able to declare its dependencies properly for the CPAN tool-chain. Applications that need GHTTP support can just declare their dependency on LWP::Protocol::GHTTP and will no longer need to know what underlying modules to install.

CAVEATS ^

WARNING!

This module depends on the GNOME libghttp http://ftp.gnome.org/pub/gnome/sources/libghttp project. That project is no longer in development. If you are trying to use this module, you'd likely do better to just use LWP::Protocol::http or LWP::Protocol::https.

Also, LWP::Protocol::GHTTP is only capable of dispatching requests using the GET, POST, or HEAD verbs.

FUNCTIONS ^

LWP::Protocol::GHTTP inherits all functions from LWP::Protocol and provides the following overriding functions.

request

    my $response = $ua->request($request, $proxy, undef);
    my $response = $ua->request($request, $proxy, '/tmp/sss');
    my $response = $ua->request($request, $proxy, \&callback, 1024);

Dispatches a request over the HTTP protocol and returns a response object. Refer to LWP::UserAgent for description of the arguments.

AUTHOR ^

Gisle Aas <gisle@ActiveState.com>

CONTRIBUTORS ^

BUGS ^

Please report any bugs or feature requests on GitHub https://github.com/genio/lwp-protocol-ghttp/issues. We appreciate any and all criticism, bug reports, enhancements, or fixes.

LICENSE AND COPYRIGHT ^

Copyright 1997-2011 Gisle Aas.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: