MasonX::Resolver::ExtendedCompRoot - Extend functionality of C<HTML::Mason::Resolver::File> to allow specific comp_roots to be called

  PerlSetVar   MasonResolverClass   MasonX::Resolver::ExtendedCompRoot

  my $ah =
      HTML::Mason::ApacheHandler->new
          ( 
           resolver_class => 'MasonX::Resolver::ExtendedCompRoot',
          );

  my $resolver = MasonX::Resolver::ExtendedCompRoot->new( comp_root => '/var/www/mason' );

  my $info = $resolver->get_info('/some/comp.html');

  <& comp_root_name=>path/to/comp &>

  PerlSetVar  MasonRequestClass    MasonX::Request::ExtendedCompRoot
  PerlSetVar  MasonResolverClass   MasonX::Resolver::ExtendedCompRoot

  request_class  => 'MasonX::Request::ExtendedCompRoot'
  resolver_class => 'MasonX::Resolver::ExtendedCompRoot'

# This software is copyright (c) 2004 Alex Robinson.
# It is free software and can be used under the same terms as perl,
# i.e. either the GNU Public Licence or the Artistic License.

package MasonX::Resolver::ExtendedCompRoot;

use strict;

our $VERSION = '0.03';

use base qw(HTML::Mason::Resolver::File);

use HTML::Mason::Tools qw(read_file_ref);

#
# call ApacheHandler's apache_request_to_comp_path in a way 
# that doesn't cause standalone invocations to choke
#
sub apache_request_to_comp_path
	{
	return HTML::Mason::Resolver::File::ApacheHandler::apache_request_to_comp_path(@_);
	}

#
# override HTML::Mason::Resolver::File's get_info
# which this method simply replicates and adds several lines to
# additional lines marked #ecr
#
sub get_info {
    my ($self, $path) = @_;

	my $specified_comp_root;							#ecr
	if (index($path,'=>') != -1) {						#ecr
	my ($comp_root,$comp_path) = split('=>',$path,2);	#ecr
	$specified_comp_root = $comp_root;					#ecr
	$specified_comp_root =~ s|^/||;						#ecr
	$path = $comp_path;									#ecr
	}													#ecr

    foreach my $pair ($self->comp_root_array) {

	next if ($specified_comp_root and ($pair->[0] ne $specified_comp_root));	#ecr

	my $srcfile = File::Spec->canonpath( File::Spec->catfile( $pair->[1], $path ) );
	next unless -f $srcfile;

	my $key = $pair->[0];

	my $modified = (stat _)[9];
	my $base = $key eq 'MAIN' ? '' : "/$key";
	$key = undef if $key eq 'MAIN';

	return
            HTML::Mason::ComponentSource->new
                    ( friendly_name => $srcfile,
                      comp_id => "$base$path",
                      last_modified => $modified,
                      comp_path => $path,
                      comp_class => 'HTML::Mason::Component::FileBased',
                      extra => { comp_root => $key },
                      source_callback => sub { read_file_ref($srcfile) },
                    );
    }

    if ( $path ne '/' )
    {
        # see if path corresponds to real filesystem path, a common new user mistake
        my $fs_path = File::Spec->catfile( split /\//, $path );
        if ( defined $fs_path && -e $fs_path )
        {
            warn "Your component path ($path) matches a real file on disk ($fs_path).  Have you read about the component root in the Administrator's Manual (HTML::Mason::Admin)?";
        }
    }

    return;
}

1;


__END__