code: @Nonnull
    public static ESuccess readMap (@Nonnull @WillClose final InputStream aIS,
                                    @Nonnull final Map <String, String> aTargetMap)
    {
      ValueEnforcer.notNull (aIS, "InputStream");
      ValueEnforcer.notNull (aTargetMap, "TargetMap");
  
      try (final InputStream aCloseMe = aIS)
      {
        // open file
        final IMicroDocument aDoc = MicroReader.readMicroXML (aIS);
        if (aDoc != null)
        {
          readMap (aDoc.getDocumentElement (), aTargetMap);
          return ESuccess.SUCCESS;
        }
      }
      catch (final Exception ex)
      {
        if (LOGGER.isWarnEnabled ())
          LOGGER.warn ("Failed to read mapping resource '" + aIS + "'", ex);
      }
      return ESuccess.FAILURE;
    }
docs: Read a mapping from the passed input stream.
  
  @param aIS
  The input stream to read from. May not be <code>null</code>.
  @param aTargetMap
  The target map to be filled.
  @return {@link ESuccess#SUCCESS} if the stream could be opened, if it could
  be read as XML and if the root element was correct.
  {@link ESuccess#FAILURE} otherwise.