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