Convert

Conversor de tipos de dados da aplicação.

---

arrayToList

---

_convert.arrayToList(array: java.lang.Object) : java.util.List

Descrição

Converte um array de tipos primitivos para uma lista (coleção).

Atributos

NOME	TIPO	DESCRIÇÃO
array	java.lang.Object	Array que será convertido numa lista (coleção).

Retorno

( java.util.List )

Nova lista com todos os elementos do array.

---

bytesFromText

---

_convert.bytesFromText(text: string) : byte[]

Descrição

Converte um text em array de bytes.

Atributos

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

Retorno

( byte[] )

Retorna o array de bytes obtido do texto.

---

_convert.bytesFromText(text: string, charset: string) : byte[]

Descrição

Converte um text em array de bytes.

Atributos

NOME	TIPO	DESCRIÇÃO
text	string	Conteúdo em texto.
charset	string	Código de codificação de caracteres.

Retorno

( byte[] )

Retorna o array de bytes obtido do texto.

---

fromBase64

---

_convert.fromBase64(conteúdo: byte[]) : string

Descrição

Converte o conteúdo com Base64 em uma string descodificada.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	byte[]	Conteúdo para ser convertido.

Retorno

( string )

Retorna a string descodificada que estava em Base64.

---

_convert.fromBase64(conteúdo: string) : string

Descrição

Converte o conteúdo com Base64 em uma string descodificada.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( string )

Retorna a string descodificada que estava em Base64.

---

fromBase64AsBytes

---

_convert.fromBase64AsBytes(conteúdo: byte[]) : byte[]

Descrição

Converte o conteúdo em Base64 para o array de bytes original descodificado.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	byte[]	Conteúdo para ser convertido.

Retorno

( byte[] )

Retorna os bytes descodificados que estavam em Base64.

---

_convert.fromBase64AsBytes(conteúdo: string) : byte[]

Descrição

Converte o conteúdo em Base64 para o array de bytes original descodificado.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( byte[] )

Retorna os bytes descodificados que estavam em Base64.

---

fromHTML

---

_convert.fromHTML(conteúdo: string) : string

Descrição

Transforma a codificação de caracteres especiais de HTML para texto normal.

Como Usar

// Vai imprimir: €s Ação
_out.print(_convert.fromHTML("€s Ação"))

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( string )

Texto com códificação dos caracteres especiais em HTML tranformado para texto normal.

---

fromJSON

---

_convert.fromJSON(conteúdo: string) : string

Descrição

Transforma a codificação de caracteres especiais de JSON para texto normal.

Como Usar

// Vai imprimir: €s Ação
_out.print(_convert.toJSON("\u20ACs A\u00E7\u00E3o"))

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( string )

Texto com codificação dos caracteres especiais em JSON tranformado para texto normal.

---

textFromBytes

---

_convert.textFromBytes(bytes: byte[]) : string

Descrição

Converte um array de bytes em text.

Atributos

NOME	TIPO	DESCRIÇÃO
bytes	byte[]	Array de bytes.

Retorno

( string )

Retorna o texto obtido do array de bytes.

---

_convert.textFromBytes(bytes: byte[], charset: string) : string

Descrição

Converte um array de bytes em text.

Atributos

NOME	TIPO	DESCRIÇÃO
bytes	byte[]	Array de bytes.
charset	string	Código de codificação de caracteres.

Retorno

( string )

Retorna o texto obtido do array de bytes.

---

toBase64

---

_convert.toBase64(conteúdo: byte[]) : string

Descrição

Converte o conteúdo em uma string codificada com Base64.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	byte[]	Conteúdo para ser convertido.

Retorno

( string )

Retorna a string codificada em Base64.

---

_convert.toBase64(conteúdo: string) : string

Descrição

Converte o conteúdo em uma string codificada com Base64.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( string )

Retorna a string codificada em Base64.

---

toBase64AsBytes

---

_convert.toBase64AsBytes(conteúdo: byte[]) : byte[]

Descrição

Converte o conteúdo em uma string codificada com Base64.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	byte[]	Conteúdo para ser convertido.

Retorno

( byte[] )

Retorna a string codificada em Base64.

---

_convert.toBase64AsBytes(conteúdo: string) : byte[]

Descrição

Converte o conteúdo em codificação Base64.

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( byte[] )

Retorna os bytes codificados em Base64.

---

toByte

---

_convert.toByte(valor: int) : byte

Descrição

Converte o valor recebido para byte.

Como Usar

_convert.toByte(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	int	Valor para ser convertido.

Retorno

( byte )

Retorna o valor recebido em byte.

---

_convert.toByte(valor: long) : byte

Descrição

Converte o valor recebido para byte.

Como Usar

_convert.toByte(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	long	Valor para ser convertido.

Retorno

( byte )

Retorna o valor recebido em byte.

---

_convert.toByte(valor: short) : byte

Descrição

Converte o valor recebido para byte.

Como Usar

_convert.toByte(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	short	Valor para ser convertido.

Retorno

( byte )

Retorna o valor recebido em byte.

---

toDouble

---

_convert.toDouble(valor: byte) : double

Descrição

Converte o valor recebido para double.

Como Usar

_convert.toDouble(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	byte	Valor para ser convertido.

Retorno

( double )

Retorna o valor recebido em double.

---

_convert.toDouble(valor: float) : double

Descrição

Converte o valor recebido para double.

Como Usar

_convert.toDouble(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	float	Valor para ser convertido.

Retorno

( double )

Retorna o valor recebido em double.

---

_convert.toDouble(valor: int) : double

Descrição

Converte o valor recebido para double.

Como Usar

_convert.toDouble(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	int	Valor para ser convertido.

Retorno

( double )

Retorna o valor recebido em double.

---

_convert.toDouble(valor: long) : double

Descrição

Converte o valor recebido para double.

Como Usar

_convert.toDouble(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	long	Valor para ser convertido.

Retorno

( double )

Retorna o valor recebido em double.

---

_convert.toDouble(valor: short) : double

Descrição

Converte o valor recebido para double.

Como Usar

_convert.toDouble(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	short	Valor para ser convertido.

Retorno

( double )

Retorna o valor recebido em double.

---

toError

---

_convert.toError(objeto: java.lang.Object) : java.lang.Error

Descrição

Converte o objecto recebido em um objeto de Error.

Como Usar

const erroOriginal = _error.createError("Falha grave.")
const generico = _convert.toObject(erroOriginal)
const deVoltaComoErro = _convert.toError(generico)
if (_error.isError(deVoltaComoErro)) {
    _error.info("É realmente uma falha grave...")
}

Atributos

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

Retorno

( java.lang.Error )

Retorna o objeto convertido em Error.

---

toException

---

_convert.toException(objeto: java.lang.Object) : java.lang.Exception

Descrição

Converte o objecto recebido em um objeto de Exception.

Como Usar

const excecaoOriginal = _error.createError("Falha grave.")
const generico = _convert.toObject(excecaoOriginal)
const deVoltaComoExcecao = _convert.toException(generico)
if (_error.isException(deVoltaComoExcecao)) {
    _error.info("É realmente uma falha grave...")
}

Atributos

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

Retorno

( java.lang.Exception )

Retorna o objeto convertido em Exception.

---

toFile

---

_convert.toFile(nome: string, conteúdo: string, bytes: byte[]) : File

Descrição

Inicia um objeto de ficheiro em memória com o conteúdo dos bytes recebidos.

Atributos

NOME	TIPO	DESCRIÇÃO
nome	string	Nome do ficheiro.
conteúdo	string	Tipo de conteúdo.
bytes	byte[]	Bytes que representam o conteúdo do ficheiro.

Retorno

( File )

Objeto do ficheiro iniciado que permite a manipulação dos bytes como ficheiro.

---

toFloat

---

_convert.toFloat(valor: byte) : float

Descrição

Converte o valor recebido para float

Como Usar

_convert.toFloat(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	byte	Valor para ser convertido.

Retorno

( float )

Retorna o valor recebido em float.

---

_convert.toFloat(valor: double) : float

Descrição

Converte o valor recebido para float

Como Usar

_convert.toFloat(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	double	Valor para ser convertido.

Retorno

( float )

Retorna o valor recebido em float.

---

_convert.toFloat(valor: int) : float

Descrição

Converte o valor recebido para float

Como Usar

_convert.toFloat(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	int	Valor para ser convertido.

Retorno

( float )

Retorna o valor recebido em float.

---

_convert.toFloat(valor: long) : float

Descrição

Converte o valor recebido para float

Como Usar

_convert.toFloat(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	long	Valor para ser convertido.

Retorno

( float )

Retorna o valor recebido em float.

---

_convert.toFloat(valor: short) : float

Descrição

Converte o valor recebido para float

Como Usar

_convert.toFloat(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	short	Valor para ser convertido.

Retorno

( float )

Retorna o valor recebido em float.

---

toHEX

---

_convert.toHEX(bytes: byte[]) : string

Descrição

Converte os bytes em hexadecimal com letras maiúsculas.

Atributos

NOME	TIPO	DESCRIÇÃO
bytes	byte[]	Bytes para serem convertidos.

Retorno

( string )

Retorna os bytes recebidos em hexadecimal em minúsculas.

---

toHTML

---

_convert.toHTML(conteúdo: string) : string

Descrição

Converte os caracteres especiais no texto para garantir que são válidos em HTML.

Como Usar

// Vai imprimir: €s Ação
_out.print(_convert.toHTML("€s Ação"))

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdp para ser convertido.

Retorno

( string )

Texto formatado com códificação dos caracteres especiais em HTML.

---

toHex

---

_convert.toHex(bytes: byte[]) : string

Descrição

Converte os bytes em hexadecimal com letras minúsculas.

Atributos

NOME	TIPO	DESCRIÇÃO
bytes	byte[]	Bytes para serem convertidos.

Retorno

( string )

Retorna os bytes recebidos em hexadecimal em minúsculas.

---

toInt

---

_convert.toInt(valor: byte) : int

Descrição

Converte o valor recebido para int.

Como Usar

_convert.toInt(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	byte	Valor para ser convertido.

Retorno

( int )

Retorna o valor recebido em int.

---

_convert.toInt(valor: double) : int

Descrição

Converte o valor recebido para int.

Como Usar

_convert.toInt(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	double	Valor para ser convertido.

Retorno

( int )

Retorna o valor recebido em int.

---

_convert.toInt(valor: float) : int

Descrição

Converte o valor recebido para int.

Como Usar

_convert.toInt(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	float	Valor para ser convertido.

Retorno

( int )

Retorna o valor recebido em int.

---

_convert.toInt(valor: long) : int

Descrição

Converte o valor recebido para int.

Como Usar

_convert.toInt(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	long	Valor para ser convertido.

Retorno

( int )

Retorna o valor recebido em int.

---

_convert.toInt(valor: short) : int

Descrição

Converte o valor recebido para int.

Como Usar

_convert.toInt(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	short	Valor para ser convertido.

Retorno

( int )

Retorna o valor recebido em int.

---

toJSON

---

_convert.toJSON(conteúdo: string) : string

Descrição

Converte os caracteres especiais no texto para garantir que são válidos em JSON.

Como Usar

// Vai imprimir: \u20ACs A\u00E7\u00E3o
_out.print(_convert.toJSON("€s Ação"))

Atributos

NOME	TIPO	DESCRIÇÃO
conteúdo	string	Conteúdo para ser convertido.

Retorno

( string )

Texto formatado com códificação dos caracteres especiais em JSON.

---

toLong

---

_convert.toLong(valor: byte) : long

Descrição

Converte o valor recebido para long.

Como Usar

_convert.toLong(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	byte	Valor para ser convertido.

Retorno

( long )

Retorna o valor recebido em long.

---

_convert.toLong(valor: double) : long

Descrição

Converte o valor recebido para long.

Como Usar

_convert.toLong(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	double	Valor para ser convertido.

Retorno

( long )

Retorna o valor recebido em long.

---

_convert.toLong(valor: float) : long

Descrição

Converte o valor recebido para long.

Como Usar

_convert.toLong(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	float	Valor para ser convertido.

Retorno

( long )

Retorna o valor recebido em long.

---

_convert.toLong(valor: int) : long

Descrição

Converte o valor recebido para long.

Como Usar

_convert.toLong(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	int	Valor para ser convertido.

Retorno

( long )

Retorna o valor recebido em long.

---

_convert.toLong(valor: short) : long

Descrição

Converte o valor recebido para long.

Como Usar

_convert.toLong(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	short	Valor para ser convertido.

Retorno

( long )

Retorna o valor recebido em long.

---

toObject

---

_convert.toObject(objeto: java.lang.Object) : java.lang.Object

Descrição

Converte o objecto recebido em um tipo de objeto genérico.

Como Usar

const objetoGenerico = _convert.toObject("Texto...")

Atributos

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

Retorno

( java.lang.Object )

Retorna como tipo de objeto genérico.

---

toShort

---

_convert.toShort(valor: byte) : short

Descrição

Converte o valor recebido para short.

Como Usar

_convert.toShort(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	byte	Valor para ser convertido.

Retorno

( short )

Retorna o valor recebido em short.

---

_convert.toShort(valor: int) : short

Descrição

Converte o valor recebido para short.

Como Usar

_convert.toShort(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	int	Valor para ser convertido.

Retorno

( short )

Retorna o valor recebido em short.

---

_convert.toShort(valor: long) : short

Descrição

Converte o valor recebido para short.

Como Usar

_convert.toShort(3456)

Atributos

NOME	TIPO	DESCRIÇÃO
valor	long	Valor para ser convertido.

Retorno

( short )

Retorna o valor recebido em short.

---

toThrowable

---

_convert.toThrowable(objeto: java.lang.Object) : java.lang.Throwable

Descrição

Converte o objecto recebido em um objeto de erro do tipo Throwable.

Como Usar

const erro = _error.createError("Falha grave.")
const comoThrowable = _convert.toThrowable(erro)
_error.rise(comoThrowable)

Atributos

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

Retorno

( java.lang.Throwable )

Retorna o objeto transformado em objeto de erro do tipo Throwable.

---

toUUID

---

_convert.toUUID(valor: string) : java.util.UUID

Descrição

Inicia um objeto de UUID com o conteúdo recebido.

Atributos

NOME	TIPO	DESCRIÇÃO
valor	string	String com conteúdo no formato de UUID.

Retorno

( java.util.UUID )

Objeto do UUID iniciado.

---