Logo
Distributed Genetic Programming Framework
print print

File org.sfc.id.IDManager.java

Here you can find all the information about the file org.sfc.id.IDManager.java. You may explore it here or download it onto your local disk.
/*
 * Copyright (c) 2006 Thomas Weise
 * 
 * E-Mail           : tweise@gmx.de
 * Creation Date    : 2006-05-18 08:27:48
 * Original Filename: org.sfc.id.NamedIDManager.java
 * Version          : 1.0.0
 * Last modification: 2006-05-18
 *                by: Thomas Weise
 * 
 * License          : GNU LESSER GENERAL PUBLIC LICENSE
 *                    Version 2.1, February 1999
 *                    You should have received a copy of this license along
 *                    with this library; if not, write to the Free Software
 *                    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *                    MA 02111-1307, USA or download the license under
 *                    http://www.gnu.org/copyleft/lesser.html.
 *                    
 * Warranty         : This software is provided "as is" 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.sfc.id;

import java.util.Iterator;

import org.sfc.collections.IVisitable;
import org.sfc.collections.IVisitor;
import org.sfc.collections.ProtectedHash;
import org.sfc.utils.Typesafe;

/**
 * The manager class for named ids.
 * 
 * @param <Type>    The type of the objects uniquely being assigned to this
 *                  id - classes or strings are common.
 * @param <IDType>  The type of ids this manager is used for.
 * 
 * @author Thomas Weise
 */

public   class IDManager<Type, IDType extends ID<Type, IDType>>
              extends         ProtectedHash<Type, IDType>
              implements      Iterable<IDType>, IVisitable<IDType>
  {  
/**
 * Create a new id manager.
 */

  public IDManager()
    {
    super(-1);
    }

/**
 * Add a new id object. This is called by the constructor.
 * @param p_id  The id to add.
 */

  synchronized  final void  add_id (final ID<?,?> p_id)
    {
    IDType l_t;
    
    l_t = Typesafe.cast(p_id);
    
    if(this.get(p_id.m_id) != null)
      {
      Typesafe.tunnel_error(p_id.m_id + " already exists in " +
                            this);
      }
    
    this.do_put(l_t.m_id, l_t);
    }

/**
 * Resolve an id read from a stream.
 * @param p_id  The id read.
 * @return  The resolved id.
 */

  final IDType  resolve (final ID<?,?> p_id)
    {    
    IDType l_t;    
    l_t = Typesafe.cast(p_id);
    
    return this.get(l_t.m_id);
    }


/**
 * Visit all ids in this id manager.
 * @param p_visitor The visitor to be carried around.
 * @return  <code>true</code> if the visitor successfully visited all
 *          elements, <code>false</code> if it aborted its visit.
 */

  public  final boolean visit (final IVisitor<IDType> p_visitor)
    {
    return this.visit_values(p_visitor);
    }
    
/**
 * Returns <tt>true</tt> if this manager contains the specified element.
 * More formally, returns <tt>true</tt> if and only if this manager
 * contains at least one element <tt>e</tt> such that
 * <tt>(o==null&nbsp;?&nbsp;e==null&nbsp;:&nbsp;o.equals(e))</tt>.
 *
 * @param p_o element whose presence in this manager is to be tested.
 * @return <tt>true</tt> if this manager contains the specified element.
 * @throws ClassCastException if the type of the specified element
 *         is incompatible with this manager (optional).
 * @throws NullPointerException if the specified element is null and this
 *         managerdoes not support null elements (optional).
 */

  public  final boolean contains(final  Object p_o)
    {
    return this.containsValue(p_o);
    }
  
/**
 * Returns an iterator over the elements in this collection.  There are no
 * guarantees concerning the order in which the elements are returned
 * (unless this collection is an instance of some class that provides a
 * guarantee).
 * 
 * @return an <tt>Iterator</tt> over the elements in this collection
 */

  public  final Iterator<IDType> iterator()
    {
    return this.values().iterator();
    }


/**
 * Creates and returns a copy of this object.  The precise meaning
 * of "copy" may depend on the class of the object.
 *
 * @return     A clone of this instance.
 *
 * @see java.lang.Cloneable
 */

  @Override
  public  final Object  clone ()
    {
    return this;
    }
  }

File Information:

file name:IDManager.java
package:org.sfc.id
qualified name:org.sfc.id.IDManager.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/sfc/id/IDManager.java
size:4.363 KB (4468 B)
uploaded: 2018-01-07 12:03:36 GMT+0000
last update: 2006-05-25 07:25:24 GMT+0000
last access: 2018-04-23 23:14:09 GMT+0000

statistics online since 2006-01-02.   RSS Feed
Contact us by sending an email to tweise@gmx.de to receive further information, to report errors, or to join our project.
All content on this site (http://dgpf.sourceforge.net/) is LGPL-licensed.
http://dgpf.sourceforge.net/scripts/source/source.php last modified at 2018-01-07 12:03:34 GMT+0000 served at 2018-04-23 23:14:09 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo