猿大师中间件文件操作浏览器小程序开发文档

猿大师中间件文件操作浏览器小程序开发原理：

猿大师中间件文件操作浏览器小程序是基于猿大师中间件网络版开发，提供本地文件HTTP协议上传与下载、本地图像文件旋转与缩放、本地文件访问、本地程序运行等服务。最低可用在Chrome 41、Firefox 50、Edge 80(Chromium内核)、360极速/安全、IE 8、Oprea 36、QQ、搜狗等浏览器，也兼容运行于这些浏览器的最新版本。

 

1、猿大师中间件的安装步骤：
 

1)、如果是exe的安装程序，请直接运行安装；

2)、如果是绿色版的程序包，请解压到磁盘某个目录后，双击“InstallWrl.bat”进行安装；

3)、安装完成时会启动猿大师中间件服务，在安装目录下的Data子目录有ZbaService.txt日志文件输出运行情况。

 

2、请求安装文件操作小程序：

 

{"req":"Plugin_Install","rid":1,"para":{"Name":"文件操作小程序","PID":"199BB8A7-9DD5-41F5-AE9D-2AA94300B0B3","Date":"2021-03-27","Desc":"猿大师中间件之上跨浏览器的文件操作小程序，提供文件HTTP协议上传与下载、本地图像文件缩放与旋转、本地文件访问、本地程序运行等服务，可在Chrome、Edge、Firefox、IE、Opera、360、QQ等的浏览器最新版中调用","DownAddr":"http://local.zorrosoft.com/Files/Net/WrlFileApplet.pid","MD5":"1C03FC92A8BEEBCAC9FA4135F5CC8616","Version":"2.1.3.1","Size":491520,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"33F4C7BC8E9984BC673B40F4F7CBAF333D73A8ED3015EB17C3C1540FF4E9262612412DB1476E9307C3B92EE021CB62FDA4022721154AB93B57D05EFA8A60181B136DBB84724C2A220AAEC8488DEB195EFB31AA6E7A01DD621CB5B12F24D1059ADA057D77B456CE6BF891E6DA8C52E3C0BB92DA6D1BD451B1F1EEC4B9BC02E4E13F084A5FFDEB73FEA7DBF511DADEC4A9FC70288FF8B3656DAA5749B341A67633AF592D11B2997A321E3C05C6E2992A6B630800B1F93887EF5ACD054C3DC8173BAB39BE8CC743B49555717C7B9962074314F8BB72E6992882E4832E2C62A5ECF845149B51D961859110DA80177FDDB8C0CBEBD267F7A96787C795426F6FDBB9D5"}}

 

3、请求更新文件操作小程序：

 

{"req":"Plugin_Update","rid":1,"para":{"Name":"文件操作小程序","PID":"199BB8A7-9DD5-41F5-AE9D-2AA94300B0B3","Date":"2021-03-27","Desc":"猿大师中间件之上跨浏览器的文件操作小程序，提供文件HTTP协议上传与下载、本地图像文件缩放与旋转、本地文件访问、本地程序运行等服务，可在Chrome、Edge、Firefox、IE、Opera、360、QQ等的浏览器最新版中调用","DownAddr":"http://local.zorrosoft.com/Files/Net/WrlFileApplet_Update.pid","MD5":"317CC6BF755C12B26166A5430AC0F2D5","Version":"2.1.3.1","Size":491520,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"71A6FB5B46337E4AC5C2646B9007CC8DE96A56E14EE8DF5D5469E54758B7879F119DC7EFF96A6A3D75304789638434F68F62B3959EC33CEFDB8F99BE73E6D84D5FFC78C237CDBE72670997C80DD51388B9FA0495E230A8D4C526BBFBFAD19A5E0996E7F7441498685EC5C003E59E1573A022639B3CAC3DECA3E1B08CDB99152AF83D46235AD2A5F1B5F2EF91000E85893915B1F5B232EB76AC7387F1D422AB9233914CAB31A851DA63DA12B4BA5AD0266D772E229D755699F884ED99B6A6E0094BA1BADA10D5386248957FF0BBF0DADE3DB8D75F2BC1EFE918534B3C1FC0D65B5181874A38845F5DC534AC38A4AF1E8F5B6C68ABC48B977AB8459913FE444E7A"}}

 

以上安装和升级的JSON请求包，可能因版本升级导致内容不同，如遇安装或升级时报错，请联系客服获取最新的请求包。 

 

4、连接请求文件操作小程序服务：
 

1)、图像文件处理及本地文件操作服务

说明：以下功能请通过Web Socket连接后可执行，如默认侦听端口不是80(关于如何配置侦听端口，请参考SDK包中的文档“猿大师开发者手册.doc”)，请在连接地址中指定端口号进行连接。

打开测试网页，输入地址：ws://localhost:83?sid=667&pid=D325C871-AB46-479B-B20E-1D861D26CA89&flag=1 点击连接；

 

支持的协议功能如下：

A、批量旋转图像文件

SrcFile、DestFile传入前需进行UrlEncode编码

{"req":"File_RotateImg","rid":1,"para":{"Angle":90,"Items":[{"ID":"11","SrcFile":"C:/Users/trade/Pictures/test/test.png","DestFile":"C:/Users/trade/Pictures/test/testnew.png"}]}} 

旋转指定文件SrcFile指定角度Angle，DestFile为指定时代表生成新图像文件，不指定时直接覆盖到原图

返回内容 {"ret":0,"rid":1,"data":{"Ret":[{"ID":"","Ret":1},{"ID":"","Ret":1}]}} Ret代表是否成功

 

B、请求指定图像文件的BASE64编码数据

File传入前需进行UrlEncode编码

{"req":"File_GetImg","rid":2,"para":{"File":"C:/test.jpg","Original":1,"Thumb":{"Width":200,"Height":300,"File":"C:/Newtest.jpg"}}}  

指定Original为1时代表同时取原图，有Thumb节点时取指定大小的缩略图，Thumb节点中指定File文件名代表保存到本地，不指定时取原图数据 {"ret":0,"rid":2,"data":{"Thumb":"","Original":"","ThumbFile":"","Ret":1}}

 

C、关联打开指定文件或指定执行程序打开

File传入前需进行UrlEncode编码

{"req":"File_Open","rid":3,"para":{"File":"D:/Zorro/WRL/Data/WrlService.txt"}}  File为本地路径

指定执行程序打开指定文件

{"req":"File_Open","rid":4,"para":{"File":"C:/Windows/System32/notepad.exe D:/Zorro/WRL/Data/WrlService.txt"}}

 

D、删除本地文件

Items子项目传入前需进行UrlEncode编码

{"req":"File_Delete","rid":5,"para":{"Day":7,"Items":["c:/Newtest.jpg","c:/test.jpg"]}} 删除Items指定的本地文件，可支持多个

 

E、创建指定目录

Dir传入前需进行UrlEncode编码

{"req":"File_CreateDir","rid":6,"para":{"Dir":"D:/Zorro/WRL/Data/Temp"}}  Dir为本地路径

返回如下信息：

{"ret":0,"rid":6,"data":{"Ret":"1","ErrCode":0}}

 

F、删除指定目录及子目录所有文件

Dir传入前需进行UrlEncode编码，不能删除磁盘根目录及系统及程序目录等文件

{"req":"File_DelDir","rid":7,"para":{"Dir":"D:/Zorro/WRL/Data/Temp"}}  Dir为本地路径

返回如下信息：

{"ret":0,"rid":7,"data":{"Ret":"1"}}

 

G、取指定文件属性

Dir传入前需进行UrlEncode编码，不能删除磁盘根目录及系统及程序目录等文件

{"req":"File_Info","rid":8,"para":{"File":"C:/Users/trade/Pictures/test/test.png"}}  File为本地路径

返回如下类似信息：

{"ret":0,"rid":8,"data":{"Ret":"1","Size":92095,"MD5":"B28B987EC70E1E7853F89A52CEDE68F0","Attribute":32,"CreateTime":"2020-10-07 13:07:20","LastWriteTime":"2020-07-14 10:09:43","Ver":"","CorpName":"","Desc":"","Width":1280,"Height":720}}

 

H、取指定目录下文件和目录列表

Dir传入前需进行UrlEncode编码，不能删除磁盘根目录及系统及程序目录等文件

{"req":"File_List","rid":8,"para":{"Dir":"D:/Zorro/WRL","Find":"*.*"}}  Dir为本地路径

返回如下类似信息：

{"ret":0,"rid":8,"data":[{"Name":"WrlSetup.exe","Size":157184,"Attr":2080,"Write":"2020-10-07 15:00:15"},{"Name":"X64"}]}

无属性Attr、大小Size和文件修改时间Write的是目录，否则是文件

 

2)、文件HTTP上传与下载服务

打开测试网页，输入地址：ws://localhost:83?sid=678&pid=762C3400-B3E5-4F00-8AA7-18E00F13E414&flag=1 点击连接；

支持的协议功能如下：

 

A、下载文件

Url、File传入前需进行UrlEncode编码

{"req":"File_Download","rid":1,"para":{"Cookie":"","Auth":"","Items":[{"ID":"","Url":"","File":"","MD5":"","Size":300}]}} 批量下载指定URL及文件名File等参数的文件,ID是前端指定的唯一ID，返回添加成功数量，重复的不计算，增加下载权限参数Cookie及Auth

 

B、上传文件

Url、Items子项目传入前需进行UrlEncode编码，Url为上传URL地址，ID为上传序号

Para为POST数据包中需要传递的参数param，默认上传文件名为upfile，否则通过NodeName设置自己的文件参数名称

批量上传到指定URL的本地文件，返回添加成功数量，重复的不计算

{"req":"File_Upload","rid":2,"para":{"ID":"","Url":"","Cookie":"","Auth":"","Para":"","Items":["c:/Newtest.jpg","c:/test.jpg"]}} 

 

C、停止上传/下载 一般用于页面退出

{"req":"File_Stop","rid":3,"para":{""Type":1}} 不指定停止所有，指定Type时1代表下载 2代表上传

 

D、删除数据记录

{"req":"File_Delete","rid":4,"para":{"Day":7}} 删除指定Day前数据库中的上传下载任务记录

 

/// 单个下载任务通知

{"event":"File_Status","data":{"ID":"","Url":"","File":"","Type":1,"Status":0,"Percent":0,"Error":""}} Status为状态码(1等待 2 正在进行 4成功 8取消 16错误) Percent为百分比 Error错误描述

/// 单个上传任务通知

{"event":"File_Status","data":{"ID":"","Ret":"","Type":2,"Status":0,"Percent":0,"Error":""}} Status为状态码(1等待 2 正在进行 4成功 8取消 16错误) Percent为百分比 Error错误描述 Ret为上传成功服务器返回的数据包

 

/// 上传或下载全部结束通知

{"event":"File_OK","data":{"Type":1"}} 通知上传或下载结束，Type 1代表下载全部完成 2代码上传全部完成

 

 

5、其它

请求参数的JSON数据包，请确保是UTF-8无签名的编码。

更多接口请求说明，请参考安装目录中的文档TestWrl.txt、SDK包中的“猿大师开发者手册.doc”及“猿大师中间件安全解决方案”。

如还有疑问请直接联系客服。