nsp-jstl-taglib

NSP taglib for JSTL Jakarta Standard Tag Library

• JSTL core library - e.g. <c:if test="${test}"></c:if>
• JSTL formatting library - e.g. <fmt:formatDate value="${date}" pattern="yyyy-MM-dd"/>
• JSTL functions library - e.g. ${ fn:toUpperCase("abc") }
• See TypeScript declaration files for API detail.

SYNOPSIS

import {createNSP} from "nsp-server-pages";
import {cTags, fmtTags, fnFunctions} from "nsp-jstl-taglib";

const nsp = createNSP();

nsp.addTagLib({ns: "c", tag: cTags});
nsp.addTagLib({ns: "fmt", tag: fmtTags});
nsp.addTagLib({ns: "fn", fn: fnFunctions});

const context = {title: "nsp", upper: true};

const render = await nsp.loadJSP("path/to/template.jsp");

const html = await render(context);

console.log(html);
// => <h1>NSP</h1>

<c:if test="${upper}">
  <h1>
    <c:out value="${fn:toUpperCase(title)}" default="Untitled"/>
  </h1>
</c:if>

COMMONJS

• Both ES Modules and CommonJS supported.

const {createNSP} = require("nsp-server-pages");
const {cTags, fmtTags, fnFunctions} = require("nsp-jstl-taglib");

COMPATIBILITY

JSTL core library

tag	status	note
<c:choose>	👍 OK
<c:if>	👍 OK
<c:import>	👍 OK
<c:forEach>	👍 OK
<c:forTokens>	👍 OK
<c:out>	👍 OK
<c:otherwise>	👍 OK
<c:param>	👍 OK
<c:redirect>	🚫 N/A	not available by design
<c:remove>	👍 OK
<c:set>	👍 OK
<c:url>	👍 OK
<c:when>	👍 OK

scope="xxx" attribute is just ignored as nsp supports only request scope.

JSTL formatting library

tag	status	note
<fmt:requestEncoding>	👍 OK
<fmt:setLocale>	👍 OK
<fmt:timeZone>	👍 OK
<fmt:setTimeZone>	👍 OK
<fmt:bundle>	👍 OK	implement ResourceBundle.getBundle hook
<fmt:setBundle>	👍 OK	implement ResourceBundle.getBundle hook
<fmt:message>	👍 OK
<fmt:param>	👍 OK
<fmt:formatNumber>	👍 OK	works mostly. some feature still missing
<fmt:parseNumber>	👍 OK
<fmt:formatDate>	👍 OK	works mostly. some feature still missing
<fmt:parseDate>	🕑 Not yet

Implement ResourceBundle.getBundle hook which returns an array of key-value pair properties. The hook is called by <fmt:bundle> and <fmt:setBundle> tags.

const nsp = createNSP();

nsp.hook("ResourceBundle.getBundle", async (basename) => {
    const properties = {"key": "value"};
    return [properties];
});

JSTL functions library

function	status	equivalant method
${ fn:contains() }	👍 OK	String#includes
${ fn:containsIgnoreCase() }	👍 OK
${ fn:endsWith() }	👍 OK	String#endsWith
${ fn:escapeXml() }	👍 OK
${ fn:indexOf() }	👍 OK	String#indexOf
${ fn:join() }	👍 OK	Array#join
${ fn:length() }	👍 OK
${ fn:replace() }	👍 OK	String#replace
${ fn:split() }	👍 OK	String#split
${ fn:startsWith() }	👍 OK	String#startsWith
${ fn:substring() }	👍 OK	String#substring
${ fn:substringAfter() }	👍 OK
${ fn:substringBefore() }	👍 OK
${ fn:toLowerCase() }	👍 OK	String#toLowerCase
${ fn:toUpperCase() }	👍 OK	String#toUpperCase
${ fn:trim() }	👍 OK	String#trim

LINKS

• https://github.com/kawanet/nsp-server-pages
• https://github.com/kawanet/nsp-jstl-taglib
• https://github.com/kawanet/nsp-struts1-taglib
• https://github.com/kawanet/nsp-seasar2-taglib
• https://github.com/apache/tomcat-taglibs-standard/
• https://github.com/apache/tomcat-taglibs-standard/tree/main/impl/src/main/java/org/apache/taglibs/standard
• https://github.com/apache/tomcat-taglibs-standard/tree/main/impl/src/main/resources/META-INF

LICENSE

// SPDX-License-Identifier: Apache-2.0