NAME
UMMF::MOF_1_3::__ObjectBase - base class package for Model MOF 1.3 formal/00-04-03;
SYNOPSIS
use base qw(UMMF::MOF_1_3::__ObjectBase);
DESCRIPTION
This package provides a base class for Perl modules generated by UMMF.
USAGE
EXPORT
use UMMF::MOF_1_3::__ObjectBase qw(:__ummf_array);
__ummf_array_index
__ummf_array_delete
__ummf_array_delete_once
__ummf_array_delete_each
__ummf_array_delete_each_once
AUTHOR
Kurt Stephens, kstephens@users.sourceforge.net 2003/04/15
SEE ALSO
VERSION
$Revision: 1.77 $
METHODS
__use
my $pkg = $self->__use('Some::Package');
my $new_obj = $pkg->new(...);
Dynamically "use" a package.
__factory
Returns the factory object for this Classifier's Model.
__metamodel
Returns the Model for this Classifier.
__classifier
my $classifier = $obj_or_package->__classifier;
Returns the UML meta-model Classifier for an object or package.
__isAbstract
$package->__isAbstract;
Returns true if <$package
> is an abstract Classifer.
Abstract Classifiers are not instantiable via new
.
__validate_type
Some::Package->__validate_type($value);
Returns true if $value
is a valid representation of this Classifier.
__typecheck
$value = Some::Package->__typecheck($value, $msg);
Generates an exception with $msg
if $value
is not a valid representaion of this Classifier.
Returns $value
.
__initialize
Initialize all slots in an instance with initial values.
Called by new
and new_
.
___initialize
Initialize all slots of a particular Classifier's Attributes and AssociationEnds.
Called by __initialize
.
__create
Calls all Generalizations' __create
methods.
Called by new
.
___create
Placeholder for user-specified <<create>> methods.
Called by __create
.
____create
Hand-coded subclasses can override this method, but they must return $self
.
Called by new
.
$_id
Variable incremented for each new instance created by __new_instance
. The new ID is stored in the object's <$self-
{_id}>> slot.
$__new_instance_event
Defines a subroutine that is called with each new instance created by __new_instance
. Deprecated: See add___extent
.
add___extent
my $extent = UMMF::Object::Extent->new();
UMMF::MOF_1_3::__ObjectBase->add___extent($extent);
Register a new Extent observer object to this base class.
See also: UMMF::Object::Extent.
remove___extent
my $extent = ...;
UMMF::MOF_1_3::__ObjectBase->remove__extent($extent);
Deregister an Extent observer object from this base class.
__extent_add_object
$obj = $package->__extent_add_object($obj, @args)
Cause all registered Extent objects to be messaged as <$extent-
add_object($obj, @args)>>.
Extent observer implementors should note that $obj
may not be a fully initialized instance.
Called by __new_instance
and __clone
.
Overides of __new_instance
or __clone
should call <self-
__extent_add_object($obj, ...)>>.
Returns $obj
.
__new_instance
my $obj = $package->__new_instance(%attrs);
Returns a new instance, without initializing.
New instances get a unique id stored in <$obj-
{'_id'}>>.
new
my $obj = $package->new(%attrs);
Returns a new, initialized instance using keyword values.
Throws exception if <$package-
__isAbstract>>.
Calls <$package-
__new_instance(%attrs)>> to create instance, then calls <$obj-
__initialize()->__create()>> to complete initialization.
new_
my $obj = $package->new_(@opts);
Returns a new, initialized instance using a matching <<create>> Method.
Throws exception if <$package-
__isAbstract>>.
Calls <$package-
__new_instance()>> to create instance without any initialization keyword values then calls <$obj-
__initialize()->__create(@opts)>> to complete initialization.
__clone
my $clone = $obj->__clone();
Returns a new cloned instance.
Clones get a unique id stored in <$clone-
{'_id'}>>.
__clone_deepen
Further deepens any composed objects in a instance. Subclasses may override and call SUPER.
__ummf_disassemble
$obj->__ummf_disassemble();
Dissassembles an object graph, recursively, by traversing any Attributes or AssoicationEnds.
Only objects that respond to __ummf_disassemble
are affected.
__ummf_array_index
my $i = __ummf_array_index(\@a, $elem);
Returns the first index of $elem
in @a
or undef.
__ummf_array_delete
__ummf_array_delete(\@a, $elem);
Deletes all $elem
in @a
.
__ummf_array_delete_once
__ummf_array_delete_once(\@a, $elem);
Deletes the first $elem
in @a
.
__ummf_array_delete_each
__ummf_array_delete_each(\@a, \@elem);
Deletes each element in @elem
in @a
.
__ummf_array_delete_each
__ummf_array_delete_each(\@a, \@elem);
Deletes each first element in @elem
in @a
.
AUTOLOAD
Autoloader to simplify isa<Classifier>() handling of disjoint types. This also prints a verbose stack trace for an unimplemented method.