public ElementFactory(ReportParser parser,
    String finishTag,
    Band band) 
{
                                                                                     
    super(parser, finishTag);
    this.currentBand = band;
    this.currentText = new StringBuffer();
    this.entityParser = CharacterEntityParser.createXMLEntityParser();
}

Creates a new ElementFactory. The factory queries the current Band of the ReportFactory and will add created element to this band. If unknown end-Tags are encountered, the parsing for elements will stop and the previous handler will be activated.

Parameters:

parser - the used parser to coordinate the parsing process.

finishTag - the finish tag, that should trigger the deactivation of this parser.

band - the band that should be defined.

Throws:

NullPointerException - if the finishTag or the parser are null.

 public  void characters(char[] ch,
    int start,
    int length) 
{
    if (this.currentText != null)
    {
      this.currentText.append(String.copyValueOf(ch, start, length));
    }
}

Receives some (or all) of the text in the current element.

 public  void endElement(String qName) throws SAXException 
{
    final String elementName = qName.toLowerCase().trim();
    // *** LABEL ***
    if (elementName.equals(LABEL_TAG))
    {
      endLabel();
    }
    else if (elementName.equals(RESOURCELABEL_TAG))
    {
      endResourceLabel();
    }
    else if (elementName.equals(RESOURCEFIELD_TAG))
    {
      endResourceField();
    }
    else if (elementName.equals(DRAWABLE_FIELD_TAG) ||
        elementName.equals(IMAGEREF_TAG) ||
        elementName.equals(IMAGEFIELD_TAG) ||
        elementName.equals(IMAGEURLFIELD_TAG) ||
        elementName.equals(LINE_TAG) ||
        elementName.equals(SHAPE_FIELD_TAG) ||
        elementName.equals(RECTANGLE_TAG))
    {
      // do nothing ..
    }
    else if (elementName.equals(STRING_FIELD_TAG))
    {
      endStringField();
    }
    else if (elementName.equals(NUMBER_FIELD_TAG))
    {
      endNumberField();
    }
    else if (elementName.equals(DATE_FIELD_TAG))
    {
      endDateField();
    }
    else if (elementName.equals(BAND_TAG))
    {
      endBand();
    }
    else if (elementName.equals(getFinishTag()))
    {
      getParser().popFactory().endElement(qName);
      return;
    }
    else
    {
      throw new ParseException("Invalid tag: " + qName, getLocator());
    }
}

SAX handler function that is forwarded from the ReportDefinitionContentHandler. If an unknown element is encountered, the previous handler gets activated.

 protected Band getCurrentBand() 
{
    return currentBand;
}

Returns the current band, which receives the parsed elements.

 protected String getCurrentText() 
{
    return entityParser.decodeEntities(currentText.toString());
}

Returns the current text of the textbuffer.

 public  void startElement(String qName,
    Attributes atts) throws SAXException 
{
    if (textElementFactory != null)
    {
      throw new IllegalStateException(qName);
    }
    final String elementName = qName.toLowerCase().trim();
    // *** LABEL ***
    if (elementName.equals(LABEL_TAG))
    {
      startLabel(atts);
    }
    else if (elementName.equals(RESOURCELABEL_TAG))
    {
      startResourceLabel(atts);
    }
    else if (elementName.equals(RESOURCEFIELD_TAG))
    {
      startResourceField(atts);
    }
    else if (elementName.equals(DRAWABLE_FIELD_TAG))
    {
      startDrawableField(atts);
    }
    else if (elementName.equals(IMAGEREF_TAG))
    {
      startImageRef(atts);
    }
    else if (elementName.equals(IMAGEFIELD_TAG))
    {
      startImageField(atts);
    }
    else if (elementName.equals(IMAGEURLFIELD_TAG))
    {
      startImageURLField(atts);
    }
    else if (elementName.equals(LINE_TAG))
    {
      startLine(atts);
    }
    else if (elementName.equals(SHAPE_FIELD_TAG))
    {
      startShapeField(atts);
    }
    else if (elementName.equals(STRING_FIELD_TAG))
    {
      startStringField(atts);
    }
    else if (elementName.equals(NUMBER_FIELD_TAG))
    {
      startNumberField(atts);
    }
    else if (elementName.equals(DATE_FIELD_TAG))
    {
      startDateField(atts);
    }
    else if (elementName.equals(RECTANGLE_TAG))
    {
      startRectangle(atts);
    }
    else if (elementName.equals(BAND_TAG))
    {
      startBand(atts);
    }
}

SAX-Handler function that is forwarded from the ReportDefinitionContentHandler. StartTag-occurences of element definitions get handled by this factory. If an unknown element is encountered, a SAXException is thrown.

The elements parsed in this factory denote base usecases. Element creation is delegated to the element factories in the package org.jfree.repor.elementfactory