思库可思 sqxclib 发行版

2024-07-11 08:26

重大更改: 更改 API 参数 和 结构字段 以支持复合外键。

1  C 函数 sq_column_reference() 和 sq_table_add_foreign() 参数更改。
    sq_column_reference() 和 sq_table_add_foreign() 的最后一个参数必须为 NULL。

2  C++ 不受此更改的影响。

3  如果静态定义 SQL 外键，请将 SqColumn::foreign 的数据类型替换为以 NULL 结尾的字符串数组。
   请参阅下面的示例来更改您的代码。

3.1  列 "column" 和 删除时的操作 "onDeleteAction" 必须用空字符串 "" 分隔。
3.2  如果未指定 ON DELETE 操作，请将其设为空字符串 "" ，如下所示。

原来的:
.foreign = &(SqForeign) {"table", "column"}

改成:
.foreign = (char *[])   {"table", "column", NULL}

原来的:
.foreign = &(SqForeign) {"table", "column",       "onDeleteAction", "onUpdateAction"}

改成:
.foreign = (char *[])   {"table", "column",  "",  "onDeleteAction", "onUpdateAction", NULL}

原来的:
.foreign = &(SqForeign) {"table", "column",                   NULL, "onUpdateAction"}

改成:
.foreign = (char *[])   {"table", "column",  "",                "", "onUpdateAction", NULL}

---------------------------------------

用户添加新命令时不需要派生 SqCommandValue 结构。
与 SqCommandValue 相关的旧代码必须修改。

原有结构:

struct MyCommandValue : SqCommandValueMethod
	{
		SQ_COMMAND_VALUE_MEMBERS;

int  myOption;
	};

将结构更改为:

struct MyCommandOptions
	{
		int  myOption;
	};

原始处理函数:

static void mycommand_handle(SqCommandValue *commandValue, SqConsole *console, void *data)
	{
		MyCommandValue   *values  = (MyCommandValue*)commandValue;
	}

将处理函数更改为:

static void mycommand_handle(SqCommandValue *commandValue, SqConsole *console, void *data)
	{
		MyCommandOptions *options = (MyCommandOptions*)commandValue->options;
	}

其他相关变更: 
SqCommandCommon.h  重命名为 SqAppOptions.h
SqCommandCommon.c  重命名为 SqAppOptions.c
SqCommandMigrate.h 重命名为 SqAppCommands.h
SqCommandMigrate.c 重命名为 SqAppCommands-migrate.c
SqCommandMake.c    重命名为 SqAppCommands-make.c

---------------------------------------

Type Mapping:
SqColumn 添加 SQL 类型映射字段。更改字段的某些数据类型。
如果您使用 C++ 聚合初始化来初始化 SqColumn，您的代码可能会受到影响。

Query-only column:
为 SQL 指令「SELECT length(BlobColumn), * FROM table」新增仅查询列
SqConfig.h 加入 SQ_CONFIG_QUERY_ONLY_COLUMN 来启用/停用此功能。

BLOB, CLOB, TEXT
为 C SqBuffer 和 SQL BLOB 添加 SQ_TYPE_BUFFER
为 C++ std::vector<char> 和 SQL BLOB 添加 SQ_TYPE_STD_VECTOR。

SqPostgre: 在删除表之前删除触发函数。

SqType:    添加 setName() 和 useConstant()。
Sqdb:      迁移后，按名称对表和列进行排序。
SqTable:   添加主键缓存。
SqStorage: 添加使用原始字符串进行查询的功能。
SqStorage: 为 Sq::QueryMethod 和 Sq::QueryProxy 添加了便捷的 C++ 方法。

Sqxc: 为二进位和几何等 SQL 资料类型新增 SQXC_TYPE_RAW 类型。
Sqxc: 添加缺少的 C++ 方法 eraseNested()
SqxcSql 现在不访问 SqColumn::default_value，它可以使用 SqEntry 来输出 SQL 语句。

SqConsole: 无需命令名即可运行。 添加 C++ 方法。
SqCommand: 命令选项可以使用 Sqxc 输出 JSON 或 SQL。
SqOption: 添加将选项值设置为指针类型的函数。

SqApp: 禁用包含表 "User" 的示例迁移。默认情况下不会对其进行编译。

添加 sq_type_copy()    来替换 sq_type_copy_static()
添加 sq_column_copy()  来替换 sq_column_copy_static()
添加 sq_command_copy() 来替换 sq_command_copy_static()
sq_type_copy_static()、sq_column_copy_static()、sq_command_copy_static() 已弃用。

加入巨集 SQ_N_ELEMENTS() 来计算数组中存在的元素数量。
巨集 SQ_N_PTRS() 和 SQ_N_COLUMNS() 已弃用。

添加 sq_type_entry_array() 来替换 sq_type_get_ptr_array()，它获取 SqType 中的 SqEntry 数组。
sq_type_get_ptr_array() 已弃用。

sq_column_foreign() 已弃用。

删除 0.11 之前已弃用的代码

-------------

此版本中已弃用的符号

SQCODE_NOT_SUPPORT
SQCODE_TYPE_NOT_MATCH
SQCODE_TYPE_NOT_SUPPORT

SQ_N_PTRS()
SQ_N_COLUMNS()
SQ_PTR_ARRAY_MEMBERS()

sq_buffer_insert_n()
sq_buffer_write_n()
SQ_BUFFER_WRITE_N
SQ_BUFFER_INSERT_N

Sq::Type::copyStatic()
Sq::Command::copyStatic()
sq_type_get_ptr_array()
sq_type_copy_static()
sq_column_foreign()
sq_column_copy_static()
sq_command_copy_static()

最后提交信息为： bump version to 1.0

v0.11

13d7a6e

2023-07-06 08:20

v0.11

此版本主要修改了基础数据结构，下一个版本将删除已弃用的代码。

添加 SqArray、SqIntArray 和它们的静态 SqType：SQ_TYPE_ARRAY、SQ_TYPE_INT_ARRAY。

SqType-PtrArray.c 更名为 SqType-array.c

SqPtrArray: 移除 sq_ptr_array_init_full()
SqPtrArray: 更改 C 函数名称以对应 SqArray 的函数名称。
	sq_ptr_array_append   重命名为 sq_ptr_array_push
	sq_ptr_array_insert   重命名为 sq_ptr_array_push_to
	sq_ptr_array_append_n 重命名为 to sq_ptr_array_append
	sq_ptr_array_insert_n 重命名为 to sq_ptr_array_insert
	SQ_PTR_ARRAY_APPEND_N 重命名为 SQ_PTR_ARRAY_APPEND
	SQ_PTR_ARRAY_INSERT_N 重命名为 SQ_PTR_ARRAY_INSERT

SqStrArray: 更改 C 函数名称以对应 SqArray 的函数名称。
	sq_str_array_append   重命名为 sq_str_array_push
	sq_str_array_insert   重命名为 sq_str_array_push_to
	sq_str_array_append_n 重命名为 sq_str_array_append
	sq_str_array_insert_n 重命名为 sq_str_array_insert
	sq_str_array_dup_n    重命名为 sq_str_array_strdup

SqPairs: sq_pairs_find() 重命名为 sq_pairs_get()
SqPairs: 添加 C++ 類 Sq::Pairs

SqRow：添加 shareCols() 以节省内存。 SqArray 现在是 SqRow 的基本结构。
SqSchema：添加 new_ver() 和 init_ver() 以在初始化时指定版本。
SqTable、SqColumn：为其派生结构/类添加 init() 和 final()。
Sql::Table 添加方法 stdstr  （stdstring 的别名）
SqType 定义 SQ_TYPE_STD_STR （SQ_TYPE_STD_STRING 的别名）

弃用以下类型：
SQ_TYPE_INTPTR
SQ_TYPE_INTPTR_ARRAY
SqStringArray
SqIntptrArray
SqUintptrArray

最后提交信息为： bump version to 0.11

v0.10

8b5abe9

2023-03-03 08:27

v0.10

最后提交信息为： bump version to 0.10

v0.9

05ae8ef

2022-11-11 12:29

v0.9

SqQuery 重大变化：
  [已弃用] 如果列名包含 % 字符，则作为 printf 格式字符串处理。 （以后不支持）
  用户必须在传递条件值之前传递 printf 格式字符串。
  C 函数 sq_query_xxx_raw() 和 C++ 方法 xxxRaw() 现在支持 printf 格式字符串。
  请参阅 doc/SqQuery.md 以获取更多信息。

将来会删除与旧版本兼容的代码。
  SqConfig.h 有选项 SQ_CONFIG_QUERY_USE_OLD_CONDITION 来启用/禁用兼容代码。

例如:

// C 旧版
	sq_query_where(query, "id", ">", "100");
	sq_query_where(query, "id > %d", 10);

// C 新版本
	sq_query_where(query, "id", ">", "%d", 100);
	sq_query_where_raw(query, "id > %d", 10);

// C++ 旧版
	query->where("id", ">", "100");
	query->where("id > %d", 10);

// C++ 新版本
	query->where("id", ">", 100);
	query->whereRaw("id > %d", 10);

SqQuery 其他变化：
  更改节点的链接方式。
  添加 C 宏 sq_query_xxxx_sub() 用于在 C 语言中使用子查询。
  添加 C 函数 sq_query_last() 和 C++ 方法 last()
  添加 C 函数和 C++ 方法，例如 whereNot() 和 whereNull()。
  为 lambda std::function<void(SqQuery &query)> 添加 C++ 重载函数
  为 join()、on()、where() 和 have() 添加 C++ 重载函数以省略 printf 格式字符串。
  现在不需要在 sq_query_select()、sq_query_group_by()、sq_query_order_by() 的最后一个参数处传递 NULL。
  sq_query_where_in() 可以通过宏计算 printf 格式字符串后的值个数。
  sq_query_raw() 支持 printf 格式字符串并使用宏来计算参数的数量。
  在使用变量参数的宏的注释中添加声明。
  C++ 方法 whereBetween() 和 whereIn() 应该在 C 字符串中添加引号。

SqQuery 修复：
  sq_query_select_table_as()中使用AS名替换表名
  SqQuery 不能在括号中使用 sq_query_on() 和 sq_query_having()。

最后提交信息为： bump version to 0.9