FarelDB 第1章 第1讲 连接服务器

FarelDB 连接服务器

通过FarelDB的客户端命令或者调用API，您可以连接到FarelDB服务端，并可以向FarelDB服务端发送各种命令，进行对FarelDB的相关操作。

语法

#默认主机IP:27.0.0.1 ; 默认端口:6800 ; 默认用户名:root ; 默认密码:root;
C:\FarelDB>FarelDbcli.exe [-h 主机名或主机IP地址 -P 端口号 -u 用户名 -p 密码]

返回值

命令行窗口显示当前连接的服务器版本号，服务器版本发布时间，客户端版本号，客户端版本发布时间以及客户端连接ID等信息。

命令实例

第一步：打开一个命令行窗口，进入到FarelDB目录下，启动FarelDB服务端：

// 启动服务端 
C:\FarelDB>FarelDB.exe

第二步：重新再打开一个命令行窗口，进入到FarelDB目录下，启动FarelDB客户端：

// 启动客户端
C:\FarelDB>  FarelDBcli.exe -h 127.0.0.1 -P 6800 -u root -p root
#终端命令行窗口提示登录成功并显示服务端IP和端口号，客户端版本和发布时间以及客户端ID等信息
FarelDB 127.0.0.1:6800> 

退出FarelDB> 命令提示窗口可以使用 exit 命令，如下所示：

// 退出客户端
FarelDB 127.0.0.1:6800>  exit
C:\FarelDB>

---

API 说明

函数原型

tuple<int, string> connect(string host, int port, string user, string password, unsigned int tryReconnectWaitSeconds = 0)

时间复杂度

O(1)

输入参数说明：

输入参数	描述	默认可选
host	连接FarlDB服务端的IP地址	否
port	连接FarlDB服务端的IP地址	否
user	连接用户名	否
password	连接密码	否
tryReconnectWaitSeconds	当连接失败后，在该时间段内反复尝试连接，单位：秒	可选 默认值：0

返回参数说明：

tuple<int , string>

调用正常返回

返回参数	值	含义
int	0	调用成功，正常返回
string	空字符串	调用成功 返回空字符串

调用异常返回

返回参数	值	含义
int	大于0的数值	调用错误，返回错误代码
string	非空字符串	调用错误，返回 错误信息字符串

样例代码

#include <iostream>
#include <functional>
#include <memory>
#include "fareldb_connection.h"
using namespace std;
using namespace fareldb_connection;

//与服务端连接样例代码
int main(int argc, char* argv[]) 
{
	//创建链接对象
	FarelDbConnection conn;
	
	//与服务端连接
	tuple<int, string> res = conn.connect( "127.0.0.1", 6800, "root", "root");
	
	//判断连接是否成功
	if (0 == get<0>(res))
	{
		printf("连接成功. \n");
	}
	else
	{
		printf("连接失败：错误代码：%d ，错误信息： %s \n", get<0>(res), get<1>(res).c_str());
	}
}

应用场景

1. FarelDB操作的所有命令在执行前都需要进行connect，以保证客户端和服务端的正常通信以及保证数据交互安全性。
2. connect调用成功是客户端和服务端之间保持心跳连接的开始，也是服务端监听客户端是否断开的唯一途径