| InfoSys-FreeDB documentation | Contained in the InfoSys-FreeDB distribution. |
InfoSys::FreeDB::Response::Write::1 - FreeDB write first pass response
This class is used internally by the InfoSys::FreeDB::Connection::CDDBP class.
FreeDB write first pass response
InfoSys::FreeDB::Response::Write::1 contains information about FreeDB write first pass responses.
Creates a new InfoSys::FreeDB::Response::Write::1 object. OPT_HASH_REF is a hash reference used to pass initialization options. OPT_HASH_REF is mandatory. On error an exception Error::Simple is thrown.
Options for OPT_HASH_REF may include:
categPassed to set_categ().
discidPassed to set_discid().
Options for OPT_HASH_REF inherited through package InfoSys::FreeDB::Response may include:
codePassed to set_code(). Mandatory option.
errorPassed to set_error().
resultPassed to set_result(). Mandatory option.
Creates a new InfoSys::FreeDB::Response::Write::1 object from the specified content reference. CONTENT_REF is a string reference. On error an exception Error::Simple is thrown.
Returns the CD category.
This method is inherited from package InfoSys::FreeDB::Response. Returns the response code.
Returns the CD disk ID number.
This method is inherited from package InfoSys::FreeDB::Response. Returns the response result text.
This method is inherited from package InfoSys::FreeDB::Response. Returns whether the response has an error or not.
Set the CD category. VALUE is the value. On error an exception Error::Simple is thrown.
This method is inherited from package InfoSys::FreeDB::Response. Set the response code. VALUE is the value. On error an exception Error::Simple is thrown.
Set the CD disk ID number. VALUE is the value. On error an exception Error::Simple is thrown.
This method is inherited from package InfoSys::FreeDB::Response. State that the response has an error. VALUE is the value. On error an exception Error::Simple is thrown.
This method is inherited from package InfoSys::FreeDB::Response. Set the response result text. VALUE is the value. On error an exception Error::Simple is thrown.
InfoSys::FreeDB, InfoSys::FreeDB::Connection, InfoSys::FreeDB::Connection::CDDBP, InfoSys::FreeDB::Connection::HTTP, InfoSys::FreeDB::Entry, InfoSys::FreeDB::Entry::Track, InfoSys::FreeDB::Match, InfoSys::FreeDB::Response, InfoSys::FreeDB::Response::DiscId, InfoSys::FreeDB::Response::Hello, InfoSys::FreeDB::Response::LsCat, InfoSys::FreeDB::Response::Motd, InfoSys::FreeDB::Response::Proto, InfoSys::FreeDB::Response::Query, InfoSys::FreeDB::Response::Quit, InfoSys::FreeDB::Response::Read, InfoSys::FreeDB::Response::SignOn, InfoSys::FreeDB::Response::Sites, InfoSys::FreeDB::Response::Stat, InfoSys::FreeDB::Response::Ver, InfoSys::FreeDB::Response::Whom, InfoSys::FreeDB::Response::Write::2, InfoSys::FreeDB::Site
None known (yet.)
First development: September 2003 Last update: December 2003
Vincenzo Zocca
Copyright 2003 by Vincenzo Zocca
This file is part of the InfoSys::FreeDB module hierarchy for Perl by
Vincenzo Zocca.
The InfoSys::FreeDB module hierarchy is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
The InfoSys::FreeDB module hierarchy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with the InfoSys::FreeDB module hierarchy; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
| InfoSys-FreeDB documentation | Contained in the InfoSys-FreeDB distribution. |
package InfoSys::FreeDB::Response::Write::1; use 5.006; use base qw( InfoSys::FreeDB::Response ); use strict; use warnings; use AutoLoader qw(AUTOLOAD); use Error qw(:try); use InfoSys::FreeDB::Response qw(:line_parse); # Package version our ($VERSION) = '$Revision: 0.92 $' =~ /\$Revision:\s+([^\s]+)/; 1; __END__
sub new_from_content_ref { my $class = shift; my $content_ref = shift; # Convert $opt->{content_ref} to @content_ref my @content_ref = split(/[\n\r]+/, ${$content_ref} ); # Parse first line my $line = shift(@content_ref); my ($code, $tail) = $line =~ /$CODE_RX/; defined ($code) || throw Error::Simple ('ERROR: InfoSys::FreeDB::Response::Write::1::new_from_content_ref, first line of specified \'content_ref\' does not contain a code.'); my %opt; if ($code == 320) { my @tail = split(/\s+/, $tail, 2); %opt = ( categ => $tail[0], code => $code, discid => $tail[1], result => 'OK, input CDDB data', ); } elsif ($code == 401) { %opt = ( code => $code, error => 1, result => 'Permission denied', ); } elsif ($code == 402) { %opt = ( code => $code, error => 1, result => 'Server file system full/file access failed', ); } elsif ($code == 409) { %opt = ( code => $code, error => 1, result => 'No handshake', ); } elsif ($code == 501) { %opt = ( code => $code, error => 1, result => 'Entry rejected: ' . $tail, ); } else { throw Error::Simple ("ERROR: InfoSys::FreeDB::Response::Write::1::new_from_content_ref, unknown code '$code' returned. Allowed codes are 320, 401, 402, 409 and 501."); } # Create a new object and return it return( $class->new( \%opt ) ); } sub _initialize { my $self = shift; my $opt = defined($_[0]) ? shift : {}; # Check $opt ref($opt) eq 'HASH' || throw Error::Simple("ERROR: InfoSys::FreeDB::Response::Write::1::_initialize, first argument must be 'HASH' reference."); # categ, SINGLE exists( $opt->{categ} ) && $self->set_categ( $opt->{categ} ); # discid, SINGLE exists( $opt->{discid} ) && $self->set_discid( $opt->{discid} ); # Call the superclass' _initialize $self->SUPER::_initialize($opt); # Return $self return($self); } sub _value_is_allowed { return(1); } sub get_categ { my $self = shift; return( $self->{InfoSys_FreeDB_Response_Write_1}{categ} ); } sub get_discid { my $self = shift; return( $self->{InfoSys_FreeDB_Response_Write_1}{discid} ); } sub set_categ { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'categ', $val ) || throw Error::Simple("ERROR: InfoSys::FreeDB::Response::Write::1::set_categ, the specified value '$val' is not allowed."); # Assignment $self->{InfoSys_FreeDB_Response_Write_1}{categ} = $val; } sub set_discid { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'discid', $val ) || throw Error::Simple("ERROR: InfoSys::FreeDB::Response::Write::1::set_discid, the specified value '$val' is not allowed."); # Assignment $self->{InfoSys_FreeDB_Response_Write_1}{discid} = $val; }