cn.hutool.http

Class HttpDownloader

java.lang.Object

cn.hutool.http.HttpDownloader

public class HttpDownloader
extends Object

下载封装，下载统一使用GET请求，默认支持30x跳转

Since:

5.6.4

Author:

looly

Constructor Summary

Constructors

Constructor and Description
HttpDownloader()

Method Summary

Modifier and Type	Method and Description
static long	download(String url, OutputStream out, boolean isCloseOut, StreamProgress streamProgress) 下载远程文件
static byte[]	downloadBytes(String url) 下载远程文件数据，支持30x跳转
static byte[]	downloadBytes(String url, int timeout) 下载远程文件数据，支持30x跳转
static long	downloadFile(String url, File targetFileOrDir, int timeout, StreamProgress streamProgress) 下载远程文件
static long	downloadFile(String url, File targetFileOrDir, String tempFileSuffix, int timeout, StreamProgress streamProgress) 下载文件-避免未完成的文件 来自：https://gitee.com/chinabugotech/hutool/pulls/407 此方法原理是先在目标文件同级目录下创建临时文件，下载之，等下载完毕后重命名，避免因下载错误导致的文件不完整。
static File	downloadForFile(String url, File targetFileOrDir, int timeout, StreamProgress streamProgress) 下载远程文件，返回文件
static String	downloadString(String url, Charset customCharset, StreamProgress streamPress) 下载远程文本

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpDownloader

public HttpDownloader()

Method Detail

downloadString

public static String downloadString(String url,
                                    Charset customCharset,
                                    StreamProgress streamPress)

下载远程文本

Parameters:

url - 请求的url

customCharset - 自定义的字符集，可以使用CharsetUtil#charset 方法转换

streamPress - 进度条 StreamProgress

Returns:

文本

downloadBytes

public static byte[] downloadBytes(String url)

下载远程文件数据，支持30x跳转

Parameters:

url - 请求的url

Returns:

文件数据

downloadBytes

public static byte[] downloadBytes(String url,
                                   int timeout)

下载远程文件数据，支持30x跳转

Parameters:

url - 请求的url

timeout - 超时毫秒数

Returns:

文件数据

Since:

5.8.28

downloadFile

public static long downloadFile(String url,
                                File targetFileOrDir,
                                int timeout,
                                StreamProgress streamProgress)

下载远程文件

Parameters:

url - 请求的url

targetFileOrDir - 目标文件或目录，当为目录时，取URL中的文件名，取不到使用编码后的URL做为文件名

timeout - 超时，单位毫秒，-1表示默认超时

streamProgress - 进度条

Returns:

文件大小

downloadFile

public static long downloadFile(String url,
                                File targetFileOrDir,
                                String tempFileSuffix,
                                int timeout,
                                StreamProgress streamProgress)

下载文件-避免未完成的文件
来自：https://gitee.com/chinabugotech/hutool/pulls/407
此方法原理是先在目标文件同级目录下创建临时文件，下载之，等下载完毕后重命名，避免因下载错误导致的文件不完整。

Parameters:

url - 请求的url

targetFileOrDir - 目标文件或目录，当为目录时，取URL中的文件名，取不到使用编码后的URL做为文件名

tempFileSuffix - 临时文件后缀，默认".temp"

timeout - 超时，单位毫秒，-1表示默认超时

streamProgress - 进度条

Returns:

下载大小

Since:

5.7.12

downloadForFile

public static File downloadForFile(String url,
                                   File targetFileOrDir,
                                   int timeout,
                                   StreamProgress streamProgress)

下载远程文件，返回文件

Parameters:

url - 请求的url

targetFileOrDir - 目标文件或目录，当为目录时，取URL中的文件名，取不到使用编码后的URL做为文件名

timeout - 超时，单位毫秒，-1表示默认超时

streamProgress - 进度条

Returns:

文件

download

public static long download(String url,
                            OutputStream out,
                            boolean isCloseOut,
                            StreamProgress streamProgress)

下载远程文件

Parameters:

url - 请求的url

out - 将下载内容写到输出流中 OutputStream

isCloseOut - 是否关闭输出流

streamProgress - 进度条

Returns:

文件大小