/*
* JBoss, Home of Professional Open Source.
* Copyright 2000 - 2008, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This 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 software 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 software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.cache.marshall;
import org.jboss.cache.CacheException;
import java.util.ArrayList;
/**
* An efficient array-based list of referenced objects, using the reference id as a subscript for the array.
*
* @author <a href="mailto:manik AT jboss DOT org">Manik Surtani (manik AT jboss DOT org)</a>
*/
public class UnmarshalledReferences
{
private final ArrayList<Object> referencedObjects = new ArrayList<Object>();
/**
* Retrieves an object referenced by an id
*
* @param ref reference
* @return object
*/
public Object getReferencedObject(int ref)
{
if (ref >= referencedObjects.size())
throw new CacheException("Attempting to look up a ref that hasn't been inserted yet");
return referencedObjects.get(ref);
}
/**
* Adds a referenced object to the list of references
*
* @param ref reference id
* @param o object
*/
public void putReferencedObject(int ref, Object o)
{
int sz = referencedObjects.size();
// if we are not adding the object to the end of the list, make sure we use a specific position
if (ref < sz)
{
referencedObjects.set(ref, o);
return;
}
else if (ref > sz)
{
// if we are adding the reference to a position beyond the end of the list, make sure we expand the list first.
// this can happen, weirdly enough, since marshallObject() can be called recursively, such as from marshallFqn().
for (int i = sz; i < ref; i++) referencedObjects.add(null);
}
referencedObjects.add(o);
}
}