java-design-patterns/iterator/index.md

---
layout: pattern
title: Iterator
folder: iterator
permalink: /patterns/iterator/
categories: Behavioral
tags: 
 - Java
 - Difficulty-Beginner
 - Gang Of Four
---

**Also known as:** Cursor

**Intent:** Provide a way to access the elements of an aggregate object
sequentially without exposing its underlying representation.

![alt text](./etc/iterator_1.png "Iterator")

**Applicability:** Use the Iterator pattern

* to access an aggregate object's contents without exposing its internal representation
* to support multiple traversals of aggregate objects
* to provide a uniform interface for traversing different aggregate structures

**Real world examples:**

* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)

**Credits**

* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`---`
			`layout: pattern`
			`title: Iterator`
			`folder: iterator`
Work towards #56: Add permalink to every pattern This makes cleaner URLs thanks to jekyll 2015-08-15 18:03:05 +02:00			`permalink: /patterns/iterator/`
Work on #213 - properly categorize all patterns - remove pattern list from readme - minor fixes to readme - removed "introduction" because its not a pattern and an error i committed some time ago 2015-08-20 21:40:07 +02:00			`categories: Behavioral`
Work on #226, #213, added references of Gang Of Four to all GoF patterns, added tag for Gang Of Four, added difficulty tags to some of them 2015-09-22 18:25:56 +05:30			`tags:`
			`- Java`
			`- Difficulty-Beginner`
			`- Gang Of Four`
Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`---`

Added alias names for GOF patterns #267 2015-11-04 21:13:32 +02:00			`Also known as: Cursor`

Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... 2015-08-13 23:54:40 +02:00			`Intent: Provide a way to access the elements of an aggregate object`
			`sequentially without exposing its underlying representation.`

			`![alt text](./etc/iterator_1.png "Iterator")`

			`Applicability: Use the Iterator pattern`

			`* to access an aggregate object's contents without exposing its internal representation`
			`* to support multiple traversals of aggregate objects`
			`* to provide a uniform interface for traversing different aggregate structures`

			`Real world examples:`

Work towards #56: Add permalink to every pattern This makes cleaner URLs thanks to jekyll 2015-08-15 18:03:05 +02:00			`* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)`
Work on #226, #213, added references of Gang Of Four to all GoF patterns, added tag for Gang Of Four, added difficulty tags to some of them 2015-09-22 18:25:56 +05:30
			`Credits`

			`* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)`