/* Copyright (c) 2006-2007, Vladimir Nikic
All rights reserved.
Redistribution and use of this software in source and binary forms,
with or without modification, are permitted provided that the following
conditions are met:
* Redistributions of source code must retain the above
copyright notice, this list of conditions and the
following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other
materials provided with the distribution.
* The name of HtmlCleaner may not be used to endorse or promote
products derived from this software without specific prior
written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
You can contact Vladimir Nikic by sending e-mail to
nikic_vladimir@yahoo.com. Please include the word "HtmlCleaner" in the
subject line.
*/
package org.htmlcleaner;
import org.xml.sax.Attributes;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.DefaultHandler;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import java.io.*;
import java.util.HashMap;
import java.util.Map;
import java.net.URL;
/**
* Default tag provider - reads XML file in specified format and creates tag infos
*/
@SuppressWarnings({ "rawtypes", "serial", "unchecked" })
public class ConfigFileTagProvider extends HashMap implements ITagInfoProvider {
// obtaining instance of the SAX parser factory
static SAXParserFactory parserFactory = SAXParserFactory.newInstance();
static {
parserFactory.setValidating(false);
parserFactory.setNamespaceAware(false);
}
// tells whether to generate code of the tag provider class based on XML configuration file
// to the standard output
private boolean generateCode = false;
private ConfigFileTagProvider() {
}
public ConfigFileTagProvider(InputSource inputSource) {
try {
new ConfigParser(this).parse(inputSource);
} catch (Exception e) {
throw new HtmlCleanerException("Error parsing tag configuration file!", e);
}
}
public ConfigFileTagProvider(File file) {
try {
new ConfigParser(this).parse(new InputSource(new FileReader(file)));
} catch (Exception e) {
throw new HtmlCleanerException("Error parsing tag configuration file!", e);
}
}
public ConfigFileTagProvider(URL url) {
try {
Object content = url.getContent();
if (content instanceof InputStream) {
InputStreamReader reader = new InputStreamReader((InputStream)content);
new ConfigParser(this).parse(new InputSource(reader));
}
} catch (Exception e) {
throw new HtmlCleanerException("Error parsing tag configuration file!", e);
}
}
public TagInfo getTagInfo(String tagName) {
return (TagInfo) get(tagName);
}
/**
* Generates code for tag provider class from specified configuration XML file.
* In order to create custom tag info provider, make config file and call this main method
* with the specified file. Output will be generated on the standard output. This way default
* tag provider (class DefaultTagProvider) is generated from default.xml which which is packaged
* in the source distribution.
*
* @param args
* @throws IOException
* @throws SAXException
* @throws ParserConfigurationException
*/
public static void main(String[] args) throws IOException, SAXException, ParserConfigurationException {
final ConfigFileTagProvider provider = new ConfigFileTagProvider();
provider.generateCode = true;
File configFile = new File("default.xml");
String packagePath = "org.htmlcleaner";
String className = "DefaultTagProvider";
final ConfigParser parser = provider.new ConfigParser(provider);
System.out.println("package " + packagePath + ";");
System.out.println("import java.util.HashMap;");
System.out.println("public class " + className + " extends HashMap implements ITagInfoProvider {");
System.out.println("public " + className + "() {");
System.out.println("TagInfo tagInfo;");
parser.parse( new InputSource(new FileReader(configFile)) );
System.out.println("}");
System.out.println("}");
}
/**
* SAX parser for tag configuration files.
*/
private class ConfigParser extends DefaultHandler {
private TagInfo tagInfo = null;
private String dependencyName = null;
private Map tagInfoMap;
ConfigParser(Map tagInfoMap) {
this.tagInfoMap = tagInfoMap;
}
public void parse(InputSource in) throws ParserConfigurationException, SAXException, IOException {
SAXParser parser = parserFactory.newSAXParser();
parser.parse(in, this);
}
public void characters(char[] ch, int start, int length) throws SAXException {
if (tagInfo != null) {
String value = new String(ch, start, length).trim();
if ( "fatal-tags".equals(dependencyName) ) {
tagInfo.defineFatalTags(value);
if (generateCode) {
System.out.println("tagInfo.defineFatalTags(\"" + value + "\");");
}
} else if ( "req-enclosing-tags".equals(dependencyName) ) {
tagInfo.defineRequiredEnclosingTags(value);
if (generateCode) {
System.out.println("tagInfo.defineRequiredEnclosingTags(\"" + value + "\");");
}
} else if ( "forbidden-tags".equals(dependencyName) ) {
tagInfo.defineForbiddenTags(value);
if (generateCode) {
System.out.println("tagInfo.defineForbiddenTags(\"" + value + "\");");
}
} else if ( "allowed-children-tags".equals(dependencyName) ) {
tagInfo.defineAllowedChildrenTags(value);
if (generateCode) {
System.out.println("tagInfo.defineAllowedChildrenTags(\"" + value + "\");");
}
} else if ( "higher-level-tags".equals(dependencyName) ) {
tagInfo.defineHigherLevelTags(value);
if (generateCode) {
System.out.println("tagInfo.defineHigherLevelTags(\"" + value + "\");");
}
} else if ( "close-before-copy-inside-tags".equals(dependencyName) ) {
tagInfo.defineCloseBeforeCopyInsideTags(value);
if (generateCode) {
System.out.println("tagInfo.defineCloseBeforeCopyInsideTags(\"" + value + "\");");
}
} else if ( "close-inside-copy-after-tags".equals(dependencyName) ) {
tagInfo.defineCloseInsideCopyAfterTags(value);
if (generateCode) {
System.out.println("tagInfo.defineCloseInsideCopyAfterTags(\"" + value + "\");");
}
} else if ( "close-before-tags".equals(dependencyName) ) {
tagInfo.defineCloseBeforeTags(value);
if (generateCode) {
System.out.println("tagInfo.defineCloseBeforeTags(\"" + value + "\");");
}
}
}
}
public void startElement(String uri, String localName, String qName, Attributes attributes) throws SAXException {
if ( "tag".equals(qName) ) {
String name = attributes.getValue("name");
String content = attributes.getValue("content");
String section = attributes.getValue("section");
String deprecated = attributes.getValue("deprecated");
String unique = attributes.getValue("unique");
String ignorePermitted = attributes.getValue("ignore-permitted");
tagInfo = new TagInfo(name,
"all".equals(content) ? TagInfo.CONTENT_ALL : ("none".equals(content) ? TagInfo.CONTENT_NONE : TagInfo.CONTENT_TEXT),
"all".equals(section) ? TagInfo.HEAD_AND_BODY : ("head".equals(section) ? TagInfo.HEAD : TagInfo.BODY),
deprecated != null && "true".equals(deprecated),
unique != null && "true".equals(unique),
ignorePermitted != null && "true".equals(ignorePermitted) );
if (generateCode) {
String s = "tagInfo = new TagInfo(\"#1\", #2, #3, #4, #5, #6);";
s = s.replaceAll("#1", name);
s = s.replaceAll("#2", "all".equals(content) ? "TagInfo.CONTENT_ALL" : ("none".equals(content) ? "TagInfo.CONTENT_NONE" : " TagInfo.CONTENT_TEXT"));
s = s.replaceAll("#3", "all".equals(section) ? "TagInfo.HEAD_AND_BODY" : ("head".equals(section) ? "TagInfo.HEAD" : "TagInfo.BODY"));
s = s.replaceAll("#4", Boolean.toString(deprecated != null && "true".equals(deprecated)));
s = s.replaceAll("#5", Boolean.toString(unique != null && "true".equals(unique)));
s = s.replaceAll("#6", Boolean.toString(ignorePermitted != null && "true".equals(ignorePermitted)));
System.out.println(s);
}
} else if ( !"tags".equals(qName) ) {
dependencyName = qName;
}
}
public void endElement(String uri, String localName, String qName) throws SAXException {
if ( "tag".equals(qName) ) {
if (tagInfo != null) {
tagInfoMap.put(tagInfo.getName(), tagInfo);
if (generateCode) {
System.out.println("this.put(\"" + tagInfo.getName() + "\", tagInfo);\n");
}
}
tagInfo = null;
} else if ( !"tags".equals(qName) ) {
dependencyName = null;
}
}
}
}