jspSmartUpload是由wwwjspsmartcom.doc

1. jspSmartUpload是由网浏览开发的一个可浏览使用的全功能的文件上传浏览组件，适于嵌入执行上传下载操作的JSP文件中。该组件有以下几个特点：1、使用简单。在JSP文件中仅仅书写三五行JAVA代码就可以搞定文件的上传或下载，方便。2、能全程控制上传。利用jspSmartUpload组件提供的对象及其操作方法，可以获得全部上传文件的信息（包括文件名，大小，类型，扩展名，文件数据等），方便存取。3、能对上传的文件在大小、类型等方面做出限制。如此可以滤掉不符合要求的文件。4、下载灵活。仅写两行代码，就能把Web服务器变成文件服务器。不管文件在Web服务器的目录下或在其它任何目录下，都可以利用jspSmartUpload进行下载。5、能将文件上传到数据库中，也能将数据库中的数据下载下来。这种功能针对的是MYSQL数据库，因为不具有通用性，所以本文不准备举例介绍这种用法。jspSmartUpload组件可以从网站上自由下载，压缩包的名字是jspSmartUpload.zip。下载后，用浏览或浏览将其解压到Tomcat的webapps目录下（本文以Tomcat服务器为例进行介绍）。解压后，将webapps/jspsmartupload目录下的子目录Web-inf名字改为全大写的WEB-INF，这样一改jspSmartUpload类才能使用。因为Tomcat对文件名大小写敏感，它要求Web应用程序相关的类所在目录为WEB-INF，且必须是大写。接着重新启动Tomcat，这样就可以在JSP文件中使用jspSmartUpload组件了。注意，按上述方法安装后，只有webapps/jspsmartupload目录下的程序可以使用jspSmartUpload组件，如果想让Tomcat服务器的所有Web应用程序都能用它，必须做如下工作：1进入命令行状态，将目录切换到Tomcat的webapps/jspsmartupload/WEB-INF目录下。2运行JAR打包命令：jar cvf jspSmartUpload.jar com（也可以打开资源管理器，切换到当前目录，用WinZip将com目录下的所有文件压缩成jspSmartUpload.zip，然后将jspSmartUpload.zip换名为jspSmartUpload.jar文件即可。）3将jspSmartUpload.jar拷贝到Tomcat的shared/lib目录下。二、相关类说明篇 File类这个类包装了一个上传文件的所有信息。通过它，可以得到上传文件的文件名、文件大小、扩展名、文件数据等信息。File类主要提供以下方法：1、saveAs作用：将文件换名另存。原型：public void saveAs(java.lang.String destFilePathName)或public void saveAs(java.lang.String destFilePathName, int optionSaveAs)其中，destFilePathName是另存的文件名，optionSaveAs是另存的选项，该选项有三个值，分别是SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL表明以浏览的根目录为文件根目录另存文件，SAVEAS_VIRTUAL表明以Web应用程序的根目录为文件根目录另存文件，SAVEAS_AUTO则表示让组件决定，当Web应用程序的根目录存在另存文件的目录时，它会选择SAVEAS_VIRTUAL，否则会选择SAVEAS_PHYSICAL。例如，saveAs(/upload/sample.zip,SAVEAS_PHYSICAL)执行后若Web服务器安装在C盘，则另存的文件名实际是c:uploadsample.zip。而saveAs(/upload/sample.zip,SAVEAS_VIRTUAL)执行后若Web应用程序的根目录是webapps/jspsmartupload，则另存的文件名实际是webapps/jspsmartupload/upload/sample.zip。saveAs(/upload/sample.zip,SAVEAS_AUTO)执行时若Web应用程序根目录下存在upload目录，则其效果同saveAs(/upload/sample.zip,SAVEAS_VIRTUAL)，否则同saveAs(/upload/sample.zip,SAVEAS_PHYSICAL)。2. 2、isMissing作用：这个方法用于判断用户是否选择了文件，也即对应的表单项是否有值。选择了文件时，它返回false。未选文件时，它返回true。原型：public boolean isMissing()3、getFieldName作用：取HTML表单中对应于此上传文件的表单项的名字。原型：public String getFieldName()4、getFileName作用：取文件名（不含目录信息）原型：public String getFileName()5、getFilePathName作用：取文件全名（带目录）原型：public String getFilePathName6、getFileExt作用：取文件扩展名（后缀）原型：public String getFileExt()7、getSize作用：取文件长度（以字节计）原型：public int getSize()8、getBinaryData作用：取文件数据中指定位移处的一个字节，用于检测文件等处理。原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之间。 Files类这个类表示所有上传文件的集合，通过它可以得到上传文件的数目、大小等信息。有以下方法：1、getCount作用：取得上传文件的数目。原型：public int getCount()2、getFile作用：取得指定位移处的文件对象File（这是com.jspsmart.upload.File，不是java.io.File，注意区分）。原型：public File getFile(int index)。其中，index为指定位移，其值在0到getCount()-1之间。3、getSize作用：取得上传文件的总长度，可用于限制一次性上传的数据量大小。原型：public long getSize()4、getCollection作用：将所有上传文件对象以Collection的形式返回，以便其它应用程序引用，浏览上传文件信息。原型：public Collection getCollection()5、getEnumeration作用：将所有上传文件对象以Enumeration（枚举）的形式返回，以便其它应用程序浏览上传文件信息。原型：public Enumeration getEnumeration() Request类这个类的功能等同于JSP内置的对象request。只所以提供这个类，是因为对于文件上传表单，通过request对象无法获得表单项的值，必须通过jspSmartUpload组件提供的Request对象来获取。该类提供如下方法：1、getParameter作用：获取指定参数之值。当参数不存在时，返回值为null。原型：public String getParameter(String name)。其中，name为参数的名字。2、getParameterValues作用：当一个参数可以有多个值时，用此方法来取其值。它返回的是一个字符串数组。当参数不存在时，返回值为null。原型：public String getParameterValues(String name)。其中，name为参数的名字。3、getParameterNames作用：取得Request对象中所有参数的名字，用于遍历所有参数。它返回的是一个枚举型的对象。原型：public Enumeration getParameterNames() SmartUpload类这个类完成上传下载工作。A上传与下载共用的方法：只有一个：initialize。3. 原型：有多个，主要使用下面这个：public final void initialize(javax.servlet.jsp.PageContext pageContext)其中，pageContext为JSP页面内置对象（页面上下文）。B上传文件使用的方法：1、upload作用：上传文件数据。对于上传操作，第一步执行initialize方法，第二步就要执行这个方法。原型：public void upload()2、save作用：将全部上传文件保存到指定目录下，并返回保存的文件个数。原型：public int save(String destPathName)和public int save(String destPathName,int option)其中，destPathName为文件保存目录，option为保存选项，它有三个值，分别是SAVE_PHYSICAL,SAVE_VIRTUAL和SAVE_AUTO。（同File类的saveAs方法的选项之值类似）SAVE_PHYSICAL指示组件将文件保存到以操作系统根目录为文件根目录的目录下，SAVE_VIRTUAL指示组件将文件保存到以Web应用程序根目录为文件根目录的目录下，而SAVE_AUTO则表示由组件自动选择。注：save(destPathName)作用等同于save(destPathName,SAVE_AUTO)。3、getSize作用：取上传文件数据的总长度原型：public int getSize()4、getFiles作用：取全部上传文件，以Files对象形式返回，可以利用Files类的操作方法来获得上传文件的数目等信息。原型：public Files getFiles()5、getRequest作用：取得Request对象，以便由此对象获得上传表单参数之值。原型：public Request getRequest()6、setAllowedFilesList作用：设定允许上传带有指定扩展名的文件，当上传过程中有文件名不允许时，组件将抛出异常。原型：public void setAllowedFilesList(String allowedFilesList)其中，allowedFilesList为允许上传的文件扩展名列表，各个扩展名之间以逗号分隔。如果想允许上传那些没有扩展名的文件，可以用两个逗号表示。例如：setAllowedFilesList(doc,txt,)将允许上传带doc和txt扩展名的文件以及没有扩展名的文件。7、setDeniedFilesList作用：用于限制上传那些带有指定扩展名的文件。若有文件扩展名被限制，则上传时组件将抛出异常。原型：public void setDeniedFilesList(String deniedFilesList)其中，deniedFilesList为禁止上传的文件扩展名列表，各个扩展名之间以逗号分隔。如果想禁止上传那些没有扩展名的文件，可以用两个逗号来表示。例如：setDeniedFilesList(exe,bat,)将禁止上传带exe和bat扩展名的文件以及没有扩展名的文件。8、setMaxFileSize作用：设定每个文件允许上传的最大长度。原型：public void setMaxFileSize(long maxFileSize)其中，maxFileSize为为每个文件允许上传的最大长度，当文件超出此长度时，将不被上传。9、setTotalMaxFileSize作用：设定允许上传的文件的总长度，用于限制一次性上传的数据量大小。4. 原型：public void setContentDisposition(String contentDisposition)其中，contentDisposition为要添加的数据。如果contentDisposition为null，则组件将自动添加attachment;，以表明将下载的文件作为附件，结果是IE浏览器将会提示另存文件，而不是自动打开这个文件（IE浏览器一般根据下载的文件扩展名决定执行什么操作，扩展名为doc的将用浏览程序打开，扩展名为pdf的将用acrobat程序打开，等等）。2、downloadFile作用：下载文件。原型：共有以下三个原型可用，第一个最常用，后两个用于特殊情况下的文件下载（如更改内容类型，更改另存的文件名）。 public void downloadFile(String sourceFilePathName)其中，sourceFilePathName为要下载的文件名（带目录的文件全名） public void downloadFile(String sourceFilePathName,String contentType)其中，sourceFilePathName为要下载的文件名（带目录的文件全名）,contentType为内容类型（MIME格式的文件类型信息，可被浏览器识别）。 public void downloadFile(String sourceFilePathName,String contentType,String destFileName)其中，sourceFilePathName为要下载的文件名（带目录的文件全名）,contentType为内容类型（MIME格式的文件类型信息，可被浏览器识别）,destFileName为下载后默认的另存文件名。三、文件上传篇 表单要求对于上传文件的FORM表单，有两个要求：1、METHOD应用POST，即METHOD=POST。2、增加属性：ENCTYPE=multipart/form-data下面是一个用于上传文件的FORM表单的例子： 上传的例子1、上传页面upload.html本页面提供表单，让用户选择要上传的文件，点击上传按钮执行上传操作。页面源码如下：文件上传 上传文件选择1、5. 2、3、4、2、上传处理页面do_upload.jsp本页面执行文件上传操作。页面源码中详细介绍了上传方法的用法，在此不赘述了。页面源码如下：文件上传处理页面%/ 新建一个SmartUpload对象SmartUpload su = new SmartUpload();/ 上传初始化su.initialize(pageContext);/ 设定上传限制/ 1.限制每个上传文件的最大长度。/ su.setMaxFileSize(10000);/ 2.限制总上传数据的长度。/ su.setTotalMaxFileSize(20000);/ 3.设定允许上传的文件（通过扩展名限制）,仅允许doc,txt文件。/ su.setAllowedFilesList(doc,txt);/ 4.设定禁止上传的文件（通过扩展名限制）,禁止上传带有exe,bat,jsp,htm,html扩展名的文件和没有扩展名的文件。/ su.setDeniedFilesList(exe,bat,jsp,htm,html,);/ 上传文件su.upload();/ 将上传文件全部保存到指定目录int count = su.save(/upload);out.println(count+个文件上传浏览！);/ 利用Request对象获取参数之值out.println(TEST=+su.getRequest().getParameter(TEST)+);/ 逐一提取上传文件信息，同时可保存文件。for (int i=0;isu.getFiles().getCount();i+)com.jspsmart.upload.File file = su.getFiles().getFile(i);6. / 若文件不存在则继续if (file.isMissing() continue;/ 显示当前文件信息out.println();out.println(表单项名（FieldName）+ file.getFieldName() + );out.println(文件长度（Size） +file.getSize() + );out.println(文件名（FileName）+ file.getFileName() + );out.println(文件扩展名（FileExt）+ file.getFileExt() + );out.println(文件全名（FilePathName）+ file.getFilePathName() + );out.println();/ 将文件另存/ file.saveAs(/upload/ + myFile.getFileName();/ 另存到以WEB应用程序的根目录为文件根目录的目录下/ file.saveAs(/upload/ + myFile.getFileName(),su.SAVE_VIRTUAL);/ 另存到操作系统的根目录为文件根目录的目录下/ file.saveAs(c:temp + myFile.getFileName(),su.SAVE_PHYSICAL);%四、文件下载篇1、下载链接页面download.html页面源码如下：下载点击下载2、下载处理页面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload组件来下载文件，从下面的源码中就可以看到，下载何其简单。源码如下：注意，执行下载的页面，在Java脚本范围外（即之外），不要包含HTML代码、空格、回车或换行等字符，有的话将不能正确下载。不信的话，可以在上述源码中%之间加入一个换行符，再下载一下，保证出错。因为它影响了返回给浏览器的数据流，导致解析出错。3、如何下载中文文件jspSmartUpload虽然能下载文件，但对中文支持不足。若下载的文件名中有汉字，则浏览器在提示另存的文件名时，显示的是一堆乱码，很扫人兴。上面的例子就是这样。（这个问题也是众多下载组件所存在的问题，很少有人解决，浏览不到相关资料，可叹！）为了给jspSmartUpload组件增加下载中文文件的支持，我对该组件进行了研究，发现对返回给浏览器的另存文件名进行UTF-8编码后，浏览器便能正确显示中文名字了。这是一个令人高兴的发现。于是我对jspSmartUpload组件的SmartUpload类做了升级处理，增加了toUtf8String这个方法，改动部分源码如下：public void downloadFile(String s, String s1, String s2, int i)throws ServletException, IOException, SmartUploadExceptionif(s = null)throw new IllegalArgumentException(File + s + not found (1040).);if(s.equals()throw new IllegalArgumentException(File + s + not found (1040).);if(!isVirtual(s) & m_denyPhysicalPath)throw new SecurityException(Physical path isdenied (1035).);if(isVirtual(s)s = m_application.getRealPath(s);java.io.File file = new java.io.File(s);FileInputStream fileinputstream = new FileInputStream(file);long l = file.length();boolean flag = false;int k = 0;byte abyte0 = new bytei;if(s1 = null)m_response.setContentType(application/x-msdownload);elseif(s1.length() = 0)m_response.setContentType(application/x-msdownload);elsem_response.setContentType(s1);m_response.setContentLength(int)l);m_contentDisposition = m_contentDisposition != null ?m_contentDisposition : attachment;if(s2 = null)m_response.setHeader(Content-Disposition,m_contentDisposition + filename= +toUtf8String(getFileName(s);elseif(s2.length() = 0)m_response.setHeader(Content-Disposition,m_contentDisposition);elsem_response.setHeader(Content-Disposition,m_contentDisposition + filename= + toUtf8String(s2);8. while(long)k l)int j = fileinputs