语源科技BlogJava-Thinking in Manito

SmartUpload 中文API帮助

廖海瀛 — Tue, 22 Nov 2005 12:11:00 GMT

㈠ 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:\upload\sample.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)。

建议：对于Web程序的开发来说，最好使用SAVEAS_VIRTUAL，以便移植。

2、isMissing

作用：这个方法用于判断用户是否选择了文件，也即对应的表单项是否有值。选择了文件时，它返回false。未选文件时，它返回true。

原型：public boolean isMissing()

3、getFieldName

作用：取HTML表单中对应于此上传文件的表单项的名字。

原型：public String getFieldName()

4、getFileName

作用：取文件名（不含目录信息）

原型：public String getFileName()

5、getFilePathName

作用：取文件全名（带目录）

原型：public String getFilePathName

6、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。

作用：执行上传下载的初始化工作，必须第一个执行。

原型：有多个，主要使用下面这个：

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

作用：设定允许上传的文件的总长度，用于限制一次性上传的数据量大小。

原型：public void setTotalMaxFileSize(long totalMaxFileSize)

其中，totalMaxFileSize为允许上传的文件的总长度。

C．下载文件常用的方法

1、setContentDisposition

作用：将数据追加到MIME文件头的CONTENT-DISPOSITION域。jspSmartUpload组件会在返回下载的信息时自动填写MIME文件头的CONTENT-DISPOSITION域，如果用户需要添加额外信息，请用此方法。

原型：public void setContentDisposition(String contentDisposition)

其中，contentDisposition为要添加的数据。如果contentDisposition为null，则组件将自动添加"attachment;"，以表明将下载的文件作为附件，结果是IE浏览器将会提示另存文件，而不是自动打开这个文件（IE浏览器一般根据下载的文件扩展名决定执行什么操作，扩展名为doc的将用word程序打开，扩展名为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为下载后默认的另存文件名。

廖海瀛 2005-11-22 20:11 发表评论

JSP生成彩色验证码的源码

廖海瀛 — Fri, 18 Nov 2005 12:43:00 GMT

产生验证码图片的文件-----image.jsp

<%@ page contentType="image/jpeg" import="java.awt.*,java.awt.image.*,java.util.*,javax.imageio.*" %>
<%!
Color getRandColor(int fc,int bc){//给定范围获得随机颜色
        Random random = new Random();
        if(fc>255) fc=255;
        if(bc>255) bc=255;
        int r=fc+random.nextInt(bc-fc);
        int g=fc+random.nextInt(bc-fc);
        int b=fc+random.nextInt(bc-fc);
        return new Color(r,g,b);
        }
%>
<%
//设置页面不缓存
response.setHeader("Pragma","No-cache");
response.setHeader("Cache-Control","no-cache");
response.setDateHeader("Expires", 0);

// 在内存中创建图象
int width=60, height=20;
BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);

// 获取图形上下文
Graphics g = image.getGraphics();

//生成随机类
Random random = new Random();

// 设定背景色
g.setColor(getRandColor(200,250));
g.fillRect(0, 0, width, height);

//设定字体
g.setFont(new Font("Times New Roman",Font.PLAIN,18));

//画边框
//g.setColor(new Color());
//g.drawRect(0,0,width-1,height-1);

// 随机产生155条干扰线，使图象中的认证码不易被其它程序探测到
g.setColor(getRandColor(160,200));
for (int i=0;i<155;i++)
{
int x = random.nextInt(width);
int y = random.nextInt(height);
int xl = random.nextInt(12);
int yl = random.nextInt(12);
g.drawLine(x,y,x+xl,y+yl);
}

// 取随机产生的认证码(4位数字)
String sRand="";
for (int i=0;i<4;i++){
    String rand=String.valueOf(random.nextInt(10));
    sRand+=rand;
    // 将认证码显示到图象中
    g.setColor(new Color(20+random.nextInt(110),20+random.nextInt(110),20+random.nextInt(110)));//调用函数出来的颜色相同，可能是因为种子太接近，所以只能直接生成
    g.drawString(rand,13*i+6,16);
}

// 将认证码存入SESSION
session.setAttribute("rand",sRand);

// 图象生效
g.dispose();

// 输出图象到页面
ImageIO.write(image, "JPEG", response.getOutputStream());

---------------使用验证码图片的文件---------a.jsp------------------------------------

<%@ page contentType="text/html;charset=gb2312" %>

认证码输入页面

-----------------验证的页面----------check.jsp

<%@ page contentType="text/html; charset=gb2312" language="java" import="java.sql.*" errorPage="" %>

认证码验证页面

<%
String rand = (String)session.getAttribute("rand");
String input = request.getParameter("rand");
%>
系统产生的认证码为： <%= rand %>

您输入的认证码为： <%= input %>

<%
if (rand.equals(input)) {
%>
输入相同，认证成功！
<%
} else {
%>
输入不同，认证失败！
<%
}
%>

廖海瀛 2005-11-18 20:43 发表评论

以前用的一个网站表单字符处理的类

廖海瀛 — Sun, 06 Nov 2005 08:53:00 GMT

public class CodeFilter
{

    public CodeFilter()
    {
    }

    public static String toHtml(String s)
    {
        if(s == null)
        {
            s = "";
            return s;
        } else
        {
            s = Replace(s, "&", "&");
            s = Replace(s, "<", "<");
            s = Replace(s, ">", ">");
            s = Replace(s, "\t", "    ");
            s = Replace(s, "\r\n", "\n");
            s = Replace(s, "\n", "
");
            s = Replace(s, " ", " ");
            s = Replace(s, "'", "'");
            s = Replace(s, "\\", "\");
            return s;
        }
    }

    public static String unHtml(String s)
    {
        s = Replace(s, "<img src='", "        s = Replace(s, "'>", "'>");
        s = Replace(s, "<center>", "

");
        s = Replace(s, "</center>", "");
        return s;
    }

    public static String Replace(String s, String s1, String s2)
    {
        StringBuffer stringbuffer = new StringBuffer();
        int i = s.length();
        int j = s1.length();
        int k;
        int l;
        for(k = 0; (l = s.indexOf(s1, k)) >= 0; k = l + j)
        {
            stringbuffer.append(s.substring(k, l));
            stringbuffer.append(s2);
        }

        if(k < i)
            stringbuffer.append(s.substring(k));
        return stringbuffer.toString();
    }
}

廖海瀛 2005-11-06 16:53 发表评论

jsp图像处理 X11错解决方法

廖海瀛 — Sun, 06 Nov 2005 08:22:00 GMT

当在linux服务器上没有装xwindows时,处理图像时会报
java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.这个错.

解决方法:

在tomcat的catalina.sh文件中找到
# ----- Execute The Requested Command -----------------------------------------
echo "Using CATALINA_BASE: $CATALINA_BASE"
echo "Using CATALINA_HOME: $CATALINA_HOME"
echo "Using CATALINA_TMPDIR: $CATALINA_TMPDIR"
echo "Using JAVA_HOME: $JAVA_HOME"
加入
JAVA_OPTS="-Djava.awt.headless=true "

就能解决问题.

廖海瀛 2005-11-06 16:22 发表评论

关于极限编程，理论与实践的结合！

廖海瀛 — Sun, 06 Nov 2005 08:05:00 GMT

极限编程（XP）是一种轻量级的软件开发方法论，XP从实践中来，是对实践的总结，也是经过实践检验的，其主要特征是要适应环境变化和需求变化，充分发挥开发人员的主动精神。XP承诺降低软件项目风险，改善业务变化的反应能力，提高开发期间的生产力，为软件开发过程增加乐趣，相信这些足以吸引每个人的眼球。在XP的项目开发中，首先引入了四个变量：成本、时间、质量和范围，通过研究变量之间的相互作用，将项目开发分析的更加透彻，成功讲述一个项目成功的原则。为了能成功地实施XP，XP制定四个准则：沟通、简单、反馈和勇气，和十二条原则：计划游戏、小版本、隐喻、简单设计、测试、重构、结队编程、代码集体所有、持续集成、每周工作40小时、现场客户、编码标准，以及对开发人员的工作要求：编码、测试、倾听和设计。XP是一个非常庞大的知识库，每一项都是一门值得深究的学问。提出这些要求和原则后，XP有提出了一系列的解决方案，也就是策略，其中包含：管理策略、设施策略、计划策略、开发策略、设计策略和测试策略。在真正去实现XP时，XP又提供了将策略成功应用的实践。可以说XP为你的软件开发的指导老师。
XP是从实践中来的，应此有好多人围绕XP发表了一些自己的实践经验，其中主要包括：测试驱动开发、结队编程、重构和极限编程工具。在这里我们想阐述一下关于极限编程Java工具的应用，主要包含Ant，Junit和IntelliJ，其中IntelliJ包含对Ant和Junit的支持，还包含了对重构的出色支持，再加上众多的个性化定制，相信精通这款对你的编码有很大的帮助。

廖海瀛 2005-11-06 16:05 发表评论

关于易语言

廖海瀛 — Sun, 06 Nov 2005 06:14:00 GMT

好久没有更新过自己的BLOG了！最近看朋友在使用一种中文编程语言，觉得挺有意思的！便也拿来玩玩！感觉和VB的语法结构差不多，对MYSQL数据库的支持挺强大的，用来写些简单的网站后台挺实用的！开发周期也大大的缩短了，我想用来开发一些小程序应该也是挺不错的一个东西！

廖海瀛 2005-11-06 14:14 发表评论

谈鬼神与对象！（一）

廖海瀛 — Fri, 17 Jun 2005 14:08:00 GMT

        今天和同事在上班的时候，无意间谈起中学时小女生们常玩的“笔仙”、“银仙”和“碟仙”等较“灵异”的一些东西。偶然大感兴趣，也许是遇到一个未知的领域而特别稀奇，本想让公司里一位较为“通灵”的MM带我玩玩，也见识下这些传说中的未知物，但MM似乎挺忌讳的跟我说这些东西很“邪”，说什么也不肯带我玩，但好奇心的驱使，我还是忍不住在Google上搜索了半天，终于让找到了些资料！
        鬼啊，神啊，究竟真的存在吗？如果他们存在，他们又是以何种形态存在的呢？这个世界存在的灵异传闻是真的吗？究竟这些匪夷所思的“奇迹”是如何产生的呢？偶然见，我突想到，鬼神不一直都是被人们抽象化的一种事物吗？而我们现在所接触到的所有程序语言不也都提供着抽象化机制。于是乎，我便尝试着用面向对象的思想来解释这一切的“不可思议”！

        未完待续……

廖海瀛 2005-06-17 22:08 发表评论

系统产生的认证码：
输入上面的认证码：