The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
package Win32::SqlServer::DTS::TaskFactory;

=head1 NAME

Win32::SqlServer::DTS::TaskFactory - a Perl abstract class to create DTS Package Tasks in a polymorphic way 

=head1 SYNOPSIS

    use Win32::SqlServer::DTS::TaskFactory;

	# $task is a unknow DTS Task object
    my $new_task = Win32::SqlServer::DTS::TaskFactory::create($task);
    print $new_task->to_string, "\n";

=head1 DESCRIPTION

C<Win32::SqlServer::DTS::TaskFactory> creates C<Win32::SqlServer::DTS::Task> subclasses objects depending on the type of the DTS Package Task object
passed as a reference.

=head2 EXPORT

Nothing.

=cut

use strict;
use warnings;
use Carp;
use Win32::SqlServer::DTS::TaskTypes;
our $VERSION = '0.13'; # VERSION

=head2 METHODS

=head3 create

Expects a C<DTSTask> object passed as a parameter.

Returns a object from a subclass of C<Win32::SqlServer::DTS::Task> depending on the C<CustomTaskID> property from the C<Task>
object passed as a parameter.

=cut

sub create {
    my $task           = shift;
    my $type_converted = Win32::SqlServer::DTS::TaskTypes::convert( $task->CustomTaskID );

    if ( defined($type_converted) ) {
        # using DOS directory separator
        my $location  = 'Win32\\SqlServer\\DTS\\Task\\' . $type_converted . '.pm';
        my $new_class = 'Win32::SqlServer::DTS::Task::' . $type_converted;
        require $location;
        return $new_class->new( $task );

    }
    else {
        croak $task->CustomTaskID . ' is not a implemented Win32::SqlServer::DTS::Task subclass';
    }

}

1;

__END__

=head1 SEE ALSO

=over

=item *
MSDN on Microsoft website and MS SQL Server 2000 Books Online are a reference about using DTS'
object hierarchy, but you will need to convert examples written in VBScript to Perl code.

=item *
L<Win32::SqlServer::DTS::Task|Win32::SqlServer::DTS::Task> and it's subclasses modules at C<perldoc>.

=item *
L<Win32::SqlServer::DTS::TaskTypes> at C<perldoc>.

=back

=head1 AUTHOR

Alceu Rodrigues de Freitas Junior, E<lt>arfreitas@cpan.orgE<gt>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2006 by Alceu Rodrigues de Freitas Junior

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.

=cut