安裝篇jspSmartUpload是由www.jspsmart.com網(wǎng)站開發(fā)的一個(gè)可免費(fèi)使用的全功能的文件上傳下載組件，適于嵌入執(zhí)行上傳下載操作的JSP文件中。該組件有以下幾個(gè)特點(diǎn)：
1、使用簡單。在JSP文件中僅僅書寫三五行JAVA代碼就可以搞定文件的上傳或下載，方便。
2、能全程控制上傳。利用jspSmartUpload組件提供的對象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類型，擴(kuò)展名，文件數(shù)據(jù)等），方便存取。
3、能對上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫兩行代碼，就能把Web服務(wù)器變成文件服務(wù)器。不管文件在Web服務(wù)器的目錄下或在其它任何目錄下，都可以利用jspSmartUpload進(jìn)行下載。
5、能將文件上傳到數(shù)據(jù)庫中，也能將數(shù)據(jù)庫中的數(shù)據(jù)下載下來。這種功能針對的是MYSQL數(shù)據(jù)庫，因?yàn)椴痪哂型ㄓ眯?，所以本文不?zhǔn)備舉例介紹這種用法。
jspSmartUpload組件可以從www.jspsmart.com網(wǎng)站上自由下載，壓縮包的名字是jspSmartUpload.zip。下載后，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下（本文以Tomcat服務(wù)器為例進(jìn)行介紹）。解壓后，將webapps/jspsmartupload目錄下的子目錄Web-inf名字改為全大寫的WEB-INF，這樣一改jspSmartUpload類才能使用。因?yàn)?/span>Tomcat對文件名大小寫敏感，它要求Web應(yīng)用程序相關(guān)的類所在目錄為WEB-INF，且必須是大寫。接著重新啟動(dòng)Tomcat，這樣就可以在JSP文件中使用jspSmartUpload組件了。
注意，按上述方法安裝后，只有webapps/jspsmartupload目錄下的程序可以使用jspSmartUpload組件，如果想讓Tomcat服務(wù)器的所有Web應(yīng)用程序都能用它，必須做如下工作：
1．進(jìn)入命令行狀態(tài)，將目錄切換到Tomcat的webapps/jspsmartupload/WEB-INF目錄下。
2．運(yùn)行JAR打包命令：jar cvf jspSmartUpload.jar com（也可以打開資源管理器，切換到當(dāng)前目錄，用WinZip將com目錄下的所有文件壓縮成jspSmartUpload.zip，然后將jspSmartUpload.zip換名為jspSmartUpload.jar文件即可。）
3．將jspSmartUpload.jar拷貝到Tomcat的shared/lib目錄下。
文件上傳篇
（一）表單要求
對于上傳文件的FORM表單，有兩個(gè)要求：
1、METHOD應(yīng)用POST，即METHOD="POST"。
2、增加屬性：ENCTYPE="multipart/form-data"
下面是一個(gè)用于上傳文件的FORM表單的例子：
<FORM METHOD="POST" ENCTYPE="multipart/form-data" ACTION="/jspSmartUpload/upload.jsp">
<INPUT TYPE="FILE" NAME="MYFILE">
<INPUT TYPE="SUBMIT">
</FORM>
（二）上傳的例子
1、上傳頁面upload.html
本頁面提供表單，讓用戶選擇要上傳的文件，點(diǎn)擊"上傳"按鈕執(zhí)行上傳操作。
頁面源碼如下：
<!--
文件名：upload.html
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>文件上傳</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<p> </p>
<p align="center">上傳文件選擇</p>
<FORM METHOD="POST" ACTION="jsp/do_upload.jsp" ENCTYPE="multipart/form-data">
<input type="hidden" name="TEST" value="good">
<table width="75％" border="1" align="center">
<tr>
<td><div align="center">1、
<input type="FILE" name="FILE1" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">2、
<input type="FILE" name="FILE2" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">3、
<input type="FILE" name="FILE3" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">4、
<input type="FILE" name="FILE4" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">
<input type="submit" name="Submit" value="上傳它！">
</div></td>
</tr>
</table>
</FORM>
</body>
</html>
2、上傳處理頁面do_upload.jsp
本頁面執(zhí)行文件上傳操作。頁面源碼中詳細(xì)介紹了上傳方法的用法，在此不贅述了。
頁面源碼如下：
<%--
文件名：do_upload.jsp
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
--%>
<%@ page contentType="text/html; charset=gb2312" language="java" import="java.util.*,com.jspsmart.upload.*" errorPage="" %>
<html>
<head>
<title>文件上傳處理頁面</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<%
// 新建一個(gè)SmartUpload對象
SmartUpload su = new SmartUpload();
// 上傳初始化
su.initialize(pageContext);
// 設(shè)定上傳限制
// 1.限制每個(gè)上傳文件的最大長度。
// su.setMaxFileSize(10000);
// 2.限制總上傳數(shù)據(jù)的長度。
// su.setTotalMaxFileSize(20000);
// 3.設(shè)定允許上傳的文件（通過擴(kuò)展名限制），僅允許doc,txt文件。
// su.setAllowedFilesList("doc,txt");
// 4.設(shè)定禁止上傳的文件（通過擴(kuò)展名限制），禁止上傳帶有exe,bat, jsp,htm,html擴(kuò)展名的文件和沒有擴(kuò)展名的文件。
// su.setDeniedFilesList("exe,bat,jsp,htm,html,,");
// 上傳文件
su.upload();
// 將上傳文件全部保存到指定目錄
int count = su.save("/upload");
out.println(count+"個(gè)文件上傳成功！<br>");
// 利用Request對象獲取參數(shù)之值
out.println("TEST="+su.getRequest().getParameter("TEST") + "<BR><BR>");
// 逐一提取上傳文件信息，同時(shí)可保存文件。
for (int i=0;i<su.getFiles().getCount();i++)
{
com.jspsmart.upload.File file = su.getFiles().getFile(i);
// 若文件不存在則繼續(xù)
if (file.isMissing()) continue;
// 顯示當(dāng)前文件信息
out.println("<TABLE BORDER=1>");
out.println("<TR><TD>表單項(xiàng)名（FieldName）</TD><TD>" + file.getFieldName()+ "</TD></TR>");
out.println("<TR><TD>文件長度（Size）</TD><TD>" + file.getSize() + "</TD></TR>");
out.println("<TR><TD>文件名（FileName）</TD><TD>" + file.getFileName() + "</TD></TR>");
out.println("<TR><TD>文件擴(kuò)展名（FileExt）</TD><TD>" + file.getFileExt() + "</TD></TR>");
out.println("<TR><TD>文件全名（FilePathName）</TD><TD>" + file.getFilePathName() + "</TD></TR>");
out.println("</TABLE><BR>");
// 將文件另存
// file.saveAs("/upload/" + myFile.getFileName());
// 另存到以WEB應(yīng)用程序的根目錄為文件根目錄的目錄下
// file.saveAs("/upload/" + myFile.getFileName(), su.SAVE_VIRTUAL);
// 另存到操作系統(tǒng)的根目錄為文件根目錄的目錄下
// file.saveAs("c:\\temp\\" + myFile.getFileName(), su.SAVE_PHYSICAL);
}
%>
</body>
</html>
文件下載篇
1、下載鏈接頁面download.html
頁面源碼如下：
<!--
文件名：download.html
作者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>下載</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<a href="jsp/do_download.jsp">點(diǎn)擊下載</a>
</body>
</html>
2、下載處理頁面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload組件來下載文件，從下面的源碼中就可以看到，下載何其簡單。
源碼如下：
<%@ page contentType="text/html;charset=gb2312" import="com.jspsmart.upload.*" %>
<%
// 新建一個(gè)SmartUpload對象
SmartUpload su = new SmartUpload();
// 初始化
su.initialize(pageContext);
// 設(shè)定contentDisposition為null以禁止瀏覽器自動(dòng)打開文件，
// 保證點(diǎn)擊鏈接后是下載文件。若不設(shè)定，則下載的文件擴(kuò)展名為
// doc時(shí)，瀏覽器將自動(dòng)用word打開它。擴(kuò)展名為pdf時(shí)，
// 瀏覽器將用acrobat打開。
su.setContentDisposition(null);
// 下載文件
su.downloadFile("/upload/如何賺取我的第一桶金.doc");
%>
注意，執(zhí)行下載的頁面，在Java腳本范圍外（即<% ... %>之外），不要包含HTML代碼、空格、回車或換行等字符，有的話將不能正確下載。不信的話，可以在上述源碼中%><%之間加入一個(gè)換行符，再下載一下，保證出錯(cuò)。因?yàn)樗绊懥朔祷亟o瀏覽器的數(shù)據(jù)流，導(dǎo)致解析出錯(cuò)。
文件上傳篇之中文亂碼
1、當(dāng)頁面上傳有參數(shù)時(shí)，中文會(huì)亂碼，解決頁面上中文參數(shù)亂碼方法：
修改類SmartUpload()中的upload()方法
public void upload()
throws ServletException, IOException, SmartUploadException
{
int i = 0;
boolean flag = false;
long l = 0L;
boolean flag1 = false;
String s = new String();
String s2 = new String();
String s4 = new String();
String s5 = new String();
String s6 = new String();
String s7 = new String();
String s8 = new String();
String s9 = new String();
String s10 = new String();
boolean flag2 = false;
m_totalBytes = m_request.getContentLength();
m_binArray = new byte[m_totalBytes];
int j;
for(; i < m_totalBytes; i += j)
try
{
m_request.getInputStream();
j = m_request.getInputStream().read(m_binArray, i, m_totalBytes - i);
}
catch(Exception exception)
{
throw new SmartUploadException("Unable to upload.");
}
for(; !flag1 && m_currentIndex < m_totalBytes; m_currentIndex++)
if(m_binArray[m_currentIndex] == 13)
flag1 = true;
else
m_boundary = m_boundary + (char)m_binArray[m_currentIndex];
if(m_currentIndex == 1)
return;
for(m_currentIndex++; m_currentIndex < m_totalBytes; m_currentIndex = m_currentIndex + 2)
{
String s1 = getDataHeader();
m_currentIndex = m_currentIndex + 2;
boolean flag3 = s1.indexOf("filename") > 0;
String s3 = getDataFieldValue(s1, "name");
if(flag3)
{
s6 = getDataFieldValue(s1, "filename");
s4 = getFileName(s6);
s5 = getFileExt(s4);
s7 = getContentType(s1);
s8 = getContentDisp(s1);
s9 = getTypeMIME(s7);
s10 = getSubTypeMIME(s7);
}
getDataSection();
if(flag3 && s4.length() > 0)
{
if(m_deniedFilesList.contains(s5))
throw new SecurityException("The extension of the file is denied to be uploaded (1015).");
if(!m_allowedFilesList.isEmpty() && !m_allowedFilesList.contains(s5))
throw new SecurityException("The extension of the file is not allowed to be uploaded (1010).");
if(m_maxFileSize > 0L && (long)((m_endData - m_startData) + 1) > m_maxFileSize)
throw new SecurityException("Size exceeded for this file : " + s4 + " (1105).");
l += (m_endData - m_startData) + 1;
if(m_totalMaxFileSize > 0L && l > m_totalMaxFileSize)
throw new SecurityException("Total File Size exceeded (1110).");
}
if(flag3)
{
com.jspsmart.upload.File file = new com.jspsmart.upload.File();
file.setParent(this);
file.setFieldName(s3);
file.setFileName(s4);
file.setFileExt(s5);
file.setFilePathName(s6);
file.setIsMissing(s6.length() == 0);
file.setContentType(s7);
file.setContentDisp(s8);
file.setTypeMIME(s9);
file.setSubTypeMIME(s10);
if(s7.indexOf("application/x-macbinary") > 0)
m_startData = m_startData + 128;
file.setSize((m_endData - m_startData) + 1);
file.setStartData(m_startData);
file.setEndData(m_endData);
m_files.addFile(file);
} else
{
/**
*原來的代碼，當(dāng)頁面上要傳入中文參數(shù)時(shí)，亂碼。
*/
// String s11 = new String(m_binArray, m_startData, (m_endData - m_startData) + 1);
/**
*2008-10-28 carton修改，解決頁面?zhèn)魅胫形膮?shù)亂碼
*/
String s11 = new String(m_binArray,m_startData,(m_endData - m_startData) + 1, "utf-8");
m_formRequest.putParameter(s3, s11);
}
if((char)m_binArray[m_currentIndex + 1] == '-')
break;
}
}
2、當(dāng)上傳時(shí)文件名為中文時(shí)，解決中文亂碼
修改類SmartUpload()中的getDataHeader()方法
private String getDataHeader()
{
int i = m_currentIndex;
int j = 0;
boolean flag = false;
for(boolean flag1 = false; !flag1;)
if(m_binArray[m_currentIndex] == 13 && m_binArray[m_currentIndex + 2] == 13)
{
flag1 = true;
j = m_currentIndex - 1;
m_currentIndex = m_currentIndex + 2;
} else
{
m_currentIndex++;
}
/**
*原代碼，當(dāng)上傳文件名為中文時(shí)，亂碼
*/
//String s = new String(m_binArray, i, (j - i) + 1);
/**
*2008-10-28 carton修改，解決上傳文件中文亂碼問題
*/
String s = null;
try {
s = new String(m_binArray,i,(j - i) + 1, "utf-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return s;
}
這樣頁面上就不用再轉(zhuǎn)碼了。頁面設(shè)置成"utf-8"編碼即可。
文件下載篇之中文下載
jspSmartUpload雖然能下載文件，但對中文支持不足。若下載的文件名中有漢字，則瀏覽器在提示另存的文件名時(shí)，顯示的是一堆亂碼，很掃人興。上面的例子就是這樣。（這個(gè)問題也是眾多下載組件所存在的問題，很少有人解決，搜索不到相關(guān)資料，可嘆！）
為了給jspSmartUpload組件增加下載中文文件的支持，我對該組件進(jìn)行了研究，發(fā)現(xiàn)對返回給瀏覽器的另存文件名進(jìn)行UTF-8編碼后，瀏覽器便能正確顯示中文名字了。這是一個(gè)令人高興的發(fā)現(xiàn)。
首先，用jad將jspSmartUpload.jar反編譯為java文件；
然后在SmartUpload類的開始處添加代碼：import java.io.File;（這一點(diǎn)很重要）；
最后，再對jspSmartUpload組件的SmartUpload類做升級處理，增加了toUtf8String這個(gè)方法，改動(dòng)部分源碼如下：
public void downloadFile(String s, String s1, String s2, int i)
throws ServletException, IOException, SmartUploadException
{
if(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 is
denied (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 byte[i];
if(s1 == null)
m_response.setContentType("application/x-msdownload");
else
if(s1.length() == 0)
m_response.setContentType("application/x-msdownload");
else
m_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)));
else
if(s2.length() == 0)
m_response.setHeader("Content-Disposition",
m_contentDisposition);
else
m_response.setHeader("Content-Disposition",
m_contentDisposition + " filename=" + toUtf8String(s2));
while((long)k < l)
{
int j = fileinputstream.read(abyte0, 0, i);
k += j;
m_response.getOutputStream().write(abyte0, 0, j);
}
fileinputstream.close();
}
/**
* 將文件名中的漢字轉(zhuǎn)為UTF8編碼的串,以便下載時(shí)能正確顯示另存的文件名.
* 縱橫軟件制作中心雨亦奇2003.08.01
* @param s 原文件名
* @return 重新編碼后的文件名
*/
public static String toUtf8String(String s) {
StringBuffer sb = new StringBuffer();
for (int i=0;i<s.length();i++) {
char c = s.charAt(i);
if (c >= 0 && c <= 255) {
sb.append(c);
} else {
byte[] b;
try {
b = Character.toString(c).getBytes("utf-8");
} catch (Exception ex) {
System.out.println(ex);
b = new byte[0];
}
for (int j = 0; j < b.length; j++) {
int k = b[j];
if (k < 0) k += 256;
sb.append("％" + Integer.toHexString(k).
toUpperCase());
}
}
}
return sb.toString();
}
注意源碼中粗體部分，原jspSmartUpload組件對返回的文件未作任何處理，現(xiàn)在做了編碼的轉(zhuǎn)換工作，將文件名轉(zhuǎn)換為UTF-8形式的編碼形式。UTF-8編碼對英文未作任何處理，對中文則需要轉(zhuǎn)換為％XX的形式。toUtf8String方法中，直接利用Java語言提供的編碼轉(zhuǎn)換方法獲得漢字字符的UTF-8編碼，之后將其轉(zhuǎn)換為％XX的形式。
將源碼編譯后打包成jspSmartUpload.jar，拷貝到Tomcat的shared/lib目錄下（可為所有WEB應(yīng)用程序所共享），然后重啟Tomcat服務(wù)器就可以正常下載含有中文名字的文件了。另，toUtf8String方法也可用于轉(zhuǎn)換含有中文的超級鏈接，以保證鏈接的有效，因?yàn)橛械?/span>WEB服務(wù)器不支持中文鏈接。
相關(guān)類說明篇
（一）File類
這個(gè)類包裝了一個(gè)上傳文件的所有信息。通過它，可以得到上傳文件的文件名、文件大小、擴(kuò)展名、文件數(shù)據(jù)等信息。
File類主要提供以下方法：
1、saveAs作用：將文件換名另存。
原型：
public void saveAs(java.lang.String destFilePathName)
或
public void saveAs(java.lang.String destFilePathName, int optionSaveAs)
其中，destFilePathName是另存的文件名，optionSaveAs是另存的選項(xiàng)，該選項(xiàng)有三個(gè)值，分別是SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL表明以操作系統(tǒng)的根目錄為文件根目錄另存文件，SAVEAS_VIRTUAL表明以Web應(yīng)用程序的根目錄為文件根目錄另存文件，SAVEAS_AUTO則表示讓組件決定，當(dāng)Web應(yīng)用程序的根目錄存在另存文件的目錄時(shí)，它會(huì)選擇SAVEAS_VIRTUAL，否則會(huì)選擇SAVEAS_PHYSICAL。
例如，saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)執(zhí)行后若Web服務(wù)器安裝在C盤，則另存的文件名實(shí)際是c:\upload\sample.zip。而saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)執(zhí)行后若Web應(yīng)用程序的根目錄是webapps/jspsmartupload，則另存的文件名實(shí)際是webapps/jspsmartupload/upload/sample.zip。saveAs("/upload/sample.zip",SAVEAS_AUTO)執(zhí)行時(shí)若Web應(yīng)用程序根目錄下存在upload目錄，則其效果同saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)，否則瑂aveAs("/upload/sample.zip",SAVEAS_PHYSICAL)。
建議：對于Web程序的開發(fā)來說，最好使用SAVEAS_VIRTUAL，以便移植。
2、isMissing
作用：這個(gè)方法用于判斷用戶是否選擇了文件，也即對應(yīng)的表單項(xiàng)是否有值。選擇了文件時(shí)，它返回false。未選文件時(shí)，它返回true。
原型：public boolean isMissing()
3、getFieldName
作用：取HTML表單中對應(yīng)于此上傳文件的表單項(xiàng)的名字。
原型：public String getFieldName()
4、getFileName
作用：取文件名（不含目錄信息）
原型：public String getFileName()
5、getFilePathName
作用：取文件全名（帶目錄）
原型：public String getFilePathName
6、getFileExt
作用：取文件擴(kuò)展名（后綴）
原型：public String getFileExt()
7、getSize
作用：取文件長度（以字節(jié)計(jì)）
原型：public int getSize()
8、getBinaryData
作用：取文件數(shù)據(jù)中指定位移處的一個(gè)字節(jié)，用于檢測文件等處理。
原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之間。
（二）Files類
這個(gè)類表示所有上傳文件的集合，通過它可以得到上傳文件的數(shù)目、大小等信息。有以下方法：
1、getCount
作用：取得上傳文件的數(shù)目。
原型：public int getCount()
2、getFile
作用：取得指定位移處的文件對象File（這是com.jspsmart.upload.File，不是java.io.File，注意區(qū)分）。
原型：public File getFile(int index)。其中，index為指定位移，其值在0到getCount()-1之間。
3、getSize
作用：取得上傳文件的總長度，可用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public long getSize()
4、getCollection
作用：將所有上傳文件對象以Collection的形式返回，以便其它應(yīng)用程序引用，瀏覽上傳文件信息。
原型：public Collection getCollection()
5、getEnumeration
作用：將所有上傳文件對象以Enumeration（枚舉）的形式返回，以便其它應(yīng)用程序?yàn)g覽上傳文件信息。
原型：public Enumeration getEnumeration()
（三）Request類
這個(gè)類的功能等同于JSP內(nèi)置的對象request。只所以提供這個(gè)類，是因?yàn)閷τ谖募蟼鞅韱?，通過request對象無法獲得表單項(xiàng)的值，必須通過jspSmartUpload組件提供的Request對象來獲取。該類提供如下方法：
1、getParameter
作用：獲取指定參數(shù)之值。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String getParameter(String name)。其中，name為參數(shù)的名字。
2、getParameterValues
作用：當(dāng)一個(gè)參數(shù)可以有多個(gè)值時(shí)，用此方法來取其值。它返回的是一個(gè)字符串?dāng)?shù)組。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String[] getParameterValues(String name)。其中，name為參數(shù)的名字。
3、getParameterNames
作用：取得Request對象中所有參數(shù)的名字，用于遍歷所有參數(shù)。它返回的是一個(gè)枚舉型的對象。
原型：public Enumeration getParameterNames()
在使用表單傳送數(shù)據(jù)的時(shí)候，如果form加了enctype="multipart/form-data"這個(gè)屬性（此時(shí)上傳的是二進(jìn)制數(shù)據(jù)），那么表單請求傳到另一個(gè)jsp或servlet里時(shí)，是不能用request.getParameter()來獲取到各個(gè)表單元素的值的。
取表單值加入數(shù)據(jù)庫時(shí)，用到下面的：
SmartUpload su = new SmartUpload();//新建一個(gè)SmartUpload對象
su.getRequest().getParameterValues();//取數(shù)組值
su.getRequest().getParameter();//取單個(gè)參數(shù)單個(gè)值
特別說明：用于接收表單參數(shù)的語句一定要放在su.upload();語句的后面，也就是說要在文件上傳后再接收，否則不管你怎么試接收到的結(jié)果總是"null"。
當(dāng)采用get方式傳遞數(shù)值，須用request.getParameter()取值，若沿用su.getRequest().getParameter();，則接收結(jié)果為"null"。
注意：參數(shù)為漢字時(shí)編碼格式必須為"gb2312"或"utf-8"。
（四）SmartUpload類這個(gè)類完成上傳下載工作。
A．上傳與下載共用的方法：
只有一個(gè)：initialize。
作用：執(zhí)行上傳下載的初始化工作，必須第一個(gè)執(zhí)行。
原型：有多個(gè)，主要使用下面這個(gè)：
public final void initialize(javax.servlet.jsp.PageContext pageContext)
其中，pageContext為JSP頁面內(nèi)置對象（頁面上下文）。
B．上傳文件使用的方法：
1、upload
作用：上傳文件數(shù)據(jù)。對于上傳操作，第一步執(zhí)行initialize方法，第二步就要執(zhí)行這個(gè)方法。
原型：public void upload()
2、save
作用：將全部上傳文件保存到指定目錄下，并返回保存的文件個(gè)數(shù)。
原型：public int save(String destPathName)
和public int save(String destPathName,int option)
其中，destPathName為文件保存目錄，option為保存選項(xiàng)，它有三個(gè)值，分別是SAVE_PHYSICAL,SAVE_VIRTUAL和SAVE_AUTO。（同File類的saveAs方法的選項(xiàng)之值類似）SAVE_PHYSICAL指示組件將文件保存到以操作系統(tǒng)根目錄為文件根目錄的目錄下，SAVE_VIRTUAL指示組件將文件保存到以Web應(yīng)用程序根目錄為文件根目錄的目錄下，而SAVE_AUTO則表示由組件自動(dòng)選擇。
注：save(destPathName)作用等同于save(destPathName,SAVE_AUTO)。
3、getSize
作用：取上傳文件數(shù)據(jù)的總長度
原型：public int getSize()
4、getFiles
作用：取全部上傳文件，以Files對象形式返回，可以利用Files類的操作方法來獲得上傳文件的數(shù)目等信息。
原型：public Files getFiles()
5、getRequest
作用：取得Request對象，以便由此對象獲得上傳表單參數(shù)之值。
原型：public Request getRequest()
6、setAllowedFilesList
作用：設(shè)定允許上傳帶有指定擴(kuò)展名的文件，當(dāng)上傳過程中有文件名不允許時(shí)，組件將拋出異常。
原型：public void setAllowedFilesList(String allowedFilesList)
其中，allowedFilesList為允許上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號分隔。如果想允許上傳那些沒有擴(kuò)展名的文件，可以用兩個(gè)逗號表示。例如：setAllowedFilesList("doc,txt,,")將允許上傳帶doc和txt擴(kuò)展名的文件以及沒有擴(kuò)展名的文件。
7、setDeniedFilesList
作用：用于限制上傳那些帶有指定擴(kuò)展名的文件。若有文件擴(kuò)展名被限制，則上傳時(shí)組件將拋出異常。
原型：public void setDeniedFilesList(String deniedFilesList)
其中，deniedFilesList為禁止上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號分隔。如果想禁止上傳那些沒有擴(kuò)展名的文件，可以用兩個(gè)逗號來表示。例如：setDeniedFilesList("exe,bat,,")將禁止上傳帶exe和bat擴(kuò)展名的文件以及沒有擴(kuò)展名的文件。
8、setMaxFileSize
作用：設(shè)定每個(gè)文件允許上傳的最大長度。
原型：public void setMaxFileSize(long maxFileSize)
其中，maxFileSize為為每個(gè)文件允許上傳的最大長度，當(dāng)文件超出此長度時(shí)，將不被上傳。
9、setTotalMaxFileSize
作用：設(shè)定允許上傳的文件的總長度，用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public void setTotalMaxFileSize(long totalMaxFileSize)
其中，totalMaxFileSize為允許上傳的文件的總長度。
1、setContentDisposition
作用：將數(shù)據(jù)追加到MIME文件頭的CONTENT-DISPOSITION域。jspSmartUpload組件會(huì)在返回下載的信息時(shí)自動(dòng)填寫MIME文件頭的CONTENT-DISPOSITION域，如果用戶需要添加額外信息，請用此方法。
原型：public void setContentDisposition(String contentDisposition)
其中，contentDisposition為要添加的數(shù)據(jù)。如果contentDisposition為null，則組件將自動(dòng)添加"attachment;"，以表明將下載的文件作為附件，結(jié)果是IE瀏覽器將會(huì)提示另存文件，而不是自動(dòng)打開這個(gè)文件（IE瀏覽器一般根據(jù)下載的文件擴(kuò)展名決定執(zhí)行什么操作，擴(kuò)展名為doc的將用word程序打開，擴(kuò)展名為pdf的將用acrobat程序打開，等等）。
2、downloadFile
作用：下載文件。
原型：共有以下三個(gè)原型可用，第一個(gè)最常用，后兩個(gè)用于特殊情況下的文件下載（如更改內(nèi)容類型，更改另存的文件名）。
① public void downloadFile(String sourceFilePathName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）
② public void downloadFile(String sourceFilePathName,String contentType)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(shí)別）。
③ public void downloadFile(String sourceFilePathName,String contentType,String destFileName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(shí)別）,destFileName為下載后默認(rèn)的另存文件名。
下載文件，出現(xiàn)getOutputStream() has already been called for this response 錯(cuò)誤
執(zhí)行下載的頁面，在Java腳本范圍外（即<% ... %>之外），不要包含HTML代碼、空格、回車或換行等字符，有的話將不能正確下載。不信的話，可以在上述源碼中%><%之間加入一個(gè)換行符，再下載一下，保證出錯(cuò)。因?yàn)樗绊懥朔祷亟o瀏覽器的數(shù)據(jù)流，導(dǎo)致解析出錯(cuò)。
<%@ page language="java" import="com.jspsmart.upload.*"%><jsp:useBean id="mySmartUpload" scope="page" class="com.jspsmart.upload.SmartUpload" /><%
// Initialization
mySmartUpload.initialize(pageContext);
// Download file
mySmartUpload.downloadFile("/files/wordkey sn.txt");
// With a physical path
// mySmartUpload.downloadFile("c:\temp\sample.zip");
// With options
// mySmartUpload.downloadFile("/upload/sample.zip","application/x-zip-compressed","downloaded.zip")
%>
上面的地方要連著寫，不能有任何的空格。
要是沒有資料，怎么會(huì)想到是這個(gè)原因呢？
當(dāng)然最好成的解決方案是直接把整個(gè)代碼都寫在一行,省得煩.
以下是另外一些從網(wǎng)上DOWN下來的附加文檔：
一、采用RequestDispatcher的方式進(jìn)行
1、web.xml文件中增加
<mime-mapping>
<extension>doc</extension>
<mime-type>application/vnd.ms-word</mime-type>
</mime-mapping>
2、程序如下：
<%@page language="java" import="java.net.*" pageEncoding="gb2312"%>
<%
response.setContentType("application/x-download");//設(shè)置為下載application/x-download
String filenamedownload = "/系統(tǒng)解決方案.doc";//即將下載的文件的相對路徑
String filenamedisplay = "系統(tǒng)解決方案.doc";//下載文件時(shí)顯示的文件保存名稱
filenamedisplay = URLEncoder.encode(filenamedisplay,"UTF-8");
response.addHeader("Content-Disposition","attachment;filename=" + filenamedisplay);
try
{
RequestDispatcher dispatcher = application.getRequestDispatcher(filenamedownload);
if(dispatcher != null)
{
dispatcher.forward(request,response);
}
response.flushBuffer();
}
catch(Exception e)
{
e.printStackTrace();
}
finally
{
}
%>
二、采用文件流輸出的方式下載
1、web.xml文件中增加
<mime-mapping>
<extension>doc</extension>
<mime-type>application/vnd.ms-word</mime-type>
</mime-mapping>
2、程序如下：
<%@page language="java" contentType="application/x-msdownload" import="java.io.*,java.net.*" pageEncoding="gb2312"%><%
//關(guān)于文件下載時(shí)采用文件流輸出的方式處理：
//加上response.reset()，并且所有的％>后面不要換行，包括最后一個(gè)；
//因?yàn)?/span>Application Server在處理編譯jsp時(shí)對于％>和<％之間的內(nèi)容一般是原樣輸出，而且默認(rèn)是PrintWriter，
//而你卻要進(jìn)行流輸出：ServletOutputStream，這樣做相當(dāng)于試圖在Servlet中使用兩種輸出機(jī)制，
//就會(huì)發(fā)生：getOutputStream() has already been called for this response的錯(cuò)誤
//詳細(xì)請見《More Java Pitfill》一書的第二部分 Web層Item 33：試圖在Servlet中使用兩種輸出機(jī)制 270
//而且如果有換行，對于文本文件沒有什么問題，但是對于其它格式，比如AutoCAD、Word、Excel等文件
//下載下來的文件中就會(huì)多出一些換行符0x0d和0x0a，這樣可能導(dǎo)致某些格式的文件無法打開，有些也可以正常打開。
response.reset();//可以加也可以不加
response.setContentType("application/x-download");//設(shè)置為下載application/x-download
// /../../退WEB-INF/classes兩級到應(yīng)用的根目錄下去，注意Tomcat與WebLogic下面這一句得到的路徑不同，WebLogic中路徑最后沒有/
System.out.println(this.getClass().getClassLoader().getResource("/").getPath());
String filenamedownload = this.getClass().getClassLoader().getResource("/").getPath() + "/../../系統(tǒng)解決方案.doc";
String filenamedisplay = "系統(tǒng)解決方案.doc";//系統(tǒng)解決方案.txt
filenamedisplay = URLEncoder.encode(filenamedisplay,"UTF-8");
response.addHeader("Content-Disposition","attachment;filename=" + filenamedisplay);
OutputStream output = null;
FileInputStream fis = null;
try
{
output = response.getOutputStream();
fis = new FileInputStream(filenamedownload);
byte[] b = new byte[1024];
int i = 0;
while((i = fis.read(b)) > 0)
{
output.write(b, 0, i);
}
output.flush();
}
catch(Exception e)
{
System.out.println("Error!");
e.printStackTrace();
}
finally
{
if(fis != null)
{
fis.close();
fis = null;
}
if(output != null)
{
output.close();
output = null;
}
}
%>
轉(zhuǎn)載于 http://www.tkk7.com/DreamAngel/archive/2012/08/30/386613.html