NAME

Liz::URLSet::URL - module for URL objects of the URLSet


SYNOPSIS

 use Liz::URLSet;
 $urlset = new Liz::URLSet;

 $url = $urlset->URL;
 $url = $urlset->URL( $urlID );

 $url->update;


EXAMPLES


DESCRIPTION

Provide object oriented access to urls in a URLSet. Usually not accessed directly, but rather through the Liz::URLSet object and its URL method.


BASIC METHODS


new

Create a new URL object from a URLSet object.

Input Parameters

 1 Liz::URLSet object
 2 ID to created URL object with
   (default: none = new url)
Output Parameters

 1 instantiated object
Note

It is not intended to call this method directly, but rather indirectly through the Liz::URLSet module.

Example

 $urlset = new Liz::URLSet;
 $url = $urlset->URL;
 $url = $urlset->URL( $urlID );


update

Update a URL object in the Liz::URLSet database.

Output Parameters

 1 ID with which the object was updated (undef = error)
Example

 $urlID = $url->update;


delete

Delete a Liz::URLSet::URL object from the database.

Output Parameters

 1 flag: whether action was successful
Example

 $url->delete;


CONTENT METHODS

The following methods allow you to inspect and/or change certain fields of the Liz::URLSet::URL object.


Alt

Return or set the Alt (alternate text) information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Alt
   (default: no change)
Output Parameters

 1 current/old name value of the Alt
Example

 $url->Alt( $alt );
 $alt = $url->Alt;


Anchor

Return or set the Anchor (reference to an internal link in the document) information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Anchor
   (default: no change)
Output Parameters

 1 current/old name value of the Anchor
Example

 $url->Anchor( $anchor );
 $anchor = $url->Anchor;


Created

Return the Created timestamp of the Liz::URLSet::URL object.

Output Parameters

 1 current timestamp value of the Created date
Example

 $created = $url->Created;


ID

Return the ID of the Liz::URLSet::URL object.

Output Parameters

 1 current ID of the object
Example

 $ID = $url->ID;


LastChecked

Return or set the LastChecked timestamp of the Liz::URLSet::URL object.

Input Parameters

 1 new timestamp value of the LastChecked date
   (default: no change)
Output Parameters

 1 current/old timestamp value of the LastChecked date
Example

 $url->LastChecked( $lastchecked );
 $lastchecked = $url->LastChecked;


Options

Return or set the Options information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Options
   (default: no change)
Output Parameters

 1 current/old name value of the Options
Example

 $url->Options( $options );
 $options = $url->Options;


Parameters

Return or set the Parameters (CGI-parameters to be passed) information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Parameters
   (default: no change)
Output Parameters

 1 current/old name value of the Parameters
Example

 $url->Parameters( $parameters );
 $parameters = $url->Parameters;


Published

Return or set the Published timestamp of the Liz::URLSet::URL object.

Input Parameters

 1 new timestamp value of the Published date
   (default: no change)
Output Parameters

 1 current/old timestamp value of the Published date
Example

 $url->Published( $published );
 $published = $url->Published;


Server

Return or set the Server information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Server
   (default: no change)
Output Parameters

 1 current/old name value of the Server
Example

 $url->Server( $server );
 $server = $url->Server;


Status

Return or set the Status information of the Liz::URLSet::URL object.

Input Parameters

 1 new value of the Status
   (default: no change)
Output Parameters

 1 current/old value of the Status
Example

 $url->Status( $status );
 $status = $url->Status;


Title

Return or set the Title (mnemonic) information of the Liz::URLSet::URL object.

Input Parameters

 1 new name value of the Title
   (default: no change)
Output Parameters

 1 current/old name value of the Title
Example

 $url->Title( $title );
 $title = $url->Title;


Updated

Return the Updated timestamp of the Liz::URLSet::URL object.

Output Parameters

 1 current timestamp value of the Updated date
Example

 $updated = $url->Updated;


URI

Return or set the URI (reference to a file on the server's filesystem) information of the Liz::URLSet::URL object. It is usually easier to use the URL method to set the complete URL info of the object.

Input Parameters

 1 new name value of the URI
   (default: no change)
Output Parameters

 1 current/old name value of the URI
Example

 $url->URI( $uri );
 $uri = $url->URI;


URL

Return or set the complete URL (protocol://server:port/uri#anchor?parameters) information of the Liz::URLSet::URL object. When a new value is specified, it sets the fields Server, URI, Anchor and Parameters fields.

Input Parameters

 1 new name value of the URL
   (default: no change)
Output Parameters

 1 current/old name value of the URL
Example

 $url->URI( $link );
 $link = $url->URL;


AUTHOR

Elizabeth Mattijsen ( lizperl@INC.nl )


COPYRIGHT

(C) 1998-1999 International Network Consultants


HISTORY

Version 0.12, 30 September 1999

Now inherits from Liz::URLSet rather than from Liz::SQL.

Now no longer puts Exporter in ISA: it was not needed.

Version 0.11, 20 August 1999

Added support for extra fields to methods new and update.

Changed to new source typography.

Version 0.1, 27 April 1999

First version of this true Perl module.