HttpClient

需要先构建 libcurl、libssl（arm版本为1.0.1，x86版本为1.0.2）、libcrypto（arm版本为1.0.1，x86版本为1.0.2）和libz的静态链接库。

wget https://github.com/curl/curl/releases/download/curl-7_47_0/curl-7.47.0.tar.gz
tar -zxf curl-7.47.0.tar.gz
cd curl-7.47.0
CFLAGS="-fPIC" ./configure --prefix=/tmp/curl --without-nss --with-ssl=/tmp/ssl --with-ca-bundle=/etc/ssl/certs/ca-certificates.crt //指定前面安装的openssl的所在位置，否则不支持https协议。并且指定了https的默认证书位置。
make
make install

wget http://www.zlib.net/zlib-1.2.11.tar.gz
tar -zxf zlib-1.2.11.tar.gz
cd zlib-1.2.11
CFLAGS="-fPIC" ./configure  --prefix=/tmp/zlib 
make 
make install

在使用make构建时，需要指定 CURL_DIR和SSL_DIR（假定 libssl.a 和 libcrypto.a 在同一个目录下）。例如：

mkdir build
cd build
cmake -DCURL_DIR=/tmp/curl -DSSL_DIR=/tmp/ssl -DZ_DIR=/tmp/zlib  ..
make -j

会在当前目录下编译出插件库 libPluginHttpClient.so。

发送HTTP GET请求。

语法

httpClient::httpGet(url, [params], [timeout], [headers])

参数

• url：请求的URL字符串。
• params：一个字符串或一个键和值都是string的字典。http协议Get方法请求的会把参数放在url的后面。 假如url为 www.dolphindb.cn，
  • 如果params为一个字符串（例如，"example"），则发出的完整http报文的请求头中的url为 "www.dolphindb.cn?example"。
  • 如果params为一个字典（例如，两个键值对"name"->"zmx"和"id"->"111"），则发出的完整http报文的请求头中的url为 "www.dolphindb.cn?id=111&name=zmx"。
• timeout：超时时间，单位为毫秒。
• headers：一个字符串或一个键和值都是string的字典，填写http请求头部。如果headers为一个字典（两个键值对"groupName"->"dolphindb"和"groupId"->"11"）， 则发出的完整http报文添加请求头"groupId:11"和"groupName:dolphindb"。如果只是一个字符串，则必须是"xx:xx"格式，会添加一个http请求头。

返回一个dictionary，包括以下键：

• responseCode：请求返回的响应码
• headers：请求返回的头部
• text：请求返回的内容文本
• elapsed：请求经过的时间

例子

loadPlugin('/home/zmx/worker/DolphinDBPlugin/httpClient/PluginHttpClient.txt');
param=dict(string,string);
header=dict(string,string);
param['name']='zmx';
param['id']='111';
header['groupName']='dolphindb';
header['groupId']='11';
//Please set up your own httpServer ex.(python -m SimpleHTTPServer 8900)
url = "localhost:8900";
res = httpClient::httpGet(url,param,1000,header);

发送HTTP POST请求。

语法

httpClient::httpPost(url, [params], [timeout], [headers])

参数

• url：请求的URL字符串。
• params：一个字符串或一个key是string的字典。http协议Post方法请求的会把参数放在http请求正文中。
  • 如果params为一个字符串（例如，"example"），则发出的完整http报文的请求正文l为"example"。
  • 如果params为一个字典（例如，两个键值对"name"->"zmx"和"id"->"111"），则发出的完整http报文的请求正文为 "id=111&name=zmx"。
• timeout：超时时间，单位为毫秒。
• headers：一个字符串或一个键和值都是string的字典，填写http请求头部。如果headers为一个字典（两个键值对"groupName"->"dolphindb"和"groupId"->"11"）， 则发出的完整http报文添加请求头"groupId:11"和"groupName:dolphindb"。如果只是一个字符串，则必须是"xx:xx"格式，会添加一个http请求头。

返回一个dictionary，键包括：

• responseCode：请求返回的响应码
• headers：请求返回的头部
• text：请求返回的内容文本
• elapsed：请求经过的时间

例子

loadPlugin('/home/zmx/worker/DolphinDBPlugin/httpClient/PluginHttpClient.txt');
param=dict(string,string);
header=dict(string,string);
param['name']='zmx';
param['id']='111';
header['groupName']='dolphindb';
header['groupId']='11';
//Please set up your own httpServer ex.(python -m SimpleHTTPServer 8900)
url = "localhost:8900";
res = httpClient::httpPost(url,param,1000,header);

发送邮件。

• 本插件使用smtp邮件传输协议，所以邮件服务器必须支持smtp协议和开启smtp端口，如果邮件服务商没有默认开启smtp端口，则需要开启该账号邮箱的smtp服务。还需要注意该邮件服务商是否提供邮箱授权码的功能，如果有，此时的参数pwd为邮箱授权码而非邮箱密码。
• 如果成功发送邮件，返回字典res，res['responseCode']==250。

语法

httpClient::sendEmail(userId,pwd,recipient,subject,body)

参数

• userId：发送者邮箱账号。
• pwd：发送者邮箱密码。
• recipient：目标邮箱账号的一个字符串或一个字符串集合。
• subject：邮件主题的字符串。
• body：邮件正文的字符串。

返回一个dictionary，键包括：

• userId：发送者邮箱账号
• recipient：接受者邮箱的集合的字符串
• responseCode：请求返回的响应码
• headers：请求返回的头部
• text：请求返回的内容文本
• elapsed：请求经过的时间

例子

res=httpClient::sendEmail('MailFrom@xxx.com','xxxxx','Maildestination@xxx.com','This is a subject','It is a text');

recipient='Maildestination@xxx.com''Maildestination2@xxx.com''Maildestination3@xxx.com';
res=httpClient::sendEmail('MailFrom@xxx.com','xxxxx',recipient,'This is a subject','It is a text');

配置邮件服务器。

语法

httpClient::emailSmtpConfig(emailName,host,post)

参数

• emailName：邮箱名称，格式为邮箱'@'字符后的字符串。类型为字符串。如果是qq邮箱，则是"qq.com"。如果是yeah邮箱，则是"yeah.net"。
• host：邮箱stmp服务器的地址。类型为字符串。
• port：邮箱服务器端口。类型为INT。如果为空，默认为25。

例子

emailName="qq.com";
host="smtp.qq.com";
port=25;
httpClient::emailSmtpConfig(emailName,host,port);