Url's
No rucula-js a criação de url's é um processo dinâmico, que ocorre a partir da leitura de algumas propriedades presentes na configuração global, na janela e nos botões.
{
name: "Clientes",
pathController: "Cliente", 👈
type: "crud",
grid:false,
frames: []
...
}
environments:[
{
env:"development",
hostname:"http://localhost", 👈
port: "5016" 👈
}
]
{
URL:{
absolute:string 👈
relative:string, 👈
params:string 👈
}
}
A URL Principal
A URL principal usada por todas as janelas é criada a partir da configuração global environments
, nela existe uma array de ambientes que dão suporte à todas as janelas.
Durante o processo de criação de url, o ruculs-js cria a URL principa padrão na seguinte forma http://localhost:5016
Path Controller
Normalmente temos janelas que fazem referência à um único caminho path, por exemplo, ao criar uma janela chamada Ordem de Servico
é provável que o path de serviço utilizado pela janela seja /OrdemServico
ou algo muito semelhante, o fato é que a janela terá os serviços que utiliza dentro de /OrdemServico
. Complementado, podemos utilizar a propriedade button.URL.params
para complementar a URL, como em casos GET.
Para esse caso a url seria criada utilizando a URL de domínio do ambiente atual, tendo o apoio do exemplo acima, teriamos uma url completa na seguinte forma: http://localhost:5016/OrdemServico
Path Relativo no Contexto de Mesmo Ambiente
O path relativo de mesmo ambiente traz maior flexibilidade ao se fazer referencias a outros path's que estão presentes no mesmo ambiente.
Isso ocorre porque se informado em button.URL.relative
, pathController
será ignorado, o que garante ao desenvolvedor criar variações de URL's ao ambiente atual.
O Path Relativo tem o mesmo peso do pathController
, entretanto, substitui o pathController
.
Path Absoluto ou nova URL
Nesse modalidade de criação, toda configuração criada é ignorada e uma nova URL é criada. Para isso utilize a propriedade button.URL.absolute
.
O objetivo aqui é criar URL's que façam por exemplo referência a aplicações terceiras.
Os Parametros de URL
Existem casos em que as URL's devem ser criadas com parametros, para esses casos o rucula-js lê as propriedade presente em button.URL
e resolve a URL.
Com a url quase pronta http://localhost:5016/OrdemServico
, podemos passar os parametros em duas formas:
A Sintaxe dos Parametros
Para que a devida substituição entre propriedade do objeto seja feita, utilizamos duas sintaxes
parametro={aliasFrame.namePropert}
. Caso tenha mais de um parametro, teriamos algo comoparametro={aliasFrame.namePropert}¶metro={aliasFrame2.namePropert2}
nome=reginaldo
/{aliasFrame.namePropert}
./Cliente/234
Nota: A sintaxe de objeto propriedade {{objeto.propriedade}}, pode ser substituida por constantes, exemplo: ?id=12345
ou /12345
Após a construção completa da url, teriamos http://localhost:5016/OrdemServico?id=12345
, http://localhost:5016/OrdemServico/12345
ou outra URL absoluta.
Itens Relacionados
⭐ Visite o projeto rucula-js ⭐
Contribuidores
Contribuidores |
---|