Field Detail

• NOT_STARTED

  public static final int NOT_STARTED

  See Also:

  Constant Field Values

• OPENED

  public static final int OPENED

  See Also:

  Constant Field Values

• WAITING_FOR_JOIN

  public static final int WAITING_FOR_JOIN

  See Also:

  Constant Field Values

• FINISHING

  public static final int FINISHING

  See Also:

  Constant Field Values

• FINISHED

  public static final int FINISHED

  See Also:

  Constant Field Values

Constructor Detail

• ElementLayoutController

  protected ElementLayoutController()

Method Detail

• toString

  public java.lang.String toString()

  Overrides:

  toString in class java.lang.Object

• getParent

  public LayoutController getParent()

  Retrieves the parent of this layout controller. This allows childs to query their context.

  Specified by:

  getParent in interface LayoutController

  Returns:

  the layout controller's parent to null if there is no parent.

• initialize

  public void initialize​(java.lang.Object node,
                         FlowController flowController,
                         LayoutController parent)
                  throws DataSourceException,
                         ReportDataFactoryException,
                         ReportProcessingException

  Initializes the layout controller. This method is called exactly once. It is the creators responsibility to call this method.

  Calling initialize after the first advance must result in a IllegalStateException.

  Specified by:

  initialize in interface LayoutController

  Parameters:

  node - the currently processed object or layout node.

  flowController - the current flow controller.

  parent - the parent layout controller that was responsible for instantiating this controller.

  Throws:

  DataSourceException - if there was a problem reading data from the datasource.

  ReportProcessingException - if there was a general problem during the report processing.

  ReportDataFactoryException - if a query failed.

• advance

  public final LayoutController advance​(ReportTarget target)
                                 throws DataSourceException,
                                        ReportProcessingException,
                                        ReportDataFactoryException

  Advances the layout controller to the next state. This method delegates the call to one of the following methods:

  • startElement(org.jfree.report.flow.ReportTarget)
  • processContent(org.jfree.report.flow.ReportTarget)
  • finishElement(org.jfree.report.flow.ReportTarget)

  Specified by:

  advance in interface LayoutController

  Parameters:

  target - the report target that receives generated events.

  Returns:

  the new layout controller instance representing the new state.

  Throws:

  DataSourceException - if there was a problem reading data from the datasource.

  ReportProcessingException - if there was a general problem during the report processing.

  ReportDataFactoryException - if a query failed.

• startElement

  protected LayoutController startElement​(ReportTarget target)
                                   throws DataSourceException,
                                          ReportProcessingException,
                                          ReportDataFactoryException

  This method is called for each newly instantiated layout controller. The returned layout controller instance should have a processing state of either 'OPEN' or 'FINISHING' depending on whether there is any content or any child nodes to process.

  Parameters:

  target - the report target that receives generated events.

  Returns:

  the new layout controller instance representing the new state.

  Throws:

  DataSourceException - if there was a problem reading data from the datasource.

  ReportProcessingException - if there was a general problem during the report processing.

  ReportDataFactoryException - if a query failed.

• getAttributeMap

  public org.jfree.layouting.util.AttributeMap getAttributeMap()

• getExpressionsCount

  public int getExpressionsCount()

• getIterationCount

  public int getIterationCount()

• startData

  protected FlowController startData​(ReportTarget target,
                                     FlowController fc)
                              throws DataSourceException,
                                     ReportProcessingException,
                                     ReportDataFactoryException

  Throws:

  DataSourceException

  ReportProcessingException

  ReportDataFactoryException

• computeAttributes

  protected org.jfree.layouting.util.AttributeMap computeAttributes​(FlowController fc,
                                                                    Element element,
                                                                    ReportTarget target)
                                                             throws DataSourceException

  Throws:

  DataSourceException

• processContent

  protected abstract LayoutController processContent​(ReportTarget target)
                                              throws DataSourceException,
                                                     ReportProcessingException,
                                                     ReportDataFactoryException

  Processes any content in this element. This method is called when the processing state is 'OPENED'. The returned layout controller will retain the 'OPENED' state as long as there is more content available. Once all content has been processed, the returned layout controller should carry a 'FINISHED' state.

  Parameters:

  target - the report target that receives generated events.

  Returns:

  the new layout controller instance representing the new state.

  Throws:

  DataSourceException - if there was a problem reading data from the datasource.

  ReportProcessingException - if there was a general problem during the report processing.

  ReportDataFactoryException - if a query failed.

• finishElement

  protected LayoutController finishElement​(ReportTarget target)
                                    throws ReportProcessingException,
                                           DataSourceException,
                                           ReportDataFactoryException

  Finishes the processing of this element. This method is called when the processing state is 'FINISHING'. The element should be closed now and all privatly owned resources should be freed. If the element has a parent, it would be time to join up with the parent now, else the processing state should be set to 'FINISHED'.

  Parameters:

  target - the report target that receives generated events.

  Returns:

  the new layout controller instance representing the new state.

  Throws:

  DataSourceException - if there was a problem reading data from the datasource.

  ReportProcessingException - if there was a general problem during the report processing.

  ReportDataFactoryException - if there was an error trying query data.

• handleDefaultEndElement

  protected FlowController handleDefaultEndElement​(ReportTarget target)
                                            throws ReportProcessingException,
                                                   DataSourceException,
                                                   ReportDataFactoryException

  Throws:

  ReportProcessingException

  DataSourceException

  ReportDataFactoryException

• isAdvanceable

  public boolean isAdvanceable()

  Description copied from interface: LayoutController
  Checks, whether the layout controller would be advanceable. If this method returns true, it is generally safe to call the 'advance()' method.

  Specified by:

  isAdvanceable in interface LayoutController

  Returns:

  true, if the layout controller is advanceable, false otherwise.

• getElement

  public Element getElement()

• getFlowController

  public FlowController getFlowController()

  Specified by:

  getFlowController in interface LayoutController

• getProcessingState

  public int getProcessingState()

• setProcessingState

  public void setProcessingState​(int processingState)

• setFlowController

  public void setFlowController​(FlowController flowController)

• setParent

  public void setParent​(LayoutController parent)

• clone

  public java.lang.Object clone()

  Description copied from interface: LayoutController
  Creates a copy of this layout controller.

  Specified by:

  clone in interface LayoutController

  Overrides:

  clone in class java.lang.Object

  Returns:

  a copy.

• isPrecomputing

  public boolean isPrecomputing()

• performElementPrecomputation

  protected FlowController performElementPrecomputation​(Expression[] expressions,
                                                        FlowController fc)
                                                 throws ReportProcessingException,
                                                        ReportDataFactoryException,
                                                        DataSourceException

  Throws:

  ReportProcessingException

  ReportDataFactoryException

  DataSourceException

• tryRepeatingCommit

  protected FlowController tryRepeatingCommit​(FlowController fc)
                                       throws DataSourceException

  Throws:

  DataSourceException

• createPrecomputeInstance

  public LayoutController createPrecomputeInstance​(FlowController fc)

  Derives a copy of this controller that is suitable to perform a precomputation.

  Specified by:

  createPrecomputeInstance in interface LayoutController

  Parameters:

  fc -

  Returns:

• getNode

  public java.lang.Object getNode()

  Specified by:

  getNode in interface LayoutController