com.saxonica.ee.schema

Interface ComponentReference

All Superinterfaces:

Location, Locator, SourceLocator

All Known Implementing Classes:

AttributeGroupReference, AttributeUse, Edge.MaxOccursParticle, ElementParticle, ElementWildcard, IdentityConstraintReference, KeyRef, ModelGroupParticle, Particle, SimpleComponentReference, TypeReference

public interface ComponentReference
extends Location

A reference to a schema component. The reference may have been resolved to a specific component, or may be as yet unresolved. Any attempt to use a reference that has not yet been resolved causes an unchecked exception.

Method Summary

Methods

Modifier and Type	Method and Description
EnterpriseConfiguration	getConfiguration() Determine the configuration containing this reference (and its target)
int	getSymbolSpace() Get the symbol space of the target of this reference
SchemaComponent	getTarget() Get the schema component identified by this reference.
StructuredQName	getTargetComponentName() Get the name of the target of this reference
boolean	isDangling() Ask whether this is known to be a dangling reference
boolean	isResolved() Ask whether this reference has been resolved
void	tryToResolve(SchemaCompiler compiler) Try to resolve the reference if possible, relative to components present in a given schema.

Methods inherited from interface net.sf.saxon.expr.parser.Location

getColumnNumber, getLineNumber, getPublicId, getSystemId, saveLocation

Method Detail

getConfiguration

EnterpriseConfiguration getConfiguration()

Determine the configuration containing this reference (and its target)

Returns:

the Saxon configuration

tryToResolve

void tryToResolve(SchemaCompiler compiler)

Try to resolve the reference if possible, relative to components present in a given schema. No error occurs if the reference cannot yet be resolved, but the reference is marked as a dangling reference.

Parameters:

compiler - The compiler being used to compile the referring component. This is assumed to know about the schema containing the candidate target components for the reference. If null, the schema containing the reference is used.

isResolved

boolean isResolved()

Ask whether this reference has been resolved

Returns:

true if the reference has been resolved to a schema component

isDangling

boolean isDangling()

Ask whether this is known to be a dangling reference

Returns:

true if the target of this component reference is known to be absent, and if a warning has been issued to this effect

getTarget

SchemaComponent getTarget()
                          throws MissingComponentException

Get the schema component identified by this reference.

Returns:

the schema component if the reference has been resolved.

Throws:

MissingComponentException - if the reference has not been resolved.

getTargetComponentName

StructuredQName getTargetComponentName()

Get the name of the target of this reference

Returns:

the component name of the target component

getSymbolSpace

int getSymbolSpace()

Get the symbol space of the target of this reference

Returns:

an integer code identifying the symbol space