Comment télécharger des fichiers sur le serveur à l'aide de JSP/Servlet ?

L'éditeur PHP Youzi vous présentera comment utiliser JSP/Servlet pour télécharger des fichiers sur le serveur en Java. Dans le développement Web, le téléchargement de fichiers est une exigence courante, et JSP/Servlet peut être utilisé pour implémenter une fonction de téléchargement de fichiers simple et efficace. Ensuite, nous présenterons en détail les étapes de téléchargement de fichiers sur le serveur via du code Java, afin que vous puissiez rapidement maîtriser cette compétence et améliorer vos capacités de développement.

Contenu de la question

Comment utiliser jsp/servlet pour télécharger des fichiers sur le serveur ?

J'ai essayé ceci :

<form action="upload" method="post">
    <input type="text" name="description" />
    <input type="file" name="file" />
    <input type="submit" />
</form>

Cependant, je n'obtiens que le nom du fichier, pas le contenu du fichier. Quand je le ferai enctype="multipart/form-data" 添加到 <form> 时，request.getparameter() 返回 null.

Au cours de mes recherches, je suis tombé sur le téléchargement de fichiers communs Apache. J'ai essayé ceci :

fileitemfactory factory = new diskfileitemfactory();
servletfileupload upload = new servletfileupload(factory);
list items = upload.parserequest(request); // this line is where it died.

Malheureusement, la servlet a levé une exception sans message ni raison clair. Voici la trace de la pile :

SEVERE: Servlet.service() for servlet UploadServlet threw exception
javax.servlet.ServletException: Servlet execution threw an exception
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:313)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)
    at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:852)
    at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)
    at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
    at java.lang.Thread.run(Thread.java:637)

Solution

Introduction

Pour parcourir et sélectionner les fichiers à télécharger, vous devez ajouter du HTML au formulaire <input type="file"> 字段。如 HTML specification 中所述，您必须使用 post 方法，并且表单的 enctype 属性必须设置为 "multipart/form-data".

<form action="upload" method="post" enctype="multipart/form-data">
    <input type="text" name="description" />
    <input type="file" name="file" />
    <input type="submit" />
</form>

Après avoir soumis un tel formulaire, les données du formulaire binaire en plusieurs parties sont disponibles dans le corps de la demande dans enctypeun format différent que lorsque n'est pas défini.

Avant le servlet 3.0 (décembre 2009), l'API du servlet elle-même ne prenait pas en charge multipart/form-data。它仅支持默认形式 enctype application/x-www-form-urlencoded。当使用多部分表单数据时，request.getparameter() 和 consorts 都将返回 null. C'est là qu'intervient le célèbre Apache Commons FileUpload.

Ne l'analysez pas manuellement !

Théoriquement, vous pouvez analyser vous-même le corps de la requête en fonction de ServletRequest#getInputStream(). Il s’agit cependant d’une tâche précise et fastidieuse qui nécessite une connaissance précise de la RFC2388. Vous ne devriez pas essayer de le faire vous-même ou copier-coller du code maison sans bibliothèque trouvé ailleurs sur Internet. De nombreuses ressources en ligne échouent à cet égard, comme roseindia.net. Voir aussi téléchargement d'un fichier pdf. Vous devez utiliser une vraie bibliothèque qui a été utilisée (et implicitement testée !) par des millions d'utilisateurs depuis des années. Une telle bibliothèque a prouvé sa robustesse.

Lorsque vous utilisez déjà le servlet 3.0 ou supérieur, veuillez utiliser l'API native

Si vous utilisez au moins le servlet 3.0 (tomcat 7, jetty 9, jboss as 6, glassfish 3, etc., ils existent depuis 2010), alors vous pouvez utiliser HttpServletRequest#getPart() HttpServletRequest#getPart() 提供的标准 api 来收集单独的多部分表单数据项（大多数 servlet 3.0 实现实际上都在幕后使用 apache commons fileupload！）。此外，正常形式字段可以通过 getparameter() Fournit une API standard pour collecter des éléments de données individuels de formulaire en plusieurs parties (la plupart des implémentations de servlet 3.0 utilisent en fait Apache Commons FileUpload en coulisses !). De plus, les champs de formulaire normaux peuvent être obtenus de la manière habituelle via getparameter().

Annotez d'abord votre servlet avec @MultipartConfig@MultipartConfig 注释您的 servlet，以便让它识别并支持 multipart/form-data 请求，从而使 getpart() afin qu'il reconnaisse et prenne en charge les requêtes multipart/form-data, permettant ainsi getpart()</code > Working normalement : </p> <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false;">@webservlet(&quot;/upload&quot;) @multipartconfig public class uploadservlet extends httpservlet { // ... }</pre><div class="contentsignin">Copier après la connexion</div></div> <p>Ensuite, mettez-le en œuvre <code>dopost() comme suit :

protected void dopost(httpservletrequest request, httpservletresponse response) throws servletexception, ioexception {
    string description = request.getparameter("description"); // retrieves <input type="text" name="description">
    part filepart = request.getpart("file"); // retrieves <input type="file" name="file">
    string filename = paths.get(filepart.getsubmittedfilename()).getfilename().tostring(); // msie fix.
    inputstream filecontent = filepart.getinputstream();
    // ... (do your job here)
}

Attentionpath#getfilename(). Il s'agit d'un correctif msie concernant l'obtention des noms de fichiers. Ce navigateur envoie de manière incorrecte le chemin et le nom complets du fichier au lieu de simplement le nom du fichier.

Si vous souhaitez télécharger plusieurs fichiers via multiple="true",

<input type="file" name="files" multiple="true" />

Ou à l'ancienne avec plusieurs entrées,

<input type="file" name="files" />
<input type="file" name="files" />
<input type="file" name="files" />
...

Vous pouvez ensuite les récupérer de la manière suivante (malheureusement, il n'existe pas de méthode telle que request.getparts("files")) :

protected void dopost(httpservletrequest request, httpservletresponse response) throws servletexception, ioexception {
    // ...
    list<part> fileparts = request.getparts().stream().filter(part -> "files".equals(part.getname()) && part.getsize() > 0).collect(collectors.tolist()); // retrieves <input type="file" name="files" multiple="true">

    for (part filepart : fileparts) {
        string filename = paths.get(filepart.getsubmittedfilename()).getfilename().tostring(); // msie fix.
        inputstream filecontent = filepart.getinputstream();
        // ... (do your job here)
    }
}

当您尚未使用 servlet 3.1 时，手动获取提交的文件名

请注意，Part#getSubmittedFileName() 是在 servlet 3.1 中引入的（tomcat 8、jetty 9、wildfly 8、glassfish 4 等，它们自 2013 年以来就已存在）。如果您还没有使用 servlet 3.1（真的吗？），那么您需要一个额外的实用方法来获取提交的文件名。

private static string getsubmittedfilename(part part) {
    for (string cd : part.getheader("content-disposition").split(";")) {
        if (cd.trim().startswith("filename")) {
            string filename = cd.substring(cd.indexof('=') + 1).trim().replace("\"", "");
            return filename.substring(filename.lastindexof('/') + 1).substring(filename.lastindexof('\\') + 1); // msie fix.
        }
    }
    return null;
}

string filename = getsubmittedfilename(filepart);

请注意有关获取文件名的 msie 修复。此浏览器错误地发送完整文件路径和名称，而不仅仅是文件名。

当您尚未使用 servlet 3.0 时，请使用 apache commons fileupload

如果您还没有使用 servlet 3.0（是不是该升级了？它已经十多年前发布了！），通常的做法是使用 Apache Commons FileUpload 来解析多部分表单数据请求。它有一个很好的User Guide和FAQ（仔细检查两者）。还有 o'reilly（“cos”）multipartrequest，但它有一些（小）错误，并且多年来不再积极维护。我不建议使用它。 apache commons fileupload 仍在积极维护，目前非常成熟。

为了使用 apache commons fileupload，您的 web 应用程序的 /web-inf/lib 中至少需要有以下文件：

• commons-fileupload.jar
• commons-io.jar

您最初的尝试失败很可能是因为您忘记了公共 io。

下面是一个启动示例，显示使用 apache commons fileupload 时 uploadservlet 的 dopost() 的样子：

protected void dopost(httpservletrequest request, httpservletresponse response) throws servletexception, ioexception {
    try {
        list<fileitem> items = new servletfileupload(new diskfileitemfactory()).parserequest(request);
        for (fileitem item : items) {
            if (item.isformfield()) {
                // process regular form field (input type="text|radio|checkbox|etc", select, etc).
                string fieldname = item.getfieldname();
                string fieldvalue = item.getstring();
                // ... (do your job here)
            } else {
                // process form file field (input type="file").
                string fieldname = item.getfieldname();
                string filename = filenameutils.getname(item.getname());
                inputstream filecontent = item.getinputstream();
                // ... (do your job here)
            }
        }
    } catch (fileuploadexception e) {
        throw new servletexception("cannot parse multipart request.", e);
    }

    // ...
}

非常重要的是，您不要事先在同一请求上调用 getparameter()、getparametermap()、getparametervalues()、getinputstream()、getreader() 等。否则，servlet 容器将读取并解析请求正文，因此 apache commons fileupload 将得到一个空请求正文。另请参见 a.o. ServletFileUpload#parseRequest(request) returns an empty list。

注意 filenameutils#getname()。这是有关获取文件名的 msie 修复。此浏览器错误地发送完整文件路径和名称，而不仅仅是文件名。

或者，您也可以将这一切包装在 filter 中，它会自动解析所有内容并将内容放回请求的参数映射中，以便您可以继续以通常的方式使用 request.getparameter() 并通过以下方式检索上传的文件request.getattribute()。 You can find an example in this blog article。

glassfish3 中 getparameter() 错误的解决方法仍然返回 null

请注意，早于 3.1.2 的 glassfish 版本有 a bug，其中 getparameter() 仍返回 null。如果您的目标是这样的容器并且无法升级它，那么您需要借助此实用程序方法从 getpart() 中提取值：

private static string getvalue(part part) throws ioexception {
    bufferedreader reader = new bufferedreader(new inputstreamreader(part.getinputstream(), "utf-8"));
    stringbuilder value = new stringbuilder();
    char[] buffer = new char[1024];
    for (int length = 0; (length = reader.read(buffer)) > 0;) {
        value.append(buffer, 0, length);
    }
    return value.tostring();
}

string description = getvalue(request.getpart("description")); // retrieves <input type="text" name="description">

保存上传的文件（不要使用 getrealpath() 或 part.write()！）

前往以下答案，详细了解如何将获得的 inputstream （上述代码片段中所示的 filecontent 变量）正确保存到磁盘或数据库：

• Recommended way to save uploaded files in a servlet application
• How to upload an image and save it in database?
• How to convert Part to Blob, so I can store it in MySQL?

提供上传的文件

请参阅以下答案，了解如何正确地将保存的文件从磁盘或数据库返回给客户端的详细信息：

• Load images from outside of webapps / webcontext / deploy folder using or tag
• How to retrieve and display images from a database in a JSP page?
• Simplest way to serve static data from outside the application server in a Java web application
• Abstract template for static resource servlet supporting HTTP caching

ajax 表单

前往以下答案，了解如何使用 ajax（和 jquery）上传。请注意，无需为此更改用于收集表单数据的 servlet 代码！只有您响应的方式可能会改变，但这相当简单（即，不转发到 jsp，只需打印一些 json 或 xml 甚至纯文本，具体取决于负责 ajax 调用的脚本所期望的内容）。

• How can I upload files to a server using JSP/Servlet and Ajax?
• Send a file as multipart through XMLHttpRequest
• HTML5 drag and drop file upload to Java Servlet

如果您碰巧使用 Spring MVC，请按以下方法操作（我将其留在这里，以防有人发现它有用）：

使用 enctype 属性设置为“multipart/form-datazqbenczqb”的表单（与 <a href="https://www.php.cn/link/8a13dab3f5ec9e22d0d1495c8c85e436">BalusC's answer</a> 相同）：</p> <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:html;toolbar:false;">&lt;form action=&quot;upload&quot; method=&quot;post&quot; enctype=&quot;multipart/form-data&quot;&gt; &lt;input type=&quot;file&quot; name=&quot;file&quot; /&gt; &lt;input type=&quot;submit&quot; value=&quot;upload&quot;/&gt; &lt;/form&gt; </pre><div class="contentsignin">Copier après la connexion</div></div> <p>在您的控制器中，将请求参数 <code>file 映射到 multipartfile 类型，如下所示：

@RequestMapping(value = "/upload", method = RequestMethod.POST)
public void handleUpload(@RequestParam("file") MultipartFile file) throws IOException {
    if (!file.isEmpty()) {
            byte[] bytes = file.getBytes(); // alternatively, file.getInputStream();
            // application logic
    }
}

您可以使用 multipartfile 的 getoriginalfilename() 和 getsize() 获取文件名和大小。

我已经使用 spring 版本 4.1.1.release 对此进行了测试。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!