Neste último aditamento à sérieORDA, veremos como os novos conceitos ORDA podem interagir com objectos e colecções existentes. De facto, é possível transformar entidades e selecções de entidades em objectos e colecções, assim como construir entidades e selecções de entidades a partir de objectos e colecções. Ao fazê-lo, pode facilmente integrar o código ORDA no seu código existente. Pode tirar o máximo partido da ORDA sem precisar de reescrever o seu código!
Hoje utiliza SELECTION TO ARRAY e ARRAY TO SELECTION para trabalhar de forma desconectada do servidor, mas tem de gerir tantos matrizes como campos. E para um registo actual, não há maneira de o extrair de qualquer forma. Com ORDA, pode facilmente exportar entidades e selecções de entidades da base de dados para trabalhar nelas separadamente. E não é tudo, é possível importar objectos e colecções previamente criados para a base de dados. Tudo com um método único e fácil de usar!
Isto é muito útil para trabalhar eficientemente em modo cliente servidor, para comunicar com outras aplicações, ou para importar dados utilizando processos em lote.
ORDA: trabalhar com objectos e colecções
ENTIDADE EXPORTADORA E SELECÇÕES DE ENTIDADE A OBJECTOS E COLECÇÕES
Os exemplos seguintes são baseados nesta estrutura. Vamos sujar as nossas mãos!
EXPORTAÇÃO PARA OBJECTOS
Uma entidade pode ser extraída como um objecto utilizando o toObject() método. Aqui, extraímos a entidade $pupil como um objecto. Podemos escolher quais as propriedades a extrair.
Depois, podemos aplicar o método JSON Stringify para converter o valor deste objecto numa cadeia JSON e enviá-lo através da rede, por exemplo. C_OBJECT($pupil;$pupilObject)
C_TEXT ($pupilString)
//Get the first pupil whose last name is "Dunaway"
$pupil :=ds.Pupil.query("lastName=:1"; "Dunaway").first
()
If ($pupil#Null)
// Turn the entity to an object $pupilObject :=$pupil.toObject("firstName, lastName, email")
$pupilString :=JSON Stringify($pupilObject) // Stringify the object
End if
O objecto $pupilObject será:
{
"primeiroNome": "Cecil",
"sobrenome": "Dunaway",
"e-mail": "Cecil.Dunaway@echo"
}
EXPORTAÇÃO PARA COLEITAS
Uma selecção de entidade pode ser exportada para uma colecção utilizando o toCollection() método. Aqui, exportamos a selecção de entidades $pupils (que contém 2 entidades) como uma colecção. Decidimos extrair apenas o método de lastName and firstName propriedades, juntamente com todas as propriedades da entidade relacionada school .
Então, podemos aplicar o JSON Stringify para converter os valores desta colecção numa cadeia JSON e enviá-la através da rede, por exemplo.
C_OBJECT($pupils)
C_COLLECTION ($pupilsCollection)
C_TEXT ($pupilsString)
// Get the pupils whose first name starts with "L"
$pupils :=ds.Pupil.query("firstName=:1"; "L@")
//Turn the entity selection to a collection of objects
$pupilsCollection :=$pupils.toCollection("lastName,firstName,school.*")
$pupilsString :=JSON Stringify($pupilsCollection)
A colecção $pupilsCollection será:
[
{
"primeiroNome": "Lauren",
"sobrenome": "Bouchard",
"escola": {\i1}
"ID": 45,
"nome": "Escolas de artes",
"estado": "New Jersey" }
},
{
"primeiroNome": "Laurie",
"sobrenome": "Valenti",
"escola": {\i1}
"ID": 46,
"nome": "Escola de Matemática",
"estado": "New Jersey"}
}
]
Mais opções para toObject() e toCollection() estão disponíveis métodos, consulte a documentação para mais detalhes!
IMPORTAÇÃO DE ENTIDADES E SELECÇÕES DE ENTIDADE DE OBJECTOS E COLECÇÕES
importação de Objectos
Uma entidade pode ser construída a partir de um objecto com o fromObject() método. Aqui, criamos uma nova entidade $pupil a partir de um determinado objecto:
C_OBJECT($pupil;$pupilObject)
$pupilObject :=New object("firstName"; "Mary"; "lastName"; "Smith"; "email"; "Mary.Smith@whisky")
//Create a new empty entity
$pupil :=ds.Pupil. .new()
//Fill entity
$pupil.fromObject($pupilObject)
importação de colecções
Uma selecção de entidade pode ser construída a partir de uma colecção com o fromCollection() método. Aqui, construímos uma selecção de entidades $pupils a partir de uma determinada colecção.
Note-se que este mecanismo pode ser utilizado para criar novas entidades ou actualizar as já existentes. Depende simplesmente da presença da chave primária nos objectos.
C_OBJECT($pupils)
C_TEXT($txtPupils)
C_COLLECTION ($pupilsCollection)
$txtPupils :=Document to text(Get 4D folder(Current resources folder)+"pupils_data.json")
//Get a collection of objects
$pupilsCollection:=JSON Parse($txtPupils)
$pupils :=ds.Pupil.fromCollection($pupilsCollection)
e aqui está o $pupilsCollection collection:
[
{ // A chave primária da entidade não é dada. Será criada uma nova entidade
"primeiroNome": "Marca",
"sobrenome": "Mac Arthur",
"e-mail": "Mark.MacArthur@yankee",
"escola": {\i1}
"__KEY": "45"
}
},
{ // A chave primária da entidade é dada. Esta entidade será actualizada (se existir)
"__KEY": 3436,
"primeiroNome": "Victor",
"sobrenome": "Valenti",
"e-mail": "Victor.Valenti@NEWSCHOOL",
"escola": {\i1}
"__KEY": "45"
}
}
]