java如何实现文件304请求

Java实现文件304请求的方法包括：使用HTTP响应头、检查文件的修改时间、设置缓存策略。 其中最关键的一点是设置HTTP响应头中的Last-Modified和If-Modified-Since，以便让浏览器或客户端可以通过比较文件的修改时间来判断是否需要重新下载文件。

304状态码表示资源未修改，客户端可以继续使用缓存的版本。通过在HTTP响应中添加合适的头信息，服务器可以告知客户端资源是否被修改，从而避免不必要的网络传输，提升性能。

一、HTTP响应头

HTTP协议支持一些头部字段用于缓存控制和条件请求。这些头部字段包括Last-Modified、If-Modified-Since、ETag和If-None-Match。其中，Last-Modified和If-Modified-Since是最常用的一对。

1.1 `Last-Modified`头

Last-Modified头部字段包含资源的最后修改时间。服务器在响应中包含这个头部字段，告诉客户端资源的最后修改时间。

response.setHeader("Last-Modified", formatDate(new Date(file.lastModified())));

1.2 `If-Modified-Since`头

客户端在后续请求中可以包含If-Modified-Since头部字段，告诉服务器它上次获取资源的时间。服务器可以通过比较资源的最后修改时间与If-Modified-Since值来决定是否返回304状态码。

String ifModifiedSince = request.getHeader("If-Modified-Since");
if (ifModifiedSince != null && !ifModifiedSince.isEmpty()) {
    Date ifModifiedSinceDate = parseDate(ifModifiedSince);
    if (file.lastModified() <= ifModifiedSinceDate.getTime()) {
        response.setStatus(HttpServletResponse.SC_NOT_MODIFIED);
        return;
    }
}

二、检查文件的修改时间

为了实现304请求，服务器需要检查文件的最后修改时间。Java中的File类提供了获取文件最后修改时间的方法。

File file = new File(filePath);
long lastModified = file.lastModified();

2.1 文件存在与否检查

在处理文件请求时，首先需要检查文件是否存在。如果文件不存在，应该返回404状态码。

if (!file.exists()) {
    response.setStatus(HttpServletResponse.SC_NOT_FOUND);
    return;
}

2.2 文件修改时间格式化

为了在HTTP头部中传递文件的修改时间，需要将时间格式化为HTTP日期格式。

private String formatDate(Date date) {
    SimpleDateFormat sdf = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss z", Locale.US);
    sdf.setTimeZone(TimeZone.getTimeZone("GMT"));
    return sdf.format(date);
}

三、设置缓存策略

除了使用Last-Modified和If-Modified-Since，还可以使用其他HTTP头部字段来控制缓存策略，如Cache-Control和Expires。

3.1 `Cache-Control`头

Cache-Control头部字段用于指定缓存指令。例如，可以使用max-age指令来指定资源的最大缓存时间。

response.setHeader("Cache-Control", "max-age=3600");

3.2 `Expires`头

Expires头部字段指定资源的过期时间。客户端在资源过期之前可以使用缓存版本。

response.setHeader("Expires", formatDate(new Date(System.currentTimeMillis() + 3600 * 1000)));

四、完整示例代码

以下是一个完整的示例代码，展示了如何在Java中实现文件304请求。

import java.io.File;
import java.io.IOException;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
import java.util.TimeZone;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class FileServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        String filePath = getServletContext().getRealPath(request.getPathInfo());
        File file = new File(filePath);
        if (!file.exists()) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }
        long lastModified = file.lastModified();
        String ifModifiedSince = request.getHeader("If-Modified-Since");
        if (ifModifiedSince != null && !ifModifiedSince.isEmpty()) {
            Date ifModifiedSinceDate = parseDate(ifModifiedSince);
            if (ifModifiedSinceDate != null && lastModified <= ifModifiedSinceDate.getTime()) {
                response.setStatus(HttpServletResponse.SC_NOT_MODIFIED);
                return;
            }
        }
        response.setHeader("Last-Modified", formatDate(new Date(lastModified)));
        response.setHeader("Cache-Control", "max-age=3600");
        response.setHeader("Expires", formatDate(new Date(System.currentTimeMillis() + 3600 * 1000)));
        // 其他代码，如写入文件内容到响应
    }
    private String formatDate(Date date) {
        SimpleDateFormat sdf = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss z", Locale.US);
        sdf.setTimeZone(TimeZone.getTimeZone("GMT"));
        return sdf.format(date);
    }
    private Date parseDate(String dateString) {
        SimpleDateFormat sdf = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss z", Locale.US);
        sdf.setTimeZone(TimeZone.getTimeZone("GMT"));
        try {
            return sdf.parse(dateString);
        } catch (ParseException e) {
            return null;
        }
    }
}

五、总结

通过设置HTTP响应头、检查文件的修改时间、设置缓存策略，可以有效实现Java中的文件304请求。 这种方法可以显著提高网络传输效率，降低服务器负载，并提供更好的用户体验。掌握这些技术对于开发高性能的Web应用至关重要。