/**如果还有一个指定的字符流，SAX解析器将忽略这一点，但它会使用一个字节流来优先打开一个URI连接本身。

如果应用程序知道字节流的字符编码，则应使用setEncoding方法进行设置。*/

inputSource.setByteStream(inputStream);

public XMLReader getXMLReader() throws SAXException {

        if (reader == null) {

            reader = getParser().getXMLReader();

        }

        reader.setDTDHandler(this);

        reader.setContentHandler(this);

        if (entityResolver == null) {

            reader.setEntityResolver(this);

        } else {

            reader.setEntityResolver(entityResolver);

        }

        reader.setProperty("http://xml.org/sax/properties/lexical-handler", this);

        reader.setErrorHandler(this);

        return reader;

    }

public SAXParser getParser() {

        // Return the parser we already created (if any)

        if (parser != null) {

            return (parser);

        }

        // Create a new parser

        try {

            parser = getFactory().newSAXParser();

        } catch (Exception e) {

            log.error("Digester.getParser: ", e);

            return (null);

        }

        return (parser);

    }

注册内容事件处理程序。如果应用程序没有注册内容处理程序，SAX解析器报告的所有内容事件将被默认忽略。

应用程序可以在解析的中间注册一个新的或不同的处理程序，而SAX解析器必须立即开始使用新的处理程序

在SAX编程中，需要为XMLReader设置相应的ContentHandler，
该Handler的startDocument,endDocument,startElement,endElement及characters等方法将用于响应解析xml时的标签事件,
可看到Digester继承于DefaultHandler类,而该类则实现ContentHandler接口,
因此在对server.xml解析时将相应地调用到Digester的startDocument,endDocument,startElement,endElement及characters等方法

startDocument,endDocument,startElement,endElement及characters等方法将会被调用

提供定位器：如果这样做，它必须通过调用此方法在调用ContentHandler接口中的任何其他方

法之前将定位器提供给应用程序。定位器允许应用程序确定任何文档相关事件的结束位置，即使

解析器没有报告错误。通常，应用程序将使用此信息来报告其自身的错误（例如与应用程序业务

规则不匹配的字符内容）

处理通知文档的开头，这里主要设置的编码The encoding used by the source XMl document.

((DocumentProperties.Encoding) root).setEncoding(((Locator2) locator).getEncoding());

再开始startElement()方法之前会先调用

startPrefixMapping(String prefix, String namespaceURI)//命名空间前缀进入范围的通知处理方法

这个方法主要是用HashMap<String, ArrayStack<String>>

namespaces 变量以prefix为key，ArrayStack为值保存数据ArrayStack保存着namespaceURI

ArrayStack<String> stack = namespaces.get(prefix);

        if (stack == null) {

            stack = new ArrayStack<>();

            namespaces.put(prefix, stack);

        }

        stack.push(namespaceURI);

SAX XML reader将自动替换元素和属性名称的前缀。

然而，有些情况下，当应用程序需要在字符数据或属性值中使用前缀时，它们无法安全地自动扩展; start / endPrefixMapping事件将信息提供给应用程序，以在必要时在这些上下文中扩展前缀。

startPrefixMapping事件都将在相应的startElement事件之前立即发生，并且所有endPrefixMapping事件都将在相应的endElement事件之后立即发生

2、Digester.startElement(String namespaceURI, String localName, String qName, Attributes list)

namespaceURI The Namespace URI, or the empty string if the element has no

 　　　　　　　　Namespace URI or if Namespace processing is not being performed.
命名空间URI，如果元素没有命名空间URI或未执行命名空间处理，则为空字符串

localName

 　　　　The local name (without prefix), or the empty string if Namespace processing is

　　　　not being performed.
本地名称（无前缀），或为空字符串（如果命名空间处理） 没有执行。
qName 　　The qualified name (with prefix), or the empty string

 　　　　  if qualified names are not available.
限定名称（带前缀）或为空字符串 如果限定名称不可用。
list　　 The attributes attached to the element. If

　　　　　　there are no attributes, it shall be an empty Attributes object.
附加到元素的属性。如果没有属性，它将是一个空的Attributes对象。

到达XML元素的开始处理通知

 updateAttributes(list)更新属性中的系统值引用

格式为“$ {xxx}”的文本都将被系统属性中适当的值替换。

初始化标签体内容

bodyTexts用于周围元素的正文文本字符串缓冲区堆栈。The stack of body text string buffers for surrounding elements.

bodyText当前元素标签内的正文内容

获取路径名

将标签的路径字符赋给name。XML格式如:<Servers><Server><Server></Servers>,

当解析到<Server>标签时路径则为Servers/Server,在得到路径后又将该路径赋予match变量;

得到与标签体路径名匹配的Rule List，触发其begin方法

这部分内容是tomcat解析xml的重要部分

当遇到匹配的XML元素的开始时调用此方法。默认实现委托到不推荐使用的方法，而不使用命名空间和名称参数，以保留向后兼容性。

然后这个方法内调用Rule.begin(Attributes attributes) 开始匹配xml元素

3、Digester.characters(char[] buffer, int start, int length) 处理从XML元素的正文接收到的字符数据的通知。

buffer The characters from the XML document来自XML文档的字符

start Starting offset into the buffer开始偏移到缓冲区

length Number of characters from the buffer缓冲区中的字符数

bodyText.append(buffer, start, length);接受元素标签内的正文内容

4、Digester.endElement(String namespaceURI, String localName, String qName)处理到达的XML元素的结束标记的通知

将bodyText中的变量值替换,如标签体中有${catalina.base}，会使用System.getProperties()提取系统catalina.base的属性值

获取与标签路径名匹配的Rule，触发其body及end方法

matches再startElement中被复值了

List<Rule> rules = getRules().match(namespaceURI, match);

matches.push(rules);

// Parse system properties

        bodyText = updateBodyText(bodyText);

List<Rule> rules = matches.pop();

rule.body(namespaceURI, name, bodyText);

// Recover the body text from the surrounding element

　　bodyText = bodyTexts.pop();

rule.end(namespaceURI, name);

// Recover the previous match expression

int slash = match.lastIndexOf('/');

if (slash >= 0) {

match = match.substring(0, slash);

} else {

match = "";

}

执行完endElement（）方法后元素标签解析完毕需要取消注册此前缀映射

在Digester.endPrefixMapping(String prefix)就是处理的地方

ArrayStack<String> stack = namespaces.get(prefix);

stack.pop();

            if (stack.empty())

                namespaces.remove(prefix);

5、Digester.endDocument()

方法内容为:弹出所有还在栈中的对象,执行所有Rule的finish方法,执行clear方法清空相关堆栈（clear方法将Digester定义的变量设置为null,configure设置为false）

到这里xml解析完成。等有空再把上面缕缕