• NAME
• SYNOPSIS
• EXAMPLES
• DESCRIPTION
• BASIC METHODS
  • new
  • update
  • delete
• CONTENT METHODS
  • Alt
  • Anchor
  • Created
  • ID
  • LastChecked
  • Options
  • Parameters
  • Published
  • Server
  • Status
  • Title
  • Updated
  • URI
  • URL
• AUTHOR
• COPYRIGHT
• HISTORY

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.