1Frontier::Client(3)   User Contributed Perl Documentation  Frontier::Client(3)
2
3
4

NAME

6       Frontier::Client - issue Frontier XML RPC requests to a server
7

SYNOPSIS

9        use Frontier::Client;
10
11        $server = Frontier::Client->new( I<OPTIONS> );
12
13        $result = $server->call($method, @args);
14
15        $boolean = $server->boolean($value);
16        $date_time = $server->date_time($value);
17        $base64 = $server->base64($value);
18
19        $value = $boolean->value;
20        $value = $date_time->value;
21        $value = $base64->value;
22

DESCRIPTION

24       Frontier::Client is an XML-RPC client over HTTP.  Frontier::Client
25       instances are used to make calls to XML-RPC servers and as shortcuts
26       for creating XML-RPC special data types.
27

METHODS

29       new( OPTIONS )
30           Returns a new instance of Frontier::Client and associates it with
31           an XML-RPC server at a URL.  OPTIONS may be a list of key, value
32           pairs or a hash containing the following parameters:
33
34           url The URL of the server.  This parameter is required.  For
35               example:
36
37                $server = Frontier::Client->new( 'url' => 'http://betty.userland.com/RPC2' );
38
39           proxy
40               A URL of a proxy to forward XML-RPC calls through.
41
42           encoding
43               The XML encoding to be specified in the XML declaration of
44               outgoing RPC requests.  Incoming results may have a different
45               encoding specified; XML::Parser will convert incoming data to
46               UTF-8.  The default outgoing encoding is none, which uses XML
47               1.0's default of UTF-8.  For example:
48
49                $server = Frontier::Client->new( 'url' => 'http://betty.userland.com/RPC2',
50                                                 'encoding' => 'ISO-8859-1' );
51
52           use_objects
53               If set to a non-zero value will convert incoming <i4>, <float>,
54               and <string> values to objects instead of scalars.  See int(),
55               float(), and string() below for more details.
56
57           username
58               Sets the username for basic authentication. If this is not set,
59               basic authentication will be disabled.
60
61           password
62               Sets the password for basic authentication.
63
64           debug
65               If set to a non-zero value will print the encoded XML request
66               and the XML response received.
67
68       call($method, @args)
69           Forward a procedure call to the server, either returning the value
70           returned by the procedure or failing with exception.  `$method' is
71           the name of the server method, and `@args' is a list of arguments
72           to pass.  Arguments may be Perl hashes, arrays, scalar values, or
73           the XML-RPC special data types below.
74
75       boolean( $value )
76       date_time( $value )
77       base64( $base64 )
78           The methods `boolean()', `date_time()', and `base64()' create and
79           return XML-RPC-specific datatypes that can be passed to `call()'.
80           Results from servers may also contain these datatypes.  The
81           corresponding package names (for use with `ref()', for example) are
82           `"Frontier::RPC2::Boolean"', `"Frontier::RPC2::DateTime::ISO8601"',
83           and `"Frontier::RPC2::Base64"'.
84
85           The value of boolean, date/time, and base64 data can be set or
86           returned using the `value()' method.  For example:
87
88             # To set a value:
89             $a_boolean->value(1);
90
91             # To retrieve a value
92             $base64 = $base64_xml_rpc_data->value();
93
94           Note: `base64()' does not encode or decode base64 data for you, you
95           must use MIME::Base64 or similar module for that.
96
97       int( 42 );
98       float( 3.14159 );
99       string( "Foo" );
100           By default, you may pass ordinary Perl values (scalars) to be
101           encoded.  RPC2 automatically converts them to XML-RPC types if they
102           look like an integer, float, or as a string.  This assumption
103           causes problems when you want to pass a string that looks like
104           "0096", RPC2 will convert that to an <i4> because it looks like an
105           integer.  With these methods, you could now create a string object
106           like this:
107
108             $part_num = $server->string("0096");
109
110           and be confident that it will be passed as an XML-RPC string.  You
111           can change and retrieve values from objects using value() as
112           described above.
113

SEE ALSO

115       perl(1), Frontier::RPC2(3)
116
117       <http://www.scripting.com/frontier5/xml/code/rpc.html>
118

AUTHOR

120       Ken MacLeod <ken@bitsko.slc.ut.us> Basic authentication patch by Jeff
121       <jeff@freemedsoftware.org>
122
123
124
125perl v5.36.0                      2023-01-20               Frontier::Client(3)
Impressum