Coverage Report - org.as3coreaddendum.system.comparators.PriorityIndexComparator
 
Classes in this File Line Coverage Branch Coverage Complexity
PriorityIndexComparator
100%
15/15
N/A
0
 
 1  
 /*
 2  
  * Licensed under the MIT License
 3  
  * 
 4  
  * Copyright 2010 (c) Flávio Silva, http://flsilva.com
 5  
  *
 6  
  * Permission is hereby granted, free of charge, to any person
 7  
  * obtaining a copy of this software and associated documentation
 8  
  * files (the "Software"), to deal in the Software without
 9  
  * restriction, including without limitation the rights to use,
 10  
  * copy, modify, merge, publish, distribute, sublicense, and/or sell
 11  
  * copies of the Software, and to permit persons to whom the
 12  
  * Software is furnished to do so, subject to the following
 13  
  * conditions:
 14  
  *
 15  
  * The above copyright notice and this permission notice shall be
 16  
  * included in all copies or substantial portions of the Software.
 17  
  *
 18  
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 19  
  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
 20  
  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 21  
  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 22  
  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
 23  
  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 24  
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 25  
  * OTHER DEALINGS IN THE SOFTWARE.
 26  
  * 
 27  
  * http://www.opensource.org/licenses/mit-license.php
 28  
  */
 29  
 
 30  1
 package org.as3coreaddendum.system.comparators {
 31  
         import org.as3coreaddendum.system.IComparator;
 32  
         import org.as3coreaddendum.system.IIndexable;
 33  
         import org.as3coreaddendum.system.IPriority;
 34  
 
 35  
         /**
 36  
          * A comparator for objects that implements the <code>org.as3coreaddendum.system.IPriority</code> and <code>org.as3coreaddendum.system.IIndexable</code> interfaces, comparing the <code>priority</code> and <code>index</code> properties.
 37  
          * <p>This comparator is util when you want to sort the objects by priority, but if the priority of the two objects are equal, the <code>index</code> property of the objects are compared to decide wich object comes before.</p>
 38  
          * 
 39  
          * @see org.as3coreaddendum.system.IComparator IComparator
 40  
          * @see org.as3coreaddendum.system.IIndexable IIndexable
 41  
          * @see org.as3coreaddendum.system.IPriority IPriority
 42  
          * @author Flávio Silva
 43  
          */
 44  
         public class PriorityIndexComparator implements IComparator
 45  
         {
 46  
                 private var _numberComparator: NumberComparator;
 47  
 
 48  
                 /**
 49  
                  * Constructor, creates a new <code>PriorityIndexComparator</code> object.
 50  
                  */
 51  
                 public function PriorityIndexComparator()
 52  1
                 {
 53  1
                         _numberComparator = new NumberComparator();
 54  1
                 }
 55  
 
 56  
                 /**
 57  
                  * Performs the comparison between the two arguments.
 58  
                  * 
 59  
                  * @param         o1        The first <code>Number</code> object to be compared.
 60  
                  * @param         o2        The second <code>Number</code> object to be compared.
 61  
                  * @throws         ArgumentError         if any of the arguments does not implements the <code>IPriority</code> or <code>IIndexable</code> interfaces.
 62  
                  * @return         A negative integer or a positive integer as the priority of the first argument is greater than or less than the second. If the priority of the arguments are equal, returns a negative integer, zero, or a positive integer as the index of the first argument is less than, equal to, or greater than the second.
 63  
                  */
 64  
                 public function compare(o1:*, o2:*): int
 65  
                 {
 66  1
                         if (!(o1 is IPriority) || !(o2 is IPriority)) throw new ArgumentError("Both arguments must implement the 'IPriority' interface.");
 67  1
                         if (!(o1 is IIndexable) || !(o2 is IIndexable)) throw new ArgumentError("Both arguments must implement the 'IIndexable' interface.");
 68  
                         
 69  1
                         var p1:int = (o1 as IPriority).priority;
 70  1
                         var p2:int = (o2 as IPriority).priority;
 71  
                         
 72  1
                         if (p1 > p2)
 73  
                         {
 74  1
                                 return -1;
 75  
                         }
 76  1
                         else if (p1 < p2)
 77  
                         {
 78  1
                                 return 1;
 79  
                         }
 80  
                         else
 81  
                         {
 82  1
                                 var i1:int = (o1 as IIndexable).index;
 83  1
                                 var i2:int = (o2 as IIndexable).index;
 84  
                                 
 85  1
                                 return _numberComparator.compare(i1, i2);
 86  
                         }
 87  
                 }
 88  
 
 89  
         }
 90  
 
 91  
 }