Syntax

   FACTORY_DEF <ReaderKeyword> XMLNamespaceHandlerFactory 
   [FACTORY_NAME <factory name>] 
   [INPUT FEATURE_TYPE <feature type> 
      [<attribute name> <attribute value>]* 
      [<feature function>]*]*
   XML_INPUT_FILE <file name or attribute value> | 
      XML_INPUT_TEXT_ATTR  <attribute name> |
      XML_INPUT_TEXT <xmlText>
   XML_OUTPUT_FILE <file name or attribute value> | 
      XML_OUTPUT_ATTR  <attribute name>
   [FILL_MISSING_NAMESPACE (YES|NO)]
   SAMPLE_XML_FOR_NAMESPACE <file name>
   [PRETTY_PRINT (YES|NO)]
   [INDENT_SIZE (0...9)]
   [REPLACE_TABS_WITH_SPACES (YES|NO)]
   LIST_ATTR <attribute name>
   [OUTPUT (PASSED|FAILED) FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]* 
      [<feature function>]*]* 

Overview

   The XMLNamespaceHandlerFactory fixes prefixes that are missing namespace 
   declarations in input XML document by providing a sample XML file containing 
   the proper namespace declarations. 

   The input XML can be specified either as a file path in the XML_INPUT_FILE 
   clause or as XML text in the XML_INPUT_TEXT_ATTR clause. The sample file 
   containing the proper namespace declarations can be specified in 
   SAMPLE_XML_FOR_NAMESPACE clause. 

   The resulting XML document can be output to either a file or feature 
   attribute. If all missing namespace declarations are fixed and the output is 
   a valid XML file, then the feature is output through the PASSED output port. 
   Otherwise, it will be output through the FAILED port. 

   If PRETTY_PRINT is enabled, the output XML elements will be
   formatted by adding indentations and adding new lines to improve
   readability. INDENT_SIZE determines the size of each indentation and
   REPLACE_TABS_WITH_SPACES determines whether indentation is measured in
   tabs or spaces.

   In the cases where the input or output is not a valid XML document, the 
   factory will tag on the list of errors and warnings on the feature as a list 
   attribute specified in LIST_ATTR clause. The following elements are added to 
   the list that further describes the errors or warnings (assuming listName is 
   the attribute list specified in this clause): listName{}.type, 
   listName{}.file, listName{}.line, listName{}.col and listName{}.desc.

Assumptions

   The file specified in SAMPLE_XML_FOR_NAMESPACE must be a valid XML file 
   containing the namespace declarations.

Output Tags

   The XMLNamespaceHandler factory supports the following output tags.
   
   PASSED   
   
      The features that have their XML input document fixed and produce valid 
      XML files are output through this tag.

   FAILED   
   
      The INPUT features containing an error in their XML source or not fixed 
      are output through the FAILED output tag.

TO BE RESOLVED

   XML_INPUT_TEXT and FILL_MISSING_NAMESPACE clause added to Syntax section 
   above from header, but not documented.