44.7. 给开发者
本节面向想要开发 ecpg 接口的人。它描述各部分如何工作。这里的定位是让本节包含给想深入了解的人的内容，而如何使用一节应该足以回答所有常规问题。所以，在研究 ecpg 的内部之前先读这一节。如果你对它究竟如何工作不感兴趣，请跳过本节。
44.7.1. 待办列表
这个版本的预处理器有一些缺陷：
- 预处理器输出
这些变量应该是 static 的。
- 预处理器无法对你的 SQL 语句做语法检查
你写的任何内容都会几乎原样复制给 Postgres，直到运行时你才能定位错误。
- 并非只限于字符串
ecpg 所使用的 PQ 接口（尤其是 PQexec 函数）依赖请求是以字符串形式构建的。在某些情况下，比如数据中包含空字符时，这会是一个严重的问题。
- 错误码
不同的错误应当有不同的错误编号，而不是全都用 -1。
- 库函数
to_date et al.
- records
希望能够在 declare 区中以某种方式定义记录或结构，使该记录可以从数据库中的一行来填充。
这是一种每次处理整行的更简单方式。
- 数组操作
Oracle 有能提升速度的数组操作。在 ecpg 中实现它只是出于兼容性原因。要让它们提升速度，需要对 Postgres 内部机制比我更深入的理解。
- 指示符变量
Oracle 有指示符变量，用来说明一个值是
null还是空。这大大简化了数组操作，并提供了一种绕过VARCHAR2处理中某些设计缺陷的方法（比如空字符串无法与null值区分）。我不确定这是 Oracle 的扩展还是 ANSI 标准的一部分。- typedefs
除了记录和数组这样的复杂类型外，typedef 也值得处理。
- 脚本转换
建立数据库需要一些包含表定义和其他配置参数的脚本。如果你有一套旧数据库的这些脚本，你会希望直接应用它们得到一个以相同方式工作的 Postgres 数据库。
这种功能可以用一些转换脚本来实现，但速度永远无法以这种方式达成。要做到这一点，你需要对数据库的构造和使用有比脚本所能实现的更深入的理解。
44.7.2. 预处理器
前四行被写入输出。两行注释和两行与库接口所必需的 include 行。
然后预处理器单遍工作，边读输入文件边向输出写入。通常它只是把所有内容原样回显到输出，不做进一步检查。
当遇到 EXEC SQL 语句时，它会介入并根据其种类改变它们。EXEC SQL 语句可以是下列之一：
- Declare sections
声明节以
exec sql begin declare section;
开始，以
exec sql end declare section;
结束。此节内只允许变量声明。此节内声明的每个变量也按名称索引连同其对应类型登记到一个变量列表中。
声明也会被回显到文件中，使该变量同时成为普通的 C 变量。
特殊类型 VARCHAR 和 VARCHAR2 会为每个变量转换成一个命名的结构。像这样的声明：
VARCHAR var[180];
会被转换为
struct varchar_var { int len; char arr[180]; } var;- 包含语句
include 语句的形式是：
exec sql include filename;
它被转换成
#include <filename.h>
- 连接语句
connect 语句的形式是：
exec sql connect '
database';该语句被转换成
ECPGconnect("database");- 打开游标语句
open cursor 语句的形式是：
exec sql open
cursor;它被忽略，不复制到输出中。
- 提交语句
commit 语句的形式是
exec sql commit;
在输出中被翻译为
ECPGcommit(__LINE__);
- 回滚语句
rollback 语句的形式是
exec sql rollback;
and is translated on the output to
ECPGrollback(__LINE__);
- 其他语句
其他 SQL 语句是其他以
exec sql开始、以;结束的语句。中间的一切都被当作 SQL 语句并解析变量替换。当符号以冒号（
:）开头时发生变量替换。此时会在先前在 declare 区中声明的变量里查找具有该名称的变量，并根据 SQL 语句是否知道它是用于输入还是输出的变量，把指向这些变量的指针写到输出中，供该函数访问。对于作为 SQL 请求一部分的每个变量，函数还会得到另外五个参数。
作为特殊符号的类型 指向值的指针 如果变量是 varchar 则为变量的大小 数组中的元素个数（用于数组抓取） 到数组中下一个元素的偏移（用于数组抓取） 由于数组抓取尚未实现，最后两个参数其实并不重要。也许本可以把它们省去。
44.7.3. 一个完整的例子
下面是一个完整的例子，描述预处理器的输出：
exec sql begin declare section;
int index;
int result;
exec sql end declare section;
...
exec sql select res into :result from mytable where index = :index;被翻译成：
/* These two include files are added by the preprocessor */
#include <ecpgtype.h>
#include <ecpglib.h>
/* exec sql begin declare section */
int index;
int result;
/* exec sql end declare section */
...
ECPGdo(__LINE__, "select res from mytable where index = ;;",
ECPGt_int,&index,0,0,sizeof(int),
ECPGt_EOIT,
ECPGt_int,&result,0,0,sizeof(int),
ECPGt_EORT );(the indentation in this manual is added for readability and not something that the preprocessor can do.)
44.7.4. 库
库中最重要的函数是 ECPGdo
函数。它接受数量可变的参数。希望我们不会遇到对 varchar 函数可接受的变量数量有限制的机器。参数很容易累计到 50 个左右。
参数有：
- 一个行号
这是原语句的行号，只用于错误消息。
- A string
这是要发出的 SQL 请求。该请求被输入变量修改，即那些编译时未知但要输入请求的变量。在变量应出现的位置，字符串中包含 “;”。
- 输入变量
如关于预处理器的一节所述，每个输入变量得到五个参数。
- ECPGt_EOIT
一个枚举，表示不再有输入变量。
- 输出变量
如关于预处理器的一节所述，每个输入变量得到五个参数。These variables are filled by the function.
- ECPGt_EORT
一个枚举，表示不再有变量。
除非你发出提交事务命令，所有 SQL 语句都在一个事务中执行。其工作方式是：第一个事务，或提交/回滚之后的第一个事务，总是开始一个新事务。
待完成：描述其余条目的条目。