Package net.sf.saxon.expr.parser
Class RoleDiagnostic
java.lang.Object
net.sf.saxon.expr.parser.RoleDiagnostic
A RoleDiagnostic (formerly RoleLocator) identifies the role in which an expression is used,
for example as the third argument of the concat() function. This information is stored in an
ItemChecker or CardinalityChecker so that good diagnostics can be
achieved when run-time type errors are detected.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
-
Constructor Summary
ConstructorsConstructorDescriptionRoleDiagnostic
(int kind, String operation, int operand) Create information about the role of a subexpression within its parent expressionRoleDiagnostic
(int kind, String operation, int operand, String errorCode) -
Method Summary
Modifier and TypeMethodDescriptioncomposeErrorMessage
(ItemType requiredItemType, Expression supplied, TypeHierarchy th) Construct a full error message, containing the supplied expression (for use when the error is reported statically)composeErrorMessage
(ItemType requiredItemType, Item item, TypeHierarchy th) Construct a full error message, displaying the item in error (suitable for use when a type error is reported dynamically)composeErrorMessage
(ItemType requiredItemType, ItemType suppliedItemType) Construct a full error messagecomposeErrorMessage
(ItemType requiredItemType, UType suppliedItemType) Construct a full error message, in terms of UTypescomposeRequiredMessage
(ItemType requiredItemType) Construct the part of the message giving the required item typeGet the error code to be produced if a type error is detectedConstruct and return the error message indicating a type errorboolean
Ask whether the error code represents a type errorstatic String
ordinal
(int n) Get the ordinal representation of a number (used to identify which argument of a function is in error)static RoleDiagnostic
reconstruct
(String in) Reconstruct from a saved stringsave()
Save as a string, for use when serializing the expression treevoid
setErrorCode
(String code) Set the error code to be produced if a type error is detected
-
Field Details
-
FUNCTION
public static final int FUNCTION- See Also:
-
BINARY_EXPR
public static final int BINARY_EXPR- See Also:
-
TYPE_OP
public static final int TYPE_OP- See Also:
-
VARIABLE
public static final int VARIABLE- See Also:
-
INSTRUCTION
public static final int INSTRUCTION- See Also:
-
FUNCTION_RESULT
public static final int FUNCTION_RESULT- See Also:
-
ORDER_BY
public static final int ORDER_BY- See Also:
-
TEMPLATE_RESULT
public static final int TEMPLATE_RESULT- See Also:
-
PARAM
public static final int PARAM- See Also:
-
UNARY_EXPR
public static final int UNARY_EXPR- See Also:
-
UPDATING_EXPR
public static final int UPDATING_EXPR- See Also:
-
EVALUATE_RESULT
public static final int EVALUATE_RESULT- See Also:
-
CONTEXT_ITEM
public static final int CONTEXT_ITEM- See Also:
-
AXIS_STEP
public static final int AXIS_STEP- See Also:
-
OPTION
public static final int OPTION- See Also:
-
CHARACTER_MAP_EXPANSION
public static final int CHARACTER_MAP_EXPANSION- See Also:
-
FOR_MEMBER
public static final int FOR_MEMBER- See Also:
-
MATCH_PATTERN
public static final int MATCH_PATTERN- See Also:
-
MISC
public static final int MISC- See Also:
-
DYNAMIC_FUNCTION
public static final int DYNAMIC_FUNCTION- See Also:
-
-
Constructor Details
-
RoleDiagnostic
Create information about the role of a subexpression within its parent expression- Parameters:
kind
- the kind of parent expression, e.g. a function call or a variable referenceoperation
- the name of the object in the parent expression, e.g. a function name or instruction name. A QName is provided in display form, prefix:local. For a string, the special format element/attribute is recognized, for example xsl:for-each/select, to identify the role of an XPath expression in a stylesheet.operand
- Ordinal position of this subexpression, e.g. the position of an argument in a function call
-
RoleDiagnostic
-
-
Method Details
-
setErrorCode
Set the error code to be produced if a type error is detected- Parameters:
code
- The error code
-
getErrorCode
Get the error code to be produced if a type error is detected- Returns:
- code The error code
-
isTypeError
public boolean isTypeError()Ask whether the error code represents a type error- Returns:
- true if the error is treated as a type error
-
getMessage
Construct and return the error message indicating a type error- Returns:
- the constructed error message
-
composeRequiredMessage
Construct the part of the message giving the required item type- Parameters:
requiredItemType
- the item type required by the context of a particular expression- Returns:
- a message of the form "Required item type of X is Y"
-
composeErrorMessage
Construct a full error message- Parameters:
requiredItemType
- the item type required by the context of a particular expressionsuppliedItemType
- the item type inferred by static analysis of an expression- Returns:
- a message of the form "Required item type of A is R; supplied value has item type S"
-
composeErrorMessage
Construct a full error message, containing the supplied expression (for use when the error is reported statically)- Parameters:
requiredItemType
- the item type required by the context of a particular expressionsupplied
- the supplied expressionth
- the type hierarchy- Returns:
- a message of the form "Required item type of A is R; supplied value has item type S"
-
composeErrorMessage
Construct a full error message, displaying the item in error (suitable for use when a type error is reported dynamically)- Parameters:
requiredItemType
- the item type required by the context of a particular expressionitem
- the actual item in error. Must NOT be null (unlike earlier releases).th
- the type hierarchy- Returns:
- a message of the form "Required item type of A is R; supplied value has item type S"
-
composeErrorMessage
Construct a full error message, in terms of UTypes- Parameters:
requiredItemType
- the item type required by the context of a particular expressionsuppliedItemType
- the item type inferred by static analysis of an expression- Returns:
- a message of the form "Required item type of A is R; supplied value has item type S"
-
save
Save as a string, for use when serializing the expression tree- Returns:
- a string representation of the object
-
reconstruct
Reconstruct from a saved string- Parameters:
in
- the saved string representation of the RoleDiagnostic- Returns:
- the RoleDiagnostic
-
ordinal
Get the ordinal representation of a number (used to identify which argument of a function is in error)- Parameters:
n
- the cardinal number- Returns:
- the ordinal representation
-