likes
comments
collection
share

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

作者站长头像
站长
· 阅读数 58

一套适合 SAP UI5 初学者循序渐进的学习教程

作者简介

Jerry Wang,2007 年从电子科技大学计算机专业硕士毕业后加入 SAP 成都研究院工作至今。Jerry 是 SAP 社区导师,SAP 中国技术大使。在长达 15 年的 SAP 标准产品开发生涯里,Jerry 曾经先后参与 SAP Business ByDesign, SAP CRM, SAP Cloud for Customer, SAP S/4HANA, SAP Commerce Cloud(电商云)等标准产品的研发工作。

Jerry 工作中使用 ABAP, Java, JavaScript 和 TypeScript 进行开发, 对包括 SAP UI5 在内的多款 SAP 自研框架有深入的研究。

教程目录

说明

Jerry 从 2014 年加入 SAP成都研究院 CRM Fiori 开发团队之后开始接触 SAP UI5,曾经在 SAP 社区和“汪子熙”微信公众号上发表过多篇关于 SAP UI5 工作原理和源码解析的文章。

在 Jerry 这篇文章 对 SAP UI5 一无所知的新手,从哪些材料开始学习比较好? 曾经提到,Jerry 也是从 SAP UI5 菜鸟一路走过来,深知只有 ABAP 开发背景的开发者,向 SAP UI5 开发领域转型的不易,因此我在业余时间设计了这份适合 SAP UI5 不同水平的学习者的学习教程,把开发一个完整的 SAP UI5 应用的流程,拆分成若干个步骤,力求每个步骤里,把涉及到的知识点都涵盖到。

这些知识点可能不像我的 UI5 源码分析系列文章那么深入,但力求做到深入浅出,重要的知识点都配上详细的截图来辅助文字的介绍,便于教程学习者的理解。

本教程每一个步骤的源代码,都存放在我的 Github 上,分别用文件夹 01,02,03 等等来标识,例如步骤 1 的源代码在这里

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

每一个步骤均是前一步骤的基础上,添加了若干新特性。建议零基础或者对 SAP UI5 知之甚少的 SAP UI5 初学者,按照顺序从第一个步骤开始循序渐进地学习,把这些代码下载到本地,配合教程的文字讲解,自己动手,以加深理解。

对于已经有一定基础的 SAP UI5 开发人员,可以通过本文的目录,跳过前面一部分比较基础的章节,直接挑选对自己工作项目有关,或者包含某些知识点自己尚未掌握的章节来有针对性地学习。

大家如果对教程的每个步骤有任何疑问,欢迎在教程对应的步骤文章里给我评论,进行留言。我虽然平时开发工作很忙,但是保证会定期查看大家给我留下的评论,对于里面涉及到的技术疑问,我一定会抽时间做出解答

本教程我们已经花了三个步骤的篇幅,介绍了 SAP UI5 FileUploader 的使用方法,实现原理,以及引起跨域访问错误的根源。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

我们再次回顾一下这个跨域访问的错误根源:

(1) 我们开发的 SAP UI5 应用,向 XML 视图里,FileUploader 控件的 uploadUrl 硬编码的 localhost:3003 发起文件上传请求,如下图图例 1.

(2) 监听在 3003 端口上的文件服务器(下图右边),接收到这个上传请求,将响应返回给 SAP UI5 框架创建的隐藏 iframe 的 body 节点中去(细节在之前的步骤SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe里有介绍)。使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

(3) 因为这个隐藏的 iframe 接收的响应来自 localhost:3003, 因此无法通过来自 localhost:8080 的 SAP UI5 app 访问,会遇到错误消息:

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

Uncaught DOMException: Blocked a frame with origin “http://localhost:8080” from accessing a cross-origin frame.at eval (eval at (https://sapui5.hana.ondemand....), :1:31)at fnClass. (https://sapui5.hana.ondemand....)at HTMLIFrameElement.dispatch (https://sapui5.hana.ondemand....)at elemData.handle (https://sapui5.hana.ondemand....)

解决这个跨域访问错误有很多种思路。

一种最直接的思路,就是将 SAP UI5 和文件服务器,部署在同一台主机的同一台端口号上,如下图所示,这样 SAP UI5 App 和文件服务器之间的交互,属于同源资源的互相访问,可以不加任何特殊处理地正常进行。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

另一种引入代理服务器,或者说负载均衡服务器的方法是,在仍然保留 SAP UI5 应用运行的 localhost:8080 本地服务器和文件服务器 localhost:3003 不变的前提下,将新引入的代理服务器 localhost:8085,作为用户访问 SAP UI5 应用,进行文件上传的操作入口。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

这两种方法的具体介绍,参考笔者这篇文章

本教程我们已经花了三个步骤的篇幅,介绍了 SAP UI5 FileUploader 的使用方法,实现原理,以及引起跨域访问错误的根源。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

我们再次回顾一下这个跨域访问的错误根源:

(1) 我们开发的 SAP UI5 应用,向 XML 视图里,FileUploader 控件的 uploadUrl 硬编码的 localhost:3003 发起文件上传请求,如下图图例 1.

(2) 监听在 3003 端口上的文件服务器(下图右边),接收到这个上传请求,将响应返回给 SAP UI5 框架创建的隐藏 iframe 的 body 节点中去(细节在之前的步骤SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe里有介绍)。使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

(3) 因为这个隐藏的 iframe 接收的响应来自 localhost:3003, 因此无法通过来自 localhost:8080 的 SAP UI5 app 访问,会遇到错误消息:

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

Uncaught DOMException: Blocked a frame with origin “http://localhost:8080” from accessing a cross-origin frame.at eval (eval at (https://sapui5.hana.ondemand....), :1:31)at fnClass. (https://sapui5.hana.ondemand....)at HTMLIFrameElement.dispatch (https://sapui5.hana.ondemand....)at elemData.handle (https://sapui5.hana.ondemand....)

解决这个跨域访问错误有很多种思路。

一种最直接的思路,就是将 SAP UI5 和文件服务器,部署在同一台主机的同一台端口号上,如下图所示,这样 SAP UI5 App 和文件服务器之间的交互,属于同源资源的互相访问,可以不加任何特殊处理地正常进行。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

另一种引入代理服务器,或者说负载均衡服务器的方法是,在仍然保留 SAP UI5 应用运行的 localhost:8080 本地服务器和文件服务器 localhost:3003 不变的前提下,将新引入的代理服务器 localhost:8085,作为用户访问 SAP UI5 应用,进行文件上传的操作入口。

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误试

这两种方法的具体介绍,参考笔者这篇文章