Switch to: V11V10V9V8V7V6V5


Inherits from NSObjectController
Represents object Valenina, VConnection.
Declared in V4CC_VClientConnection.h


VClientConnection Controller - provides access to the content of Valentina's server.

It manages two Valentina's classes - Valentina & VConnection. When you use VClientConnection Controller - it will make two steps:

  • Init Valentina Client;
  • Init VConnection in Client mode;

To get a connection to Valentina Server you should specify connections parameters. By default, VClientConnection connects to the 'localhost' with username 'sa' and password 'sa'.

To connect to a remote VServer - select 'Web' in the pop-up menu and specify needed parameters.


Please familiarise with tasks of all controllers before programming your application. Some tasks may be invoked and executed by high-level's objects. And you should not invoke them directly.

Construction Methods

Init Connection Method


Class Methods

Init Methods

- (id)initWithHost:(NSString*)inHost userName:(NSString*)inUserName password:(NSString*)inUserPassword;
- (id)initWithHost:(NSString*)inHost userName:(NSString*)inUserName password:(NSString*)inUserPassword port:(int)inPort;
- (id)initWithHost:(NSString*)inHost userName:(NSString*)inUserName password:(NSString*)inUserPassword port:(int)inPort timeout:(int)inTimeOut;
- (id)initWithHost:(NSString*)inHost userName:(NSString*)inUserName password:(NSString*)inUserPassword port:(int)inPort	timeout:(int)inTimeOut  options:(NSString*)inOptions;

This is a group of methods of initialization of VClientConnection properties. VClientConnection has properties, which are responsible for the connection type:

  • host - host name where the Valentina Server was installed;
  • userName - user name for connection to Valentina Server;
  • userPassword - user password;
  • port - port number;
  • timeOut - time out;
  • options - options parameters for connection.

host, userName and userPassword - this is obligatory parameters.
port, timeOut and options - options parameters.

To init properties - you can use one of the init methods in dependence of needed connection type. (For more info look VConnection )


Releases VClientConnection properties

- (void)dealloc;


Initializes a client VConnection instance.

- (void)initConnection;

VClientConnection contains two objects - Valentina instance and VConnection. This method consistently initializes Valentina instance and VConnection with given properties.

Be attentive: you should invoke this method after the properties have been initialized.


Accessors for local connection property.

- (id)localConnection;
- (void)setLocalConnection:(VLocalConnection*)inVLocalConnection;

If your application uses two types of connections - local and client, you should specify VLocalConnection using this method.


Accessors for connection property.

- (VConnection*)connection;
- (void)setConnection:(VConnection*)inConnection;

Provides access to VConnection property controller.

Return Value

Returns a VConnection class object.


Provides names of connection types for IBPlugin.

- (NSArray*)connectionMethods;

Return Value
Returns array of two strings - Localhost,Web.


Accessors for current connection property.

- (int) currentConnectionMethod;
- (void)setCurrentConnectionMethod:(int)inConnectMethod;

If you set current connection method - 0 connection will be established to the localhost with username 'sa' and password 'sa'. If you set current connection method - 1, connection parameters will be empty and you will have to init them before connections init.

This method is used in IBPlugin. We do not advise you to use them programmatically. Use one of the Init Methods for init connection properties.


Accessors for the host property.

- (NSString*)host;
- (void)setHost:(NSString*)inHostName;

You can get, or set, the host name for the current connection.


Accessors for the userName property.

- (NSString*)userName;
- (void)setUserName:(NSString*)inUserName;

You can get, or set, userName for the current connection.


Accessors for the userPassword property.

- (NSString*)userPassword;
- (void)setUserPassword:(NSString*)inUserPassword;

You can get, or set, userPassword for the current connection.


Accessors for the port property.

- (int)port;
- (void)setPort:(int)inTimeOut;

You can get, or set, a port for the current connection.


Accessors for the timeOut property.

- (int)timeOut;
- (void)setTimeOut:(int)inTimeOut;

You can get, or set, timeOut for the current connection.


Accessors for the options property.

- (NSString*)options;
- (void)setOptions:(NSString*)inOptions;

You can get, or set, options for the current connection.

Code Example

VClientConnection*  myClientConnection;
myClientConnection = [[VLocalConnection alloc] initWithHost:@"localhost" 
[myClientConnection initConnection];