com.phloc.schematron.pure.preprocess

Class PSPreprocessor

java.lang.Object

com.phloc.schematron.pure.preprocess.PSPreprocessor

@NotThreadSafe
public class PSPreprocessor
extends Object

This is the pre-processor class for pure Schematron. It converts an existing schema to the minimal syntax (by default) but allows for a certain degree of customization by keeping certain elements in the resulting schema. The actual query binding is used, so that report test expressions can be converted to assertions, and to replace the content of <param> elements into actual values.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_KEEP_DIAGNOSTICS
static boolean	DEFAULT_KEEP_EMPTY_PATTERNS
static boolean	DEFAULT_KEEP_EMPTY_SCHEMA
static boolean	DEFAULT_KEEP_REPORTS
static boolean	DEFAULT_KEEP_TITLES

Constructor Summary

Constructors

Constructor and Description
PSPreprocessor(IPSQueryBinding aQueryBinding)

Method Summary

Methods

Modifier and Type	Method and Description
PSSchema	getAsMinimalSchema(PSSchema aSchema) Convert the passed schema to a minimal schema.
PSSchema	getAsPreprocessedSchema(PSSchema aSchema) Convert the passed schema to a preprocessed schema.
PSSchema	getForcedPreprocessedSchema(PSSchema aSchema) Convert the passed schema to a preprocessed schema independent if it is already minimal or not.
IPSQueryBinding	getQueryBinding()
boolean	isKeepDiagnostics()
boolean	isKeepEmptyPatterns()
boolean	isKeepEmptySchema()
boolean	isKeepReports()
boolean	isKeepTitles()
PSPreprocessor	setKeepDiagnostics(boolean bKeepDiagnostics)
PSPreprocessor	setKeepEmptyPatterns(boolean bKeepEmptyPatterns)
PSPreprocessor	setKeepEmptySchema(boolean bKeepEmptySchema) Should schema objects without a pattern be kept?
PSPreprocessor	setKeepReports(boolean bKeepReports)
PSPreprocessor	setKeepTitles(boolean bKeepTitles)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_KEEP_TITLES

public static final boolean DEFAULT_KEEP_TITLES

See Also:

Constant Field Values

DEFAULT_KEEP_DIAGNOSTICS

public static final boolean DEFAULT_KEEP_DIAGNOSTICS

See Also:

Constant Field Values

DEFAULT_KEEP_REPORTS

public static final boolean DEFAULT_KEEP_REPORTS

See Also:

Constant Field Values

DEFAULT_KEEP_EMPTY_PATTERNS

public static final boolean DEFAULT_KEEP_EMPTY_PATTERNS

See Also:

Constant Field Values

DEFAULT_KEEP_EMPTY_SCHEMA

public static final boolean DEFAULT_KEEP_EMPTY_SCHEMA

See Also:

Constant Field Values

Constructor Detail

PSPreprocessor

public PSPreprocessor(@Nonnull
              IPSQueryBinding aQueryBinding)

Method Detail

getQueryBinding

@Nonnull
public IPSQueryBinding getQueryBinding()

Returns:

The query binding to be used. Never null!

isKeepTitles

public boolean isKeepTitles()

Returns:

true if <title>-elements should be kept. Default is false.

setKeepTitles

@Nonnull
public PSPreprocessor setKeepTitles(boolean bKeepTitles)

isKeepDiagnostics

public boolean isKeepDiagnostics()

Returns:

true if <diagnostics>-elements should be kept. Default is false.

setKeepDiagnostics

@Nonnull
public PSPreprocessor setKeepDiagnostics(boolean bKeepDiagnostics)

isKeepReports

public boolean isKeepReports()

Returns:

true if <report>-elements should be kept. Default is false.

setKeepReports

@Nonnull
public PSPreprocessor setKeepReports(boolean bKeepReports)

isKeepEmptyPatterns

public boolean isKeepEmptyPatterns()

Returns:

true if <pattern>-elements without a rule should be kept. Default is true.

setKeepEmptyPatterns

@Nonnull
public PSPreprocessor setKeepEmptyPatterns(boolean bKeepEmptyPatterns)

isKeepEmptySchema

public boolean isKeepEmptySchema()

Returns:

true if <schema>-elements without a pattern should be kept. Default is true.

setKeepEmptySchema

@Nonnull
public PSPreprocessor setKeepEmptySchema(boolean bKeepEmptySchema)

Should schema objects without a pattern be kept? It makes only sense to set it to false if setKeepEmptyPatterns(boolean) is also set to false, because otherwise patterns without rules are kept.

Parameters:

bKeepEmptySchema - true to keep them, false to discard them.

Returns:

this

getAsMinimalSchema

@Nullable
public PSSchema getAsMinimalSchema(@Nonnull
                                   PSSchema aSchema)
                            throws SchematronPreprocessException

Convert the passed schema to a minimal schema.

Parameters:

aSchema - The schema to be made minimal. May not be null

Returns:

The original schema object, if it is already minimal - a minimal copy otherwise! May be null if the original schema is not yet minimal and isKeepEmptySchema() is set to false.

Throws:

SchematronPreprocessException - In case a preprocessing error occurs

getAsPreprocessedSchema

@Nullable
public PSSchema getAsPreprocessedSchema(@Nonnull
                                        PSSchema aSchema)
                                 throws SchematronPreprocessException

Convert the passed schema to a preprocessed schema.

Parameters:

aSchema - The schema to pre-process. May not be null

Returns:

The original schema object, if it is already preprocessed - a preprocessed copy otherwise! May be null if the original schema is not yet preprocessed and isKeepEmptySchema() is set to false.

Throws:

SchematronPreprocessException - In case a preprocessing error occurs

getForcedPreprocessedSchema

@Nullable
public PSSchema getForcedPreprocessedSchema(@Nonnull
                                            PSSchema aSchema)
                                     throws SchematronPreprocessException

Convert the passed schema to a preprocessed schema independent if it is already minimal or not.

Parameters:

aSchema - The schema to be made minimal. May not be null

Returns:

A minimal copy of the schema. May be null if the original schema is not yet minimal and isKeepEmptySchema() is set to false.

Throws:

SchematronPreprocessException - In case a preprocessing error occurs

toString

public String toString()

Overrides:

toString in class Object