webgui/lib/WebGUI/Definition/Meta/Class.pm

package WebGUI::Definition::Meta::Class;

=head1 LEGAL

 -------------------------------------------------------------------
  WebGUI is Copyright 2001-2009 Plain Black Corporation.
 -------------------------------------------------------------------
  Please read the legal notices (docs/legal.txt) and the license
  (docs/license.txt) that came with this distribution before using
  this software.
 -------------------------------------------------------------------
  http://www.plainblack.com                     info@plainblack.com
 -------------------------------------------------------------------

=cut

use 5.010;
use Moose::Role;
use namespace::autoclean;
use WebGUI::Definition::Meta::Property;
no warnings qw(uninitialized);

our $VERSION = '0.0.1';

=head1 NAME

Package WebGUI::Definition::Meta::Class

=head1 DESCRIPTION

Moose-based meta class for all definitions in WebGUI.

=head1 SYNOPSIS

A definition contains all the information needed to build an object.
Information required to build forms are added as optional roles and
sub metaclasses.  Database persistance is handled similarly.

=head1 METHODS

These methods are available from this class:

=cut

#-------------------------------------------------------------------

=head2 add_property ()

=cut

sub add_property {
    my ($self, $name, %options) = @_;
    if (! (exists $options{noFormPost} || exists $options{label}) ) {
        Moose->throw_error("Must pass either noFormPost or label when making a property");
    }
    my %form_options;
    my $prop_meta_roles = $self->property_metaroles;
    my $prop_meta = $self->_property_metaclass;
    for my $key ( keys %options ) {
        if ( ! $prop_meta->find_attribute_by_name($key) ) {
            $form_options{$key} = delete $options{$key};
        }
    }
    $self->add_attribute(
        $name,
        is          => 'rw',
        traits      => $prop_meta_roles,
        form        => \%form_options,
        %options,
    );
}

#-------------------------------------------------------------------

=head2 get_all_attributes_list ( )

Returns an array of all attribute names across all meta classes.

=cut

sub get_all_attributes_list {
    my $self  = shift;
    my @attributes = ();
    CLASS: foreach my $meta ($self->get_all_class_metas) {
        push @attributes, $meta->get_attribute_list;
    }
    return @attributes;
}

#-------------------------------------------------------------------

=head2 get_all_class_metas ( )

Returns an array of all WebGUI::Definition::Meta::Class objects for the classes in this class,
in the order they were created in the Definition.

=cut

sub get_all_class_metas {
    my $self  = shift;
    my @metas = ();
    CLASS: foreach my $class_name (reverse $self->linearized_isa) {
        my $meta = $class_name->meta;
        next CLASS unless $meta->can('get_all_properties');
        push @metas, $meta;
    }
    return @metas;
}

#-------------------------------------------------------------------

=head2 get_all_properties ( )

Returns an array of all Properties, in all classes, in the order they were
created in the Definition.

=cut

sub get_all_properties {
    my $self       = shift;
    return
        map { $_->get_properties } $self->get_all_class_metas;
}

#-------------------------------------------------------------------

=head2 get_all_property_list ( )

Returns an array of the names of all Properties, in all classes, in the order they were
created in the Definition.

=cut

sub get_all_property_list {
    my $self       = shift;
    my @names = ();
    my %seen  = ();
    foreach my $meta ($self->get_all_class_metas) {
        push @names,
             grep { !$seen{$_}++ }
             $meta->get_property_list;
    }
    return @names;
}

#-------------------------------------------------------------------

=head2 get_attributes ( )

Returns an array of all attributes, but only for this class.  This is the
API-safe way of doing values %{ $self->_attribute_map };

=cut

sub get_attributes {
    my $self   = shift;
    return map { $self->find_attribute_by_name($_) } $self->get_attribute_list;
}

#-------------------------------------------------------------------

=head2 get_properties ( )

Returns an array of all properties, but only for this class.

=cut

sub get_properties {
    my $self = shift;
    return grep { $_->does('WebGUI::Definition::Meta::Property') } $self->get_attributes;
}

#-------------------------------------------------------------------

=head2 get_property_list ( )

Returns an array of the names of all Properties, in this class, sorted by the order they
were added to the Definition.  This guarantees repeatable, reliable handling of properties.

=cut

sub get_property_list {
    my $self = shift;
    return map  { $_->name }
           sort { $a->insertion_order <=> $b->insertion_order }   # In insertion order
           $self->get_properties
}

#-------------------------------------------------------------------

=head2 property_traits ( )

Returns the name of the class for properties.

=cut

has property_metaroles => (
    is  => 'ro',
    default => sub { ['WebGUI::Definition::Meta::Property' ] },
);

has _property_metaclass => (
    is  => 'ro',
    lazy => 1,
    builder => '_build_property_metaclass',
);

sub _build_property_metaclass {
    my $self = shift;
    my $class = Moose::Meta::Class->create_anon_class(
        superclasses => [ $self->attribute_metaclass ],
        roles        => $self->property_metaroles,
        cache        => 1,
    );
    return $class;
}

1;