Objetos

Variáveis, campos ou expressões do tipo Objecto podem conter vários tipos de dados. A estrutura dos objetos 4D "nativos" baseia-se no princípio clássico dos pares "propriedade/valor". A sintaxe desses objetos é baseada na notação JSON:

• Um nome de uma propriedade é sempre um texto, por exemplo "nome".

• Um valor de propriedade pode ser do seguinte tipo:

  • number (Real, Integer, etc.)
  • text
  • null
  • Parâmetros
  • ponteiro (armazenado como tal, avaliado usando o comando JSON Stringify ou quando copiando),
  • data (tipo de data ou cadeia de formato de data ISO)
  • objeto (os objetos podem ser aninhados em vários níveis)
  • imagem(*)
  • collection

(*)Quando se expõe como texto no depurador ou se exporta a JSON, as propriedades dos objetos imagem imprimem "[objeto Imagem]".

Aviso: tenha em mente que os nomes de atributo diferenciam entre maiúsculas e minúsculas.

Para gerenciar variáveis, campos ou expressões de tipo de objeto, você pode usar a notação de objeto (cf. Usando a notação objeto) ou os comandos 4D na seção Objetos (Linguagem). Note que comandos específicos do tema Queries tais como QUERY BY ATTRIBUTE, QUERY SELECTION BY ATTRIBUTE, ou ORDER BY ATTRIBUTE pode ser usado para realizar processamento em campos objeto.

Cada valor de propriedade acessado através da notação de objeto é considerado uma expressão. Quando a notação objeto estiver ativa no seu banco de dados (veja abaixo), você pode usar esses valores sempre que forem esperadas expressões 4D:

• em código 4D, quer escritos nos métodos (Editor de método) ou externalizados (fórmulas, ficheiros de etiquetas 4D processados por PROCESS 4D TAGS ou no Servidor Web, arquivos de exportação, documentos 4D Write Pro...),
• nas áreas de expressão do depurador e do explorador de Runtime,
• na lista de propriedades do editor de formulários para objectos de formulários: Variável ou Campo de expressão, bem como várias caixas de selecção e expressões de colunas (Fonte de dados, cor de fundo, estilo, ou cor da fonte).

Inicialização

Objetos devem ter sido inicializadas, por exemplo, usando o comando New object, caso contrário, tentar ler ou modificar suas propriedades gerará um erro de sintaxe.

Exemplo:

 C_OBJECT($obVar) //criação de uma variável 4D do tipo objeto
 $obVar:=New object //inicialização do objeto e atribuição à variável 4D

Objeto regular ou compartilhado

Pode criar dois tipos de objetos:

• objetos regulares (não compartilhados) usando o comando New object. Estes objetos podem ser editados sem qualquer controle de acesso específico, mas não podem ser compartilhados entre processos.
• objetos compartilhados, usando o comando New shared object. Estes objetos podem ser compartidos entre processos, incluidos os threads preemptivos. Access to these objects is controlled by Use... End use structures. Para saber mais, consulte a seção Objetos e coleções compartidos.

Noções básicas de sintaxe

A notação de objetos pode ser utilizada para acessar aos valores das propriedades de objetos através de uma string de tokens.

Propriedades dos objectos

Identificadores de propriedades de objetos

• usar uma string dentro de colchetes: > object["propertyName"]

Exemplo:

     employee.name:="Smith"

• usar um simbolo "ponto": > object.propertyName

Exemplos:

     $vName:=employee["name"]
     /ou também:
     $property:="name"
     $vName:=employee[$property]

Uma vez que um valor de propriedade de objeto pode ser um objeto ou uma coleção, a notação de objeto aceita uma sequência de símbolos para acessar subpropriedades, por exemplo:

 $vAge:=employee.children[2].age

A notação de objetos está disponível em qualquer elemento da lenguagem que possa conter ou devolver um objeto, ou seja:

• com os Objetos mesmos (armazenados em variáveis, campos, propriedades de objetos, arrays de objetos ou elementos de coleções). Exemplos:

     $age:=$myObjVar.employee.age //variável
     $addr:=[Emp]data_obj.address //campo
     $city:=$addr.city //propriedade de um objeto
     $pop:=$aObjCountries{2}.population //array objeto
     $val:=$myCollection[3].subvalue //elemento coleção

• Comandos 4D que devolvem objectos. Exemplo:

     $measures:=Get database measures.DB.tables

• Métodos de Projeto que retornam objetos. Exemplo:

      // MyMethod1
     C_OBJECT($0)
     $0:=New object("a";10;"b";20)

      //myMethod2
     $result:=MyMethod1.a //10

• Collections Example:

     myColl.length //tamanho da coleção

Ponteiro

Nota preliminar: dado que os objetos são passados sempre por referência, geralmente não é preciso usar ponteiros. Ao passar o objeto, internamente 4D utiliza automaticamente um mecanismo similar a um ponteiro, minimizando a necessidade de memória e permitindo modificar o parâmetro e devolver as modificações. Como resultado, não é necessário usar ponteiros. Mas se quiser usar ponteiros, valores de propriedade podem ser acessados com ponteiros.

Usar notação de objeto com ponteiros é parecido com usar notação de objeto diretamente com os objetos, exceto que o símbolo "ponto" deve ser omitido.

• Acesso direto

pointerOnObject->propertyName

• Acesso pelo nome:

pointerOnObject->["propertyName"]

Exemplo:

 C_OBJECT(vObj)
 C_POINTER(vPtr)
 vObj:=New object
 vObj.a:=10
 vPtr:=->vObj
 x:=vPtr->a //x=10

Valor Null

Quando se usar a notação de objeto, o valore null se torna compatível com o comando Null . Este comando pode ser usado para atribuir ou comparar o valor nulo com as propriedades de objeto ou elementos de coleção, por exemplo

 myObject.address.zip:=Null
 If(myColl[2]=Null)

Para mais informações, consulte a descrição de comando Null.

Valor não definido

A avaliação de uma propriedade de um objeto pode produzir às vezes um valor indefinido. Normalmente ao tentar ler ou atribuir expressões indefinidas, 4D gera erros. Isso não acontece nos casos abaixo:

• Lendo uma propriedade de um objeto indefinido ou valor retorna indefinido; atribuir um valor indefinido para variáveis (exceto arrays) tem o mesmo efeito que chamar com eles:

     C_OBJECT($o)
     C_LONGINT($val)
     $val:=10 //$val=10
     $val:=$o.a //$o.a é indefinido (sem erro) e a atribuição desse valor limpa a variável
      //$val=0

• Lendo a propriedade de comprimento de uma coleção indefinida produz 0:

     C_COLLECTION($c) //variável criada, mas nenhuma coleção está definida
     $size:=$c.length //$size = 0

• Um valor indefinido passado como parâmetro para um método de projecto é automaticamente convertido em 0 ou "" de acordo com o tipo de parâmetro declarado.

     C_OBJECT($o)
     mymethod($o.a) //passa um parâmetro indefinido

      //No método mymethod
     C_TEXT($1) //o tipo de parâmetro é texto
      // $1 contém ""

• Uma expressão de condição é automaticamente convertida em falsa quando se avalia para indefinida com as palavras-chave If e Case:

     C_OBJECT($o)
     If($o.a) // false
     End if
     Case of
        :($o.a) // false
     End case

• A atribuição de um valor indefinido a um objecto existente reinicia ou limpa o seu valor, dependendo do seu tipo:
• Objecto, colecção, ponteiro: Null
• Imagem: Imagem vazia
• Booleano: Falso
• String: ""
• Número: 0
• Data: !00-00-00-00! se a configuração "Usar tipo de data em vez de formato de data ISO nos objetos" estiver habilitada, caso contrário ""
• Hora: 0 (número de ms)
• Indefinido, Null: sem mudança

     C_OBJECT($o)
     $o:=New object("a";2)
     $o.a:=$o.b //$o.a=0

• Atribuir um valor indefinido a uma propriedade objecto não existente não faz nada.

Quando expressões de um certo tipo são esperadas em seu código 4D, pode garantir que tenha o tipo correto mesmo quando são avaliadas como indefinidas, cercando-as com o comando de transformação 4D apropriado: String, Num, Date, Time, Bool. Estes comandos devolvem um valor vazio de tipo especificado quando a expressão é avaliada como indefinida. Por exemplo:

 $myString:=Caixa minúscula(String($o.a.b))) // certifique-se de obter um valor de string mesmo que não esteja definido
  // para evitar erros no código

Identificadores de propriedade de objetos

As regras de nomenclatura dos tokens (ou seja, nomes de propriedades de objetos acessados usando a notação objeto) são mais restritivos do que nomes de objetos 4D padrão. Devem estar em conformidade com a gramática de identificadores JavaScript (consulte ECMA Script standard):

• o primeiro caractere deve ser uma letra, um sublinhado (_) ou um cifrão ($),
• os caracteres podem ser qualquer letra, dígito, um sinal de sublinhado ou dólar (não são permitidos caracteres de espaço),
• eles são sensíveis às maiúsculas e minúsculas.

Nota:

• Usar um campo de tabela como um índice de coleção, por exemplo, a.b[[Table1]Id], não é permitido. É necessário utilizar uma variável intermédia.
• Criar atributos de objeto usando uma string entre colchetes quadradas permite que você substitua as regras de ECMA Script. Por exemplo, o atributo $o["My Att"] é válido em 4D, apesar do espaço. No entanto, neste caso, não será possível usar uma notação de ponto com esse atributo.

Exemplos

Usar notação de objeto simplifica o código 4D no manejo dos mesmos. Entretanto note que a notação baseada em comandos continua sendo totalmente compatível.

• Escrita e leitura das propriedades de objetos (este exemplo compara a notação de objetos e anotação de comandos):

  // Usando a notação de objeto
 C_OBJECT($myObj) //declara um objeto de variável 4D
 $myObj:=New object //cria um objeto e atribui à variável
 $myObj. idade: =56
 $age:=$myObj. ge //56

  // Usando a notação de comando
 C_OBJECT($myObj2) /declara um objeto de variável 4D
 OB SET($myObj2; idade";42) /cria um objeto e adiciona a propriedade de idade
 $age:=OB Get($myObj2; idade") /42

  // É claro, ambas as notações podem ser misturadas
 C_OBJECT($myObj3)
 OB SET($myObj3; idade";10)
 $age:=$myObj3. de //10

• Criar uma propriedade e atribuir valores, incluindo objetos:

 C_OBJECT($Emp)
 $Emp:=New object
 $Emp.city:="London" //cria a propriedade da cidade e define o seu valor para "London"
 $Emp.city:="Paris" //modifica a propriedade da cidade
 $Emp.phone:=Novo objecto("office"; "123456789"; "home"; "0011223344")
  //cria a propriedade do telefone e define o seu valor para um objecto

• Obter um valor em um subobjeto é bem simples usando a notação de objeto:

 $vCity:=$Emp.city //"Paris"
 $vPhone:=$Emp.phone.home //"0011223344"

• É possível acessar as propriedades como strings usando o operador []

  $Emp["city"]:="Berlin" //modifica a propriedade city
  //isso pode ser útil para criar propriedades por meio de variáveis
 var $addr : Text
 $addr:="address"
 For($i;1;4)
    $Emp[$addr+String($i)]:=""
 End for
  // cria 4 propriedades vazias "address1...address4" no objeto $Emp