NAME

Class::MakeMethods::Template::ClassName - Access object's class

SYNOPSIS

  package MyObject;
  use Class::MakeMethods::Template::ClassName (
    subclass_name => [ 'type' ]
  );
  ...
  package main;
  my $object = MyObject->new;

  $object->type('Foo')
  # reblesses object to MyObject::Foo subclass

  print $object->type();
  # prints "Foo".

DESCRIPTION

These method types access or change information about the class an object is associated with.

class_name

Called without arguments, returns the class name.

If called with an argument, reblesses object into that class. If the class doesn't already exist, it will be created.

subclass_name

Called without arguments, returns the subclass name.

If called with an argument, reblesses object into that subclass. If the subclass doesn't already exist, it will be created.

The subclass name is written as follows:

if it's the original, defining class: empty
if its a a package within the namespace of the original: the distingushing name within that namespace, without leading "::"
if it's a package elsewhere: the full name with leading "::"

static_hash_classname

Provides a shared hash mapping keys to class names.

  class_registry => [ qw/ foo / ]

Takes a single string or a reference to an array of strings as its argument. For each string, creates a new anonymous hash and associated accessor methods that will map scalar values to classes in the calling package's subclass hiearchy.

The accessor methods provide an interface to the hash as illustrated below. Note that several of these functions operate quite differently depending on the number of arguments passed, or the context in which they are called.