Interface ValidationService
-
- All Known Implementing Classes:
ValidationServiceImpl
public interface ValidationService
Generic EMF validation service which allows validation of a collection ofEObject
s honoring defined EValidators. Additionally customValidator
s can be registered i.e. if the feature set of the EValidators is insufficient.- Author:
- Mat Hansen
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description void
addDiagnosticFilter(DiagnosticFilter diagnosticFilter)
Adds aDiagnosticFilter
to remove specificDiagnostic
from the result of a validation.void
addObjectFilter(ObjectFilter objectFilter)
Adds anObjectFilter
to skip specific EObjects during the validation.void
addSubTreeFilter(SubTreeFilter subTreeFilter)
Adds aSubTreeFilter
to skip specific sub trees during the validation.void
addValidator(Validator validator)
Adds a validation provider to the list of known validators.void
cancel()
Allows to cancel the current validation run (if any).boolean
isBusy()
Returns true as long as a validation is in process.<Filter extends ValidationFilter>
voidregisterValidationFilter(Filter filter)
Deprecated.Use addSubTreeFilter, addObjectFilter and addDiagnosticFilter insteadvoid
registerValidationResultListener(ValidationResultListener listener)
Registers aValidationResultListener
.void
removeDiagnosticFilter(DiagnosticFilter diagnosticFilter)
Removes aDiagnosticFilter
.void
removeObjectFilter(ObjectFilter objectFilter)
Removes anObjectFilter
.void
removeSubTreeFilter(SubTreeFilter subTreeFilter)
Removes aSubTreeFilter
.void
removeValidator(Validator validator)
Removes a validation provider from the list of known validators.void
setSubstitutionLabelProvider(org.eclipse.emf.ecore.EValidator.SubstitutionLabelProvider substitutionLabelProvider)
Set aEValidator.SubstitutionLabelProvider
to be used for substituting labels inDiagnostic
s.<Filter extends ValidationFilter>
voidunregisterValidationFilter(Filter filter)
Deprecated.Use removeSubTreeFilter, removeObjectFilter and removeDiagnosticFilter insteadvoid
unregisterValidationResultListener(ValidationResultListener listener)
Unregisters aValidationResultListener
.java.util.Set<org.eclipse.emf.common.util.Diagnostic>
validate(java.util.Iterator<org.eclipse.emf.ecore.EObject> eObjects)
Uses the given iterator to validate all eObjects in a collection.org.eclipse.emf.common.util.Diagnostic
validate(org.eclipse.emf.ecore.EObject eObject)
Validates the given eObject.
-
-
-
Method Detail
-
addValidator
void addValidator(Validator validator)
Adds a validation provider to the list of known validators.- Parameters:
validator
- theValidator
to add
-
removeValidator
void removeValidator(Validator validator)
Removes a validation provider from the list of known validators.- Parameters:
validator
- theValidator
to remove
-
registerValidationFilter
@Deprecated <Filter extends ValidationFilter> void registerValidationFilter(Filter filter)
Deprecated.Use addSubTreeFilter, addObjectFilter and addDiagnosticFilter insteadRegisters a validation filter.- Type Parameters:
Filter
- anValidationFilter
implementation- Parameters:
filter
- theValidationFilter
to register
-
unregisterValidationFilter
@Deprecated <Filter extends ValidationFilter> void unregisterValidationFilter(Filter filter)
Deprecated.Use removeSubTreeFilter, removeObjectFilter and removeDiagnosticFilter insteadUnregisters a validation filter.- Type Parameters:
Filter
- anValidationFilter
implementation- Parameters:
filter
- theValidationFilter
to unregister
-
registerValidationResultListener
void registerValidationResultListener(ValidationResultListener listener)
Registers aValidationResultListener
.- Parameters:
listener
- theValidationResultListener
to register
-
unregisterValidationResultListener
void unregisterValidationResultListener(ValidationResultListener listener)
Unregisters aValidationResultListener
.- Parameters:
listener
- theValidationResultListener
to unregister
-
setSubstitutionLabelProvider
void setSubstitutionLabelProvider(org.eclipse.emf.ecore.EValidator.SubstitutionLabelProvider substitutionLabelProvider)
Set aEValidator.SubstitutionLabelProvider
to be used for substituting labels inDiagnostic
s.- Parameters:
substitutionLabelProvider
- theEValidator.SubstitutionLabelProvider
to be set for this service- See Also:
EValidator.SubstitutionLabelProvider
-
validate
org.eclipse.emf.common.util.Diagnostic validate(org.eclipse.emf.ecore.EObject eObject)
Validates the given eObject.- Parameters:
eObject
- the eObject to validate- Returns:
- the resulting
Diagnostic
, or null if the eObject is filtered by aValidationFilter
-
validate
java.util.Set<org.eclipse.emf.common.util.Diagnostic> validate(java.util.Iterator<org.eclipse.emf.ecore.EObject> eObjects) throws ValidationCanceledException
Uses the given iterator to validate all eObjects in a collection.- Parameters:
eObjects
- the list to validate- Returns:
- the resulting set of
Diagnostic
s - Throws:
ValidationCanceledException
- in casecancel()
has been called
-
isBusy
boolean isBusy()
Returns true as long as a validation is in process. Not applicable for single validation runs withvalidate(EObject)
. Seecancel()
to interrupt a running validation process.- Returns:
- true as long as a validation is running, false otherwise.
-
cancel
void cancel()
Allows to cancel the current validation run (if any). Not applicable for single validation runs withvalidate(EObject)
.
-
addSubTreeFilter
void addSubTreeFilter(SubTreeFilter subTreeFilter)
Adds aSubTreeFilter
to skip specific sub trees during the validation.null
is ignored.- Parameters:
subTreeFilter
-SubTreeFilter
-
addObjectFilter
void addObjectFilter(ObjectFilter objectFilter)
Adds anObjectFilter
to skip specific EObjects during the validation.null
is ignored.- Parameters:
objectFilter
-ObjectFilter
-
addDiagnosticFilter
void addDiagnosticFilter(DiagnosticFilter diagnosticFilter)
Adds aDiagnosticFilter
to remove specificDiagnostic
from the result of a validation.null
is ignored.- Parameters:
diagnosticFilter
-DiagnosticFilter
-
removeSubTreeFilter
void removeSubTreeFilter(SubTreeFilter subTreeFilter)
Removes aSubTreeFilter
.- Parameters:
subTreeFilter
-SubTreeFilter
-
removeObjectFilter
void removeObjectFilter(ObjectFilter objectFilter)
Removes anObjectFilter
.- Parameters:
objectFilter
-ObjectFilter
-
removeDiagnosticFilter
void removeDiagnosticFilter(DiagnosticFilter diagnosticFilter)
Removes aDiagnosticFilter
.- Parameters:
diagnosticFilter
-DiagnosticFilter
-
-