/*
 *    Geotoolkit - An Open Source Java GIS Toolkit
 *    http://www.geotoolkit.org
 *
 *    (C) 2008 - 2009, Geomatys
 *
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License as published by the Free Software Foundation; either
 *    version 2.1 of the License, or (at your option) any later version.
 *
 *    This library is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *    Lesser General Public License for more details.
 */
package org.geotoolkit.style;

import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.lang.ref.WeakReference;
import java.util.ArrayList;
import java.util.Collection;

import org.geotoolkit.internal.ReferenceQueueConsumer;
import org.geotoolkit.util.collection.CollectionChangeEvent;
import org.apache.sis.util.Disposable;

import org.opengis.style.SemanticType;
import org.opengis.util.GenericName;

/**
 * Listener for FeatureTypeStyle.
 *
 * @author Johann Sorel (Geomatys)
 * @module
 */
public interface FeatureTypeStyleListener extends PropertyChangeListener{

    /**
     * Called when a change occurs in the living rule collection.
     */
    void ruleChange(CollectionChangeEvent<MutableRule> event);

    /**
     * Called when a change occurs in the living feature type name collection.
     */
    void featureTypeNameChange(CollectionChangeEvent<GenericName> event);

    /**
     * Called when a change occurs in the living semantic collection.
     */
    void semanticTypeChange(CollectionChangeEvent<SemanticType> event);

    /**
     * Weak feture type style listener. Use it when you are not
     * sure that the listener will be correctly removed by your class.
     */
    public static final class Weak extends WeakReference<FeatureTypeStyleListener> implements FeatureTypeStyleListener,Disposable{

        private final Collection<MutableFeatureTypeStyle> sources = new ArrayList<MutableFeatureTypeStyle>(1);

        public Weak(final FeatureTypeStyleListener ref) {
            this(null,ref);
        }

        public Weak(final MutableFeatureTypeStyle source, final FeatureTypeStyleListener ref) {
            super(ref, ReferenceQueueConsumer.DEFAULT.queue);
            registerSource(source);
        }

        /**
         * Register this listener on the given source.
         */
        public synchronized void registerSource(final MutableFeatureTypeStyle source){
            if(source != null && !sources.contains(source)){
                //register in the new source
                source.addListener(this);
                this.sources.add(source);
            }
        }

        /**
         * Unregister this listener on the given source.
         */
        public synchronized void unregisterSource(final MutableFeatureTypeStyle source){
            sources.remove(source);
            source.removeListener(this);
        }

        @Override
        public synchronized void dispose() {
            for(MutableFeatureTypeStyle source : sources){
                source.removeListener(this);
            }
            sources.clear();
        }

        @Override
        public void ruleChange(final CollectionChangeEvent<MutableRule> event) {
            final FeatureTypeStyleListener listener = get();
            if (listener != null) {
                listener.ruleChange(event);
            }
            //if the listener is null, that means we are in the reference queue and it will be disposed soon.
        }

        @Override
        public void featureTypeNameChange(final CollectionChangeEvent<GenericName> event) {
            final FeatureTypeStyleListener listener = get();
            if (listener != null) {
                listener.featureTypeNameChange(event);
            }
            //if the listener is null, that means we are in the reference queue and it will be disposed soon.
        }

        @Override
        public void semanticTypeChange(final CollectionChangeEvent<SemanticType> event) {
            final FeatureTypeStyleListener listener = get();
            if (listener != null) {
                listener.semanticTypeChange(event);
            }
            //if the listener is null, that means we are in the reference queue and it will be disposed soon.
        }

        @Override
        public void propertyChange(final PropertyChangeEvent evt) {
            final FeatureTypeStyleListener listener = get();
            if (listener != null) {
                listener.propertyChange(evt);
            }
            //if the listener is null, that means we are in the reference queue and it will be disposed soon.
        }

    }

}