The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Tomcat::Connector - Utility class for representing Tomcat Connector objects

SYNOPSIS

Net::Tomcat::Connector is a utility class for representing Tomcat Connector objects.

        use Net::Tomcat;

        # Create a new Net::Tomcat object
        my $tc = Net::Tomcat->new(
                                username => 'admin',
                                password => 'password',
                                hostname => 'web-server-01.company.com'
                              ) 
                or die "Unable to create new Net::Tomcat object: $!\n";

        # Print the Tomcat server version and JVM version information
        print "Tomcat version: " . $tc->server->version . "\n"
            . "JVM version: " . $tc->server->jvm_version . "\n";

        # Get all connectors as an array of Net::Tomcat::Connector objects
        my @connectors = $tc->connectors;

        # Print the connector names, and request and error counts
        foreach my $connector ( @connectors ) {
                print "Name: " . $connector->name . "\n"
                    . "Request Count: ".$connector->stats->request_count . "\n"
                    . "Error Count: ".$connector->stats->error_count . "\n\n"
        }

        # Directly access a connector by name
        print "http-8080 error count: " 
                . $tc->connector('http-8080')->stats->error_count . "\n";

METHODS

new

Constructor - creates a new Net::Tomcat::Connector. Note that you should not normally need to call the constructor method directly as a Net::Tomcat::Connector object will be created for you on invoking methods in parent classes.

name

Returns the connector name. Note that Net::Tomcat::Connector objects also use this method to implement stringification as an overloaded method.

        # Print the connector name
        print "My connector name: " . $connector->name . "\n";
        # Or
        print "My connector name: $connector\n";

stats

Returns a Net::Tomcat::Connector::Statistics object containing statistics for the Tomcat connector.

scoreboard

Returns a Net::Tomcat::Connector::Scoreboard object containing the server scoreboard information for the connector.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

Please report any bugs or feature requests to bug-net-tomcat-connector at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Tomcat-Connector. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Net::Tomcat::Connector

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2015 Luke Poskitt.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.