http://www-128.ibm.com/developerworks/java/library/x-jaxp

Brett McLaughlin

Document Object Model (DOM)

Simple API for XML (SAX)

JDK1.4

javax.xml.parsers
javax.xml.transform
javax.xml.transform.dom
javax.xml.transform.sax
javax.xml.transform.stream

JDK5.0

javax.xml
javax.xml.datatype
javax.xml.namespace
javax.xml.parsers
javax.xml.transform
javax.xml.transform.dom
javax.xml.transform.sax
javax.xml.transform.stream
javax.xml.validation
javax.xml.xpath

严格来说， JAXP 并没有提供新的解析 XML 的方法，但是它使得我们更容易地使用 DOM 或者 SAX 来进行解析任务，更能以一种 vendor-neutral 的方式来使用 DOM 和 SAX 。

JAXP 与 SAX, DOM, JDOM 和 dom4j （这四个都可以解析 XML ）没有可比较性，它并没有提供一个新的解析 XML 的方法。

JAXP API, located in the javax.xml.parsers package. All of these classes sit on top of an existing parser. 其中的 6 个类都是建立在已有的解析上面的。

JDOM 与 dom4j 都提供不同的模型来接受来自 SAX/DOM 的数据，他们从内部来讲都是使用了 SAX ，不过是做了些修改。

此外， Java 1.5 中 Xerces 的包 org.apache.xerces 被放到了 com.sun.org.apache.xerces.internal

First, com.sun.xml.tree.XMLDocument class is not part of JAXP. It is part of Sun's Crimson parser, packaged in earlier versions of JAXP.

Second, a major purpose of JAXP is to provide vendor independence when dealing with parsers. With JAXP, you can use the same code with Sun's XML parser, Apache's Xerces XML parser, and Oracle's XML parser.

先从 SAX 说起，我们只用继承 DefaultHandler 类 (org.xml.sax.helpers 包中 ) 就能获得所有的 callbacks ，只用在需要的方法中加入实现的代码。

Here's the typical SAX routine:

1 ． Create a SAXParser instance using a specific vendor's parser implementation.

2 ． Register callback implementations (by using a class that extends DefaultHandler, for example).

3 ． Start parsing and sit back as your callback implementations are fired off.

SAX 必须 指定 XML 驱动（如 org.apache.xerces.parsers.SAXParser ），而 JAXP 提供了更好的选择，只要我们提供什么 XML 驱动（在 classpath 中配置），它就调用什么驱动，不需要改动代码。

new SAXParserFactory.newSAXParser() 就返回 JAXP SAXParser 类，这个类包装了 SAX parser (an instance of the SAX class org.xml.sax.XMLReader ) 。

In Listing 1, you can see that two JAXP-specific problems can occur in using the factory: the inability to obtain or configure a SAX factory, and the inability to configure a SAX parser.

The first of these problems, represented by a FactoryConfigurationError, usually occurs when the parser specified in a JAXP implementation or system property cannot be obtained.

The second problem, represented by a ParserConfigurationException, occurs when a requested feature is not available in the parser being used. Both are easy to deal with and shouldn't pose any difficulty when using JAXP.

SAXParser 的 parse 方法可以接受 SAX InputSource ， Java InputStream 或者 URL in String form

可以通过 SAXParser 的 getXMLReader() 方法来获得底层的 SAX parser （ org.xml.sax.XMLReader 的实例），这样就可以使用各个 SAXParser 方法。 [ 参照 Listing2]

使用 DOM  

The only difference between DOM and SAX in this respect is that with DOM you substitute DocumentBuilderFactory for SAXParserFactory, and DocumentBuilder for SAXParser.

The major difference is that variations of the parse() method do not take an instance of the SAX DefaultHandler class. Instead they return a DOM Document instance representing the XML document that was parsed. The only other difference is that two methods are provided for SAX-like functionality:

• setErrorHandler(), which takes a SAX ErrorHandler implementation to handle problems that might arise in parsing
• setEntityResolver(), which takes a SAX EntityResolver implementation to handle entity resolution

JAXP 的使用

1. Source for input

The javax.xml.transform.Source interface is the basis for all input into JAXP and the transformation API. This interface defines only two methods -- getSystemId() and setSystemId(String systemId) .

JAXP 提供了三个实现 Source 接口的类：

• javax.xml.transform.dom.DOMSource passes a DOM Node (and its children) into JAXP.
• javax.xml.transform.sax.SAXSource passes the results of SAX callbacks (from an XMLReader ) into JAXP.
• javax.xml.transform.stream.StreamSource passes XML wrapped in a File , InputStream , or Reader into JAXP.   

2. Result for output

  javax.xml.transform.Result 也有两个方法： getSystemId() 和 setSystemId(String systemId) 。 同样有三个实现类：

• javax.xml.transform.dom.DOMResult passes transformed content into a DOM Node .
• javax.xml.transform.sax.SAXResult passes the results of a transformation to a SAX ContentHandler .
• javax.xml.transform.stream.StreamResult passes the transformed *ML into a File , OutputStream , or Writer .

3. Performing transformations with JAXP

1)Getting a Factory     

JAXP this way has two significant limitations:

• The Transformer object processes the XSL stylesheet each and every time transform() is executed.
• Instances of Transformer are not thread-safe. You can't use the same instances across multiple threads.

Transformer 实例不是线程安全的，不能通过多线程去使用同一个 Transformer 实例。

5)Loading a Template

javax.xml.transform.Templates .

The Templates interface is thread-safe (addressing the second limitation) and represents a compiled stylesheet (addressing the first limitation).

Templates 实例是线程安全的，可以处理一堆 XSL ，解决了上述两个限制。

6)From Transformer to Templates

如果只要对一个 stylesheet 进行一个 transformation ，那么用 Transformer 比较快，没有必要选择 Templates 对象。但是考虑到线程安全问题，还是推荐使用 Templates 。

7)Changing the XSL processor

JAXP 默认使用 Xalan-J ，如果要使用其它 parser ，可以通过 javax.xml.transform.TransformerFactory 修改。


java -D javax.xml.transform.TransformerFactory=[transformer.impl.class] TestTransformations  simple.xml simple.xsl

http://sourceforge.net/docman/display_doc.php?docid=31070&group_id=1

功能特性：

Subversion 官方网站，查看 http://subversion.tigris.org/

欣慰的是这里有个网站提供一本免费的、非常棒的 SVN 图书，可以选择在线查看或者下载 PDF ， SVN 使用者必读。 http://svnbook.red-bean.com/

各个版本控制系统功能比较的文章

http://better-scm.berlios.de/comparison/comparison.html

Subversion 使用手记 中文英文对照

http://robinlet.bokee.com/2866408.html

一篇文章介绍如何将 CVS 的 Repository 转换成 SNV

http://up-u.com/?q=node/232

转换方法来自这个程序 http://cvs2svn.tigris.org/

官方的那本书是最好的教程，网上还有大量的安装和使用的文章可以借鉴，这里简单罗列几个 SVN 辅助的软件：

1 、 SubVersion ，从 http://subversion.tigris.org/

下载，是实现服务系统的软件，必装的。

2 、 TortoiseSVN ，从 http://tortoisesvn.tigris.org/

下载，是很不错的 SVN 客户端程序，为 windows 外壳程序集成到 windows 资源管理器和文件管理系统的 Subversion 客户端，用起来很方便。

3 、 SVNService.exe ，从 http://dark.clansoft.dk/~mbn/svnservice/

下载，是专为 SubVersion 开发的一个用来作为 Win32 服务挂接的入口程序。

4 、 AnkhSVN ，从 http://ankhsvn.tigris.org/

下载，这是一个专为 Visual Studio 提供 SVN 的插件。

5 、 Subversive ，从 http://www.polarion.org/p_subversive.php

下载，一个为 Eclipse 提供 SVN 的插件，据说已经和 Eclipse 自带的 CVS 功能有一拼。

6 、还有很多很多 SVN 相关的工具以及使用 TIP 介绍，大家可以上官方的相关链接页面中查看，地址： http://subversion.tigris.org/links.html

Linux 下软件的安装主要有三种不同的形式。

第一种安装文件名为 xxx.tar.gz ；

第二种安装文件名为 xxx.i386.rpm ，

还有一种是 xxx.src.rpm 。

以第一种方式发行的软件多为以源码形式发送的；

第二种方式则是直接以二进制形式发送的；

第三种是 rpm 格式发布的源码。

对于第一种 [xxx.tar.gz] ，安装方法如下：
　　 1 . 首先，将安装文件拷贝至你的目录中。例如，如果你是以 root 身份登录上的，就将软件拷贝至 /root 中。
　　 #cp xxx.tar.gz /root
　　 2 . 由于该文件是被压缩并打包的 , 应对其解压缩。命令为：
　　 #tar xvzf filename.tar.gz
　　 3. 执行该命令后，安装文件按路径，解压缩在当前目录下。用 ls 命令可以看到解压缩后的文件。通常在解压缩后产生的文件中，有 “Install” 的文件。该文件为纯文本文件，详细讲述了该软件包的安装方法。
　　 4. 执行解压缩后产生的一个名为 configure 的可执行脚本程序。它是用于检查系统是否有编译时所需的库，以及库的版本是否满足编译的需要等安装所需要的系统信息。为随后的编译工作做准备。命令为： #./configure
　　 5. 检查通过后，将生成用于编译的 MakeFile 文件。此时，可以开始进行编译了。编译的过程视软件的规模和计算机性能的不同，所耗费的时间也不同。命令为： #make 。
　　 6. 成功编译后，键入如下的命令开始安装：
　　 #make install
　　 7. 安装完毕，应清除编译过程中产生的临时文件和配置过程中产生的文件。键入如下命令：
　　 #make clean
　　 #make distclean
　　至此，软件的安装结束。
　　
对于第二种 [xxx.i386.rpm] ，其安装方法要简单得多。
　　同第一种方式一样，将安装文件拷贝至你的目录中。然后使用 rpm 来安装该文件。命令如下：
　　 #rpm -i filename.i386.rpm
　　 rpm 将自动将安装文件解包，并将软件安装到缺省的目录下。并将软件的安装信息注册到 rpm 的数据库中。参数 i 的作用是使 rpm 进入安装模式。
　　

软件的卸载
　　 1. 软件的卸载主要是使用 rpm 来进行的。卸载软件首先要知道软件包在系统中注册的名称。键入命令：
　　 #rpm -q -a
　　即可查询到当前系统中安装的所有的软件包。

　　 2. 确定了要卸载的软件的名称，就可以开始实际卸载该软件了。键入命令：
　　 #rpm -e [package name]
　　即可卸载软件。参数 e 的作用是使 rpm 进入卸载模式。对名为 [package name] 的软件包进行卸载。由于系统中各个软件包之间相互有依赖关系。如果因存在依赖关系而不能卸载， rpm 将给予提示并停止卸载。你可以使用如下的命令来忽略依赖关系，直接开始卸载：
　　 #rpm -e [package name] -nodeps

忽略依赖关系的卸载可能会导致系统中其它的一些软件无法使用

对于第三种 [xxx.src.rpm] ，安装也很简单
拷贝到目标目录，然后执行
#rpmbuild --rebuild xxx.src.rpm 编译文件
然后进入 #cd /usr/src/redhat(or other)/RPMS/i386/
执行 #rpm -ivh xxxxx.rpm 安装

上面的方法是对 Redhat 8.0 以及 Mandrake9.0 来说的，如果是低于这个版本。应该用
#rpm --rebuild *.src.rpm

与 C 或 C++ 编写的程序不同， Java 程序并不是一个可执行文件，而是由许多独立的类文件组成，每一个文件对应于一个 Java 类。此外，这些类文件并非立即全部都装入内存，而是根据程序需要装入内存。 ClassLoader 是 JVM 中将类装入内存的那部分。而且， Java ClassLoader 就是用 Java 语言编写的。这意味着创建您自己的 ClassLoader 非常容易，不必了解 JVM 的微小细节。 Java 的 classloader 不但可以使你运行本地得 class 类 , 你也可以定制 classloader 运行来自远程的字节代码 .

ClassLoader 的基本目标是对类的请求提供服务。当 JVM 需要使用类时，它根据名称向 ClassLoader 请求这个类，然后 ClassLoader 试图返回一个表示这个类的 Class 对象。

通过覆盖对应于这个过程不同阶段的方法，可以创建定制的 ClassLoader 。通常当你需要动态加载资源的时候 , 你至少有三个 ClassLoader 可以选择 :

1.       系统类加载器（应用类加载器）

(system classloader or application classloader)

2.       当前类加载器

3.       当前线程类加载器

第一种 : 系统类加载器

系统类加载器 (system classloader). 这个类加载器处理 -classpath 下的类加载工作 , 可以通过 ClassLoader.getSystemClassLoader() 方法调用 .

ClassLoader 下所有的 getSystemXXX() 的静态方法都是通过这个方法定义的 . 在你的代码中 , 你应该尽量少地调用这个方法 , 以其它的类加载器作为代理 . 否则你的代码将只能工作在简单的命令行应用中 , 这个时候系统类加载器 (system classloader) 是 JVM 最后创建的类加载器 . 一旦你把代码移到 EJB, Web 应用或 Java Web Start 应用中 , 一定会出问题 .

Class.loadClass( String name, boolean resolve );

name 参数指定了 JVM 需要的类的名称，该名称以包表示法表示，如 Foo 或   java.lang.Object 。

resolve 参数告诉方法是否需要解析类。在准备执行类之前，应考虑类解析。并不总是需要解析。如果 JVM 只需要知道该类是否存在或找出该类的超类，那么就不需要解析。

方法 defineClass 是 ClassLoader 的主要诀窍。

该方法接受由原始字节组成的数组并把它转换成 Class 对象。原始数组包含如从文件系统或网络装入的数据。

defineClass 管理 JVM 的许多复杂、神秘和倚赖于实现的方面 -- 它把字节码分析成运行时数据结构、校验有效性等等。不必担心，您无需亲自编写它。事实上，即使您想要这么做也不能覆盖它，因为它已被标记成最终的。

方法 findSystemClass

findSystemClass 方法从本地文件系统装入文件。它在本地文件系统中寻找类文件，如果存在，就使用 defineClass 将原始字节转换成 Class 对象，以将该文件转换成类。当运行 Java 应用程序时，这是 JVM 正常装入类的缺省机制 .

   如果 ClassLoader 不能找到类，它会请求父代 ClassLoader 来执行此项任务。所有 ClassLoaders 的根是系统 ClassLoader ，它会以缺省方式装入类 -- 即，从本地文件系统。

方法 findLoadedClass 充当一个缓存

当请求 loadClass 装入类时，它调用该方法来查看 ClassLoader 是否已装入这个类，这样可以避免重新装入已存在类所造成的麻烦。应首先调用该方法。

让我们看一下如何组装所有方法。

loadClass 实现示例执行以下步骤：

（这里，我们没有指定生成类文件是采用了哪种技术，它可以是从 Net 上装入、或者从归档文件中提取、或者实时编译。无论是哪一种，那是种特殊的神奇方式，使我们获得了原始类文件字节。）

1.   调用 findLoadedClass 来查看是否存在已装入的类。

2.   如果没有，那么采用那种特殊的神奇方式来获取原始字节。

3.   如果已有原始字节，调用 defineClass 将它们转换成 Class 对象。

4.   如果没有原始字节，然后调用 findSystemClass 查看是否从本地文件系统获取类。

5.   如果 resolve 参数是 true ，那么调用 resolveClass 解析 Class 对象。

6.   如果还没有类，返回 ClassNotFoundException 。

7.   否则，将类返回给调用程序。

第二种选择 : 当前上下文环境下的类加载器 .

CUT        Coding&Unit Test /Construct 编码及单元测试

DD   Detail Design 详细设计  

HLD  High Level Design 概要设计
LLD  Low Level Design 详细设计

SD         System Design 系统设计

SRS        System/Software Requirement Specification 软件需求规格说明

UT Unit Testing 单元测试
IT Integration Test 集成测试

ST System Test 系统测试

PT Performance Test 性能测试

UAT        User Acceptance Test 用户验收测试

FURPS+

Functionality, Usability, Reliability, Performance,Supportability, + Localizability, Portability

功能性，可用性，可靠性，性能，支持性＋ 本地化，可移植性

IC (IGC)

Inter-group Coordination ( CMM Level 3 KPA )     组间协调（ CMM 第三级的 KPA ）
ISM

Integrated Software Management ( CMM Level 3 KPA ) 集成软件管理（ CMM 第三级的 KPA ）
 
KPA Key Process Area 关键过程区域
LC Lifecycle 生命周期
 
OOA Object Oriented Analysis 面对对象分析
OOD Object Oriented Design 面向对象设计

OPD

 Organization Process Definition ( CMM Level 3 KPA ) 组织过程定义（ CMM 第三级的 KPA ）
OPF

 Organization Process Focus ( CMM Level 3 KPA ) 组织过程焦点（ CMM 第三级的 KPA ）
OSSP

Organization Standard Software Process 组织标准软件过程

PCB

Process Capability  Baselines 过程能力基准
PCM

Process Change  Management ( CMM Level 5 KPA ) 过程更改管理（ CMM 第五级的 KPA ）
PDSP

Project's Defined  Software Process 项目定义的软件过程
PI

Process Improvement 过程改进
PMR

Project Management Review 项目管理评审
PM

Project Manager 项目经理
PP

Project Planning 项目策划
PR

Peer Reviews ( CMM Level 3 KPA) 同行评审（ CMM 第三级的 KPA ）
QC

Quality Champion 项目 SQA 人员
QP

Quality Plan 质量计划
QPM

Quantitative Process Management ( CMM Level 4 KPA ) 定量过程管理（ CMM 第四级的 KPA ）

RA

Requirement Analysis 需求分析
RCA

Root Cause Analysis 根本原因分析
RFP

Request for Proposal 提议和请求
RM

Requirements Management ( CMM Level 2 KPA ) 需求管理（ CMM 第二级的 KPA ）
ROI

Return On Investment 投资收益率

SCCB

Software Configuration Control Board 软件配置控制组
SCM

Software Configuration Management ( CMM Level 2 KPA) 软件配置管理（ CMM 第二级的 KPA ）
SCMP

 Software Configuration Management Plan 软件配置管理计划

SDLC

Software Development Life Cycle 软件开发生命周期
SEI

Software Engineering Institute 软件工程研究所
SEPG

Software Engineering  Process Group 软件工程过程组

SMR      Senior Management  Review 高级管理评审
SPC        Statistical Process Control 统计过程控制
SPE  Software Product Engineering ( CMM Level 3 KPA ) 软件产品工程（ CMM 第三级的 KPA ）
SPI Software Process  Improvement 软件过程改进
SPP        Software Project Plan ( CMM Level 2 KPA ) 软件项目策划（ CMM 第二级的 KPA ）
SPTO      Software Project Tracking & Oversight 软件项目跟踪和监督
SQA       Software Quality  Assurance  ( CMM Level 2 KPA ) 软件质量保证（ CMM 第二级的 KPA ）
SQM       Software Quality Management 软件质量管理

DP   Defect Prevention ( CMM Level 5 KPA ) 缺陷预防 (CMM 第五级的 KPA)

SSD        System Sequence Diagram 系统时序图
SSM       Software Subcontract Management  ( CMM Level 2 KPA ) 软件子合同管理（ CMM 第二级的 KPA ）

TCM       Technology Change Management 技术改革管理
TP   Training Plan / Training Program  ( CMM Level 3 KPA ) 培训大纲（ CMM 第三级的 KPA ）
TQM       Total Quality Management 总质量管理

 
UC   Use Case 用例
UCD Use Case Diagram 用例图

WBS Work Breakdown Structure 工作分解结构

和目前项目要求一样，所用到的软件列表如下：

1 ， eclipse-SDK-3.1M7-win32

  在 http://www.eclipse.org/downloads/index_topic.php 上下载相应版本

2 ， wtp-R-1.0.3-200607290929

  在 http://download.eclipse.org/webtools/downloads/ 下载对应 eclipse3.1 的应该是 R1.0 版本

  另根据 WTP 要求，还须下载

JEM-SDK-1.1.0.1.zip ， GEF-SDK-3.1.1.zip ， emf-sdo-xsd-SDK-2.1.2.zip 等

3 ， tomcatPluginV3

  http://www.sysdeo.com/eclipse/tomcatplugin 上可下载

4 ， Tomcat 5.0

在 http://tomcat.apache.org/ 下载

5 ， j2sdk1.4.2

安装步骤：

1 、 Java 环境安装： 配置 JAVA_HOME ， PATH

2 、 Tomcat 环境安装： 配置 TOMCAT_HOME ， CATALINA_HOME

3 、 Eclipse 3.1 解压缩

4 、 Eclipse 几个插件解压缩 [wtp-R-1.0.3-200607290929 ， JEM-SDK-1.1.0.1.zip ， GEF-SDK-3.1.1.zip ， emf-sdo-xsd-SDK-2.1.2.zip ， tomcatPluginV3 ]

5 、 lomboz 插件安装 [ 可选 ]

网上很多配置用到了 lomboz 插件： http://forge.objectweb.org/project/showfiles.php?group_id=97 ，我没有安装不知道有什么影响。

测试例子：

1 ，新建工程：选择 Dynamic Web Project ，点 Next  

2 ，输入 project name ，点 Next  

3 ，点击 Finish ，然后点击项目 TestJSP 新建 JSP ，点击 Next

4 ，输入 index.jsp 建在 webContent 目录下，点击 Next  

5 ，因为用于测试，使用 jsp 模板即可，点击 Finish

6 ，编辑 index.jsp ，添加点测试信息 Testing...

7 ，右键点击 index.jsp 选择 Run as->Run on server

8 ，选择 Tomcat5

9 ，设定 server 相关参数

10 ，点击 Finish 。 Server 就会启动，然后转到 index 页面。到此就成功配置完毕。

最近又开始要使用 JSP ，于是写下这些便于将来参考！

Tomcat 5.5 开发 Servlet 和 JavaBean 的配置

1 、 JDK 安装到 C:\jdk 1.5.0 , 配置环境变量如下：

JAVA_HOME=C:\jdk 1.5.0

PATH=C:\jdk 1.5.0 \bin

2 、 Tomcat 安装到 C:\Tomcat, 配置环境变量如下：

CATALINA_HOME=C:\Tomcat

TOMCAT_HOME=C:\Tomcat

然后修改环境变量中的 CLASSPATH ，把 Tomat 安装目录下的 common\lib 下的 servlet-api.jar 加到 CLASSPATH 中去，修改后的 CLASSPATH 为： C:\Tomcat\common\lib\servlet-api.jar

第 1 步：建立自己的开发目录

1. 到 Tomcat 的安装目录下 webapps 目录

2. 在 webapps 目录下新建一个目录 myapp

3.myapp 下新建一个目录 WEB-INF （目录名称是区分大小写）

4.WEB-INF 下新建一个文件 web.xml ，将 tomcat\conf\web.xml 直接拷贝过来就 OK

第 2 步：建立自己的 Servlet 目录

1. 新建 servlet 程序，文件名为 Test.java ，内容如下：

package test;

import java.io.IOException;

import java.io.PrintWriter;

import javax.servlet.ServletException;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

public class Test extends HttpServlet

{

protected void doGet(HttpServletRequest request, HttpServletResponse response)

throws ServletException, IOException

{ PrintWriter out=response.getWriter(); out.println(" This is a servlet test.");

out.flush();

}

}

2 . 编译 Test.java

3 . 将 Test.class 剪切到 ..\webapps\myapp\WEB-INF\classes\test\ 下

4 . 修改 webapps\myapp\WEB-INF\web.xml ，改动 servlet 和 servlet-mapping 的内容 :

<servlet-name>Test</servlet-name>

<servlet-class>test.Test</servlet-class>

<servlet-mapping>

        <servlet-name>Test</servlet-name>

        <url-pattern>/test</url-pattern>

</servlet-mapping>

5 . 启动 Tomcat ， http://localhost:8080/myapp/Test 看到输出 This is a servlet test. 说明编写的 servlet 成功了。

第 3 步：建立自己的 Bean

1. 新建一个 java 程序 TestBean.java ，内容如下：

 package test;

public class TestBean{

public String name = "TestBean Testing ";

public String test()

{ return this.name; }

}

2 . 编译 TestBean.java 产生 TestBean.class

3 . 将 TestBean.class 文件剪切到 \webapps\myapp\WEB-INF\classes\test 下，

4 . \myapp 目录下新建一个 TestBean.jsp 文件，文件内容为：

<html><body>

<jsp:useBean id="tb" scope="page" class="test.TestBean" />

This is <%=tb.test()%>

</body></html>

5 重启 Tomcat ，启动浏览器，输入 http://localhost:8080/myapp/TestBean.jsp 如果看到输出 This is TestBean Testing 就说明编写的 Bean 成功了