com.wm.xmldata

Class XmlDataCopy

java.lang.Object

com.wm.xmldata.XmlDataCopy

public class XmlDataCopy
extends java.lang.Object

XmlDataCopy implements a structured copying utility for XmlData infosets. It is implemented using XmlDataMaps. It allows copying from an XmlData infoset to another XmlData infoset using the same path expressions used by XmlDataMap. However, the paths used by XmlDataCopy have been enhanced significantly with the introduction of the iterator-tag. The iterator-tag acts like a wildcard, iterating over the names or indexes of instance data. XmlDataIteratorTags must begin with the ! character and are not namespace-qualified. Same-named iterator tags in the source map and output are matched during iteration over the entire input infoset, copying the values to the corresponding output infoset.

Constructor Summary

Constructors

Constructor and Description
XmlDataCopy(XmlDataMap source, XmlDataMap dest) Creates an XmlDataCopy executor, providing a source map and a destination map.

Method Summary

Modifier and Type	Method and Description
static void	copy(IData input, NSRecord inputRecord, java.lang.String inputPath, IData output, NSRecord outputRecord, java.lang.String outputPath) Convenience method that performs a single copy operation.
void	copy(java.lang.String sourcePath, java.lang.String destinationPath) Convenience method that performs a copy using String form of the path specification.
void	copy(XmlDataContentTag[] sourcePath, XmlDataContentTag[] destinationPath) Performs a copy operation using the specified source and destination paths.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XmlDataCopy

public XmlDataCopy(XmlDataMap source,
                   XmlDataMap dest)

Creates an XmlDataCopy executor, providing a source map and a destination map. The map provides the source and destination XmlData infosets as well as a map for the top-level document.

Parameters:

source - source map

dest - destination map

Method Detail

copy

public void copy(XmlDataContentTag[] sourcePath,
                 XmlDataContentTag[] destinationPath)

Performs a copy operation using the specified source and destination paths. In addition to element, group, substitution, and any tags, this method also supports XmlDataIteratorTags. An iterator tag is tag with a name starting with the ! character. They serve as path wildcards. Corresponding wildcards in the input path are matched with corresponding wildcards in the output path. For example input path /employee/!items has a wildcard that matches child names in output path /contractor/!items.

Parameters:

sourcePath - source path array of tags

destinationPath - destination path array of tags

copy

public void copy(java.lang.String sourcePath,
                 java.lang.String destinationPath)

Convenience method that performs a copy using String form of the path specification.

Parameters:

sourcePath - source path String

destinationPath - destination path String

copy

public static void copy(IData input,
                        NSRecord inputRecord,
                        java.lang.String inputPath,
                        IData output,
                        NSRecord outputRecord,
                        java.lang.String outputPath)

Convenience method that performs a single copy operation. It creates an XmlDataMap for input and output, creates an XmlDataCopy object using the String form for input and output paths, and then invokes the copy method.

Parameters:

input - input XmlData infoset

inputRecord - document type providing the input schema

inputPath - the source path specified as a String

output - output XmlData infoset

outputRecord - Document Type providing the output scheme

outputPath - the destination path specified as a String