001    /**
002     * ========================================
003     * JFreeReport : a free Java report library
004     * ========================================
005     *
006     * Project Info:  http://reporting.pentaho.org/
007     *
008     * (C) Copyright 2000-2007, by Object Refinery Limited, Pentaho Corporation and Contributors.
009     *
010     * This library is free software; you can redistribute it and/or modify it under the terms
011     * of the GNU Lesser General Public License as published by the Free Software Foundation;
012     * either version 2.1 of the License, or (at your option) any later version.
013     *
014     * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
015     * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
016     * See the GNU Lesser General Public License for more details.
017     *
018     * You should have received a copy of the GNU Lesser General Public License along with this
019     * library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
020     * Boston, MA 02111-1307, USA.
021     *
022     * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
023     * in the United States and other countries.]
024     *
025     * ------------
026     * $Id: GroupReadHandler.java 3525 2007-10-16 11:43:48Z tmorgner $
027     * ------------
028     * (C) Copyright 2000-2005, by Object Refinery Limited.
029     * (C) Copyright 2005-2007, by Pentaho Corporation.
030     */
031    package org.jfree.report.modules.factories.report.flow;
032    
033    import org.jfree.report.structure.Element;
034    import org.jfree.report.structure.Group;
035    import org.jfree.xmlns.parser.XmlReadHandler;
036    import org.jfree.xmlns.parser.ParseException;
037    import org.xml.sax.Attributes;
038    import org.xml.sax.SAXException;
039    
040    /**
041     * Creation-Date: 09.04.2006, 15:37:31
042     *
043     * @author Thomas Morgner
044     */
045    public class GroupReadHandler extends SectionReadHandler
046    {
047      private Group group;
048      private GroupingExpressionReadHandler groupingExpressionReadHandler;
049    
050      public GroupReadHandler()
051      {
052        group = new Group();
053      }
054    
055      /**
056       * Returns the handler for a child element.
057       *
058       * @param tagName the tag name.
059       * @param atts    the attributes.
060       * @return the handler or null, if the tagname is invalid.
061       * @throws SAXException       if there is a parsing error.
062       */
063      protected XmlReadHandler getHandlerForChild(final String uri,
064                                                  final String tagName,
065                                                  final Attributes atts)
066          throws SAXException
067      {
068        final XmlReadHandler base = super.getHandlerForChild(uri, tagName, atts);
069        if (base != null)
070        {
071          return base;
072        }
073        if (FlowReportFactoryModule.NAMESPACE.equals(uri))
074        {
075          if ("grouping-expression".equals(tagName))
076          {
077            groupingExpressionReadHandler = new GroupingExpressionReadHandler();
078            return groupingExpressionReadHandler;
079          }
080        }
081        return null;
082      }
083    
084      /**
085       * Done parsing.
086       *
087       * @throws SAXException       if there is a parsing error.
088       */
089      protected void doneParsing() throws SAXException
090      {
091        if (groupingExpressionReadHandler == null)
092        {
093          throw new ParseException
094              ("Required element 'grouping-expression' is missing.", getLocator());
095        }
096    
097        super.doneParsing();
098        final Group group = (Group) getElement();
099        group.setGroupingExpression(groupingExpressionReadHandler.getExpression());
100      }
101    
102      protected Element getElement()
103      {
104        return group;
105      }
106    }