org.zkoss.zk.ui.metainfo.DefinitionLoaders Maven / Gradle / Ivy
/* DefinitionLoaders.java
Purpose:
Description:
History:
Mon Aug 29 21:57:08 2005, Created by tomyeh
Copyright (C) 2005 Potix Corporation. All Rights Reserved.
{{IS_RIGHT
This program is distributed under LGPL Version 2.1 in the hope that
it will be useful, but WITHOUT ANY WARRANTY.
}}IS_RIGHT
*/
package org.zkoss.zk.ui.metainfo;
import java.util.Iterator;
import java.util.List;
import java.util.LinkedList;
import java.util.Set;
import java.util.HashSet;
import java.util.Map;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Enumeration;
import java.net.URL;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.zkoss.lang.Library;
import org.zkoss.lang.Classes;
import org.zkoss.lang.Strings;
import org.zkoss.util.resource.Locator;
import org.zkoss.util.resource.XMLResourcesLocator;
import org.zkoss.idom.Document;
import org.zkoss.idom.Item;
import org.zkoss.idom.Element;
import org.zkoss.idom.Attribute;
import org.zkoss.idom.ProcessingInstruction;
import org.zkoss.idom.input.SAXBuilder;
import org.zkoss.idom.util.IDOMs;
import org.zkoss.xel.taglib.Taglib;
import org.zkoss.html.JavaScript;
import org.zkoss.html.StyleSheet;
import org.zkoss.zk.ui.Component;
import org.zkoss.zk.ui.UiException;
import org.zkoss.zk.ui.metainfo.impl.*;
import org.zkoss.zk.ui.ext.Macro;
import org.zkoss.zk.ui.ext.Native;
import org.zkoss.zk.ui.sys.ConfigParser;
import org.zkoss.zk.ui.sys.PageRenderer;
import org.zkoss.zk.ui.impl.Utils;
import org.zkoss.zk.device.Devices;
import org.zkoss.zk.device.Device;
/**
* Utilities to load language definitions.
*
* @author tomyeh
*/
public class DefinitionLoaders {
private static final Logger log = LoggerFactory.getLogger(DefinitionLoaders.class);
/** List */
private static volatile List _addons;
private static volatile List _langs;
/** A map of (String ext, String lang). */
private static volatile Map _exts;
private static volatile boolean _loaded, _loading;
//CONSIDER:
//Store language definitions per WebApp, since different app may add its
//own definitions thru WEB-INF's lang-addon, or a JAR in WEB-INF/lib.
//
//CONSEQUENCE:
//Other Web app is affected by another in the current implementation
//
//WORKAROUND:
//Copy ZK libraries into WEB-INF/lib
//
//DIFFICULTY TO SUPPORT
//To support it we have to pass WebApp around. It is a challenge for
//1) a working thread (other than servlet/event thread);
//2) deserialize LanguageDefinition (and maybe ComponentDefinition)
/** Adds a language addon.
* It is usually used when an application want to load additional addons.
* For example, if you want to load an addon only if
* the professional edition is ready, you can register a
* {@link org.zkoss.zk.ui.util.WebAppInit} listener.
*/
public static void addAddon(Locator locator, URL url) {
if (locator == null || url == null)
throw new IllegalArgumentException("null");
if (_loaded) {
loadLang(locator, url, true); //addon
} else {
if (_addons == null)
_addons = new LinkedList();
_addons.add(new Object[] {locator, url});
}
}
/** Adds a language.
* It is usually used when application want to load additional language.
* @since 5.0.7
*/
public static void addLanguage(Locator locator, URL url) {
if (locator == null || url == null)
throw new IllegalArgumentException("null");
if (_loaded) {
loadLang(locator, url, false);
} else {
if (_langs == null)
_langs = new LinkedList();
_langs.add(new Object[] {locator, url});
}
}
/** Associates an extension to a language.
*
* @param lang the language name. It cannot be null.
* @param ext the extension, e.g., "svg". It cannot be null.
* @since 3.0.0
*/
public static final void addExtension(String ext, String lang) {
if (_loaded) {
LanguageDefinition.addExtension(ext, lang);
} else {
if (lang == null || ext == null)
throw new IllegalArgumentException("null");
if (_exts == null)
_exts = new HashMap();
_exts.put(ext, lang);
}
}
/** Loads all config.xml, lang.xml and lang-addon.xml found in
* the /metainfo/zk path.
*
* Remember to call {@link #addAddon}, if necessary, before
* calling this method.
*/
/*package*/ static void load() throws java.io.IOException {
if (!_loaded) {
synchronized (DefinitionLoaders.class) {
if (!_loaded && !_loading) {
try {
_loading = true; //prevent re-entry for the same thread
load0();
} finally {
_loaded = true; //only once
_loading = false;
}
}
}
}
}
private static void load0() throws java.io.IOException {
final XMLResourcesLocator locator = Utils.getXMLResourcesLocator();
//1. parse config.xml
final ConfigParser parser = new ConfigParser();
parser.parseConfigXml(null); //only system default configs
//2. process lang.xml (no particular dependency)
for (Enumeration en = locator.getResources("metainfo/zk/lang.xml");
en.hasMoreElements();) {
final URL url = (URL)en.nextElement();
if (log.isDebugEnabled()) log.debug("Loading "+url);
try {
final Document doc = new SAXBuilder(true, false, true).build(url);
if (ConfigParser.checkVersion(url, doc, true))
parseLang(doc, locator, url, false);
} catch (Exception ex) {
log.error("Failed to load "+url, ex);
throw UiException.Aide.wrap(ex, "Failed to load "+url);
//abort since it is hardly to work then
}
}
//5. process other language (from addLanguage)
if (_langs != null) {
for (Iterator it = _langs.iterator(); it.hasNext();) {
final Object[] p = it.next();
loadLang((Locator)p[0], (URL)p[1], false);
}
_langs = null; //free memory
}
//4. process lang-addon.xml (with dependency)
final List xmls = locator.getDependentXMLResources(
"metainfo/zk/lang-addon.xml", "addon-name", "depends");
for (XMLResourcesLocator.Resource res: xmls) {
try {
if (ConfigParser.checkVersion(res.url, res.document, true))
parseLang(res.document, locator, res.url, true);
} catch (Exception ex) {
log.error("Failed to load "+res.url, ex);
//keep running
}
}
//5. process other addon (from addAddon)
if (_addons != null) {
for (Iterator it = _addons.iterator(); it.hasNext();) {
final Object[] p = it.next();
loadLang((Locator)p[0], (URL)p[1], true); //addon
}
_addons = null; //free memory
}
//6. process the extension
if (_exts != null) {
for (Map.Entry me: _exts.entrySet()) {
final String ext = me.getKey();
final String lang = me.getValue();
try {
LanguageDefinition.addExtension(ext, lang);
} catch (DefinitionNotFoundException ex) {
log.warn("Extension "+ext+" ignored since language "+lang+" not found");
}
}
_exts = null;
}
}
/** Loads a language.
*/
private static void loadLang(Locator locator, URL url, boolean addon) {
try {
parseLang(
new SAXBuilder(true, false, true).build(url), locator, url, addon);
} catch (Exception ex) {
log.error("Failed to load "+(addon?"addon":"language")+": "+url, ex);
//keep running
}
}
private static
void parseLang(Document doc, Locator locator, URL url, boolean addon)
throws Exception {
final Element root = doc.getRootElement();
final String lang = IDOMs.getRequiredElementValue(root, "language-name");
final LanguageDefinition langdef;
final Device device;
if (addon) {
if (log.isDebugEnabled()) log.debug("Addon language to "+lang+" from "+root.getElementValue("addon-name", true));
langdef = LanguageDefinition.lookup(lang);
device = Devices.getDevice(langdef.getDeviceType());
if (root.getElement("case-insensitive") != null)
throw new UiException(message("case-insensitive not allowed in addon", root));
} else {
final String ns =
IDOMs.getRequiredElementValue(root, "namespace");
final String deviceType =
IDOMs.getRequiredElementValue(root, "device-type");
//if (log.isDebugEnabled()) log.debug("Load language: "+lang+", "+ns);
PageRenderer pageRenderer = (PageRenderer)
locateClass(IDOMs.getRequiredElementValue(root, "renderer-class"), PageRenderer.class)
.newInstance();
final List exts = parseExtensions(root);
if (exts.isEmpty())
throw new UiException(message("The extension must be specified for "+lang, root));
String ignoreCase = root.getElementValue("case-insensitive", true);
String bNative = root.getElementValue("native-namespace", true);
langdef = new LanguageDefinition(
deviceType, lang, ns, exts, pageRenderer,
"true".equals(ignoreCase), "true".equals(bNative), locator);
device = Devices.getDevice(deviceType);
}
parsePI(langdef, doc);
parseLabelTemplate(langdef, root);
parseDynamicTag(langdef, root);
parseMacroTemplate(langdef, root);
parseNativeTemplate(langdef, root);
for (Element el : root.getElements("message-loader-class")) {
final String clsname = el.getText().trim();
if (Strings.isEmpty(clsname))
throw new UiException("Empty class name of message loader for " + lang);
MessageLoader msgLoader = (MessageLoader) locateClass(clsname).newInstance();
langdef.addMessageLoader(msgLoader);
}
for (Element el: root.getElements("library-property")) {
final String nm = IDOMs.getRequiredElementValue(el, "name");
final String val = IDOMs.getRequiredElementValue(el, "value");
Library.setProperty(nm, val);
}
for (Iterator it = root.getElements("system-property").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
final String nm = IDOMs.getRequiredElementValue(el, "name");
final String val = IDOMs.getRequiredElementValue(el, "value");
System.setProperty(nm, val);
}
for (Iterator it = root.getElements("javascript").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
String src = el.getAttributeValue("src"),
pkg = el.getAttributeValue("package");
String mergeTo = el.getAttributeValue("merge");
final boolean merge = mergeTo != null && !"false".equals(mergeTo);
if (merge && "true".equals(mergeTo)) mergeTo = "zk";
final boolean ondemand = "true".equals(el.getAttributeValue("ondemand"));
//ondemand means to cancel the previous definition (merge or not)
if (pkg != null) {
if (src != null)
log.warn("The src attribute ignored because package is specified, "+el.getLocator());
if (!ondemand && !merge) {
src = "~." + device.packageToPath(pkg);
pkg = null;
}
}
final String ctn = el.getText(true);
final JavaScript js;
if (pkg != null && pkg.length() > 0) {
if (ondemand) { //ondemand has the higher priority than merge
langdef.removeJavaScript("~." + device.packageToPath(pkg));
langdef.unmergeJavaScriptPackage(pkg, mergeTo);
} else { //merge must be true
langdef.mergeJavaScriptPackage(pkg, mergeTo);
}
continue; //TODO
} else if (src != null && src.length() > 0) {
if (ctn != null && ctn.length() > 0)
throw new UiException(message("You cannot specify the content if the src attribute is specified", el));
final String charset = el.getAttributeValue("charset");
js = new JavaScript(src, charset);
} else if (ctn != null && ctn.length() > 0) {
js = new JavaScript(ctn);
} else {
log.warn("Ignored: none of the src or package attribute, or the content specified, "+el.getLocator());
continue;
}
langdef.addJavaScript(js);
}
for (Iterator it = root.getElements("javascript-module").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
langdef.addJavaScriptModule(
IDOMs.getRequiredAttributeValue(el, "name"),
IDOMs.getRequiredAttributeValue(el, "version"));
}
for (Iterator it = root.getElements("stylesheet").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
final String href = el.getAttributeValue("href");
final String ctn = el.getText(true);
final StyleSheet ss;
if (href != null && href.length() > 0) {
if (ctn != null && ctn.length() > 0)
throw new UiException(message("You cannot specify the content if the href attribute is specified", el));
ss = new StyleSheet(href, el.getAttributeValue("type"), el.getAttributeValue("media"), false);
} else if (ctn != null && ctn.length() > 0) {
ss = new StyleSheet(ctn, el.getAttributeValue("type"), el.getAttributeValue("media"), true);
} else {
throw new UiException(message("You must specify either the href attribute or the content", el));
}
langdef.addStyleSheet(ss);
}
for (Iterator it = root.getElements("zscript").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
final String zslang;
final Attribute attr = el.getAttributeItem("language");
if (attr == null) {
zslang = "Java";
} else {
zslang = attr.getValue();
if (zslang == null || zslang.length() == 0)
throw new UiException(message("The language attribute cannot be empty", attr));
}
final String s = el.getText(true);
final String eachTime = el.getAttributeValue("each-time");
if ("true".equals(eachTime))
langdef.addEachTimeScript(zslang, s);
else
langdef.addInitScript(zslang, s);
}
for (Iterator it = root.getElements("component").iterator();
it.hasNext();) {
final Element el = (Element)it.next();
final String name =
IDOMs.getRequiredElementValue(el, "component-name");
String clsnm = el.getElementValue("component-class", true);
Class cls = null;
if (clsnm != null) {
if (clsnm.length() > 0) {
noEL("component-class", clsnm, el);
try {
cls = locateClass(clsnm, Component.class);
} catch (Throwable ex) { //Feature 1873426
log.warn("Component "+name+" ignored. Reason: unable to load "+clsnm+" due to "
+ex.getClass().getName()+": "+ex.getMessage()
+(ex instanceof NoClassDefFoundError?"":"\n"+el.getLocator()));
log.debug("", ex);
//keep processing (Feature 2060367)
}
} else {
clsnm = null;
}
}
final String macroURI = el.getElementValue("macro-uri", true);
final ComponentDefinitionImpl compdef;
boolean extend = false;
if (macroURI != null && macroURI.length() != 0) {
if (log.isTraceEnabled()) log.trace("macro component definition: "+name);
final String inline = el.getElementValue("inline", true);
compdef = (ComponentDefinitionImpl)
langdef.getMacroDefinition(
name, macroURI, "true".equals(inline), null);
if (cls != null)
compdef.setImplementationClass(cls);
else if (clsnm != null)
compdef.setImplementationClass(clsnm);
compdef.setDeclarationURL(url);
langdef.addComponentDefinition(compdef);
} else if (el.getElement("extends") != null) { //extends
extend = true;
final String extnm = el.getElementValue("extends", true);
if (log.isTraceEnabled()) log.trace("Extends component definition, "+name+", from "+extnm);
final ComponentDefinition ref = langdef.getComponentDefinitionIfAny(extnm);
if (ref == null) {
log.warn("Component "+name+" ignored. Reason: extends a non-existent component "+extnm+".\n"+el.getLocator());
//not throw exception since the derived component might be
//ignored due to class-not-found
continue;
}
if (ref.isMacro())
throw new UiException(message("Unable to extend from a macro component", el));
if (extnm.equals(name)) {
compdef = (ComponentDefinitionImpl)ref;
} else {
compdef = (ComponentDefinitionImpl)
ref.clone(ref.getLanguageDefinition(), name);
compdef.setDeclarationURL(url);
}
if (cls != null)
compdef.setImplementationClass(cls);
else if (clsnm != null)
compdef.setImplementationClass(clsnm);
langdef.addComponentDefinition(compdef);
//Note: setImplementationClass before addComponentDefinition
} else {
if (log.isTraceEnabled()) log.trace("Add component definition: name="+name);
if (cls == null && clsnm == null)
throw new UiException(message("component-class is required", el));
compdef = cls != null ?
new ComponentDefinitionImpl(langdef, null, name, cls):
new ComponentDefinitionImpl(langdef, null, name, clsnm);
compdef.setDeclarationURL(url);
langdef.addComponentDefinition(compdef);
}
parseTextAs(compdef, el.getElement("text-as"));
String s = el.getElementValue("preserve-blank", true);
compdef.setBlankPreserved((s != null && !"false".equals(s)));
String wgtnm = el.getElementValue("widget-class", true);
WidgetDefinition wgtdef = null;
if (wgtnm == null && extend)
wgtnm = compdef.getDefaultWidgetClass(null);
if (wgtnm != null) {
if (!withEL(wgtnm))
wgtdef = getWidgetDefinition(langdef, compdef, wgtnm);
compdef.setDefaultWidgetClass(wgtnm);
}
s = el.getElementValue("component-apply", true);
if (s == null) s = el.getElementValue("apply", true); //backward-compatible
compdef.setApply(s);
for (Iterator i = el.getElements("mold").iterator(); i.hasNext();) {
final Element e = (Element)i.next();
final String nm = IDOMs.getRequiredElementValue(e, "mold-name");
final String moldURI = e.getElementValue("mold-uri", true);
String cssURI = e.getElementValue("css-uri", true);
final String wn = e.getElementValue("widget-class", true);
noEL("mold-uri", moldURI, e); //5.0 limitation
noEL("css-uri", cssURI, e);
compdef.addMold(nm, wn != null ? wn: wgtnm);
WidgetDefinition wd = wn == null ? wgtdef:
withEL(wn) ? null: getWidgetDefinition(langdef, compdef, wn);
if (moldURI != null) {
if (wd != null)
wd.addMold(nm, moldURI);
else
log.error("Mold "+nm+" for "+name+" ignored because "+
((wn != null && withEL(wn)) || (wgtnm != null && withEL(wgtnm)) ?
"widget-class contains EL expressions":"widget-class is required")
+", "+e.getLocator());
}
if (cssURI != null && cssURI.length() > 0) {
final char cc = cssURI.charAt(0);
if (cc != '/' && cc != '~') {
String n = wn != null ? wn: wgtnm;
if (!withEL(n)) {
int k = n.lastIndexOf('.');
cssURI = "~." + device.toAbsolutePath(
n.substring(0, k).replace('.', '/') + '/' + cssURI);
} else {
log.error("Absolute path required for cssURI, since the widget class contains EL expressions, "+e.getLocator());
}
}
langdef.addCSSURI(cssURI);
}
}
for (Iterator e = parseCustAttrs(el).entrySet().iterator(); e.hasNext();) {
final Map.Entry me = (Map.Entry)e.next();
compdef.addCustomAttribute((String)me.getKey(), (String)me.getValue());
}
for (Iterator e = parseProps(el).entrySet().iterator(); e.hasNext();) {
final Map.Entry me = (Map.Entry)e.next();
compdef.addProperty((String)me.getKey(), (String)me.getValue());
}
parseAnnots(compdef, el);
}
}
private static void parseTextAs(ComponentDefinitionImpl compdef, Element el) {
if (el != null) {
final String s = el.getText(true);
noEmpty("text-as", s, el);
noEL("text-as", s, el);
if (!"false".equals(s)) {
compdef.setTextAs(s);
if ("true".equals(el.getAttributeValue("childable")))
compdef.setChildAllowedInTextAs(true);
} else { // reset
compdef.setTextAs(null);
compdef.setChildAllowedInTextAs(false);
}
}
}
private static String message(String message, org.zkoss.idom.Item el) {
return org.zkoss.xml.Locators.format(message, el != null ? el.getLocator(): null);
}
private static org.zkoss.util.resource.Location location(org.zkoss.idom.Item el) {
return org.zkoss.xml.Locators.toLocation(el != null ? el.getLocator(): null);
}
private static WidgetDefinition getWidgetDefinition(
LanguageDefinition langdef, ComponentDefinition compdef, String wgtnm) {
WidgetDefinition wgtdef = langdef.getWidgetDefinitionIfAny(wgtnm);
if (wgtdef != null)
return wgtdef;
wgtdef = new WidgetDefinitionImpl(wgtnm, compdef.isBlankPreserved());
langdef.addWidgetDefinition(wgtdef);
return wgtdef;
}
@SuppressWarnings("unchecked")
private static Class locateClass(String clsnm, Class... clses)
throws Exception {
final Class c = Classes.forNameByThread(clsnm);
if (clses != null)
for (Class cls: clses)
if (!cls.isAssignableFrom(c))
throw new UiException(c + " must implement "+cls);
return (Class)c;
}
private static void noEmpty(String nm, String val, Item item)
throws UiException {
if (val != null && val.length() == 0)
throw new UiException(message(nm+" cannot be empty", item));
}
private static void noEL(String nm, String val, Item item)
throws UiException {
if (withEL(val))
throw new UiException(message(nm+" does not support EL expressions", item));
}
private static boolean withEL(String val) {
return val != null && val.indexOf("${") >= 0;
}
/** Parse the processing instructions. */
private static void parsePI(LanguageDefinition langdef, Document doc)
throws Exception {
for (Iterator it = doc.getChildren().iterator(); it.hasNext();) {
final Object o = it.next();
if (!(o instanceof ProcessingInstruction))
continue;
final ProcessingInstruction pi = (ProcessingInstruction)o;
final String target = pi.getTarget();
final Map params = pi.parseData();
if ("taglib".equals(target)) {
final String uri = params.remove("uri");
final String prefix = params.remove("prefix");
if (!params.isEmpty())
log.warn("Ignored unknown attribute: "+params+", "+pi.getLocator());
if (uri == null || prefix == null)
throw new UiException(message("Both uri and prefix attribute are required", pi));
if (log.isDebugEnabled()) log.debug("taglib: prefix="+prefix+" uri="+uri);
langdef.addTaglib(new Taglib(prefix, uri));
} else {
log.warn("Unknown processing instruction: "+target);
}
}
}
/** Parse the component used to represent a label.
*/
private static
void parseLabelTemplate(LanguageDefinition langdef, Element el) {
el = el.getElement("label-template");
if (el != null) {
final Element raw = el.getElement("raw");
langdef.setLabelTemplate(
IDOMs.getRequiredElementValue(el, "component-name"),
IDOMs.getRequiredElementValue(el, "component-attribute"),
raw != null && !"false".equals(raw.getText(true)));
}
}
private static
void parseMacroTemplate(LanguageDefinition langdef, Element el)
throws Exception {
el = el.getElement("macro-template");
if (el != null) {
final Class cls =
locateClass(IDOMs.getRequiredElementValue(el, "macro-class"),
Component.class, Macro.class);
langdef.setMacroTemplate(cls);
}
}
private static
void parseNativeTemplate(LanguageDefinition langdef, Element el)
throws Exception {
el = el.getElement("native-template");
if (el != null) {
final Class cls =
locateClass(IDOMs.getRequiredElementValue(el, "native-class"),
Component.class, Native.class);
langdef.setNativeTemplate(cls);
}
}
private static
void parseDynamicTag(LanguageDefinition langdef, Element el)
throws ClassNotFoundException {
el = el.getElement("dynamic-tag");
if (el != null) {
final String compnm =
IDOMs.getRequiredElementValue(el, "component-name");
final Set reservedAttrs = new HashSet(8);
for (Element e: el.getElements("reserved-attribute"))
reservedAttrs.add(e.getText(true));
langdef.setDynamicTagInfo(compnm, reservedAttrs);
}
//if (log.finerable()) log.finer(el);
}
private static List parseExtensions(Element elm) {
final List exts = new LinkedList();
for (Element el: elm.getElements("extension")) {
final String ext = el.getText(true);
if (ext.length() != 0) {
for (int j = 0, len = ext.length(); j < len; ++j) {
final char cc = ext.charAt(j);
if ((cc < 'a' || cc > 'z') && (cc < 'A' || cc > 'Z')
&& (cc < '0' || cc > '9'))
throw new UiException(message("Invalid extension; only letters and numbers are allowed: "+ext, elm));
}
exts.add(ext);
}
}
///if (log.finerable()) log.finer(exts);
return exts;
}
private static Map parseProps(Element elm) {
return IDOMs.parseParams(elm, "property", "property-name", "property-value");
}
private static Map parseCustAttrs(Element elm) {
return IDOMs.parseParams(elm, "custom-attribute", "attribute-name", "attribute-value");
}
private static Map parseAttrs(Element elm) {
return IDOMs.parseParams(elm, "attribute", "attribute-name", "attribute-value");
}
private static void parseAnnots(ComponentDefinitionImpl compdef, Element top) {
for (Element el: top.getElements("annotation")) {
final String annotName = IDOMs.getRequiredElementValue(el, "annotation-name");
final Map annotAttrs = new LinkedHashMap();
for (Map.Entry me: parseAttrs(el).entrySet())
annotAttrs.put(me.getKey(),
AnnotationHelper.parseAttributeValue(me.getValue().trim(),
location(el))); //not accurate but acceptable
compdef.addAnnotation(
el.getElementValue("property-name", true), annotName,
annotAttrs, location(el));
}
}
/** Configures an integer. */
private static Integer parseInteger(Element el, String subnm,
boolean positiveOnly) throws UiException {
//Warning instead of exception since config.xml is embedded in jar, so
//better not to stop the process
String val = el.getElementValue(subnm, true);
if (val != null && val.length() > 0) {
try {
final int v = Integer.parseInt(val);
if (!positiveOnly || v > 0)
return new Integer(v);
log.warn("Ignored: the "+subnm+" element must be a positive number, not "+val+", at "+el.getLocator());
} catch (NumberFormatException ex) { //eat
log.warn("Ignored: the "+subnm+" element must be a number, not "+val+", at "+el.getLocator());
}
}
return null;
}
}