HttpURLConnection与HttpClient示例：调用OCR API详解

本教程旨在提供一个详细的Http接口调用示例，通过使用Java的内置HttpURLConnection和开源的HttpClient库。首先，我们将从JDK自带的HttpURLConnection库开始讲解，因为它在没有HttpClient时也能派上用场。 HttpURLConnection是Java标准库中的一个类，它位于java.net包下，用于与HTTP服务器进行通信。在实际应用中，我们可以通过创建URL对象，然后调用其openConnection()方法来建立连接。在给出的示例代码中： ```java import sun.misc.BASE64Encoder; import java.io.*; import java.net.HttpURLConnection; import java.net.URL; import java.net.URLConnection; public class Main { public static void main(String[] args) throws Exception { String apiUrl = "https://ocr-api.ccint.com/ocr_service?app_key=%s"; String appKey = "xxxxxx"; // 请替换为您的app_key String appSecret = "xxxxxx"; // 请替换为您的app_secret String url = String.format(apiUrl, appKey); // 将图片转换为Base64编码，这是常见的HTTP请求体数据格式 String imgData = imageToBase64("example.jpg"); String param = "{\"app_secret\":\"%s\",\"image_data\":\"%s\"}"; param = String.format(param, appSecret, imgData); URL realUrl = new URL(url); HttpURLConnection conn = (HttpURLConnection) realUrl.openConnection(); // 设置HTTP请求头，包括接受内容类型、保持连接和用户代理信息 conn.setRequestProperty("accept", "*/*"); conn.setRequestProperty("connection", "Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla..."); // 发送POST请求，如果需要上传文件或参数，需设置连接方式为POST，并添加请求方法 conn.setRequestMethod("POST"); conn.setDoOutput(true); // 表示发送数据 conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8"); // 指定请求体的MIME类型 // 创建输出流写入数据 OutputStreamWriter out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8"); out.write(param); out.flush(); out.close(); // 读取响应，通常使用BufferedReader处理输入流 BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream())); StringBuilder responseBuilder = new StringBuilder(); String line; while ((line = in.readLine()) != null) { responseBuilder.append(line); } in.close(); String result = responseBuilder.toString(); // 这里result变量将存储服务器返回的HTTP响应 System.out.println(result); } // 辅助方法，将图片转换为Base64编码 private static String imageToBase64(String imageName) { // ...这里实现图片文件到Base64字符串的转换逻辑 } } ``` 在这个示例中，我们首先构造了一个包含app_key和请求参数的URL，然后创建HttpURLConnection对象并设置了必要的请求头。接着，我们发送POST请求，将参数以JSON格式写入到请求体中。最后，我们读取服务器的响应并将其存储在result变量中。 需要注意的是，实际操作中可能还需要处理异常，并且对于敏感信息如app_key和app_secret，应当在传输前进行安全处理。此外，这个示例仅展示了基础的HTTP接口调用，实际应用中可能还需处理身份验证、错误处理、超时设置以及更复杂的请求处理。如果项目需求更高级的功能，如并发请求、断点续传等，可以考虑引入HttpClient库，它提供了更多的功能和灵活性。