# 8.8. `dialect.py` 介绍
`Dialectizer` 是 `BaseHTMLProcessor` 的简单 (和拙劣) 的派生类。它通过一系列的替换对文本块进行了处理,但是它确保在 ``<pre>`...`</pre>`` 块之间的任何东西不被修改地通过。
为了处理 `<pre>` 块,我们在 `Dialectizer` 中定义了两个方法:`start_pre` 和 `end_pre`。
## 例 8.17. 处理特别标记
```
def start_pre(self, attrs):
self.verbatim += 1
self.unknown_starttag("pre", attrs)
def end_pre(self):
self.unknown_endtag("pre")
self.verbatim -= 1
```
| | |
| --- | --- |
| \[1\] | 每当 `SGMLParser` 在 HTML 源代码中发现一个 `<pre>` 时,都会调用 `start_pre`。(马上我们就会确切地看到它是如何发生的。) 这个方法使用单个参数:`attrs`,这个参数会包含标记的属性 (如果存在的话) 。`attrs` 是一个键/值 tuple 的 list,就像 [`unknown_starttag`](dictionary_based_string_formatting.html#dialect.unknownstarttag "例 8.14. BaseHTMLProcessor.py 中的基于 dictionary 的字符串格式化") 中所使用的。 |
| \[2\] | 在 `reset` 方法中,我们初始化了一个数据属性,它作为 `<pre>` 标记的一个计数器。每当我们找到一个 `<pre>` 标记,我们增加计数器的值;每当我们找到一个 `</pre>` 标记,我们将减少计数器的值。(我们本可以把它实现为一个标志,即或把它设为 `1`,或重置为 `0`,但这样做只是为了方便,并且这样做可以处理古怪 (但有可能) 的 `<pre>` 标记嵌套的情况。) 马上我们将会看到这个计数器是多么的好用。 |
| \[3\] | 不错,这就是我们对 `<pre>` 标记所做的唯一的特殊处理。现在我们将属性列表传给 `unknown_starttag`,由它来进行缺省的处理。 |
| \[4\] | 每当 `SGMLParser` 找到一个 `</pre>` 标记时,会调用 `end_pre`。因为结束标记不能包含属性,因此这个方法没有参数。 |
| \[5\] | 首先我们要进行缺省处理,就像其它结束标记做的一样。 |
| \[6\] | 其次我们将计数器减少,标记这个 `<pre>` 块已经被关闭了。 |
到了这个地方,有必要对 `SGMLParser` 更深入一层。我已经多次声明 (到目前为止您应已经把它做为信条了) ,就是 `SGMLParser` 查找每一个标记并且如果存在特定的方法就调用它们。例如:我们刚刚看到处理 `<pre>` 和 `</pre>` 的 `start_pre` 和 `end_pre` 的定义。但这是如何发生的呢?嗯,也没什么神奇的,只不过是出色的 Python 编码。
## 例 8.18. `SGMLParser`
```
def finish_starttag(self, tag, attrs):
try:
method = getattr(self, 'start_' + tag)
except AttributeError:
try:
method = getattr(self, 'do_' + tag)
except AttributeError:
self.unknown_starttag(tag, attrs)
return -1
else:
self.handle_starttag(tag, method, attrs)
return 0
else:
self.stack.append(tag)
self.handle_starttag(tag, method, attrs)
return 1
def handle_starttag(self, tag, method, attrs):
method(attrs)
```
| | |
| --- | --- |
| \[1\] | 此处,`SGMLParser` 已经找到了一个开始标记,并且分析出属性列表。唯一要做的事情就是检查对于这个标记是否存在一个特别的处理方法,否则我们就应该求助于缺省方法 (`unknown_starttag`) 。 |
| \[2\] | `SGMLParser` 的 “神奇” 之处除了我们的老朋友 [`getattr`](../power_of_introspection/getattr.html "4.4. 通过 getattr 获取对象引用") 之外就没有什么了。您以前可能没注意到,`getattr` 将查找定义在一个对象的继承者中或对象自身的方法。这里对象是 `self`,即当前实例。所以,如果 `tag` 是 `'pre'`,这里对 `getattr` 的调用将会在当前实例 (它是 `Dialectizer` 类的一个实例) 中查找一个名为 `start_pre` 的方法。 |
| \[3\] | 如果 `getattr` 所查找的方法在对象或它的任何继承者中不存在的话,它会引发一个 `AttributeError` 的异常。但没有关系,因为我们把对 `getattr` 的调用包装到一个 [`try...except`](../file_handling/index.html#fileinfo.exception "6.1. 异常处理") 块中了,并且显式地捕捉 `AttributeError` 异常。 |
| \[4\] | 因为我们没有找到一个 `start_xxx` 方法,在放弃之前,我们将还要查找一个 `do_xxx` 方法。这个可替换的命名模式一般用于单独的标记,如 `<br>`,这些标记没有相应的结束标记。但是您可以使用任何一种模式,正如您看到的,`SGMLParser` 对每个标记尝试两次。(您不应该对相同的标记同时定义 `start_xxx` 和 `do_xxx` 处理方法,因为这样的话只有 `start_xxx` 方法会被调用。) |
| \[5\] | 另一个 `AttributeError` 异常,它是说用 `do_xxx` 来调用 `getattr` 失败了。因为对同一个标记我们既没有找到 `start_xxx` 也没有找到 `do_xxx` 处理方法,这样我们捕捉到了异常并且求助于缺省方法:`unknown_starttag`。 |
| \[6\] | 记得吗?`try...except` 块可以有一个 `else` 子句,当在 `try...except` 块中[没有异常被引发](../file_handling/index.html#crossplatform.example "例 6.2. 支持特定平台功能")时,它将被调用。逻辑上,意味着我们_确实_ 找到了这个标记的 `do_xxx` 方法,所以我们将要调用它。 |
| \[7\] | 顺便说,不要为这些不同的返回值而担心;理论上他们有意义,但实际上它们没有任何用处。也不要担心 `self.stack.append(tag)` ; `SGMLParser` 内部会知晓您的开始标记是否有合适的结束标记与之匹配,但是它不会对这些信息做任何操作。理论上,您能使用这个模块校验您的标记是否完全匹配,但是这或许没有多大价值,并且这样的内容已经超出了本章所要讨论的范畴。现在有您更需要担心的问题。 |
| \[8\] | `start_xxx` 和 `do_xxx` 方法并不被直接调用;标记名、方法和属性被传给 `handle_starttag` 这个方法,以便继承者可以覆盖它,并改变_全部_ 开始标记分发的方式。我们不需要控制这个层面,所以我们只让这个方法做它自已的事,就是用属性 list 来调用方法 (`start_xxx` 或 `do_xxx`) 。记住 `method` 是一个从 `getattr` 返回的函数,而函数是对象。(我知道您已经听腻了,我发誓,一旦我们停止寻找新的使用方法来为我们服务时,我就决不再提它了。) 这时,函数对象作为一个参数传入这个分发方法,这个方法反过来再调用这个函数。在这里,我们不需要知道函数是什么,叫什么名字,或是在哪时定义的;我们只需要知道用一个参数 `attrs` 调用它。 |
现在回到我们已经计划好的程序:`Dialectizer`。当我们跑题时,我们定义了特别的处理方法来处理 `<pre>` 和 `</pre>` 标记。还有一件事没有做,那就是用我们预定义的替换处理来处理文本块。为了实现它,我们需要覆盖 `handle_data` 方法。
## 例 8.19. 覆盖 `handle_data` 方法
```
def handle_data(self, text):
self.pieces.append(self.verbatim and text or self.process(text))
```
| | |
| --- | --- |
| \[1\] | `handle_data` 在调用时只使用一个参数:要处理的文本。 |
| \[2\] | 在祖先类 [`BaseHTMLProcessor`](basehtmlprocessor.html#dialect.basehtml.intro "例 8.8. BaseHTMLProcessor 介绍") 中,`handle_data` 方法只是将文本追加到输出缓冲区 `self.pieces` 之后。这里的逻辑稍微有点复杂。如果我们处于 ``<pre>`...`</pre>`` 块的中间,`self.verbatim` 将是大于 `0` 的某个值,接着我们想要将文本不作改动地传入输出缓冲区。否则,我们将调用另一个单独的方法来进行替换处理,然后将处理结果放入输出缓冲区中。在 Python 中,这是一个一行代码,它使用了[`and-or` 技巧](../power_of_introspection/and_or.html#apihelper.andortrick.intro "例 4.17. and-or 技巧介绍")。 |
我们已经接近了对 `Dialectizer` 的全面理解。唯一缺少的一个环节是文本替换的特性。如果您知道点 Perl,您就会知道当需要复杂的文本替换时,唯一有效的解决方法就是正则表达式。在 `dialect.py` 文件后面的几个类中定义了一连串的正则表达式来操作 HTML 标记中的文本。我们已经学习过了[正则表达式中的所有字符](../regular_expressions/index.html "第 7 章 正则表达式")。我们不必重复学习正则表达式的艰难历程了,不是吗?上帝知道我反正不需要。我想现在这章您已经学得差不多了。
- 版权信息
- 第 1 章 安装 Python
- 1.1. 哪一种 Python 适合您?
- 1.2. Windows 上的 Python
- 1.3. Mac OS X 上的 Python
- 1.4. Mac OS 9 上的 Python
- 1.5. RedHat Linux 上的 Python
- 1.6. Debian GNU/Linux 上的 Python
- 1.7. 从源代码安装 Python
- 1.8. 使用 Python 的交互 Shell
- 1.9. 小结
- 第 2 章 第一个 Python 程序
- 2.1. 概览
- 2.2. 函数声明
- 2.3. 文档化函数
- 2.4. 万物皆对象
- 2.5. 代码缩进
- 2.6. 测试模块
- 第 3 章 内置数据类型
- 3.1. Dictionary 介绍
- 3.2. List 介绍
- 3.3. Tuple 介绍
- 3.4. 变量声明
- 3.5. 格式化字符串
- 3.6. 映射 list
- 3.7. 连接 list 与分割字符串
- 3.8. 小结
- 第 4 章 自省的威力
- 4.1. 概览
- 4.2. 使用可选参数和命名参数
- 4.3. 使用 type、str、dir 和其它内置函数
- 4.4. 通过 getattr 获取对象引用
- 4.5. 过滤列表
- 4.6. and 和 or 的特殊性质
- 4.7. 使用 lambda 函数
- 4.8. 全部放在一起
- 4.9. 小结
- 第 5 章 对象和面向对象
- 5.1. 概览
- 5.2. 使用 from _module_ import 导入模块
- 5.3. 类的定义
- 5.4. 类的实例化
- 5.5. 探索 UserDict:一个封装类
- 5.6. 专用类方法
- 5.7. 高级专用类方法
- 5.8. 类属性介绍
- 5.9. 私有函数
- 5.10. 小结
- 第 6 章 异常和文件处理
- 6.1. 异常处理
- 6.2. 与文件对象共事
- 6.3. for 循环
- 6.4. 使用 `sys.modules`
- 6.5. 与目录共事
- 6.6. 全部放在一起
- 6.7. 小结
- 第 7 章 正则表达式
- 7.1. 概览
- 7.2. 个案研究:街道地址
- 7.3. 个案研究:罗马字母
- 7.4. 使用 {n,m} 语法
- 7.5. 松散正则表达式
- 7.6. 个案研究:解析电话号码
- 7.7. 小结
- 第 8 章 HTML 处理
- 8.1. 概览
- 8.2. sgmllib.py 介绍
- 8.3. 从 HTML 文档中提取数据
- 8.4. BaseHTMLProcessor.py 介绍
- 8.5. locals 和 globals
- 8.6. 基于 dictionary 的字符串格式化
- 8.7. 给属性值加引号
- 8.8. dialect.py 介绍
- 8.9. 全部放在一起
- 8.10. 小结
- 第 9 章 XML 处理
- 9.1. 概览
- 9.2. 包
- 9.3. XML 解析
- 9.4. Unicode
- 9.5. 搜索元素
- 9.6. 访问元素属性
- 9.7. Segue [9]
- 第 10 章 脚本和流
- 10.1. 抽象输入源
- 10.2. 标准输入、输出和错误
- 10.3. 查询缓冲节点
- 10.4. 查找节点的直接子节点
- 10.5. 根据节点类型创建不同的处理器
- 10.6. 处理命令行参数
- 10.7. 全部放在一起
- 10.8. 小结
- 第 11 章 HTTP Web 服务
- 11.1. 概览
- 11.2. 避免通过 HTTP 重复地获取数据
- 11.3. HTTP 的特性
- 11.4. 调试 HTTP web 服务
- 11.5. 设置 User-Agent
- 11.6. 处理 Last-Modified 和 ETag
- 11.7. 处理重定向
- 11.8. 处理压缩数据
- 11.9. 全部放在一起
- 11.10. 小结
- 第 12 章 SOAP Web 服务
- 12.1. 概览
- 12.2. 安装 SOAP 库
- 12.3. 步入 SOAP
- 12.4. SOAP 网络服务查错
- 12.5. WSDL 介绍
- 12.6. 以 WSDL 进行 SOAP 内省
- 12.7. 搜索 Google
- 12.8. SOAP 网络服务故障排除
- 12.9. 小结
- 第 13 章 单元测试
- 13.1. 罗马数字程序介绍 II
- 13.2. 深入
- 13.3. romantest.py 介绍
- 13.4. 正面测试 (Testing for success)
- 13.5. 负面测试 (Testing for failure)
- 13.6. 完备性检测 (Testing for sanity)
- 第 14 章 测试优先编程
- 14.1. roman.py, 第 1 阶段
- 14.2. roman.py, 第 2 阶段
- 14.3. roman.py, 第 3 阶段
- 14.4. roman.py, 第 4 阶段
- 14.5. roman.py, 第 5 阶段
- 第 15 章 重构
- 15.1. 处理 bugs
- 15.2. 应对需求变化
- 15.3. 重构
- 15.4. 后记
- 15.5. 小结
- 第 16 章 函数编程
- 16.1. 概览
- 16.2. 找到路径
- 16.3. 重识列表过滤
- 16.4. 重识列表映射
- 16.5. 数据中心思想编程
- 16.6. 动态导入模块
- 16.7. 全部放在一起
- 16.8. 小结
- 第 17 章 动态函数
- 17.1. 概览
- 17.2. plural.py, 第 1 阶段
- 17.3. plural.py, 第 2 阶段
- 17.4. plural.py, 第 3 阶段
- 17.5. plural.py, 第 4 阶段
- 17.6. plural.py, 第 5 阶段
- 17.7. plural.py, 第 6 阶段
- 17.8. 小结
- 第 18 章 性能优化
- 18.1. 概览
- 18.2. 使用 timeit 模块
- 18.3. 优化正则表达式
- 18.4. 优化字典查找
- 18.5. 优化列表操作
- 18.6. 优化字符串操作
- 18.7. 小结
- 附录 A. 进一步阅读
- 附录 B. 五分钟回顾
- 附录 C. 技巧和窍门
- 附录 D. 示例清单
- 附录 E. 修订历史
- 附录 F. 关于本书
- 附录 G. GNU Free Documentation License
- G.0. Preamble
- G.1. Applicability and definitions
- G.2. Verbatim copying
- G.3. Copying in quantity
- G.4. Modifications
- G.5. Combining documents
- G.6. Collections of documents
- G.7. Aggregation with independent works
- G.8. Translation
- G.9. Termination
- G.10. Future revisions of this license
- G.11. How to use this License for your documents
- 附录 H. GNU 自由文档协议
- H.0. 序
- H.1. 适用范围和定义
- H.2. 原样复制
- H.3. 大量复制
- H.4. 修改
- H.5. 合并文档
- H.6. 文档合集
- H.7. 独立著作聚集
- H.8. 翻译
- H.9. 终止协议
- H.10. 协议将来的修订
- H.11. 如何为你的文档使用本协议
- 附录 I. Python license
- I.A. History of the software
- I.B. Terms and conditions for accessing or otherwise using Python
- 附录 J. Python 协议
- J.0. 关于译文的声明
- J.A. 软件的历史
- J.B. 使用 Python 的条款和条件