Package com.e1c.g5.v8.dt.bsl.check

Class DocumentationCommentBasicDelegateCheck

java.lang.Object

com.e1c.g5.v8.dt.check.components.BasicCheck

com.e1c.g5.v8.dt.bsl.check.DocumentationCommentBasicDelegateCheck

All Implemented Interfaces:

ITopObjectFilter, ICheck

public abstract class DocumentationCommentBasicDelegateCheck
extends BasicCheck

Basic documentation comment check. Delelopers should use it to perform easier validations of documenting comments

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	DocumentationCommentBasicDelegateCheck.DocumentationCommentResultAcceptor	Accepts results of the check in form of Issue's.

Nested classes/interfaces inherited from class com.e1c.g5.v8.dt.check.components.BasicCheck

BasicCheck.CheckConfigurer, BasicCheck.CheckParameterBuilder, BasicCheck.ContainmentConfigurationBuilder, BasicCheck.DelegateCheckConfigurationBuilder, BasicCheck.ModuleConfigurationBuilder, BasicCheck.ResultAcceptor, BasicCheck.TopObjectConfigurationBuilder, BasicCheck.TopObjectFeatureConfigurationBuilder

Field Summary

Fields

Modifier and Type	Field	Description
protected final IBmModelManager	bmModelManager	BM manager service.
protected final INamingService	namingService	The naming service.
protected final IResourceLookup	resourceLookup	The resource lookup service.
protected final IV8ProjectManager	v8ProjectManager	IV8ProjectManager for getting IV8Project by EObject

Constructor Summary

Constructors

Constructor	Description
DocumentationCommentBasicDelegateCheck(IResourceLookup resourceLookup, INamingService namingService, IBmModelManager bmModelManager, IV8ProjectManager v8ProjectManager)	Constructor

Method Summary

Modifier and Type	Method	Description
protected final void	check(Object object, BasicCheck.ResultAcceptor resultAcceptor, ICheckParameters parameters, org.eclipse.core.runtime.IProgressMonitor progressMonitor)	The method that performs the check.
protected abstract void	checkDocumentationCommentObject(IDescriptionPart descriptionPart, BslDocumentationComment rootNode, DocumentationCommentBasicDelegateCheck.DocumentationCommentResultAcceptor resultAceptor, ICheckParameters parameters, BmOperationContext typeComputationContext, org.eclipse.core.runtime.IProgressMonitor progressMonitor)	Checks the documentation comment model object.

Methods inherited from class com.e1c.g5.v8.dt.check.components.BasicCheck

check, check, configureCheck, configureContextCollector, isCheckApplicable, postConfigureContextCollector

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.e1c.g5.v8.dt.check.ICheck

check, getCheckId, prepareContext, prepareContext

Field Details

resourceLookup

protected final IResourceLookup resourceLookup

The resource lookup service.

namingService

protected final INamingService namingService

The naming service.

bmModelManager

protected final IBmModelManager bmModelManager

BM manager service.

v8ProjectManager

protected final IV8ProjectManager v8ProjectManager

IV8ProjectManager for getting IV8Project by EObject

Constructor Details

DocumentationCommentBasicDelegateCheck

public DocumentationCommentBasicDelegateCheck(IResourceLookup resourceLookup,
 INamingService namingService,
 IBmModelManager bmModelManager,
 IV8ProjectManager v8ProjectManager)

Constructor

Parameters:

resourceLookup - service for look up workspace resources, see IResourceLookup, cannot be null

namingService - service for getting names of EDT object and resources, cannot be null

bmModelManager - service for getting instance of Bm Model by EObject, cannot be null

v8ProjectManager - IV8ProjectManager for getting IV8Project by EObject, cannot be null

Method Details

check

protected final void check(Object object,
 BasicCheck.ResultAcceptor resultAcceptor,
 ICheckParameters parameters,
 org.eclipse.core.runtime.IProgressMonitor progressMonitor)

Description copied from class: BasicCheck

The method that performs the check. Check results (issues) need to be placed into the result acceptor. Validation may be cancelled by a user. Complex implemantations should take this into the account and check IProgressMonitor.isCanceled() periodically during long-running operations.

Overrides:

check in class BasicCheck

Parameters:

object - The object to check, not null

resultAcceptor - Result acceptor, not null

parameters - The set of check execution parameters taken from check settings, not null

progressMonitor - Current check progress monitor, not null

checkDocumentationCommentObject

protected abstract void checkDocumentationCommentObject(IDescriptionPart descriptionPart,
 BslDocumentationComment rootNode,
 DocumentationCommentBasicDelegateCheck.DocumentationCommentResultAcceptor resultAceptor,
 ICheckParameters parameters,
 BmOperationContext typeComputationContext,
 org.eclipse.core.runtime.IProgressMonitor progressMonitor)

Checks the documentation comment model object. Check developers should implement their main check logic by overriding this method

Parameters:

descriptionPart - The checked part of the documentation comment model. May not be null

rootNode - The root node of the documentation comment model. May not be null

resultAceptor - The check's result acceptor. May not be null

parameters - The accessor of the check's parameters. May not be null

progressMonitor - The progress monitor. It should be checked for the canceling in case of the long/complex checks. May not be null