NAME

DTA::CAB::Server::HTTP::Handler::QueryFormats - CAB HTTP Server: request handler: format list queries

SYNOPSIS

##========================================================================
## PRELIMINARIES

use DTA::CAB::Server::HTTP::Handler::QueryFormats;

##========================================================================
## Methods: API

$h = $class_or_obj->new(%options);
$bool = $h->prepare($server);
$bool = $path->run($server, $localPath, $clientSocket, $httpRequest);

DESCRIPTION

DTA::CAB::Server::HTTP::Handler::QueryFormats is a request handler class for use with a DTA::CAB::Server::HTTP server which handles format list queries for a selected DTA::CAB::Server::HTTP::Handler::Query handler.

Globals

Variable: @ISA

DTA::CAB::Server::HTTP::Handler::QueryFormats inherits from DTA::CAB::Server::HTTP::Handler::CGI and implements the DTA::CAB::Server::HTTP::Handler API.

Methods: API

new

$h = $class_or_obj->new(%options);

%$h, %options:

(
 ##-- INHERITED from Handler::CGI
 #encoding => $defaultEncoding,  ##-- default encoding (UTF-8)
 allowGet => $bool,             ##-- allow GET requests? (default=1)
 allowPost => $bool,            ##-- allow POST requests? (default=1)
 allowList => $bool,            ##-- if true, allowed analyzers will be listed for 'PATHROOT/.../list' paths
 pushMode => $mode,             ##-- push mode for addVars (default='keep')
 ##
 ##-- NEW in Handler::QueryFormats
 qh => $qh,                     ##-- associated query handler
)

prepare

$bool = $h->prepare($server);

Checks that $h->{qh} is defined.

run

$bool = $path->run($server, $localPath, $clientSocket, $httpRequest);

Process $httpRequest matching $localPath as CGI form-encoded format list query. The following CGI form parameters are supported:

(
 f => $analyerRegex,            ##-- format name regex for $qh->{formats}
 fmt => $format,                ##-- I/O format
 #enc => $enc,                   ##-- I/O encoding
 pretty => $level,              ##-- pretty-printing level
 raw => $bool,                  ##-- if true, data will be returned as text/plain (default=$h->{returnRaw})
)

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2011-2019 by Bryan Jurish

This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.24.1 or, at your option, any later version of Perl 5 you may have available.

SEE ALSO

DTA::CAB::Server::HTTP::Handler::Query(3pm), DTA::CAB::Server::HTTP::Handler::CGI(3pm), DTA::CAB::Server::HTTP::Handler(3pm), DTA::CAB::Server::HTTP(3pm), DTA::CAB(3pm), perl(1), ...