文件服务.二开案例.WebApi方式从币别单据上传、下载附件

本案例将演示第三方系统，如果通过WebApi上传下载附件至业务单据上。

1、上传：

    1.1、传入用户名及密码等，通过WebApi登录接口获取登录上下文中的UserToken。

    1.2、传入UserToken及文件流等信息，通过应用服务器文件上传接口将文件分段上传至当前启用的文件服务实例，返回FileId文件编码等信息。

    1.3、传入FileId文件编辑及相关文件信息，通过WebApi保存接口，保存附件与单据的关联信息进到附件信息 表格。

    1.4、注意：通过此方式上传附件并不会更新附件数，需自行更新，单据无附件数字段可忽略此提醒。

2、下载：

    2.1、传入用户名及密码等，通过WebApi登录接口获取登录上下文中的UserToken。

    2.2、传入文件编码及UserToken等信息，通过应用服务器文件下载接口将文件下载到本地。

3、文件服务示例代码如下：

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.IO;
using System.Net;
using System.Text;
using System.Web;

namespace Kingdee.FileServiceDemo
{
    public class FileService
    {
        private const string WebSiteUrl = "http://localhost/k3cloud/"; //应用服务器地址。
        private readonly ApiClient _client = new ApiClient(WebSiteUrl);
        private string _fileId;

        private string GetUserToken()
        {
            string dbId = "5e7074b0e8e407"; //数据中心内码。
            string username = "Administrator"; //用户名。
            string password = "888888"; //密码。
            int lcid = 2052; //登录语言。

            string loginResultString = _client.Login(dbId, username, password, lcid);
            JObject loginResult = JsonConvert.DeserializeObject<JObject>(loginResultString);
            return loginResult["Context"]["UserToken"].ToString();
        }

        public void Upload()
        {
            //上传附件至金蝶云星空系统。
            string filePath = @".\123.txt"; //测试用附件地址。
            JObject uploadResult = UploadToWebSite(filePath);
            if (uploadResult == null)
            {
                throw new Exception("上传返回结果为空。");
            }
            //保存与单据的关联关系。
            string res = SaveBillData(uploadResult);
        }

        /// <summary>
        /// 传入文件物理路径，上传附件至当前启用的文件服务实例，返回上传结果。
        /// </summary>
        /// <param name="filePath">文件物理路径。</param>
        /// <returns>返回上传结果。</returns>
        private JObject UploadToWebSite(string filePath)
        {
            JObject uploadResult = null;
            string fileId = string.Empty; //文件内码。
            long blockSize = 1024 * 1024; //分块上传大小。
            string fileName = Path.GetFileName(filePath); //文件名。
            string token = GetUserToken(); //用户登录Token。

            using (FileStream fsRead = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite))
            {
                if (fsRead.Length <= 0) throw new Exception("文件内容不允许为空。");
                int block = Convert.ToInt32(Math.Ceiling((fsRead.Length * 1.0) / blockSize));
                for (int i = 0; i < block; i++)
                {
                    byte[] content = new byte[blockSize];
                    int size = fsRead.Read(content, 0, content.Length);
                    if (size == 0) break;
                    byte[] uploadBytes = new byte[size];
                    Array.Copy(content, uploadBytes, size);

                    bool last = i == block - 1;
                    uploadResult = UploadToWebSite(fileName, fileId, token, last, uploadBytes);
                    if (uploadResult == null) throw new Exception("上传返回结果为空。");

                    _fileId = fileId = uploadResult["FileId"].ToString(); //获取返回的文件内码。
                    bool success;
                    Boolean.TryParse(uploadResult["Success"].ToString(), out success);
                    if (!success) throw new Exception(uploadResult["Message"].ToString());
                    if (last) break;
                }
            }
            return uploadResult;
        }

        private JObject UploadToWebSite(string fileName, string fileId, string token, bool last, byte[] content)
        {
            string url = string.Format(
                "{0}FileUpLoadServices/FileService.svc/upload2attachment/?fileName={1}&fileId={2}&token={3}&last={4}",
                WebSiteUrl, HttpUtility.HtmlEncode(fileName), fileId, token, last);
            string responseString = _client.UploadData(url, fileName, content);
            JObject loginResult = JsonConvert.DeserializeObject<JObject>(responseString);
            return loginResult["Upload2AttachmentResult"] as JObject;
        }

        private string SaveBillData(JObject uploadResult)
        {
            //业务对象唯一标识：附件明细。
            string formID = "BOS_Attachment";

            //Model数据包。
            JObject jsonRoot = new JObject();
            jsonRoot.Add("Creator", "Demo"); //创建用户。
            jsonRoot.Add("NeedUpDateFields", new JArray("")); //需要更新的字段：为空则表示全部。

            JObject model = new JObject(); //Model: 单据详细数据参数
            jsonRoot.Add("Model", model);
            model.Add("FID", 0); //内码：为零代表新增。
            model.Add("FBILLTYPE", "BD_Currency"); //业务单据唯一标识：此处关联币别。
            model.Add("FINTERID", 1); //业务单据内码：此处上传至人民币，内码为1。
            model.Add("FBILLNO", "PRE001"); //业务单据编码：此处上传至人民币，编码为PRE001。
            model.Add("FENTRYKEY", " "); //关联实体标识：单据头为空格，单据体则填单据体标识。
            model.Add("FENTRYINTERID", -1); //单据体内码：单据头为-1，单据体则填单据体内码。
            model.Add("FFILEID", uploadResult["FileId"].ToString()); //文件编码：上面上传成功拿到文件编码。
            model.Add("FFILESTORAGE", "1"); //存储类型：1为文件服务器、2为亚马逊云存储、3为金蝶·个人云存储、4为金蝶·企业云存储。
            string fileName = uploadResult["FileName"].ToString();
            model.Add("FATTACHMENTNAME", fileName); //附件名。
            model.Add("FEXTNAME", Path.GetExtension(fileName)); //文件后缀名。
            Decimal fileSize = Convert.ToDecimal(uploadResult["FileSize"].ToString());
            model.Add("FATTACHMENTSIZE", Math.Round(fileSize / 1024, 2)); //附件大小，单位为KB。
            model.Add("FBILLSTATUS", "A"); //单据状态：给默认值A即可。
            model.Add("FALIASFILENAME", ""); //别名。
            model.Add("FIsAllowDownLoad", false); //是否禁止下载：false代表允许下载。
            JObject userJObject = new JObject { { "FUSERID", 16394 } }; //管理员内码16394。
            model.Add("FCREATEMEN", userJObject); //创建人。
            model.Add("FCREATETIME", DateTime.Now); //创建时间。
            model.Add("FMODIFYMEN", userJObject); //修改人。
            model.Add("FMODIFYTIME", DateTime.Now); //修改时间。

            //调用保存接口。
            string res = _client.Save(formID, jsonRoot.ToString());
            return res;
        }

        public void Download()
        {
            string filePath = @".\124.txt"; //测试用附件下载地址。
            string token = GetUserToken(); //用户登录Token。
            string nail = "1"; //是否下载缩略图，1为缩略图，其余为原图。

            //fileId文件编码可由 T_BAS_ATTACHMENT 附件明细表查得，此处直接拿上面上传文件的编码来做示例。
            string url = string.Format("{0}FileUpLoadServices/Download.aspx?fileId={1}&token={2}&nail={3}",
                WebSiteUrl, _fileId, token, nail);
            using (WebClient webClient = new WebClient() { Encoding = Encoding.UTF8 })
            {
                webClient.DownloadFile(url, filePath); //下载保存物理文件方式。
            }
        }
    }
}

4、API客户端示例代码如下：

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Security.Cryptography;
using System.Text;
using System.Web;

namespace Kingdee.FileServiceDemo
{
    /// <summary>
    /// API调用客户端。
    /// </summary>
    public class ApiClient
    {
        private readonly CookieContainer _cookieContainer;
        private string _webSiteUrl;

        public ApiClient(string webSiteUrl)
        {
            _cookieContainer = new CookieContainer();
            _webSiteUrl = webSiteUrl;
        }

        /// <summary>
        /// 传入Url，创建并返回Http请求对象。
        /// </summary>
        /// <param name="url"></param>
        /// <returns>返回Http请求对象。</returns>
        private HttpWebRequest CreateHttpRequest(string url)
        {
            HttpWebRequest httpWebRequest = (HttpWebRequest)WebRequest.Create(url);
            //设置请求关联的Cookie。
            httpWebRequest.CookieContainer = _cookieContainer;
            httpWebRequest.Method = "POST";
            return httpWebRequest;
        }

        /// <summary>
        /// 传入文件上传地址、文件名及文件内容，上传文件并返回上传结果。
        /// </summary>
        /// <param name="url">文件上传地址。</param>
        /// <param name="filename">文件名。</param>
        /// <param name="data">文件内容。</param>