在FDO 3.4之前,使用FdoIDescribeSchema会返回DataStore中所有要素模式和要素类的信息。如果DataStore中包含了大量的要素类,执行FdoIDescribeSchema命令将是一个非常耗时的过程,对RDBMS类型的FDO Prvoder来说尤为如此。在许多情况下,用户只想得到某些要素模式和要素类的名称,这时他们需要一种更加高效的方法。
FDO 3.4引入了两个新的命令FdoIGetSchemaNames和FdoIGetClassNames来解决这个问题。命令FdoIGetSchemaNames可以返回DataStore中所有要素模式的名称,命令FdoIGetClassNames可以返回指定要素模式中所有要素类的名称。
以下示例代码展示了如何获得DataStore的第一个要素模式中所有要素类的名称。
// 创建FdoIGetSchemaNames命令 FdoPtr<FdoIGetSchemaNames> getSchemaNamesCmd = (FdoIGetSchemaNames*) connection->CreateCommand(FdoCommandType_GetSchemaNames); // 执行FdoIGetSchemaNames命令,获得Data Store中所有要素模式的名称 FdoPtr<FdoStringCollection> schemaNames = getSchemaNamesCmd->Execute();
// 创建FdoIGetClassNames命令 FdoPtr<FdoIGetClassNames> getClassNamesCmd = (FdoIGetClassNames*) connection->CreateCommand(FdoCommandType_GetClassNames); FdoString* schemaName = (FdoString*)schemaNames->GetItem(0)->GetString(); getClassNamesCmd->SetSchemaName(schemaName); //执行FdoIGetSchemaNames命令,获得DataStore的第一个要素模式中所有要素类的名称 FdoPtr<FdoStringCollection> classNames = getClassNamesCmd->Execute(); |
但是,如果想使用FdoIDescribeSchema返回指定要素类的定义,我们还必须扩展该命令。所以,FDO 3.4扩展了命令FdoIDescribeSchema,增加了方法GetClassNames和SetClassNames。
class FdoIDescribeSchema : public FdoICommand { public: virtual FdoString* GetSchemaName(); virtual void SetSchemaName(FdoString* value);
// FDO 3.4中新增的方法 virtual FdoStringCollection* GetClassNames(); virtual void SetClassNames(FdoStringCollection* value); ...... }; |
如果为该命令设置了需要返回的要素模式名称和要素类名称,则只返回指定要素类的定义;如果没有指定要素模式名称,在调用方法SetClassNames时必须使用合格名称(Qualified Name,即由要素模型名称和要素类名称组成的名称);如果要素类名称不是合格名称,那么返回所有匹配要素类的定义。
但是,遗憾的是:并非所有FDO Provider支持对命令FdoIDescribeSchema的扩展。因为多数文件类型的FDO Provider并不会受益于这个扩展,所以目前主要是RDBMS类型的FDO Provider支持这种扩展。例如:在使用FDO sqlite Provider时,即使调用SetClassNames设置了需要返回的要素类,仍然会返回所有的要素类定义。