Package com.inet.report

Class JavaBean

java.lang.Object
com.inet.report.ReportComponent
com.inet.report.Element
com.inet.report.AbstractFontElement
com.inet.report.JavaBean
All Implemented Interfaces:
BorderProperties, FontProperties, GeneralProperties, HyperlinkProperties, NodeParser, com.inet.report.ReferenceHolder, Serializable, Cloneable
public class JavaBean extends AbstractFontElement implements HyperlinkProperties, BorderProperties
An instance of this class is an i-net Clear Reports Element that represents a Java Bean which can be rendered to a report. The Java bean must be a lightweight bean extending java.awt.Component.

Use Section.addJavaBean to create a JavaBean element.

Use the setBeanProperty methods to set a bean property to a Java Object or an i-net Clear Reports ForumulaField.

There are two methods for rendering a report. The default method paintToImage paints the view of the Java bean into a background image then draws the image to the report. If paintToImage is set to false, this class will attempt to render directly to the report (which may provide better quality, e.g when using fonts). Please note that the second method does not support components that use a Java Graphics2D object to paint themselves and currently does not support clipping.

Please note that the view (image) of the bean is taken directly after the beans' paint method returns. If the bean accesses its Graphics in threads or after the paint method the resulting view will be incorrect. The following example code creates a PDF report containing a javax.swing.JSlider component showing 75% of 100%:


 Engine engine = RDC.createEmptyEngine();
 Section section = (Section) engine.getSections().get(0);
 JavaBean javaBean = section.addJavaBean("javax.swing.JSlider", 1, 100, 3000, 315);
 javaBean.setBeanProperty("minimum", new Integer(0));
 javaBean.setBeanProperty("maximum", new Integer(100));
 javaBean.setBeanProperty("value", new Integer(75));
 engine.execute();
 FileOutputStream fos = new FileOutputStream("D:/exports/slider_bean.pdf");
 for( int i=1;i<=engine.getPageCount();i++ ) {
     fos.write(engine.getPageData(i));
 }
 fos.close();
See Also:

  • Field Details

    • APPLY_PROPERTIES

      public static final String APPLY_PROPERTIES
      The Constant used for notify Customizer component
      See Also:

  • Method Details

    • setBeanClassName

      public void setBeanClassName(String name) throws ReportException
      Sets the name of the beans' class
      Parameters:
      name - The name of the beans' class
      Throws:
      ReportException - If there are problems finding or initializing the bean by the name given.
      Since:
      6.0

    • getBeanClassName

      public String getBeanClassName()
      Returns the name of the beans's class
      Returns:
      The name of the beans' class
      Since:
      6.0

    • getCustomizer

      public Customizer getCustomizer()
      Returns the customizer component if it is supported for this bean.
      Returns:
      the customizer component (null possible)
      Since:
      10.1

    • getBeanPropertyDescriptorsForGUI

      public PropertyDescriptor[] getBeanPropertyDescriptorsForGUI() throws ReportException
      Returns those bean property descriptors that are suitable for setting via the i-net Desginer GUI.
      Returns:
      Those bean property descriptors that are suitable for setting via the i-net Desginer GUI.
      Throws:
      ReportException - If an exception occurs during Introspection. IntrospectionException
      Since:
      6.0

    • setBeanProperty

      public void setBeanProperty(String name, FormulaField field) throws ReportException
      Sets the beans property named name to be the value of the passed FormulaField. The value is computed at report time.
      Parameters:
      name - The name of the beans' property
      field - The formula that produces the beans properties' value
      Throws:
      ReportException - If a get or set method is missing for the property trying to be set.
      Since:
      6.0

    • setBeanProperty

      public void setBeanProperty(String name, Object value) throws ReportException
      Sets the beans property named name to the passed value (while trying to convert to the properties' type). Please note: name is the name of the property as defined in the JavaBeans API Specification (1.01), chapter 8.8 "Capitalization of inferred names".
      Parameters:
      name - Name of the beans property to set
      value - Value of the property, should be != null and convertible to the properties' type
      Throws:
      ReportException - If a set or get method is missing for the property trying to be set.
      Since:
      6.0

    • getBeanPropertyFormula

      public FormulaField getBeanPropertyFormula(String name) throws ReportException
      Returns the current property FormulaField of the beans' property named name.
      Parameters:
      name - The name of the beans property
      Returns:
      The current property FormulaField of the beans' property named name.
      Throws:
      ReportException - If problems occur while trying to access the formula, should never occur
      Since:
      6.5

    • getBeanPropertyValue

      public Object getBeanPropertyValue(String name) throws ReportException
      Returns the current property value of the beans' property named name. If this property is an i-net Clear Reports formula, the return value has type FormulaField.
      Parameters:
      name - The name of the beans property
      Returns:
      The current property value of the beans' property named name.
      Throws:
      ReportException - If the property specified by the given name could not be found
      Since:
      6.5

    • checkBean

      public static void checkBean(String className) throws ReportException
      Checks if the class named className is a valid lightweight java bean extending java.awt.Component.
      Parameters:
      className - Name to check whether it exists as a java bean.
      Throws:
      ReportException - If the bean could not be found, or is not valid (e.g. it is not public or not a component, etc.)
      Since:
      10.0

    • applyProperties

      public void applyProperties() throws ReportException
      FOR INTERNAL USE ONLY Bei 'OK' werden properties vom original bean eingelesen und PropertyValue Einträge erstellt.
      Throws:
      ReportException

    • isPaintToImage

      public boolean isPaintToImage()
      Returns whether the bean is set to "paint to an image", which makes sure that all Graphics2D methods are supported, however it also causes less graphical quality on higher zoom levels.
      Returns:
      Returns whether the bean is set to "paint to an image"
      Since:
      6.0
      See Also:

    • setPaintToImage

      public void setPaintToImage(boolean paintToImage)
      If the bean is paint to a image then all API methods of Graphics2D for paint() of the current JDK are supported. On printing the result can be screened. It can be look like printed with a dot matrix printer.
      Parameters:
      paintToImage - The paintToImage to set.
      Since:
      6.0
      See Also:

    • getBeanComponent

      public Component getBeanComponent()
      Return a instance of bean Component. This method is used for example by i-net Designer to create a preview of the component in the design view.
      Returns:
      Instance of the bean as a Component.
      Since:
      6.0

    • getPropertyFormulas

      public List<FormulaField> getPropertyFormulas()
      Returns a list with all property formulas that are set for this report element. This includes property formulas for any type of sub-component but excludes formulas for any descendant ReportComponent of this one. To get the property formulas for descendant ReportComponent use ReportComponent.getSubComponents()
      Overrides:
      getPropertyFormulas in class AbstractFontElement
      Returns:
      List of property formulas

    • setScale

      public void setScale(double scale) throws IllegalArgumentException
      Sets the scaling factor for this JavaBean element. The scaling factory is used for both the width and the height of this JavaBean. At runtime a uniform scaling of this JavaBean will be done.
      Parameters:
      scale - The scaling factor to be used for this JavaBean.
      Throws:
      IllegalArgumentException - If the supplied scale factor is less or equal to zero.
      Since:
      7.4
      See Also:

    • getScale

      public double getScale()
      Returns the scaling factor used for this JavaBean.
      Returns:
      The current scaling factor of this JavaBean.
      Since:
      7.4
      See Also:

    • setScaleFormula

      public void setScaleFormula(FormulaField scaleFormula)
      Sets a formula for the scaling factor of this JavaBean. The set formula will override the value set by setScale(double). The formula should return a number value greater than zero.
      Parameters:
      scaleFormula - The formula which should be used to determine the scale factor for this JavaBean.
      Since:
      7.4
      See Also:

    • getScaleFormula

      public FormulaField getScaleFormula()
      Returns the formula used to determine the scaling factor of this JavaBean.
      Returns:
      The formula used to determine the scaling factor of this JavaBean or null if no formula has been set.
      Since:
      7.4
      See Also:

    • parseElement

      public NodeParser parseElement(com.inet.report.parser.XMLTag group, String tag, Attributes atts, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XML

      Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.

      Specified by:
      parseElement in interface NodeParser
      Overrides:
      parseElement in class AbstractFontElement
      Parameters:
      group - XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.
      tag - The XMLTag to be parsed
      atts - The set of attributes in the current XMLTag
      parserMap - The map of current Parser.
      Returns:
      The NodeParser sub-element if one needed to be created, or null if none was created.
      Throws:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

    • getSubComponents

      public List<? extends ReportComponent> getSubComponents()
      Returns all ReportComponents that are descendants of this one. E.G. this will return all Element of a Section. But it's as well useful for CrossTabs or Text elements which have additional elements.
      Specified by:
      getSubComponents in class ReportComponent
      Returns:
      a list with all sub components which can be empty as well; will be null if the component has no descendants