GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
SPOPS::Error(3) User Contributed Perl Documentation SPOPS::Error(3)
 

SPOPS::Error - (DEPRECATED) Centralized error messages from all SPOPS objects.

NOTE: AS OF SPOPS 0.56 THIS CLASS IS DEPRECATED IN FAVOR OF THE SPOPS::Exception HIERARCHY. THAT CLASS MAINTAINS BACKWARD COMPATIBILITY WITH THIS ONE, BUT THIS WILL BE REMOVED SOMETIME BEFORE A FINAL 1.0 RELEASE.
 # Using SPOPS in your application
 my $obj_list = eval { $class->fetch_group({ where => 'this = that' }) };
 if ( $@ ) {
   warn "Error found! Error: $@\n",
        "Error type: $SPOPS::Error::type\n",
        "More specific: $SPOPS::Error::system_msg\n",
        "Extra stuff:\n",
        "--$SPOPS::Error::extra->{sql}\n",
        "--$SPOPS::Error::extra->{valuesb}\n";
 }

This class provides a central location for error messages from all SPOPS modules. The error information collected in these variables is guaranteed to result from the most recent error generated by SPOPS.

All of these variables are package variables, so you refer to them like this:
  $SPOPS::Error::<variable_name>
  $SPOPS::Error::system_msg
See the NOTES section below for hints on making the error variables shorter.
user_msg ($)
A generic message that is suitable for showing a user. When telling a user something went wrong, you do not want to tell them:
 execute called with 2 bind variables when 1 are needed
instead, you want to tell them:
 Database query failed to execute
Typically, this is the message that the SPOPS class will "die()" with.
system_msg ($)
Even though you do not want to show your users details of the error, you still need to know them! The variable system_msg gives you details regarding the error.
type ($)
SPOPS knows about a few types of errors. Some depend on your SPOPS implementation (e.g., DBI, dbm, LDAP, etc.). Others can be:
security: There is a security violation and the action could not be completed
package ($)
Set to the package from where the error was thrown.
method ($)
Set to the method from where the error was thrown. (If set automatically, this is a fully-qualified subroutine name.)
filename ($)
Set to the filename from where the error was thrown.
line ($)
Set to the line number from where the error was thrown.
extra (\%)
Different SPOPS classes have different information related to the current request. For instance, DBI errors will typically fill the 'sql' and 'values' keys. Other SPOPS implementations may use different keys; see their documentation for details.

clear()
Clears the current error saved in the class. Classes outside the SPOPS:: hierarchy should never need to call this.
No return value.
get()
Returns a hashref with all the currently set error values.
set( \%params )
First clears the variables then sets them all in one fell swoop. The variables that are set are passed in the first argument, a hashref. Also sets both the package, method, filename and line and variables for you, although you can override by setting manually.
Returns the results from a "get()", including the results that may be automatically filled in.

Some people might find it easier to alias a local package variable to a SPOPS error variable. For instance, you can do:
 *err_user_msg   = \$SPOPS::Error::user_msg;
 *err_system_msg = \$SPOPS::Error::system_msg;
 *err_type       = \$SPOPS::Error::type;
 *err_extra      = \%SPOPS::Error::extra;
And then refer to the alias in your local package:
 my $obj_list = eval { $obj->fetch_group({ where => 'this = that' }) };
 if ( $@ ) {
   warn "Error found! Error: $@\n",
        "Error type: $err_type\n",
        "More specific: $err_system_msg\n",
        "Extra stuff:\n",
        "--$err_extra{sql}\n",
        "--$err_extra{values}\n";
 }
Whatever floats your boat.

Nothing known.

None known.

Copyright (c) 2001-2004 intes.net, inc.. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Chris Winters <chris@cwinters.com>
2004-06-02 perl v5.28.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.