Entity selections

Uma entity selection é um objeto que contém uma ou mais referências a entidades que pertecem à mesma dataclass. Uma entity selection pode conter 0, 1 ou entidades X da dataclass, onde X pode representar a quantidade total de entidades contidas na dataclass. As entity selections podem ser "ordenadas" ou "não ordenadas" (este ponto se analisa abaixo).

As entity selections geralmente são criadas utilizando uma pesquisa ou são retornadas desde um atributo relação. Por exemplo:

Este código retorna em brokers todas as pessoas de tipo broker. Para acessar a uma entidade da seleção, utilize uma sintaxe similar para acessar a um elemento em uma coleção. Por exemplo:

Este código retorna em brokers a mesma seleção de entidade das entidades Person, mas ordenadas por nome.

Alternativamente, pode usar um atributo relação para devolver uma seleção de entidade. Por exemplo:

Este código atribui a brokerCompanies todas as empresas relacionadas das pessoas na seleção de entidade brokers, utilizando o atributo de relação myCompany. O uso de atributos de relação nas seleções de entidades é uma forma poderosa e fácil de navegar para cima e para baixo a série de entidades relacionadas.

Para realizar ações repetidas a entidades em uma seleção de entidades, como recuperar e modificar valores de certos atributos, pode usar a estrutura For each...End for each. Por exemplo:

É possível criar  um  objeto de tipo entity selection da seguinte maneira:

• Buscar as entidades em uma dataclass (ver o método dataClass.query( ));
• Usando o método dataClass.all( )para selecionar todas as entidades em uma dataclass;
• Usando o comando Criar seleção de entidade ou o método dataClass.newSelection( ) para criar um objeto entity collection em branco;
• Usando um dos vários métodos do tema ORDA - seleção de entidade que retorna uma nova seleção de entidade, como entitySelection.or( );
• Usando um atributo relação de tipo "related entities" (ver abaixo).

Pode criar e usar simultaneamente tantas entity selections diferentes quantas queira para uma dataclass. Lembre que uma entity selection só contém referências a entidades. As diferentes entity selections podem conter referências às mesmas entidades.

Nota: Uma seleção de entidade é definida apenas no processo onde foi criada. Não é possível, por exemplo, armazenar uma referência a uma seleção de entidade em uma variável interprocesso e usá-la em outro processo.

Todos os atributos de armazenamento (texto, número, booleano, data) estão disponíveis como propriedades das entity selections assim como das entidades. Quando for usado junto com uma entity selection, um atributo escalar retorna uma coleção de valores escalares. Por exemplo:

Este código retorna em localEmails uma coleção de endereços de correio eletrônico como strings.

Além da variedade de formas em que pode realizar consultas, também pode usar atributos relação como propriedades de entity selections  para devolver novas entity selections. Por exemplo, considere a estrutura abaixo:

A última linha devolverá em $myInvoices uma entity selection de todas as faturas que tenham pelo menos um item de fatura  relacionado com uma parte na entity selection myParts. Quando um atributo relação for usado como uma propriedade de una entity selection, o resultado é sempre outra entity selection, mesmo se apenas for  devolvida uma entidade. Quando um atributo relação for usado como uma propriedade de uma entity selection e não forem retornadas entidades, o resultado é uma seleção de entidade vazia, não null.

As entity selections locais  podem ser ordenadas ou não ordenadas. Basicamente, ambos objetos têm uma funcionalidade similar, mas existem algumas diferenças com respeito a seu rendimento e funções disponíveis. Pode decidir que tipo de entity selection usar segundo suas necessidades específicas.

Nota: as Entity selections em uma devolvidas por 4D Server a um cliente remoto sempre são ordenadas.

• As entity selections desordenadas são construídas sobre tabelas de bits na memória. Uma entity selection desordenada contém um bit para cada entidade na dataclass, independentemente de se a entidade estiver realmente na seleção. Cada bit é igual a 1 ou 0, para indicar se a entidade estiver ou não  incluída na seleção. É uma representação muito compacta para cada entidade.
  Como consequência, as operações que utilizam entity selections não ordenadas são muito rápidas. Além disso, as entity selections desordenadas são econômicas em termos de espaço de memória. O tamanho de uma entity selection desordenada, em bytes, sempre é igual ao número total de entidades na dataclass dividido entre 8. Por exemplo, se criar uma  entity selection desordenada para uma dataclass  que contenha 10.000 entidades, ocupará 1.250 bytes, que é aproximadamente 1.2K em RAM.
  Por outro lado, as entity selections não ordenadas não podem ser ordenadas. Não pode confiar na posição das entidades dentro da seleção. Além disso, não pode ter mais de uma referência à mesma entidade na seleção: cada entidade só pode ser agregado uma vez.

• As entity selections ordenadas são criadas sobre arrays inteiros longos (que contenham referências de entidade) na memória. Cada referência a uma entidade toma 4 bytes na memória. Processar e manter essas seleções leva mais tiempo e exige mais espaço de memória que as seleções sem ordenar.
  Por outro lado, podem ser ordenadas ou reordenar, e pode confiar nas posições da entidade. Além disso, pode agregar mais de uma referência à mesma entidade.

A tabela abaixo resume as principais funcionalidades de cada tipo de entity selection:

Por razões de otimização, como padrão normal, 4D ORDA geralmente cria entity selections não ordenadas, exceto quando utilizar o método orderBy( ) ou usar as opções apropriadas (ver a continuação). Nesta documentação, a menos que se especifique "entity selection" geralmente se refere a uma "entity selection desordenada".

Como se mencionou anteriormente, ORDA por padrão cria e maneja entity selections não ordenadas como resultado de operações tais como consultas ou comparações como and( ). As entity selections ordenadas são criadas só quando for necessário ou quando são solicitadas especificamente mediante o uso de opções.

As entity selections ordenadas são criadas nos casos abaixo:

• resultado de um orderBy( ) em uma seleção (de qualquer tipo) ou uma orderBy( ) em uma dataclass
• resultado do método newSelection( ) com a opção dk keep ordered

As entity selections desordenadas são criadas nos casos abaixo:

• resultado de uma query( ) padrão em uma seleção (de qualquer tipo) ou uma query( ) em uma dataclass,
• resultado do método newSelection( ) sem opção,
• resultado de qualquer um dos métodos de comparação, qualquer que seja o tipo de seleção de entrada: or( ), and( ), minus( ).

Lembre que quando uma entity selection ordenada são convertida em uma entity selection desordenada, qualquer referência de entidade repetida é eliminada.

Se quiser transformar uma entity selection ordenada em uma não ordenada, pode simplesmente aplicar uma operação and( ), por exemplo:

4D oferece uma otimização automática para as petições ORDA que utilizam seleções de entidades ou carregam entidades nas configurações cliente/servidor. Esta otimização acelera a execução de sua aplicação 4D ao reduzir drasticamente o volume de informação transmitida através da rede.

São implementadas os seguintes mecanismos de otimização:

• Quando um cliente solicita uma seleção de entidades de servidor, 4D "aprende" automaticamente que atributos da seleção de entidades são utilizadas realmente do lado do cliente durante a execução de código, e cria um "contexto de otimização" correspondente. Este contexto se anexa à seleção de entidades e armazena os atributos utilizados. Se atualizará dinamicamente se depois forem utilizados outros atributos.
• As petições posteriores enviadas ao servidor na mesma seleção de entidades reutilizam automaticamente o contexto de otimização e apenas obtém os atributos necessários do servidor, o que acelera o processamento. Por exemplo, em um list box baseado na seleção de entidades, a fase de aprendizagem é feita durante a visualização das primeiras filas, a visualização das filas seguintes está muito otimizada.
• Um contexto de otimização existente pode ser passada como uma propriedade a outra seleção de entidades da mesma classe de dados, pelo que se ignora a fase de aprendizagem e se acelera a aplicação (ver abaixo "Uso da propriedade de contexto").

Os métodos abaixo associam automaticamente o contexto de otimização da seleção de entidades de origem à seleção de entidades devolvidas:

• entitySelection.and( )
• entitySelection.minus( )
• entitySelection.or( )
• entitySelection.orderBy( )
• entitySelection.slice( )
• entitySelection.drop( )

Exemplo

Dado o código abaixo:

Graças à otimização, esta solicitude apenas obterá dados dos atributos utilizados (nome, sobrenome, empregador, empregador.nome) em $sel depois de uma fase de aprendizagem.

Utilizando a propriedade de contexto

Pode aumentar os beneficios da otimização utilizando a propriedade contexto. Esta propriedade faz referência a um contexto de otimização "aprendido" para uma seleção de entidades. Se pode passar como parâmetro aos métodos ORDA que devolvem novas seleções de entidades, de modo que as seleções de entidades solicitem diretamente aos atributos utilizados ao servidor e omitem a fase de aprendizagem.

Uma mesma propriedade de contexto de otimização pode ser passada a um número ilimitado de seleções de entidades na mesma classe de dados. Todos os métodos ORDA que manejam as seleções de entidades admitem a propriedad contexto (por exemplo, o método dataClass.query( ) ou dataClass.all( )). Entretanto, lembre que um contexto se atualiza automaticamente quando forem usados novos atributos em outras partes do código. Reutilizar o mesmo contexto em diferentes códigos poderia resultar em uma sobrecarga de contexto e depois reduzir sua eficiência.

Nota: se implementa um mecanismo similar para as entidades que são carregadas, de modo que apenas são solicitadas os atributos utilizados (ver o método dataClass.get( )). 

List box baseado na seleção de entidades

A otimização da seleção de entidades se aplica automaticamente aos list boxes baseados ​em seleção de entidades nas configurações cliente/servidor, ao mostrar e deslocar o conteúdo de um list box. Apenas os atributos mostrados no list box são solicitados desde o servidor. Entretanto, lembre que se utiliza um contexto de otimização diferente quando se carrega a entidade atual da seleção, para não sobrecarregar o contexto de list box.

Exemplo com o método dataClass.query( ): 

O objeto entity selection em si mesmo não pode ser copiado como um objeto:

Entretanto, as propriedades entity selection são numeráveis: