AWS MVC框架参考指南

上传文件

AWS应用容器对每个应用各类资源提供了沙箱管理，对于文件读写提供了一套完善的DC(Doc Center)机制，文件必须通过DC处理器进行处理。AWS对文件上传封装了一个公用的组件，能够满足常用浏览器（IE8+, Firefox, Google Chrome, Safari、平板UC等）的文件上传功能。

服务端插件注册和声明

注册DCPluginProfile需要你声明repositoryName（存放文件的根目录名）和文件处理器（继承com.actionsoft.bpms.server.fs.AbstFileProcessor）。

• 有关DC开发详细内容，参见《AWS 插件扩展开发参考指南》
• 有关DC API操作（如读、写文件），参见aws-api-doc提供的DCAPI

客户端调用

upfile是AWS UI封装的通用文件上传组件，采用双核技术（IE8/IE9提供Flash模式，对支持HTML5的浏览器采用无插件模式）实现批量文件上传、文件类型过滤、文件大小控制和上传进度控制，对各类浏览器提供了较好的体验支持。

上传组件的资源引用

<link rel="stylesheet" type="text/css" href="../commons/css/awsui.css"/>
<script type="text/javascript" src="../commons/js/jquery/scripts/jquery.js"></script>
<script type="text/javascript" src="../commons/js/awsui.js"></script>

用JavaScript打开上传对话框

<script type="text/javascript">
$(function(){
    //myUpfile对象绑定upfile组件
    $("#myUpfile").upfile({
        sid: "<#sid>", // 会话ID
        appId: "com.actionsoft.apps.poc.plugin", // 应用ID
        groupValue: "dir1", // DC大类，建议变量规则
        fileValue: "dir2", // DC小类，建议变量规则
        numLimit: "2", //最多一次允许上传几个，0(无限制)
        filesToFilter : [["Images (*.jpg; *.jpeg; *.gif; *.png; *.bmp)","*.jpg; *.jpeg; *.gif; *.png; *.bmp"]],
        repositoryName: "myfile", // 该应用申请的DC名
        done: function(e, data){
            //事件回调函数
            //上传完成后，开始调用导入代码
            if (awsui.ajax.ok(data.result.data)) {//判断请求是否执行成功
                //可以调用公共方法处理提示信息
                awsui.ajax.alert(data.result.data);
                //或者自行处理提示信息
                //$.simpleAlert('文件上传成功!');
                // downloadURL
                var url = data.result.data.data.attrs.url;
                //如果定义了其他返回的属性，也需要使用data.result.data.data.attrs调用
            } else {
                // 上传失败，提示出错误信息
                awsui.ajax.alert(data.result.data);
            }
        }
    });

});
</script>

上传按钮的定义

<span id="myUpfile" class="button green" onclick="return false;">上传</span>

上述客户端调用示例，也可从AWS企业应用商店安装扩展插件概念验证应用，所有源码在src目录下

参数说明

• 属性

• 事件

上面的客户端调用和参数说明适合6.4.GA之前的版本，6.4.GA及以后的版本用下面的

客户端调用

awsui-upload-file是AWSUI封装的通用文件上传组件，实现批量文件上传、文件类型过滤、文件大小控制和上传进度控制。

上传组件引入AWSUI资源

import awsui from "../libraries/lib/awsui.es"; //注意awsui组件库根据情况指定路径
import "../libraries/lib/awsui.css";

在VUE中打开上传对话框

<awsui-upload-file
    :url="url"
    :files="uploadImgList"
    :fileCount="options.fileCount"
    :fileMaxSize="options.fileMaxSize"
    :fileTypeFormat="fileTypeFormat"
    :drag=true
    :accept="accept"
    @on-success="handleImgSuccess"
    @onExceed="handleExceed"
    @onError="handleError"
    @onProgress="handleProgress"
    :before-upload="beforeUpload"
>
<template #button>
  <awsui-button :class="{'up-file-btn': true, 'disabled': progressList.length > 0}">
    <i class="awsui-iconfont upload-icon">&#xf0f0;</i>{{$t("上传")}}
  </awsui-button>
</template>
</awsui-upload-file>

参数说明

• URL属性格式 'uf?sid=&appId=&repositoryName=&groupValue=&fileValue='

• URL属性具体说明

• 其他属性

• 事件