Iterator

// Interfejs kolekcja musi deklarować metodę wytwórczą do
// produkowania iteratorów. Można zadeklarować wiele metod jeśli
// potrzebujesz kilku różnych sposobów iterowania.
interface SocialNetwork is
    method createFriendsIterator(profileId):ProfileIterator
    method createCoworkersIterator(profileId):ProfileIterator


// Każda konkretna kolekcja jest powiązana z zestawem
// konkretnych klas iteratorów jakie zwraca. Ale klient nie jest
// z nimi powiązany, bo sygnatury tych metod zwracają typ
// interfejs iteratora.
class Facebook implements SocialNetwork is
    // ... Większość kodu kolekcji powinna znaleźć się tutaj ...

    // Kod kreacyjny iteratora.
    method createFriendsIterator(profileId) is
        return new FacebookIterator(this, profileId, "friends")
    method createCoworkersIterator(profileId) is
        return new FacebookIterator(this, profileId, "coworkers")


// Wspólny interfejs wszystkich iteratorów.
interface ProfileIterator is
    method getNext():Profile
    method hasMore():bool


// Konkretna klasa iteratora.
class FacebookIterator implements ProfileIterator is
    // Iterator potrzebuje odniesienia do kolekcji po elementach
    // której ma przechodzić.
    private field facebook: Facebook
    private field profileId, type: string

    // Obiekt iteratora przechodzi po elementach kolekcji
    // niezależnie od innych iteratorów. Dlatego musi
    // przechowywać stan iteracji.
    private field currentPosition
    private field cache: array of Profile

    constructor FacebookIterator(facebook, profileId, type) is
        this.facebook = facebook
        this.profileId = profileId
        this.type = type

    private method lazyInit() is
        if (cache == null)
            cache = facebook.socialGraphRequest(profileId, type)

    // Każda konkretna klasa iteratora posiada własną
    // implementację wspólnego interfejsu iteratora.
    method getNext() is
        if (hasMore())
            result = cache[currentPosition]
            currentPosition++
            return result

    method hasMore() is
        lazyInit()
        return currentPosition < cache.length


// Oto kolejna użyteczna sztuczka: możesz przekazać iterator
// klasie klienckiej zamiast dawać jej dostęp do całej kolekcji.
// Dzięki temu nie trzeba eksponować całej kolekcji klientowi.
//
// Kolejna zaleta takiego podejścia to możliwość zmiany sposobu
// w jaki klient współpracuje z kolekcją w trakcie działania
// programu poprzez przekazanie klientowi innego iteratora. Jest
// to możliwe ponieważ kod klienta nie jest sprzęgnięty z
// konkretnymi klasami iteratora.
class SocialSpammer is
    method send(iterator: ProfileIterator, message: string) is
        while (iterator.hasMore())
            profile = iterator.getNext()
            System.sendEmail(profile.getEmail(), message)


// Klasa aplikacji konfiguruje kolekcje i iteratory, a następnie
// przekazuje je kodowi klienta.
class Application is
    field network: SocialNetwork
    field spammer: SocialSpammer

    method config() is
        if working with Facebook
            this.network = new Facebook()
        if working with LinkedIn
            this.network = new LinkedIn()
        this.spammer = new SocialSpammer()

    method sendSpamToFriends(profile) is
        iterator = network.createFriendsIterator(profile.getId())
        spammer.send(iterator, "Very important message")

    method sendSpamToCoworkers(profile) is
        iterator = network.createCoworkersIterator(profile.getId())
        spammer.send(iterator, "Very important message")