Cette fonction convertit une URL (sous la forme de chaîne alphanumérique) en chaîne alphanumérique au format Data-URI (cliquez ici pour plus de détails).
La syntaxe de la chaîne alphanumérique retournée est :
data:<media type>;base64,<data>
avec :
- media type : le type MIME déduit de l'analyse du contenu de l'URL,
- data : la suite des nombres encodés en base 64.
La déduction automatique de type MIME se déclenche lorsque le paramètre mimeType n'est pas présent. Elle se fait par l'intermédiaire des API javax.ImageIO. Celles-ci supportent nativement les formats suivants :
- BMP : format Bitmap (type MIME image/bmp),
- WBMP : format Wireless Bitmap (type MIME image/vnd.wap.wbmp),
- PNG : format Portable Network Graphics (type MIME image/png),
- GIF : format Graphics interchange format (type MIME image/gif),
- JPEG : format Joint Photographic Experts Group (type MIME image/jpeg).
Pour spécifier un type MIME non reconnu, il faut renseigner le paramètre mimeType avec une chaîne alphanumérique représentant le type MIME. Cliquez ici pour plus de détails.
Quelques exemples d'URL possibles :
- HTTPS : https://picsum.photos/200/300/?gravity=east,
- FILE : file:///c:/tmp/logo.png,
- Relative FILE : file:./resources/logo.jpeg , file:./resources/logo.jpeg. Dans ce cas, le répertoire utilisé est le répertoire de lancement de l'application Java qui exécute l'APE (le user directory Java),
- JAR FILE : jar:file:///c:/tmp/apesamples-0.0.1-SNAPSHOT.jar!/Training/Hardis_XSL-FO/Resources/Images/xml_feather.gif.
Paramètres
String |
url |
URL pointant vers une donnée à convertir |
Obligatoire |
String |
mimeType |
Type mime de la donnée représentée par l'URL |
Optionnel |
Number |
timeout |
Valeur de délai d'attente maximum (en millisecondes) utilisée pour la connexion et la lecture des données de l'URL. Les valeurs possibles sont : < 0 : utilisation des valeurs par défaut Java, = 0 : pas de délai d'attente (attente infinie), > 0 : valeur fixée |
Optionnel. La valeur par défaut est "-1". |
Par exemple
<@hardisFo.foExternalGraphic src=hardisCore.urlToBase64DataURI("https://picsum.photos/200/300/?gravity=east") contentWidth="200px" contentWidth="300px"/>