接下来第一步，就是要先定义好一些全局的参数，以便以后更改起来方便，风格
大家自己选择好了，我用的是如下的方式：

(1) 给出项目的目录：
  <!--// project directories //--><property name="dir.project" ="D:/Code/MyProject"/><property name="dir.project.lib" ="${dir.project}/lib"/><property name="dir.project.src" ="${dir.project}/src"/><property name="dir.project.web_module" ="${dir.project}/web"/><property name="dir.project.ejb_module" ="${dir.project}/ejb"/><property name="dir.project.ear_module" ="${dir.project}/ear"/><!--// compile, build and deploy directories //--><property name="dir.project.compile" ="${dir.project}/classes"/><property name="dir.project.compile.jspcache" ="${dir.project.compile}/jspcache"/><property name="dir.project.build" ="${dir.project}/build"/><!--// J2EE Container //--><property name="dir.appserver.tomcat.home" ="D:/J2EE_HOME/AppServer/Tomcat"/><property name="dir.appserver.oc4j.j2ee.home" ="D:/J2EE_HOME/AppServer/OC4J/j2ee/home"/>
 

(2) 定义Java Source的编译选项
<!--// Java compiler options //--> <property name="opt.compile.source" ="1.4"/><property name="opt.compile.target" ="1.4"/><property name="opt.compile.encoding" ="UTF-8"/><property name="opt.compile.deprecation" ="on"/><property name="opt.compile.debug" ="on"/><property name="opt.compile.optimize" ="off"/>
 

(3) 如果需要 import EJB library 的话，给出下面的定义，后面会用到
    <!--// EJB imported resource //--><property name="import.ejb.report.server" ="${dir.project.lib}/Appwork.jar"/>
 

(4) 给出部署WAR/EAR文件的名称：
  <!--// Deployment //--><property name="deploy.file.ejb_module" ="MyApp_EJB.jar" /><property name="deploy.file.web_module" ="MyApp_WEB.war" /><property name="deploy.file.ear_module" ="MyApp.ear" />
 

(5) 给出CLASSPATH的定义，引入相关的Library和项目编译生成的Java Classes
  <path id="CLASSPATH"><!--// Tomcat Libraries //--><fileset dir="${dir.appserver.tomcat.home}/bin"> <include name="*.jar"/></fileset> <fileset dir="${dir.appserver.tomcat.home}/server/lib"> <include name="*.jar"/> </fileset> <fileset dir="${dir.appserver.tomcat.home}/common/lib"> <include name="*.jar"/> </fileset> <!--// Depended Libraries //--><pathelement location="${dir.project.lib}/abc.jar"/><pathelement location="${dir.project.lib}/AppServer.jar"/><pathelement location="${dir.project.lib}/AppServiceClient.jar"/><pathelement location="${dir.project.lib}/AppUtil.jar"/><pathelement location="${dir.project.lib}/xport.jar"/><pathelement location="${dir.project.lib}/jaxen-full.jar"/><pathelement location="${dir.project.lib}/jstl.jar"/><pathelement location="${dir.project.lib}/log4j-1.2.13.jar"/><pathelement location="${dir.project.lib}/ojdbc14.jar"/><pathelement location="${dir.project.lib}/saxpath.jar"/><pathelement location="${dir.project.lib}/standard.jar"/><pathelement location="${dir.project.lib}/taglibs-log.jar"/><!--// Project classes //--><pathelement location="${dir.project.compile}"/></path>
 

(6) 基本的clean和init的task
  <target name="clean"><delete dir="${dir.project.build}"/><delete dir="${dir.project.compile.jspcache}"/><delete dir="${dir.project.compile}"/><delete dir="${dir.project.web_module}/WEB-INF/classes"/><delete dir="${dir.project.web_module}/WEB-INF/lib"/></target><target name="init"><mkdir dir="${dir.project.compile}"/><mkdir dir="${dir.project.compile.jspcache}"/><mkdir dir="${dir.project.web_module}/WEB-INF/classes"/><mkdir dir="${dir.project.web_module}/WEB-INF/lib"/><mkdir dir="${dir.project.build}"/></target>
 

(7) 编译Java Source
<target name="src_compile" depends="init"><!--// compile the Java source //--><javac srcdir="${dir.project.src}" destdir="${dir.project.compile}" encoding="${opt.compile.encoding}" source="${opt.compile.source}" target="${opt.compile.source}" deprecation="${opt.compile.deprecation}"debug="${opt.compile.debug}" optimize="{opt.compile.optimize}" ><classpath refid="CLASSPATH"/><include name="**/*.java"/></javac><!--// copy the classpath resources //--><copy todir="${dir.project.compile}"><fileset dir="${dir.project.src}"><exclude name="**/*.java"/></fileset></copy> </target>
 

(8) 预编译JSP文件，可选择基于Tomcat或是Oracle Application Server
  <!--// for Tomcat //--> <target name="jsp_src_generate" depends="src_compile"><taskdef classname="org.apache.jasper.JspC" name="jasper2"><classpath refid="CLASSPATH"/> </taskdef><jasper2 validateXml="false" verbose="9"uriroot="${dir.project.web_module}" outputDir="${dir.project.compile.jspcache}" webXmlFragment="${dir.project.compile.jspcache}/generated-web.xml" /> </target><target name="jsp_src_compile"><javac srcdir="${dir.project.compile.jspcache}" destdir="${dir.project.compile.jspcache}" encoding="${opt.compile.encoding}" source="${opt.compile.source}" target="${opt.compile.source}" deprecation="${opt.compile.deprecation}"debug="${opt.compile.debug}" optimize="{opt.compile.optimize}" ><classpath refid="CLASSPATH"/><include name="**"/></javac></target><target name="jsp_precompile" depends="src_compile, jsp_src_generate, jsp_src_compile" />
 

 <property name="app.name" ="demo"/>
 <property name="app.dir" location="../WebRoot"/>
 <property name="webserver.home" location="../../../platform/jakarta-tomcat-5.0.19"/>
 <property name="webserver.deploy" location="${webserver.home}/webapps/"/>
 <property name="src.dir" location="../src"/>
 <property name="build.dir" location="${app.dir}/WEB-INF/classes"/>
 <property name="lib.dir" location="${app.dir}/WEB-INF/lib"/>
 <property name="dist.dir" location="../dist"/>
 <property name="properties.dir" location="${src.dir}/com/easydone/struts/ApplicationResources.properties"/>
 <property name="properties_zh.dir" location="${build.dir}/com/easydone/struts/ApplicationResources_zh.properties"/>
 <property name="doc.dir" ="../api"/>
 <property name="packages" ="com.easydone.*"/>
 
 <echo>+--------------------------------------------------+</echo>
 <echo>|                                                  |</echo>
 <echo>|       R U N N I N G   A N T    REPOSITORY        |</echo>
 <echo>|                                                  |</echo>
 <echo>+--------------------------------------------------+</echo>
 <!---Help Information-->
 <target name="usage" >
     <echo message=""/>
     <echo message="-------------------------------------------------------------"/>
     <echo message="操作说明："/>
     <echo message="首先将您编写的java文件拷贝至${src.dir}目录下,按先后顺序执行以下命令既可。"/>
     <echo message="第一步：compile 命令编译*.java"/>
     <echo message="第二步：deploy 命令生成${app.name}.jar文件"/>
     <echo message="第三步：doc 命令生成详细javadoc文档"/>
     <echo message="每一步操作都能看到 BUILD SUCCESSFUL提示后，表示您操作成功！"/>
     <echo message="-------------------------------------------------------------"/>
     <echo message=""/>
 </target>  
  <!-- =================================================================== -->
  <!-- 设置应用环境变量                           -->
  <!-- =================================================================== --> 
 <path id="compile.classpath">
  <pathelement path ="${build.dir}"/>
  <fileset dir="${lib.dir}">
   <include name="**/*.jar"/>
  </fileset>
 </path>
  <!-- =================================================================== -->
  <!-- 格式化中文资源包，解决国际化中文问题                     -->
  <!-- =================================================================== --> 
    <target name="checkToZh">
         <uptodate property="toZh.notRequired"
            srcfile="${properties.dir}"
            targetfile="${properties_zh.dir}"/>
    </target>
    <target name="toZh" depends="checkToZh" unless="toZh.notRequired">
        <delete file="${properties_zh.dir}"/>
        <!-- native2ascii struts.properties -->
        <exec executable="native2ascii">
          <arg line=" ${properties.dir}  ${properties_zh.dir}"/>
        </exec> 
        <echo message="toZh performed!"/>
    </target>
  <!-- =================================================================== -->
  <!-- 初始化创建相关应用目录                             -->
  <!-- =================================================================== -->
    <target name="prepare" deion="create build,dist files">
     <mkdir dir="${build.dir}"/>
     <mkdir dir="${dist.dir}"/>    
    </target>
  <!-- =================================================================== -->
  <!-- 初始化应用程序，删除相关目录                           -->
  <!-- =================================================================== --> 
 <target name="clean" deion="Delete build files">
  <delete dir="${build.dir}"/>
  <delete dir="${dist.dir}"/>
 </target>
 
  <!-- =================================================================== -->
  <!-- compile 命令，执行javac编译命令                          -->
  <!-- =================================================================== --> 
 <target name="compile" depends="prepare">
  <javac srcdir="${src.dir}" destdir="${build.dir}" debug="on">
   <classpath refid="compile.classpath"/>
  </javac>
 </target>
  <!-- =================================================================== -->
  <!-- update命令，编译及处理国际化中文资源文件                        -->
  <!-- =================================================================== -->
 <target name="update" depends="compile,toZh">
  <!--copy classes-->
  <copy todir="${webserver.deploy}/${app.name}/WEB-INF/classes" includeEmptyDirs="no">
   <fileset dir="${build.dir}"/>
  </copy>
  <!--copy pages-->
  <copy todir="${webserver.deploy}/${app.name}" includeEmptyDirs="no">
   <fileset dir="${app.dir}"/>
  </copy>
  <!-- copy libs-->
  <copy todir="${webserver.deploy}/${app.name}/WEB-INF/lib" includeEmptyDirs="no">
   <fileset dir="${lib.dir}"/>
  </copy>
 </target>
  <!-- =================================================================== -->
  <!-- 部署应用程序，依赖于 compile命令clean,prepare,compile,dist          -->
  <!-- =================================================================== -->

// 初始化可以拖拽的Element的函数，与拖拽无关的我去掉了
  draggable(el) {
     // 公用的开始拖拽的函数
     this ._dragStart  =  start_Drag;
     // 公用的正在拖拽的函数
     this ._drag  =  when_Drag;
     // 公用的拖拽结束的函数
     this ._dragEnd  =  end_Drag;
     // 这个函数主要用来进行拖拽结束后的dom处理
     this ._afterDrag  =  after_Drag;
     // 是否正在被拖动，一开始当然没有被拖动
     this .isDragging  =   false ;
     // 将这个Element的this指针注册在elm这个变量里面，方便在自己的上下文以外调用自己的函数等，很常用的方法
     this .elm  =  el;
     // 触发拖拽的Element，在这里就是这个div上显示标题的那个div
     this .header  =  getElementById(el.id  +   " _h " );
     // 对于有i的element拖拽不同，这里检测一下并记录
     this .hasI  =   this .elm.getElementsByTagName( " I " ).length  >   0 ;
     // 如果找到了header就绑定drag相关的event
     if  ( this .header) {
         // 拖拽时的叉子鼠标指针
         this .header.style.cursor  =   " move " ;
         // 将函数绑定到header和element的this上，参照那个函数的说明
        Drag.init( this .header,  this .elm);
         // 下面三个语句将写好的三个函数绑定给这个elemnt的三个函数钩子上，也就实现了element从draggable继承可拖拽的函数
         this .elm.onDragStart  =  Util.bind( this ,  " _dragStart " );
         this .elm.onDrag  =  Util.bind( this ,  " _drag " );
         this .elm.onDragEnd  =  Util.bind( this ,  " _dragEnd " );
    }
};

// 可拖拽Element的原形，用来将event绑定到各个钩子，这部分市比较通用的，netvibes也是基本完全相同的实现
// 这部分推荐看dindin的这个，也会帮助理解，http://www.jroller.com/page/dindin/?anchor=pro_java_12
var  Drag  =  {
     // 对这个element的引用，一次只能拖拽一个Element
    obj: null ,
     // element是被拖拽的对象的引用，elementHeader就是鼠标可以拖拽的区域
    init:   (elementHeader, element) {
         // 将start绑定到down事件，按下鼠标触发start
        elementHeader.down  =  Drag.start;
         // 将element存到header的obj里面，方便header拖拽的时候引用
        elementHeader.obj  =  element;
         // 初始化绝对的坐标，因为不是position=absolute所以不会起什么作用，但是防止后面onDrag的时候parse出错了
         if  (isNaN(parseInt(element.style.left))) {
            element.style.left  =   " 0px " ;
        }
         if  (isNaN(parseInt(element.style.top))) {
            element.style.top  =   " 0px " ;
        }
         // 挂上空，初始化这几个成员，在Drag.init被调用后才帮定到实际的函数，可以参照draggable里面的内容
        element.onDragStart  =   new  ();
        element.onDragEnd  =   new  ();
        element.onDrag  =   new  ();
    },
     // 开始拖拽的绑定，绑定到鼠标的移动的event上
    start:   (event) {
         var  element  =  Drag.obj  =   this .obj;
         // 解决不同浏览器的event模型不同的问题
        event  =  Drag.fixE(event);
         // 看看是不是左键点击
         if  (event.which  !=   1 ) {
             // 除了左键都不起作用
             return   true ;
        }
         // 参照这个函数的解释，挂上开始拖拽的钩子
        element.onDragStart();
         // 记录鼠标坐标
        element.lastMouseX  =  event.clientX;
        element.lastMouseY  =  event.clientY;
         // 将Global的event绑定到被拖动的element上面来
        up  =  Drag.end;
        move  =  Drag.drag;
         return   false ;
    },
     // Element正在被拖动的函数
    drag:   (event) {
         // 解决不同浏览器的event模型不同的问题
        event  =  Drag.fixE(event);
         // 看看是不是左键点击
         if  (event.which  ==   0 ) {
             // 除了左键都不起作用
             return  Drag.end();
        }
         // 正在被拖动的Element
         var  element  =  Drag.obj;
         // 鼠标坐标
         var  _clientX  =  event.clientY;
         var  _clientY  =  event.clientX;
         // 如果鼠标没动就什么都不作
         if  (element.lastMouseX  ==  _clientY  &&  element.lastMouseY  ==  _clientX) {
             return   false ;
        }
         // 刚才Element的坐标
         var  _lastX  =  parseInt(element.style.top);
         var  _lastY  =  parseInt(element.style.left);
         // 新的坐标
         var  newX, newY;
         // 计算新的坐标：原先的坐标+鼠标移动的值差
        newX  =  _lastY  +  _clientY  -  element.lastMouseX;
        newY  =  _lastX  +  _clientX  -  element.lastMouseY;
         // 修改element的显示坐标
        element.style.left  =  newX  +   " px " ;
        element.style.top  =  newY  +   " px " ;
         // 记录element现在的坐标供下一次移动使用
        element.lastMouseX  =  _clientY;
        element.lastMouseY  =  _clientX;
         // 参照这个函数的解释，挂接上Drag时的钩子
        element.onDrag(newX, newY);
         return   false ;
    },
     // Element正在被释放的函数，停止拖拽
    end:   (event) {
         // 解决不同浏览器的event模型不同的问题
        event  =  Drag.fixE(event);
         // 解除对Global的event的绑定
        move  =   null ;
        up  =   null ;
         // 先记录下onDragEnd的钩子，好移除obj
         var  _onDragEndFuc  =  Drag.obj.onDragEnd();
         // 拖拽完毕，obj清空
        Drag.obj  =   null ;
         return  _onDragEndFuc;
    },
     // 解决不同浏览器的event模型不同的问题
    fixE:   (ig_) {
         if  ( typeof  ig_  ==   " undefined " ) {
            ig_  =  event;
        }
         if  ( typeof  ig_.layerX  ==   " undefined " ) {
            ig_.layerX  =  ig_.offsetX;
        }
         if  ( typeof  ig_.layerY  ==   " undefined " ) {
            ig_.layerY  =  ig_.offsetY;
        }
         if  ( typeof  ig_.which  ==   " undefined " ) {
            ig_.which  =  ig_.button;
        }
         return  ig_;
    }
};

// 下面是初始化的函数了，看看上面这些东西怎么被调用
var  _IG_initDrag  =     (el) {
     // column那个容器，在google里面就是那个table布局的tbody，netvibes用的<div>
    Util.rootElement  =  el;
     // 这个tbody的行
    Util._rows  =  Util.rootElement.tBodies[ 0 ].rows[ 0 ];
     // 列，google是3列，其实也可以更多
    Util.column  =  Util._rows.cells;
     // 用来存取可拖拽的对象
    Util.dragArray  =   new  Array();
     var  counter  =   0 ;
     for  ( var  i  =   0 ; i  <  Util.column.length; i ++ ) {
         // 搜索所有的column
         var  ele  =  Util.column[i];
         for  ( var  j  =   0 ; j  <  ele.childNodes.length; j ++ ) {
             // 搜索每一column里面的所有element
             var  ele1  =  ele.childNodes[j];
             // 如果是div就把它初始化为一个draggable对象
             if  (ele1.tagName  ==   " DIV " ) {
                Util.dragArray[counter]  =   new  draggable(ele1);
                counter ++ ;
            }
        }
    }
};

// google的页面里可以拖动的部分的id是"t_1"
// 挂载到，载入完毕执行。不过实际上google没有用。
// 而是写在页面最下面，异曲同工吧，也许直接写在页面是种怪癖，或者也有可能是兼容性考虑。

// 请将下面两条被注释掉的代码加，到你自己下载的一个google ig页面里面，把里面的所有其余删除，挂上这个js也可以拖拽了，哈哈
// _table=getElementById("t_1");
// = _IG_initDrag(_table);

使搜索引搜索蜘蛛的收录由被动变为主动，google Sitemap服务目前尚不提供在线创建Sitemap的功能，但是我们可以借助第三方网站提供的此类服务，打开网站（http://www.xml-sitemaps.com）（如图1） 

在“Starting URL”栏中输入你自己的网站地址，在“Change frequency”下拉列表选择网站的更新频率（经常 每天 每年等不同的时段），在“Last modification”选择最后修改时间（建议选择Use server's response服务器反映时间 ），在“Priority”栏中速入跟新的优先权，最后点击“Start”按钮创建网站地图 （如图0）

完成操作后，我们将在显示的结果中看到各式各样的网站生成地图Sitemap文件，将“Sitemap.xml”下载到本地然后再传到服务器主目录下，下面用Gmail帐户登陆到google Sitemap,添加自己的网站sitemap文件（如图2），再选在添加该站点的sitemap，注意在选择分类的时候选择添加常规网络(如图3)sitemap然后输入刚才上传得那个sitemap.xml地址，各式http://www.6b9g.com/sitemap.xml  再点击“添加普通sitemap” 按钮

首发 高峰 站长互动信息网   http://www.6b9g.com

Introducing FileUpload
The FileUpload component has the capability of simplifying the handling of files uploaded to a server. Note that the FileUpload component is meant for use on the server side; in other words, it handles where the files are being uploaded to—not the client side where the files are uploaded from. Uploading files from an HTML form is pretty simple; however, handling these files when they get to the server is not that simple. If you want to apply any rules and store these files based on those rules, things get more difficult.

The FileUpload component remedies this situation, and in very few lines of code you can easily manage the files uploaded and store them in appropriate locations. You will now see an example where you upload some files first using a standard HTML form and then using HttpClient code.

Using HTML File Upload
The commonly used methodology to upload files is to have an HTML form where you define the files you want to upload. A common example of this HTML interface is the Web page you encounter when you want to attach files to an email while using any of the popular Web mail services.

In this example, you will create a simple HTML page where you provide for three files to be uploaded. Listing 1-1 shows the HTML for this page. Note that the enctype attribute for the form has the multipart/form-data, and the input tag used is of type file. Based on the of the action attribute, on form submission, the data is sent to ProcessFileUpload.jsp.

Listing 1-1. UploadFiles.html
<HTML>
  <HEAD>
    < HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252"/>
    <TITLE>File Upload Page</TITLE>
  </HEAD>
  <BODY>Upload Files
    <FORM name="filesForm" action="ProcessFileUpload.jsp"
    method="post" enctype="multipart/form-data">
        File 1:<input type="file" name="file1"/><br/>
        File 2:<input type="file" name="file2"/><br/>
        File 3:<input type="file" name="file3"/><br/>
        <input type="submit" name="Submit" ="Upload Files"/>
    </FORM>
  </BODY>
</HTML>

You can use a servlet to handle the file upload. I have used JSP to minimize the code you need to write. The task that the JSP has to accomplish is to pick up the files that are sent as part of the request and store these files on the server. In the JSP, instead of displaying the result of the upload in the Web browser, I have chosen to print messages on the server console so that you can use this same JSP when it is not invoked through an HTML form but by using HttpClient-based code.

Listing 1-2 shows the JSP code. Note the code that checks whether the item is a form field. This check is required because the Submit button contents are also sent as part of the request, and you want to distinguish between this data and the files that are part of the request. You have set the maximum file size to 1,000,000 bytes using the setSizeMax method.

Listing 1-2. ProcessFileUpload.jsp
<%@ page contentType="text/html;charset=windows-1252"%>
<%@ page import="org.apache.commons.fileupload.DiskFileUpload"%>
<%@ page import="org.apache.commons.fileupload.FileItem"%>
<%@ page import="jsp servlet ejb .util.List"%>
<%@ page import="jsp servlet ejb .util.Iterator"%>
<%@ page import="jsp servlet ejb .io.File"%>
html>
<head>
< http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Process File Upload</title>
</head>
<%
        System.out.println("Content Type ="+request.getContentType());

        DiskFileUpload fu = new DiskFileUpload();
        // If file size exceeds, a FileUploadException will be thrown
        fu.setSizeMax(1000000);

        List fileItems = fu.parseRequest(request);
        Iterator itr = fileItems.iterator();

        while(itr.hasNext()) {
          FileItem fi = (FileItem)itr.next();

          //Check if not form field so as to only handle the file inputs
          //else condition handles the submit button input
          if(!fi.isFormField()) {
            System.out.println(""nNAME: "+fi.getName());
            System.out.println("SIZE: "+fi.getSize());
            //System.out.println(fi.getOutputStream().toString());
            File fNew= new File(application.getRealPath("/"), fi.getName());

            System.out.println(fNew.getAbsolutePath());
            fi.write(fNew);
          }
          else {
            System.out.println("Field ="+fi.getFieldName());
          }
        }
%>
<body>
Upload Successful!!
</body>
</html>

CAUTION With FileUpload 1.0 I found that when the form was submitted using Opera version 7.11, the getName method of the class FileItem returns just the name of the file. However, if the form is submitted using Internet Explorer 5.5, the filename along with its entire path is returned by the same method. This can cause some problems.

To run this example, you can use any three files, as the contents of the files are not important. Upon submitting the form using Opera and uploading three random XML files, the output I got on the Tomcat server console was as follows:

Content Type =multipart/form-data; boundary=----------rz7ZNYDVpN1To8L73sZ6OE

NAME: academy.xml
SIZE: 951
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"academy.xml

NAME: academyRules.xml
SIZE: 1211
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"academyRules.xml

NAME: students.xml
SIZE: 279
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"students.xml
Field =Submit
However, when submitting this same form using Internet Explorer 5.5, the output on the server console was as follows:
Content Type =multipart/form-data; boundary=---------------------------7d3bb1de0
2e4

NAME: D:"temp"academy.xml
SIZE: 951
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"D:"temp"academy.xml

The browser displayed the following message: “The requested resource (D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"D:"temp"academy.xml (The filename, directory name, or volume label syntax is incorrect)) is not available.”

This contrasting behavior on different browsers can cause problems. One workaround that I found in an article at http://www.onjava.com/pub/a/onjava/2003/06/25/commons.html is to first create a file reference with whatever is supplied by the getName method and then create a new file reference using the name returned by the earlier file reference. Therefore, you can insert the following code to have your code work with both browsers (I wonder who the guilty party is…blaming Microsoft is always the easy way out)

File tempFileRef  = new File(fi.getName());
File fNew = new File(application.getRealPath("/"),tempFileRef.getName());

In this section, you uploaded files using a standard HTML form mechanism. However, often a need arises to be able to upload files from within your jsp servlet ejb code, without any browser or form coming into the picture. In the next section, you will look at HttpClient-based file upload.

Using HttpClient-Based FileUpload
Earlier in the article you saw some of the capabilities of the HttpClient component. One capability I did not cover was its ability to send multipart requests. In this section, you will use this capability to upload a few files to the same JSP that you used for uploads using HTML.

The class org.apache.commons.httpclient.methods.MultipartPostMethod provides the multipart method capability to send multipart-encoded forms, and the package org.apache.commons.httpclient.methods.multipart has the support classes required. Sending a multipart form using HttpClient is quite simple. In the code in Listing 1-3, you send three files to ProcessFileUpload.jsp.

Listing 1-3. HttpMultiPartFileUpload.java
package com.commonsbook.chap9;
import jsp servlet ejb .io.File;
import jsp servlet ejb .io.IOException;

import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.methods.MultipartPostMethod;

public class HttpMultiPartFileUpload {
    private static String url =
      "http://localhost/yaoliang/ProcessFileUpload.jsp";

    public static void main(String[] args) throws IOException {
        HttpClient client = new HttpClient();
        MultipartPostMethod mPost = new MultipartPostMethod(url);
        client.setConnectionTimeout(8000);

        // Send any XML file as the body of the POST request
        File f1 = new File("D:/students.xml");
        File f2 = new File("D:/demy.xml");
        File f3 = new File("D:/demyRules.xml");

        System.out.println("File1 Length = " + f1.length());
        System.out.println("File2 Length = " + f2.length());
        System.out.println("File3 Length = " + f3.length());

        mPost.addParameter(f1.getName(),f1.getName(),  f1);
        mPost.addParameter(f2.getName(), f2.getName(), f2);
        mPost.addParameter(f3.getName(), f3.getName(),f3);

FilePart part1 = new FilePart("file1",file);
FilePart part2 = new FilePart("file2",file);
FilePart part3 = new FilePart("file3",file);
mPost.addPart(part1);
mPost.addPart(part2);
mPost.addPart(part3);

        int statusCode1 = client.executeMethod(mPost);

        System.out.println("statusLine>>>" + mPost.getStatusLine());
        mPost.releaseConnection();
    }
}

In this code, you just add the files as parameters and execute the method. The ProcessFileUpload.jsp file gets invoked, and the output is as follows:

Content Type =multipart/form-data; boundary=----------------31415926535897932384
6

NAME: students.xml
SIZE: 279
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"students.xml

NAME: academy.xml
SIZE: 951
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"academy.xml

NAME: academyRules.xml
SIZE: 1211
D:"javaGizmos"jakarta-tomcat-4.0.1"webapps"HttpServerSideApp"academyRules.xml

Thus, file uploads on the server side become quite a simple task if you are using the Commons FileUpload component.

我们不可能列举所 有可能的顽固，我们会针对几种最常见的问题进行处理。当然了，正如前面说到的，如果我们自己使用java.net.HttpURLConnection来 搞定这些问题是很恐怖的事情，因此在开始之前我们先要介绍一下一个开放源码的项目，这个项目就是Apache开源组织中的httpclient，它隶属于 Jakarta的commons项目，目前的版本是2.0RC2。commons下本来已经有一个net的子项目，但是又把httpclient单独提出 来，可见http服务器的访问绝非易事。

Commons-httpclient 项目就是专门设计来简化HTTP客户端与服务器进行各种通讯编程。通过它可以让原来很头疼的事情现在轻松的解决，例如你不再管是HTTP或者HTTPS的 通讯方式，告诉它你想使用HTTPS方式，剩下的事情交给httpclient替你完成。本文会针对我们在编写HTTP客户端程序时经常碰到的几个问题进 行分别介绍如何使用httpclient来解决它们，为了让读者更快的熟悉这个项目我们最开始先给出一个简单的例子来读取一个网页的内容，然后循序渐进解 决掉前进中的所有问题。

1． 读取网页(HTTP/HTTPS)内容

下面是我们给出的一个简单的例子用来访问某个页面

/*

* Created on 2003-12-14 by Liudong

*/

package http.demo;

import java.io.IOException;

import org.apache.commons.httpclient.*;

import org.apache.commons.httpclient.methods.*;

/**

* 最简单的HTTP客户端,用来演示通过GET或者POST方式访问某个页面

* @author Liudong

*/

public class SimpleClient {

    public static void main(String[] args) throws IOException

    {

        HttpClient client = new HttpClient();    

        //设置代理服务器地址和端口    

        //client.getHostConfiguration().setProxy("proxy_host_addr",proxy_port);

        //使用GET方法，如果服务器需要通过HTTPS连接，那只需要将下面URL中的http换成https

        HttpMethod method = new GetMethod("http://java.sun.com");

        //使用POST方法

        //HttpMethod method = new PostMethod("http://java.sun.com");

        client.executeMethod(method);

        //打印服务器返回的状态

        System.out.println(method.getStatusLine());

        //打印返回的信息

        System.out.println(method.getResponseBodyAsString());

        //释放连接

        method.releaseConnection();

    }
}

在这个例子中首先创建一个 HTTP客户端(HttpClient)的实例，然后选择提交的方法是GET或者POST，最后在HttpClient实例上执行提交的方法，最后从所选 择的提交方法中读取服务器反馈回来的结果。这就是使用HttpClient的基本流程。其实用一行代码也就可以搞定整个请求的过程，非常的简单！

1. 提供了一个实现了 org.apache.commons.httpclient.protocol.SecureProtocolSocketFactory接口的 socket factory。这个 socket factory负责打一个到服务器的端口，使用标准的或第三方的SSL函数库，并进行象连接握手等初始化操作。通常情况下，这个初始化操作在端口被创建时 自动进行的。
   
   
2. 实例化一个org.apache.commons.httpclient.protocol.Protocol对象。创建这个实例时，需要一个合法的协议类型(如https)，一个定制的socket factory，和一个默认的端中号(如https的443端口).
   
   Protocol myhttps = new Protocol("https", new MySSLSocketFactory(), 443);
   然后，这个实例可被设置为协议的处理器。
   
   HttpClient httpclient = new HttpClient();
   httpclient.getHostConfiguration().setHost("www.whatever.com", 443, myhttps);
   GetMethod httpget = new GetMethod("/");
   httpclient.executeMethod(httpget);
3. 通过调用Protocol.registerProtocol方法，将此定制的实例，注册为某一特定协议的默认的处理器。由此，可以很方便地定制自己的协议类型(如myhttps)。
   
   Protocol.registerProtocol("myhttps",
   new Protocol("https", new MySSLSocketFactory(), 9443));
   ...
   HttpClient httpclient = new HttpClient();
   GetMethod httpget = new GetMethod("myhttps://www.whatever.com/");
   httpclient.executeMethod(httpget);
   如果想用自己定制的处理器取代https默认的处理器，只需要将其注册为"https"即可。
   
   Protocol.registerProtocol("https",
   new Protocol("https", new MySSLSocketFactory(), 443));
   HttpClient httpclient = new HttpClient();
   GetMethod httpget = new GetMethod("https://www.whatever.com/");
   httpclient.executeMethod(httpget);

1. 持续的SSL连接在Sun的低于1.4JVM上不能工作，这是由于JVM的bug造成。
   
   
2. 通过代理访问服务器时，非抢先认证（ Non-preemptive authentication）会失败，这是由于HttpClient的设计缺陷造成的，以后的版本中会修改。

11、httpclient的多线程处理

12、HTTP方法

1. 对已有的资源做评注
   
   
2. 将信息发布到BBS、新闻组、邮件列表，或类似的文章组中
   
   
3. 将一块数据，提交给数据处理进程
   
   
4. 通过追加操作，来扩展一个数据库

参考资料：

1、HttpClient的功能

1. 基于标准，纯正java，实现了http1.0和1.1。
   
   
2. 在一个可扩展的OO框架内，实现了HTTP的全部方法(GET, POST,
   PUT, DELETE, HEAD, OPTIONS, and TRACE)
   
   
3. 支持HTTPS(ssl上的HTTP)的加密操作
   
   
4. 透明地穿过HTTP代理建立连接
   
   
5. 通过CONNECT方法，利用通过建立穿过HTTP代理的HTTPS连接
   
   
6. 利用本地Java socket，透明地穿过SOCKS(版本5和4）代理建立连接
   
   
7. 支持利用Basic、Digest和NTLM加密的认证
   
   
8. 支持用于上传大文件的Multi-Part表单POST方法
   
   
9. 插件式安全socket实现，易于使用第三方的解决方案
   
   
10. 连接管理，支持多线程应用，支持设定单个主机总连接和最高连接数量,自动检测和关闭失效连接
    
    
11. 直接将请求信息流送到服务器的端口
    
    
12. 直接读取从服务器的端口送出的应答信息
    
    
13. 支持HTTP/1.0中用KeepAlive和HTTP/1.1中用persistance设置的持久连接
    
    
14. 直接访问由服务器送出的应答代码和头部信息
    
    
15. 可设置连接超时时间
    
16. 
    
17. HttpMethods 实现Command Pattern，以允许并行请求或高效连接复用
    
    
18. 遵循the Apache Software License协议，源码免费可得
    

2、预备工作

3、取得源码

4、使用HttpClient编程的基本步聚

1. 创建 HttpClient 的一个实例.
   
   
2. 创建某个方法（DeleteMethod，EntityEnclosingMethod，ExpectContinueMethod， GetMethod，HeadMethod，MultipartPostMethod，OptionsMethod，PostMethod， PutMethod，TraceMethod）的一个实例，一般可用要目标URL为参数。
   
   
3. 让 HttpClient 执行这个方法.
   
   
4. 读取应答信息.
   
   
5. 释放连接.
   
   
6. 处理应答.
   

5、认证

1. 从HttpClientAPI的角度来看，NTLM与其它认证方式一样的工作，差别是需要提供'NTCredentials'实例而不是'UsernamePasswordCredentials'(其实，前者只是扩展了后者)
   
   
2. 对NTLM认证，访问空间是连接到的机器的域名，这对多域名主机会有一些麻烦.只有HttpClient连接中指定的域名才是认证用的域名。建议将realm设为null以使用默认的设置。
   
   
3. NTLM只是认证了一个连接而不是一请求，所以每当一个新的连接建立就要进行一次认证，且在认证的过程中保持连接是非常重要的。 因此，NTLM不能同时用于代理认证和服务器认证，也不能用于http1.0连接或服务器不支持持久连接的情况。

6、重定向

1. 301 永久移动. HttpStatus.SC_MOVED_PERMANENTLY
   
   
2. 302 临时移动. HttpStatus.SC_MOVED_TEMPORARILY
   
   
3. 303 See Other. HttpStatus.SC_SEE_OTHER
   
   
4. 307 临时重定向. HttpStatus.SC_TEMPORARY_REDIRECT

1. 300 多重选择. HttpStatus.SC_MULTIPLE_CHOICES
   
   
2. 304 没有改动. HttpStatus.SC_NO T_MODIFIED
   
   
3. 305 使用代理. HttpStatus.SC_USE_PROXY
   

7、字符编码(character encoding)

8、s

1. Netscape 草案，是最早的规范，基于rfc2109。尽管这个规范与rc2109有较大的差别，这样做可以与一些服务器兼容。
   
   
2. rfc2109， 是w3c发布的第一个官方规范。理论上讲，所有的服务器在处理(版本1)时，都要遵循此规范，正因如此，HttpClient将其设为默认的规范。遗憾的 是，这个规范太严格了，以致很多服务器不正确的实施了该规范或仍在作用Netscape规范。在这种情况下，应使用兼容规范。
   
   
3. 兼容性规范，设计用来兼容尽可能多的服务器，即使它们并没有遵循标准规范。当解析出现问题时，应考虑采用兼容性规范。

1. HttpClient client = new HttpClient();
   client.getState().setPolicy(Policy.COMPATIBILITY);
   这种方法设置的规范只对当前的HttpState有效，参数可取值Policy.COMPATIBILITY，Policy.NETSCAPE_DRAFT或Policy.RFC2109。
   
   
2. System.setProperty("apache.commons.httpclient.spec", "COMPATIBILITY");
   此法指的规范，对以后每个新建立的HttpState对象都有效，参数可取值"COMPATIBILITY","NETSCAPE_DRAFT"或"RFC2109"。
   常有不能解析的问题，但更换到兼容规范大都能解决。
   

9、使用HttpClient遇到问题怎么办?

1. 用一个浏览器访问服务器，以确认服务器应答正常
   
   
2. 如果在使代理，关掉代理试试
   
   
3. 另找一个服务器来试试（如果运行着不同的服务器软件更好）
   
   
4. 检查代码是否按教程中讲的思路编写
   
   
5. 设置log级别为debug，找出问题出现的原因
   
   
6. 打开wiretrace，来追踪客户端与服务器的通信，以确实问题出现在什么地方
   
   
7. 用telnet或netcat手工将信息发送到服务器，适合于猜测已经找到了原因而进行试验时
   
   
8. 将netcat以监听方式运行，用作服务器以检查httpclient如何处理应答的。
   
   
9. 利用最新的httpclient试试，bug可能在最新的版本中修复了
   
   
10. 向邮件列表求帮助
    
    
11. 向bugzilla报告bug.