Critic (ArgoUML Javadoc for ArgoUML Module Developers)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.argouml.cognitive
Class Critic

java.lang.Object
  java.util.Observable
      org.argouml.cognitive.Critic

All Implemented Interfaces:: java.io.Serializable, Poster

Direct Known Subclasses:: CompoundCritic

public class Critic
extends java.util.Observable
implements Poster, java.io.Serializable
extends java.util.Observable
implements Poster, java.io.Serializable

"Abstract" base class for design critics. Each subclass should define its own predicate method and define its own relevance tags.

A critic supports design goals and decisions, which can be adjusted accordingly. It will post todo items which may or may not be relevant to the particular designer.

Steps to follow when adding a critic are listed in the Argo cookbook under define_critic.

See Also:: Serialized Form

Field Summary
`static javax.swing.Icon`	`DEFAULT_CLARIFIER` The icon representing the resource.
`static java.lang.String`	`KT_COMPLETENESS` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_CONSISTENCY` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_CORRECTNESS` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_DESIGNERS` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_EXPERIENCIAL` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_OPTIMIZATION` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_ORGANIZATIONAL` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_PRESENTATION` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_SEMANTICS` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_SYNTAX` Type of knowledge that critics can deliver.
`static java.lang.String`	`KT_TOOL` Type of knowledge that critics can deliver.
`static boolean`	`NO_PROBLEM` NO_PROBLEM is used for the result of the check of a critic.
`static boolean`	`PROBLEM_FOUND` PROBLEM_FOUND is used for the result of the check of a critic.

Constructor Summary
`Critic()` Construct a new critic instance.

Method Summary
`java.lang.Object`	`addControlRec(java.lang.String name, java.lang.Object controlData)` Add some attribute used by ControlMech to determine if this Critic should be active.
`void`	`addKnowledgeType(java.lang.String type)`
`void`	`addSupportedDecision(Decision d)`
`void`	`addSupportedGoal(Goal g)`
`void`	`addTrigger(java.lang.String s)`
`void`	`beActive()` Make this critic active.
`void`	`beInactive()` Make this critic inactive.
`boolean`	`canFixIt(ToDoItem item)`
`boolean`	`containsKnowledgeType(java.lang.String type)`
`void`	`critique(java.lang.Object dm, Designer dsgr)` Examine the given Object and Designer and, if appropriate, produce one or more ToDoItem's and add them to the offending design material's and the Designer's ToDoList.
`java.lang.String`	`defaultMoreInfoURL()` This function calculates the default URL to describe this critic.
`java.lang.String`	`expand(java.lang.String desc, ListSet offs)` Customize the description string just before it is displayed.
`void`	`fixIt(ToDoItem item, java.lang.Object arg)` TODO: Not implemented yet.
`javax.swing.Icon`	`getClarifier()`
`java.lang.Object`	`getControlRec(java.lang.String name)` Reply the named control record, or null if not defined.
`java.lang.String`	`getCriticCategory()` Returns a default critic category.
`java.util.Set<java.lang.Object>`	`getCriticizedDesignMaterials()` Get the design materials to be criticized by this critic
`org.argouml.configuration.ConfigurationKey`	`getCriticKey()` Returns the `ConfigurationKey` that the critic uses to determine if it is enabled or disabled.
`java.lang.String`	`getCriticName()` Returns a default critic name.
`java.lang.String`	`getCriticType()` Reply a string used to contol critics according to type.
`java.lang.String`	`getDecisionCategory()` Reply a string used to determine if this critic would be relevant to current design decisions.
`java.lang.String`	`getDescription(ListSet offenders, Designer dsgr)` Reply the description used in feedback produced by this Critic.
`java.lang.String`	`getDescriptionTemplate()`
`java.lang.String`	`getHeadline()` Reply the headline used in feedback produced by this Critic.
`java.lang.String`	`getHeadline(ListSet offenders, Designer dsgr)` Reply the headline used in feedback produced by this Critic.
`java.lang.String`	`getHeadline(java.lang.Object dm, Designer dsgr)` Reply the headline used in feedback produced by this Critic.
`ListSet<java.lang.String>`	`getKnowledgeTypes()`
`java.lang.String`	`getMoreInfoURL()`
`java.lang.String`	`getMoreInfoURL(ListSet offenders, Designer dsgr)` Reply the moreInfoURL used in feedback produced by this Critic.
`int`	`getPriority()`
`int`	`getPriority(ListSet offenders, Designer dsgr)` Reply the priority used in feedback produced by this Critic.
`java.util.List<Decision>`	`getSupportedDecisions()`
`java.util.List<Goal>`	`getSupportedGoals()`
`long`	`getTriggerMask()`
`java.lang.Class`	`getWizardClass(ToDoItem item)` Return the Class of wizard that can fix the problem identifed by this critic.
`void`	`initWizard(org.argouml.cognitive.critics.Wizard w)` Initialize a newly created wizard with information found by the critic.
`boolean`	`isActive()` Reply true iff this Critic can execute.
`boolean`	`isEnabled()` This is a convient method for accessing one well-known control record.
`boolean`	`isRelevantToDecisions(Designer dsgr)` Reply true if this Critic is relevant to the decisions that the Designer is considering.
`boolean`	`isRelevantToGoals(Designer dsgr)` Reply true iff this Critic is relevant to the goals that the Designer is trying to achieve.
`boolean`	`isSnoozed()` Checks if the critic is currently snoozed.
`org.argouml.cognitive.critics.Wizard`	`makeWizard(ToDoItem item)` Create a new Wizard to help the user fix the identified problem.
`boolean`	`matchReason(long patternCode)`
`void`	`postItem(ToDoItem item, java.lang.Object dm, Designer dsgr)`
`boolean`	`predicate(java.lang.Object dm, Designer dsgr)` Perform the Critic's analysis of the design.
`static int`	`reasonCodeFor(java.lang.String s)`
`protected void`	`setDecisionCategory(java.lang.String c)` Set the decisionCategory, usually done in the constructor.
`void`	`setDescription(java.lang.String d)`
`void`	`setEnabled(boolean e)`
`void`	`setHeadline(java.lang.String h)` Set the headline used in feedback produced by this Critic.
`void`	`setKnowledgeTypes(ListSet<java.lang.String> kt)`
`void`	`setKnowledgeTypes(java.lang.String t1)` Reset all knowledgetypes, and add the given one.
`void`	`setKnowledgeTypes(java.lang.String t1, java.lang.String t2)` Reset all knowledgetypes, and add the given ones.
`void`	`setKnowledgeTypes(java.lang.String t1, java.lang.String t2, java.lang.String t3)` Reset all knowledgetypes, and add the given ones.
`void`	`setMoreInfoURL(java.lang.String m)`
`void`	`setPriority(int p)`
`void`	`snooze()` Disable this Critic for the next few minutes.
`org.argouml.cognitive.critics.SnoozeOrder`	`snoozeOrder()` Reply the SnoozeOrder that is defined for this critic.
`boolean`	`stillValid(ToDoItem i, Designer dsgr)` Return true iff the given ToDoItem is still valid and should be kept in the given designers ToDoList.
`boolean`	`supports(Decision d)`
`boolean`	`supports(Goal g)`
`ToDoItem`	`toDoItem(java.lang.Object dm, Designer dsgr)` Reply the ToDoItem that the designer should see iff predicate() returns true.
`java.lang.String`	`toString()`
`void`	`unsnooze()` Lift any previous SnoozeOrder.

Methods inherited from class java.util.Observable
`addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

PROBLEM_FOUND

public static final boolean PROBLEM_FOUND

PROBLEM_FOUND is used for the result of the check of a critic.

See Also:: Constant Field Values

NO_PROBLEM

public static final boolean NO_PROBLEM

NO_PROBLEM is used for the result of the check of a critic.

See Also:: Constant Field Values