org.springframework.web.multipart
接口MultipartFile
所有已知的实现类:
CommonsMultipartFile,MockMultipartFile
公共接口MultipartFile
在多部分请求中接收的上载文件的表示。
文件内容存储在内存中或临时存储在磁盘上。在任何一种情况下,如果需要,用户负责将文件内容复制到会话级或持久性存储。临时存储将在请求处理结束时清除。
以来:
2003年9月29日
作者:
Juergen Hoeller,Trevor D. Cook
也可以看看:
MultipartHttpServletRequest
, MultipartResolver
方法摘要 | |
---|---|
byte[] |
getBytes() 将文件的内容作为字节数组返回。 |
String |
getContentType() 返回文件的内容类型。 |
InputStream |
getInputStream() 返回一个InputStream以从中读取文件的内容。 |
String |
getName() 返回多部分表单中参数的名称。 |
String |
getOriginalFilename() 返回客户端文件系统中的原始文件名。 |
long |
getSize() 以字节为单位返回文件的大小。 |
boolean |
isEmpty() 返回上传的文件是否为空,即,在多部分表单中没有选择任何文件,或者所选文件没有内容。 |
void |
transferTo(File dest) 将收到的文件传输到给定的目标文件。 |
方法细节 |
---|
的getName
String getName()
返回多部分表单中参数的名称。
返回:
参数的名称(从不null
或为空)
getOriginalFilename
String getOriginalFilename()
返回客户端文件系统中的原始文件名。
这可能包含路径信息,具体取决于所使用的浏览器,但它通常不包含Opera以外的任何其他信息。
返回:
原始文件名,如果在多部分表单中未选择任何文件,则为空字符串
的getContentType
String getContentType()
返回文件的内容类型。
返回:
内容类型,或者null
如果未定义(或者在多部分表单中未选择任何文件)
是空的
boolean isEmpty()
返回上传的文件是否为空,即,在多部分表单中没有选择任何文件,或者所选文件没有内容。
的getSize
long getSize()
以字节为单位返回文件的大小。
返回:
文件的大小,如果为空则为0
的getBytes
byte [] getBytes()
抛出IOException
将文件的内容作为字节数组返回。
返回:
文件的内容为字节,如果为空则为空字节数组
抛出:
IOException
- 如果访问错误(如果临时存储失败)
的getInputStream
InputStream getInputStream()
抛出IOException
返回一个InputStream以从中读取文件的内容。用户负责关闭流。
返回:
文件的内容为流,如果为空,则为空流
抛出:
IOException
- 如果访问错误(如果临时存储失败)
转移至
void transferTo(File dest)
抛出IOException,
IllegalStateException
将收到的文件传输到给定的目标文件。
这可以在文件系统中移动文件,在文件系统中复制文件,或者将存储器保存的内容保存到目标文件。如果目标文件已存在,则将首先删除它。
如果文件已在文件系统中移动,则无法再次调用此操作。因此,只需调用此方法一次即可使用任何存储机制。
参数:
dest
- 目标文件
抛出:
IOException
- 在阅读或写入错误的情况下
IllegalStateException
- 如果文件已经在文件系统中移动,并且不再可用于另一次传输