NAME

NetSDS::Class::Abstract - superclass for all NetSDS APIs

SYNOPSIS

package MyClass;
use base 'NetSDS::Class::Abstract';

__PACKAGE__->mk_accessors(qw/my_field/);

sub error_sub {
	my ($this) = @_;
	if (!$this->my_field) {
		return $this->error("No my_field defined");
	}
}

1;

DESCRIPTION

NetSDS::Class::Abstract is a superclass for all other NetSDS classes, containing the following functionality:

• common class constructor

• safe modules inclusion

• class and objects accessors and cloning;

• error handling;

All other class/object APIs should inherit this class to use it's functionality in standard way.

CONSTRUCTOR, INITIALIZATION, APPLICATION

new([...])

Common constructor for NetSDS classes.

my $object = NetSDS::SomeClass->new(%options);

Constructor may be overwriten in inherited classes and usually is. Parameters for constructor may be given as hash or hash reference.

mk_class_var(@variables)

Class->mk_class_var(@variables);

This creates accessor/mutator methods for each named class variable.

use_modules(ARRAY)

Invoke modules from list given in parameters.

Return TRUE in case of success or FALSE if failed.

unbless()

Return non object copy of object data structure.

$copy = $obj->unbless();
$same = $obj->unbless( 1 );

serialize() - returns serialized object

This method returns serialized copy of object.

deserialize($serialized) - returns deserialized object

Paramters: serialized object as string

Returns: object

my $obj = NetSDS::SomeClass->deserialize($str);

nstore($file_name) - store serialized object

Save serialized object to file

logger() - set logger handler

This method allows to set class logger (NetSDS::Logger object)

log($level, $message) - write log message

Paramters: log level, log message

$obj->log("info", "We still alive");

error_code($new_code) - set/get error code

if (error_occured()) {

	$this->error_code(1234); # secret error status
	return $this->error("Oops! We have a 1234 error!");

}

EXAMPLES

See samples directory and other NetSDS moduleis for examples of code.

BUGS

Unknown yet

SEE ALSO

Class::Accessor, Class::Accessor::Class, Clone, Class::ErrorHandler

TODO

None

AUTHOR

Michael Bochkaryov <misha@rattler.kiev.ua>