NativeScript Angular 下实现CALDAV REPORT HTTP请求的方案
需求
- 基于NativeScript(Angular)框架开发同时适配Android、iOS的跨端应用,按照RFC 4791规范发送CALDAV协议要求的REPORT方法HTTP请求。
- 当前开发环境版本:
tns 7.0.11、Node.js v15.1.0、npm 7.0.8
已尝试方案与问题表现
方案一:使用NativeScript封装的Angular HTTP模块发起请求
- 运行报错堆栈:
JS: "error": { JS: "originalStack": "Error: java.net.ProtocolException: Expected one of [OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, PATCH] but was REPORT at new ZoneAwareError (file:///data/data/org.nativescript.Ya2Do/files/app/vendor.js:141841:33) at onRequestComplete (file:///data/data/org.nativescript.Ya2Do/files/app/vendor.js:103522:34) at Object.onComplete (file: node_modules/@nativescript/core/http/http-request/index.android.js:38:0)" JS: }
- 问题原因:Android端默认
HttpURLConnection内置HTTP方法白名单,仅允许系统列表内的方法发起请求,传入REPORT时直接抛出协议异常,无法完成请求发起。
方案二:使用axios库发起请求
- 实现代码:
const axios = require('axios'); const options = { headers: { 'Content-Type': 'text/xml', 'Authorization': 'Basic xxxxxxxxxxxxxxxxxx==' }, method: 'REPORT', url: 'http://192.168.0.xxx:5232/xxxxxx/5673B18A-0B74-4725-9BE5-95F0A35E9244', timeout: 6000, data: '<?xml version="1.0" encoding="utf-8" ?> \ <C:calendar-query xmlns:C="urn:ietf:params:xml:ns:caldav"> \ <D:prop xmlns:D="DAV:"> \ <D:getetag/> \ <C:calendar-data/> \ </D:prop> \ <C:filter> \ <C:comp-filter name="VCALENDAR"> \ <C:comp-filter name="VTODO"> \ <C:prop-filter name="RELATED"> \ <C:is-not-defined/> \ </C:prop-filter> \ </C:comp-filter> \ </C:comp-filter> \ </C:filter> \ </C:calendar-query>' }; axios(options) .then((response) => { console.log("success"); console.log("status", response.status); console.log("data", response.data); }) .catch((error) => { console.log("error", error); }) .then(() => { console.log("finished?"); });
- 实际运行输出:
JS: Angular is running in development mode. Call enableProdMode() to enable production mode. JS: success JS: status JS: null JS: data JS: JS: finished?
- 问题原因:NativeScript环境下的axios底层依然调用平台原生HTTP客户端,未经过适配的REPORT方法会被平台层静默拦截,既不抛出异常也不携带正确的请求参数,因此回调返回空状态、空数据。即使通过反射设置了method,Android 10以上的HttpURLConnection会在请求实际发送前二次校验方法值,若未关闭校验开关,会静默将方法替换为系统白名单内的值,导致CALDAV服务器无法识别请求,返回空响应。
已验证的合法请求前提
- 当前环境下axios发起的普通GET请求可正常工作;相同的REPORT请求通过curl、HTTPie命令行工具可正常获取服务端响应。
- 该REPORT请求在Windows环境下基于Node.js + axios组合可正常运行。
- 该REPORT请求在Web端基于Angular原生HTTP模块可正常运行。
可行实现路径
- Android端适配HttpURLConnection白名单限制
- 通过反射机制修改HttpURLConnection实例的内部
method字段,跳过系统内置的方法白名单校验。 - 实现步骤:
- 在获取到URL连接实例后,定位类内部存储请求方法的
method私有字段 - 调用
setAccessible(true)开放字段访问权限 - 直接将字段值设置为
REPORT - Android 9及以上版本需额外通过反射关闭连接实例的
streaming校验开关,避免后续请求发起时再次触发方法校验、替换为系统白名单内的方法值
- 在获取到URL连接实例后,定位类内部存储请求方法的
- 通过反射机制修改HttpURLConnection实例的内部
- iOS端无需额外适配
- iOS端NSURLSession实现无内置HTTP方法白名单限制,直接传入REPORT作为自定义请求方法即可正常发起
- 跨端统一封装
- 在应用内封装独立的CALDAV请求服务,运行时判断平台:
- 运行在Android环境时,先执行上述反射修改逻辑,再携带原有请求头、请求体发起请求
- 运行在iOS环境时,直接传入REPORT方法发起请求
- 不要直接使用裸axios发起自定义方法请求,需替换其内置的NativeScript HTTP adapter为经过上述适配的自定义请求逻辑,避免被平台层静默拦截
- 在应用内封装独立的CALDAV请求服务,运行时判断平台:
- 低改动替代方案
- 将NativeScript底层HTTP实现替换为OkHttp客户端,OkHttp无内置HTTP方法白名单,可直接传入REPORT等自定义扩展方法,无需额外编写反射逻辑,适配成本更低。
内容的提问来源于stack exchange,提问作者Ulrich Pickartz
相关产品推荐
相关产品推荐

