Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Frontier::Client(3)   User Contributed Perl Documentation  Frontier::Client(3)

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

	use Frontier::Client;

	$server	= Frontier::Client->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;

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

       new( OPTIONS )
	   Returns a new instance of Frontier::Client 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

		$server	= Frontier::Client->new( 'url' => '' );

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

	       The XML encoding	to be specified	in the XML declaration of
	       outgoing	RPC requests.  Incoming	results	may have a different
	       encoding	specified; XML::Parser 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->new( 'url' => '',
						 'encoding' => 'ISO-8859-1' );

	       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.

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

       call($method, @args)
	   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(	$value )
       date_time( $value )
       base64( $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"',
	   `"Frontier::RPC2::DateTime::ISO8601"', and

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

	     # To set a	value:

	     # 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 or	similar	module for that.

       int( 42 );
       float( 3.14159 );
       string( "Foo" );
	   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.

       perl(1),	Frontier::RPC2(3)


       Ken MacLeod <>

perl v5.32.0			  2002-08-03		   Frontier::Client(3)


Want to link to this manual page? Use this URL:

home | help