1.下载：
spring-beandoc-0.7.0:
http://opensource.atlassian.com/confluence/spring/download/attachments/993/spring-beandoc-0.7.0.tgz?version=1

参考： http://opensource.atlassian.com/confluence/spring/display/BDOC/Home
graphviz-2.8:

http://www.graphviz.org/pub/graphviz/ARCHIVE/graphviz-2.8.exe
参考： http://www.graphviz.org/Download_windows.php
apache-ant-1.6.5:
http://www.eu.apache.org/dist/ant/binaries/apache-ant-1.6.5-bin.zip

2.安装，解压spring-beandoc-0.7.0.tgz和apache-ant-1.6.5-bin.zip到d:/Java/
设置环境变量：
ANT_HOME=D:\java\apache-ant-1.6.5
Path=D:\jdk1.5.0_06\bin;D:\java\apache-ant-1.6.5\bin;........
运行graphviz-2.8.exe，安装到D:\Programs\ATT。

3.到D:\java\spring-beandoc-0.7.0\src\org\springframework\beandoc\output\i18n下
增加中文资源文件labels_zh.properties ，然后对照翻译，
#-----------------------------------------
# @since 1.0

i18n-generated=beandoc \u751F\u6210\u4E86
i18n-filelist=files making up this application context
i18n-description=\u63CF\u8FF0
i18n-attributes=\u5C5E\u6027
i18n-constructorargs=\u6784\u9020\u53C2\u6570
i18n-allTitle=\u6240\u6709 Beans
i18n-summaryTitle=beans\u6458\u8981
i18n-detailTitle=beans\u8BE6\u60C5
i18n-innerbean=\u533F\u540D\u5185\u90E8bean
i18n-home=\u9996\u9875
i18n-summary=\u6458\u8981
i18n-detail=\u8BE6\u60C5
i18n-abstractbean=\u62BD\u8C61 bean
i18n-deps=\u4F9D\u8D56, \u5C5E\u6027\u503C \u548C \u65B9\u6CD5 \u6CE8\u5165
i18n-backtotop=\u9000\u56DE\u5230\u9876\u90E8
i18n-name=\u540D\u5B57
i18n-bean=bean
i18n-argtypes=\u53C2\u6570\u7C7B\u578B

#-----------------------------------------

再到D:\java\spring-beandoc-0.7.0\下运行build.bat。

4.到D:\java\spring-beandoc-0.7.0\samples\
编辑beandoc.properties，

第50行改为：i18n.locale=zh
第60行改为：compiler.dotExe=d:/Programs/ATT/GraphViz/bin/dot.exe

5.清空 D:\java\spring-beandoc-0.7.0\samples\jpetstore和 D:\java\spring-beandoc-0.7.0\samples\petclinic,复制spring配置文件
到D:\java\spring-beandoc-0.7.0\samples\jpetstore

6.然后运行D:\java\spring-beandoc-0.7.0\samples\runbeandoc-cli.bat
需要带参数：
D:\java\SPRING~1.0\samples>runbeandoc-cli.bat beandoc.properties

7.然后打开D:\java\spring-beandoc-0.7.0\target\sample-output\index.html.
就可以看到生成好的文档了。

(lizongbo原创，转载请注明出处。)
A. java操作xmlrpc.
可以使用 apache xmlrpc http://ws.apache.org/xmlrpc/

1. org.apache.xmlrpc.XmlRpc.setDebug(true);可以打开调试模式，可以看到一些详细的xmlrpc解析处理日志。
2. 不支持值为null，支持的java类型为：Integer,Boolean,String,Double,java.util.Date(支持其子类),byte[],java.util.Vector,java.util.Hashtable
(http://ws.apache.org/xmlrpc/types.html  apache xmlrpc 对java类型作了扩展，但是如果要考虑其它编程语言的调用，不建议使用扩展的类型)

B. delphi操作xmlrpc的库是delphixml-rpc：http://sourceforge.net/projects/delphixml-rpc/
(网上有人提到过codepunk，但是现在已经无法下载.http://www.codepunk.com/xmlrpc1_7_6.zip ,参考：http://www.delphibbs.com/keylife/iblog_comment.asp?xid=870)
于是选择了delphixml-rpc,实际使用中遇到以下一些问题，
1.汉字处理的问题。 delphi作客户端,  java作服务端,产生
Hello, 你好 , test  汉字"不能够转换成"Hello, 你好 , test 汉字"
的问题, 解决方法如下:
 
xmlrpcparser
1554行，
CHR改成widechar
如下:
          THEN CurContent := CurContent + widechar (StrToIntDef ('$'+Copy (Name, 3, MaxInt), 32))
          ELSE CurContent := CurContent + widechar (StrToIntDef (Copy (Name, 2, MaxInt), 32));

对于sf上最新的xmlrpc包,则需要修改LibxmlPraser.pas对应地方的代码
2.空字符串（非null）的解析问题。
java 的代码： Hashtable struct = new Hashtable();
        struct.put("type", new Integer(0));
        struct.put ("id", "0"); //如果这样写 struct.put("id", ""); ,就会导致结构体错乱 ,取不到第一个 struct
解决办法，通过一个约定的字符串“nil”来表示空字符串。

3. 使用ssl遇到的问题:
tomcat的 ssl配置为:
    <Connector port="8083"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" disableUploadTimeout="true"
               acceptCount="100" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS"
           keystoreFile="conf/ca/.keystore"
           keystorePass="password">
     </Connector>
 
而delphi的xmlrpc调用会出问题,因此需要修改源代码:
在XmlRpcClient.pas的第321行之后加上下面两行代码:
 
        IdSSLIOHandlerSocket.SSLOptions.Mode := sslmUnassigned;
        IdSSLIOHandlerSocket.SSLOptions.Method := sslvTLSv1;
 
 (如果tomcat使用了apr,则ssl配置是不一样的，这种情况下的delphi调用，我们没测试过)
4.乱码导致结构体解析失败
 
如果结构体的string里有不可识别的字符，会导致结构体解析失败，
因此，在传输的内容为不可预见的情况下（比如用户发送的千奇百怪的短消息），
建议用ｂｙｔｅ传送（实际工作中遇到这样的情况并总结出来的。）
服务端 ：struct.put ("msg", "测试短消息"); ---> struct.put ("msgbyte", "测试短消息".getBytes());
客户端delphi代码改用asBase64str方法来还原为string.

(以上均是实际工作中遇到的问题。 )

C .jsolait的xmlrpc库是javascript的操作xmlrpc的，非常简单.

多个参数的调用可以放在一个数组，也可以分别传入,同jdk1.5的可变参数(Variable Arguments)。
如果只传一个参数，而这个参数是个数组，需要这样写：

var xmlrpc=null;
 try{
    var xmlrpc = importModule("xmlrpc");
 }catch(e){
    reportException(e);
    throw "importing of xmlrpc module failed.";
 }
 var addr = "http://lizongbo:808/lizongbo/xmlrpc";
 var methods = ["lizongbo.testOneArray"];
 var rslt;
 var params = new Array();
 params[0] = "0311112";
 params[1] = "awsasaas";
 params[2] = "awsasaas";
 try{
       var service = new xmlrpc.ServiceProxy(addr, methods);
       rslt = service.lzbrpc.testOneArray([params]);//用中括号括起来，否则会被解析为三个传入参数的调用
       ///service.lzbrpc.testOneArray(params) 等同于service.lzbrpc.testOneArray(params[0],params[1],params[2]);

       返回结果里如果只有一个值，可以直接在用rslt，如果有多个值，
       比如下面这个结构体， 则可以用rslt.flag,rslt.info,rslt.struct.version来分别得到对应的值。
       （符合dom）
// var str="" + rslt.flag+' xx '+rslt.info+' yy '+rslt.struct.version ;
// 或者var str="" + rslt['flag']+' xx '+rslt['info']+' yy '+rslt['struct']['version'];
//得到的结果是"1 xx 成功 yy 123.beta "
参考 ： http://www.blogjava.net/mstar/archive/2005/06/07/5657.aspx

D . 调试xmlrpc,有一个非常优秀的工具：
http://torrez.net/projects/konstructor/Konstructor.exe
来自:
http://torrez.net/archives/xmlrpc_request_builder.php

缺点,只能够连接类似 http://lizongbo.com/xmlrpc的Endpoint
不支持https,也不支持除80外的其它端口

(lizongbo原创，转载请注明出处。)

     public int getFirstIndexForCurrentPage() {
        return (this.currentPage - 1) * this.pageSize;
    }

    /**
     * Returns the index into the master list of the last object that should appear on the current page that the user is
     * viewing.
     * @return int
     */
    protected int getLastIndexForCurrentPage() {
        if (this.partialList) {
            return (getFirstIndexForCurrentPage()) +
                    Math.min(this.pageSize - 1, this.fullList.size() - 1);
        } else {
            return getLastIndexForPage(this.currentPage);
        }
    }


顺便记录 displaytag 1.1 使用Partial Lists大数据量分页的例子：

在近量不改动现有代码的基础上来使用displaytag结合数据库分页.

1.先设置总页数:

<%
   Integer totalNum = new Integer(919);
request.setAttribute("totalNum",totalNum);//设置总记录条数
%>

2.配置displaytag的 两个属性：partialList="true" size="totalNum"
比如：
  <display:table id="testtbid"  name="requestScope.testlist" pagesize="20" partialList="true" size="totalNum">

3.在jsp中获得翻页信息的代码：

<%

下面代码是取得翻页数

//如果没有为table设置 id那么就要写成ParamEncoder(null);
  String rpname = new org.displaytag.util.ParamEncoder("testtbid")
      .encodeParameterName(
          org.displaytag.tags.TableTagParameters.PARAMETER_PAGE);
  System.out.println("当前页数：" + rpname + " = " +
                     request.getParameter(rpname));
       //然后根据当前页数去从数据库中取出相应数据。

//see: http://displaytag.sourceforge.net/11/displaytag/apidocs/org/displaytag/tags/TableTagParameters.html

%>
表格分页导航条里的分页链接个数默认是8个，可以通过下面的代码来更改
//在<display:table>标签内
    <display:setProperty name="paging.banner.group_size" value="20"/>
//</display:table>

当然也可以通过实现 org.displaytag.pagination.PaginatedList接口来完成这个要求。
更多信息，请参考：
http://displaytag.sourceforge.net/11/tut_externalSortAndPage.html

利用内置el在displaytag里显示checkbox非常简单：

                     <display:column title='select User' >
 <input type="checkbox" name="firstName"  value="{testtbid.name}" />${testtbid.name}
</display:column>

     java.util.ConcurrentModificationException 这个异常。
Exception in thread "main" java.util.ConcurrentModificationException
 at java.util.HashMap$HashIterator.nextEntry(HashMap.java:787)
 at java.util.HashMap$KeyIterator.next(HashMap.java:823)

解决办法如下：

import java.util.*;

public class TestMap {
  public TestMap() {
  }

  public static void main(String[] args) {
    java.util.Map m = new java.util.HashMap();
    m.put("aaa", "lizongbo ");
    m.put("bbb", " lizongbo");
    m.put("ccc", "lizongbo  ");
    m.put("ddd", "  lizongbo");
    m.put("eee", "lizongbo");
    m.put("fff", "lizongbo");
    m.put("ggg", "lizongbo");
    m.put("adads", "lizongbo");
    m.put("dffd", "lizongbo");
    m.put("dcxv", "lizongbo");
    m.put("lizongbo", "lizongbo");
    m.put("ert", "lizongbo");
    m.put("544", "lizongbo ");
    Iterator iterator = m.keySet().iterator();
    while (iterator.hasNext()) {
      String sessionId = (String) iterator.next();
      if ("ggg".equals(sessionId) || "lizongbo".equals(sessionId) ||
          "544".equals(sessionId)) {
        iterator.remove();       //这行代码是关键。
        m.remove(sessionId);
      }
    }
    System.out.println(m.get("ggg"));
    System.out.println(m.get("lizongbo"));
    System.out.println(m.get("544"));
  }

        相关参考： http://ldfren.bosinet.com/archives/113.html
http://gceclub.sun.com.cn/yuanchuang/week-14/iterator.html