NAME

Prty::Http::Client - HTTP-Client

BASE CLASS

Prty::Object

DESCRIPTION

Die Klasse implementiert einen HTTP-Client für GET- und POST-Requests.

Die zentrale Methode ist $class->"sendReceive"(). Diese sendet eine HTTP-Request-Message, die der Aufrufer konfiguriert hat, an einen Server (URL), und gibt die HTTP-Response-Message des Servers zurück. Die Methode beherrscht GET- und POSTS-Requests. Auf ihrer Basis sind die spezielleren Methoden $class->"get"() und $class->"post"() implementiert. Die HTTP-Messages, sowohl gesendete als auch empfangene, sind Instanzen der Klasse Prty::HTTP::Message.

EXAMPLE

Universeller Client

Siehe prty-http-client

GET-Request

    my $msg = Prty::Http::Client->get($url);
    print $msg->asString;

POST-Request

    my $sMsg = Prty::Http::Message->new(
        contentType=>'text/plain',
        contentLength=>-1,
        body=>'Dies ist ein Test',
    );
    my $rMsg = Prty::Http::Client->put($url,$sMsg);
    print $rMsg->asString;

METHODS

Klassenmethoden

sendReceive() - Führe HTTP-Request aus

Synopsis

    $rMsg = $class->sendReceive($op,$url,$sMsg,@opt);

Description

Führe HTTP Request vom Typ $op gegen URL $url mit HTTP-Nachricht $sMsg aus und liefere die vom Server gelieferte Antwort $rMsg zurück.

Arguments

$op

Die HTTP-Operation: 'post' oder 'get'.

$url

Der URL, gegen den die Operation ausgeführt wird.

$sMsg

Die HTTP-Nachricht, die gesendet wird. Dies ist eine Instanz der Klasse Prty::Http::Message.

Options

-debug => $bool (Default: 0)

Gib die kommunizierten Daten (Request, Response) und Metainformation (Zeitmessung) auf STDOUT aus.

-redirect => $bool (Default: 1)

Führe Redirects automatisch aus.

get() - Führe GET-Request aus

Synopsis

    $msg = $class->get($url,@opt);

Description

Führe HTTP POST-Request mit URL $url aus und liefere die vom Server gelieferte Antwort zurück.

Arguments

$url

Der URL, gegen den der GET-Request ausgeführt wird.

$sMsg

Die HTTP-Nachricht, die gesendet wird. Dies ist eine Instanz der Klasse Prty::Http::Message.

Options

Siehe Methode "sendReceive"().

post() - Führe POST-Request aus

Synopsis

    $rMsg = $class->post($url,$sMsg,@opt);

Description

Führe HTTP POST-Request gegen URL $url und mit HTTP-Nachricht $sMsg aus und liefere die vom Server gelieferte Antwort zurück.

Arguments

$url

Der URL, gegen den der GET-Request ausgeführt wird.

Options

Siehe Methode "sendReceive"().

VERSION

1.108

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2017 Frank Seitz

LICENSE

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

cpanm Prty

perl -MCPAN -e shell
install Prty