Net::FreeDB2::Connection::HTTP FreeDB/CDDB concrete connection class using the HTTP protocol
Download

Net::FreeDB2::Connection::HTTP Ranking & Summary

Net::FreeDB2::Connection::HTTP Tags

Connection Perl module cddb FreeDB connection class HTTP connection

Net::FreeDB2::Connection::HTTP Description

FreeDB/CDDB concrete connection class using the HTTP protocol Net::FreeDB2::Connection::HTTP is a FreeDB/CDDB concrete connection class using the HTTP protocol.CONSTRUCTORnew (OPT_HASH_REF) Creates a new Net::FreeDB2::Connection::HTTP object. Throws a Error::Simple exception if a mandatory option is missing. See Net::FreeDB2::Connection for allowed/mandatory options for OPT_HASH_REF. Additionally the follwoing option is allowed: freedb_cgi The FreeDB/CDDB cgi path. Defaults to ~cddb/cddb.cgi.METHODShello () hello is not supported under HTTP. This method does not do anything.lscat () Issues an lscat command on the FreeDB/CDDB database. Returns an ARRAY with available categories. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.query (ENTRY) Queries the FreeDB/CDDB database using ENTRY which is a Net::FreeDB2::Entry object. Returns a Net::FreeDB2::Response::Query object. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.read (MATCH) Reads an entry from the FreeDB/CDDB database using MATCH which is a Net::FreeDB2::Match object. Returns a Net::FreeDB2::Response::Read object. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.write (ENTITY) Quote from CDDBPROTO: 'All CDDBP commands are supported under HTTP, except for "cddb hello", "cddb write", "proto" and "quit".' Therefor this method only throws an Error::Simple exception.log () Issues an log command on the FreeDB/CDDB database. TO BE IMPLEMENTEDmotd () Issues an motd command on the FreeDB/CDDB database. Returns an ARRAY containing the motd lines. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.discid (ENTRY) Issues an discid command on the FreeDB/CDDB database using the Net::FreeDB2::Entry object ENTRY. Returns the discid as calculated by FreeDB/CDDB. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.proto () Issues an proto command on the FreeDB/CDDB database. TO BE IMPLEMENTEDsites () Issues an sites command on the FreeDB/CDDB database. Returns an ARRAY with sites. Throws an Error::Simple exception if no connection is made, if the instanciation of an HTTP::Request object fails or if the HTTP request fails. Also, exceptions from mkHello () or mkUrlBase () may be thrown if an exceptional situation occurs.stat () Issues an stat command on the FreeDB/CDDB database. TO BE IMPLEMENTEDver () Issues an ver command on the FreeDB/CDDB database. TO BE IMPLEMENTEDupdate () Issues an update command on the FreeDB/CDDB database. TO BE IMPLEMENTEDwhom () Issues an whom command on the FreeDB/CDDB database. TO BE IMPLEMENTEDconnect () Connects to the FreeDB/CDDB database. Throws an Error::Simple exception if the instanciation of the LWP::UserAgent (which BTW forms the actiual connection) object fails.mkHello () Makes a FreeDB/CDDB HTTP hello string for uasage by other FreeDB/CDDB command methods and returns it. Throws an Error::Simple exception if client name, client version, client host or client user not set.mkUrlBase () Makes a HTTP mase URL string for uasage by other FreeDB/CDDB command methods and returns it. Throws an Error::Simple exception if FreeDB/CDDB host or FreeDB/CDDB cgi not set.setFreeDBCgi (VALUE) Set the FreeDB/CDDB cgi (e.g. ~cddb/cddb.cgi) attribute. VALUE is the value.getFreeDBCgi () Returns the FreeDB/CDDB cgi attribute. Requirements: · Perl

Net::FreeDB2::Connection::HTTP Related Software