All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.sf.jasperreports.engine.fill.JRPrintBand Maven / Gradle / Ivy

There is a newer version: 6.21.3
Show newest version
/*
 * JasperReports - Free Java Reporting Library.
 * Copyright (C) 2001 - 2011 Jaspersoft Corporation. All rights reserved.
 * http://www.jaspersoft.com
 *
 * Unless you have purchased a commercial license agreement from Jaspersoft,
 * the following license terms apply:
 *
 * This program is part of JasperReports.
 *
 * JasperReports 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 3 of the License, or
 * (at your option) any later version.
 *
 * JasperReports 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 JasperReports. If not, see .
 */
package net.sf.jasperreports.engine.fill;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;

import net.sf.jasperreports.engine.JRPrintElement;
import net.sf.jasperreports.engine.JRPrintElementContainer;


/**
 * @author Teodor Danciu ([email protected])
 * @version $Id: JRPrintBand.java 5180 2012-03-29 13:23:12Z teodord $
 */
public class JRPrintBand implements JRPrintElementContainer
{
	

	/**
	 *
	 */
	private int height;
	// adding both elements and OffsetElements to this list
	private List elements = new ArrayList();
	private boolean iterated = false;

	
	/**
	 *
	 */
	public int getHeight()
	{
		return this.height;
	}
		
	/**
	 *
	 */
	public void setHeight(int height)
	{
		this.height = height;
	}

	/**
	 *
	 */
	public List getElements()
	{
		// should not be called
		throw new UnsupportedOperationException();
	}
	
	public Iterator iterateElements()
	{
		// we only allow one iteration of the elements because we apply 
		// the offsets during iteration
		if (iterated)
		{
			// this should not happen
			throw new IllegalStateException("Elements already iterated");
		}
		
		iterated = true;
		return new ElementsIterator(elements);
	}
	
	/**
	 *
	 */
	public void addElement(JRPrintElement element)
	{
		this.elements.add(element);
	}
	
	public void addOffsetElements(Collection elements, int offsetX, int offsetY)
	{
		if (elements == null || elements.isEmpty())
		{
			// nothing to do
			return;
		}
		
		OffsetElements offsetElements = new OffsetElements(elements, offsetX, offsetY);
		this.elements.add(offsetElements);
	}
		
	protected static class OffsetElements
	{
		private final Collection elements;
		private final int offsetX;
		private final int offsetY;
		
		public OffsetElements(Collection elements,
				int offsetX, int offsetY)
		{
			this.elements = elements;
			this.offsetX = offsetX;
			this.offsetY = offsetY;
		}
	}
	
	protected static class ElementsIterator implements Iterator
	{
		private final Iterator iterator;
		
		private OffsetElements subElements;
		private Iterator subIterator;

		public ElementsIterator(List elements)
		{
			this.iterator = elements.iterator();
		}

		public boolean hasNext()
		{
			return (subIterator != null && subIterator.hasNext()) || iterator.hasNext();
		}

		public JRPrintElement next()
		{
			JRPrintElement element = null;
			// try to get the element from the sublist
			if (subIterator != null)
			{
				if (subIterator.hasNext())
				{
					element = subIterator.next();
					// remove the element from the sublist.  this helps with virtualized subreport pages 
					// by releasing the external data and allowing the master page to reuse the storage.
					subIterator.remove();
					
					// apply the offsets
					setSubOffsets(element);
				}
				else
				{
					subIterator = null;
					subElements = null;
				}
			}
			
			// if no sublist element, get from the main list
			if (element == null)
			{
				Object next = iterator.next();
				if (next instanceof JRPrintElement)
				{
					element = (JRPrintElement) next;
				}
				else
				{
					subElements = (OffsetElements) next;
					subIterator = subElements.elements.iterator();

					// we're only adding non empty sublists, hence not checking hasNext()
					element = subIterator.next();
					subIterator.remove();
					
					// apply the offsets
					setSubOffsets(element);
				}
			}
			
			return element;
		}

		protected void setSubOffsets(JRPrintElement element)
		{
			element.setX(subElements.offsetX + element.getX());
			element.setY(subElements.offsetY + element.getY());
		}

		public void remove()
		{
			throw new UnsupportedOperationException();
		}
	}
}