简介
Yuntan-Service是一个基于Node.js的云端基础服务，主要用于提供各种基础功能，如：日志管理、文件管理、邮件发送等，本篇文章主要介绍如何使用Yuntan-Service。
安装
使用npm安装，需要先安装node.js
npm install yuntan-service --save
使用
在项目中引入yuntan-service：
var yuntanservice = require('yuntan-service');接着，通过如下方式连接到Yuntan-Service云端服务
yuntanservice.init('http://yuntan-xxxxx:port', 'appkey', 'appsecret', function (err) {
if (err) {
console.error('init yuntan-service fail:', err);
return;
}
console.log('init yuntan-service succ!');
});其中第一个参数是Yuntan-Service的连接地址，第二个和第三个参数是在Yuntan-Service开发者中心中申请的appkey与appsecret，callback函数中返回参数中err表示连接失败的原因，如果err为null则表示连接成功。
日志管理
在项目中，如果需要记录一些log日志，我们可以使用Yuntan-Service的log服务，通过如下方式记录一条日志：
var log_data = {'key' : 'value'};
yuntanservice.log.log('tag','title','content',log_data,function(err){
if(err){
console.error('write log fail:',err);
return;
}
});上面的代码中，tag表示日志标签，title表示日志标题，content表示日志正文，log_data则表示需要记录的日志数据。callback函数中返回参数中err表示记录日志失败的原因，如果err为null则表示记录日志成功。
我们可以通过如下方式查询log：
-- -------------------- ---- -------
--- ------- - ---
------------- - ----------- ---------- -- ------
------------- - ----------- ---------- -- ------
----------------- - ------------------ -- ----
------------- - --- -- ---------
-------------- - -- -- --------
------------- - ------ -- -----------
------------- - ------ -- -------
------------------------------ -------- ------------- ------
--------
-------------------- ---- ------------
-------
-
------------------ -------------
---上述代码中，tag表示日志标签，options是查询参数，我们可以通过条件、时间范围、排列顺序、偏移量等参数来查询日志。
文件管理
如果需要上传文件到云端存储，我们可以使用yuntanservice.file.insert服务，通过以下方式上传文件：
-- -------------------- ---- -------
--- -- - --------------
--- ---- - ----------- -- ------
--- ------ - ---------------------- -- ----------
--- ------ - ---------------------- -- -----
--- -------- - ------- - ------- -- ----
--- ------------ - ------------- -- --------------
------------------------------------------- -------
--------- ------------- ------------- --------
--------
--------------------- ---- ------------
-------
-
------------------------------------
-------------------------------
---------------------------------
-----------------------------------------
---上述代码中，path/to/upload表示上传到云端的路径，我们通过通过本地文件路径读取到该文件的Buffer，并指定文件名称、Content-Type,同时在callback函数中返回上传后的文件信息，例如：文件名称、url、大小、mime类型。
如果需要下载云端文件，我们可以使用yuntanservice.file.get服务，通过以下方式下载文件：
-- -------------------- ---- -------
--- ------- - ---------------------------- -- ----------
--- --- - ----------- -- --------
--------------------------- -------- ------------- -
-- ----- -
----------------------- ------- -----
-------
-
--------------------- -----------
---邮件发送
如果项目中需要发送邮件功能，我们可以使用Yuntan-Service的mail服务，通过如下方式发送邮件：
-- -------------------- ---- -------
--- ------- - ---
------------ - --------------- -- ---
---------- - ---------------- -- -----------
--------------- - ------- -- ----
------------ - ------- -- ----
-------------------------------- --------------
--------
------------------- ---- ------------
-------
-
----------------- ---- -----------
---上述代码中，message.from表示发件人，message.to表示收件人（多个收件人用逗号分隔），message.subject表示邮件主题，message.text表示邮件文本内容。callback函数中返回参数中err表示发送邮件失败的原因，如果err为null则表示发送邮件成功。
总结
本文主要介绍了如何使用Yuntan-Service提供的日志管理、文件管理、邮件发送等云端基础服务，并且给出了实际应用的代码示例。通过本文，读者可以清楚的了解到如何进行前端开发时云端服务的调用，希望可以对大家有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/80247