com.wombat.mama.MamaSourceGroupManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of openmama Show documentation
OpenMAMA is a high performance vendor neutral lightweight wrapper that provides a common API interface to different middleware and messaging solutions across a variety of platforms and languages.
There is a newer version: 6.3.2
Show newest version
/* $Id:
 *
 * OpenMAMA: The open middleware agnostic messaging API
 * Copyright (C) 2011 NYSE Technologies, Inc.
 *
 * 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.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301 USA
 */

package com.wombat.mama;
import java.util.*;

public class MamaSourceGroupManager
{
    private Map myGroupMap = null;
    public MamaSourceGroupManager ()
    {
        myGroupMap = Collections.synchronizedMap (new HashMap());
    }
    /**
     * Create a new MamaSourceGroup and add it to the manager.
     * @param name The string identifier for the MamaSourceGroup
     * @return MamaSourceGroup
     */
    private MamaSourceGroup createSourceGroup (final String name)
    {
        MamaSourceGroup temp = null;
        if (!myGroupMap.containsKey (name))
        {
            //create a new one
            temp = new MamaSourceGroup (name);
            myGroupMap.put (name, temp);
            return temp;
        }
        else
        {
            return (MamaSourceGroup)myGroupMap.get (name);
        }
    }

    /**
     * Locates an existing MamaSourceGroup for a given name.
     * If none exists, create a new one and add it to the group
     * manager.
     * @param key The key identifier for the MamaSourceGroup
     * @return MamaSourceGroup
     */
    public MamaSourceGroup findOrCreateSourceGroup (final String key)
    {
        return createSourceGroup (key);
    }
    /**
     * Locates an existing MamaSourceGroup in the specified 
     * MamaSourceGroupManager with the specified key identifier.
     * The value of the sourceGroup will be set to NULL, if no source
     * was found.
     * @param key The key identifier for the required MamaSourceGroup
     * @return MamaSourceGroup
     */
    public MamaSourceGroup findSourceGroup (final String key)
    {
        MamaSourceGroup temp = null;
        if (myGroupMap.containsKey (key))
        {
            temp = (MamaSourceGroup)myGroupMap.get (key);
            return temp;
        }
        return temp;
    }
    /**
     * Add an existing MamaSourceGroup to the MamaSourceGroupManager.
     * The name of the source group manager will be used to uniquely 
     * identify the source group within the manager.
     * @param sourceGroup - The mama source group being specified.
     */
    public void addSourceGroup (MamaSourceGroup sourceGroup)
    {
        //get the name to check if it is valid
        String groupName;
        if ((groupName = sourceGroup.getName ()) == null )
        {
            throw new NullPointerException ("MamaSourceGroupManager:" +
                                            " addSourceGroup Could not"+
                                            " get name for source group");
        }
        if (myGroupMap.containsKey (groupName))
        {
            throw new NullPointerException ("MamaSourceGroupManager: "+
                                            " addSourceGroup Duplicate"+ 
                                            " source group [" +groupName+"]");
        }
        myGroupMap.put (groupName, sourceGroup);
    }
    
    public Iterator sourceGroupIterator ()
    {
        return new SourceGroupManagerIterator (this);
    }

    public void destroy()
    {
        if (myGroupMap != null)
            myGroupMap.clear();
    }

    /** Iterator class for SourceGroupManager*/
    private class SourceGroupManagerIterator implements Iterator
    {
        private
        MamaSourceGroupManager mySourceGroupManger = null;
        private Iterator myIterator = null;
        public SourceGroupManagerIterator 
        (MamaSourceGroupManager groupManager)
        {
            if (groupManager == null)
            {
                throw new NullPointerException ("SourceGroupManagerIterator :" +
                                                "Nullpointer Exception "+
                                                "in constructor");
            }
            mySourceGroupManger = groupManager;
            myIterator = mySourceGroupManger.myGroupMap.
                entrySet().iterator();
        }
        public boolean hasNext ()
        {
            return myIterator.hasNext();
        }
        public void remove ()
        {
            myIterator.remove();
        }
        public Object next ()
        {
            /*what if I am interested in keys?*/
            Map.Entry pairs = (Map.Entry)myIterator.next();
            MamaSourceGroup sourceGroup = 
                (MamaSourceGroup) pairs.getValue();
            return sourceGroup;
        }
    }
}
/**end*/