Java Hutool工具包中HttpUtil的日志统一打印及统一超时时间配置
作者:ayuyihu
为何要打印Http请求日志
使用hutool工具包中的HttpUtil,为了便于排查问题以及控制请求时间,每次都要在请求前后log日志,每次都需要设置超时时间,十分麻烦。
log.info("请求路径:{},请求体:{}", url, body); HttpResponse response = HttpUtil.createPost(url).body(body).timeout(3000).execute(); log.info("请求结果:{}", response);
HttpUtil的请求拦截器(HttpInterceptor.Chain)、响应拦截器(HttpInterceptor.Chain)
从HttpUtil的execute()方法点进去几步,可以看到以下代码
/** * 请求前的拦截器,用于在请求前重新编辑请求 */ final HttpInterceptor.Chain<HttpRequest> requestInterceptors = GlobalInterceptor.INSTANCE.getCopiedRequestInterceptor(); /** * 响应后的拦截器,用于在响应后处理逻辑 */ final HttpInterceptor.Chain<HttpResponse> responseInterceptors = GlobalInterceptor.INSTANCE.getCopiedResponseInterceptor(); /** * 执行Reuqest请求 * * @param isAsync 是否异步 * @return this */ public HttpResponse execute(boolean isAsync) { return doExecute(isAsync, config.requestInterceptors, config.responseInterceptors); }
这里有两个拦截器配置,分别是请求拦截器配置config.requestInterceptors, 响应拦截器配置config.responseInterceptors
继续点进去可以看到拦截器的执行逻辑,分别在请求前和请求后执行,代码进行省略,只保留我们需要的逻辑
/** * 执行Reuqest请求 * * @param isAsync 是否异步 * @param requestInterceptors 请求拦截器列表 * @param responseInterceptors 响应拦截器列表 * @return this */ private HttpResponse doExecute(boolean isAsync, HttpInterceptor.Chain<HttpRequest> requestInterceptors, HttpInterceptor.Chain<HttpResponse> responseInterceptors) { if (null != requestInterceptors) { for (HttpInterceptor<HttpRequest> interceptor : requestInterceptors) { interceptor.process(this); } } // 初始化URL urlWithParamIfGet(); // 初始化 connection initConnection(); // 发送请求 send(); // 手动实现重定向 HttpResponse httpResponse = sendRedirectIfPossible(isAsync); // 获取响应 if (null == httpResponse) { httpResponse = new HttpResponse(this.httpConnection, this.config, this.charset, isAsync, isIgnoreResponseBody()); } // 拦截响应 if (null != responseInterceptors) { for (HttpInterceptor<HttpResponse> interceptor : responseInterceptors) { interceptor.process(httpResponse); } } return httpResponse; }
HttpUtil的全局日志配置
明白了HttpUtil的execute()方法执行过程,现在我们可以很方便的实现HttpUtil的全局日志了
项目启动时进行添加我们自定义的拦截器即可,这里直接使用toString方法,是因为HttpUtil里面帮我们重写了toString的逻辑,不需要我们自己去解析HttpRequest和HttpResponse了
@Autowired public void addRequestInterceptor() { GlobalInterceptor.INSTANCE.addRequestInterceptor(httpObj -> log.info(String.valueOf(httpObj))); GlobalInterceptor.INSTANCE.addResponseInterceptor(httpObj -> log.info(String.valueOf(httpObj))); }
HttpUtil的超时时间源码分析
同样的,我们点进timeout()方法可以发现,会分别设置连接超时、读取响应超时。
/** * 默认连接超时 */ int connectionTimeout = HttpGlobalConfig.getTimeout(); /** * 默认读取超时 */ int readTimeout = HttpGlobalConfig.getTimeout(); /** * 设置超时,单位:毫秒<br> * 超时包括: * * <pre> * 1. 连接超时 * 2. 读取响应超时 * </pre> * * @param milliseconds 超时毫秒数 * @return this * @see #setConnectionTimeout(int) * @see #setReadTimeout(int) */ public HttpConfig timeout(int milliseconds) { setConnectionTimeout(milliseconds); setReadTimeout(milliseconds); return this; } /** * 设置连接超时,单位:毫秒 * * @param milliseconds 超时毫秒数 * @return this */ public HttpConfig setConnectionTimeout(int milliseconds) { this.connectionTimeout = milliseconds; return this; } /** * 设置连接超时,单位:毫秒 * * @param milliseconds 超时毫秒数 * @return this */ public HttpConfig setReadTimeout(int milliseconds) { this.readTimeout = milliseconds; return this; }
但是这两个超时字段配置是由默认的全局配置的。
所以配置一个全局的超时时间就比较方便了
HttpUtil的全局超时时间配置
@Autowired public void hutoolHttpUtilConfig() { // 设置hutool HttpUtil的request请求参数打印 GlobalInterceptor.INSTANCE.addRequestInterceptor(httpObj -> log.info(String.valueOf(httpObj))); // 设置hutool HttpUtil的response参数打印 GlobalInterceptor.INSTANCE.addResponseInterceptor(httpObj -> log.info(String.valueOf(httpObj))); // 设置hutool HttpUtil的连接超时时间、读取响应超时时间 HttpGlobalConfig.setTimeout(3000); }
附:hutool-http使用注意
Hutool谐音“糊涂”,一方面简洁易懂,一方面寓意“难得糊涂”,但是糊涂中可能就会掉入坑中。查看HttpUtil源码,再调用HttpUtil中的post或者get方法后,会创建HttpRequest对象调用execute()方法,建立连接发送请求。
但是初始化连接的时候会直接创建一个新的连接,如果要循环调用大量接口,这个是很不合适的。
总结
到此这篇关于Java Hutool工具包中HttpUtil的日志统一打印及统一超时时间配置的文章就介绍到这了,更多相关HttpUtil日志统一打印内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!