脚本开发 / 响应数据 `DFF.RESP`

函数的返回值，除了以往直接返回字符串、JSON 外，可使用 DFF.RESP(...) 进行细节控制。

参数	类型	必须 / 默认值	说明
`data`	str/dict/list	必须	指定返回的数据
`status_code`	int	`200`	指定响应状态码
`content_type`	str	`None`	指定响应体类型，如 `json`, `text`, `html` 等
`headers`	dict	`None`	指定 HTTP 响应头（此处不需要重复填写 `Content-Type`）
`allow_304`	bool	`False`	指定为 `True` 时，允许浏览器 304 缓存
`download`	str	`False`	指定下载文件名，并将数据作为文件下载指定本参数后，`content_type` 参数不再起效

如果开启 allow_304，允许浏览器 304 缓存，可以实现接口性能提升。但也可能会因为缓存导致客户端无法及时从接口获取最新内容

指定 download 参数后，系统会自动根据文件扩展名填充 Content-Type，而 content_type 参数会被忽略

常见用例如下：

Python
@DFF.API('用例 1')
def case_1():
    '''
    返回一个由函数内生成的 HTML 页面
    '''
    data = '''<h1>Hello, World!</h1>'''
    return DFF.RESP(data, content_type='html')

@DFF.API('用例 2')
def case_2():
    '''
    返回由函数生成的 JSON 数据
    与 return {"hello": "world"} 等价
    '''
    data = '''{"hello": "world"}'''
    return DFF.RESP(data, content_type='json')

@DFF.API('用例 3')
def case_3():
    '''
    下载由函数生成的文件，并命名为`文章.txt`
    '''
    data = '''Some text'''
    return DFF.RESP(data, download='文章.txt')

@DFF.API('用例 4')
def case_4():
    '''
    指定额外的响应头
    '''
    data = '''<h1>Hello, World!</h1>'''
    headers = {
        'X-Author': 'Tom',
    }
    return DFF.RESP(data, content_type='html', headers=headers)

@DFF.API('用例 5')
def case_5():
    '''
    指定相应代码
    '''
    data = '''<h1>No such data</h1>'''
    return DFF.RESP(data, content_type='html', status_code=404)

脚本开发 / 响应数据 DFF.RESP

脚本开发 / 响应数据 `DFF.RESP`