在 Java Web 应用程序中从应用程序服务器外部提供静态数据的最简单方法

Question

我有一个在 Tomcat 上运行的 Java Web 应用程序。我想加载将在 Web UI 和应用程序生成的 PDF 文件中显示的静态图像。此外，新图像将通过 Web UI 上传来添加和保存。

通过将静态数据存储在 Web 容器中来做到这一点不是问题，但从 Web 容器外部存储和加载它们却让我头疼。

此时我不想使用像 Apache 这样的单独的 Web 服务器来提供静态数据。我也不喜欢将图像以二进制形式存储在数据库中的想法。

我见过一些建议，例如将图像目录作为指向 Web 容器外部目录的符号链接，但是这种方法在 Windows 和 *nix 环境中都适用吗？

有些人建议编写一个过滤器或 servlet 来处理图像服务，但这些建议非常模糊且高级，没有指向如何完成此操作的更详细信息。

Answer 1

我看到了一些建议，例如将图像目录作为指向 Web 容器外部目录的符号链接，但是这种方法在 Windows 和 *nix 环境中都适用吗？

文件系统路径规则（即您只使用正斜杠，如 /path/to/files 中），那么它也可以在 Windows 上工作，而无需摆弄丑陋的 File.separator< /code> 字符串连接。然而，它只会在调用该命令的同一工作磁盘上进行扫描。因此，如果 Tomcat 安装在 C: 上，那么 /path/to/files 实际上会指向 C:\path\to\files >。

如果这些文件都位于 web 应用程序之外，并且您希望 Tomcat 的 DefaultServlet 来处理它们，那么您在 Tomcat 中基本上需要做的就是将以下 Context 元素添加到 /conf /server.xml 位于 标记内：

<Context docBase="/path/to/files" path="/files" />

这样就可以通过 http://example.com/files/... 访问它们。对于基于 Tomcat 的服务器（例如 JBoss EAP 6.x 或更早版本），方法基本相同，另请参阅 在这里。 GlassFish/Payara 配置示例可以在此处找到WildFly 配置示例可以在此处< /a>.

如果您想自己控制读/写文件，那么您需要为此创建一个 Servlet ，它基本上只是获取文件的 InputStream ，例如FileInputStream 并将其写入HttpServletResponse 的OutputStream。

在响应中，您应该设置 Content-Type 标头，以便客户端知道哪个应用程序与提供的文件关联。并且，您应该设置 Content-Length 标头，以便客户端可以计算下载进度，否则将未知。而且，如果您想要“另存为”对话框，则应将 Content-Disposition 标头设置为 attachment，否则客户端将尝试内联显示它。最后只需将文件内容写入响应输出流即可。

下面是此类 servlet 的一个基本示例：

@WebServlet("/files/*")
public class FileServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException
    {
        String filename = URLDecoder.decode(request.getPathInfo().substring(1), "UTF-8");
        File file = new File("/path/to/files", filename);
        response.setHeader("Content-Type", getServletContext().getMimeType(filename));
        response.setHeader("Content-Length", String.valueOf(file.length()));
        response.setHeader("Content-Disposition", "inline; filename=\"" + file.getName() + "\"");
        Files.copy(file.toPath(), response.getOutputStream());
    }

}

当映射到 /files/* 等 url-pattern 时，您可以通过 http:// /example.com/files/image.png。通过这种方式，您可以比 DefaultServlet 更好地控制请求，例如提供默认图像（即 if (!file.exists()) file = new File("/path /to/files", "404.gif") 左右）。另外，使用 request.getPathInfo() 优于 request.getParameter()，因为它对 SEO 更友好，否则 IE 将无法在 期间选择正确的文件名另存为。

您可以重用相同的逻辑来提供数据库中的文件。只需将 new FileInputStream() 替换为 ResultSet#getInputStream() 即可。

另请参阅：

• 在 servlet 中保存上传文件的推荐方法application
• 静态资源 servlet 的抽象模板（支持HTTP 缓存）
• 如何检索并在 JSP 页面中显示数据库中的图像？
• 如何使用 Servlet 流式传输音频/视频文件，例如 MP3、MP4、AVI 等

Answer 2

您可以通过将图像放在固定路径（例如：/var/images 或 c:\images）中，在应用程序设置中添加设置（在我的示例中由 Settings.class 表示），然后加载它们来完成此操作像这样，在你的 HttpServlet 中：

String filename = Settings.getValue("images.path") + request.getParameter("imageName")
FileInputStream fis = new FileInputStream(filename);

int b = 0;
while ((b = fis.read()) != -1) {
        response.getOutputStream().write(b);
}

或者如果你想操作图像：

String filename = Settings.getValue("images.path") + request.getParameter("imageName")
File imageFile = new File(filename);
BufferedImage image = ImageIO.read(imageFile);
ImageIO.write(image, "image/png", response.getOutputStream());

那么 html 代码将是

当然，您应该考虑提供不同的内容类型 - “image/jpeg”，例如基于文件扩展名。您还应该提供一些缓存。

此外，您可以使用此 servlet 来对图像进行质量重新缩放，方法是提供宽度和高度参数作为参数，并使用 image.getScaledInstance(w, h, Image.SCALE_SMOOTH)，当然还要考虑性能。

Answer 3

要求：从WEBROOT目录外部或本地磁盘访问静态资源（图像/视频等）

第1步：
在tomcat服务器的webapps下创建一个文件夹，假设文件夹名称为myproj

第2步：在myproj下创建一个WEB-INF文件夹，在该文件夹下创建一个简单的web.xml

代码，在web.xml下

<web-app>
</web-app>

创建上述目录结构两步

c:\programfile\apachesoftwarefoundation\tomcat\...\webapps
                                                            |
                                                            |---myproj
                                                            |   |
                                                            |   |---WEB-INF
                                                                |   |
                                                                    |---web.xml

第三步：
现在，在 myproj.xml 中的以下位置

c:\programfile\apachesoftwarefoundation\tomcat\conf\catalina\localhost

CODE 下创建一个名为 myproj.xml 的 xml 文件：

<Context path="/myproj/images" docBase="e:/myproj/" crossContext="false" debug="0" reloadable="true" privileged="true" /> 

---

步骤 4：
4 A) 现在在硬盘的 E 驱动器中创建一个名为 myproj 的文件夹，并创建一个

名为 images 的新文件夹，并将一些图像放入图像文件夹 (e:myproj\images\)

让我们假设myfoto.jpg 放置在 e:\myproj\images\myfoto.jpg 下

4 B) 现在在 e:\myproj\WEB-INF 中创建一个名为 WEB-INF 的文件夹> 并在 WEB-INF 文件夹中创建一个 web.xml

web.xml 中的代码

<web-app>
</web-app>

第 5 步：
现在创建一个名为 index.html 的 .html 文档，并将其放在 e:\myproj 下，

代码位于 index.html 下

欢迎来到我的项目

上述步骤 4 和步骤 5 的目录结构如下

E:\myproj
    |--index.html
    |
    |--images
    |     |----myfoto.jpg
    |
    |--WEB-INF
    |     |--web.xml

步骤 6：
现在启动 apache tomcat 服务器

步骤 7：
打开浏览器并键入如下 url，

http://localhost:8080/myproj    

然后显示中提供的内容index.html

第 8 步：
访问本地硬盘下的图像（webroot 之外）

http://localhost:8080/myproj/images/myfoto.jpg

Answer 4

添加到 server.xml ：

 <Context docBase="c:/dirtoshare" path="/dir" />

在 web.xml 中启用 dir 文件列表参数：

    <init-param>
        <param-name>listings</param-name>
        <param-value>true</param-value>
    </init-param>

Answer 5

这是我工作场所的故事：
- 我们尝试使用 Struts 1 和 Tomcat 7.x 上传多个图像和文档文件。
- 我们尝试将上传的文件写入文件系统、文件名和数据库记录的完整路径。
- 我们尝试在网络应用程序目录之外分离文件夹。 (*)

下面的解决方案非常简单，对要求有效 (*)：

在文件 META-INF/context.xml 文件中包含以下内容：
（例如，我的应用程序在 http://localhost:8080/ABC 运行，我的应用程序/项目名为 ABC）。
（这也是文件 context.xml 的完整内容）

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/ABC" aliases="/images=D:\images,/docs=D:\docs"/>

（适用于 Tomcat 版本 7 或更高版本）

结果： 我们已创建 2 个别名。例如，我们将图像保存在：D:\images\foo.jpg
并从链接或使用图像标签查看：

<img src="http://localhost:8080/ABC/images/foo.jsp" alt="Foo" height="142" width="142">

或

<img src="/images/foo.jsp" alt="Foo" height="142" width="142">

（我使用 Netbeans 7.x，Netbeans 似乎自动创建文件 WEB-INF\context.xml）

Answer 6

如果您决定分派到 FileServlet，那么您还需要 context.xml 中的 allowLinking="true" 以允许 FileServlet 遍历符号链接。

请参阅 http://tomcat.apache.org/tomcat-6.0-doc/配置/context.html

Answer 7

如果您想使用JAX-RS（例如RESTEasy），请尝试以下操作：

@Path("/pic")
public Response get(@QueryParam("url") final String url) {
    String picUrl = URLDecoder.decode(url, "UTF-8");

    return Response.ok(sendPicAsStream(picUrl))
            .header(HttpHeaders.CONTENT_TYPE, "image/jpg")
            .build();
}

private StreamingOutput sendPicAsStream(String picUrl) {
    return output -> {
        try (InputStream is = (new URL(picUrl)).openStream()) {
            ByteStreams.copy(is, output);
        }
    };
}

使用javax.ws.rs.core.Response和com.google.common。 io.ByteStreams

Answer 8

如果有人无法通过接受的答案解决他的问题，请注意以下注意事项：

1. 无需使用 提及 localhost: 。 src 属性。
2. 确保您在 eclipse 外部运行此项目，因为 eclipse 在其本地 server.xml 文件中自行创建 context docBase 条目。

Answer 9

读取文件的InputStream并将其写入 ServletOutputStream 用于向客户端发送二进制数据。

• 本地文件您可以使用FileInputStream('path/image.png')直接读取文件。
• Mongo 数据库文件，您可以使用 GridFS 获取 InputStream。

@WebServlet("/files/URLStream")
public class URLStream extends HttpServlet {
    private static final long serialVersionUID = 1L;

    public URLStream() {
        super();
    }

    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        File source = new File("D:\\SVN_Commit.PNG");
        long start = System.nanoTime();

        InputStream image = new FileInputStream(source);

        /*String fileID = request.getParameter("id");
        System.out.println("Requested File ID : "+fileID);
        // Mongo DB GridFS - https://stackoverflow.com/a/33544285/5081877
        image = outputImageFile.getInputStream();*/

        if( image != null ) {
            BufferedInputStream bin = null;
            BufferedOutputStream bout = null;
            ServletOutputStream sos = response.getOutputStream();
            try {
                bin = new BufferedInputStream( image );
                bout = new BufferedOutputStream( sos );
                int ch =0; ;
                while((ch=bin.read())!=-1) {
                    bout.write(ch);
                }
            } finally {
                bin.close();
                image.close();
                bout.close();
                sos.close();
            }

        } else {
            PrintWriter writer = response.getWriter();
            writer.append("Something went wrong with your request.");
            System.out.println("Image not available.");
        }
        System.out.println("Time taken by Stream Copy = "+(System.nanoTime()-start));
    }
}

---

结果 URL 直接指向 src 属性。

<img src='http://172.0.0.1:8080/ServletApp/files/URLStream?id=5a575be200c117cc2500003b' alt="mongodb File"/>
<img src='http://172.0.0.1:8080/ServletApp/files/URLStream' alt="local file"/>

<video controls="controls" src="http://172.0.0.1:8080/ServletApp/files/URLStream"></video>

Answer 10

您可以编辑 conf 目录中的 2 个文件：
首先，编辑 server.xml 文件：
您将看到 有许多 标记。
在名称为：“localhost”的 中，将 更改为：

<Host>
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
    ...
    <Context docBase="/home/your_directory_contain_image/" reloadable="true" path="images"></Context>
</Host>

with:
docBase 是包含图像的目录的路径。
path：是显示图像时将添加到 url 的路径。
您的目标将类似于：http://localhost:8080/images/image1.png

接下来，在 中编辑 web.xml 文件，名称为：< code>default 编辑如下：

    <servlet>
        <servlet-name>default</servlet-name>
        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>0</param-value>
        </init-param>
        <init-param>
            <param-name>listings</param-name>
            <param-value>true</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

当您启动 Tomcat 时，它将像图像服务器一样启动
希望有帮助

Answer 11

我做的更简单。问题：CSS 文件具有指向 img 文件夹的 url 链接。获取 404。

我查看了 url，http://tomcatfolder:port/img/blablah.png ，它不存在。但是，这确实指向 Tomcat 中的 ROOT 应用程序。

所以我只是将 img 文件夹从我的 web 应用程序复制到该 ROOT 应用程序中。作品！

当然，不建议用于生产，但这是用于内部工具开发应用程序。