Caminho lógico dos componentes

O caminho lógico é usado para organizar componentes gerenciados por um gravador em grupos bem definidos.

O caminho lógico é análogo na estrutura ao caminho de arquivo tradicional, usando a barra invertida "\" para separar elementos no caminho. Ao contrário dos caminhos de arquivo, a raiz de um caminho lógico é NULL, em vez de "\".

O caminho lógico é expresso como uma cadeia de caracteres terminada em NULL e não há outras restrições nos caracteres que o caminho pode conter.

O uso mais importante do caminho lógico está na definição de conjuntos de componentes, em que a inclusão explícita do componente em uma operação de backup ou restauração de um componente selecionável requer a inclusão de vários outros componentes (subcomponente). O caminho lógico do componente definidor de um conjunto de componentes é um pai para os caminhos lógicos de seus subcomponentes e:

• Os subcomponentes devem compartilhar como um caminho raiz o caminho lógico do componente selecionável que define o conjunto de componentes.
• Um caminho raiz de NULL é válido.
• O nome do componente selecionável definidor deve ser o primeiro elemento de caminho lógico após o caminho raiz para cada subcomponente não reelecionável do conjunto de componentes.
• Os conjuntos de componentes podem ser aninhados.
• A combinação de caminho lógico e nome do componente deve ser exclusiva em todas as instâncias de uma classe de gravador.

O exemplo hipotético de um gravador MyWriter com uma estrutura de caminho lógico definida abaixo ilustra o caminho lógico.

Nome do Componente	Caminho lógico	Selecionável para backup
"Executáveis"	""	N
"ConfigFiles"	"Executáveis"	N
"LicenseInfo"	""	S
“Segurança”	""	S
"UserInfo"	“Segurança”	N
"Certificados"	“Segurança”	N
"writerData"	""	S
"Set1"	"writerData"	N
"Jan"	"writerData\Set1"	N
"Dez"	"writerData\Set1"	N
"Set2"	"writerData"	N
"Jan"	"writerData\Set2"	N
"Dez"	"writerData\Set2"	N
"Consulta"	"writerData\QueryLogs"	N
"Uso"	"writerData"	S
"Jan"	"writerData\Usage"	N
"Dez"	"writerData\Usage"	N

 

Observe que os componentes "Executables" e "ConfigFile" têm uma relação pai-filho, mas ambos são não reelecionáveis. Portanto, eles não formam um conjunto de componentes. Sempre que o gravador MyWriter for feito backup ou restaurado, esses dois componentes precisarão ser incluídos explicitamente na operação.

O componente "LicenseInfo" é selecionável sem ancestral nem descendente. Ele pode ser incluído explicitamente ou não em uma operação de backup ou restauração a critério do solicitante.

O componente "Segurança" define um conjunto de componentes simples, sem nenhum conjunto de componentes abaixo dele.

O componente "writerData" define um conjunto de componentes, que contém uma coleção complexa de componentes com várias hierarquias de caminho lógico bem definidas abaixo dele.

Um subcomponente, "Uso", é selecionável e define um conjunto de componentes.

Vários componentes têm o mesmo nome e são diferenciados por seus caminhos lógicos. As instâncias dos componentes não reelecionáveis "Dec" e "Jan" existem nos componentes componentes não reelecionáveis "Set1" e "Set2" e no subcomponente selecionável "Uso".

Se o componente "writerData" for explicitamente incluído em um backup ou restauração, todos os seus subcomponentes, mesmo aqueles no conjunto de componentes aninhados definido por "Uso", serão incluídos implicitamente na operação.

Se o conjunto de componentes definido por "writerData" não estiver explicitamente incluído em um backup ou restauração, os componentes "Set1", "Set2" e "QueryLogs" (e suas instâncias de subcomponentes "Dec" e "Jan") não serão incluídos implicitamente na operação de backup ou restauração.

No entanto, mesmo que "writerData" não esteja incluído na operação, o componente "Uso" ainda será selecionável e ainda poderá ser incluído explicitamente em uma operação de backup ou restauração. Se for, seus subcomponentes "Jan" e "Dez" serão incluídos implicitamente.

Outros pontos dignos de observação:

• Os componentes selecionáveis "LicenseInfo" e "writerData" e o componente não selecionável "Executables" estão todos no mesmo nível na hierarquia de caminho lógico do MyWriter: todos têm o mesmo caminho lógico de NULL ou "", o caminho lógico raiz.
• O componente selecionável "Uso" nunca deve ser incluído explicitamente em um backup, se seu pai selecionável ("writerData") estiver explicitamente incluído em uma operação de backup ou restauração.
• Componentes que definem conjuntos de componentes podem existir simplesmente por motivos organizacionais. Por exemplo, o componente "writerData" ou "Uso" ou ambos podem estar vazios; ou seja, nenhum conjunto de arquivos foi adicionado a eles usando o método IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles ou IVssCreateWriterMetadata::AddDatabaseLogFiles . Os componentes ainda definem um conjunto de componentes.