ref
Vytváří odkaz na soubor (tedy například obrázek).
Stringref
(
( Asset | BlobData | ImageInstance ) blobsrc [,
Boolean stable [,
String blobname ] ])
- blobsrc
- Zdroj blobu. Buď přímo blob, nebo asset, který blob obsahuje, nebo data obrázku.
- stable
- Příznak, zda se má generovat stabilní URL, tzn. URL, které se nemění s novými verzemi blobu.
- blobname
- Název blobu; smysl má, pokud je blobsrc asset. Defaultní hodnota je "data".
Verze systému jNetPublish
Možnost zadat jako argument přímo blob nebo obrázek byla přidána ve verzi 3.3.
Přebírání blobu z assetu
Pokud je blobsrc asset typu obrázek, soubor nebo datový zdroj ze souboru, není třeba použít parametr blobname, protože tyto assety obsahují právě jeden blob se jménem "data".
Název odkazovaného blobu se použije v případě generování odkazů na data nestandardních assetů.
Stabilní URL
Stabilní URL garantuje, že odkaz na blob se nebude měnit v čase (nebude reflektovat verzi blobu). Jde o paralelu podtypu identifikace stránky AK_STABLE
.
Nevýhodou stabilního URL je nutnost použití servletu, které může být pomalejší než druhá alternativa. Tou je nestabilní odkaz, při kterém se může poskytnout přímo statický soubor z disku.
Obvykle platí, že odkazy na obrázky a jiné komponenty stránky by měly být nestabilní (kvůli rychlosti a zátěži serveru), a odkazy na ostatní data jako PDF, Word apod., kde hrozí, že jejich URL si budou uživatelé ukládat do bookmarků, či budou zasílány emailem, by měly být generovány jako stabilní.
Absolutní URL
Funkce respektuje volbu forceAbsoluteAddresses
příkazu options.