Package com.deltaxml.mergecommon

Interface MergeCommon

All Superinterfaces:

MergeBase

All Known Implementing Classes:

ConcurrentMerge, ConcurrentMerge, ThreeWayMerge, ThreeWayMerge

public interface MergeCommon
extends MergeBase

A common interface for concurrent merge classes.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	MERGE_REST_CONFIG_NAMESPACE	XML Namespace used by the Merge configuration file.

Method Summary

Modifier and Type	Method	Description
String	getAncestorVersion()	Returns the version name of the ancestor.
boolean	isNewTableProcessingEnabled()	Returns the current setting for new table processing.
void	setAncestor(File file, String version)	Sets the ancestor document with a File input.
void	setAncestor(InputStream is, String systemId, String version)	Sets the ancestor document with a InputStream.
void	setAncestor(Reader r, String systemId, String version)	Sets the ancestor document with a Reader.
void	setAncestor(URL url, String version)	Sets the ancestor document with a URL.
void	setTableProcessingAlgorithmVersion2(boolean value)	Enables new table processing algorithm for CALS and HTML table.

Methods inherited from interface com.deltaxml.mergecommon.MergeBase

addLicenseFile, addLicenseServer, addLicenseServer, addProgressListener, addVersion, addVersion, addVersion, addVersion, clearProgressListeners, extractAll, extractAll, extractAll, getCalsTableConfiguration, getDebugFiles, getDebugFilesPrefix, getElementSplitting, getEntityResolver, getEntityResolver, getFormatExtractionPriorityList, getFormattingOutputType, getHtmlTableConfiguration, getVersions, getWordByWord, removeProgressListener, reset, setCalsTableConfiguration, setDebugFiles, setDebugFilesPrefix, setElementSplitting, setEntityResolver, setFormatExtractionPriorityList, setFormattingOutputType, setHtmlTableConfiguration, setIndent, setWordByWord

Field Details

MERGE_REST_CONFIG_NAMESPACE

static final String MERGE_REST_CONFIG_NAMESPACE

XML Namespace used by the Merge configuration file.

See Also:

• Constant Field Values

Method Details

setAncestor

void setAncestor(File file,
 String version)
          throws IllegalStateException,
IllegalArgumentException,
FileNotFoundException,
InvalidInputException,
UnorderedElementContainingPCDATAException,
UnorderedDuplicateKeysException,
com.deltaxml.licensing.LicenseException

Sets the ancestor document with a File input.

The version parameter appears in the result file and must correspond to the NMTOKEN production rule in the XML Specification (the same production rule is used in both XML 1.0 and XML 1.1). This precludes the use of the '!' (0x21) and '=' (0x3d) characters used for version delimiting and other characters which could cause confusion such as the space character.

Parameters:

file - The input file which is the ancestor version.

version - The string to use as the name of the version. This appears in the deltaxml:deltaV2 attributes in the result. This must be an XML NMTOKEN

Throws:

FileNotFoundException - Thrown if the provided file object does not exist.

IllegalStateException - Thrown if the merge object's state is not INITIAL or RESET.

IllegalArgumentException - Thrown if the version parameter is not an NMTOKEN.

InvalidInputException - Thrown if the input is invalid in some way.

UnorderedDuplicateKeysException - Thrown if there are duplicate keys in orderless merge.

UnorderedElementContainingPCDATAException - Thrown if input contains mixed content in orderless merge.

com.deltaxml.licensing.LicenseException - Thrown if there is no license installed, or if the installed license is invalid.

See Also:

• XML 1.0 Specification, Section 2.3: Common Syntactic Constructs

setAncestor

void setAncestor(InputStream is,
 String systemId,
 String version)
          throws IllegalStateException,
IllegalArgumentException,
InvalidInputException,
UnorderedElementContainingPCDATAException,
UnorderedDuplicateKeysException,
com.deltaxml.licensing.LicenseException

Sets the ancestor document with a InputStream.

The version parameter appears in the result file and must correspond to the NMTOKEN production rule in the XML Specification (the same production rule is used in both XML 1.0 and XML 1.1). This precludes the use of the '!' (0x21) and '=' (0x3d) characters used for version delimiting and other characters which could cause confusion such as the space character.

Parameters:

is - The input steam which is the ancestor version.

systemId - The location of the ancestor input stream (for relative lookup).

version - The string to use as the name of the version. This appears in the deltaxml:deltaV2 attributes in the result. This cannot contain '=' or '!' characters.

Throws:

IllegalStateException - Thrown if the merge object's state is not INITIAL or RESET.

IllegalArgumentException - Thrown if the version parameter is not an NMTOKEN.

InvalidInputException - Thrown if the input is invalid in some way.

UnorderedDuplicateKeysException - Thrown if there are duplicate keys in orderless merge.

UnorderedElementContainingPCDATAException - Thrown if input contains mixed content in orderless merge.

com.deltaxml.licensing.LicenseException - Thrown if there is no license installed, or if the installed license is invalid.

See Also:

• XML 1.0 Specification, Section 2.3: Common Syntactic Constructs

setAncestor

void setAncestor(Reader r,
 String systemId,
 String version)
          throws IllegalStateException,
IllegalArgumentException,
InvalidInputException,
DifferingOrderedAttributesException,
UnorderedElementContainingPCDATAException,
UnorderedDuplicateKeysException,
com.deltaxml.licensing.LicenseException

Sets the ancestor document with a Reader.

The version parameter appears in the result file and must correspond to the NMTOKEN production rule in the XML Specification (the same production rule is used in both XML 1.0 and XML 1.1). This precludes the use of the '!' (0x21) and '=' (0x3d) characters used for version delimiting and other characters which could cause confusion such as the space character.

Parameters:

r - The reader which is the ancestor version.

systemId - The location of the ancestor reader (for relative lookup).

version - The string to use as the name of the version. This appears in the deltaxml:deltaV2 attributes in the result. This cannot contain '=' or '!' characters.

Throws:

IllegalStateException - Thrown if the merge object's state is not INITIAL or RESET.

IllegalArgumentException - Thrown if the version parameter is not an NMTOKEN.

InvalidInputException - Thrown if the input is invalid in some way.

DifferingOrderedAttributesException - Thrown if inputs have different deltaxml:ordered attribute values.

UnorderedDuplicateKeysException - Thrown if there are duplicate keys in orderless merge.

UnorderedElementContainingPCDATAException - Thrown if input contains mixed content in orderless merge.

com.deltaxml.licensing.LicenseException - Thrown if there is no license installed, or if the installed license is invalid.

See Also:

• XML 1.0 Specification, Section 2.3: Common Syntactic Constructs

setAncestor

void setAncestor(URL url,
 String version)
          throws IllegalStateException,
IllegalArgumentException,
IOException,
InvalidInputException,
UnorderedElementContainingPCDATAException,
UnorderedDuplicateKeysException,
com.deltaxml.licensing.LicenseException

Sets the ancestor document with a URL.

The version parameter appears in the result file and must correspond to the NMTOKEN production rule in the XML Specification (the same production rule is used in both XML 1.0 and XML 1.1). This precludes the use of the '!' (0x21) and '=' (0x3d) characters used for version delimiting and other characters which could cause confusion such as the space character.

Parameters:

url - The URL to load as the ancestor version.

version - The string to use as the name of the version. This appears in the deltaxml:deltaV2 attributes in the result. This cannot contain '=' or '!' characters.

Throws:

IOException - Thrown if a stream for the supplied URL cannot be opened.

IllegalStateException - Thrown if the merge object's state is not INITIAL or RESET.

IllegalArgumentException - Thrown if the version parameter is not an NMTOKEN.

InvalidInputException - Thrown if the input is invalid in some way.

UnorderedDuplicateKeysException - Thrown if there are duplicate keys in orderless merge.

UnorderedElementContainingPCDATAException - Thrown if input contains mixed content in orderless merge.

com.deltaxml.licensing.LicenseException - Thrown if there is no license installed, or if the installed license is invalid.

See Also:

• XML 1.0 Specification, Section 2.3: Common Syntactic Constructs

getAncestorVersion

String getAncestorVersion()

Returns the version name of the ancestor.

Returns:

the version name of the ancestor

isNewTableProcessingEnabled

boolean isNewTableProcessingEnabled()

Returns the current setting for new table processing.

Returns:

the current value

setTableProcessingAlgorithmVersion2

void setTableProcessingAlgorithmVersion2(boolean value)

Enables new table processing algorithm for CALS and HTML table.

Parameters:

value - The new newTableProcessing setting to use.