1 针对性

 文档编制以前应分清读者对象，按不同的类型、不同层次的读者，决定怎样适应他们的需要。    

   ① 对于面向管理人员和用户的文档，不应像开发文档(面向软件开发人员)那样过多地使用软件的专业术语。 难以避免使用的词汇，应在文档中添加词汇表，进行解释。    

   ② 开发文档使用的专业词汇未被广泛认知的，应添加注释进行说明。

   ③ 缩写词未被广泛认知的，应在其后跟上完整的拼写。    
        

2  正确性 

   ① 没有错字，漏字。

   ② 文档间引用关系正确。 

   ③ 文档细节(Title/History)正确。    
        
3  准确性

   ① 意思表达准确清晰，没有二义性。

   ② 正确使用标点符号，避免产生歧义。    
        
4  完整性 

   ① 意思表达完整，能找到主语、谓语、宾语，没有省略主语，特别是谓语。

   ② 一句话中不能出现几个动词一个宾语的现象。

   ③ 不遗漏要求和必需的信息。    
        
5  简洁性 

   ① 尽量不要采用较长的句子来描述，无法避免时，应注意使用正确的标点符号。

   ② 简洁明了，不累赘冗余，每个意思只在文档中表达一次。  

   ③ 每个陈述语句，只表达一个意思。    

   ④ 力求简明，如有可能，配以适当的图表，以增强其清晰性。    
        
6  统一性 

   ① 统一采用专业术语和项目规定的术语集。

   ② 同一个意思和名称，前后描述的用语要一致。 

   ③ 文档前后使用的字体要统一。    

   ④ 同一课题若干文档内容应该协调一致，没有矛盾。    
        
7  易读性 

   ① 文字描述要通俗易懂。 

   ② 前后文关联词使用恰当。  

   ③ 文档变更内容用其他颜色与上个版本区别开来。 

   ④ 测试步骤要采用列表的方式，用1)、2)、3)…等数字序号标注。 

 

（当前地址是：http://localhost:8080/foo/stuff.html）

重定向：   URL地址不是以“/”开头：

                   response.sendRedirect(http://www.google.com);

                  现在的地址是：http://www.google.com



                   URL地址是以“/”开头：

                   response.sendRedirect(/http://www.google.com);

                  现在的地址是：http://localhost:8080/http://www.google.com（当让这样的地址你会看到一个404错误，在这我只是为了理解更方便一点）

总结：从上面的内容我们看到，通过sendRedirect后url 的地址发生了变化， 我们通常叫他客户端跳转。


请求分派：RequestDispatcher有两种方法得到：
                    1、request.getRequestDispatcher("/result.jsp");或request.getRequestDispatcher("result.jsp");
                          如果是由request引导的，那么“/”可有可无
                    2、getServletContext().getRequestDispatcher("/result.jsp");
                           如果是由getServletContext()引导的，那么必须让“/”开头
总结：尝试后，你会发现，通过getRequestDispatcher后url 的地址没有发生变化， 我们通常叫他服务器端跳转。

另外再多嘴一句：ServletContext 接口下有一个getNamedDispatcher("name");name是Servlet或jsp的名字而不是路径（需要在web.xml中定义他们的路径）是为了以后修改方便

以下配置环境是SQL Server 2000、Tomcat5.0.28

1、把msbase.jar、sqlserver.jar、msutil.jar三个文件拷贝到%TOMMCAT_HOME%\common\lib 目录下

2、在webapp下新建一个文档，再在%TOMCAT_HOME%\conf\Catalina\localhost\ 新建一个与webapp下文档名相同的.xml

3、把一下文件拷贝到上面新建的.xml中（注：也可以把以下内容拷贝到%TOMCAT_HOME%\conf、servlet.xml中，第2步新建.xml就可以省略[不过有个弊端参阅：5]）
<?xml version="1.0" encoding="GB2312"?>
<Context path="/（webapp下新建的文档）"> 
  <Logger className="org.apache.catalina.logger.FileLogger"prefix="localhost_admin_log." suffix=".txt" timestamp="true"/>
 <Resource type="javax.sql.DataSource"  auth="Container"  name="（数据源名字）"/> 
    <ResourceParams name="（数据源名字）"/> 
      <parameter>
        <name>maxWait</name> //最大等待时间
        <value>5000</value>
      </parameter>
      <parameter>
        <name>maxActive</name>//最大连接数：达到这个数字时候 就不要在连接
        <value>4</value>
      </parameter>
      <parameter>
        <name>maxIdle</name> ///最大的维持数：如果没有用户连接时候 连接池中保持 这么多个连接
        <value>2</value>
      </parameter>     
   <parameter>
        <name>username</name>
        <value>sa</value>
      </parameter>
      <parameter>
        <name>password</name>
        <value></value>
      </parameter>
      <parameter>
        <name>url</name>
        <value>jdbc:microsoft:sqlserver://localhost:1433;databaseName=（数据库名）</value>
      </parameter>
      <parameter>
        <name>driverClassName</name>
        <value>com.microsoft.jdbc.sqlserver.SQLServerDriver</value>
      </parameter>      
    </ResourceParams>  
</Context>

4、如果你在Eclipse或JBuilder 中开发的话，你需要在你的Web应用程序的WEB-   INF\Web.xml文件中注册数据源，文件添加如下内容： 
    <resource-ref>
          <res-ref-name>jdbc/northwind</res-ref-name>
           <res-type>javax.sql.DataSource</res-type>
          <res-auth>Container</res-auth>
    </resource-ref>

5、忠告在做任何配置时最好不要修改Tomcat服务器的任何文件，如servel.xml或web.xml文件，而所有的操作和配置都可以在你自己的应用配置文件中来完成，这样即使培植错误也不至于服务器的崩溃。

6、撰写测试文档
   <%@ page import="java.sql.*"%>
   <%@ page import="javax.sql.*"%>
   <%@ page import="javax.naming.*"%>
   <%!
      final String  JNDINAME="java:comp/env/(数据源名字)" 
    %>
   <%
      Connection conn =null;
     try
    {
     //初始化查找命名空间
     Context ctx = new InitialContext();
     //找到DataSourse
     DataSource ds = (DataSourse)ctx.lookup(数据库名);
     conn = ds.getConnection();
    }
     catch(Exception e){
      System.out.println(e);
    }
   %>

备注：在Tomcat 5.5.xx中使用以前的配置方式，会出现以下问题：“Cannot create JDBC driver of class '' for connect URL 'null'”。
解决方法是，把如下格式的Resource描述插入server.xml 的<Context></Context>中：
<Resource name="jdbc/db" type="javax.sql.DataSource" username="sa" password=""
driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
maxIdle="2"maxWait="5000" url="jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=jspdev" maxActive="4"/>
用以取代以上的配置方式。
在Tomcat中配置数据源很复杂 但在weblogic和websphere中 会给出特定的界面 给你配置 比较方便