Val

Recurso para interagir com listas ou mapas com chaves e valores (dicionários). O valores é um objeto de armazenamento dados que pode ser representado como uma lista ou como um mapa de dados (dicionário). Uma vez inicializado como uma dessas estruturas, lista ou mapa, não poderá mais ser alterado para a outra.

const mapaDeDados = _val.map()
    .set('id', 1)
    .set('name', 'Netuno')
    .set('site', 'www.netuno.org')
    .set('active', 'true')
const idComoString = mapaDeDados.getString('id')
const name = mapaDeDados['name']
const site = mapaDeDados['site']
const active = mapaDeDados.getBoolean('active')

const listaDeDados = _val.list()
    .add('Linha 1')
    .push('Linha 2')
    .add('Linha 3')
for (const linha of listaDeDados) {
    _log.info(linha)
}

---

cast

---

_val.cast(obj: java.lang.Object) : Values

Descrição

Transforma um objeto em valores se possível.

Atributos

NOME	TIPO	DESCRIÇÃO
obj	java.lang.Object	Objeto para ser convertido.

Retorno

( Values )

O objeto convertido para valores.

---

fromJSON

---

_val.fromJSON(texto: string) : Values

Descrição

Obtém o values de uma string com array ou objecto em JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
texto	string	Conteúdo JSON.

Retorno

( Values )

O objeto de valores carregado com a estrutura e dados obtidos com a string JSON.

---

global

---

_val.global() : Values

Descrição

Instância do tipo Values para armazenar dados que ficam disponíveis apenas durante a execução do pedido HTTP, é útil para partilhar dados entre scripts.

Como Usar

// Define que esta sendo processado o cliente 10:
const global = _val.global()
global.set('clienteId', 10)
_out.json(global)

Retorno

( Values )

Dados que são partilhados globalmente entre os diversos scripts durante a execução da chamada HTTP.

---

init

---

_val.init() : Values

Descrição

Inicializa valores de modo genérico, o primeiro dado a ser atribuído definirá se será lista ou mapa.

Retorno

( Values )

O novo objeto de valores genérico.

---

_val.init(obj: Config | Exec | Header | Req | Res | Values | DataSchema) : Values

Descrição

Inicializa valores de modo genérico, o primeiro dado a ser atribuído definirá se será lista ou mapa.

Atributos

NOME	TIPO	DESCRIÇÃO
obj	Config | Exec | Header | Req | Res | Values | DataSchema	Objeto para carregar o novo objeto de valores criado.

Retorno

( Values )

O novo objeto de valores iniciado com os dados do objeto passado.

---

_val.init(obj: java.lang.Object) : Values

Descrição

Inicializa valores de modo genérico, o primeiro dado a ser atribuído definirá se será lista ou mapa.

Atributos

NOME	TIPO	DESCRIÇÃO
obj	java.lang.Object	Objeto para carregar o novo objeto de valores criado.

Retorno

( Values )

O novo objeto de valores iniciado com os dados do objeto passado.

---

_val.init(obj: Config | Exec | Header | Req | Res | Values | DataSchema) : Values

Descrição

Inicializa valores de modo genérico, o primeiro dado a ser atribuído definirá se será lista ou mapa.

Atributos

NOME	TIPO	DESCRIÇÃO
obj	Config | Exec | Header | Req | Res | Values | DataSchema	Objeto para carregar o novo objeto de valores criado.

Retorno

( Values )

O novo objeto de valores iniciado com os dados do objeto passado.

---

is

---

_val.is(obj: java.lang.Object) : boolean

Descrição

Verifica se o objeto é do tipo de valores.

Atributos

NOME	TIPO	DESCRIÇÃO
obj	java.lang.Object	Objeto para ser validado se é do tipo de valores.

Retorno

( boolean )

Resultado da verificação se é do tipo valores ou não.

---

list

---

_val.list() : Values

Descrição

Inicia um novo objeto de valores mas do tipo lista.

Retorno

( Values )

O novo objeto de valores iniciado como lista.

---

_val.list(valores: java.lang.Object) : java.util.List

Descrição

Transforma um objeto de valores para uma lista normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.lang.Object	Objeto de valores no modo lista.

Retorno

( java.util.List )

Uma nova lista normal com os itens do objeto de valores recebido.

---

_val.list(valores: Values) : java.util.List

Descrição

Transforma um objeto de valores para uma lista normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores no modo lista.

Retorno

( java.util.List )

Uma nova lista normal com os itens do objeto de valores recebido.

---

map

---

_val.map() : Values

Descrição

Inicia um novo objeto de valores mas do tipo mapa.

Retorno

( Values )

O novo objeto de valores iniciado como mapa.

---

_val.map(valores: java.lang.Object) : Config | Exec | Header | Req | Res | Values | DataSchema

Descrição

Transforma um objeto de valores para um mapa normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.lang.Object	Objeto de valores no modo mapa.

Retorno

( Config | Exec | Header | Req | Res | Values | DataSchema )

Uma novo mapa normal com os dados do objeto de valores recebido.

---

_val.map(valores: Values) : Config | Exec | Header | Req | Res | Values | DataSchema

Descrição

Transforma um objeto de valores para um mapa normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores no modo mapa.

Retorno

( Config | Exec | Header | Req | Res | Values | DataSchema )

Uma novo mapa normal com os dados do objeto de valores recebido.

---

persistent

---

_val.persistent() : Values

Descrição

Instância do tipo Values para armazenar dados que persistem na memória, ou seja os dados aqui guardados ficam disponíveis por todos os pedidos HTTP.

Como Usar

// Contagem mantida em memória que aumenta a cada refresh:
const persistente = _val.persistent()
persistente.set('counter', persistente.getInt('counter') + 1)
_out.json(persistente)

Retorno

( Values )

Dados que são mantidos em memória e que estão disponíveis para todas as solicitações.

---

toJSON

---

_val.toJSON(valores: java.util.List) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.util.List	Objeto de valores para ser transformado no formato JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: java.util.List, emHTML: boolean) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.util.List	Objeto de valores para ser transformado no formato JSON.
emHTML	boolean	Ativa a formatação automática em HTML dos caracteres especiais que estão nos valores de texto, útil para a transformação de acentos.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: java.util.List, emHTML: boolean, indentacao: int) : string

Descrição

Converte o values para JSON.

Como Usar

const lista = _val.list()
    .add("Item 1")
    .add("Item 2")
    .add("Item 3")
const listaString = _val.toJSON(lista)
_out.println(`${listaString}<br/>`)
const mapa = _val.map()
    .set("chave1", "Valor 1")
    .set("chave2", "Valor 2")
const mapaString = _val.toJSON(mapa)
_out.println(`${mapaString}<br/>`)

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.util.List	Objeto de valores para ser transformado no formato JSON.
emHTML	boolean	Ativa a formatação automática em HTML dos caracteres especiais que estão nos valores de texto, útil para a transformação de acentos.
indentacao	int	Quantidade de espaços que deve ser utilizado na indentação do JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: java.util.List, indentacao: int) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.util.List	Objeto de valores para ser transformado no formato JSON.
indentacao	int	Quantidade de espaços que deve ser utilizado na indentação do JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: Values) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores para ser transformado no formato JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: Values, emHTML: boolean) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores para ser transformado no formato JSON.
emHTML	boolean	Ativa a formatação automática em HTML dos caracteres especiais que estão nos valores de texto, útil para a transformação de acentos.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: Values, emHTML: boolean, indentacao: int) : string

Descrição

Converte o values para JSON.

Como Usar

const lista = _val.list()
    .add("Item 1")
    .add("Item 2")
    .add("Item 3")
const listaString = _val.toJSON(lista)
_out.println(`${listaString}<br/>`)
const mapa = _val.map()
    .set("chave1", "Valor 1")
    .set("chave2", "Valor 2")
const mapaString = _val.toJSON(mapa)
_out.println(`${mapaString}<br/>`)

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores para ser transformado no formato JSON.
emHTML	boolean	Ativa a formatação automática em HTML dos caracteres especiais que estão nos valores de texto, útil para a transformação de acentos.
indentacao	int	Quantidade de espaços que deve ser utilizado na indentação do JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

_val.toJSON(valores: Values, indentacao: int) : string

Descrição

Converte o values para JSON.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores para ser transformado no formato JSON.
indentacao	int	Quantidade de espaços que deve ser utilizado na indentação do JSON.

Retorno

( string )

String JSON com a estrutura e dados do objeto de valores.

---

toList

---

_val.toList(valores: java.lang.Object) : java.util.List

Descrição

Transforma um objeto de valores para uma lista normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.lang.Object	Objeto de valores no modo lista.

Retorno

( java.util.List )

Uma nova lista normal com os itens do objeto de valores recebido.

---

_val.toList(valores: Values) : java.util.List

Descrição

Transforma um objeto de valores para uma lista normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores no modo lista.

Retorno

( java.util.List )

Uma nova lista normal com os itens do objeto de valores recebido.

---

toMap

---

_val.toMap(valores: java.lang.Object) : Config | Exec | Header | Req | Res | Values | DataSchema

Descrição

Transforma um objeto de valores para um mapa normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	java.lang.Object	Objeto de valores no modo mapa.

Retorno

( Config | Exec | Header | Req | Res | Values | DataSchema )

Uma novo mapa normal com os dados do objeto de valores recebido.

---

_val.toMap(valores: Values) : Config | Exec | Header | Req | Res | Values | DataSchema

Descrição

Transforma um objeto de valores para um mapa normal.

Atributos

NOME	TIPO	DESCRIÇÃO
valores	Values	Objeto de valores no modo mapa.

Retorno

( Config | Exec | Header | Req | Res | Values | DataSchema )

Uma novo mapa normal com os dados do objeto de valores recebido.

---