Coverage Report

Coverage Report - org.as3collections.iterators.ReadOnlyListIterator

Classes in this File

Line Coverage

Branch Coverage

Complexity

ReadOnlyListIterator

100%

6/6

N/A

 ﻿/*
  * Licensed under the MIT License
  * 
  * Copyright 2010 (c) Flávio Silva, http://flsilva.com
  *
  * Permission is hereby granted, free of charge, to any person
  * obtaining a copy of this software and associated documentation
  * files (the "Software"), to deal in the Software without
  * restriction, including without limitation the rights to use,
  * copy, modify, merge, publish, distribute, sublicense, and/or sell
  * copies of the Software, and to permit persons to whom the
  * Software is furnished to do so, subject to the following
  * conditions:
  *
  * The above copyright notice and this permission notice shall be
  * included in all copies or substantial portions of the Software.
  *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  * OTHER DEALINGS IN THE SOFTWARE.
  * 
  * http://www.opensource.org/licenses/mit-license.php
  */
 
 package org.as3collections.iterators {
         import org.as3collections.IList;
         import org.as3coreaddendum.errors.UnsupportedOperationError;
         import org.as3utils.ReflectionUtil;
 
         /**
          * An iterator to iterate over lists.
          * This implementation doesn't allow modifications in the list.
          * All methods that change the list will throw an <code>UnsupportedOperationError</code>.
          * 
          * @author Flávio Silva
          */
         public class ReadOnlyListIterator extends ListIterator
         {
                 /**
                  * Constructor, creates a new <code>ReadOnlyListIterator</code> object.
                  * 
                  * @param          source         the source <code>ReadOnlyListIterator</code> to iterate over.
                  * @param          position         indicates the first element that would be returned by an initial call to <code>next</code>. An initial call to <code>previous</code> would return the element with the specified position minus one.
                  * @throws         ArgumentError  if the <code>source</code> argument is <code>null</code>.
                  */
                 public function ReadOnlyListIterator(source:IList, position:int = 0)
                 {
                         super(source, position);
                 }
 
                 /**
                  * This implementation always throws an <code>UnsupportedOperationError</code>.
                  * 
                  * @param element         the element to add.
                  * @throws         org.as3coreaddendum.errors.UnsupportedOperationError          <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
                  */
                 override public function add(element:*): Boolean
                 {
                         throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
                 }
 
                 /**
                  * This implementation always throws an <code>UnsupportedOperationError</code>.
                  * 
                  * @throws         org.as3coreaddendum.errors.UnsupportedOperationError          <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
                  */
                 override public function remove(): void
                 {
                         throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
                 }
 
                 /**
                  * This implementation always throws an <code>UnsupportedOperationError</code>.
                  * 
                  * @param element         the element with which to replace the last element returned by <code>next</code> or <code>previous</code>.
                  * @throws         org.as3coreaddendum.errors.UnsupportedOperationError          <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
                  */
                 override public function set(element:*): void
                 {
                         throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
                 }
 
         }
 
 }

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.as3collections.iterators {
31		import org.as3collections.IList;
32		import org.as3coreaddendum.errors.UnsupportedOperationError;
33		import org.as3utils.ReflectionUtil;
34
35		/**
36		* An iterator to iterate over lists.
37		* This implementation doesn't allow modifications in the list.
38		* All methods that change the list will throw an <code>UnsupportedOperationError</code>.
39		*
40		* @author Flávio Silva
41		*/
42		public class ReadOnlyListIterator extends ListIterator
43		{
44		/**
45		* Constructor, creates a new <code>ReadOnlyListIterator</code> object.
46		*
47		* @param source the source <code>ReadOnlyListIterator</code> to iterate over.
48		* @param position indicates the first element that would be returned by an initial call to <code>next</code>. An initial call to <code>previous</code> would return the element with the specified position minus one.
49		* @throws ArgumentError if the <code>source</code> argument is <code>null</code>.
50		*/
51		public function ReadOnlyListIterator(source:IList, position:int = 0)
52		{
53	1	super(source, position);
54	1	}
55
56		/**
57		* This implementation always throws an <code>UnsupportedOperationError</code>.
58		*
59		* @param element the element to add.
60		* @throws org.as3coreaddendum.errors.UnsupportedOperationError <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
61		*/
62		override public function add(element:*): Boolean
63		{
64	1	throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
65		}
66
67		/**
68		* This implementation always throws an <code>UnsupportedOperationError</code>.
69		*
70		* @throws org.as3coreaddendum.errors.UnsupportedOperationError <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
71		*/
72		override public function remove(): void
73		{
74	1	throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
75		}
76
77		/**
78		* This implementation always throws an <code>UnsupportedOperationError</code>.
79		*
80		* @param element the element with which to replace the last element returned by <code>next</code> or <code>previous</code>.
81		* @throws org.as3coreaddendum.errors.UnsupportedOperationError <code>ReadOnlyListIterator</code> is a read-only iterator and doesn't allow modifications in the list.
82		*/
83		override public function set(element:*): void
84		{
85	1	throw new UnsupportedOperationError(ReflectionUtil.getClassName(this) + " is a read-only iterator and doesn't allow modifications in the list.");
86		}
87
88		}
89
90		}