catalyst::controller::sru(3pm) [debian man page]

Catalyst::Controller::SRU(3pm)				User Contributed Perl Documentation			    Catalyst::Controller::SRU(3pm)

NAME

       Catalyst::Controller::SRU - Dispatch SRU methods with Catalyst

SYNOPSIS

	   package MyApp::Controller::SRU;

	   # use it as a base controller
	   use base qw( Catalyst::Controller::SRU );

	   # explain, scan and searchretrieve methods
	   sub explain {
	       my ( $self, $c,
		   $sru_request,  # ISA SRU::Request::Explain
		   $sru_response, # ISA SRU::Response::Explain
	       ) = @_;
	   }

	   sub scan {
	       my ( $self, $c,
		   $sru_request,  # ISA SRU::Request::Scan
		   $sru_response, # ISA SRU::Response::Scan
		   $cql,	  # ISA CQL::Parser root node
	       ) = @_;

	   }

	   sub searchRetrieve {
	       my ( $self, $c,
		   $sru_request,  # ISA SRU::Request::SearchRetrieve
		   $sru_response, # ISA SRU::Response::SearchRetrieve
		   $cql,	  # ISA CQL::Parser root node
	       ) = @_;
	   }

DESCRIPTION

       This module allows your controller class to dispatch SRU actions ("explain", "scan", and "searchRetrieve") from its own class.

METHODS

   index : Private
       This method will create an SRU request, response and possibly a CQL object based on the type of SRU request it finds. It will then pass the
       data over to your customized method.

SEE ALSO

       o   Catalyst

AUTHOR

       Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2005-2009 by Brian Cassidy

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

perl v5.12.4							    2009-12-02					    Catalyst::Controller::SRU(3pm)

SRU::Response::Term(3pm)				User Contributed Perl Documentation				  SRU::Response::Term(3pm)

NAME

       SRU::Response::Term - A class for representing terms in a Scan response

SYNOPSIS

DESCRIPTION

       A SRU::Response::Term object bundles up information about a single term contained in a SRU::Response::Scan object. A scan object can
       contain multiple term objects.

METHODS

   new()
       THe constructor which you must at least pass the value parameter:

	   my $term = SRU::Response::Term->new( term => "Foo Fighter" );

       In addition you can pass the numberOfRecords, displayTerm, whereInList, and extraTermData parameters, or set them separately with their
       accessors.

   value()
       The term exactly as it appears in the index. This term should be able to be sent in a query as is to retrieve the records it derives from.

   numberOfRecords()
       The number of records which would be matched if the index in the request's scanClause was searched with the term in the 'value' field.

   displayTerm()
       A string to display to the end user in place of the term itself. For example this might add back in stopwords which do not appear in the
       index, or diacritics which have been normalised.

   whereInList()
       A flag to indicate the position of the term within the complete term list. It must be one of the following values: 'first' (the first
       term), 'last' (the last term), 'only' (the only term) or 'inner' (any other term).

   extraTermData()
       Additional profile specific information. More details are available in the extensions section.

   asXML()
perl v5.12.4							    2009-11-20						  SRU::Response::Term(3pm)