com.phloc.schematron.pure.bound

Class PSBoundSchemaCacheKey

java.lang.Object

com.phloc.schematron.pure.bound.PSBoundSchemaCacheKey

@Immutable
public class PSBoundSchemaCacheKey
extends Object

This class represents keys for the PSBoundSchemaCache. It is a combination of a resource and a phase. It is the responsible class for reading and binding a Schematron resource.

Author:

Philip Helger

Constructor Summary

Constructors

Constructor and Description
PSBoundSchemaCacheKey(com.phloc.commons.io.IReadableResource aResource, String sPhase, IPSErrorHandler aErrorHandler)

Method Summary

Methods

Modifier and Type	Method and Description
IPSBoundSchema	createBoundSchema() The main routine to create a bound schema from the passed resource and phase.
protected PSSchema	createPreprocessedSchema(PSSchema aSchema, IPSQueryBinding aQueryBinding) Pre-process the read schema, using the determined query binding.
protected PSPreprocessor	createPreprocessor(IPSQueryBinding aQueryBinding) Create the pre-processor to be used for createPreprocessedSchema(PSSchema, IPSQueryBinding).
boolean	equals(Object o)
IPSErrorHandler	getErrorHandler()
String	getPhase()
protected IPSQueryBinding	getQueryBinding(PSSchema aSchema) Determine the query binding for the read schema.
com.phloc.commons.io.IReadableResource	getResource()
int	hashCode()
protected PSSchema	readSchema(com.phloc.commons.io.IReadableResource aResource, IPSErrorHandler aErrorHandler) Read the specified schema from the passed resource.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PSBoundSchemaCacheKey

public PSBoundSchemaCacheKey(@Nonnull
                     com.phloc.commons.io.IReadableResource aResource,
                     @Nullable
                     String sPhase,
                     @Nullable
                     IPSErrorHandler aErrorHandler)

Method Detail

getResource

@Nonnull
public final com.phloc.commons.io.IReadableResource getResource()

Returns:

The resource passed in the constructor. Never null.

getPhase

@Nullable
public final String getPhase()

Returns:

The phase selected in the constructor. May be null.

getErrorHandler

@Nullable
public final IPSErrorHandler getErrorHandler()

Returns:

The error handler passed in the constructor. May be null.

readSchema

@Nonnull
@OverrideOnDemand
protected PSSchema readSchema(@Nonnull
                                           com.phloc.commons.io.IReadableResource aResource,
                                           @Nullable
                                           IPSErrorHandler aErrorHandler)
                       throws SchematronException

Read the specified schema from the passed resource.

Parameters:

aResource - The resource to read from. Never null.

aErrorHandler - The error handler to use. May be null.

Returns:

The read schema. May not be null.

Throws:

SchematronException - In case there is an error reading.

getQueryBinding

@Nonnull
@OverrideOnDemand
protected IPSQueryBinding getQueryBinding(@Nonnull
                                                       PSSchema aSchema)
                                   throws SchematronException

Determine the query binding for the read schema.

Parameters:

aSchema - The read schema. Never null.

Returns:

The query binding to use. Never null.

Throws:

SchematronException - In case the determination fails.

createPreprocessor

@Nonnull
@OverrideOnDemand
protected PSPreprocessor createPreprocessor(@Nonnull
                                                         IPSQueryBinding aQueryBinding)

Create the pre-processor to be used for createPreprocessedSchema(PSSchema, IPSQueryBinding).

Parameters:

aQueryBinding - The query binding to be determined from the read schema. Never null.

Returns:

The pre-processor to be used.

createPreprocessedSchema

@Nonnull
@OverrideOnDemand
protected PSSchema createPreprocessedSchema(@Nonnull
                                                         PSSchema aSchema,
                                                         @Nonnull
                                                         IPSQueryBinding aQueryBinding)
                                     throws SchematronException

Pre-process the read schema, using the determined query binding.

Parameters:

aSchema - The read schema. Never null.

aQueryBinding - The determined query binding. Never null.

Returns:

The pre-processed schema and never null.

Throws:

SchematronException - In case pre-processing fails

createBoundSchema

@Nonnull
public IPSBoundSchema createBoundSchema()
                                 throws SchematronException

The main routine to create a bound schema from the passed resource and phase. The usual routine is to

1. read the schema from the resource - see readSchema(IReadableResource, IPSErrorHandler)
2. resolve the query binding - see getQueryBinding(PSSchema)
3. pre-process the schema - createPreprocessedSchema(PSSchema, IPSQueryBinding)
4. and finally bind it - IPSQueryBinding.bind(PSSchema, String, IPSErrorHandler)

Returns:

The bound schema. Never null.

Throws:

SchematronException - In case reading or binding fails.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object