Package org.apache.jena.iri
Class Violation
- java.lang.Object
-
- org.apache.jena.iri.Violation
-
- All Implemented Interfaces:
IRIComponents,ViolationCodes
- Direct Known Subclasses:
ViolationImpl
public abstract class Violation extends java.lang.Object implements ViolationCodes, IRIComponents
Information concerning a violation of some specification concerning IRIs. This may be wrapped in anIRIExceptionand thrown, or may be returned byIRI.violations(boolean). Which conditions result in errors and warnings depends on the setting of the relatedIRIFactory.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.apache.jena.iri.ViolationCodes
ViolationCodes.Initialize
-
-
Field Summary
-
Fields inherited from interface org.apache.jena.iri.IRIComponents
AUTHORITY, FRAGMENT, HOST, PATH, PATHQUERY, PORT, QUERY, SCHEME, USER
-
Fields inherited from interface org.apache.jena.iri.ViolationCodes
ACE_PREFIX, BAD_BIDI_SUBCOMPONENT, BAD_DOT_IN_IDN, BAD_IDN, BAD_IDN_UNASSIGNED_CHARS, BIDI_FORMATTING_CHARACTER, COMPATIBILITY_CHARACTER, CONTROL_CHARACTER, DEFAULT_PORT_SHOULD_BE_OMITTED, DEPRECATED_UNICODE_CHARACTER, DISCOURAGED_IRI_CHARACTER, DISCOURAGED_XML_CHARACTER, DNS_LABEL_DASH_START_OR_END, DNS_LABEL_LENGTH_LIMIT, DNS_LENGTH_LIMIT, DOUBLE_DASH_IN_REG_NAME, DOUBLE_WHITESPACE, EMPTY_SCHEME, HAS_PASSWORD, ILLEGAL_CHARACTER, ILLEGAL_PERCENT_ENCODING, IP_V4_OCTET_RANGE, IP_V6_OR_FUTURE_ADDRESS_SYNTAX, IPv6ADDRESS_SHOULD_BE_LOWERCASE, LONE_SURROGATE, LOWERCASE_PREFERRED, MAYBE_NOT_NFC, MAYBE_NOT_NFKC, NON_INITIAL_DOT_SEGMENT, NON_URI_CHARACTER, NON_XML_CHARACTER, NOT_DNS_NAME, NOT_NFC, NOT_NFKC, NOT_UTF8_ESCAPE, NOT_UTF8_ESCAPE_IN_HOST, NOT_XML_SCHEMA_WHITESPACE, PERCENT, PERCENT_20, PERCENT_ENCODING_SHOULD_BE_UPPERCASE, PORT_SHOULD_NOT_BE_EMPTY, PORT_SHOULD_NOT_BE_WELL_KNOWN, PORT_SHOULD_NOT_START_IN_ZERO, PRIVATE_USE_CHARACTER, PROHIBITED_COMPONENT_PRESENT, QUERY_IN_LEGACY_SCHEME, REQUIRED_COMPONENT_MISSING, SCHEME_INCLUDES_DASH, SCHEME_MUST_START_WITH_LETTER, SCHEME_PATTERN_MATCH_FAILED, SCHEME_PREFERS_LOWERCASE, SCHEME_REQUIRES_LOWERCASE, SUPERFLUOUS_ASCII_PERCENT_ENCODING, SUPERFLUOUS_NON_ASCII_PERCENT_ENCODING, UNASSIGNED_UNICODE_CHARACTER, UNDEFINED_UNICODE_CHARACTER, UNICODE_CONTROL_CHARACTER, UNICODE_WHITESPACE, UNREGISTERED_IANA_SCHEME, UNREGISTERED_NONIETF_SCHEME_TREE, UNWISE_CHARACTER, USE_PUNYCODE_NOT_PERCENTS, WHITESPACE
-
-
Constructor Summary
Constructors Constructor Description Violation()
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description abstract java.lang.StringcodeName()A string version of the code number, corresponding to the name of the java identifier.abstract java.lang.Stringcomponent()The name of the component in which the problem occurred.abstract intgetComponent()A value fromIRIComponentsindicating which component of the IRI is involved with this error.abstract IRIgetIRI()The IRI that triggered this condition.abstract java.lang.StringgetLongMessage()A long description of the error condition, typically including theabstract java.lang.StringgetShortMessage()A short description of the error condition.abstract java.lang.StringgetSpecificationURL()The URL of the section of the specification which has been violated.abstract intgetViolationCode()The value fromViolationCodescorresponding to this condition.abstract booleanisError()Using the settings of the factory associated with the IRI associated with this violation, is this condition intended as an error (or as a warning)?
-
-
-
Method Detail
-
getViolationCode
public abstract int getViolationCode()
The value fromViolationCodescorresponding to this condition.- Returns:
- An error code.
-
getIRI
public abstract IRI getIRI()
The IRI that triggered this condition. If an IRI has been constructed by resolving a relative reference against a base IRI then exceptions associated with that IRI will have the most informative value here, which can be any of the three IRIs involved (the base IRI, the relative IRI or the resolved IRI).- Returns:
- The IRI that triggered the error.
-
getComponent
public abstract int getComponent()
A value fromIRIComponentsindicating which component of the IRI is involved with this error.- Returns:
- A code indicating the IRI component in which the error occurred.
-
codeName
public abstract java.lang.String codeName()
A string version of the code number, corresponding to the name of the java identifier.- Returns:
- The name of the java identifier of the error code for this error.
-
getShortMessage
public abstract java.lang.String getShortMessage()
A short description of the error condition. (Short is in comparison withgetLongMessage(), not an absolute value).- Returns:
- The error message.
-
getLongMessage
public abstract java.lang.String getLongMessage()
A long description of the error condition, typically including the- Returns:
- The error message.
-
getSpecificationURL
public abstract java.lang.String getSpecificationURL()
The URL of the section of the specification which has been violated.- Returns:
- The error message.
-
isError
public abstract boolean isError()
Using the settings of the factory associated with the IRI associated with this violation, is this condition intended as an error (or as a warning)?- Returns:
- true if this condition is an error, false if it is a warning.
-
component
public abstract java.lang.String component()
The name of the component in which the problem occurred.- Returns:
- A component name.
-
-