alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

What this is

This file is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Other links

The source code

// $Id: CrNavFromInterface.java,v 1.12 2004/09/21 19:03:26 mvw Exp $
// Copyright (c) 1996-2004 The Regents of the University of California. All
// Rights Reserved. Permission to use, copy, modify, and distribute this
// software and its documentation without fee, and without a written
// agreement is hereby granted, provided that the above copyright notice
// and this paragraph appear in all copies.  This software program and
// documentation are copyrighted by The Regents of the University of
// California. The software program and documentation are supplied "AS
// IS", without any accompanying services from The Regents. The Regents
// does not warrant that the operation of the program will be
// uninterrupted or error-free. The end-user understands that the program
// was developed for research purposes and is advised not to rely
// exclusively on the program for any reason.  IN NO EVENT SHALL THE
// UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
// SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS,
// ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF
// THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF
// SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY
// WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE
// PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
// CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT,
// UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

// File: CrNavFromInterface.java
// Classes: CrNavFromInterface.java

package org.argouml.uml.cognitive.critics;

import java.util.Iterator;
import org.argouml.cognitive.Designer;
import org.argouml.cognitive.critics.Critic;
import org.argouml.model.ModelFacade;


// Use Model through ModelFacade

/**
 * A critic to detect navigation from an Interface to a Class in an
 * Association.  This is not permitted in UML, since it would require
 * the Interface to hold state to represent the association
 * reference.

* * The critic will trigger whenever an association between an * interface and a class is navigable from the interface.

* * @see * ArgoUML User Manual: N * @author jrobbins@ics.uci.edu */ public class CrNavFromInterface extends CrUML { /** * Constructor for the critic.

* * Sets up the resource name, which will allow headline and description * to found for the current locale (replaces deprecated setHeadline and sd * methods). Provides a design issue category (RELATIONSHIPS) and knowledge * type (SYNTAX). Adds trigger "end_navigable".

*/ public CrNavFromInterface() { // Set the resource label, which will get the headline and description // appropriate for the locale setResource("CrNavFromInterface"); // Specify design issue category and knowledge type addSupportedDecision(CrUML.DEC_RELATIONSHIPS); setKnowledgeTypes(Critic.KT_SYNTAX); // This may not actually make any difference at present (the code // behind addTrigger needs more work). addTrigger("end_navigable"); } /** * The trigger for the critic.

* * Applies to Associations only, not AssociationRoles. The reason is * that an AssociationRole cannot have greater navigability than the * Association it specializes, so if the critic has addressed the * Association, the AssociationRole will effectively be addressed. There * may of course be a need for a critic to check that Association Roles do * match their parents in this respect!

* * As a consequence, we also don't need to check for associations with * ClassifierRoles.

* * Iterate over all the AssociationEnds. We only have a problem if:

*

    *
  1. There is an end connected to an Interface; and *
  2. An end other than that end is navigable. *
* * @param dm the object to be checked against the critic * @param dsgr the designer creating the model. Not used, this is for * future development of ArgoUML * @return {@link #PROBLEM_FOUND PROBLEM_FOUND} if the critic is * triggered, otherwise {@link #NO_PROBLEM NO_PROBLEM}. */ public boolean predicate2(Object dm, Designer dsgr) { // Only look at Associations if (!(ModelFacade.isAAssociation(dm))) { return NO_PROBLEM; } if (ModelFacade.isAAssociationRole(dm)) { return NO_PROBLEM; } // Iterate over all the AssociationEnds. We only have a problem if 1) // there is an end connected to an Interface and 2) an end other than // that end is navigable. Iterator assocEnds = ModelFacade.getConnections(dm).iterator(); boolean haveInterfaceEnd = false; // End at an Interface? boolean otherEndNavigable = false; // Navigable other end? while (assocEnds.hasNext()) { // The next AssociationEnd Object ae = assocEnds.next(); // If its an interface we have an interface end, otherwise its // something else and we should see if it is navigable. We don't // check that the end is a Classifier, rather than its child // ClassifierRole, since we have effectively eliminated that // possiblity in rejecting AssociationRoles above. Object type = ModelFacade.getType(ae); if (ModelFacade.isAInterface(type)) { haveInterfaceEnd = true; } else if (ModelFacade.isNavigable(ae)) { otherEndNavigable = true; } // We can give up looking if we've hit both criteria if (haveInterfaceEnd && otherEndNavigable) { return PROBLEM_FOUND; } } // If we drop out we didn't meet both criteria, and all is well. return NO_PROBLEM; } } /* end class CrNavFromInterface */
... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2024 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.