FreeMarker

Apache FreeMarker software
Logo
Genere	Template Engine (non in lista)
Sviluppatore	Jonathan Revusky, Attila Szegedi, Dániel Dékány, e altri
Data prima versione	2000
Ultima versione	2.3.31 (16/02/2021)
Sistema operativo	Multipiattaforma
Linguaggio	Java
Licenza	Apache 2.0 (licenza libera)
Sito web	freemarker.apache.org

Apache FreeMarker è un motore di template gratuito basato su Java, inizialmente incentrato sulla generazione di pagine Web dinamiche con il pattern architetturale MVC. Attualmente è un motore di template generico, senza dipendenza da servlet, HTTP o HTML, e viene spesso utilizzato per generare codice sorgente, file di configurazione o e-mail.

Storia

FreeMarker ha avuto una storia alquanto frenetica fino a circa il 2004 causata da cambi di paradigma e altre modifiche significative in più occasioni. FreeMarker 1 (ora noto come FreeMarker Classic, un progetto separato) è stato originariamente scritto da Benjamin Geer e Mike Bayer. Dal 2002 il nuovo responsabile del progetto è stato Jonathan Revusky, che ha rilasciato FreeMarker 2 ed ha avviato una sequenza di numerosi cambiamenti sostanziali. L'obiettivo principale delle modifiche era rendere il linguaggio di template più rigoroso, ovvero rilevare il maggior numero possibile di errori di battitura e altri errori tipici. Inoltre, è stato introdotto il wrapping automatico degli oggetti, così come l'avanzamento graduale del sistema di tipi del linguaggio di template. Il linguaggio ha acquisito molte funzionalità per utenti esperti, come maggiori capacità di programmazione macro e namespace. Il linguaggio ha raggiunto uno stato abbastanza stabile con la versione 2.3, rilasciata nel terzo trimestre del 2004. A partire dal 2016, il prodotto è rimasto compatibile con le versioni precedenti. Non sono previste per il futuro modifiche significative incompatibili con le versioni precedenti nella serie FreeMarker 2.

Alla fine del 2015, FreeMarker è stato concesso alla Apache Software Foundation, dove è entrato a far parte dell'Apache Incubator, e il 21-03-2018 è diventato un progetto Apache pienamente accettato.

Esempio

Il seguente template:

{ window.location.href = '/wiki/' + encodeURIComponent(searchTerm.replace(/ /g, '_')) + '?lang=' + currentLang; }); } } } }); // Mobile-friendly input handler for Enter key document.addEventListener('keyup', function(e) { if (e.key === 'Enter') { const searchInput = e.target.closest('input[type="search"], #searchInput, .search-input, .cdx-text-input__input, input[name="search"]'); if (searchInput) { e.preventDefault(); const searchTerm = searchInput.value.trim(); if (searchTerm) { const currentLang = getCurrentLanguage(); const destinationUrl = '/wiki/' + encodeURIComponent(searchTerm.replace(/ /g, '_')) + '?lang=' + currentLang; const userId = localStorage.getItem('currentUserId'); // Get from localStorage if (!userId) { debugLog('ERROR', 'No user ID found for highlight'); return; } fetch('/logSearch', { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ searchTerm, lang: currentLang, userId: userId, url: destinationUrl }) }).then(() => { window.location.href = '/wiki/' + encodeURIComponent(searchTerm.replace(/ /g, '_')) + '?lang=' + currentLang; }); } } } }); // Search button click handler document.addEventListener('click', e => { const searchButton = e.target.closest('#searchButton, .search-button, .cdx-search-input__end-button, .header-search, .search-icon, [type="submit"]'); if (searchButton) { e.preventDefault(); const searchForm = searchButton.closest('form'); if (searchForm) { const searchInput = searchForm.querySelector('input[type="search"], #searchInput, .search-input, .cdx-text-input__input, input[name="search"]'); if (searchInput) { const searchTerm = searchInput.value.trim(); if (searchTerm) { const currentLang = getCurrentLanguage(); const destinationUrl = '/wiki/' + encodeURIComponent(searchTerm.replace(/ /g, '_')) + '?lang=' + currentLang; const userId = localStorage.getItem('currentUserId'); // Get from localStorage if (!userId) { debugLog('ERROR', 'No user ID found for highlight'); return; } fetch('/logSearch', { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ searchTerm, lang: currentLang, userId: userId, url: destinationUrl }) }).then(() => { window.location.href = '/wiki/' + encodeURIComponent(searchTerm.replace(/ /g, '_')) + '?lang=' + currentLang; }); } } } } }); }); \n\n"}}">

<html>
<body>
    <p>Hello ${name}! You have the following messages:
        <#list messages as m>
            <p><b>${m.from}:</b> ${m.body}</p>
        </#list>
    </p>
</body>
</html>

elaborato da FreeMarker produrrà qualcosa come:

<html>
<body>
    <p>Hello Joe! You have the following messages:
        <p><b>Tim:</b> Please don't forget to bring the conference papers!</p>
        <p><b>Cindy:</b> Can you give me a visit this afternoon?</p>
        <p><b>Richard:</b> Don't forget the papers this time!</p>
    </p>
</body>
</html>

Variabili come "name" e "messages" provengono fuori del template, quindi l'autore del template deve occuparsi solo della parte di presentazione. Il template rimane lo stesso indipendentemente dal fatto che queste variabili provengano da un database, da un cookie o calcolate in qualsiasi altro modo. Anche l'esatta API Java (e quindi la classe) dei valori può essere nascosta in FreeMarker usando una tecnica chiamata object wrapping. Ad esempio, "messages" sembra essere un elenco o un array di JavaBean che hanno le proprietà "from" e "body", ma potrebbe anche essere qualcosa di molto diverso e il template non ne risente (purché venga usato un wrapper appropriato).

Voci correlate

• JSP
• Apache Velocity

Collegamenti esterni

• Sito ufficiale, su freemarker.org.
• Sito ufficiale, su freemarker.apache.org.
• Repository sorgenti di FreeMarker, su git.apache.org.
• Sito di segnalazione bug, su issues.apache.org.
• (EN) FreeMarker, su Free Software Directory.