/ 
Quiq-1.222
River stage zero No dependents
/ Quiq::Http::Client

NAME

Quiq::Http::Client - HTTP-Client

BASE CLASS

Quiq::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 Quiq::HTTP::Message.

EXAMPLE

Universeller Client

Siehe quiq-http-client

GET-Request

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

POST-Request

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

METHODS

Klassenmethoden

sendReceive() - Führe HTTP-Request aus

Synopsis

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

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

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.

get() - Führe GET-Request aus

Synopsis

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

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 Quiq::Http::Message.

Options

Siehe Methode sendReceive().

Description

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

post() - Führe POST-Request aus

Synopsis

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

Arguments

$url

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

Options

Siehe Methode sendReceive().

Description

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

VERSION

1.222

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2024 Frank Seitz

LICENSE

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