CN111092916B - 文件上传的方法、装置、电子设备及介质 - Google Patents

Abstract

本发明提供一种文件上传的方法，用于将移动终端中的文件传输至服务端，方法包括：在移动终端中封装网络请求接口函数，该网络请求接口函数用于接收外界传递的创建网络请求所需的信息；调用该网络请求接口函数，将创建网络请求所需的信息传递至移动终端中的多部分请求函数；调用多部分请求函数，创建网络请求；根据网络请求在移动终端中创建文件上传任务，并发送给服务端；调用服务端中的任务启动函数，启动文件上传任务。通过封装网络请求接口，外界通过接口函数中输入不同值的参数实现不同网络请求的创建，使得更多的地方能够复用这个网络请求接口，同时，请求和任务的创建隔离，使得能够及时的取消文件上传任务，实现便捷的文件上传。

Description

文件上传的方法、装置、电子设备及介质

技术领域

本发明涉及互联网移动开发领域，尤其涉及一种文件上传的方法、装置、电子设备及介质。

背景技术

随着互联网移动端开发的快速发展，手机移动端已日渐普及。而手机移动端的发展项目中经常需要向服务端传递文件，常规的方法是使用第三方工具或者编写一段上传的代码来进行文件上传，这种文件上传的方法存在一些缺点：不能及时的取消文件上传的任务；上传的工具或代码没有进行高度的封装和抽象，往往是哪里需要进行文件上传就在该处编写一段代码，导致文件上传的逻辑非常分散，不利用代码的复用和方法的修改。因此，本发明提出一种优化的文件上传方法。

发明内容

(一)要解决的技术问题

针对目前存在的技术问题，本发明提出一种文件上传的方法，通过网络请求结构的封装，只需要传递参数就可以获得文件上传的结果，用于解决常规方法中逻辑非常分散、代码不能复用及方法不能修改等问题。

(二)技术方案

本发明提供一种文件上传的方法，包括：在移动终端中封装网络请求接口函数，该网络请求接口函数用于接收外界传递的创建网络请求所需的信息；调用该网络请求接口函数，将该创建网络请求所需的信息传递至该移动终端中的多部分请求函数；调用该多部分请求函数，创建网络请求；根据该网络请求在移动终端中创建文件上传任务，并发送给所述服务端；调用服务端中的任务启动函数，启动该文件上传任务。

可选地，调用多部分请求函数，创建网络请求，包括：向多部分请求函数传入错误指针，该错误指针用于接收创建网络请求的错误消息；在创建所述网络请求之后，根据该错误指针判断是否接收到错误消息，若否，则网络请求创建成功，若是，则网络请求创建失败。

可选地，创建网络请求所需的信息包括第一回调函数，该第一回调函数用于向移动终端返回网络请求是否创建成功的消息；在创建所述网络请求之后，调用第一回调函数向移动终端返回网络请求是否创建成功的消息。

可选地，服务端包括第二回调函数，在调用任务启动函数启动文件上传任务之后，调用第二回调函数向移动终端返回文件上传任务的结果；若该结果中不包括错误消息，则文件上传成功，若该结果中包括错误消息，则文件上传失败。

可选地，根据所述网络请求在所述移动终端中创建文件上传任务，包括：调用任务上传请求函数获取网络请求，并根据网络请求创建文件上传任务。

可选地，所述调用所述多部分请求函数，创建所述网络请求，包括：在移动终端中创建请求序列器；通过该请求序列器调用多部分请求函数创建网络请求。

可选地，在启动文件上传任务后，还包括：调用任务取消函数，取消文件上传任务。

本发明另一方面提供一种文件上传装置，用于将移动终端中的文件传输至服务端，其特征在于，所述装置包括：接口封装模块，用于在移动终端中创建网络请求接口函数，该网络请求接口函数用于接收外界传递的创建网络请求所需的信息；信息传递模块，用于调用网络请求接口函数，将创建网络请求所需的信息传递至移动终端中的多部分请求函数；网络请求创建模块，用于调用多部分请求函数，创建网络请求；任务创建模块，根据创建的网络请求在移动终端中创建文件上传任务；任务启动模块，调用服务端中的任务启动函数，启动文件上传任务。

本发明另一方面提供一种电子设备，包括：处理器；存储器，其存储有计算机可执行程序，该程序在被处理器执行时，使得处理器执行本发明中文件上传的方法。

本发明另一方面还提供一种计算机可读介质，其上存储有计算机程序，该程序被处理器执行时实现如本发明中文件上传的方法。

(三)有益效果

本发明提供一种文件上传的方法，通过对网络请求接口进行封装和抽象，提供一些简单的接口方便外界进行调用，无需关注接口调用的细节，实现文件上传方法在不同地方的复用，实现了便捷的文件上传，同时，首先创建网络请求，然后根据创建的网络请求创建文件上传的任务，实现了网络请求和文件上传任务的创建隔离，使得在文件上传的过程中，可以及时的取消文件上传任务。

附图说明

为了更完整地理解本发明及其优势，现在将参考结合附图的以下描述，其中：

图1示意性示出了根据本发明实施例的文件上传方法的流程图。

图2示意性示出了根据本发明实施例的文件上传装置的框图。

图3示意性示出了根据本发明实施例的电子设备的框图。

具体实施方式

以下，将参照附图来描述本发明的实施例。但是应该理解，这些描述只是示例性的，而并非要限制本发明的范围。在下面的详细描述中，为便于解释，阐述了许多具体的细节以提供对本发明实施例的全面理解。然而，明显地，一个或多个实施例在没有这些具体细节的情况下也可以被实施。此外，在以下说明中，省略了对公知结构和技术的描述，以避免不必要地混淆本发明的概念。

图1示意性示出了根据本发明实施例的文件上传方法，用于将客户端的文件传输至服务端。

如图1所示，方法包括：

S1，在移动终端中封装网络请求接口函数，该网络请求接口函数用于向客户端传递创建网络请求所需的信息。

为了解决常规方法逻辑分散、代码不能复用的问题，在上述操作S1中，封装一个网络请求接口函数，将创建网络请求所需的信息统一利用该网络请求接口函数来传递，当用户需要需要发起查询请求时，只需要输入对应的参数就可以实现。

具体地，在服务端中封装网络请求接口函数putData，为该函数设置一些参数，这些参数包含的内容对应的即为创建网络请求所需的信息，这些参数决定创建什么样的网络请求。参数一为url地址，其内容为文件上传到服务端的具体位置；参数二为请求参数，本实施例将改参数设置为字典；参数三为请求方法。网络请求接口函数还设置有第一回调函数，包括成功的回调函数(编写的成功的代码块)和失败的回调函数，当网络请求创建成功以后，成功的回调函数用于向服务端返回网络请求创建成功的消息，失败的回调函数用于向服务端返回网络请求创建失败的消息，即终止本次文件上传。

其中，关于请求方法，http协议中定义了八种请求方法来表明对Request-url来对指定资源的不同操作，该八种请求方法为返回服务器针对特定资源所支持的HTTP请求方法(OPTIONS)、向特定的资源发出请求(GET)、向指定资源提交数据进行处理请求(POST)、向指定资源位置上传其最新内容(PUT)、向服务器索要与GET请求相一致的响应(HEAD)、请求服务器删除Request-URI所标识的资源(DELETE)、回显服务器收到的请求(TRACE)及HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器(CONNECT)。虽然HTTP的请求方式有八种，但是我们在实际应用中常用的也就是get和post，其他请求方式也都可以通过这两种方式间接的来实现。

关于请求参数，其内容为网络请求附加的信息，一般附在url后面，如用户名、密码等，例如，在浏览器端通过http://localhost:8080/Example09/AServlet？name＝zhangsan访问AServlet，其中“？”后面的“name＝zhangsan”就是请求参数，又如在form表单中，如下所示：

当提交表单时，表单中的表单项：用户名、密码作为请求参数提交给AServlet。

本操作通过封装和抽象一个网络请求接口函数，通过改变该接口函数中参数的值就可以实现不同的网络请求的创建，使得更多的地方能够复用这个网络请求接口，避免了需要上传文件时就编写一端代码来实现的繁琐操作。该网络请求接口函数提供一些简单的接口方便外界进行调用，无需关注接口调用的细节。同时，操作S1中在移动端封装了一个网络请求接口函数，是一个对外暴露的部分，后续操作则是这个接口函数的内部实现，内部实现和接口高度分离，这是常规方法所不具备的，也正是这种分离，使得该接口函数能够在多个地方被复用，提高文件上传的便捷性。

S2，创建文件上传的网络请求。

在上述操作S2中，需要根据操作S1中网络接口请求函数传递的信息创建一个文件上传的网络请求。这个过程分为两步，首先，需要在移动端创建一个请求序列器requestSerializer，具体是通过获取创建序列器的管理类SerializerManager，通过该序列器的管理类SerializerManager调用创建序列器的方法serializer来创建，在创建序列器方法serializer内部需要进行初始化的方法，这些初始化的方法包括对序列器进行编码，设置支持中文的编码格式等，该请求序列器requestSerializer用于将接口函数传递的创建文件上传任务所需的信息传入多部分请求函数multipartRequest内部，所需的信息即为前述所提及的上传地址、请求参数及请求方法，然后，调用多部分请求函数multipartRequest根据上传地址、请求参数及请求方法创建一个具体的网络请求，一般，网络请求方法选择GET和PUT。

例如：

通过上面的例子亦可以看出，网络请求由请求方法，上传地址url和请求参数共同决定需要创建一个怎样的网络请求，即请求方法，上传地址url和请求参数不同创建的网络请求不同，请求方法，上传地址url和请求参数与网络请求是一个强关联的关系。

另外，还需要向多部分请求函数multipartRequest内部传入一个error指针，该error指针用于接收网络请求创建失败的错误消息，在网络请求创建创建完毕之后，需要判断该error指针是否接收到错误消息，若没有接收到，则表明网络请求创建成功，此时调用成功的回调函数移动终端返回创建成功的消息，若接收到，则表明网络请求创建失败，此时调用失败的回调函数向移动终端返回创建失败的消息，即终止本次文件上传任务。

本操作的主要目的是为了根据传递经移动终端的上传地址url、请求参数及请求方法等创建一个网络请求，为后续创建文件上传任务建立基础，实现了网络请求与文件上传任务的创建隔离，便于后续能够及时返回创建的任务。

S3，创建文件上传任务，并启动文件上传任务，向服务端上传文件。

在操作S2中的网络请求创建成功后，调用移动终端中的任务上传请求函数uploadTaskRequest获取创建的网络请求，并根据该网络请求创建文件上传任务，将创建的文件上传任务发送给服务端，调用服务端中的任务启动函数resume，启动该文件上传任务进行文件的上传，具体的实现方式为：

同时，服务端将该文件上传任务返回给移动终端，这样，当需要取消该任务时，在移动终端就可以调用任务取消函数及时的取消该文件上传任务，该任务取消函数可以是通过代码在移动终端实现的取消按钮，也可以是能够实现任务取消功能的具体函数等，例如，在将一个文件拷贝到一个文件夹中时，如果该文件夹中存在和该文件相同名称的文件，就会提示是否替换文件的两个按钮是和否，类似的，在移动终端中定义一个取消dataTask的cancel方法，即在移动终端界面会设置一个cancel按钮，在dataTask创建完成后，可以通过点击cancel按钮，调用cancel方法对任务及时进行取消。

在文件上传任务启动完毕之后，通过调用服务端中的第二回调函数向移动终端返回文件是否上传成功的结果，该第二回调函数可为completion函数，其包含参数response和error，若返回的结果中存在error(错误消息)，说明文件上传失败，若返回的结果中不存在error(错误消息)，说明文件上传成功，就将成功的response传递至移动终端。

本操作创建的任务与操作S2中创建的网络请求是隔离开来的，这样在启动文件上传任务时可以同步向移动终端返回文件上传任务，以便能够及时的曲线该任务，同时，对于文件上传之后是否成功的结果是异步的，需要任务执行完毕或者某种异常或者网络中断导致失败就会给予异常回调，方便得到最终文件上传的结果。

综上所述，本发明实施例通过在移动终端封装一个网络请求接口，提供一些简单的接口方便外界进行调用，外界通过调用该网络请求接口，向移动终端传递请求方法、请求参数、上传地址等，根据这些请求方法、请求参数及上传地址创建网络请求，并且，只需通过向接口函数中输入不同的参数值就可传递不同的请求方法、请求参数及上传地址，实现不同的网络请求的创建，使得更多的地方能够复用这个网络请求接口。同时，网络请求和文件上传任务的创建是隔离的，这样，可以实现任务的同步返回和文件上传结果的异步回调，移动终端能够及时的取消文件上传任务，这些都是常规方案所不具备的，通过本实施例的实施，能够实现便捷的文件上传。

图2示意性示出了根据本发明实施例的文件上传装置200的框图。

如图2所示，文件上传装置200包括接口封装模块210、信息传递模块220、请求创建模块230、任务创建模块240及任务启动模块250。

具体地，接口封装模块210，用于在移动终端中创建网络请求接口函数putData，该网络请求接口函数用于向接收外界传入的创建网络请求所需的信息。该网络请求接口函数包括：参数一为url地址，其内容为文件上传到服务端的具体位置；参数二为上传需要的参数，本实施例将改参数设置为字典；参数三为第一回调函数，包括成功的回调函数(编写的成功的代码块)和失败的回调函数，当网络请求创建成功以后，成功的回调函数用于向服务端返回网络请求创建成功的消息，失败的回调函数用于向服务端返回网络请求创建失败的消息，即终止本次文件上传。

信息传递模块220，用于调用所述网络请求接口函数，将所述创建网络请求所需的信息传递至所述客户端中的多部分请求函数multipartRequest内部，所需的信息包括上传的url，请求参数及请求方法等。

请求创建模块230，用于调用多部分请求函数multipartRequest，根据传递的所需信息创建网络请求。该网络请求与上传的url，请求参数及请求方法是强关联的关系，所谓强关联上传的url，请求参数及请求方法决定创建怎样的网络请求。

任务创建模块240，用于调用移动终端中的任务上传请求函数uploadTaskRequest获取创建的网络请求，根据该网络请求创建文件上传任务，并将创建的文件上传任务发送给服务端。

任务启动模块250，用于调用服务端中的任务启动函数resume，启动该文件上传任务进行文件上传。

应当理解，接口封装模块210、信息传递模块220、请求创建模块230、任务创建模块240及任务启动模块250可以合并在一个模块中实现，或者其中的任意一个模块可以被拆分成多个模块。或者，这些模块中的一个或多个模块的至少部分功能可以与其他模块的至少部分功能相结合，并在一个模块中实现。根据本发明的实施例，接口封装模块210、信息传递模块220、请求创建模块230、任务创建模块240及任务启动模块250中的至少一个可以至少被部分地实现为硬件电路，例如现场可编程门阵列(FPGA)、可编程逻辑阵列(PLA)、片上系统、基板上的系统、封装上的系统、专用集成电路(ASIC)，或可以以对电路进行集成或封装的任何其他的合理方式等硬件或固件来实现，或以软件、硬件以及固件三种实现方式的适当组合来实现。或者，接口封装模块210、信息传递模块220、请求创建模块230、任务创建模块240及任务启动模块250中的至少一个可以至少被部分地实现为计算机程序模块，当该程序被计算机运行时，可以执行相应模块的功能。

本发明提供一种电子设备，如图3所示，该电子设备300包括处理器310和存储器320。该电子设备300可以执行根据图1所示的本发明实施例的方法。

具体地，处理器310例如可以包括通用微处理器、指令集处理器和/或相关芯片组和/或专用微处理器(例如，专用集成电路(ASIC))，等等。处理器310还可以包括用于缓存用途的板载存储器。处理器310可以是用于执行根据本公开实施例的方法流程的不同动作的单一处理单元或者是多个处理单元。

存储器320，例如可以是能够包含、存储、传送、传播或传输指令的任意介质。例如，可读存储介质可以包括但不限于电、磁、光、电磁、红外或半导体系统、装置、器件或传播介质。可读存储介质的具体示例包括：磁存储装置，如磁带或硬盘(HDD)；光存储装置，如光盘(CD-ROM)；存储器，如随机存取存储器(RAM)或闪存；和/或有线/无线通信链路。

存储器320可以包括计算机程序321，该计算机程序321可以包括代码/计算机可执行指令，其在由处理器310执行时使得处理器310执行根据本公开实施例的方法或其任何变形。

计算机程序321可被配置为具有例如包括计算机程序模块的计算机程序代码。例如，在示例实施例中，计算机程序321中的代码可以包括至少一个程序模块，例如包括模块321A、模块321B、……。应当注意，模块的划分方式和个数并不是固定的，本领域技术人员可以根据实际情况使用合适的程序模块或程序模块组合，当这些程序模块组合被处理器310执行时，使得处理器310可以执行根据本公开实施例的方法或其任何变形。

本公开还提供了一种计算机可读介质，该计算机可读介质可以是上述实施例中描述的设备/装置/系统中所包含的；也可以是单独存在，而未装配入该设备/装置/系统中。上述计算机可读介质承载有一个或者多个程序，当上述一个或者多个程序被执行时，实现根据本公开实施例的方法。

根据本公开的实施例，计算机可读介质可以是计算机可读信号介质或者计算机可读存储介质或者是上述两者的任意组合。计算机可读存储介质例如可以是——但不限于——电、磁、光、电磁、红外线、或半导体的系统、装置或器件，或者任意以上的组合。计算机可读存储介质的更具体的例子可以包括但不限于：具有一个或多个导线的电连接、便携式计算机磁盘、硬盘、随机访问存储器(RAM)、只读存储器(ROM)、可擦式可编程只读存储器(EPROM或闪存)、光纤、便携式紧凑磁盘只读存储器(CD-ROM)、光存储器件、磁存储器件、或者上述的任意合适的组合。在本公开中，计算机可读存储介质可以是任何包含或存储程序的有形介质，该程序可以被指令执行系统、装置或者器件使用或者与其结合使用。而在本公开中，计算机可读的信号介质可以包括在基带中或者作为载波一部分传播的数据信号，其中承载了计算机可读的程序代码。这种传播的数据信号可以采用多种形式，包括但不限于电磁信号、光信号或上述的任意合适的组合。计算机可读的信号介质还可以是计算机可读存储介质以外的任何计算机可读介质，该计算机可读介质可以发送、传播或者传输用于由指令执行系统、装置或者器件使用或者与其结合使用的程序。计算机可读介质上包含的程序代码可以用任何适当的介质传输，包括但不限于：无线、有线、光缆、射频信号等等，或者上述的任意合适的组合。

尽管已经参照本公开的特定示例性实施例示出并描述了本公开，但在不背离所附权利要求及其等同物限定的本公开的精神和范围的情况下，可对本公开进行形式和细节上的多种改变。因此，本公开的范围不应该限于上述实施例，而是应该不仅由所附权利要求来进行确定，还由所附权利要求的等同物来进行限定。

Claims (10)

1.一种文件上传的方法，用于将移动终端中的文件传输至服务端，其特征在于，包括：

在所述移动终端中封装网络请求接口函数，所述网络请求接口函数用于接收创建网络请求所需的信息；

调用所述网络请求接口函数，将所述创建网络请求所需的信息传递至所述移动终端中的多部分请求函数；

调用所述多部分请求函数，创建网络请求；

根据所述网络请求在所述移动终端中创建文件上传任务，并发送给所述服务端；

调用所述服务端中的任务启动函数，启动所述文件上传任务。

2.根据权利要求1所述的文件上传的方法，其特征在于，调用所述多部分请求函数，创建网络请求，包括：

向所述多部分请求函数传入错误指针，所述错误指针用于接收创建所述网络请求的错误消息；

在创建所述网络请求之后，根据所述错误指针判断是否接收到错误消息，若否，则所述网络请求创建成功，若是，则所述网络请求创建失败。

3.根据权利要求1所述的文件上传的方法，其特征在于，所述创建网络请求所需的信息包括第一回调函数，所述第一回调函数用于向所述移动终端返回所述网络请求是否创建成功的消息；

在创建所述网络请求之后，调用所述第一回调函数向所述移动终端返回网络请求是否创建成功的消息。

4.根据权利要求1所述的文件上传的方法，其特征在于，所述服务端包括第二回调函数，在所述调用任务启动函数启动所述文件上传任务之后，调用所述第二回调函数向所述移动终端返回所述文件上传任务的结果；

若所述结果中不包括错误消息，则所述文件上传成功，若所述结果中包括错误消息，则所述文件上传失败。

5.根据权利要求1所述的文件上传的方法，其特征在于，所述调用所述多部分请求函数，创建所述网络请求，包括：

在所述移动终端中创建请求序列器；

通过所述请求序列器调用所述多部分请求函数创建所述网络请求。

6.根据权利要求1所述的文件上传的方法，其特征在于，所述根据所述网络请求在所述移动终端中创建文件上传任务，包括：

调用任务上传请求函数获取所述网络请求，并根据所述网络请求创建文件上传任务。

7.根据权利要求1所述的文件上传的方法，其特征在于，在启动所述文件上传任务之后，还包括：

调用任务取消函数，取消所述文件上传任务。

8.一种文件上传装置，用于将移动终端中的文件传输至服务端，其特征在于，所述装置包括：

接口封装模块，用于在所述移动终端中创建网络请求接口函数，所述网络请求接口函数用于接收外界传递的创建网络请求所需的信息；

信息传递模块，用于调用所述网络请求接口函数，将所述创建网络请求所需的信息传递至所述移动终端中的多部分请求函数；

网络请求创建模块，用于调用所述多部分请求函数，创建网络请求；

任务创建模块，根据所述网络请求在所述移动终端中创建文件上传任务；

任务启动模块，调用所述服务端中的任务启动函数，启动所述文件上传任务。

9.一种电子设备，包括：

处理器；

存储器，其存储有计算机可执行程序，该程序在被所述处理器执行时，使得所述处理器执行如权利要求1-7中任意一项所述的文件上传的方法。

10.一种计算机可读介质，其上存储有计算机程序，其特征在于，该程序被处理器执行时实现如权利要求1-7中任意一项所述的文件上传的方法。

Images