mlinkimpl.java

UML设计测试工具

/*
 * USE - UML based specification environment
 * Copyright (C) 1999-2004 Mark Richters, University of Bremen
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

/* $ProjectHeader: use 2-3-0-release.1 Mon, 12 Sep 2005 20:18:33 +0200 green $ */

package org.tzi.use.uml.sys;

import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.tzi.use.uml.mm.MAssociation;
import org.tzi.use.uml.mm.MAssociationEnd;
import org.tzi.use.util.StringUtil;

/**
 * A link is an instance of an association.
 *
 * @version     $ProjectVersion: 2-3-0-release.1 $
 * @author      Mark Richters 
 */

final class MLinkImpl implements MLink {
    private MAssociation fAssociation; // The type of this link

    /**
     * For each association end we store the corresponding link end.
     */
    private Map fLinkEnds;  // (aend : MAssociationEnd -> MLinkEnd)

    //      /**
    //       * Constructs a new binary link for the given association. 
    //       *
    //       * @exception MSystemException objects do not conform to the
    //       *            association end.
    //       * @see MSystemState#createBinaryLink */
    //      public MLinkImpl(MAssociation assoc,
    //           MAssociationEnd aend0, MObject obj0,
    //           MAssociationEnd aend1, MObject obj1) 
    //      throws MSystemException 
    //      {
    //      fAssociation = assoc;
    //      fLinkEnds = new HashMap();
    //      fLinkEnds.put(aend0, new MLinkEnd(aend0, obj0));
    //      fLinkEnds.put(aend1, new MLinkEnd(aend1, obj1));
    //      }

    /**
     * Creates a new link for the given association.
     *
     * @param objects List(MObject)
     * @exception MSystemException objects do not conform to the
     *            association ends.
     */
    MLinkImpl(MAssociation assoc, List objects) throws MSystemException {
        fAssociation = assoc;
        if (assoc.associationEnds().size() != objects.size() )
            throw new IllegalArgumentException("Number of association ends (" +
                                               assoc.associationEnds().size() +
                                               ") does not match number of passed objects (" +
                                               objects.size() + ")");
        fLinkEnds = new HashMap();
        Iterator it1 = assoc.associationEnds().iterator();
        Iterator it2 = objects.iterator();
        while (it1.hasNext() && it2.hasNext() ) {
            MAssociationEnd aend = (MAssociationEnd) it1.next();
            MObject obj = (MObject) it2.next();
            fLinkEnds.put(aend, new MLinkEnd(aend, obj));
        }
    }

    //      /** 
    //       * Returns the size (arity) of the link.
    //       */
    //      public int size() {
    //      return fLinkEnds.size();
    //      }

    //      /** 
    //       * Returns the name of the link. We use the name of the defining
    //       * association.  
    //       */
    //      public String name() {
    //      return fAssociation.name();
    //      }

    /**
     * Returns the association describing this link.
     */
    public MAssociation association() {
        return fAssociation;
    }

    /** 
     * Returns all link ends of this link.
     *
     * @return Set(MLinkEnd)
     */
    public Set linkEnds() {
        Set s = new HashSet(fLinkEnds.size());
        s.addAll(fLinkEnds.values());
        return s;
    }

    /**
     * Returns the set of objects participating in this link.
     *
     * @return Set(MObject).
     */
    public Set linkedObjects() {
        Set s = new HashSet();
        Iterator linkIter = fLinkEnds.values().iterator();
        while (linkIter.hasNext() ) {
            MLinkEnd lend = (MLinkEnd) linkIter.next();
            s.add(lend.object());
        }
        return s;
    }

    /** 
     * Returns the link end for the given association end.
     */
    public MLinkEnd linkEnd(MAssociationEnd aend) {
        return (MLinkEnd) fLinkEnds.get(aend);
    }

    public int hashCode() { 
        int hash = fAssociation.hashCode();
        Iterator it = fLinkEnds.values().iterator();
        while (it.hasNext() ) {
            MLinkEnd lend = (MLinkEnd) it.next();
            hash += lend.hashCode();
        }
        return hash;
    }

    /**
     * Two links are equal iff they connect the same objects.
     */
    public boolean equals(Object obj) { 
        if (obj == this )
            return true;
        if (obj instanceof MLink )
            return association().equals(((MLink) obj).association())
                && linkEnds().equals(((MLink) obj).linkEnds());
        return false;
    }

    public String toString() {
        return "[" + fAssociation.name() + " : (" +
            StringUtil.fmtSeq(fLinkEnds.values().iterator(), ", ") +
            ")]";
    }

}