1、需求说明
在SAP中调用第三方文件服务器的HTTP请求,将文件保存在文件服务器上,并返回保存的文件地址。SAP保存返回的文件地址,通过浏览器进行访问。
2、需求实现
2.1、POSTMAN测试
通过POSTMAN测试成功,获取返回的文件地址
并且可以看到请求对应编程语言的示例代码
2.2、代码示例
通过文件服务器URL创建http_client,设置类型为multipart/form-data,并传输请求参数
"-----------------------------@斌将军-----------------------------TYPES: BEGIN OF ty_itab, raw(255) TYPE x, END OF ty_itab. DATA:lt_bin TYPE STANDARD TABLE OF ty_itab, ls_bin LIKE LINE OF lt_bin. DATA: lv_len TYPE i, "发送报文长度 lv_url TYPE string, "接口地址 lo_http_client TYPE REF TO if_http_client, "http客户端 lo_part TYPE REF TO if_http_entity, lv_value TYPE string, lv_name TYPE string, lv_file TYPE string, lv_rec_json TYPE string, "接收的JSON lv_code TYPE i, "HTTP 返回状态 lv_reason TYPE string. " HTTP 状态描述 DATA:lv_filelength TYPE i, lv_xstring TYPE xstring. DATA:lv_account TYPE string, lv_pass TYPE string. 。。。。。。 "创建http客户端 CALL METHOD cl_http_client=>create_by_url EXPORTING url = lv_url IMPORTING client = lo_http_client EXCEPTIONS argument_not_found = 1 plugin_not_active = 2 internal_error = 3 pse_not_found = 4 pse_not_distrib = 5 pse_errors = 6 oa2c_set_token_error = 7 oa2c_missing_authorization = 8 oa2c_invalid_config = 9 oa2c_invalid_parameters = 10 oa2c_invalid_scope = 11 oa2c_invalid_grant = 12 OTHERS = 13. IF sy-subrc <> 0. e_return-type = 'E'. e_return-message = '无法创建http client'. RAISE error. ENDIF. "设置http method 为POST CALL METHOD lo_http_client->request->set_header_field EXPORTING name = '~request_method' value = 'POST'. "SET protocol version CALL METHOD lo_http_client->request->set_version( if_http_request=>co_protocol_version_1_1 ). "content type CALL METHOD lo_http_client->request->set_content_type EXPORTING content_type = 'multipart/form-data'. "用户名 CALL METHOD lo_http_client->request->set_form_field EXPORTING name = 'accessKey' value = lv_account. "文件夹名称 CALL METHOD lo_http_client->request->set_form_field EXPORTING name = 'bucketName' value = 'sap'. "密码 CALL METHOD lo_http_client->request->set_form_field EXPORTING name = 'secretKey' value = lv_pass. ""-----------------------------@斌将军-----------------------------
浏览器对应的编码和语言设置,可以参考浏览器中测试时,真实发送的请求参数
"-----------------------------@斌将军-----------------------------"浏览器支持的 MIME 类型 CALL METHOD lo_http_client->request->set_header_field EXPORTING name = 'Accept' value = '*/*'. "浏览器支持的压缩编码 CALL METHOD lo_http_client->request->set_header_field EXPORTING name = 'Accept-Encoding' value = 'gzip, deflate'. "浏览器支持的语言 CALL METHOD lo_http_client->request->set_header_field EXPORTING name = 'Accept-Language' value = 'zh-CN,zh;q=0.9,de;q=0.8,en;q=0.7'."-----------------------------@斌将军-----------------------------
添加上传的文件,其中文件名需要进行URL编码,可避免文件的中文乱码
其中name="file" 对应POSTMAN请求参数中的file
"-----------------------------@斌将军-----------------------------CALL METHOD lo_http_client->request->if_http_entity~set_formfield_encoding EXPORTING formfield_encoding = cl_http_request=>if_http_entity~co_encoding_raw. lo_part = lo_http_client->request->if_http_entity~add_multipart( ). "拼接上传的文件名,并将文件名转码 lv_name = i_filename. lv_name = cl_http_utility=>escape_url( lv_name ). lv_value = 'form-data; name="file"; filename="' && lv_name && '";'. CALL METHOD lo_part->set_header_field EXPORTING name = 'content-disposition' * value = 'form-data; name="file"; filename="11.txt";'. value = lv_value. CALL METHOD lo_part->set_content_type EXPORTING content_type = 'application/x-www-form-urlencoded'."-----------------------------@斌将军-----------------------------
上传本地文件为二进制,并转为xstring格式
"-----------------------------@斌将军-----------------------------CALL FUNCTION 'GUI_UPLOAD' EXPORTING filename = lv_file filetype = 'BIN' IMPORTING filelength = lv_filelength TABLES data_tab = lt_bin EXCEPTIONS file_open_error = 1 file_read_error = 2 no_batch = 3 gui_refuse_filetransfer = 4 invalid_type = 5 no_authority = 6 unknown_error = 7 bad_data_format = 8 header_not_allowed = 9 separator_not_allowed = 10 header_too_long = 11 unknown_dp_error = 12 access_denied = 13 dp_out_of_memory = 14 disk_full = 15 dp_timeout = 16 OTHERS = 17. IF sy-subrc <> 0. e_return-type = 'E'. e_return-message = '读取文件失败'. RAISE error. ENDIF. CALL FUNCTION 'SCMS_BINARY_TO_XSTRING' EXPORTING input_length = lv_filelength IMPORTING buffer = lv_xstring TABLES binary_tab = lt_bin EXCEPTIONS failed = 1 OTHERS = 2."-----------------------------@斌将军-----------------------------
将文件流放入client中并发送,接收返回结果
"-----------------------------@斌将军-----------------------------lv_len = xstrlen( lv_xstring ). CALL METHOD lo_part->set_data EXPORTING data = lv_xstring offset = 0 length = lv_len. "发送 CALL METHOD lo_http_client->send EXCEPTIONS http_communication_failure = 1 http_invalid_state = 2 http_processing_failed = 3 OTHERS = 4. IF sy-subrc <> 0. CALL METHOD lo_http_client->get_last_error IMPORTING message = DATA(lv_error_message). CALL METHOD lo_http_client->close. e_return-type = 'E'. e_return-message = '通信失败'. RAISE error. ENDIF. "接收 CALL METHOD lo_http_client->receive EXCEPTIONS http_communication_failure = 1 http_invalid_state = 2 http_processing_failed = 3 OTHERS = 9. IF sy-subrc <> 0. CALL METHOD lo_http_client->get_last_error IMPORTING message = lv_error_message. CALL METHOD lo_http_client->close. e_return-type = 'E'. e_return-message = '接收失败'. RAISE error. ENDIF. "提取返回字符串 CLEAR:lv_code,lv_reason. CALL METHOD lo_http_client->response->get_status IMPORTING code = lv_code reason = lv_reason. "获取返回的JSON CLEAR:lv_rec_json. lv_rec_json = lo_http_client->response->get_cdata( ). "关闭接口 CALL METHOD lo_http_client->close."-----------------------------@斌将军-----------------------------
3、补充说明
3.1、文件类型
在设置上传文件的类型时需要注意
文件有对应的类型参数,例如:
TXT:text/plain
Excel:application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Word:application/vnd.openxmlformats-officedocument.wordprocessingml.document
PDF:application/pdf
PNG:image/png
应用程序:application/octet-stream
测试得出以下结论:(可能有出入,仅供参考)
1、如果上传文件时,设置了对应的参数,
1.1、且浏览器支持预览,则访问文件地址时,直接能在浏览器中显示文件的内容,比如:TXT、PDF、PNG等
1.2、如果浏览器不支持预览,则访问文件地址时,浏览器会自动下载对应的文件到本地,比如Excel、Word、应用程序等
2、如果上传文件时,没有设置对应的参数,比如直接设置application/x-www-form-urlencoded、application/octet-stream,就算是TXT文件,浏览器也不会支持预览,直接下载
3、如果上传文件时,没有设置正确的参数,比如Excel文件,设置了text/plain参数,则会导致文件识别失败,浏览器既不下载也不能正确预览
3.2、参数细节
关于参数中的q=0.8
q:相对品质因数。它指定用户喜欢哪种语言,范围从0到1,默认为1。
该质量值表示用户对由该范围指定的语言的偏好的估计
- 中文(简体)
- 中文(繁体)
- 丹麦语
- 乌克兰语
- 乌尔都语
- 亚美尼亚语
- 俄语
- 保加利亚语
- 克罗地亚语
- 冰岛语
- 加泰罗尼亚语
- 匈牙利语
- 卡纳达语
- 印地语
- 印尼语
- 古吉拉特语
- 哈萨克语
- 土耳其语
- 威尔士语
- 孟加拉语
- 尼泊尔语
- 布尔语(南非荷兰语)
- 希伯来语
- 希腊语
- 库尔德语
- 德语
- 意大利语
- 拉脱维亚语
- 挪威语
- 捷克语
- 斯洛伐克语
- 斯洛文尼亚语
- 旁遮普语
- 日语
- 普什图语
- 毛利语
- 法语
- 波兰语
- 波斯语
- 泰卢固语
- 泰米尔语
- 泰语
- 海地克里奥尔语
- 爱沙尼亚语
- 瑞典语
- 立陶宛语
- 缅甸语
- 罗马尼亚语
- 老挝语
- 芬兰语
- 英语
- 荷兰语
- 萨摩亚语
- 葡萄牙语
- 西班牙语
- 越南语
- 阿塞拜疆语
- 阿姆哈拉语
- 阿尔巴尼亚语
- 阿拉伯语
- 韩语
- 马尔加什语
- 马拉地语
- 马拉雅拉姆语
- 马来语
- 马耳他语
- 高棉语
标签:
留言评论