Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2006-2015 phloc systems
* http://www.phloc.com
* office[at]phloc[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.phloc.commons.xml;
import java.util.ArrayList;
import java.util.List;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.xml.parsers.DocumentBuilderFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.xml.sax.SAXNotRecognizedException;
import org.xml.sax.SAXNotSupportedException;
import com.phloc.commons.ValueEnforcer;
import com.phloc.commons.annotations.CodingStyleguideUnaware;
import com.phloc.commons.annotations.Nonempty;
import com.phloc.commons.annotations.ReturnsMutableCopy;
import com.phloc.commons.lang.EnumHelper;
import com.phloc.commons.lang.GenericReflection;
import com.phloc.commons.name.IHasName;
/**
* Contains constants for parser properties.
*
* @author Philip Helger
*/
public enum EXMLParserProperty implements IHasName
{
/**
* Get the string of characters associated with the current event. If the
* parser recognizes and supports this property but is not currently parsing
* text, it should return null.
* Xerces: This property is currently not supported because the contents of the
* XML string returned by this property is not well defined.
*/
GENERAL_XML_STRING (EXMLParserPropertyType.GENERAL, "http://xml.org/sax/properties/xml-string", String.class),
/**
* The XML Schema Recommendation explicitly states that the inclusion of
* schemaLocation/noNamespaceSchemaLocation attributes is only a hint; it does
* not mandate that these attributes must be used to locate schemas. Similar
* situation happens to <import> element in schema documents. This
* property allows the user to specify a list of schemas to use. If the
* targetNamespace of a schema (specified using this property) matches the
* targetNamespace of a schema occurring in the instance document in
* schemaLocation attribute, or if the targetNamespace matches the namespace
* attribute of <import> element, the schema specified by the user using
* this property will be used (i.e., the schemaLocation attribute in the
* instance document or on the <import> element will be effectively
* ignored).
* The syntax is the same as for schemaLocation attributes in instance
* documents: e.g, "http://www.example.com file_name.xsd". The user can specify
* more than one XML Schema in the list.
*/
GENERAL_EXTERNAL_SCHEMALOCATION (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/schema/external-schemaLocation", String.class),
/**
* This property allows the user to specify an XML Schema with no
* namespace.
* he syntax is a same as for the noNamespaceSchemaLocation attribute that may
* occur in an instance document: e.g."file_name.xsd". The user may specify
* only one XML Schema. For more information see the documentation for the
* http://apache.org/xml/properties/schema/external-schemaLocation property.
*/
GENERAL_EXTERNAL_NONAMESPACE_SCHEMALOCATION (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/schema/external-noNamespaceSchemaLocation", String.class),
/**
* A QName or XSElementDeclaration object representing the top-level element
* declaration used when validating the root element of a document or document
* fragment (also known as the validation root). If the value of this property
* is non-null the validation root will be validated against the specified
* element declaration regardless of the actual name of the root element in the
* instance document. If the value is a QName and a element declaration cannot
* be found an error will be reported.
* If the 'root-type-definition' property has been set this property takes
* precedence if its value is non-null.
* If the value specified is an XSElementDeclaration it must be an object
* obtained from Xerces and must also be an object which is known to the schema
* validator, for example one which would be returned from an XMLGrammarPool.
* If these constraints are not met a ClassCastException may be thrown or
* processing of substitution groups, xsi:type and wildcards may fail to locate
* otherwise available schema components.
*/
GENERAL_ROOT_ELEMENT_DECLARATION (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/validation/schema/root-element-declaration", javax.xml.namespace.QName.class),
/**
* A QName or XSTypeDefinition object representing the top-level type
* definition used when validating the root element of a document or document
* fragment (also known as the validation root). If the value of this property
* is non-null and the 'root-element-declaration' property is not set the
* validation root will not be validated against any element declaration. If
* the value is a QName and a type definition cannot be found an error will be
* reported.
* If the 'root-element-declaration' property has been set this property is
* ignored.
* Prior to Xerces-J 2.10.0 setting the value of this property to an
* XSTypeDefinition was not supported.
* If the value specified is an XSTypeDefinition it must be an object obtained
* from Xerces and must also be an object which is known to the schema
* validator, for example one which would be returned from an XMLGrammarPool.
* If these constraints are not met a ClassCastException may be thrown or
* processing of substitution groups, xsi:type and wildcards may fail to locate
* otherwise available schema components.
*/
GENERAL_ROOT_TYPE_DECLARATION (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/validation/schema/root-type-definition", javax.xml.namespace.QName.class),
/**
* The size of the input buffer in the readers. This determines how many bytes
* to read for each chunk.
* Some tests indicate that a bigger buffer size can improve the parsing
* performance for relatively large files. The default buffer size in Xerces is
* 2K. This would give a good performance for small documents (less than 10K).
* For documents larger than 10K, specifying the buffer size to 4K or 8K will
* significantly improve the performance. But it's not recommended to set it to
* a value larger than 16K. For really tiny documents (1K, for example), you
* can also set it to a value less than 2K, to get the best performance.
* There are some conditions where the size of the parser's internal buffers
* may be increased beyond the size specified for the input buffer. This would
* happen in places where the text in the document cannot be split, for
* instance if the document contains a name which is longer than the input
* buffer.
*/
GENERAL_INPUT_BUFFER_SIZE (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/input-buffer-size", Integer.class),
/**
* The locale to use for reporting errors and warnings. When the value of this
* property is null the platform default returned from
* java.util.Locale.getDefault() will be used.
* If no messages are available for the specified locale the platform default
* will be used. If the platform default is not English and no messages are
* available for this locale then messages will be reported in English.
*/
GENERAL_LOCALE (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/locale", java.util.Locale.class),
/**
* It is possible to create XML documents whose processing could result in the
* use of all system resources. This property enables Xerces to detect such
* documents, and abort their processing.
* The org.apache.xerces.util.SecurityManager class contains a number of
* methods that allow applications to tailor Xerces's tolerance of document
* constructs that could result in the heavy consumption of system resources
* (see the javadoc of this class for details). Default values that should be
* appropriate for many environments are provided when the class is
* instantiated. Xerces will not behave in a strictly spec-compliant way when
* this property is set. By default, this property is not set; Xerces's
* behaviour is therefore strictly spec-compliant by default.
*/
GENERAL_SECURITY_MANAGER (EXMLParserPropertyType.GENERAL, "http://apache.org/xml/properties/security-manager", "org.apache.xerces.util.SecurityManager"),
/**
* The current DOM element node while parsing.
* This property is useful for determining the location with a DOM document
* when an error occurs.
*/
DOM_CURRENT_ELEMENT_NODE (EXMLParserPropertyType.DOM, "http://apache.org/xml/properties/dom/current-element-node", org.w3c.dom.Element.class),
/**
* The fully qualified name of the class implementing the org.w3c.dom.Document
* interface. The implementation used must have a zero argument
* constructor.
* When the document class name is set to a value other than the name of the
* default document factory, the deferred node expansion feature does not work.
*/
DOM_DOCUMENT_CLASS_NAME (EXMLParserPropertyType.DOM, "http://apache.org/xml/properties/dom/document-class-name", String.class),
/** The handler for DTD declarations. */
SAX_DECLARATION_HANDLER (EXMLParserPropertyType.SAX, "http://xml.org/sax/properties/declaration-handler", org.xml.sax.ext.DeclHandler.class),
/** The handler for lexical parsing events. */
SAX_LEXICAL_HANDLER (EXMLParserPropertyType.SAX, "http://xml.org/sax/properties/lexical-handler", org.xml.sax.ext.LexicalHandler.class),
/**
* The DOM node currently being visited, if SAX is being used as a DOM
* iterator. If the parser recognizes and supports this property but is not
* currently visiting a DOM node, it should return null.
* This property is only for SAX parser implementations used as DOM tree
* walkers. Currently, Xerces does not have this functionality.
*/
SAX_DOM_NODE (EXMLParserPropertyType.SAX, "http://xml.org/sax/properties/dom-node", org.w3c.dom.Node.class),
/**
* A literal string describing the actual XML version of the document, such as
* "1.0" or "1.1".
* This property may only be examined during a parse after the startDocument
* callback has been completed.
*/
SAX_XML_VERSION (EXMLParserPropertyType.SAX, "http://xml.org/sax/properties/document-xml-version", String.class);
private static final Logger s_aLogger = LoggerFactory.getLogger (EXMLParserProperty.class);
private final EXMLParserPropertyType m_ePropertyType;
private final String m_sName;
private Class m_aValueClass;
@CodingStyleguideUnaware
private boolean m_bWarnedOnce = false;
private final String m_sValueClassName;
private EXMLParserProperty (@Nonnull final EXMLParserPropertyType ePropertyType,
@Nonnull @Nonempty final String sName,
@Nonnull @Nonempty final String sValueClassName)
{
this.m_ePropertyType = ePropertyType;
this.m_sName = sName;
// May be null
this.m_aValueClass = GenericReflection.getClassFromNameSafe (sValueClassName);
this.m_sValueClassName = sValueClassName;
}
private EXMLParserProperty (@Nonnull final EXMLParserPropertyType ePropertyType,
@Nonnull @Nonempty final String sName,
@Nonnull final Class aValueClass)
{
this.m_ePropertyType = ePropertyType;
this.m_sName = sName;
this.m_aValueClass = aValueClass;
this.m_sValueClassName = aValueClass.getName ();
}
@Nonnull
public EXMLParserPropertyType getPropertyType ()
{
return this.m_ePropertyType;
}
@Override
@Nonnull
@Nonempty
public String getName ()
{
return this.m_sName;
}
@Nullable
public Class getValueClass ()
{
return this.m_aValueClass;
}
@Nonnull
@Nonempty
public String getValueClassName ()
{
return this.m_sValueClassName;
}
public void applyTo (@Nonnull final org.xml.sax.XMLReader aParser, final Object aValue)
{
ValueEnforcer.notNull (aParser, "Parser");
if (this.m_ePropertyType != EXMLParserPropertyType.GENERAL && this.m_ePropertyType != EXMLParserPropertyType.SAX)
s_aLogger.warn ("Parser property '" + name () + "' is not applicable for SAX parsers!");
try
{
aParser.setProperty (this.m_sName, aValue);
}
catch (final SAXNotRecognizedException ex)
{
if (!this.m_bWarnedOnce)
{
s_aLogger.warn ("XML Parser does not recognize property '" + name () + "'");
this.m_bWarnedOnce = true;
}
}
catch (final SAXNotSupportedException ex)
{
s_aLogger.warn ("XML Parser does not support property '" + name () + "'");
}
}
public void applyTo (@Nonnull final DocumentBuilderFactory aDocumentBuilderFactory, final Object aValue)
{
ValueEnforcer.notNull (aDocumentBuilderFactory, "DocumentBuilderFactory");
if (this.m_ePropertyType != EXMLParserPropertyType.GENERAL && this.m_ePropertyType != EXMLParserPropertyType.DOM)
s_aLogger.warn ("Parser property '" + name () + "' is not applicable for DOM parsers!");
try
{
aDocumentBuilderFactory.setAttribute (this.m_sName, aValue);
}
catch (final IllegalArgumentException ex)
{
s_aLogger.warn ("DOM parser does not support property '" + name () + "'");
}
}
@Nullable
public static EXMLParserProperty getFromNameOrNull (@Nullable final String sName)
{
return EnumHelper.getFromNameOrNull (EXMLParserProperty.class, sName);
}
@Nonnull
@ReturnsMutableCopy
public static List getAllPropertiesOfType (@Nonnull final EXMLParserPropertyType ePropertyType)
{
ValueEnforcer.notNull (ePropertyType, "PropertyType");
final List ret = new ArrayList ();
for (final EXMLParserProperty eProperty : values ())
if (eProperty.getPropertyType () == ePropertyType)
ret.add (eProperty);
return ret;
}
}
