NAME

DTA::CAB::Client - abstract class for DTA::CAB server clients

SYNOPSIS

            

              
              
use DTA::CAB::Client;
##========================================================================
## Constructors etc.
$cli = DTA::CAB::Client->new(%args);
undef = $cli->initialize();
##========================================================================
## Methods: Generic Client API: Connections
$bool = $cli->connected;
$bool = $cli->connect();
$bool = $cli->disconnect();
@analyzers = $cli->analyzers();
##========================================================================
## Methods: Generic Client API: Queries
$tok  = $cli->analyzeToken($analyzer, $tok, \%opts);
$sent = $cli->analyzeSentence($analyzer, $sent, \%opts);
$doc  = $cli->analyzeDocument($analyzer, $doc, \%opts);
$str  = $cli->analyzeData($analyzer, $str, \%opts);
            
          

DESCRIPTION

Abstract base class / API specification for generic DTA::CAB clients.

Globals

Variable: @ISA

DTA::CAB::Client inherits from DTA::CAB::Logger.

Constructors etc.

new

            

              
              
$obj = CLASS_OR_OBJ->new(%args);
            
          

%args, %$obj: none here; see subclass documentation for details.

initialize

            

              
              
undef = $obj->initialize();
            
          

Called to initialize new objects after new(). Default implementation does nothing.

Methods: Generic Client API: Connections

connected

            

              
              
$bool = $cli->connected;
            
          

Returns true iff a connection to the selected server has been established. Default implementation always returns false.

connect

            

              
              
$bool = $cli->connect();
            
          

Establish a connection to the selected sever; returns true on success, false otherwise. Default implementation just calls "connected"().

disconnect

            

              
              
$bool = $cli->disconnect();
            
          

Close current connection, if any. Default implementation just calls "connected"().

analyzers

            

              
              
@analyzers = $cli->analyzers();
            
          

Return a list of analyzers known by the server. Default implementation just returns an empty list.

Methods: Generic Client API: Queries

analyzeToken

            

              
              
$tok = $cli->analyzeToken($analyzer, $tok, \%opts);
            
          

Server-side token (type) analysis. $analyzer is the name of an analyzer known to the server.

Default implementation just croak()s.

analyzeSentence

            

              
              
$sent = $cli->analyzeSentence($analyzer, $sent, \%opts);
            
          

Server-side sentence analysis. $analyzer is the name of an analyzer known to the server.

Default implementation just croak()s.

analyzeDocument

            

              
              
$doc = $cli->analyzeDocument($analyzer, $doc, \%opts);
            
          

Server-side document analysis. $analyzer is the name of an analyzer known to the server.

Default implementation just croak()s.

analyzeData

            

              
              
$data = $cli->analyzeData($analyzer, $data, \%opts);
            
          

Server-side raw data analysis. $analyzer is the name of an analyzer known to the server, and $data is a string buffer to be analyzed, in some format parseable by the server. Depending on the client and server used, the data format must be specified in %opts.

Default implementation just croak()s.

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009-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.