translation: translation of iterator pattern to Italian (#2796)

Co-authored-by: Leonardo Lisanti <[email protected]>

Author: leonardol

localization/it/iterator/README.md

@@ -0,0 +1,152 @@
+---
+title: Iterator
+category: Behavioral
+language: it
+tag:
+ - Gang of Four
+---
+
+## Anche conosciuto come
+
+Cursor
+
+## Intento
+Fornire un modo per accedere agli elementi di un oggetto aggregato in modo sequenziale senza esporre la sua rappresentazione sottostante.
+
+## Spiegazione
+
+Esempio del mondo reale
+
+> Lo scrigno del tesoro contiene una serie di oggetti magici. Ci sono diversi tipi di oggetti, come anelli,
+> pozioni e armi. Gli oggetti possono essere esaminati per tipo utilizzando un iteratore fornito dalla cassa
+> del tesoro.
+
+In parole semplici
+
+> I contenitori possono fornire un'interfaccia di iterazione agnostica alla rappresentazione per consentire l'accesso agli
+> elementi.
+
+Wikipedia dice
+
+> Nella programmazione orientata agli oggetti, il pattern iterator è un design pattern in cui un iteratore viene
+> utilizzato per attraversare un contenitore e accedere agli elementi del contenitore stesso. _(Testo tradotto dalla voce Iterator Pattern da Wikipedia in lingua inglese)._
+
+**Esempio di codice**
+
+La classe principale nel nostro esempio è `TreasureChest`, che contiene gli oggetti.
+
+```java
+public class TreasureChest {
+
+  private final List<Item> items;
+
+  public TreasureChest() {
+    items = List.of(
+        new Item(ItemType.POTION, "Potion of courage"),
+        new Item(ItemType.RING, "Ring of shadows"),
+        new Item(ItemType.POTION, "Potion of wisdom"),
+        new Item(ItemType.POTION, "Potion of blood"),
+        new Item(ItemType.WEAPON, "Sword of silver +1"),
+        new Item(ItemType.POTION, "Potion of rust"),
+        new Item(ItemType.POTION, "Potion of healing"),
+        new Item(ItemType.RING, "Ring of armor"),
+        new Item(ItemType.WEAPON, "Steel halberd"),
+        new Item(ItemType.WEAPON, "Dagger of poison"));
+  }
+
+  public Iterator<Item> iterator(ItemType itemType) {
+    return new TreasureChestItemIterator(this, itemType);
+  }
+
+  public List<Item> getItems() {
+    return new ArrayList<>(items);
+  }
+}
+```
+
+Ecco la classe `Item`:
+
+```java
+public class Item {
+
+  private ItemType type;
+  private final String name;
+
+  public Item(ItemType type, String name) {
+    this.setType(type);
+    this.name = name;
+  }
+
+  @Override
+  public String toString() {
+    return name;
+  }
+
+  public ItemType getType() {
+    return type;
+  }
+
+  public final void setType(ItemType type) {
+    this.type = type;
+  }
+}
+
+public enum ItemType {
+
+  ANY, WEAPON, RING, POTION
+
+}
+```
+
+L'interfaccia `Iterator` è estremamente semplice.
+
+```java
+public interface Iterator<T> {
+
+  boolean hasNext();
+
+  T next();
+}
+```
+
+Nell'esempio seguente, si iterano gli oggetti di tipo anello che si trovano nel forziere.
+
+```java
+var itemIterator = TREASURE_CHEST.iterator(ItemType.RING);
+while (itemIterator.hasNext()) {
+  LOGGER.info(itemIterator.next().toString());
+}
+```
+
+Output del programma:
+
+```java
+Ring of shadows
+Ring of armor
+```
+
+## Diagramma delle classi
+
+![alt text](../../../iterator/etc/iterator_1.png "Iterator")
+
+## Applicabilità
+
+Usa il pattern Iterator
+
+* Per accedere ai contenuti di un oggetto aggregato senza esporre la sua rappresentazione interna.
+* Per supportare più attraversamenti di oggetti aggregati.
+* Per fornire un'interfaccia uniforme per l'attraversamento di diverse strutture aggregate.
+
+## Tutorial
+
+* [How to Use Iterator?](http://www.tutorialspoint.com/java/java_using_iterator.htm)
+
+## Usi noti
+
+* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)
+* [java.util.Enumeration](http://docs.oracle.com/javase/8/docs/api/java/util/Enumeration.html)
+
+## Collegamenti esterni
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)