svn commit: r12795 - trunk/src/model/src/org/argouml/model

Author: tfmorris
Date: 2007-06-08 12:31:10-0700
New Revision: 12795

Modified:
   trunk/src/model/src/org/argouml/model/Facade.java
   trunk/src/model/src/org/argouml/model/UseCasesFactory.java
   trunk/src/model/src/org/argouml/model/UseCasesHelper.java

Log:
Deprecate UseCaseInstance and getExtendingUseCases()

Modified: trunk/src/model/src/org/argouml/model/Facade.java
Url: http://argouml.tigris.org/source/browse/argouml/trunk/src/model/src/org/argouml/model/Facade.java?view=diff&rev=12795&p1=trunk/src/model/src/org/argouml/model/Facade.java&p2=trunk/src/model/src/org/argouml/model/Facade.java&r1=12794&r2=12795
==============================================================================
--- trunk/src/model/src/org/argouml/model/Facade.java	(original)
+++ trunk/src/model/src/org/argouml/model/Facade.java	2007-06-08 12:31:10-0700
@@ -1137,6 +1137,8 @@
      *
      * @param handle candidate
      * @return true if handle is a UseCaseInstance
+     * @deprecated for 0.25.4 by tfmorris. UseCaseInstances have been removed
+     *             from UML 2.x.
      */
     boolean isAUseCaseInstance(Object handle);
     
@@ -1780,12 +1782,12 @@
     Object getExtensionPoint(Object handle, int index);
 
     /**
-     * Return all Extends of a UseCase or Extend.
+     * Return all ExtensionPoints of a UseCase or Extend.
      * 
      * @param handle
      *            the UseCase or the Extend
-     * @return the Collection of Extends. If the argument was an Extend, the
-     *         Collection is ordered, ie a List.
+     * @return the Collection of ExtensionPoints. If the argument was an Extend,
+     *         the Collection is ordered, ie a List.
      */
     Collection getExtensionPoints(Object handle);
 

Modified: trunk/src/model/src/org/argouml/model/UseCasesFactory.java
Url: http://argouml.tigris.org/source/browse/argouml/trunk/src/model/src/org/argouml/model/UseCasesFactory.java?view=diff&rev=12795&p1=trunk/src/model/src/org/argouml/model/UseCasesFactory.java&p2=trunk/src/model/src/org/argouml/model/UseCasesFactory.java&r1=12794&r2=12795
==============================================================================
--- trunk/src/model/src/org/argouml/model/UseCasesFactory.java	(original)
+++ trunk/src/model/src/org/argouml/model/UseCasesFactory.java	2007-06-08 12:31:10-0700
@@ -66,8 +66,11 @@
 
     /**
      * Create an empty but initialized instance of a UseCaseInstance.
-     *
+     * 
      * @return an initialized UseCaseInstance instance.
+     * @deprecated for 0.25.4 by tfmorris. UseCaseInstances have been removed
+     *             from UML 2.x. Use an InstanceSpecification with a UseCase as
+     *             its Classifier.
      */
     Object createUseCaseInstance();
 

Modified: trunk/src/model/src/org/argouml/model/UseCasesHelper.java
Url: http://argouml.tigris.org/source/browse/argouml/trunk/src/model/src/org/argouml/model/UseCasesHelper.java?view=diff&rev=12795&p1=trunk/src/model/src/org/argouml/model/UseCasesHelper.java&p2=trunk/src/model/src/org/argouml/model/UseCasesHelper.java&r1=12794&r2=12795
==============================================================================
--- trunk/src/model/src/org/argouml/model/UseCasesHelper.java	(original)
+++ trunk/src/model/src/org/argouml/model/UseCasesHelper.java	2007-06-08 12:31:10-0700
@@ -59,8 +59,16 @@
     Collection getExtendedUseCases(Object ausecase);
 
     /**
-     * @param usecase the given usecase
+     * Find all UseCases that extend this UseCase.
+     * <p>
+     * NOTE: The association is not navigable in this direction, so a brute
+     * force search will be used and it will only include models which are
+     * accessable, not any models which are potentially linked to this one.
+     * 
+     * @param usecase
+     *            the given usecase
      * @return Collection all usecases that extend the given usecase
+     * @deprecated for 0.25.4 by tfmorris
      */
     Collection getExtendingUseCases(Object usecase);