org.dromara.hutool.http.meta

Class HttpHeaderUtil

java.lang.Object

org.dromara.hutool.http.meta.HttpHeaderUtil

public class HttpHeaderUtil
extends Object

HTTP头相关方法
相关规范见：https://www.rfc-editor.org/rfc/rfc5987

Since:

6.0.0

Author:

Looly

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HttpHeaderUtil.ExtendedValue 根据rfc5987的扩展值，格式为： 编码'语言'值

Constructor Summary

Constructors

Constructor and Description
HttpHeaderUtil()

Method Summary

Modifier and Type	Method and Description
static String	createAttachmentDisposition(String fileName, Charset charset) 生成Content-Disposition头，用于下载文件 格式为： attachment;filename="example.txt";filename*=UTF-8''example.txt
static String	getFileNameFromDisposition(Map<String,List<String>> headers, String paramName) 从Content-Disposition头中获取文件名。
static List<String>	headerList(Map<String,List<String>> headers, String name) 根据name获取对应的头信息列表

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpHeaderUtil

public HttpHeaderUtil()

Method Detail

headerList

public static List<String> headerList(Map<String,List<String>> headers,
                                      String name)

根据name获取对应的头信息列表

Parameters:

headers - 头列表

name - Header名

Returns:

Header值

createAttachmentDisposition

public static String createAttachmentDisposition(String fileName,
                                                 Charset charset)

生成Content-Disposition头，用于下载文件
格式为：

     attachment;filename="example.txt";filename*=UTF-8''example.txt
 

Parameters:

fileName - 文件名

charset - 编码

Returns:

Content-Disposition头

getFileNameFromDisposition

public static String getFileNameFromDisposition(Map<String,List<String>> headers,
                                                String paramName)

从Content-Disposition头中获取文件名。
参考标准：https://datatracker.ietf.org/doc/html/rfc6266#section-4.1
以参数名为`filename`为例，规则为：

• 首先按照RFC5987规范检查`filename*`参数对应的值，即：`filename*="example.txt"`，则获取`example.txt`
• 如果找不到`filename*`参数，则检查`filename`参数对应的值，即：`filename="example.txt"`，则获取`example.txt`

按照规范，`Content-Disposition`可能返回多个，此处遍历所有返回头，并且`filename*`始终优先获取，即使`filename`存在并更靠前。
参考：https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Content-Disposition

Parameters:

headers - 头列表

paramName - 文件参数名，如果为null则使用默认的`filename`

Returns:

文件名，empty表示无