kanzi::connect::VirtualFileLocalClient Class Reference

Local interface to access HTTP Virtual file interface in server. More...

#include <virtualfilelocalclient.hpp>

Inheritance diagram for kanzi::connect::VirtualFileLocalClient:

Public Member Functions
string	getPath (RegistrationToken token) const
	Retrieve the path associated with the registration.
RegistrationToken	registerPath (const string &scheme, const string &path, VirtualFileProvider *provider)
	Registers a path to HTTP Server.
RegistrationStatus	registrationStatus (RegistrationToken token)
	Checks the registration status.
void	unregisterPath (RegistrationToken token)
	Unregisters previously registered path.
Public Member Functions inherited from kanzi::connect::VirtualFileClient
virtual string	getIdentifier () const
	Returns the type of the service.
virtual void	registerRegistrationStatusChangeCallback (RegistrationToken token, RegistrationStatusChangeCallback *callback)
	Register registration status change callback.
virtual void	unregisterRegistrationStatusChangeCallback (RegistrationToken token)
	Clears previously registered status change callback.
virtual	~VirtualFileClient ()
	C++ destructor - performs cleanup.
Public Member Functions inherited from kanzi::connect::AbstractServiceClient
	AbstractServiceClient ()
	Constructor.
AbstractSession::MessageSubscriptionToken	addMessageSubscription (const string &messageType, AbstractSession::MessageReceivedFunction function)
SessionRunningSubscriptionToken	addSessionRunningSubscription (SessionRunningFunction function)
SessionRunningSubscriptionToken	addSessionStoppedSubscription (SessionStoppedFunction function)
optional< int >	getActiveSessionIdentifier ()
optional< const AbstractSession::ServiceAttributes >	getServiceAttributes ()
virtual void	onSessionRunning ()
virtual void	onSessionStopped ()
void	removeMessageSubscription (const string &messageType, AbstractSession::MessageSubscriptionToken token)
void	removeSessionRunningSubscription (SessionRunningSubscriptionToken token)
void	removeSessionStoppedSubscription (SessionRunningSubscriptionToken token)
void	setEnabledState (bool newEnabledState)
	Enable/disable the service by allowing or blocking traffic between client and server.
bool	transmit (const MessagePackage &message)
virtual void	work ()
	Carry out asynchronous work bound to Kanzi Connect client main thread.
virtual	~AbstractServiceClient ()
	Destructor.

Static Public Member Functions
static VirtualFileLocalClientSharedPtr	create (VirtualFileManagerSharedPtr manager)
	Factory function to create instance of a class.
Static Public Member Functions inherited from kanzi::connect::VirtualFileClient
static string	Type ()
	Type of the client.

Protected Member Functions
	VirtualFileLocalClient (VirtualFileManagerSharedPtr manager)
	C++ constructor.
Protected Member Functions inherited from kanzi::connect::AbstractServiceClient
virtual AbstractSessionSharedPtr	getSession ()

Additional Inherited Members
Public Types inherited from kanzi::connect::VirtualFileClient
enum	RegistrationStatus { NotRegistered , RegistrationInProgress , RegistrationFailed , Registered }
typedef enum kanzi::connect::VirtualFileClient::RegistrationStatus	RegistrationStatus
typedef shared_ptr< void >	RegistrationToken
	Token used to identify registration.
Public Types inherited from kanzi::connect::AbstractServiceClient
typedef function< void(void)>	SessionRunningFunction
typedef shared_ptr< void >	SessionRunningSubscriptionToken
typedef function< void(void)>	SessionStoppedFunction
Protected Types inherited from kanzi::connect::AbstractServiceClient
enum	SessionState { INITIALIZED = 0 , RUNNING = 1 , STOPPED = 2 }
Protected Attributes inherited from kanzi::connect::AbstractServiceClient
SessionState	m_sessionState

Detailed Description

Local interface to access HTTP Virtual file interface in server.

Constructor & Destructor Documentation

VirtualFileLocalClient()

kanzi::connect::VirtualFileLocalClient::VirtualFileLocalClient ( VirtualFileManagerSharedPtr manager )

protected

C++ constructor.

Parameters

manager

service manager.

Member Function Documentation

create()

static VirtualFileLocalClientSharedPtr kanzi::connect::VirtualFileLocalClient::create ( VirtualFileManagerSharedPtr manager )

static

Factory function to create instance of a class.

Parameters

manager

service manager.

getPath()

string kanzi::connect::VirtualFileLocalClient::getPath ( RegistrationToken token ) const

virtual

Retrieve the path associated with the registration.

Parameters

token

The token that identifies the registration.

Returns

full path in form: http://<server>:8080/somepath/ empty string is returned if registration has failed, or it is still in progress.

Implements kanzi::connect::VirtualFileClient.

registerPath()

RegistrationToken kanzi::connect::VirtualFileLocalClient::registerPath ( const string & scheme, const string & pathProposal, VirtualFileProvider * provider )

virtual

Registers a path to HTTP Server.

Registration is an asynchronous operation for remote clients.

Parameters

scheme	Requested protocol. Either HTTP or HTTPS expected. If you do not set a value, uses HTTP.
pathProposal	clients proposal of the path where the serving is to be done.
provider	pointer to callback interface that is, if successfully registered, invoked for every file request made under the registered path. Caller must guarantee that the provided callback interface remains valid until corresponding unregisterPath call is made.

Returns

Opaque token that identifies this registration.

Implements kanzi::connect::VirtualFileClient.

registrationStatus()

RegistrationStatus kanzi::connect::VirtualFileLocalClient::registrationStatus ( RegistrationToken token )

virtual

Checks the registration status.

For remote operations registration is asynchronous and thus it is not complete until this method returns either Registered or RegistrationFailed. Also, if for example connection is lost, then the registration status changes even if it has been completed earlier.

Parameters

token

The token that identifies the registration.

Returns

enumerated status.

Implements kanzi::connect::VirtualFileClient.

unregisterPath()

void kanzi::connect::VirtualFileLocalClient::unregisterPath ( RegistrationToken token )

virtual

Unregisters previously registered path.

Parameters

token

opaque handle got using the registerPath

Implements kanzi::connect::VirtualFileClient.

---

The documentation for this class was generated from the following file:

• virtualfile_service/virtualfilelocalclient.hpp