We need you!

Icon

The IzPack documentation needs work, and you are invited to edit it!

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Attribute

Description

Required

Allowed Value
(Default)

key

The XPath property key to deal with.

yes

"matcher.default" |
"action.default" |
"mapper.default" |
"xpath.path.<number>_ |
"matcher.path.<number>" |
"action.path.<number>" |
"mapper.path.<number>"

value

The XPath property value to set the above key value to.

yes

  • Key begins on "matcher.":
    Defines how to gather a matching pair of elements from the original and the patch document. Possible values:
    • "TAG"
      Match the element names. 
    • "ATTRIBUTE"
      Match element name and attributes (names and values)
    • "ID_ATTRIBUTE"
      Match element name and the value of the attribute with the name "ID".
    • "NAME_ATTRIBUTE"
      Match element name and the value of the attribute with the name "NAME".
    • "SKIP"
      Never match neither element names nor attributes. 

Default: "ATTRIBUTE"

 

  • Key begins on "action.":
    • "FULLMERGE"
      Merge implementation traversing element contents undependend of their order.
      Note: This does completely merge all matching elements and attributes regardless of there order. This is more time-consuming than ORDEREDMERGE, but it is not necessary to rely on a well-ordered XML. 
    • "ORDEREDMERGE"
      Merge implementation traversing parallelly both element contents. Works when contents are in the same order in both elements.
      Note: This does completely merge all matching elements and attributes, assuming they appear in the same order comparing the patched file with the patch file. This action executes faster than FULLMERGE, but can lead to bad results if the order of both sides is different.
    • "REPLACE"
      Copies the Add or replace - if there is a matching patch element if it exists, add it or replace an existing matching original element by it, otherwise keep the original matching element.
    • "OVERRIDE"
      Copies the patch element if it exist in the originalJust replace an existing matching original element by a matching patch element, but don't add anything if the original element does not exist. If there is no matching patch element, keep the original if no corresponding patch element exists.matching element
    • "KEEP"
      Copies the patch element if it exists also in original, otherwise nothing is added. The original element won't be added in any case. 
    • "COMPLETE"
      Copies the Just add a matching patch element, but only if it does not exist in the original document. in case there is no matching original element. Leave an original matching element otherwise, don't overwrite it.
    • "DELETE"
      Keeps the original element only if it does not appear in the patch document. 
    • "PRESERVE"
      Copies the original regardless of the existence of patch element. 
    • "INSERT"
      Copies the patch element into the output by inserting it after already existing elements of the same name. Usually applied with the matcher option "SKIP".
    • "DTD"
      Copy the patch element in the output parent with the correct position according to the DTD defined in the document. 

Default: ("FULLMERGE")

  • Key begins on "mapper.":
    How the matching element should be further transformed during applying the action.
    There might be more transformations supported in future, filtering out elements and attributes with a specified namespace 
    • "IDENTITY"
      Does not transform the element. 

Default: "IDENTITY"

  • Key begins on "xpath.path.":
    The path to the particular XML elements which should be handled by the so numbered action, matcher and mapper (or their defaults). The XPath is a quite complex language, for more information see XML Path Language (XPath) Version 1.0, WikiPedia and many more documents and tutorials.

...