# Frontier::Client - issue Frontier XML RPC requests to a server - perldoc - [phpMan]

## NAME
    [Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown) - issue Frontier XML RPC requests to a server

## SYNOPSIS
     use [Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown);

     $server = [Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)->new( I<OPTIONS> );

     $result = $server->call($method, @args);

     $boolean = $server->boolean($value);
     $date_time = $server->date_time($value);
     $base64 = $server->base64($value);

     $value = $boolean->value;
     $value = $date_time->value;
     $value = $base64->value;

## DESCRIPTION
    *[Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)* is an XML-RPC client over HTTP. *[Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)* instances are used to make
    calls to XML-RPC servers and as shortcuts for creating XML-RPC special data types.

## METHODS
### new
        Returns a new instance of *[Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)* and associates it with an XML-RPC server at a
        URL. *OPTIONS* may be a list of key, value pairs or a hash containing the following
        parameters:

        url The URL of the server. This parameter is required. For example:

             $server = [Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)->new( 'url' => '<http://betty.userland.com/RPC2>' );

        proxy
            A URL of a proxy to forward XML-RPC calls through.

        encoding
            The XML encoding to be specified in the XML declaration of outgoing RPC requests.
            Incoming results may have a different encoding specified; [XML::Parser](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3AParser/markdown) will convert
            incoming data to UTF-8. The default outgoing encoding is none, which uses XML 1.0's
            default of UTF-8. For example:

             $server = [Frontier::Client](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3AClient/markdown)->new( 'url' => '<http://betty.userland.com/RPC2>',
                                              'encoding' => 'ISO-8859-1' );

        use_objects
            If set to a non-zero value will convert incoming <i4>, <float>, and <string> values to
            objects instead of scalars. See int(), float(), and string() below for more details.

        debug
            If set to a non-zero value will print the encoded XML request and the XML response
            received.

### call
        Forward a procedure call to the server, either returning the value returned by the procedure
        or failing with exception. `$method' is the name of the server method, and `@args' is a list
        of arguments to pass. Arguments may be Perl hashes, arrays, scalar values, or the XML-RPC
        special data types below.

### boolean
### date_time
### base64
        The methods `boolean()', `date_time()', and `base64()' create and return XML-RPC-specific
        datatypes that can be passed to `call()'. Results from servers may also contain these
        datatypes. The corresponding package names (for use with `ref()', for example) are
        `"[Frontier::RPC2::Boolean](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3ARPC2%3A%3ABoolean/markdown)"', `"[Frontier::RPC2::DateTime::ISO8601](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3ARPC2%3A%3ADateTime%3A%3AISO8601/markdown)"', and
        `"[Frontier::RPC2::Base64](https://www.chedong.com/phpMan.php/perldoc/Frontier%3A%3ARPC2%3A%3ABase64/markdown)"'.

        The value of boolean, date/time, and base64 data can be set or returned using the `value()'
        method. For example:

          # To set a value:
          $a_boolean->[value(1)](https://www.chedong.com/phpMan.php/man/value/1/markdown);

          # To retrieve a value
          $base64 = $base64_xml_rpc_data->value();

        Note: `base64()' does *not* encode or decode base64 data for you, you must use [MIME::Base64](https://www.chedong.com/phpMan.php/perldoc/MIME%3A%3ABase64/markdown)
        or similar module for that.

### int
### float
### string
        By default, you may pass ordinary Perl values (scalars) to be encoded. RPC2 automatically
        converts them to XML-RPC types if they look like an integer, float, or as a string. This
        assumption causes problems when you want to pass a string that looks like "0096", RPC2 will
        convert that to an <i4> because it looks like an integer. With these methods, you could now
        create a string object like this:

          $part_num = $server->string("0096");

        and be confident that it will be passed as an XML-RPC string. You can change and retrieve
        values from objects using value() as described above.

## SEE ALSO
### perl

    <<http://www.scripting.com/frontier5/xml/code/rpc.html>>

## AUTHOR
    Ken MacLeod <<ken@bitsko.slc.ut.us>>