NAME
    XCGI - A perl module for writing CGI parameters into a XML data file

SYNOPSIS
        use PXSQL::XCGI;

        # Create a new instance of the XCGI perl OO module
        my $xcgi = new PXSQL::XCGI('./cgi_param.lst');

        my $cgi_data = $xsql->getData($cgi, $template);

DESCRIPTION
    This module is a simple writer of CGI parameters into a XML data file.
    It has no interrest outside the perl xsql program.

    The written data have the following format:

        <CGI>
            <param_name>value</param_name>
            ...
        </CGI>

    So if you need them into your XSL file they are provide like describe
    above.

METHODS
  new

    A new instance of the perl module must be call as follow:

            new PXSQL::XCGI( config_file_pathi, noheader )

    The config_file_path is the path to a file that must have the follwing
    format:

        template_alias:param1=default_value:paramN=default_value:

    Default value will be used if the CGI parameter is not set.

    The parameter noheader is a boolean to specify if the end tag of the
    XSQL header must be written. Default will write this footer. It consist
    in the following string:

            </PXSQL>

    If you provide your own XML header, it means that you have set noheader
    to 1 when at creation time of the PXSQL::XSQL instance you must also set
    it to 1 here.

  _init

    This method init the XCGI perl module instance and load the entire
    content of the configuration file into a single hash %CGI_PARAM.

  getData

    This method insert into the XML data all CGI parameters set into the
    main HASH %CGI_PARAM for the given template.

    It also append all CGI parameters set into the hash of default CGI
    parameters (see _set_xml_default_param).

  _set_xml_default_param

    This method is call internally to insert into the XML data the default
    CGI parameters set into the main HASH %PXSQL::XCGI::PARAM.

AUTHOR
    Gilles Darold <gilles@darold.net>

COPYRIGHT
    Copyright (c) 2001 Gilles Darold - All rights reserved

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    the PXSQL::XSQL manpage

