package org.mongodb.morphia.utils;


import org.bson.BSONObject;

import java.util.Collection;
import java.util.HashMap;
import java.util.Map;
import java.util.Map.Entry;


Helper to allow for optimizations for different types of Map/Collections
Author:
Scott Hernandez
Type parameters:
<K> – The key type of the map
<V> – The value type of the map/collection/**
 * Helper to allow for optimizations for different types of Map/Collections
 *
 * @param <K> The key type of the map
 * @param <V> The value type of the map/collection
 * @author Scott Hernandez
 */
public final class IterHelper<K, V> {
    
Process a Map
Params:
x –        the object to process
callback – the callback/**
     * Process a Map
     *
     * @param x        the object to process
     * @param callback the callback
     */
    @SuppressWarnings("unchecked")
    public void loopMap(final Object x, final MapIterCallback<K, V> callback) {
        if (x == null) {
            return;
        }

        if (x instanceof Collection) {
            throw new IllegalArgumentException("call loop instead");
        }

        if (x instanceof HashMap<?, ?>) {
            if (((HashMap) x).isEmpty()) {
                return;
            }

            final HashMap<?, ?> hm = (HashMap<?, ?>) x;
            for (final Entry<?, ?> e : hm.entrySet()) {
                callback.eval((K) e.getKey(), (V) e.getValue());
            }
            return;
        }
        if (x instanceof Map) {
            final Map<K, V> m = (Map<K, V>) x;
            for (final Entry<K, V> entry : m.entrySet()) {
                callback.eval(entry.getKey(), entry.getValue());
            }
            return;
        }
        if (x instanceof BSONObject) {
            final BSONObject m = (BSONObject) x;
            for (final String k : m.keySet()) {
                callback.eval((K) k, (V) m.get(k));
            }
        }

    }

    
Calls eval for each entry found, or just once if the "x" isn't iterable/collection/list/etc. with "x"
Params:
x –        the object process
callback – the callback/**
     * Calls eval for each entry found, or just once if the "x" isn't iterable/collection/list/etc. with "x"
     *
     * @param x        the object process
     * @param callback the callback
     */
    @SuppressWarnings({"unchecked"})
    public void loopOrSingle(final Object x, final IterCallback<V> callback) {
        if (x == null) {
            return;
        }

        //A collection
        if (x instanceof Collection<?>) {
            final Collection<?> l = (Collection<?>) x;
            for (final Object o : l) {
                callback.eval((V) o);
            }
            return;
        }

        //An array of Object[]
        if (x.getClass().isArray()) {
            for (final Object o : (Object[]) x) {
                callback.eval((V) o);
            }
            return;
        }

        callback.eval((V) x);
    }

    
A callback mechanism for processing Maps
Type parameters:
<K> – the type map keys
<V> – the type map values/**
     * A callback mechanism for processing Maps
     *
     * @param <K> the type map keys
     * @param <V> the type map values
     */
    public abstract static class MapIterCallback<K, V> {
        
The method to call in the callback
Params:
k – the key from the map
v – the value for the key/**
         * The method to call in the callback
         *
         * @param k the key from the map
         * @param v the value for the key
         */
        public abstract void eval(K k, V v);
    }

    
A callback mechanism for processing Iterables
Type parameters:
<V> – the type Iterable elements/**
     * A callback mechanism for processing Iterables
     *
     * @param <V> the type Iterable elements
     */
    public abstract static class IterCallback<V> {
        
The method to call in the callback
Params:
v – an element in the Iterable/**
         * The method to call in the callback
         *
         * @param v an element in the Iterable
         */
        public abstract void eval(V v);
    }
}