安裝篇jspSmartUpload是由www.jspsmart.com網(wǎng)站開(kāi)發(fā)的一個(gè)可免費(fèi)使用的全功能的文件上傳下載組件，適于嵌入執(zhí)行上傳下載操作的JSP文件中。該組件有以下幾個(gè)特點(diǎn)：
1、使用簡(jiǎn)單。在JSP文件中僅僅書(shū)寫(xiě)三五行JAVA代碼就可以搞定文件的上傳或下載，方便。
2、能全程控制上傳。利用jspSmartUpload組件提供的對(duì)象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類(lèi)型，擴(kuò)展名，文件數(shù)據(jù)等），方便存取。
3、能對(duì)上傳的文件在大小、類(lèi)型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫(xiě)兩行代碼，就能把Web服務(wù)器變成文件服務(wù)器。不管文件在Web服務(wù)器的目錄下或在其它任何目錄下，都可以利用jspSmartUpload進(jìn)行下載。
5、能將文件上傳到數(shù)據(jù)庫(kù)中，也能將數(shù)據(jù)庫(kù)中的數(shù)據(jù)下載下來(lái)。這種功能針對(duì)的是MYSQL數(shù)據(jù)庫(kù)，因?yàn)椴痪哂型ㄓ眯裕员疚牟粶?zhǔn)備舉例介紹這種用法。
jspSmartUpload組件可以從www.jspsmart.com網(wǎng)站上自由下載，壓縮包的名字是jspSmartUpload.zip。下載后，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下（本文以Tomcat服務(wù)器為例進(jìn)行介紹）。解壓后，將webapps/jspsmartupload目錄下的子目錄Web-inf名字改為全大寫(xiě)的WEB-INF，這樣一改jspSmartUpload類(lèi)才能使用。因?yàn)?/span>Tomcat對(duì)文件名大小寫(xiě)敏感，它要求Web應(yīng)用程序相關(guān)的類(lèi)所在目錄為WEB-INF，且必須是大寫(xiě)。接著重新啟動(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（也可以打開(kāi)資源管理器，切換到當(dāng)前目錄，用WinZip將com目錄下的所有文件壓縮成jspSmartUpload.zip，然后將jspSmartUpload.zip換名為jspSmartUpload.jar文件即可。）
3．將jspSmartUpload.jar拷貝到Tomcat的shared/lib目錄下。
文件上傳篇
（一）表單要求
對(duì)于上傳文件的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、上傳頁(yè)面upload.html
本頁(yè)面提供表單，讓用戶(hù)選擇要上傳的文件，點(diǎn)擊"上傳"按鈕執(zhí)行上傳操作。
頁(yè)面源碼如下：
<!--
文件名：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、上傳處理頁(yè)面do_upload.jsp
本頁(yè)面執(zhí)行文件上傳操作。頁(yè)面源碼中詳細(xì)介紹了上傳方法的用法，在此不贅述了。
頁(yè)面源碼如下：
<%--
文件名：do_upload.jsp
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
--%>
<%@ page contentType="text/html; charset=gb2312" language="java" import="java.util.*,com.jspsmart.upload.*" errorPage="" %>
<html>
<head>
<title>文件上傳處理頁(yè)面</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<%
// 新建一個(gè)SmartUpload對(duì)象
SmartUpload su = new SmartUpload();
// 上傳初始化
su.initialize(pageContext);
// 設(shè)定上傳限制
// 1.限制每個(gè)上傳文件的最大長(zhǎng)度。
// su.setMaxFileSize(10000);
// 2.限制總上傳數(shù)據(jù)的長(zhǎng)度。
// su.setTotalMaxFileSize(20000);
// 3.設(shè)定允許上傳的文件（通過(guò)擴(kuò)展名限制），僅允許doc,txt文件。
// su.setAllowedFilesList("doc,txt");
// 4.設(shè)定禁止上傳的文件（通過(guò)擴(kuò)展名限制），禁止上傳帶有exe,bat, jsp,htm,html擴(kuò)展名的文件和沒(méi)有擴(kuò)展名的文件。
// su.setDeniedFilesList("exe,bat,jsp,htm,html,,");
// 上傳文件
su.upload();
// 將上傳文件全部保存到指定目錄
int count = su.save("/upload");
out.println(count+"個(gè)文件上傳成功！<br>");
// 利用Request對(duì)象獲取參數(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>文件長(zhǎng)度（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、下載鏈接頁(yè)面download.html
頁(yè)面源碼如下：
<!--
文件名：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、下載處理頁(yè)面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload組件來(lái)下載文件，從下面的源碼中就可以看到，下載何其簡(jiǎn)單。
源碼如下：
<%@ page contentType="text/html;charset=gb2312" import="com.jspsmart.upload.*" %>
<%
// 新建一個(gè)SmartUpload對(duì)象
SmartUpload su = new SmartUpload();
// 初始化
su.initialize(pageContext);
// 設(shè)定contentDisposition為null以禁止瀏覽器自動(dòng)打開(kāi)文件，
// 保證點(diǎn)擊鏈接后是下載文件。若不設(shè)定，則下載的文件擴(kuò)展名為
// doc時(shí)，瀏覽器將自動(dòng)用word打開(kāi)它。擴(kuò)展名為pdf時(shí)，
// 瀏覽器將用acrobat打開(kāi)。
su.setContentDisposition(null);
// 下載文件
su.downloadFile("/upload/如何賺取我的第一桶金.doc");
%>
注意，執(zhí)行下載的頁(yè)面，在Java腳本范圍外（即<% ... %>之外），不要包含HTML代碼、空格、回車(chē)或換行等字符，有的話(huà)將不能正確下載。不信的話(huà)，可以在上述源碼中%><%之間加入一個(gè)換行符，再下載一下，保證出錯(cuò)。因?yàn)樗绊懥朔祷亟o瀏覽器的數(shù)據(jù)流，導(dǎo)致解析出錯(cuò)。
文件上傳篇之中文亂碼
1、當(dāng)頁(yè)面上傳有參數(shù)時(shí)，中文會(huì)亂碼，解決頁(yè)面上中文參數(shù)亂碼方法：
修改類(lèi)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
{
/**
*原來(lái)的代碼，當(dāng)頁(yè)面上要傳入中文參數(shù)時(shí)，亂碼。
*/
// String s11 = new String(m_binArray, m_startData, (m_endData - m_startData) + 1);
/**
*2008-10-28 carton修改，解決頁(yè)面?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í)，解決中文亂碼
修改類(lèi)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修改，解決上傳文件中文亂碼問(wèn)題
*/
String s = null;
try {
s = new String(m_binArray,i,(j - i) + 1, "utf-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return s;
}
這樣頁(yè)面上就不用再轉(zhuǎn)碼了。頁(yè)面設(shè)置成"utf-8"編碼即可。
文件下載篇之中文下載
jspSmartUpload雖然能下載文件，但對(duì)中文支持不足。若下載的文件名中有漢字，則瀏覽器在提示另存的文件名時(shí)，顯示的是一堆亂碼，很掃人興。上面的例子就是這樣。（這個(gè)問(wèn)題也是眾多下載組件所存在的問(wèn)題，很少有人解決，搜索不到相關(guān)資料，可嘆！）
為了給jspSmartUpload組件增加下載中文文件的支持，我對(duì)該組件進(jìn)行了研究，發(fā)現(xiàn)對(duì)返回給瀏覽器的另存文件名進(jìn)行UTF-8編碼后，瀏覽器便能正確顯示中文名字了。這是一個(gè)令人高興的發(fā)現(xiàn)。
首先，用jad將jspSmartUpload.jar反編譯為java文件；
然后在SmartUpload類(lèi)的開(kāi)始處添加代碼：import java.io.File;（這一點(diǎn)很重要）；
最后，再對(duì)jspSmartUpload組件的SmartUpload類(lèi)做升級(jí)處理，增加了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組件對(duì)返回的文件未作任何處理，現(xiàn)在做了編碼的轉(zhuǎn)換工作，將文件名轉(zhuǎn)換為UTF-8形式的編碼形式。UTF-8編碼對(duì)英文未作任何處理，對(duì)中文則需要轉(zhuǎn)換為％XX的形式。toUtf8String方法中，直接利用Java語(yǔ)言提供的編碼轉(zhuǎn)換方法獲得漢字字符的UTF-8編碼，之后將其轉(zhuǎn)換為％XX的形式。
將源碼編譯后打包成jspSmartUpload.jar，拷貝到Tomcat的shared/lib目錄下（可為所有WEB應(yīng)用程序所共享），然后重啟Tomcat服務(wù)器就可以正常下載含有中文名字的文件了。另，toUtf8String方法也可用于轉(zhuǎn)換含有中文的超級(jí)鏈接，以保證鏈接的有效，因?yàn)橛械?/span>WEB服務(wù)器不支持中文鏈接。
相關(guān)類(lèi)說(shuō)明篇
（一）File類(lèi)
這個(gè)類(lèi)包裝了一個(gè)上傳文件的所有信息。通過(guò)它，可以得到上傳文件的文件名、文件大小、擴(kuò)展名、文件數(shù)據(jù)等信息。
File類(lèi)主要提供以下方法：
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盤(pán)，則另存的文件名實(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)。
建議：對(duì)于Web程序的開(kāi)發(fā)來(lái)說(shuō)，最好使用SAVEAS_VIRTUAL，以便移植。
2、isMissing
作用：這個(gè)方法用于判斷用戶(hù)是否選擇了文件，也即對(duì)應(yīng)的表單項(xiàng)是否有值。選擇了文件時(shí)，它返回false。未選文件時(shí)，它返回true。
原型：public boolean isMissing()
3、getFieldName
作用：取HTML表單中對(duì)應(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
作用：取文件長(zhǎng)度（以字節(jié)計(jì)）
原型：public int getSize()
8、getBinaryData
作用：取文件數(shù)據(jù)中指定位移處的一個(gè)字節(jié)，用于檢測(cè)文件等處理。
原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之間。
（二）Files類(lèi)
這個(gè)類(lèi)表示所有上傳文件的集合，通過(guò)它可以得到上傳文件的數(shù)目、大小等信息。有以下方法：
1、getCount
作用：取得上傳文件的數(shù)目。
原型：public int getCount()
2、getFile
作用：取得指定位移處的文件對(duì)象File（這是com.jspsmart.upload.File，不是java.io.File，注意區(qū)分）。
原型：public File getFile(int index)。其中，index為指定位移，其值在0到getCount()-1之間。
3、getSize
作用：取得上傳文件的總長(zhǎng)度，可用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public long getSize()
4、getCollection
作用：將所有上傳文件對(duì)象以Collection的形式返回，以便其它應(yīng)用程序引用，瀏覽上傳文件信息。
原型：public Collection getCollection()
5、getEnumeration
作用：將所有上傳文件對(duì)象以Enumeration（枚舉）的形式返回，以便其它應(yīng)用程序?yàn)g覽上傳文件信息。
原型：public Enumeration getEnumeration()
（三）Request類(lèi)
這個(gè)類(lèi)的功能等同于JSP內(nèi)置的對(duì)象request。只所以提供這個(gè)類(lèi)，是因?yàn)閷?duì)于文件上傳表單，通過(guò)request對(duì)象無(wú)法獲得表單項(xiàng)的值，必須通過(guò)jspSmartUpload組件提供的Request對(duì)象來(lái)獲取。該類(lèi)提供如下方法：
1、getParameter
作用：獲取指定參數(shù)之值。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String getParameter(String name)。其中，name為參數(shù)的名字。
2、getParameterValues
作用：當(dāng)一個(gè)參數(shù)可以有多個(gè)值時(shí)，用此方法來(lái)取其值。它返回的是一個(gè)字符串?dāng)?shù)組。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String[] getParameterValues(String name)。其中，name為參數(shù)的名字。
3、getParameterNames
作用：取得Request對(duì)象中所有參數(shù)的名字，用于遍歷所有參數(shù)。它返回的是一個(gè)枚舉型的對(duì)象。
原型：public Enumeration getParameterNames()
在使用表單傳送數(shù)據(jù)的時(shí)候，如果form加了enctype="multipart/form-data"這個(gè)屬性（此時(shí)上傳的是二進(jìn)制數(shù)據(jù)），那么表單請(qǐng)求傳到另一個(gè)jsp或servlet里時(shí)，是不能用request.getParameter()來(lái)獲取到各個(gè)表單元素的值的。
取表單值加入數(shù)據(jù)庫(kù)時(shí)，用到下面的：
SmartUpload su = new SmartUpload();//新建一個(gè)SmartUpload對(duì)象
su.getRequest().getParameterValues();//取數(shù)組值
su.getRequest().getParameter();//取單個(gè)參數(shù)單個(gè)值
特別說(shuō)明：用于接收表單參數(shù)的語(yǔ)句一定要放在su.upload();語(yǔ)句的后面，也就是說(shuō)要在文件上傳后再接收，否則不管你怎么試接收到的結(jié)果總是"null"。
當(dāng)采用get方式傳遞數(shù)值，須用request.getParameter()取值，若沿用su.getRequest().getParameter();，則接收結(jié)果為"null"。
注意：參數(shù)為漢字時(shí)編碼格式必須為"gb2312"或"utf-8"。
（四）SmartUpload類(lèi)這個(gè)類(lèi)完成上傳下載工作。
A．上傳與下載共用的方法：
只有一個(gè)：initialize。
作用：執(zhí)行上傳下載的初始化工作，必須第一個(gè)執(zhí)行。
原型：有多個(gè)，主要使用下面這個(gè)：
public final void initialize(javax.servlet.jsp.PageContext pageContext)
其中，pageContext為JSP頁(yè)面內(nèi)置對(duì)象（頁(yè)面上下文）。
B．上傳文件使用的方法：
1、upload
作用：上傳文件數(shù)據(jù)。對(duì)于上傳操作，第一步執(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類(lèi)的saveAs方法的選項(xiàng)之值類(lèi)似）SAVE_PHYSICAL指示組件將文件保存到以操作系統(tǒng)根目錄為文件根目錄的目錄下，SAVE_VIRTUAL指示組件將文件保存到以Web應(yīng)用程序根目錄為文件根目錄的目錄下，而SAVE_AUTO則表示由組件自動(dòng)選擇。
注：save(destPathName)作用等同于save(destPathName,SAVE_AUTO)。
3、getSize
作用：取上傳文件數(shù)據(jù)的總長(zhǎng)度
原型：public int getSize()
4、getFiles
作用：取全部上傳文件，以Files對(duì)象形式返回，可以利用Files類(lèi)的操作方法來(lái)獲得上傳文件的數(shù)目等信息。
原型：public Files getFiles()
5、getRequest
作用：取得Request對(duì)象，以便由此對(duì)象獲得上傳表單參數(shù)之值。
原型：public Request getRequest()
6、setAllowedFilesList
作用：設(shè)定允許上傳帶有指定擴(kuò)展名的文件，當(dāng)上傳過(guò)程中有文件名不允許時(shí)，組件將拋出異常。
原型：public void setAllowedFilesList(String allowedFilesList)
其中，allowedFilesList為允許上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號(hào)分隔。如果想允許上傳那些沒(méi)有擴(kuò)展名的文件，可以用兩個(gè)逗號(hào)表示。例如：setAllowedFilesList("doc,txt,,")將允許上傳帶doc和txt擴(kuò)展名的文件以及沒(méi)有擴(kuò)展名的文件。
7、setDeniedFilesList
作用：用于限制上傳那些帶有指定擴(kuò)展名的文件。若有文件擴(kuò)展名被限制，則上傳時(shí)組件將拋出異常。
原型：public void setDeniedFilesList(String deniedFilesList)
其中，deniedFilesList為禁止上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號(hào)分隔。如果想禁止上傳那些沒(méi)有擴(kuò)展名的文件，可以用兩個(gè)逗號(hào)來(lái)表示。例如：setDeniedFilesList("exe,bat,,")將禁止上傳帶exe和bat擴(kuò)展名的文件以及沒(méi)有擴(kuò)展名的文件。
8、setMaxFileSize
作用：設(shè)定每個(gè)文件允許上傳的最大長(zhǎng)度。
原型：public void setMaxFileSize(long maxFileSize)
其中，maxFileSize為為每個(gè)文件允許上傳的最大長(zhǎng)度，當(dāng)文件超出此長(zhǎng)度時(shí)，將不被上傳。
9、setTotalMaxFileSize
作用：設(shè)定允許上傳的文件的總長(zhǎng)度，用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public void setTotalMaxFileSize(long totalMaxFileSize)
其中，totalMaxFileSize為允許上傳的文件的總長(zhǎng)度。
1、setContentDisposition
作用：將數(shù)據(jù)追加到MIME文件頭的CONTENT-DISPOSITION域。jspSmartUpload組件會(huì)在返回下載的信息時(shí)自動(dòng)填寫(xiě)MIME文件頭的CONTENT-DISPOSITION域，如果用戶(hù)需要添加額外信息，請(qǐng)用此方法。
原型：public void setContentDisposition(String contentDisposition)
其中，contentDisposition為要添加的數(shù)據(jù)。如果contentDisposition為null，則組件將自動(dòng)添加"attachment;"，以表明將下載的文件作為附件，結(jié)果是IE瀏覽器將會(huì)提示另存文件，而不是自動(dòng)打開(kāi)這個(gè)文件（IE瀏覽器一般根據(jù)下載的文件擴(kuò)展名決定執(zhí)行什么操作，擴(kuò)展名為doc的將用word程序打開(kāi)，擴(kuò)展名為pdf的將用acrobat程序打開(kāi)，等等）。
2、downloadFile
作用：下載文件。
原型：共有以下三個(gè)原型可用，第一個(gè)最常用，后兩個(gè)用于特殊情況下的文件下載（如更改內(nèi)容類(lèi)型，更改另存的文件名）。
① public void downloadFile(String sourceFilePathName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）
② public void downloadFile(String sourceFilePathName,String contentType)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類(lèi)型（MIME格式的文件類(lèi)型信息，可被瀏覽器識(shí)別）。
③ public void downloadFile(String sourceFilePathName,String contentType,String destFileName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類(lèi)型（MIME格式的文件類(lèi)型信息，可被瀏覽器識(shí)別）,destFileName為下載后默認(rèn)的另存文件名。
下載文件，出現(xiàn)getOutputStream() has already been called for this response 錯(cuò)誤
執(zhí)行下載的頁(yè)面，在Java腳本范圍外（即<% ... %>之外），不要包含HTML代碼、空格、回車(chē)或換行等字符，有的話(huà)將不能正確下載。不信的話(huà)，可以在上述源碼中%><%之間加入一個(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")
%>
上面的地方要連著寫(xiě)，不能有任何的空格。
要是沒(méi)有資料，怎么會(huì)想到是這個(gè)原因呢？
當(dāng)然最好成的解決方案是直接把整個(gè)代碼都寫(xiě)在一行,省得煩.
以下是另外一些從網(wǎng)上DOWN下來(lái)的附加文檔：
一、采用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";//即將下載的文件的相對(duì)路徑
String filenamedisplay = "系統(tǒng)解決方案.doc";//下載文件時(shí)顯示的文件保存名稱(chēng)
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í)對(duì)于％>和<％之間的內(nèi)容一般是原樣輸出，而且默認(rèn)是PrintWriter，
//而你卻要進(jìn)行流輸出：ServletOutputStream，這樣做相當(dāng)于試圖在Servlet中使用兩種輸出機(jī)制，
//就會(huì)發(fā)生：getOutputStream() has already been called for this response的錯(cuò)誤
//詳細(xì)請(qǐng)見(jiàn)《More Java Pitfill》一書(shū)的第二部分 Web層Item 33：試圖在Servlet中使用兩種輸出機(jī)制 270
//而且如果有換行，對(duì)于文本文件沒(méi)有什么問(wèn)題，但是對(duì)于其它格式，比如AutoCAD、Word、Excel等文件
//下載下來(lái)的文件中就會(huì)多出一些換行符0x0d和0x0a，這樣可能導(dǎo)致某些格式的文件無(wú)法打開(kāi)，有些也可以正常打開(kāi)。
response.reset();//可以加也可以不加
response.setContentType("application/x-download");//設(shè)置為下載application/x-download
// /../../退WEB-INF/classes兩級(jí)到應(yīng)用的根目錄下去，注意Tomcat與WebLogic下面這一句得到的路徑不同，WebLogic中路徑最后沒(méi)有/
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.aygfsteel.com/DreamAngel/archive/2012/08/30/386613.html