Cette fonction retourne une chaîne alphanumérique représentant une URI.
Les informations décrivant l'URI sont stockées dans un objet Hash, avec les attributs suivants :
- "scheme" : chaîne alphanumérique représentant le nom du schéma de l'URI. Cet attribut est optionnel : s'il n'est pas présent, "https" est pris comme schéma,
- "host" : chaîne alphanumérique représentant le domaine (le nom d'hôte ou l'adresse IP). Cet attribut est obligatoire,
- "path" : chaîne alphanumérique représentant le chemin (séquence de segments - similaires à des répertoires - et séparés par des slash (/)). Cet attribut est obligatoire,
- "port" : Numéro de port de l'URI. Cet attribut est optionnel,
- "queryparams" : Objet Hash représentant les paramètres de l'URI. Un attribut représente le nom du paramètre et sa valeur représente la valeur du paramètre.
Il est possible de passer à cette fonction plusieurs objets Hash en paramètre.
Dans ce cas, ces objets sont fusionnés pour produire un seul objet Hash de description d'URI.
Cet objet contiendra des couples attributs/valeurs qui proviennent d'un objet Hash passé en paramètre.
Dans le cas ou plusieurs objets Hash contiennent le même attribut, la valeur choisi est celle du premier objet Hash passé en paramètre et possédant cet attribut.
Paramètres
Hash |
uriDescription |
Objet Hash contenant une partie ou la totalité d'une description d'une URI |
Obligatoire |
Hash |
uriPart... |
Un ou plusieurs objets Hash contenant chacun une partie de la description de l'URI |
Optionnel |
Par exemple
<#assign imageWidth = 200, imageHeight = 300 />
<#assign uriFirstPart = {"scheme": "https",
"host": "picsum.photos"} />
<#assign uriSecondPart = {"path": imageWidth + "/" + imageHeight,
"queryparams": {"gravity": "east"}} />
<#-- Display image from URI https://picsum.photos/200/300/?gravity=east -->
<fo:external-graphic src="${ hardisCore.uriBuilder(uriFirstPart, uriSecondPart)?esc}" />