GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RPC::SIMPLE::AGENT (3)

.ds Aq ’

NAME

RPC::Simple::Agent - Perl extension for an agent object for RPC

CONTENTS

SYNOPSIS



  use RPC::Simple::Agent ;



DESCRIPTION

This class is an agent for client class inheriting PRC::AnyLocal. This class will handle all the boring stuff to create, access store call-back when dealing with the remote object.

Casual user should not worry about this class. RPC::Simple::AnyLocal will deal with it.

Methods

new( CW$factory_ref, client_ref, index, remote_class, ... .)

Create the agent.

factory_ref is the SPRC::Factory object.

client_ref is the client object itself.

index is an index handled by the Factory.

remote_class if the name of the class created on the remote side. By default, it is set to the client’s class name with a ’Real’ prepended to the name.

I.e if the client is Foo::Bar, the remote will be Foo::RealBar.

The remaining parameters will forwarded to the constructor of the remote class.

    getRemoteHostName

returns the remote host name

    delegate( method_name , [code_ref ], parameters ,... )

Call a method of the remote object. If code_ref is specified, the code
will be executed with whatever parameters the remote functions passed in its reply.

The remaining optionnal parameters are passed as is to the remote method.

Note that ref are copied. You can’t expect the remote to be able to modify a client’s variable because you passed it’s ref to the remote.

    callMethod( method_name, argument_array_ref )

Function used to call the owner of the agent. All arguments of the function to be called back are passed in the array ref.

CALLBACKS

    remoteCreated(result, string)

Called when the remote object is created. ’result’ will be true or false depending on whether the remote object was created or not.

’string’ contains the error message in case of a failure.

    treatCallBack ( request_id, argument_array_ref)

Function used to call-back the owner of the agent. All arguments of the function to be called back are passed in the array ref.

’request_id’ is used to know what object and methos are to be called back. These info were stored by the delegate function.

AUTHORS



    Current Maintainer
    Clint Edwards <cedwards@mcclatchyinteractive.com>
   
    Original
    Dominique Dumont, <Dominique_Dumont@grenoble.hp.com>



SEE ALSO

perl(1), RPC::Simple::AnyLocal(3).
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 SIMPLE::AGENT (3) 2006-05-31

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.