java/alt2xml-lib-input/src/cz/frantovo/alt2xml/AbstractAlt2XmlReader.java
author František Kučera <franta-hg@frantovo.cz>
Thu, 24 Oct 2019 21:56:03 +0200
changeset 111 e4900596abdb
parent 75 ed9ec17aa67f
permissions -rw-r--r--
fix license version: GNU GPLv3
franta-hg@11
     1
/**
franta-hg@11
     2
 * Alt2XML
franta-hg@11
     3
 * Copyright © 2014 František Kučera (frantovo.cz)
franta-hg@11
     4
 *
franta-hg@11
     5
 * This program is free software: you can redistribute it and/or modify
franta-hg@11
     6
 * it under the terms of the GNU General Public License as published by
franta-hg@111
     7
 * the Free Software Foundation, version 3 of the License.
franta-hg@11
     8
 *
franta-hg@11
     9
 * This program is distributed in the hope that it will be useful,
franta-hg@11
    10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
franta-hg@11
    11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
franta-hg@11
    12
 * GNU General Public License for more details.
franta-hg@11
    13
 *
franta-hg@11
    14
 * You should have received a copy of the GNU General Public License
franta-hg@11
    15
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
franta-hg@11
    16
 */
franta-hg@16
    17
package cz.frantovo.alt2xml;
franta-hg@2
    18
franta-hg@75
    19
import cz.frantovo.alt2xml.in.Alt2ContentHandler;
franta-hg@2
    20
import java.io.IOException;
franta-hg@4
    21
import java.util.HashMap;
franta-hg@4
    22
import java.util.Map;
franta-hg@2
    23
import org.xml.sax.ContentHandler;
franta-hg@2
    24
import org.xml.sax.DTDHandler;
franta-hg@2
    25
import org.xml.sax.EntityResolver;
franta-hg@2
    26
import org.xml.sax.ErrorHandler;
franta-hg@2
    27
import org.xml.sax.InputSource;
franta-hg@2
    28
import org.xml.sax.SAXException;
franta-hg@2
    29
import org.xml.sax.SAXNotRecognizedException;
franta-hg@2
    30
import org.xml.sax.SAXNotSupportedException;
franta-hg@2
    31
import org.xml.sax.XMLReader;
franta-hg@2
    32
franta-hg@2
    33
/**
franta-hg@17
    34
 * Recommended base class for all alternative format readers.
franta-hg@2
    35
 *
franta-hg@17
    36
 * @author Ing. František Kučera (frantovo.cz)
franta-hg@2
    37
 */
franta-hg@17
    38
public abstract class AbstractAlt2XmlReader implements XMLReader {
franta-hg@2
    39
franta-hg@61
    40
	private static final String PROPERTY_BASE_URL = "https://alt2xml.globalcode.info/sax-property/";
franta-hg@75
    41
	protected Alt2ContentHandler contentHandler;
franta-hg@17
    42
	protected ErrorHandler errorHandler;
franta-hg@17
    43
	protected DTDHandler dtdHandler;
franta-hg@17
    44
	protected EntityResolver entityResolver;
franta-hg@17
    45
	protected Map<String, Object> properties = new HashMap<>();
franta-hg@44
    46
	protected Map<String, Boolean> features = new HashMap<>();
franta-hg@6
    47
franta-hg@6
    48
	@Override
franta-hg@6
    49
	public void parse(String systemId) throws IOException, SAXException {
franta-hg@6
    50
		parse(new InputSource(systemId));
franta-hg@6
    51
	}
franta-hg@6
    52
franta-hg@6
    53
	@Override
franta-hg@2
    54
	public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException {
franta-hg@7
    55
		/**
franta-hg@15
    56
		 * TODO:
franta-hg@15
    57
		 * All XMLReaders are required to recognize
franta-hg@15
    58
		 * the http://xml.org/sax/features/namespaces
franta-hg@7
    59
		 * and the http://xml.org/sax/features/namespace-prefixes feature names.
franta-hg@7
    60
		 */
franta-hg@44
    61
		Boolean feature = features.get(name);
franta-hg@44
    62
		return feature == null ? false : feature;
franta-hg@2
    63
	}
franta-hg@2
    64
franta-hg@2
    65
	@Override
franta-hg@2
    66
	public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException {
franta-hg@44
    67
		/**
franta-hg@44
    68
		 * TODO: filtrovat – povolit jen náš jmenný prostor
franta-hg@44
    69
		 */
franta-hg@44
    70
		features.put(name, value);
franta-hg@2
    71
	}
franta-hg@2
    72
franta-hg@61
    73
	/**
franta-hg@61
    74
	 *
franta-hg@61
    75
	 * @param readerId should be [a-z0-9] and same as specific part of the module/project name (e.g.
franta-hg@61
    76
	 * alt2xml-in-properties → properties)
franta-hg@61
    77
	 * @param propertyId should be [a-z0-9-] and unique per module/reader
franta-hg@61
    78
	 * @return URL
franta-hg@61
    79
	 */
franta-hg@61
    80
	protected static String constructPropertyName(String readerId, String propertyId) {
franta-hg@61
    81
		return PROPERTY_BASE_URL + readerId + "/" + propertyId;
franta-hg@61
    82
	}
franta-hg@61
    83
franta-hg@2
    84
	@Override
franta-hg@2
    85
	public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException {
franta-hg@17
    86
		return properties.get(name);
franta-hg@2
    87
	}
franta-hg@2
    88
franta-hg@2
    89
	@Override
franta-hg@2
    90
	public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException {
franta-hg@17
    91
		properties.put(name, value);
franta-hg@2
    92
	}
franta-hg@2
    93
franta-hg@2
    94
	@Override
franta-hg@4
    95
	public void setEntityResolver(EntityResolver entityResolver) {
franta-hg@4
    96
		this.entityResolver = entityResolver;
franta-hg@2
    97
	}
franta-hg@2
    98
franta-hg@2
    99
	@Override
franta-hg@2
   100
	public EntityResolver getEntityResolver() {
franta-hg@4
   101
		return entityResolver;
franta-hg@2
   102
	}
franta-hg@2
   103
franta-hg@2
   104
	@Override
franta-hg@4
   105
	public void setDTDHandler(DTDHandler dtdHandler) {
franta-hg@4
   106
		this.dtdHandler = dtdHandler;
franta-hg@2
   107
	}
franta-hg@2
   108
franta-hg@2
   109
	@Override
franta-hg@2
   110
	public DTDHandler getDTDHandler() {
franta-hg@4
   111
		return dtdHandler;
franta-hg@2
   112
	}
franta-hg@2
   113
franta-hg@2
   114
	@Override
franta-hg@4
   115
	public void setContentHandler(ContentHandler contentHandler) {
franta-hg@75
   116
		this.contentHandler = new Alt2ContentHandler(contentHandler);
franta-hg@2
   117
	}
franta-hg@2
   118
franta-hg@2
   119
	@Override
franta-hg@75
   120
	public Alt2ContentHandler getContentHandler() {
franta-hg@2
   121
		return contentHandler;
franta-hg@2
   122
	}
franta-hg@2
   123
franta-hg@2
   124
	@Override
franta-hg@4
   125
	public void setErrorHandler(ErrorHandler errorHandler) {
franta-hg@4
   126
		this.errorHandler = errorHandler;
franta-hg@2
   127
	}
franta-hg@2
   128
franta-hg@2
   129
	@Override
franta-hg@2
   130
	public ErrorHandler getErrorHandler() {
franta-hg@4
   131
		return errorHandler;
franta-hg@2
   132
	}
franta-hg@2
   133
}