<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE codgen-config PUBLIC "-//Apache Software Foundation//DTD Tengen Configuration 1.0//EN" "com/bcs/codgen/resources/codgen-config_1_0.dtd">
<codgen-config>
        <project name="AOWork" label="工程验收" outputEncoding="GBK" isDefault="true" extends="defaultProject">
                <dbProvider class="com.bcs.codgen.service.impl.Sql2005Provider">
                        <jdbcConfig>
                                <driver>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver>
                                <url>jdbc:sqlserver://127.0.0.1\SQL2005;DatabaseName=MUCM_DG;selectMethod=cursor</url>
                                <user>sa</user>
                                <password>sa</password>
                        </jdbcConfig>
                        <columnHandler class="com.bcs.codgen.service.impl.DataTypeConverterForJava"/>
            <!-- 自定义的列模型处理器，用来把oracle带下划线的列名称转换为驼峰式列名称 -->
            <columnHandler class="columnHandler.OracleColumnHandler"/>
            <!-- 不使用系统默认的空格分隔符（要使用则去掉下面这行配置，当然可以设置其他分隔符来覆盖默认的空格分隔符） -->
            <splitorForLabelFromComment></splitorForLabelFromComment>
                </dbProvider>
        <!-- 自定义的构建配置处理器，可以在配置信息初始化、获取数据模型前后、获取输出模型前后时进行定制处理 -->
        <buildConfigHandler class="buildConfigHandler.MyBuildConfigHandler" />
                
                <dataModel name="templateDirectory">template/AOWork</dataModel>
                <dataModel name="outputDirectory">D:/QtoneProject/TengenCode/${copyright.author}/${projectName}</dataModel>
                <dataModel name="NamespaceModel" >com.qtone.aow.model.${groupName}</dataModel>
                <dataModel name="NamespaceParam">com.qtone.aow.model.${groupName}</dataModel>
                <dataModel name="NamespaceDao">com.qtone.aow.dao.${groupName}</dataModel>
                <dataModel name="NamespaceDaoImpl">com.qtone.aow.dao.${groupName}</dataModel>
                <dataModel name="NamespaceBll">com.qtone.aow.bll.${groupName}</dataModel>
                <dataModel name="NamespaceBllImpl">com.qtone.aow.bll.${groupGroup}</dataModel>
                <dataModel name="NamespaceApp">com.qtone.aow.app.${groupName}</dataModel>
                                
                <template name="tDao" type="file">dao.ftl</template>
                
                <output name="Model" type="text" templateText="${defaultJavaModel}" ></output>
                <output name="Param" type="text" templateFile="Param.ftl" ></output>
                <output name="Dao" type="text"

Здесь представлен перевод исходного текста на русский язык. Если у вас есть дополнительные вопросы или уточнения, пожалуйста, сообщите мне. **2.2.1 project узел**

Проект — это минимальная единица сборки.

* **name**: название проекта, которое должно быть уникальным во всех конфигурациях загрузки.
* **label**: ярлык проекта, информация на китайском языке для отображения на переднем плане.
* **outputEncoding**: тип выходной кодировки, который должен соответствовать типу кодировки шаблона, иначе в выходном файле или появится искажённый текст.
* **isDefault**: является ли проект по умолчанию, если есть несколько проектов, установленных как свойства по умолчанию (isDefault="true"), то будет использоваться последний.
* **extends**: указывает на наследование ранее настроенного существующего проекта, при загрузке и создании объекта конфигурации проекта, если обнаружено это свойство, сначала будет получен скопированный унаследованный проект, а затем будет прочитана текущая конфигурация проекта, если существует повторяющийся дочерний узел, он будет перекрыт.
* **isEnabled**: включено ли, если это свойство не установлено, оно по умолчанию включено, что эквивалентно isEnabled ="true", отключённые проекты не будут загружены в кэш конфигурации и, следовательно, не могут быть унаследованы последующими проектами.

**2.2.2 dbProvider узел**

Этот узел используется для настройки поставщика информации о базе данных, используемой текущим проектом, и не является обязательным узлом конфигурации. dbProvider обычно содержит один или несколько дочерних узлов jdbcConfig и columnHandler, но они также не являются обязательными для настройки, их можно настроить в программировании, например, jdbcConfig можно указать непосредственно объект JdbcConfig или передать объект подключения Connection в программировании без настройки. Другими словами, DbProvider предоставляет два метода построения с параметрами JdbcConfig и Connection. Узел DbProvider имеет только одно свойство class, которое указывает конкретную реализацию базы данных определённого типа, такую как OracleProvider, которая является классом реализации DbProvider для предоставления информации метаданных Oracle. Codgen также реализовал некоторые другие базы данных, такие как MsSQL, вы также можете наследовать DbProvider для расширения своего собственного поставщика информации о базе данных. Это очень просто, потому что DbProvider уже реализовал большую часть функций, вам нужно только реализовать один или два абстрактных метода, чтобы расширить свой собственный dbProvider, и использовать свойство class в конфигурации, чтобы указать полное имя класса.

**2.2.3 jdbcConfig узел**

Используется для указания конфигурации соединения JDBC, включая driver, url, user и password и т. д.

**2.2.4 columnHandler узел**

columnHandler — обработчик модели столбца. Он является дочерним узлом dbProvider. Один поставщик информации о базе данных может содержать несколько обработчиков моделей столбцов. После получения связанной информации о полях из базы данных она инкапсулируется в объект модели столбца, и эти обработчики будут вызываться для выполнения некоторых специальных операций обработки, таких как преобразование типа данных поля базы данных в тип данных фактического языка программирования. Например, все имена полей Oracle являются прописными, здесь можно добавить обработчик для унификации преобразования имени поля в более читаемое имя поля, как показано в следующем коде:

Хотя у обработчика модели столбцов есть только один метод handle, этот простой интерфейс может реализовывать множество гибких и мощных функций. Вот ещё один пример использования этого обработчика:

Фактически, codgen предоставляет два типичных примера использования обработчиков модели столбцов: DataTypeConverterForJava и DataTypeConverterForCS, которые используются для преобразования типов данных для разных сред программирования.

**2.2.5 splitorForLabelFromComment узел**

splitorForLabelFromComment — узел конфигурации разделителя для извлечения метки таблицы (столбца) из комментария таблицы (столбца). Codgen по умолчанию использует пробел в качестве разделителя, например, tableComment имеет значение «информация о пользователе, используемая для хранения основных сведений о преподавателях, родителях и студентах», тогда значение tableLabel равно «информация о пользователе»; columnComment установлен на «код пользователя|сгенерированный UUID, удалённый из 32-битного кода после удаления подчёркивания», а значение splitorForLabelFromComment равно «|», тогда значение columnLabel равно «код пользователя».

**2.2.6 buildConfigHandler узел**

buildConfigHandler — это узел обработчика конфигурации сборки, который позволяет пользователям настраивать дополнительные обработчики конфигурации сборки для индивидуальной обработки конфигурации проекта и конфигурации сборки до и после инициализации проекта, получения модели данных и получения выходной модели. Следующий обработчик конфигурации сборки перехватывает инициализацию проекта и автоматически заполняет неустановленные значения groupName, moduleName и т.д. в соответствии с соглашением об именовании, заданным именем таблицы. ```
StringUtils.countMatches(tableName, "_");
if (splitorCount >= 2) {
    tableName = tableName.replace("qky_", "");
}
//把表名中第一个和第三个下划线之间的内容作为组名
if (tableName.contains("_")) {
    String groupName = StringUtils.substringBefore(tableName, "_");
    pbConfig.setGroupName(groupName);
}

pbConfig.setModuleName(removeSplitorAndCapitalize(tableName, "_"));
}

//表标签格式化
String tableLabel = pbConfig.getTableLabel();
if (StringUtils.isNotBlank(tableLabel)) {
    if (tableLabel.indexOf("|") > 0) {
        tableLabel = StringUtils.substringBefore(tableLabel, "|");
    }
    //去掉后缀字符“表”后再作为表标签
    tableLabel = StringUtils.removeEnd(tableLabel, "表");
    pbConfig.setTableLabel(tableLabel);
}

copyright.setAuthor("黄天政");
dataModelMap.put("copyright",copyright); //dataModelMap — это дерево моделей данных```

Модели данных, подобные copyright, являются одноуровневыми узлами в дереве моделей данных и включают в себя все модели данных, объявленные в файле конфигурации. codgen предоставляет основную модель данных TableModel, помимо других встроенных моделей данных:

* **projectName** — название проекта, по умолчанию используется значение атрибута name узла project в файле конфигурации;
* **projectLabel** — описание проекта на китайском языке, по умолчанию используется атрибут label узла project в файле конфигурации;
* **tableName** — имя таблицы, без значения по умолчанию, должно быть указано явно, иначе невозможно создать объект модели таблицы TableModel;
* **tableLable** — ярлык таблицы, по умолчанию берётся из комментария к таблице, если не найден, устанавливается равным имени таблицы;
* **groupName** — группа имён, если имя таблицы соответствует формату Sys_UserInfo, то по умолчанию устанавливается Sys в качестве группы имён;
* **moduleName** — модуль имён, если имя таблицы соответствует формату Sys_UserInfo, то по умолчанию устанавливается UserInfo в качестве модуля имён;
* **copyright** — объект авторских прав, каждый атрибут имеет значение по умолчанию, подробности см. в соответствующей документации API;
* **templateDirectory** — каталог шаблонов по умолчанию, по умолчанию равен относительному пути класса «template/название проекта», обратите внимание, что здесь название проекта не является именем приложения, а является названием узла проекта в файле конфигурации, например, в конфигурации проекта «AOWork» путь по умолчанию — «template/AOWork», конечно, это значение по умолчанию можно переопределить в файле конфигурации, чтобы заменить значение по умолчанию в коде.

Примечание:

Имя модели данных TableModel не «tableModel», а «table»;
Все вышеперечисленные модели данных можно напрямую использовать в файле конфигурации, как показано ниже, две модели данных «copyright.author» и «projectName» используются в определении модели данных:

```<dataModel name="outputDirectory">D:/QtoneProject/TengenCode/${copyright.author}/${projectName}</dataModel>```

**2.2.6 template узел**

Узел template имеет только два атрибута: name и type, которые представляют имя шаблона и тип шаблона соответственно. Тип шаблона также имеет только два значения перечисления: file и text. Узел template не является обязательным узлом проекта, обычно он используется, когда содержимое шаблона велико и его тип — text, или когда тип указан как file, и в этом случае содержимое узла представляет путь к шаблону, а не содержимое шаблона. Ниже приведён пример определения шаблона, связанного с информацией об авторских правах:

```<template name="tModel" type="text">  
<![CDATA[  
    ${defaultCopyright}    
    ${defaultJavaModelWithNoCopyright}  
]]>  
</template>