Object

Variáveis, campos ou expressões do tipo Objecto podem conter vários tipos de dados. A estrutura dos objectos 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". Deve seguir regras específicas.

• Um valor de propriedade pode ser do seguinte tipo:

  • number (Real, Integer, etc.)
  • text
  • null
  • boolean
  • 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 estar aninhados em vários níveis)
  • imagem(2)
  • collection

(1) Objetos não transmissíveis , como objetos ORDA (entidades, seleções de entidades, etc.), manipuladores de arquivos, servidor da Web... não podem ser armazenados nos campos de objeto **. Um erro será retornado se você tentar fazer isso; no entanto, eles são totalmente compatíveis com as variáveis do objeto ** na memória.

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

caution

Tenha em atenção que os nomes das propriedades diferenciam entre maiúsculas e minúsculas.

Você gerencia variáveis, campos ou expressões do tipo Object usando a notação de objeto padrão ou os comandos disponíveis no tema Objects (Language) . Gerencia variáveis do tipo Objecto, campos ou expressões usando a notação de objecto ou os comandos clássicos disponíveis no tema Objects (Language) .

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

• em código 4D, quer escritos nos métodos (Editor de Código) 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).

Instanciação

Os objetos devem ter sido inicializados, por exemplo utilizando o comando New object, do contrário ao tentar ler ou modificar suas propriedades se gerará um error de sintaxe.

Com a notação de objetos, pode acessar às propriedades dos objetos de duas maneiras:

• utilizando o comando New object,
• utilizando o operador {}.

info

Vários comandos e funções 4D devolvem objectos, por exemplo Obter medidas da base de dados ou Arquivo. Neste caso, não é necessário instanciar explicitamente o objecto, a linguagem 4D faz isso por você.

comando New object

O comando New collection cria uma nova colecção vazia ou pré-preenchida e devolve a sua referência.

Exemplos:

 C_OBJECT($obVar) //criação de um objeto de tipo 4D variável
 $obVar:=Novo objeto //initialization do objeto e atribuição à variável 4D

operador {}

O operador {} permite-lhe criar um objecto literal. Um literal de objecto é uma lista separada por semicolunas de zero ou mais pares de nomes de propriedades e valores associados de um objecto, entre chaves ({}). A sintaxe literal do objecto cria objectos vazios ou preenchidos.

Uma vez que qualquer valor de propriedade é considerado uma expressão, pode criar sub-objectos utilizando {} nos valores de propriedade. Também é possível criar e referenciar os literais da coleção ****.

Exemplos:

 var $o ; $o2 ; $o3 : Object //declaração de variáveis de objecto
 $o := {} // instanciação de um objecto vazio 
 $o2 := {a: "foo"; b: 42; c: {}; d: ($toto) ? true : false } // instanciação de um objecto
        // com propriedades {"a": "foo", "b":42, "c":{}, "d":false})

    // mesmas propriedades utilizando variáveis
 var $a : Text
 var $b : Number
 var $c : Object
 $a:="foo"
 $b:=42
 $c:={}
 $o3:={ a: $a; b: $b; c: $c } // {"a": "foo";b":42; "c":{}}

É possível misturar as sintaxes New object e literal:

$o:={\
    ob1: {age: 42}; \
    ob2: New object("message"; "Hello"); \
    form1: Formula(return This.ob1.age+10); \
    form2 : Formula(ALERT($1)); \
    col: [1; 2; 3; 4; 5; 6]\
    }

$o.form1() //52
$o.form2($o.ob2.message) // apresenta Hello
$col:=$o.col[5] //6

Objeto regular ou compartilhado

Pode criar dois tipos de objetos:

• objetos regulares (não compartilhados), usando o comando Novo objeto. Estes objetos podem ser editados sem qualquer controle de acesso específico, mas não podem ser compartilhados entre processos.
• objectos partilhados, utilizando 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.

Propriedades

Você acessa os valores de propriedade do objeto por meio de uma cadeia de tokens. As propriedades do objeto podem ser acessadas de duas maneiras:

• 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]

Como o valor de uma propriedade de objeto pode ser um objeto ou uma coleção, é possível usar 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 projeto ou Funções 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

Valor Null

Ao usar os objetos, o valor null é usado por meio do comando Null . Esse comando pode ser usado para atribuir ou comparar o valor nulo às propriedades do objeto, por exemplo:

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

Atenção: lembre que os nomes de atributos diferenciam entre maiúsculas e minúsculas.

Valor não definido

A avaliação de uma propriedade de um objeto pode produzir às vezes um valor indefinido. A atribuição de um valor indefinido a uma propriedade de objeto existente reinicializa ou limpa seu valor. Atribuir um valor indefinido a uma propriedade objecto não existente não faz nada.

Para saber mais, veja a descrição do comando Null

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

Resources

Os objetos usam recursos documentos, bloqueios de entidades e, é claro, memória. Esses recursos são mantidos enquanto os objetos precisarem. Normalmente, você não precisa se preocupar com eles, 4D libera automaticamente todos os recursos anexados a um objeto quando detecta que o objeto em si não é mais referenciado por qualquer variável ou outro objeto.

Por exemplo, quando não houver mais referências a uma entidade na qual você defina um bloqueio com $entity. ock(), 4D liberará a memória, mas também liberará automaticamente o bloqueio associado, uma chamada para $entity. nlock() é inútil.

Se quiser liberar imediatamente todos os recursos ocupados por um objeto sem ter que esperar que 4D faça isso automaticamente (no final da execução do método para variáveis locais por exemplo) tem que nullify all its references. Por exemplo:

$doc:=WP Import document("large_novel.4wp")
    ... // faça algo com $doc
$doc:=Null  // free resources occupied by $doc
    . . // continue a execução com mais memória livre

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 objecto
 C_OBJECT($myObj) //declara um objecto variável 4D
 $myObj:=Novo objecto //cria um objecto e atribui à variável
 $myObj.age:=56
 $age:=$myObj.age //56

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

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

• Criar uma propriedade e atribuir valores, incluindo objetos:

 C_OBJECT($Emp)
 $Emp:=Novo objecto
 $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"

• Você pode acessar propriedades como strings usando o operador []

 $Emp["city"]:="Berlim" //modifica a propriedade da cidade
  //isto pode ser útil para criar propriedades através de variáveis
 C_TEXT($addr)
 $addr:="endereço"
 For($i;1;4)
    $Emp[$addr+String($i)]:=""". Fim para
  // cria 4 propriedades vazias "address1...address4" no objecto $Emp