Apache HTTP Server 是一款优秀的开放源码软件，从1996年以来已经被广泛地应用于多种操作系统。据Netcraft.com 2006年3月的统计，目前Internet上68.70%网站用的是Apache。

OpenSSL 是一个稳定的而且功能齐全的开放源码工具包，它实现了安全套接字层 (SSL v2/v3)和传输层层安全 (TLS v1)协议，也是一个强大的通用加密工具库。

不幸的是 Apache HTTP Server 官方提供的安装包目前不包含SSL功能，因为美国政府对“strong crypto redistribution”有意见。但是爱好者们可以自己DIY。

本人从03年起，编译了Apache (2.0.x - 2.2.x)和OpenSSL (0.9.6i - 0.9.8a)几乎每个版本。

2 编译材料清单

2.1 编译OpenSSL所需材料

• OpenSSL源码
• Perl for Win32
• 以下C编译器之一:
  • Visual C++ (我用这个)
  • Borland C
  • GNU C (Cygwin or MinGW)
• 以下汇编器之一:
  • Microsoft MASM (aka "ml")
  • Free Netwide Assembler NASM (我用这个)

2.2 编译Apache所需材料

• Apache源码
• AWK Utility 这个工具的作者Brian Kernighan发明了C语言，还写了几本牛书。
• bison, flex, sed
• MS Platform SDK (可选，如果用VC++ 6.0编译Apache 2.2.0必须)

2.3 环境变量

• 把以下文件的路径放到PATH上: perl.exe, awk.exe, nasmw.exe, bison.exe, flex.exe, sed.exe, nmake.exe, mspdb60.dll。
• 在INCLUDE和LIB里把MS Platform SDK放到VC 6.0前面。

3 编译OpenSSL

• 把OpenSSL源码解开到一个目录，比如 c:\openssl
• 设置Perl

      c:\openssl>perl Configure VC-WIN32

• 生成Makefiles

      c:\openssl>ms\do_nasm

• 用VC++编译

      nmake -f ms\ntdll.mak

• 测试

      c:\openssl>cd out32dll
      c:\openssl\out32dll>..\ms\test

4 编译Apache

• 把Apache源码解开到一个目录，比如 c:\httpd-2.2.0
• 复制OpenSSL库

      c:\httpd-2.2.0>mkdir srclib\openssl
      c:\httpd-2.2.0>xcopy/e openssl srclib\openssl

• 编译

      nmake -f makefile.win SERVERNAME=myDomainName PORT=myPort 
          INSTDIR=myInstallDir installr

• 删除多余文件 (可选)。以下语言文件一般可以删除：*.de *.es *.euc-jp *.euc-kr *.fr *.ja *.jis *.ko *.koi8-r *.pt-br。如果不想调试*.pdb文件也可删除。

1.1 编辑APACHE_HOME/conf/httpd.conf

添加以下语句, 把APACHE_HOME改成相应目录.

    LoadModule jk_module modules/mod_jk.so
    JkWorkersFile "APACHE_HOME/conf/workers.properties"
    JkLogFile "APACHE_HOME/logs/mod_jk.log"
    JkMount /*.jsp worker1
    JkMount /*/servlet/* worker1

1.2 生成workers.properties配置文件

生成如下配置文件文件,

    worker.list=worker1
    worker.worker1.type=ajp13
    worker.worker1.host=localhost
    worker.worker1.port=8009

2 Tomcat端

2.1 编辑TOMCAT_HOME/conf/server.xml

在Host element下添加相应Context,

    <!-- Test Context -->
    <Context path="/test" docBase="APACHE_HOME/htdocs/test" reloadable="true" 
        crossContext="true"/>

2.2 编辑TOMCAT_HOME/conf/web.xml (可选)

Tomcat 4.1.12之后的版本缺省配置下不能用/servlet/*的方式来调用/WEB-INF/classes路径下的servlet. 4.1.12的RELEASE-NOTES提及以下变化,

Starting with Tomcat 4.1.12, the invoker servlet is no longer available by default in all webapps. Enabling it for all webapps is possible by editing $CATALINA_HOME/conf/web.xml to uncomment the "/servlet/*" servlet-mapping definition.

Using the invoker servlet in a production environment is not recommended and is unsupported. More details are available on the Tomcat FAQ at http://tomcat.apache.org/faq/misc.html#invoker.

其实还需要Tomcat 5.0之后的版本还需要去掉web.xml另一段语句的注释, 蹊跷的是官方文档没提到.

也许因为无法消灭这个安全漏洞, 黔驴技穷的开发人员只好宣布, "Using /servlet/ to map servlets is evil, absolutely evil". 这个解决方案真是convenient, absolutely convenient.

简而言之, 用户需要去掉以下段落的注释,

    <servlet>
        <servlet-name>invoker</servlet-name>
        <servlet-class>
          org.apache.catalina.servlets.InvokerServlet
        </servlet-class>
        <init-param>
            <param-name>debug</param-name>
            <param-value>0</param-value>
        </init-param>
        <load-on-startup>2</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>invoker</servlet-name>
        <url-pattern>/servlet/*</url-pattern>
    </servlet-mapping>

打开conf/httpd.conf添加以下语句，记得把PHP_HOME改成相应目录。

    LoadModule php5_module "PHP_HOME/php5apache2.dll"
    AddType application/x-httpd-php .php
    PHPIniDir "PHP_HOME"

PHP端

• 编辑php.ini中以下变量：doc_root, extension_dir (绝对路径)
• 如使用MySQL, 去掉以下语句的注释，或添加相应语句,

      extension=php_mysql.dll
      extension=php_mysqli.dll

• 把libmysql.dll拷贝到APACHE_HOME/bin

• 编辑APACHE_HOME/conf/httpd.conf中的以下directives和tags,

  ServerRoot, ServerAdmin, ServerName, DocumentRoot, 
  <Directory %DocumentRoot%>, DirectoryIndex, ScriptAlias /cgi-bin/, 
  <Directory %cgi-bin%>

• 去掉以下语句的注释,

  Include conf/extra/httpd-manual.conf

2 生成RSA密钥 (private key)

下面两个命令都可以生成密钥,

    openssl genrsa -des3 -out server.key
    openssl genrsa -out server.key

-des3选项可以加密生成的密钥, 但是Win32平台不支持加密密钥，启动Apache时会产生以下错误信息, "SSLPassPhraseDialog builtin is not supported on Win32"

3 生成自签署证书 (self-signed certificate)

在OpenSSL源码的"openssl\apps"目录可以找到openssl.cnf (OpenSSL配置文件).

    openssl req -config openssl.cnf -new -x509 -key server.key -out 
        server.crt -days 365

4 编辑APACHE_HOME/conf/httpd.conf

去掉以下语句的注释,

   Include conf/extra/httpd-ssl.conf

5 编辑 conf/extra/httpd-ssl.conf

• 把SSLMutex标签的值改为default
• 编辑以下directives(可选),

  DocumentRoot, ServerName, ServerAdmin, ErrorLog, TransferLog, 
  SSLCertificateFile, SSLCertificateKeyFile

XMLBeans Schema Tools (XMLBeans Version 1.0.3)  This site allows XML Schema validation and compilation tools. You can submit an XML Schema (via file upload or cut and paste) or a set of XML Schemas (zip file) and you can download the resulting XMLBeans JAR file.

• XMLBeans V1.0.3 Schema Validation
• XMLBeans V1.0.3 Schema Compilation

XMLBeans Schema Tools (XMLBeans Version 2.0)  Same as above but for XMLBeans V2.0

• XMLBeans V2.0 Schema Validation
• XMLBeans V2.0 Schema Compilation

Do you have or know of a tool that works with XMLBeans? Let us know and we will list it here.

XMLBeans Articles

    应该用。VSS、CVS、PVCS、ClearCase、CCC/Harvest、FireFly都可以。我的选择是VSS。

 2. 你们的项目组使用缺陷管理系统了么？
    应该用。ClearQuest太复杂，我的推荐是BugZilla。

 3. 你们的测试组还在用Word写测试用例么？
　  不要用Word写测试用例（Test Case）。应该用一个专门的系统，可以是Test Manager，也可以是自己开发一个ASP.NET的小网站。主要目的是Track和Browse。

 4. 你们的项目组有没有建立一个门户网站？
　 　要有一个门户网站，用来放Contact Info、Baselined Schedule、News等等。推荐Sharepoint Portal Server 2003来实现，15分钟就搞定。买不起SPS 2003可以用WSS (Windows Sharepoint Service)。

 5. 你们的项目组用了你能买到最好的工具么？
　　应该用尽量好的工具来工作。比如，应该用VS.NET而不是Notepad来写C#。用Notepad写程序多半只是一种炫耀。但也要考虑到经费，所以说是"你能买到最好的"。
 
 6. 你们的程序员工作在安静的环境里么？
　　需要安静环境。这点极端重要，而且要保证每个人的空间大于一定面积。

 7. 你们的员工每个人都有一部电话么？需要每人一部电话。而且电话最好是带留言功能的。当然，上这么一套带留言电话系统开销不小。不过至少每人一部电话要有，千万别搞得经常有人站起来喊："某某某电话"。《人件》里面就强烈谴责这种做法。

 8. 你们每个人都知道出了问题应该找谁么？
　　应该知道。任何一个Feature至少都应该有一个Owner，当然，Owner可以继续Dispatch给其他人。

 9. 你遇到过有人说"我以为…"么？
　　要消灭"我以为"。Never assume anything。

10. 你们的项目组中所有的人都坐在一起么？
　　需要。我反对Virtual Team，也反对Dev在美国、Test在中国这种开发方式。能坐在一起就最好坐在一起，好处多得不得了。

11. 你们的进度表是否反映最新开发进展情况？
　　应该反映。但是，应该用Baseline的方法来管理进度表：维护一份稳定的Schedule，再维护一份最新更改。Baseline的方法也应该用于其它的Spec。Baseline是变更管理里面的一个重要手段。

12. 你们的工作量是先由每个人自己估算的么？
　　应该让每个人自己估算。要从下而上估算工作量，而不是从上往下分派。除非有其他原因，比如政治任务工期固定等。

13. 你们的开发人员从项目一开始就加班么？
　　不要这样。不要一开始就搞疲劳战。从项目一开始就加班，只能说明项目进度不合理。当然，一些对日软件外包必须天天加班，那属于剥削的范畴。

14. 你们的项目计划中Buffer Time是加在每个小任务后面的么？
　　不要。Buffer Time加在每个小任务后面，很容易轻易的就被消耗掉。Buffer Time要整段的加在一个Milestone或者checkpoint前面。

15. 值得再多花一些时间，从95%做到100%好值得，非常值得。
　　尤其当项目后期人困马乏的时候，要坚持。这会给产品带来质的区别。

16. 登记新缺陷时，是否写清了重现步骤？
　　要。这属于Dev和Test之间的沟通手段。面对面沟通需要，详细填写Repro Steps也需要。

17. 写新代码前会把已知缺陷解决么？
    要。每个人的缺陷不能超过10个或15个，否则必须先解决老的bug才能继续写新代码。

18. 你们对缺陷的轻重缓急有事先的约定么？
　　必须有定义。Severity要分1、2、3，约定好：蓝屏和Data Lost算Sev 1，Function Error算Sev 2，界面上的算Sev 3。但这种约定可以根据产品质量现状适当进行调整。

19. 你们对意见不一的缺陷有三国会议么？
    必须要有。要有一个明确的决策过程。这类似于CCB (Change Control Board)的概念。

20. 所有的缺陷都是由登记的人最后关闭的么？
　　Bug应该由Opener关闭。Dev不能私自关闭Bug。

21. 你们的程序员厌恶修改老的代码么？
　　厌恶是正常的。解决方法是组织Code Review，单独留出时间来。XP也是一个方法。

22. 你们项目组有Team Morale Activity么？
　　每个月都要搞一次，吃饭、唱歌、Outing、打球、开卡丁车等等，一定要有。不要剩这些钱。

23. 你们项目组有自己的Logo么？
　　要有自己的Logo。至少应该有自己的Codename。

24. 你们的员工有印有公司Logo的T-Shirt么？
　　要有。能增强归属感。当然，T-Shirt要做的好看一些，最好用80支的棉来做。别没穿几次就破破烂烂的。

25. 总经理至少每月参加次项目组会议要的。
　　要让team member觉得高层关注这个项目。

26. 你们是给每个Dev开一个分支么？
　　反对。Branch的管理以及Merge的工作量太大，而且容易出错。

27. 有人长期不Check-In代码么？
　　不可以。对大部分项目来说，最多两三天就应该Check-In。

28. 在Check-In代码时都填写注释了么？
　　要写的，至少一两句话，比如"解决了Bug No.225（给bug编号）"。如果往高处拔，这也算做"配置审计"的一部分。

29. 有没有设定每天Check-In的最后期限？
　　要的，要明确Check-In Deadline。否则会Build Break。

30. 你们能把所有源码一下子编译成安装文件吗？
　　要的。这是每日编译（Daily Build）的基础。而且必须要能够做成自动的。

31. 你们的项目组做每日编译么？
　　当然要做。有三样东西是软件项目/产品开发必备的：1. bug management; 2. source control; 3. daily build。

32. 你们公司有没有积累一个项目风险列表？
　　要。Risk Inventory。否则，下个项目开始的时候，又只能拍脑袋分析Risk了。

33. 设计越简单越好越简单越好。
　　设计时候多一句话，将来可能就带来无穷无尽的烦恼。应该从一开始就勇敢的砍。这叫scope management。

34. 尽量利用现有的产品、技术、代码千万别什么东西都自己Coding。BizTalk和Sharepoint就是最好的例子，有这两个作为基础，可以把起点 提高很多。或者可以尽量多用现成的Control之类的。或者尽量用XML，而不是自己去Parse一个文本文件；尽量用RegExp，而不是自己从头操 作字符串，等等等等。这就是"软件复用"的体现。

35. 你们会隔一段时间就停下来夯实代码么？
　　要。最好一个月左右一次。传言去年年初Windows组在Stevb的命令下停过一个月增强安全。Btw，"夯"这个字念"hang"，第一声。

36. 你们的项目组每个人都写Daily Report么？
　　要写。五分钟就够了，写10句话左右，告诉自己小组的人今天我干了什么。一则为了沟通，二则鞭策自己（要是游手好闲一天，自己都会不好意思写的）。

37. 你们的项目经理会发出Weekly Report么？
　　要。也是为了沟通。内容包括目前进度，可能的风险，质量状况，各种工作的进展等。

38. 你们项目组是否至少每周全体开会一次？
　　要。一定要开会。程序员讨厌开会，但每个礼拜开会时间加起来至少应该有4小时。包括team meeting, spec review meeting, bug triage meeting。千万别大家闷头写code。

39. 你们项目组的会议、讨论都有记录么？
　　会前发meeting request和agenda，会中有人负责主持和记录，会后有人负责发meeting minutes，这都是effective meeting的要点。而且，每个会议都要形成agreements和action items。

40. 其他部门知道你们项目组在干什么么？
　　要发一些Newsflash给整个大组织。Show your team's value。否则，当你坐在电梯里面，其他部门的人问："你们在干嘛"，你回答"ABC项目"的时候，别人全然不知，那种感觉不太好。

41. 通过Email进行所有正式沟通
　　Email的好处是免得抵赖。但也要避免矫枉过正，最好的方法是先用电话和当面说，然后Email来确认。

42. 为项目组建立多个Mailing Group
　 　如果在AD+Exchange里面，就建Distribution List。比如，我会建ABC Project Core Team，ABC Project Dev Team，ABC Project All Testers，ABC Project Extended Team等等。这样发起Email来方便，而且能让该收到email的人都收到、不该收到不被骚扰。

43. 每个人都知道哪里可以找到全部的文档么？
　　应该每个人都知道。这叫做知识管理（Knowledge Management）。最方便的就是把文档放在一个集中的File Share，更好的方法是用Sharepoint。

44. 你做决定、做变化时，告诉大家原因了么？
　 　要告诉大家原因。Empower team member的手段之一是提供足够的information，这是MSF一开篇的几个原则之一。的确如此，tell me why是人之常情，tell me why了才能有understanding。中国人做事喜欢搞限制，限制信息，似乎能够看到某一份文件的人就是有身份的人。大错特错。权威、权力，不在于 是不是能access information/data，而在于是不是掌握资源。

45. Stay agile and expect change 要这样。
　　需求一定会变的，已经写好的代码一定会被要求修改的。做好心理准备，对change不要抗拒，而是expect change。

46. 你们有没有专职的软件测试人员？
　　要有专职测试。如果人手不够，可以peer test，交换了测试。千万别自己测试自己的。

47. 你们的测试有一份总的计划来规定做什么和怎么做么？
    这就是Test Plan。要不要做性能测试？要不要做Usability测试？什么时候开始测试性能？测试通过的标准是什么？用什么手段，自动的还是手动的？这些问题需要用Test Plan来回答。

48. 你是先写Test Case然后再测试的么？
　　应该如此。应该先设计再编程、先test case再测试。当然，事情是灵活的。我有时候在做第一遍测试的同时补上test case。至于先test case再开发，我不喜欢，因为不习惯，太麻烦，至于别人推荐，那试试看也无妨。

49. 你是否会为各种输入组合创建测试用例？
　　不要，不要搞边界条件组合。当心组合爆炸。有很多test case工具能够自动生成各种边界条件的组合--但要想清楚，你是否有时间去运行那么多test case。

50. 你们的程序员能看到测试用例么？
　　要。让Dev看到Test Case吧。我们都是为了同一个目的走到一起来的：提高质量。

51. 你们是否随便抓一些人来做易用性测试？
　　要这么做。自己看自己写的程序界面，怎么看都是顺眼的。这叫做审美疲劳--臭的看久了也就不臭了，不方便的永久了也就习惯了。

52. 你对自动测试的期望正确么？
　　别期望太高。依我看，除了性能测试以外，还是暂时先忘掉"自动测试"吧，忘掉WinRunner和LoadRunner吧。对于国内的软件测试的现状来说，只能"矫枉必须过正"了。

53. 你们的性能测试是等所有功能都开发完才做的么？
　　不能这样。性能测试不能被归到所谓的"系统测试"阶段。早测早改正，早死早升天。

54. 你注意到测试中的杀虫剂效应了么？
　　虫子有抗药性，Bug也有。发现的新Bug越来越少是正常的。这时候，最好大家交换一下测试的area，或者用用看其他工具和手法，就又会发现一些新bug了。

55. 你们项目组中有人能说出产品的当前整体质量情况么？
　　要有。当老板问起这个产品目前质量如何，Test Lead/Manager应该负责回答。

56. 你们有单元测试么？
　　单元测试要有的。不过没有单元测试也不是不可以，我做过没有单元测试的项目，也做成功了--可能是侥幸，可能是大家都是熟手的关系。还是那句话，软件工程是非常实践、非常工程、非常灵活的一套方法，某些方法在某些情况下会比另一些方法好，反之亦然。

57. 你们的程序员是写完代码就扔过墙的么？
　　大忌。写好一块程序以后，即便不做单元测试，也应该自己先跑一跑。虽然有了专门的测试人员，做开发的人也不可以一点测试都不做。微软还有Test Release Document的说法，程序太烂的话，测试有权踢回去。

58. 你们的程序中所有的函数都有输入检查么？
　　不要。虽然说做输入检查是write secure code的要点，但不要做太多的输入检查，有些内部函数之间的参数传递就不必检查输入了，省点功夫。同样的道理，未必要给所有的函数都写注释。写一部分主要的就够了。

59. 产品有统一的错误处理机制和报错界面么？
　 　要有。最好能有统一的error message，然后每个error message都带一个error number。这样，用户可以自己根据error number到user manual里面去看看错误的具体描述和可能原因，就像SQL Server的错误那样。同样，ASP.NET也要有统一的Exception处理。可以参考有关的Application Block。

60. 你们有统一的代码书写规范么？
　　要有。Code Convention很多，搞一份来发给大家就可以了。当然，要是有FxCop这种工具来检查代码就更好了。

61. 你们的每个人都了解项目的商业意义么？
　 　要。这是Vision的意思。别把项目只当成工作。有时候要想着自己是在为中国某某行业的信息化作先驱者，或者时不时的告诉team member，这个项目能够为某某某国家部门每年节省多少多少百万的纳税人的钱，这样就有动力了。平凡的事情也是可以有个崇高的目标的。

62. 产品各部分的界面和操作习惯一致么？
　　要这样。要让用户觉得整个程序好像是一个人写出来的那样。

63. 有可以作为宣传亮点的Cool Feature么？
　　要。这是增强团队凝聚力、信心的。而且，"一俊遮百丑"，有亮点就可以掩盖一些问题。这样，对于客户来说，会感觉产品从质量角度来说还是acceptable的。或者说，cool feature或者说亮点可以作为质量问题的一个事后弥补措施。

64. 尽可能缩短产品的启动时间要这样。
　　软件启动时间（Start-Up time）是客户对性能好坏的第一印象。

65. 不要过于注重内在品质而忽视了第一眼的外在印象程序员容易犯这个错误：太看重性能、稳定性、存储效率，但忽视了外在感受。而高层经理、客户正相反。这两方面要兼顾，协调这些是PM的工作。

66. 你们根据详细产品功能说明书做开发么？
　　要这样。要有设计才能开发，这是必须的。设计文档，应该说清楚这个产品会怎么运行，应该采取一些讲故事的方法。设计的时候千万别钻细节，别钻到数据库、代码等具体实现里面去，那些是后面的事情，一步步来不能着急。

67. 开始开发和测试之前每个人都仔细审阅功能设计么？
　　要做。Function Spec review是用来统一思想的。而且，review过以后形成了一致意见，将来再也没有人可以说"你看，当初我就是反对这么设计的，现在吃苦头了吧"

68. 所有人都始终想着The Whole Image么？要这样。项目里面每个人虽然都只是在制造一片叶子，但每个人都应该知道自己在制造的那片叶子所在的树是怎么样子的。我反对软件蓝领，反对过分的把软件制造看成流水线、车间。参见第61条。

69. Dev工作的划分是单纯纵向或横向的么？
　　不能单纯的根据功能模块分，或者单纯根据表现层、中间层、数据库层分。我推荐这么做：首先根据功能模块分，然后每个"层"都有一个Owner来Review所有人的设计和代码，保证consistency。

70. 你们的程序员写程序设计说明文档么？
　　要。不过我听说微软的程序员1999年以前也不写。所以说，写不写也不是绝对的，偷懒有时候也是可以的。参见第56条。

71. 你在招人面试时让他写一段程序么？
　　要的。我最喜欢让人做字符串和链表一类的题目。这种题目有很多循环、判断、指针、递归等，既不偏向过于考算法，也不偏向过于考特定的API。

72. 你们有没有技术交流讲座？
　　要的。每一两个礼拜搞一次内部的Tech Talk或者Chalk Talk吧。让组员之间分享技术心得，这笔花钱送到外面去培训划算。

73. 你们的程序员都能专注于一件事情么？
　 　要让程序员专注一件事。例如说，一个部门有两个项目和10个人，一种方法是让10个人同时参加两个项目，每个项目上每个人都花50%时间；另一种方法是 5个人去项目A，5个人去项目B，每个人都100%在某一个项目上。我一定选后面一种。这个道理很多人都懂，但很多领导实践起来就把属下当成可以任意拆分 的资源了。

74. 你们的程序员会夸大完成某项工作所需要的时间么？
　　会的，这是常见的，尤其会在项目后期夸大做某个change所需要的时间，以次来抵制change。解决的方法是坐下来慢慢磨，磨掉程序员的逆反心理，一起分析，并把估算时间的颗粒度变小。

75. 尽量不要用Virtual Heads 最好不要用Virtual Heads。
　 　Virtual heads意味着resource is not secure，shared resource会降低resource的工作效率，容易增加出错的机会，会让一心二用的人没有太多时间去review spec、review design。一个dedicated的人，要强过两个只能投入50%时间和精力的人。我是吃过亏的：7个part time的tester，发现的Bug和干的活，加起来还不如两个full-time的。参见第73条。73条是针对程序员的，75条是针对 Resource Manager的。

Domain 名词解释

首先说明一下 Domain 在本文中的意思。

<<Domain Driven Design>> 一书，令 Domain 这个词很火。引起了广泛争论：哪些 Logic 应该放在 Business Service Layer, 哪些应该放在 Domain Object 里面。这类争论纷纷扬扬，最后通常都上升到哲学高度，世界观高度，认知心理学高度。如果不幸发展到极端情况，双方很可能开始相互质疑对方的智商和对世界的 基本理解能力。这个层次的Domain 纷争，不是本文所关心的话题。

我一向认为，设计能够满足如下的条件，就可以称为是一个好的设计：能够使用多态性，代替 Hard-Coded if else switch 等逻辑分支；新需求来的时候，不需要在旧代码里面添加 if else switch等逻辑分支，而只需要加入一个新的 Class；尽量避免 Package, Class 级别的交叉引用。

本文所关心的Domain 是一个更高的层次，类似于DSL, Domain Specific Language 里面的Domain的意思。

本文主要讨论如下议题：

• HTML是否只应该用来表示结构？
• HTML是否应该包含逻辑？
• HTML是否应该包含服务器端脚本逻辑？比如， JSP, Velocity, Freemarker.
• HTML是否应该包含浏览器端脚本逻辑？比如， Java Script.
• Java 代码中是否应该输出 HTML标签？比如，Taglib, Tapestry Page Component, etc?
• Java 代码中是否应该使用框架特殊的 HTML View Model? 比如， XMLC, Wicket, Echo, etc.
• HTTP Web Server 本来的设计宗旨是无状态，支持大用户量，多连接。目前的server side的 page flow, web flow, continuation, 力图使得HTTP Web Server 保持用户的流程状态。这种做法是否应该推荐？
• SQL是一种可读性很好，应用广泛的一种 DSL。如何动态拼装SQL ，一直是一个难以解决的问题。
• 是否应该在Java 代码中嵌入SQL?
• 是否应该在Java 代码中使用 Criteria API?
• 是否应该在SQL Template 中加入动态语言脚本逻辑？比如 iBatis 使用XML if otherwise, OR Bridge 中使用velocity?
• HQL, OQL 在SQL中引入了OO 语言的特性，似乎操作的是对象数据库，而不是关系数据库。这种做法是否应该推荐？
• Hibernate 动态期间篡改用户代码的做法，是否应该推荐？
• JDO静态期间篡改拥护代码的做法，是否应该推荐？
• Dynamic Proxy, CGLib 等动态篡改用户代码的做法，是否应该推荐？
• Reflection 绕开了 Java 的类型检查机制，是否应该推荐？
• Thread Local 是一种隐式契约，相当于绕开了显式契约（方法签名method signature），这种做法是否应该推荐？
  这些属于开发模式、代码风格方面的问题，正如所谓 Code Smell的感觉一样，也避免不了主观的成分。所以，下面的陈述并非论断，而只是"在我看来"。

HTML Template Layer

HTML应该尽量只用来表示结构，排除所有逻辑。

JSP, Velocity, Freemarker 等服务器端脚本逻辑，属于Java Code或者 Script Code对HTML 的污染。

不仅应该排除JSP, Velocity, Freemarker 等服务器端脚本逻辑，而且应该排除浏览器端脚本逻辑，比如Java Script.

当然，这里不是说，不用 Java Script，而是说，不要把Java Script 放在HTML里面。把Java Script 放在一个单独的.js 文件里面，在HTML中引入，并使用 CSS把HTML Element 和 Java Script Event Handler 联系起来。

这方面的资料有：

Unobtrusive Javascript
http://www.onlinetools.org/articles/unobtrusivejavascript/
http://www.kryogenix.org/code/browser/aqlists/
http://www.bobbyvandersluis.com/articles/goodpractices.php

如何排除HTML 中的Server Side Logic 呢？

Ajax!

Ajax fans 一定反应迅速，给出答案。

没错。Ajax 可以做到。Ajax 的主要问题在于使用和掌握难度。

除了Ajax 呢？

有几个选择，XMLC, Jivan, fastm, Wicket, Echo 等。(and Tapestry?)

fastm 是我做的一个模板层，具体内容可以在此下载。
https://fastm.dev.java.net/files/documents/1911/25042/fastm1.0c.zip

fastm采用 XML Comment 作为文档结构标记。注意，是结构标记，而不是逻辑标记。不含有 for if else。

可见，fastm 并不是毫无污染，只是没有逻辑污染。fastm 只在HTML中添加了自定义的结构标签，也勉强算没有违背 HTML只用来表示结构的原意。

Ajax, XMLC, Jivan 的HTML很干净，而且对HTML 结构的控制能力很强，能够用代码动态控制布局。fastm 也能够动态控制布局。Site mesh, tiles taglib, jsp, velocity, freemarker 等做不到。

fastm 里面的例子中，包括一个分页的例子，和一个动态组装 SQL的例子

Java Web Layer

Taglib, Tapestry Page Component, Echo, Wicket 等在Java 代码中输出HTML 标签，这也是一种，而且要求在Java 代码中使用框架特殊的HTML View Model，比如 Table, List, Label, Formbean 等View Object 。使用了这些框架，Java 代码的编译就需要依赖于这些框架了。

这相当于HTML 标签对Java 代码的污染。

JSP, Velocity, Freemarker 都不存在这种情况。Java 代码只是提供 POJO，然后 HTML 里面的Server Side Script使用这些 POJO．

fastm不支持逻辑，所以这个方面弱一些。 fastm要求Java Code 把if, else 等逻辑分支变成一个Map 结构。由于 Map属于java 的基本类，所以，fastm也不需要在 Java code中使用任何特殊的框架相关的view model 。

Web Layer - Stateless or Stateful

与其在服务器端支持 page flow, web flow, continuation，那不如在浏览器端支持状态。这种场合下，我觉得，正是使用 Ajax的最佳场所。

我倾向于这样的设计，服务器端尽量无状态，如果确实需要状态，那么尽量在浏览器段保持状态。

lightweb 是我做的一个Web框架。
https://lightweb.dev.java.net/files/documents/4371/25044/lightweb0.9b.zip

主要的特点是，URL-Centric, 鼓励无状态的Service Oriented 设计。支持三种Service模型，

• Action (like WebWork Action),

• Controller (like Spring MVC Controller),

• Channel (like Struts Action Dispatcher),

lightweb 支持多级模块寻找，使用几条匹配规则，代替庞大的Site Map 配置文件。

lightweb 查找View的时候，不是根据Site Map 文件里面的那种小型状态机的配置（success > showIt.jsp; fail> this page）, 而是直接资源定位。lightweb继承了 fastm的观点，把template 看作资源，而不是一段运行脚本。

Lightweb 设计为IoC友好。在各个环节都暴露出插件接口。程序员可以自己选择 IoC策略。可以采用一般的做法，用一个IoC container 集中管理，比如，Spring IoC, Pico, Nano等；也可以分散到各子模块，进行管理；也可以分散到每个 Action Validator里面管理。

ORM Layer

Hibernate 动态期间篡改用户代码，JDO静态期间篡改用户代码。

令我想起黑客，木马，夹带，偷梁换柱等。这属于语义上的 Pollution。就是说，从原有的Source 看起来，Domain Object并没有那样的行为，运行起来却有那样的行为。

iBatis采用 reflection，确实干净。但是，性能、功能上又不够强大。某些功能的实现，确实需要代码生成。

lightor是我做的一个 ORM框架。

https://lightor.dev.java.net/files/documents/4370/25043/lightor0.5a.zip

lightor也需要代码生成。区别在于， lightor不修改任何代码，只是产生新的 Mapper代码。Domain Object 运行的时候，还是你原来的Domain Object。这就避免了语义的污染。

lightor生成的 Mapper代码，可以编译期类型检查，可以阅读，跟踪，调试。这些生成的代码，也都遵循本文的原则。 Java 代码里面不含有SQL 片断，SQL 都存在于单独的资源文件中。

（另外，不采用CGLib ，也是为了实现的简单）

lightor直接使用 Native SQL。Lightor 的目的不是屏蔽关系数据库，而是恰好相反。lightor 的目的是，帮助程序员更清楚地认识关系数据库，SQL， JDBC。lightor 和JDBC不冲突，可以一起使用。

lightor努力的第一个主要方向就是效率。大数据量查询和处理的效率。

据我所知，目前只有 lightor才支持大数据量批量处理，因为只有lightor 不惜降低ORM的身份和封装层次，能够接受 ResultSet作为参数。

lightor的缓存策略比 Hibernate更前进了一步，把 query cache 和 ID Cache 集成在一起。以便得到更好的控制。并且，把缓存API暴露给程序员，以便智能的控制某个特定的缓存。

SQL

HQL, OQL 在SQL中引入了OO 语言的特性，似乎操作的是对象数据库，而不是关系数据库。

我感觉，这是一种语法层次上的 Domain Pollution。OO 语法对SQL语法的污染。

正如感觉LinkQ 是数据库查询语法对OO 语法的污染。

Java 代码中使用 Criteria API，也属于数据库查询领域对 OO领域的污染。

SQL是一种可读性很好，应用广泛的一种 DSL。

我的看法是，尽量把完整的 SQL放到单独的资源文件中，可以直接Copy 到SQL Client就可以运行。特殊优化过的 Native SQL，也是同样的地位。

HQL, OQL 阻碍了用户对SQL进行特殊优化。

如何动态拼装SQL ，一直是一个难以解决的问题。

直接在Java 代码中嵌入SQL ，肯定不行。前面说了，Java里面最好不要有 SQL片断，最好放到另外的资源文件中。

在Java 代码中使用 Criteria API? 前面也否定了。

在SQL Template 中加入动态语言脚本逻辑？比如 iBatis 使用XML if otherwise, OR Bridge 中使用velocity?

这种方法还是不错。不过仍然在 SQL里面引入了脚本逻辑。

我也没有好的做法。我采用 fastm来处理。在SQL 里面引入结构标记。这也相当于污染。因为SQL和 HTML不同。SQL 不是描述结构的，而是一门DSL。

这种做法的一个好处是，整段 SQL还是可以Copy 到SQL Client里面，稍微修改一番，就可以直接运行。

A Demo Forum

farum是我做的一个简单的 forum demo. 使用了 fastm, lightor, lightweb, 也尽量体现我前面提出的原则。
https://farum.dev.java.net/files/documents/4372/25045/farum0.5a.zip

我觉得，使用一门语言，应该尽量发挥它的特长，而不是针对它的短处，修修补补。

Java作为静态类型编译语言的好处，就是编译期类型检查。那么如何发挥这个优势？前面说的 Mapper源代码生成，就是一种尝试。

另外，其它的类似的胶水粘合部分，比如， IoC, Validation等，都可以进行这方面的尝试。目前，farum 就是采用这样的做法，自己写的Validator Source进行 validation, value setting, service implementation injection等工作。

farum没有使用 Dynamic Proxy, CGLib等动态篡改用户代码的做法。

尽量不使用Reflection ，因为Reflection 绕开了 Java 的类型检查机制。与其使用 reflection，真不如使用动态脚本语言。

当然，reflection 是非常难以避免的。farum 也少许使用了reflection。

Thread Local 是一种隐式契约，相当于绕开了显式契约（方法签名method signature）。 WebWork的一些用法，Spring Framework 的Open Session In View，等都是采用了 Thread Local。

farum没有采用 Thread Local，而是采用了另一种方法实现了 Open Session In view。而且如果缓存命中，甚至不需要从connection pool 中获取Connection 。

总结

<<Web 开发构想>>一文中，我提出了，理想中的 Web开发架构是这样的：

开发速度快，运行速度快，结构清晰优雅。

具体到每一层：

• Web 框架层主要追求 开发速度快。

• O/R 层主要追求 运行速度快。

• 页面资源层和页面模板层主要追求 结构清晰优雅。

下面就是我对这些理想的初步实现。

还远远达不到完美的程度，而只是朝这个方向努力。

Template Layer

fastm
https://fastm.dev.java.net/files/documents/1911/25042/fastm1.0c.zip

Web Layer

lightweb
https://lightweb.dev.java.net/files/documents/4371/25044/lightweb0.9b.zip

ORM Layer

lightor
https://lightor.dev.java.net/files/documents/4370/25043/lightor0.5a.zip

A forum demo using fastm + lightor + lightweb

farum
https://farum.dev.java.net/files/documents/4372/25045/farum0.5a.zip

----------

看了 **的 想到的
tekyDec 29, 2005 -  Show original item

看完后.明白**讲的为什么char** 不能自动转化为 const char**,(原文)但对我影响最深的是下面的话:

==================================================================
char *p="abc" 能不能编译通过要看你使用的编译器。鉴于大量遗留代码的存在，大部分编译器允许其通过，或者给个警告。当然，程序员自己必须保证绝不去修改其值。

程序员不应该在代码中出现*p='A'这样的语句。这是当初约定好了的：编译器允许char *p="abc"通过，而程序员保证不去修改它。
b. *p='A'编译时应该允许通过，因为单就这条语句而言，它完全合法。
c. 运行时*p='A'能不能通过要看实际的运行环境，包括你使用的操作系统、编译器、编译器选项 等等，一句话，其运行结果由不得你，且不应该由你去关心，因为这种行为本身已经违反约定了。
==================================================================

工作关系吧,用CString 和string用的太多了,很少这样定义字符串 char *p=“abcde“了
匝一看,还不适应,:(,渐渐的回想才想起一些来(哎,还是太生疏,赶快写下来,以后别忘了)

这样定义的字符串char *p=“abcde“ ; char *p1=“123445667“;

正如上面提到的是不能再 *p='A',运行的时候会出错,同样,strcpy(p,p1)也会出错哟,

"abcde"字符串可以看做是个常量字符串了,是不能被修改的,

但如果 char p[]=“abcde“ 这样定义,就没有问题,你可以修改*p='A',只要不越界就ok.

并且发现这样两种定义
char *p=“abcde“

char p[]=“abcde“

在运行的时候,p指向的地址也不是一样的,可见char *p=“abcde“还是有特殊的处理 :),具体怎么处理就不知道了,高手请指教:)

随着测试,又发现个问题,可能是个老问题了吧:

int main(int argc, char* argv[])
{
 int t[10];
 char p1[7]="123456";
 const char *p2="1234567890123213123";
 
 int len(0);
 
  //*p1='C';  err

 len=strlen(p1);
 printf("%d\n",len);
 
 strcpy(p1,p2);   ///??????????
 
 printf("%s\n",p1);
 
 len=strlen(p1);
 
 printf("%d\n",len);
 return 0;
}

我定义的是7个字符数组, 但用strcpy把p2拷到p1中,p1是放不下的,但程序却正常执行,warning ,err都没有,运行也正常?

输出

6
1234567890123213123
19

应该是使用内存越界了阿??怎么会正常运行呢?

难道对于内存越界的使用,运气好才崩溃表现出来,运气不好就正常运行??

    1、机器一台

　2、电池一块 注意:按行货的装相方法，电池和机器是分开的，因为香港人拿到机器要先验屏有无坏点， 所以电池就装在机器上了。

　3、适配器一套3头为英制，香港货和新加坡货都是这种。2头为美制，美国货是这样的。

　4、电话线一根，接猫上网的，现在很少人用了。

　5、说明书一套。多数均为T40版的，猜测是IBM为了节约成本，所以T40，T41，T42，T43都用同一套说明书。

　6、小红帽两个。为将来原配的脏了更换的。

　7、固定螺丝一颗用来固定互换光区的，防止别人插拔。

第2页：检查外观、验证SN号

    接下来就要看外观了，有没有划伤，毕竟外观也是很重要的，要检查外观有无硬商如果有及时更换。特别要注意平时不太注意的细节，比如机器底部、键盘还有屏幕。

 　开机进BIOS，先查看机器大概的配置，主频，内存，还有关键的两个号码，SN号和UUID号码。SN号是机器唯一的序列号，没有重复的，从BIOS里查到的SN号要和包装箱的，机器背面的，还有用测试软件测出来的都对上，才算完整。

　UUID号码是主板序列号。只显示在BIOS里和包装箱上，这两处也要对上。另外要和用测试软件测出的UUID号也对上。如果机器主板被动过，那UUID号是会改变的。

第3页：检查屏幕、电池和保修

　开始进入系统，测试屏幕，可以用专业的测试软件，网上有很多像Nokia的软件等等，主要检查坏点和亮点。

    查看电池充电次数，一般来说，不超过两次。如果是旧电池的，这一步是逃不过去的，而且以目前的技术，还没有哪个高手可以刷新充电次数

    一定要上网查询保修期限和核对附件的编号

    具体网址：http://www-3.ibm.com/pc/support/site.wss/warranty/warranty.vm 

  在TYPE一栏中输入机器型号，如2373在Serial#一栏中输入机器SN号，然后点Continue，或者点击开会出现保修信息。

    有本机器的保修期限和销售地。

    特别说明：因为过海关是机器和包装箱分开过的，然后到深圳再一对一的装箱，难免适配器和电话线装错，有可能造成这两个部件的号码和网站显示号码难以对上。除此之外，机器的硬盘编号，电池编号等等都是能对上的。另外次编号是IBM为自己的配件所做的出厂编号，很多测试软件是测不出来的。最后一点检查是否带有COA标 。

Problem Statement

Definition

 1public class CursorPosition
 2{
 3
 4        public int getPosition(String ks,int len)
 5        {
 6                int pos = 0;
 7                char c ;
 8                for(int i=0;i<ks.length();i++)
 9                {
10                        c = ks.charAt(i);
11
12                        if(c=='E')
13                        {
14                                pos = len;
15                        }
16                        else if(c=='H')
17                        {
18                                pos = 0;
19                        }
20                        else if(c=='L')
21                        {
22                                if(pos>0)
23                                {
24                                  pos--;
25                            }
26                        }
27                        else if(c=='R')
28                        {
29                                if(pos<len)
30                                {
31                                  pos++;
32                            }
33
34                        }
35                }
36
37        return pos;
38        }
39
40}

Feedback

Problem Statement

 4 3 5
 2 4 5
 0 1 9

Definition

public class MatrixTool
{

        public String[]  convert(String str)
        {
                String[] matrix = null;
                if(str==null || str.length()<1)
                {
                        return matrix;
                }

                int total = str.length();
                double d = total/1.0;
                int len = (int)Math.sqrt(d);

                //check

                for(int i=0;i<total;i++)
                {

                        if(str.charAt(i)>='0' && str.charAt(i)<='9')
                        {
                        }
                        else
                        {
                                System.out.println("invaid charareter.");
                                return matrix;
                        }
                }

                if(len*len == total)
                {
                        matrix = new String[len];
                        for(int i=0;i<len;i++)
                        {
                           matrix[i] = "";
                           for(int j=0;j<len;j++)
                           {
                              matrix[i]+= str.charAt(i*len+j);
                           }
                        }

                }
                return matrix;

        }
       
        public static void main(String args[]){
          MatrixTool mt = new MatrixTool();
          String[] temp = mt.convert("435245019");
          for(int i=0;i<temp.length;i++){
            System.out.println(temp[i]);
          }
        }

}

Feedback

【拒女淫奔】

明朝宁波地方有位叫孙道的读书人，因家里贫穷，就靠着教导孩童读书，作为生活的经济来源。后来连这份职业也不保，于是寄身到塘西 张氏家，帮忙抄抄写写，换取衣食。有一天深夜，张家有一婢女，偷偷的跑到孙道的房间，孙道知其来意，严词的拒绝。而这情景，却被张家的私塾老师看见，老师 就私下招婢女相会。到了端午节时，该名老师疽疮发作，无法痊愈，这时主人只好请孙道升任老师。

有一天，孙道在江口碰到他的叔叔，他的叔叔惊讶的说：「我因儿子的病，在城隍庙祈祷，当天晚上就作了一个梦，梦见城隍爷坐在殿上，呼唤属下将命中本 要饿死的人，将其名字删改，名字一个一个的念，念到大概十几人，我就听到你的名字。我偷偷的问那冥官，为什么孙道可以改去？冥官说：『这个人的本命，在四 十六岁时，会饿死他乡。因为今年四月十八日夜晚，严拒婢女淫奔，所以延长寿命二纪（一纪等于十二年），改饥馑籍为禄籍。』」

后来，跟着孙道学习的学生，越来越多，每年学生所贡上的学资就百余两黄金。到了明万历三十六年，孙道四十六岁，也就是他命中本该饿死的那年，果然闹 饥荒，米价变得十分昂贵，穷人根本无钱购买，当时饿死的人很多。但是，孙道不但逃过这一劫，而且还十分的富裕，到了晚年，孙府已成巨富之家。在他七十岁 时，应验延寿二纪，无疾而终。

【艳福非福】

裴章，山西省河东地区人，他的父亲与神僧昙照法师极为友善。昙师精于相术，他看裴章的相，天庭饱满，地阁方圆，将来的功名事业，一定很有成就。

裴章二十岁时，娶妻李氏，隔年裴章到太原作官，妻子则留在家中。数年后，裴章又遇见昙照法师，昙师十分惊讶的说：「多年以前，我看你是显贵之相，现 在怎么变了呢？过去你的天庭饱满，现在怎么天庭有倾陷之象呢？过去你的地阁方圆，现在怎么地阁尖削了呢？再看你的掌心有黑气盘绕，恐有不测之祸，宜谨慎防 范。你的相变得这样多，不知做了什么缺德的事？」

裴章听了，自己反省数年来的所作所为，只有在太原与女人私通，算是有违伦理，其它并无做出有亏良心的事。昙照法师叹了一口气说：「你本来有美好的前 程，奈何不知珍重，与别的女人行淫，你这样自己摧残福德，实在太可惜。」过不多久，裴章真的如昙照法师预言有灾祸临身。有一次，裴章在浴室洗澡，他的部下 进入行刺，刀中腹部，五脏尽出而死。

【邪淫果报】

非正式夫妻而行淫事者，是为邪淫。此事天地所不容，神鬼所愤怒。一有此心，虽未行其事，已大损阴骘。实犯者，非仅己身必有灾祸，且殃及家室子孙；不惟现世感受苦果，更延及未来长劫。

邪淫之事，即是以短暫之時光，造弥天之罪恶。是故凡犯邪淫者，由此而夺命者有之，由此而减禄者有之，由此而破家者有之，由此而绝嗣者有之。或有命中 本该富贵尊荣，因而贫困潦倒终生；或有命中本是寿山福海，却遭外伤内病夭亡；或有妻女原是贞良贤淑，却成他人淫玩伴侣。邪淫现世恶报，莫论古之典籍记述甚 多，今之报章亦日日刊载。凡此报导，若细心探其前因后果，则知祸福无门，惟人自召；善恶之报，如影随形。

淫恶之报，天律最严。奸人妻女，玷人闺门，在地狱中受苦五百劫，方得脱生为驴为马，又五百劫，乃复人身，为娼为优。设谋造计，奸宿寡妇尼 僧，败人操履，在地狱中受苦八百劫，方得脱生为羊为豕，供人宰杀，又八百劫，乃复人身，为瞽为哑。以卑乱尊，以长乱幼，败坏纲常，在地狱中受苦一千五百 劫，方得脱生为蛇为鼠，又一千五百劫，方得人身，或在母胎中死，或在孩抱中亡，毕竟不享天年。」

地狱之苦，苦不堪言。书云：「地狱诸苦，极难堪忍；于一日中，以三百矛，无间猛刺，所有痛苦，于地狱中，微苦少分，亦莫能比。」若入无间地狱，超脱 之日更是遥遥无期。智者深思，一时半刻，换得长劫大苦。至愚者莫此为甚！至惨者莫此为甚！（劫：时间单位，约合十三亿四千三百八十四万年）

普劝世人，未曾犯邪淫者，当自庆幸，并务期懔懔守持，谨防失足。俊美面容，须知是带肉骷髅；姣好身躯，不过是缠筋骼骸。薄皮包裹脓血屎尿， 九孔常出不净秽物。花瓶盛粪，人不把玩；蒙衣漏厕，岂值贪恋！前贤云：「他诱我杀身破家、损寿折福，实害我性命的物事，该把作杀人利刃看、作虎狼看、作毒 蛇看、作勾魂鬼使看、作前生怨对看。」

当邪缘凑临时，要有斩钉截铁之气势，毅然立定脚跟；急思，身旁鬼神怒目切齿见我一举一动；头上三台明察秋毫看我一言一行。若一念失守，子孙 之富贵福禄在此断送；阎王之严惩簿上由此具名。现生则神诛鬼戮破家败身，殁后堕入地狱极刑伺候。知好歹者，能不忍乎哉！能不力退邪缘哉！

邪淫之罪已是极重，引发他人邪淫其罪更重。天戒录云：「造作淫书，坏人心术，死入无间地狱，直至其书灭尽，因其书而作恶者，罪报皆空，方得脱生。」 由此可知，印造淫书者，阴惩当是无量无边；贩卖流通者，果报必定非轻非浅。而今之色情光盘与网站，乱人心志尤甚淫书，凡制作者、租售者、展转流通者，其所 感之祸殃恶果，岂不更为凄惨酷烈乎！

引发他人邪淫之罪既重，则知杜防他人邪淫之功必广。杜防之道，展转流通福善祸淫之文以警世人，是为其一。若因而劝诫多人不犯邪淫，则阖潭将可久膺多 福，裔世也能长发其祥。若曾自犯邪淫者，或曾引发他人而犯者，应痛切悔改，力行此事。以杜邪之功，劝善之德，并以改往修来之恳到心，忏赎昔日之罪愆，庶几 可消减祸殃。若功深德厚，则灾障消而福星照临也。

【寿康宝鉴劝读文】

当今之世，古道沦亡。色情光盘，垂手可得；网际网络，助长嚣风。欲火焚烧，何能制心；心若不制，淫恶难除。望我同胞，切勿观看；一念稍疏，陷溺难 返。寿康宝鉴，欲海清流；圣贤垂训，福善祸淫。时时警惕，置之座右；日日阅读，神清气爽。盛德君子，贞洁淑媛；人人赞叹，鬼神钦敬。灾障消灭，福寿绵延； 家运日隆，民风日美。是为劝！

【如何取得寿康宝鉴】

电子书:请上

http://www.bfnn.org

点选般若文海简体,再点选戒淫文选,再点选寿康宝鉴。文言文,词句优美,读诵较为顺畅。并可点选寿康宝鉴白话编译对照。

【放生免瘟疫】

江苏太湖附近的人家，多数是网鸟捉鱼为生，而沈文宝及其家人，却见人捕获鱼鸟，常常买来放生。有一年，瘟疫流行，有人夜里看见疫鬼拿旗一把说：「除了放生的沈家，其余的家门都要插旗。」没多久，全村感染疫病而死的超过大半，只有沈文宝家没人被传染。

【戒杀放生 增福延寿】

若想长寿，则应放生，《放生赞》云：「汝欲延生听我语，凡事惺惺须求己，汝欲延生须放生，此是循环真道理。他若死时你救他，你若死时天救你，延生生子无别方，戒杀放生而已矣。」又弥勒菩萨偈云：「劝君勤放生，终久得长寿，若发菩提心，大难天须救。」

有些人的病症，是宿世或今生杀业的果报，此种怨业病，医药很难起作用，若行放生增长善业，医治则较能得力。杭州有一个打鸟为业的人，背上长疮，大夫 无能为力，慢慢的，他自己知道是今生杀生的果报，于是发誓不再杀生，并作放生，此后诊治便有了效力而逐渐痊愈。在西藏也有很多被医生诊断为必死的病人，经 家人去放生、念经，就逐渐恢复生命的活力。尤其是医生无法诊断的怪病，均是自己宿世或今生杀害众生的业感现前，此时，惟有放生为好。

在清朝道光年间有一位太守，身患重病，正在生命垂危之际，他发誓愿云：「从今之后，饶益一切有情，忏悔自己的业障。」当夜，观世音菩萨在梦 中示现对他说：「你昔日杀业重，今得短命报，幸好此时，能发坚固誓愿，惟有放生可以延寿，且可增福禄。」他醒后大有感悟，于是全家戒杀，常常放生，后来其 病体真的痊愈了。

最近西藏炉霍县有一位牧民，多年患疾，十分痛苦，去过很多医院，皆无效益。后来有一位僧人打卦说：「妳前世杀生极多，若不放生，则短命多病。」此后她发心放生，渐渐就无病无苦，如今她特别相信因果，每年皆捐款放生。

若遭遇严重的疾病而接近死亡寿尽之时，只有放生，才能增福延寿。从前苏州有一位王大林，每当看见村中的小孩们捕捉玩弄鱼鸟等动物时，他就致 力劝止并给钱赎来放生，他说：「少年时，必须培养爱惜物命的美德，不可养成残忍好杀的坏习气。」他孜孜不倦劝人行善断恶，在他六十一岁将死时，于自己觉知 的境界中，听到圣尊告诉他说：「你平生放生，有极大功德，将可增福延寿三十六年。」后来在他九十七岁时无病善逝。

同样有一位叫果才的藏族人，由很多空行母等具神通者说，他只能活三十一岁，若能放生诵咒，尚可延寿，他立即放生甚多，每年放生护生，今已五十岁。还 有相同的实事，从前有一位屈师，到市镇去买一条赤色鲤鱼放生，后来屈师生病时梦见龙王，并对他说：「先生本来寿命已尽，因救龙子一命，增延福寿十二年。」 他救鲤鱼时四十八岁，后来活到六十岁。所以，在人间寿命不长的人，应当发心放生，才能增福延寿。

四川遂宁市有一位医生，她在海内外影响极大，她的家里挂满了锦旗，这些锦旗都是经其治疗而痊愈的病人所敬献的，以此感谢并表彰其医术的高 明，现在她已是成千上万人的救命恩人。经过她治愈的人都说，当医疗无效时，这位医生就劝病人放生、念经等，遵照嘱咐，广行放生等善行后，许多病人的身体就 慢慢康复。因此可说，放生是一种特异功能的治病方法。

相反，杀生则是短命多病的直接之因。本来能活长久的人，若喜欢杀生，则成短命。西藏阿梨阿旺扎巴云：「若行救命放生者，短命亦成长寿，若杀鱼蛇等含生，长寿者亦成短命。」自古以来，放生转短命为长寿者，不胜枚举。

我们若能时时以慈心推及物类，自己做到戒杀放生，又广劝他人戒杀放生，则一切事必能吉祥如意，正如《太上感应篇》所说的「吉神佑之，福禄随之。」华 智仁波切亦云：「恒时行善放生者，护法地神常佑彼。」《护生的故事》云：「如影随形，古今善恶报应，昭昭分明，感应事迹，历历在目，尚有何疑？」

【杀生为因 瘟疫为果】

世间至重者，性命也；天下最惨者，杀伤也。由杀生故，怨业积累，戾气所感，遂有瘟疫天灾。

【同念南无观世音菩萨，消灾免难】注:南无音拿摩

观世音菩萨，誓愿宏深，寻声救苦。若遇刀兵、水火、饥馑、虫蝗、瘟疫、旱涝、贼匪、怨家、恶兽、毒蛇、恶鬼、妖魅、怨业病、小人陷害等患难者，能发改过迁善，自利利人之心，至诚恳切念观世音，念念无间，决定得蒙慈护，不致有何危险。