1 针对性
文档编制以前应分清读者对象,按不同的类型、不同层次的读者,决定怎样适应他们的需要。
① 对于面向管理人员和用户的文档,不应像开发文档(面向软件开发人员)那样过多地使用软件的专业术语。 难以避免使用的词汇,应在文档中添加词汇表,进行解释。
② 开发文档使用的专业词汇未被广泛认知的,应添加注释进行说明。
③ 缩写词未被广泛认知的,应在其后跟上完整的拼写。
2 正确性
① 没有错字,漏字。
② 文档间引用关系正确。
③ 文档细节(Title/History)正确。
3 准确性
① 意思表达准确清晰,没有二义性。
② 正确使用标点符号,避免产生歧义。
4 完整性
① 意思表达完整,能找到主语、谓语、宾语,没有省略主语,特别是谓语。
② 一句话中不能出现几个动词一个宾语的现象。
③ 不遗漏要求和必需的信息。
5 简洁性
① 尽量不要采用较长的句子来描述,无法避免时,应注意使用正确的标点符号。
② 简洁明了,不累赘冗余,每个意思只在文档中表达一次。
③ 每个陈述语句,只表达一个意思。
④ 力求简明,如有可能,配以适当的图表,以增强其清晰性。
6 统一性
① 统一采用专业术语和项目规定的术语集。
② 同一个意思和名称,前后描述的用语要一致。
③ 文档前后使用的字体要统一。
④ 同一课题若干文档内容应该协调一致,没有矛盾。
7 易读性
① 文字描述要通俗易懂。
② 前后文关联词使用恰当。
③ 文档变更内容用其他颜色与上个版本区别开来。
④ 测试步骤要采用列表的方式,用1)、2)、3)…等数字序号标注。
posted @
2007-05-27 08:21 CHUANDAOJUN 阅读(872) |
评论 (0) |
编辑 收藏
以下配置环境是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中 会给出特定的界面 给你配置 比较方便
posted @
2007-05-15 13:39 CHUANDAOJUN 阅读(901) |
评论 (0) |
编辑 收藏