第十三章 BIRT报表引擎API及报表API (续2)-利用BIRT设计引擎API生成报表
13.3 利用BIRT设计引擎API生成报表
前面我们在讲解BIRT报表工作模式的时候实现过一个简单的利用BIRT设计引擎API生成报表，在这一节我们详细讲解实现过程。
BIRT报表的设计引擎API是BIRT报表的核心，不论是任何形式的BIRT设计器（eclipse插件，osgi独立，standalone）还是任何形式的BIRT展示器（web viewer，用户自定义servlet viewer，rcp）都必须包含BIRT设计引擎。
BIRT design API包含如下包和类：
Packages org.eclipse.birt.report.model.api org.eclipse.birt.report.model.api.activity org.eclipse.birt.report.model.api.command org.eclipse.birt.report.model.api.core org.eclipse.birt.report.model.api.css org.eclipse.birt.report.model.api.elements org.eclipse.birt.report.model.api.elements.structures org.eclipse.birt.report.model.api.elements.table org.eclipse.birt.report.model.api.extension org.eclipse.birt.report.model.api.impl org.eclipse.birt.report.model.api.metadata org.eclipse.birt.report.model.api.olap org.eclipse.birt.report.model.api.scripts org.eclipse.birt.report.model.api.simpleapi org.eclipse.birt.report.model.api.util org.eclipse.birt.report.model.api.validators
用户在用java设计BIRT报表的时候都会或多或少的用到其中的4到5个包；
我们先看一个简单的例子：
package birt;import java.io.IOException;import java.util.ArrayList; import java.util.List;import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.model.api.CellHandle;import org.eclipse.birt.report.model.api.DataItemHandle;import org.eclipse.birt.report.model.api.DesignConfig; import org.eclipse.birt.report.model.api.ElementFactory;import org.eclipse.birt.report.model.api.IDesignEngine;import org.eclipse.birt.report.model.api.IDesignEngineFactory;import org.eclipse.birt.report.model.api.LabelHandle;import org.eclipse.birt.report.model.api.OdaDataSetHandle;import org.eclipse.birt.report.model.api.OdaDataSourceHandle;import org.eclipse.birt.report.model.api.PropertyHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.RowHandle;import org.eclipse.birt.report.model.api.SessionHandle;import org.eclipse.birt.report.model.api.StructureFactory;import org.eclipse.birt.report.model.api.TableHandle;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.elements.structures.ComputedColumn;import com.ibm.icu.util.ULocale;/** * Dynamic Table BIRT Design Engine API (DEAPI) demo. */public class DECreateDynamicTable { ReportDesignHandle designHandle = null; ElementFactory designFactory = null; StructureFactory structFactory = null; public static void main( String[] args ) { try { DECreateDynamicTable de = new DECreateDynamicTable(); List al = new ArrayList(); al.add("OFFICECODE"); al.add("CITY"); al.add("COUNTRY"); de.buildReport(al, "From Offices" ); } catch( IOException e ) { e.printStackTrace(); } catch( SemanticException e ) { e.printStackTrace(); } } void buildDataSource( ) throws SemanticException { OdaDataSourceHandle dsHandle = designFactory.newOdaDataSource( "Data Source", "org.eclipse.birt.report.data.oda.jdbc" ); dsHandle.setProperty( "odaDriverClass","org.eclipse.birt.report.data.oda.sampledb.Driver" ); dsHandle.setProperty( "odaURL", "jdbc:classicmodels:sampledb" ); dsHandle.setProperty( "odaUser", "ClassicModels" ); dsHandle.setProperty( "odaPassword", "" ); designHandle.getDataSources( ).add( dsHandle ); } void buildDataSet(List al, String fromClause ) throws SemanticException { OdaDataSetHandle dsHandle = designFactory.newOdaDataSet( "ds","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" ); dsHandle.setDataSource( "Data Source" ); String qry = "Select "; for( int i=0; i < al.size(); i++) { qry += " " + al.get(i); if( i != (al.size() -1) ) { qry += ","; } } qry += " " + fromClause; dsHandle.setQueryText( qry ); designHandle.getDataSets( ).add( dsHandle ); } void buildReport(List al, String fromClause ) throws IOException, SemanticException { //Configure the Engine and start the Platform DesignConfig config = new DesignConfig( ); config.setProperty("BIRT_HOME", "E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine"); IDesignEngine engine = null; try { Platform.startup( config ); IDesignEngineFactory factory = (IDesignEngineFactory) Platform.createFactoryObject( IDesignEngineFactory.EXTENSION_DESIGN_ENGINE_FACTORY ); engine = factory.createDesignEngine( config ); } catch( Exception ex ) { ex.printStackTrace(); } SessionHandle session = engine.newSessionHandle( ULocale.ENGLISH ) ; try { //open a design or a template designHandle = session.openDesign("d:\\sample.rptdesign"); designFactory = designHandle.getElementFactory( ); buildDataSource(); buildDataSet(al, fromClause); TableHandle table = designFactory.newTableItem( "table", al.size() ); table.setWidth( "100%" ); table.setDataSet( designHandle.findDataSet( "ds" ) ); PropertyHandle computedSet = table.getColumnBindings( ); ComputedColumn cs1 = null; for( int i=0; i < al.size(); i++) { cs1 = StructureFactory.createComputedColumn(); cs1.setName((String)al.get(i)); cs1.setExpression("dataSetRow[\"" + (String)al.get(i) + "\"]"); computedSet.addItem(cs1); } // table header RowHandle tableheader = (RowHandle) table.getHeader( ).get( 0 ); for( int i=0; i < al.size(); i++ ) { LabelHandle label1 = designFactory.newLabel( (String)al.get(i) ); label1.setText((String)al.get(i)); CellHandle cell = (CellHandle) tableheader.getCells( ).get( i ); cell.getContent( ).add( label1 ); } // table detail RowHandle tabledetail = (RowHandle) table.getDetail( ).get( 0 ); for( int i=0; i < al.size(); i++ ) { CellHandle cell = (CellHandle) tabledetail.getCells( ).get( i ); DataItemHandle data = designFactory.newDataItem( "data_"+(String)al.get(i) ); data.setResultSetColumn( (String)al.get(i)); cell.getContent( ).add( data ); } designHandle.getBody( ).add( table ); // Save the design and close it. designHandle.saveAs( "d:\\sample3.rptdesign" ); //$NON-NLS-1$ designHandle.close( ); System.out.println("Finished"); } catch (Exception e) { e.printStackTrace(); } } }这个例子一共有四个函数 ：
1 . Main 函数: 这个例子简单之处在与它可以直接的运行，只要你修改了
config.setProperty("BIRT_HOME", "E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine"); 指向你自己的Birt Runtime 解压后的ReportEngine 目录.
designHandle = session.openDesign("d:\\sample.rptdesign"); 你可以从Birt 里面建立一个新的Report template.然后指向这个report 就可以了
designHandle.saveAs( "d:\\sample3.rptdesign" ); //$NON-NLS-1$ 指定一个你想保存的位置，c:/temp 目录存在你才能够保存到c:/temp 目录下.
2 . buildDataSource 函数把一个ReportDesignHandle 的 Data Source 初始化, setProperties 左边的String 是不能变的，Data Source 的名字可以随便取，取DataSet 的时候要根据这个名字来取.
3 . buildDataSet 通过拼sql 的方式 ,来build DataSet, 注意sql 别拼错了.
4 . buildReport 注意element 的初始化顺序.在所有的DataItem 外面都是一层Cell,Cell 外面才是row .这个例子使用的row 来拼成table 的，也可以用column 来拼，相对应的数据处理也是一个column 一个 column 的处理的了
这个程序打开了一个名为sample的BIRT设计文件，往其中插入了一个1行3列的网格，列名分别为OFFICECODE，CITY，COUNTRY，没有做任何美化，另存为sample3.rptdesign
我们看看改变，sample.rptdesign预览如下：
sample3.rptdesign预览如下：
这种修改不仅能表现在设计阶段，我们在调用报表引擎进行展示的时候同样可以修改，源码如下：
package birt;import java.util.ArrayList;import java.util.HashMap;import java.util.logging.Level; import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.engine.api.EngineConfig;import org.eclipse.birt.report.engine.api.EngineConstants;import org.eclipse.birt.report.engine.api.EngineException;import org.eclipse.birt.report.engine.api.HTMLActionHandler;import org.eclipse.birt.report.engine.api.HTMLEmitterConfig;import org.eclipse.birt.report.engine.api.HTMLRenderContext;import org.eclipse.birt.report.engine.api.HTMLRenderOption;import org.eclipse.birt.report.engine.api.HTMLServerImageHandler;import org.eclipse.birt.report.engine.api.IReportEngine;import org.eclipse.birt.report.engine.api.IReportEngineFactory;import org.eclipse.birt.report.engine.api.IReportRunnable;import org.eclipse.birt.report.engine.api.IRunAndRenderTask;import org.eclipse.birt.report.model.api.CellHandle;import org.eclipse.birt.report.model.api.DataItemHandle;import org.eclipse.birt.report.model.api.ElementFactory;import org.eclipse.birt.report.model.api.LabelHandle;import org.eclipse.birt.report.model.api.OdaDataSetHandle;import org.eclipse.birt.report.model.api.OdaDataSourceHandle;import org.eclipse.birt.report.model.api.PropertyHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.RowHandle;import org.eclipse.birt.report.model.api.StructureFactory;import org.eclipse.birt.report.model.api.TableHandle;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.elements.structures.ComputedColumn;public class ExecuteModifedReport { public void runReport() throws EngineException { IReportEngine engine=null; EngineConfig config = null; try { //Configure the Engine and start the Platform config = new EngineConfig( ); config.setEngineHome( "E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine" ); config.setLogConfig(null, Level.FINE); Platform.startup( config ); IReportEngineFactory factory = (IReportEngineFactory) Platform.createFactoryObject( IReportEngineFactory.EXTENSION_REPORT_ENGINE_FACTORY ); engine = factory.createReportEngine( config ); engine.changeLogLevel( Level.WARNING ); } catch( Exception ex ) { ex.printStackTrace(); } //Configure the emitter to handle actions and images HTMLEmitterConfig emitterConfig = new HTMLEmitterConfig( ); emitterConfig.setActionHandler( new HTMLActionHandler( ) ); HTMLServerImageHandler imageHandler = new HTMLServerImageHandler( ); emitterConfig.setImageHandler( imageHandler ); config.getEmitterConfigs( ).put( "html", emitterConfig ); //$NON-NLS-1$ IReportRunnable design = null; //Open the report design design = engine.openReportDesign("d:\\sample.rptdesign"); ReportDesignHandle report = (ReportDesignHandle) design.getDesignHandle( ); buildReport( report ); //Create task to run and render the report, IRunAndRenderTask task = engine.createRunAndRenderTask(design); //Set Render context to handle url and image locataions HTMLRenderContext renderContext = new HTMLRenderContext(); //Set the Base URL for all actions renderContext.setBaseURL("baseurl"); //Tell the Engine to prepend all images with this URL - Note this requires using the HTMLServerImageHandler renderContext.setBaseImageURL("urltoimages"); //Tell the Engine where to write the images to renderContext.setImageDirectory("d:\\myimages"); //Tell the Engine what image formats are supported. Note you must have SVG in the string //to render charts in SVG. renderContext.setSupportedImageFormats("JPG;PNG;BMP;SVG"); HashMap contextMap = new HashMap(); contextMap.put( EngineConstants.APPCONTEXT_HTML_RENDER_CONTEXT, renderContext ); task.setAppContext( contextMap ); //Set parameters for the report //task.setParameterValues(parameters); //Alternatively set each seperately //task.setParameterValue("Top Count", new Integer(12)); //task.validateParameters(); HTMLRenderOption options = new HTMLRenderOption(); //Set ouptut location options.setOutputFileName("d:\\output.html"); //Set output format options.setOutputFormat("html"); task.setRenderOption(options); //run the report and destroy the engine //Note - If the program stays resident do not shutdown the Platform or the Engine task.run(); task.close(); engine.destroy(); Platform.shutdown(); System.out.println("Finished"); } public void buildReport(ReportDesignHandle designHandle) { try { ElementFactory designFactory = designHandle.getElementFactory( ); buildDataSource(designFactory, designHandle); ArrayList cols = new ArrayList(); cols.add("OFFICECODE"); cols.add("CITY"); cols.add("COUNTRY"); buildDataSet(cols, "From Offices", designFactory, designHandle); TableHandle table = designFactory.newTableItem( "table", cols.size() ); table.setWidth( "100%" ); table.setDataSet( designHandle.findDataSet( "ds" ) ); PropertyHandle computedSet = table.getColumnBindings( ); ComputedColumn cs1 = null; for( int i=0; i < cols.size(); i++ ) { cs1 = StructureFactory.createComputedColumn(); cs1.setName((String)cols.get(i)); cs1.setExpression("dataSetRow[\"" + (String)cols.get(i) + "\"]"); computedSet.addItem(cs1); } // table header RowHandle tableheader = (RowHandle) table.getHeader( ).get( 0 ); for( int i=0; i < cols.size(); i++ ) { LabelHandle label1 = designFactory.newLabel( (String)cols.get(i) ); label1.setText((String)cols.get(i)); CellHandle cell = (CellHandle) tableheader.getCells( ).get( i ); cell.getContent( ).add( label1 ); } // table detail RowHandle tabledetail = (RowHandle) table.getDetail( ).get( 0 ); for( int i=0; i < cols.size(); i++ ) { CellHandle cell = (CellHandle) tabledetail.getCells( ).get( i ); DataItemHandle data = designFactory.newDataItem( "data_"+(String)cols.get(i) ); data.setResultSetColumn( (String)cols.get(i)); cell.getContent( ).add( data ); } designHandle.getBody( ).add( table ); } catch(Exception e) { e.printStackTrace(); } } void buildDataSource( ElementFactory designFactory, ReportDesignHandle designHandle ) throws SemanticException { OdaDataSourceHandle dsHandle = designFactory.newOdaDataSource( "Data Source", "org.eclipse.birt.report.data.oda.jdbc" ); dsHandle.setProperty( "odaDriverClass", "org.eclipse.birt.report.data.oda.sampledb.Driver" ); dsHandle.setProperty( "odaURL", "jdbc:classicmodels:sampledb" ); dsHandle.setProperty( "odaUser", "ClassicModels" ); dsHandle.setProperty( "odaPassword", "" ); designHandle.getDataSources( ).add( dsHandle ); } void buildDataSet(ArrayList cols, String fromClause, ElementFactory designFactory, ReportDesignHandle designHandle ) throws SemanticException { OdaDataSetHandle dsHandle = designFactory.newOdaDataSet( "ds", "org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" ); dsHandle.setDataSource( "Data Source" ); String qry = "Select "; for( int i=0; i < cols.size(); i++ ) { qry += " " + cols.get(i); if( i != (cols.size() -1) ) { qry += ","; } } qry += " " + fromClause; dsHandle.setQueryText( qry ); designHandle.getDataSets( ).add( dsHandle ); } /** * @param args */ public static void main(String[] args) { try { ExecuteModifedReport ex = new ExecuteModifedReport( ); ex.runReport(); } catch ( Exception e ) { e.printStackTrace(); } }}产生的output.html内容如下：
为什么能在运行展示报表之前进行设计上的修改，这是由报表展示器的设计架构决定的，前面提过，BIRT的展示器是包含了BIRT 设计引擎的，主要是在产生报表引擎阶段，如下图所示：
BIRT设计引擎API包含了报表设计所有元素的handle类，其中最重要的一些handle类结构如下：
org.eclipse.birt.report.model.api.DesignElementHandle (implements org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel) org.eclipse.birt.report.model.api.AccessControlHandle (implements org.eclipse.birt.report.model.elements.interfaces.IAccessControlModel) org.eclipse.birt.report.model.api.ValueAccessControlHandle (implements org.eclipse.birt.report.model.elements.interfaces.IValueAccessControlModel) org.eclipse.birt.report.model.api.FilterConditionElementHandle (implements org.eclipse.birt.report.model.elements.interfaces.IFilterConditionElementModel) org.eclipse.birt.report.model.api.MemberValueHandle (implements org.eclipse.birt.report.model.elements.interfaces.IMemberValueModel) org.eclipse.birt.report.model.api.ModuleHandle (implements org.eclipse.birt.report.model.api.core.IModuleModel) org.eclipse.birt.report.model.api.LibraryHandle (implements org.eclipse.birt.report.model.elements.interfaces.ILibraryModel) org.eclipse.birt.report.model.api.ReportDesignHandle (implements org.eclipse.birt.report.model.elements.interfaces.IReportDesignModel) org.eclipse.birt.report.model.api.MultiViewsHandle (implements org.eclipse.birt.report.model.elements.interfaces.IMultiViewsModel) org.eclipse.birt.report.model.api.ReportElementHandleorg.eclipse.birt.report.model.api.CellHandle (implements org.eclipse.birt.report.model.elements.interfaces.ICellModel) org.eclipse.birt.report.model.api.ColumnHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITableColumnModel) org.eclipse.birt.report.model.api.olap.CubeHandle (implements org.eclipse.birt.report.model.elements.interfaces.ICubeModel) org.eclipse.birt.report.model.api.olap.OdaCubeHandle (implements org.eclipse.birt.report.model.elements.interfaces.IOdaOlapElementModel) org.eclipse.birt.report.model.api.olap.TabularCubeHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITabularCubeModel) org.eclipse.birt.report.model.api.DataSetHandle (implements org.eclipse.birt.report.model.elements.interfaces.IDataSetModel, org.eclipse.birt.report.model.elements.interfaces.ISimpleDataSetModel) org.eclipse.birt.report.model.api.JointDataSetHandle (implements org.eclipse.birt.report.model.elements.interfaces.IJointDataSetModel) org.eclipse.birt.report.model.api.OdaDataSetHandle (implements org.eclipse.birt.report.model.elements.interfaces.IOdaDataSetModel) org.eclipse.birt.report.model.api.ScriptDataSetHandle (implements org.eclipse.birt.report.model.elements.interfaces.IScriptDataSetModel) org.eclipse.birt.report.model.api.DataSourceHandle (implements org.eclipse.birt.report.model.elements.interfaces.IDataSourceModel) org.eclipse.birt.report.model.api.OdaDataSourceHandle (implements org.eclipse.birt.report.model.elements.interfaces.IOdaDataSourceModel, org.eclipse.birt.report.model.elements.interfaces.IOdaExtendableElementModel) org.eclipse.birt.report.model.api.ScriptDataSourceHandle (implements org.eclipse.birt.report.model.elements.interfaces.IScriptDataSourceModel) org.eclipse.birt.report.model.api.olap.DimensionHandle (implements org.eclipse.birt.report.model.elements.interfaces.IDimensionModel) org.eclipse.birt.report.model.api.olap.OdaDimensionHandle (implements org.eclipse.birt.report.model.elements.interfaces.IOdaOlapElementModel) org.eclipse.birt.report.model.api.olap.TabularDimensionHandleorg.eclipse.birt.report.model.api.GroupHandle (implements org.eclipse.birt.report.model.elements.interfaces.IGroupElementModel) org.eclipse.birt.report.model.api.ListGroupHandleorg.eclipse.birt.report.model.api.TableGroupHandleorg.eclipse.birt.report.model.api.olap.HierarchyHandle (implements org.eclipse.birt.report.model.elements.interfaces.IHierarchyModel) org.eclipse.birt.report.model.api.olap.OdaHierarchyHandle (implements org.eclipse.birt.report.model.elements.interfaces.IOdaOlapElementModel) org.eclipse.birt.report.model.api.olap.TabularHierarchyHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITabularHierarchyModel) org.eclipse.birt.report.model.api.olap.LevelHandle (implements org.eclipse.birt.report.model.elements.interfaces.ILevelModel) org.eclipse.birt.report.model.api.olap.OdaLevelHandleorg.eclipse.birt.report.model.api.olap.TabularLevelHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITabularLevelModel) org.eclipse.birt.report.model.api.MasterPageHandle (implements org.eclipse.birt.report.model.elements.interfaces.IMasterPageModel) org.eclipse.birt.report.model.api.GraphicMasterPageHandle (implements org.eclipse.birt.report.model.elements.interfaces.IGraphicMaterPageModel) org.eclipse.birt.report.model.api.SimpleMasterPageHandle (implements org.eclipse.birt.report.model.elements.interfaces.ISimpleMasterPageModel) org.eclipse.birt.report.model.api.olap.MeasureGroupHandle (implements org.eclipse.birt.report.model.elements.interfaces.IMeasureGroupModel) org.eclipse.birt.report.model.api.olap.OdaMeasureGroupHandleorg.eclipse.birt.report.model.api.olap.TabularMeasureGroupHandleorg.eclipse.birt.report.model.api.olap.MeasureHandle (implements org.eclipse.birt.report.model.elements.interfaces.IMeasureModel) org.eclipse.birt.report.model.api.olap.OdaMeasureHandleorg.eclipse.birt.report.model.api.olap.TabularMeasureHandleorg.eclipse.birt.report.model.api.ParameterGroupHandle (implements org.eclipse.birt.report.model.elements.interfaces.IParameterGroupModel) org.eclipse.birt.report.model.api.CascadingParameterGroupHandle (implements org.eclipse.birt.report.model.elements.interfaces.ICascadingParameterGroupModel) org.eclipse.birt.report.model.api.ParameterHandle (implements org.eclipse.birt.report.model.elements.interfaces.IParameterModel) org.eclipse.birt.report.model.api.ScalarParameterHandle (implements org.eclipse.birt.report.model.elements.interfaces.IScalarParameterModel) org.eclipse.birt.report.model.api.ReportItemHandle (implements org.eclipse.birt.report.model.api.elements.IReportItemMethodContext, org.eclipse.birt.report.model.elements.interfaces.IReportItemModel, org.eclipse.birt.report.model.elements.interfaces.IStyledElementModel) org.eclipse.birt.report.model.api.AutoTextHandle (implements org.eclipse.birt.report.model.elements.interfaces.IAutoTextModel) org.eclipse.birt.report.model.api.DataItemHandle (implements org.eclipse.birt.report.model.elements.interfaces.IDataItemModel) org.eclipse.birt.report.model.api.ExtendedItemHandle (implements org.eclipse.birt.report.model.elements.interfaces.IExtendedItemModel, org.eclipse.birt.report.model.api.elements.IReportItemMethodContext) org.eclipse.birt.report.model.api.FreeFormHandle (implements org.eclipse.birt.report.model.elements.interfaces.IFreeFormModel) org.eclipse.birt.report.model.api.GridHandle (implements org.eclipse.birt.report.model.elements.interfaces.IGridItemModel) org.eclipse.birt.report.model.api.ImageHandle (implements org.eclipse.birt.report.model.elements.interfaces.IImageItemModel) org.eclipse.birt.report.model.api.LabelHandle (implements org.eclipse.birt.report.model.elements.interfaces.ILabelModel) org.eclipse.birt.report.model.api.LineHandle (implements org.eclipse.birt.report.model.elements.interfaces.ILineItemModel) org.eclipse.birt.report.model.api.ListingHandle (implements org.eclipse.birt.report.model.elements.interfaces.IListingElementModel) org.eclipse.birt.report.model.api.ListHandleorg.eclipse.birt.report.model.api.TableHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITableItemModel) org.eclipse.birt.report.model.api.RectangleHandleorg.eclipse.birt.report.model.api.TextDataHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITextDataItemModel) org.eclipse.birt.report.model.api.MultiLineDataHandleorg.eclipse.birt.report.model.api.TextItemHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITextItemModel) org.eclipse.birt.report.model.api.RowHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITableRowModel) org.eclipse.birt.report.model.api.StyleHandle (implements org.eclipse.birt.report.model.elements.interfaces.IStyleModel) org.eclipse.birt.report.model.api.PrivateStyleHandleorg.eclipse.birt.report.model.api.SharedStyleHandleorg.eclipse.birt.report.model.api.CssSharedStyleHandleorg.eclipse.birt.report.model.api.TemplateElementHandleorg.eclipse.birt.report.model.api.TemplateDataSetHandleorg.eclipse.birt.report.model.api.TemplateReportItemHandleorg.eclipse.birt.report.model.api.TemplateParameterDefinitionHandle (implements org.eclipse.birt.report.model.elements.interfaces.ITemplateParameterDefinitionModel) org.eclipse.birt.report.model.api.ThemeHandle (implements org.eclipse.birt.report.model.elements.interfaces.IThemeModel) org.eclipse.birt.report.model.api.SortElementHandle (implements org.eclipse.birt.report.model.elements.interfaces.ISortElementModel) org.eclipse.birt.report.model.api.VariableElementHandle (implements org.eclipse.birt.report.model.elements.interfaces.IVariableElementModel)
报表设计器本身包含所有的这些引擎类，当然也包含用于数据源，图表，展示的引擎：
设计引擎中的主要类如下：
ReportDesignHandle类：
代表整个报表设计，报表设计定义了用于描述整个设计的特征，基础等等的一组属性。除了属性之外，报表设计也包含一些组成报表的元素。
这些元素包括：
Code Modules，适用于整个设计的全局脚本
Parameters，一个用于描述用户在运行报表时输入的数据参数元素的集合（list）
Data Sources，报表使用的数据源
Data Sets，报表定义的数据集
Color Palette，一个自定义的颜色名称的集合（set），并且是报表的一部分
Styles，用户在报表中自定义的用于格式化元素的样式文件，在这个样式文件的集合中，每种样式必须有唯一的名字。
Page Setup，代表报表内的母版页布局
Components，报表中定义的可重复使用的报表项目中。报表项目可以扩大这些项目。可以为这个设计定义了一个“私人图书馆”
Body，Visual报表的内容清单。内容是由一个或多个节组成的。一个节是一个报表项目填补了页面的宽度。它可以包含文字，表格，列表，表格等元素
Scratch Pad，当重建报表时需要提供一个临时的地方移动报表项目。
Translations，针对报表的额外的消息列表集合
Images 报表中嵌入的图像列表集合
模块允许使用在库中定义的组件
// Include one library ReportDesignHandle designHandle = ...; designHandle.includeLibrary( "libA.rptlibrary", "LibA" ); LibraryHandle libraryHandle = designHandle.getLibrary("LibA"); // Create one label based on the one in library LabelHandle labelHandle = (LabelHandle) libraryHandle.findElement("companyNameLabel"); LabelHandle myLabelHandle = (LabelHandle) designHandle.getElementFactory().newElementFrom( labelHandle, "myLabel" ); // Add the new label into design file designHandle.getBody().add(myLabelHandle);除了继承自org.eclipse.birt.report.model.api.ModuleHandle的方法，继承自org.eclipse.birt.report.model.api.DesignElementHandle的方法，LibraryHandle还有自有的方法：
ElementFactory类
创建一个新的报表元素，并返回处理它。使用这个类来创建报表元素。创建一个元素后，通过SlotHandle类中的增加方法将它添加到设计中。通过调用这个类的getElementFactory方法来获取一个实例
SessionHandle类
代表报表设计的状态 一个用户有一个session。在Eclipse环境中，这代表了开放的设计集。在网络环境中，这代表了开放设计的session和语言环境。session有一个默认的样式属性集合和默认单位。session还拥有一些方法来创建和打开的报表设计。
OdaDataSourceHandle类
代表数据源
OdaDataSetHandle类
代表数据集
DesignConfig类
报表设计引擎配置设置。允许引擎提供图像处理，超链接处理和字体处理等个性化的实现
IdesignEngine类
代表作为一个整体BIRT的设计引擎。用于创建新的会话session
IDesignEngineFactory类
工厂类，用于创建一个新的设计引擎实例。
TableHandle类
代表一个table元素。一个table有一个本地化的标题，并且可以重复其在每一页上的标题。一个table是一个结构化的行和列的清单集合。这些列被定义为整个表，这些行被聚集成集。
PropertyHandle类
一个用于处理一个元素的顶级物业工作的处理器
ComputedColumn类
描述了一个为数据集或报表查询而定义的计算列。计算列有一个名字，和一个JavaScript表达式，用于计算这个列的值
StructureFactory类
提供一个工厂方法，用于创建一个空的结构
RowHandle类
代表一个网格或者表格中的一行。每一行包含多个cell，每一行可以定义它的高度。
CellHandle类
代表了一个表或表格里的单元格cell。一个单元格cell可以跨越多个行或列。一个单元格cell可以包含零个，一个或多个内容content。不过，由于BIRT的多个项目将自动定位，如果单元格cell拥有多个项目，应用程序一般应提供其自己的集装箱container。
应用程序一般不直接创造cell处理器。相反，它使用的导航方法对其他元素提供一个处理诸如RowHandle。
DataItemHandle类
代表一个数据项元素。一个数据项有一个动作，值表达和帮助文本
EngineConfig类
环绕的报表引擎的配置设置。允许开发人员指定在何处寻找引擎插件，数据驱动，并在写图像文件。允许用户自定义数据相关的属性（即数据引擎）。也可以让引擎提供的图像处理，超链接处理和字体处理等个性化的实现
IReportEngineFactory
一个工厂类，用于创建报表引擎。
IReportEngine
代表一个报表引擎
一个报表引擎提供了报表功能的切入点。这是全球定制的报表生成和渲染过程。这也是引擎收集统计数据的地方。通过报表引擎，报表生成，并能提供不同的输出格式。查询也可以执行预览的目的，不涉及一个完整的报告生成
HTMLRenderOption
用于输出网页格式的报表
用户可以通过查询API文档查询每个handle的用法，如何修改设计，在此我不在把API文档粘贴过来，如下：
下面的例子演示了SessionHandle，ReportDesignHandle，IncludedCssStyleSheetHandle，SlotHandle，DesignElementHandle，PropertyHandle，StructureHandle，MemberHandle，GridHandle，ListingHandle，ImageHandle，ExtendedItemHandle的用法
package birtbird;import java.io.IOException;import java.util.Iterator;import java.util.List;import org.eclipse.birt.chart.model.Chart;import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.model.api.CellHandle;import org.eclipse.birt.report.model.api.DesignConfig;import org.eclipse.birt.report.model.api.DesignElementHandle;import org.eclipse.birt.report.model.api.ExtendedItemHandle;import org.eclipse.birt.report.model.api.GridHandle;import org.eclipse.birt.report.model.api.IDesignEngine;import org.eclipse.birt.report.model.api.IDesignEngineFactory;import org.eclipse.birt.report.model.api.ImageHandle;import org.eclipse.birt.report.model.api.IncludedCssStyleSheetHandle;import org.eclipse.birt.report.model.api.ListingHandle;import org.eclipse.birt.report.model.api.MemberHandle;import org.eclipse.birt.report.model.api.PropertyHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.RowHandle;import org.eclipse.birt.report.model.api.SessionHandle;import org.eclipse.birt.report.model.api.SlotHandle;import org.eclipse.birt.report.model.api.StructureHandle;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.metadata.IStructureDefn;import com.ibm.icu.util.ULocale;public class ReportDesignDetails {public static void main(String[] args) {try {buildReport();} catch (IOException e) {e.printStackTrace();} catch (SemanticException e) {e.printStackTrace();}}static void buildReport() throws IOException, SemanticException {// Create a session handle. This is used to manage all open designs.// Your app need create the session only once.DesignConfig config = new DesignConfig();config.setBIRTHome("E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine");IDesignEngine engine = null;try {Platform.startup(config);IDesignEngineFactory factory = (IDesignEngineFactory) Platform.createFactoryObject(IDesignEngineFactory.EXTENSION_DESIGN_ENGINE_FACTORY);engine = factory.createDesignEngine(config);} catch (Exception ex) {ex.printStackTrace();}SessionHandle session = engine.newSessionHandle(ULocale.ENGLISH);ReportDesignHandle design = null;try {design = session.openDesign("d:\\TopNPercent.rptdesign");List cssStyleSheets = design.getAllStyles();// getAllCssStyleSheets();int size = cssStyleSheets.size();Iterator myincludecssiter = design.includeCssesIterator();while (myincludecssiter.hasNext()) {IncludedCssStyleSheetHandle css = (IncludedCssStyleSheetHandle) myincludecssiter.next();// System.out.println( css.getFileName());}SlotHandle sh = design.getBody();System.out.println("Contents Count: " + sh.getCount());Iterator it = sh.iterator();while (it.hasNext()) {DesignElementHandle de = (DesignElementHandle) it.next();// System.out.println(de.getName());}sh = design.getDataSources();it = sh.iterator();while (it.hasNext()) {DesignElementHandle de = (DesignElementHandle) it.next();// System.out.println(de.getName());}sh = design.getDataSets();it = sh.iterator();while (it.hasNext()) {DesignElementHandle de = (DesignElementHandle) it.next();// System.out.println(de.getName());}sh = design.getMasterPages();it = sh.iterator();while (it.hasNext()) {DesignElementHandle de = (DesignElementHandle) it.next();// System.out.println(de.getName());}sh = design.getParameters();it = sh.iterator();while (it.hasNext()) {DesignElementHandle de = (DesignElementHandle) it.next();// System.out.println(de.getName());}System.out.println("Slot Count for a report design "+ design.getDefn().getSlotCount());for (int i = 0; i < design.getDefn().getSlotCount(); i++) {// System.out.println(" Slot " + i + " -- " +// design.getDefn().getSlot(i).getName());}Iterator pit = design.getPropertyIterator();while (pit.hasNext()) {PropertyHandle ph = (PropertyHandle) pit.next();IStructureDefn structDefn = ph.getPropertyDefn().getStructDefn();if (structDefn != null){// System.out.println("ListProperty " +// ph.getPropertyDefn().getDisplayName());Iterator structIterator = ph.iterator();while (structIterator.hasNext()) {StructureHandle structHandle = (StructureHandle) structIterator.next();Iterator memberIterator = structHandle.iterator();while (memberIterator.hasNext()){MemberHandle memHandle = (MemberHandle) memberIterator.next();// System.out.println( " Structure Item " +// memHandle.getDefn( ).getDisplayName( ) + "---" +// memHandle.getValue() );}}} else {System.out.println("StandardProperty "+ ph.getPropertyDefn().getDisplayName() + "--"+ ph.getValue());}}// Instantiate a slot handle and iterator for the body slot.SlotHandle shBody = design.getBody();Iterator slotIterator = shBody.iterator();// To retrieve top-level report items, iterate over the body.while (slotIterator.hasNext()) {Object shContents = slotIterator.next();// To get the contents of the top-level report items,// instantiate slot handles.if (shContents instanceof GridHandle) {GridHandle grid = (GridHandle) shContents;parseGrid(grid);}if (shContents instanceof ListingHandle) {ListingHandle list = (ListingHandle) shContents;parseList(list);}if (shContents instanceof ImageHandle) {String imageSource = ((ImageHandle) shContents).getSource();ImageHandle ih = (ImageHandle) shContents;System.out.println(ih.getImageName());// Check that the image has a URI.}if (shContents instanceof ExtendedItemHandle) {String type = ((ExtendedItemHandle) shContents).getExtensionName();if (type.compareToIgnoreCase("Crosstab") == 0) {System.out.println("Found a crosstab");}if (type.compareToIgnoreCase("Chart") == 0) {Chart cm = (Chart) ((ExtendedItemHandle) shContents).getReportItem().getProperty("chart.instance");System.out.println("Found chart of type "+ cm.getType());}}}design.close();Platform.shutdown();} catch (Exception e) {e.printStackTrace();}System.out.println("Finished");// We're done!}public static void parseGrid(GridHandle grid) {SlotHandle grRows = grid.getRows();Iterator rowIterator = grRows.iterator();parseRow(rowIterator);}public static void parseList(ListingHandle list) {SlotHandle grRows = list.getHeader();Iterator rowIterator = grRows.iterator();parseRow(rowIterator);grRows = list.getDetail();rowIterator = grRows.iterator();parseRow(rowIterator);grRows = list.getFooter();rowIterator = grRows.iterator();parseRow(rowIterator);grRows = list.getGroups();rowIterator = grRows.iterator();parseRow(rowIterator);}public static void parseRow(Iterator rowIterator) {while (rowIterator.hasNext()) {// Get RowHandle objects.Object rowSlotContents = rowIterator.next();// To find the image element, iterate over the grid.SlotHandle cellSlot = ((RowHandle) rowSlotContents).getCells();Iterator cellIterator = cellSlot.iterator();while (cellIterator.hasNext()) {// Get a CellHandle object.Object cellSlotContents = cellIterator.next();SlotHandle cellContentSlot = ((CellHandle) cellSlotContents).getContent();Iterator cellContentIterator = cellContentSlot.iterator();while (cellContentIterator.hasNext()) {// Get a DesignElementHandle object.Object cellContents = cellContentIterator.next();// Check that the element is an image.if (cellContents instanceof ImageHandle) {String imageSource = ((ImageHandle) cellContents).getSource();ImageHandle ih = (ImageHandle) cellContents;System.out.println(ih.getImageName());// Check that the image has a URI.}if (cellContents instanceof GridHandle) {parseGrid((GridHandle) cellContents);}if (cellContents instanceof ListingHandle) {parseList((ListingHandle) cellContents);}if (cellContents instanceof ExtendedItemHandle) {String type = ((ExtendedItemHandle) cellContents).getExtensionName();if (type.compareToIgnoreCase("Crosstab") == 0) {System.out.println("Found a crosstab");}if (type.compareToIgnoreCase("Chart") == 0) {try {Chart cm = (Chart) ((ExtendedItemHandle) cellContents).getReportItem().getProperty("chart.instance");System.out.println("Found chart of type "+ cm.getType());} catch (Exception e) {e.printStackTrace();}}}}}}}}上面的源码读取一个设计文档TopNPercent.rptdesign，并未进行修改，在控制台打印设计信息如下：
Contents Count: 3Slot Count for a report design 11StandardProperty Refresh rate--0StandardProperty Event handler class--nullStandardProperty New handler on each event--falseStandardProperty Layout preference--auto layoutStandardProperty Report orientation--ltrStandardProperty Enable Data Security--falseStandardProperty Cascade ACL--trueStandardProperty ACL expression--nullStandardProperty Image DPI--nullStandardProperty Page variables--nullStandardProperty Data objects--nullStandardProperty Locale--nullStandardProperty Initialize--nullStandardProperty On prepare--nullStandardProperty Before factory--nullStandardProperty After factory--nullStandardProperty Before render--nullStandardProperty After render--nullStandardProperty On page start--nullStandardProperty On page end--nullStandardProperty Display name--nullStandardProperty Display name key--nullStandardProperty Icon file--nullStandardProperty Cheat sheet--nullStandardProperty Thumbnail--nullStandardProperty Subject--nullStandardProperty Help guide--nullStandardProperty Base--nullStandardProperty Units--inStandardProperty Theme--nullStandardProperty Author--Mark CogginsStandardProperty Title--Top Classic Models Inc. Customers by RevenueStandardProperty Title key--nullStandardProperty Description--nullStandardProperty Description key--nullStandardProperty Comments--nullStandardProperty Include resource--nullStandardProperty Created by--Eclipse BIRT Designer Version 2.5.2.v20100208 Build <2.5.2.v20100210-0630>StandardProperty External Meta Data--nullC:\Documents and Settings\pclenahan\My Documents\ClassicModels\logos\Classic-Models-Full-M.jpgFound chart of type Bar ChartFinished
下面是一个综合利用各种报表元素handle生成的一个相对复杂的报表，加入了突出显示，报表参数，动态排序，聚合等等
package birtbird;import java.io.IOException;import java.util.ArrayList;import java.util.List;import java.io.BufferedInputStream;import java.io.IOException;import java.io.InputStream;import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.model.api.CellHandle;import org.eclipse.birt.report.model.api.ColumnHandle;import org.eclipse.birt.report.model.api.DataItemHandle;import org.eclipse.birt.report.model.api.DesignConfig;import org.eclipse.birt.report.model.api.ElementFactory;import org.eclipse.birt.report.model.api.IDesignEngine;import org.eclipse.birt.report.model.api.IDesignEngineFactory;import org.eclipse.birt.report.model.api.LabelHandle;import org.eclipse.birt.report.model.api.ImageHandle;import org.eclipse.birt.report.model.api.ActionHandle;import org.eclipse.birt.report.model.api.ReportElementHandle;import org.eclipse.birt.report.model.api.RowOperationParameters;import org.eclipse.birt.report.model.api.ScalarParameterHandle;import org.eclipse.birt.report.model.api.ScriptLibHandle;import org.eclipse.birt.report.model.api.TextItemHandle;import org.eclipse.birt.report.model.elements.JointDataSet;import org.eclipse.birt.report.model.api.OdaDataSetHandle;import org.eclipse.birt.report.model.api.JointDataSetHandle;import org.eclipse.birt.report.model.api.JoinConditionHandle;import org.eclipse.birt.report.model.api.OdaDataSourceHandle;import org.eclipse.birt.report.model.api.PropertyHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.RowHandle;import org.eclipse.birt.report.model.api.SessionHandle;import org.eclipse.birt.report.model.api.StructureFactory;import org.eclipse.birt.report.model.api.TableHandle;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.elements.structures.ComputedColumn;import org.eclipse.birt.report.model.api.PropertyHandle;import org.eclipse.birt.report.model.elements.ReportItem;import org.eclipse.birt.report.model.api.elements.structures.EmbeddedImage;import org.eclipse.birt.report.model.elements.Style;import org.eclipse.birt.report.model.elements.ReportDesign;import org.eclipse.birt.report.model.api.StyleHandle;import org.eclipse.birt.report.model.api.elements.structures.AggregationArgument;import org.eclipse.birt.report.model.api.elements.structures.DateTimeFormatValue;import org.eclipse.birt.report.model.api.elements.structures.FormatValue;import org.eclipse.birt.report.model.api.elements.structures.MapRule;import org.eclipse.birt.report.model.api.elements.structures.HideRule;import org.eclipse.birt.report.model.api.elements.structures.PropertyBinding;import org.eclipse.birt.report.model.api.elements.structures.TOC;import org.eclipse.birt.report.model.api.elements.structures.JoinCondition;import org.eclipse.birt.report.model.api.elements.structures.ParamBinding;import org.eclipse.birt.report.model.api.elements.DesignChoiceConstants;import org.eclipse.birt.report.model.api.elements.structures.HighlightRule;import org.eclipse.birt.report.model.elements.interfaces.IJointDataSetModel;import org.eclipse.birt.report.model.api.elements.structures.SortKey;import org.eclipse.birt.report.model.api.SortKeyHandle;import org.eclipse.birt.report.model.api.elements.structures.FilterCondition;import org.eclipse.birt.report.model.api.elements.structures.Action;import org.eclipse.birt.report.model.api.elements.structures.IncludeScript;import java.util.Iterator;import com.ibm.icu.util.ULocale;/** * Simple BIRT Design Engine API (DEAPI) demo. */public class StructFactoryTest {ReportDesignHandle designHandle = null;ElementFactory designFactory = null;StructureFactory structFactory = null;public static void main(String[] args) {try {StructFactoryTest de = new StructFactoryTest();de.buildReport();} catch (IOException e) {// TODO Auto-generated catch blocke.printStackTrace();} catch (SemanticException e) {// TODO Auto-generated catch blocke.printStackTrace();}}void buildDataSource() throws SemanticException {OdaDataSourceHandle dsHandle = designFactory.newOdaDataSource("Data Source", "org.eclipse.birt.report.data.oda.jdbc");dsHandle.setProperty("odaDriverClass","org.eclipse.birt.report.data.oda.sampledb.Driver");dsHandle.setProperty("odaURL", "jdbc:classicmodels:sampledb");dsHandle.setProperty("odaUser", "ClassicModels");dsHandle.setProperty("odaPassword", "");PropertyBinding pb = new PropertyBinding();designHandle.getDataSources().add(dsHandle);long currid = dsHandle.getID();}void buildDataSet() throws SemanticException {OdaDataSetHandle dsHandle = designFactory.newOdaDataSet("ds","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet");dsHandle.setDataSource("Data Source");String qry = "Select * from customers";dsHandle.setQueryText(qry);addFilterCondition(dsHandle);designHandle.getDataSets().add(dsHandle);}void buildDataSet2() throws SemanticException {OdaDataSetHandle dsHandle = designFactory.newOdaDataSet("ds2","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet");dsHandle.setDataSource("Data Source");String qry = "Select * from orderdetails where ordernumber = ?";dsHandle.setQueryText(qry);addFilterCondition(dsHandle);designHandle.getDataSets().add(dsHandle);}void buildJointDataSet() throws SemanticException {OdaDataSetHandle dsHandle1 = designFactory.newOdaDataSet("ds1","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet");dsHandle1.setDataSource("Data Source");String qry1 = "Select * from customers";dsHandle1.setQueryText(qry1);OdaDataSetHandle dsHandle2 = designFactory.newOdaDataSet("ds2","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet");dsHandle2.setDataSource("Data Source");String qry2 = "Select * from orders";dsHandle2.setQueryText(qry2);JointDataSetHandle jds = designFactory.newJointDataSet("test");designHandle.getDataSets().add(dsHandle1);designHandle.getDataSets().add(dsHandle2);jds.addDataSet("ds1");jds.addDataSet("ds2");String leftExpression = "dataSetRow[\"CUSTOMERNUMBER\"]";String rightExpression = "dataSetRow[\"CUSTOMERNUMBER\"]";JoinCondition condition = StructureFactory.createJoinCondition();condition.setJoinType(DesignChoiceConstants.JOIN_TYPE_LEFT_OUT);condition.setOperator(DesignChoiceConstants.JOIN_OPERATOR_EQALS);condition.setLeftDataSet("ds1"); //$NON-NLS-1$condition.setRightDataSet("ds2"); //$NON-NLS-1$condition.setLeftExpression(leftExpression); //$NON-NLS-1$condition.setRightExpression(rightExpression); //$NON-NLS-1$PropertyHandle conditionHandle = jds.getPropertyHandle(JointDataSet.JOIN_CONDITONS_PROP);conditionHandle.addItem(condition);designHandle.getDataSets().add(jds);}void addMapRule(TableHandle th) {try {MapRule mr = structFactory.createMapRule();mr.setTestExpression("row[\"CustomerCreditLimit\"]");mr.setOperator(DesignChoiceConstants.MAP_OPERATOR_EQ);mr.setValue1("0");mr.setDisplay("N/A");PropertyHandle ph = th.getPropertyHandle(StyleHandle.MAP_RULES_PROP);ph.addItem(mr);} catch (Exception e) {e.printStackTrace();}}void addVisRule(ReportElementHandle rh) {try {HideRule hr = structFactory.createHideRule();hr.setFormat("pdf");hr.setExpression("true");PropertyHandle ph = rh.getPropertyHandle(ReportItem.VISIBILITY_PROP);ph.addItem(hr);} catch (Exception e) {e.printStackTrace();}}void addBottomBorder(ReportElementHandle rh) {try {rh.setProperty(StyleHandle.BORDER_BOTTOM_COLOR_PROP, "#000000");rh.setProperty(StyleHandle.BORDER_BOTTOM_STYLE_PROP, "solid");rh.setProperty(StyleHandle.BORDER_BOTTOM_WIDTH_PROP, "2px");} catch (Exception e) {e.printStackTrace();}}void addHighLightRule(RowHandle th) {try {HighlightRule hr = structFactory.createHighlightRule();hr.setOperator(DesignChoiceConstants.MAP_OPERATOR_GT);hr.setTestExpression("row[\"CustomerCreditLimit\"]");hr.setValue1("100000");hr.setProperty(HighlightRule.BACKGROUND_COLOR_MEMBER, "blue");PropertyHandle ph = th.getPropertyHandle(StyleHandle.HIGHLIGHT_RULES_PROP);ph.addItem(hr);} catch (Exception e) {e.printStackTrace();}}void addSortKey(TableHandle th) {try {SortKey sk = structFactory.createSortKey();// sk.setKey("row[\"CustomerName\"]");sk.setDirection(DesignChoiceConstants.SORT_DIRECTION_ASC);sk.setKey("if( params[\"srt\"].value){ if( params[\"srt\"].value == 'a' ){row[\"CustomerName\"]; }else{ row[\"CustomerCity\"];}}");PropertyHandle ph = th.getPropertyHandle(TableHandle.SORT_PROP);ph.addItem(sk);} catch (Exception e) {e.printStackTrace();}}void modSortKey(TableHandle th) {try {SortKeyHandle sk;PropertyHandle ph = th.getPropertyHandle(TableHandle.SORT_PROP);// get number or iteratesk = (SortKeyHandle) ph.get(0);sk.setDirection(DesignChoiceConstants.SORT_DIRECTION_DESC);} catch (Exception e) {e.printStackTrace();}}void addFilterCondition(OdaDataSetHandle dh) {try {FilterCondition fc = structFactory.createFilterCond();fc.setExpr("row[\"COUNTRY\"]");fc.setOperator(DesignChoiceConstants.MAP_OPERATOR_EQ);fc.setValue1("'USA'");dh.addFilter(fc);} catch (Exception e) {e.printStackTrace();}}void addFilterCondition(TableHandle th) {try {FilterCondition fc = structFactory.createFilterCond();fc.setExpr("row[\"CustomerCountry\"]");fc.setOperator(DesignChoiceConstants.MAP_OPERATOR_EQ);fc.setValue1("'USA'");PropertyHandle ph = th.getPropertyHandle(TableHandle.FILTER_PROP);ph.addItem(fc);} catch (Exception e) {e.printStackTrace();}}void addHyperlink(LabelHandle lh) {try {Action ac = structFactory.createAction();ActionHandle actionHandle = lh.setAction(ac);// actionHandle.setURI("'http://www.google.com'");actionHandle.setLinkType(DesignChoiceConstants.ACTION_LINK_TYPE_DRILL_THROUGH);actionHandle.setReportName("d:\\TopNPercent.rptdesign");actionHandle.setTargetFileType("report-design");actionHandle.setTargetWindow("_blank");actionHandle.getMember("paramBindings");ParamBinding pb = structFactory.createParamBinding();pb.setParamName("order");pb.setExpression("row[\"ORDERNUMBER\"]");actionHandle.addParamBinding(pb);} catch (Exception e) {e.printStackTrace();}}void addToc(DataItemHandle dh) {try {TOC myToc = structFactory.createTOC("row[\"CustomerName\"]");dh.addTOC(myToc);} catch (Exception e) {e.printStackTrace();}}void addImage() {try {EmbeddedImage image = structFactory.createEmbeddedImage();image.setType(DesignChoiceConstants.IMAGE_TYPE_IMAGE_JPEG);image.setData(load("logo3.jpg"));image.setName("mylogo");designHandle.addImage(image);} catch (Exception e) {e.printStackTrace();}}public byte[] load(String fileName) throws IOException {InputStream is = null;is = new BufferedInputStream(this.getClass().getResourceAsStream(fileName));byte data[] = null;if (is != null) {try {data = new byte[is.available()];is.read(data);} catch (IOException e1) {throw e1;}}return data;}void addScript(ReportDesignHandle rh) {try {IncludeScript is = structFactory.createIncludeScript();is.setFileName("test.js");// PropertyHandle ph =// rh.getPropertyHandle(ReportDesign.INCLUDE_SCRIPTS_PROP);// ph.addItem(is);} catch (Exception e) {e.printStackTrace();}}void buildReport() throws IOException, SemanticException {DesignConfig config = new DesignConfig();config.setBIRTHome("E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine");IDesignEngine engine = null;try {Platform.startup(config);IDesignEngineFactory factory = (IDesignEngineFactory) Platform.createFactoryObject(IDesignEngineFactory.EXTENSION_DESIGN_ENGINE_FACTORY);engine = factory.createDesignEngine(config);} catch (Exception ex) {ex.printStackTrace();}SessionHandle session = engine.newSessionHandle(ULocale.ENGLISH);ReportDesignHandle design = null;try {// open a design or a templatedesignHandle = session.createDesign();addScript(designHandle);designFactory = designHandle.getElementFactory();buildDataSource();buildDataSet();buildJointDataSet();TableHandle table = designFactory.newTableItem("table", 3);table.setWidth("100%");table.setDataSet(designHandle.findDataSet("ds"));RowOperationParameters ro = new RowOperationParameters(2, -1, 0);table.insertRow(ro);PropertyHandle computedSet = table.getColumnBindings();ComputedColumn cs1, cs2, cs3, cs4, cs5;cs1 = StructureFactory.createComputedColumn();cs1.setName("CustomerName");cs1.setExpression("dataSetRow[\"CUSTOMERNAME\"]");computedSet.addItem(cs1);cs2 = StructureFactory.createComputedColumn();cs2.setName("CustomerCity");cs2.setExpression("dataSetRow[\"CITY\"]");// cs2.setDataType(dataType)computedSet.addItem(cs2);cs3 = StructureFactory.createComputedColumn();cs3.setName("CustomerCountry");cs3.setExpression("dataSetRow[\"COUNTRY\"]");computedSet.addItem(cs3);cs4 = StructureFactory.createComputedColumn();cs4.setName("CustomerCreditLimit");cs4.setExpression("dataSetRow[\"CREDITLIMIT\"]");computedSet.addItem(cs4);cs5 = StructureFactory.createComputedColumn();cs5.setName("CustomerCreditLimitSum");cs5.setExpression("dataSetRow[\"CREDITLIMIT\"]");cs5.setAggregateFunction("sum");computedSet.addItem(cs5);// table headerRowHandle tableheader = (RowHandle) table.getHeader().get(0);ColumnHandle ch = (ColumnHandle) table.getColumns().get(0);ch.setProperty("width", "50%");ColumnHandle ch2 = (ColumnHandle) table.getColumns().get(1);ch2.setSuppressDuplicates(true);LabelHandle label1 = designFactory.newLabel("Label1");label1.setOnRender("var x = 3;");addBottomBorder(label1);label1.setText("Customer");CellHandle cell = (CellHandle) tableheader.getCells().get(0);cell.getContent().add(label1);LabelHandle label2 = designFactory.newLabel("Label2");label2.setText("City");cell = (CellHandle) tableheader.getCells().get(1);cell.getContent().add(label2);LabelHandle label3 = designFactory.newLabel("Label3");label3.setText("Credit Limit");cell = (CellHandle) tableheader.getCells().get(2);cell.getContent().add(label3);// table detail (second Detail Row)RowHandle tabledetail = (RowHandle) table.getDetail().get(1);cell = (CellHandle) tabledetail.getCells().get(0);DataItemHandle data = designFactory.newDataItem("data1");data.setResultSetColumn("CustomerName");addToc(data);cell.getContent().add(data);cell = (CellHandle) tabledetail.getCells().get(1);data = designFactory.newDataItem("data2");data.setResultSetColumn("CustomerCity");cell.getContent().add(data);cell = (CellHandle) tabledetail.getCells().get(2);data = designFactory.newDataItem("data3");TextItemHandle tih = designFactory.newTextItem("mytextitem");// tih.setContentType(contentType);// tih.setContent(value);data.setResultSetColumn("CustomerCreditLimit");cell.getContent().add(data);FormatValue fv = structFactory.newFormatValue();fv.setPattern("#,##0.00{RoundingMode=HALF_UP}");fv.setCategory("custom");data.setProperty("numberFormat", fv);addHyperlink(label1);addMapRule(table);addHighLightRule(tabledetail);addSortKey(table);modSortKey(table);addFilterCondition(table);// addImage();RowHandle tablefooter = (RowHandle) table.getFooter().get(0);cell = (CellHandle) tablefooter.getCells().get(0);ImageHandle image1 = designFactory.newImage("mylogo");image1.setImageName("mylogo");// image1.sets// addVisRule( image1 );// cell.getContent( ).add( image1 );cell = (CellHandle) tablefooter.getCells().get(2);data = designFactory.newDataItem("datasum");data.setResultSetColumn("CustomerCreditLimitSum");cell.getContent().add(data);ScalarParameterHandle sph = designFactory.newScalarParameter("srt");sph.setIsRequired(false);// sph.setAllowNull(true);// sph.setAllowBlank(true);sph.setValueType(DesignChoiceConstants.PARAM_VALUE_TYPE_STATIC);sph.setDataType(DesignChoiceConstants.PARAM_TYPE_STRING);designHandle.getParameters().add(sph);// delete the row added earlier:table.getDetail().get(0).drop();designHandle.getBody().add(table);// designHandle.findElement("mytable");// Save the design and close it.designHandle.saveAs("d:\\structfactorytest.rptdesign");designHandle.close();Platform.shutdown();System.out.println("Finished");} catch (Exception e) {e.printStackTrace();}}}生成的structfactorytest.rptdesign预览如下：
输入参数srt为a之后的预览如下（故意显示了目录，srt等于a意味着要根据customer逆序排序）：
当然我们还能设计交叉报表和分组报表，下面就是一个设计交叉报表的案例：
package birtbird;import java.io.IOException;import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.item.crosstab.core.ICrosstabConstants;import org.eclipse.birt.report.item.crosstab.core.de.CrosstabCellHandle;import org.eclipse.birt.report.item.crosstab.core.de.CrosstabReportItemHandle;import org.eclipse.birt.report.item.crosstab.core.de.DimensionViewHandle;import org.eclipse.birt.report.item.crosstab.core.de.LevelViewHandle;import org.eclipse.birt.report.item.crosstab.core.de.MeasureViewHandle;import org.eclipse.birt.report.item.crosstab.core.util.CrosstabExtendedItemFactory;import org.eclipse.birt.report.model.api.ComputedColumnHandle;import org.eclipse.birt.report.model.api.DataItemHandle;import org.eclipse.birt.report.model.api.DataSetHandle;import org.eclipse.birt.report.model.api.DesignConfig;import org.eclipse.birt.report.model.api.DesignElementHandle;import org.eclipse.birt.report.model.api.ElementFactory;import org.eclipse.birt.report.model.api.ExtendedItemHandle;import org.eclipse.birt.report.model.api.IDesignEngine;import org.eclipse.birt.report.model.api.IDesignEngineFactory;import org.eclipse.birt.report.model.api.LabelHandle;import org.eclipse.birt.report.model.api.OdaDataSetHandle;import org.eclipse.birt.report.model.api.OdaDataSourceHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.ReportItemHandle;import org.eclipse.birt.report.model.api.SessionHandle;import org.eclipse.birt.report.model.api.StructureFactory;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.elements.DesignChoiceConstants;import org.eclipse.birt.report.model.api.elements.structures.ComputedColumn;import org.eclipse.birt.report.model.api.extension.IReportItem;import org.eclipse.birt.report.model.api.olap.MeasureGroupHandle;import org.eclipse.birt.report.model.api.olap.MeasureHandle;import org.eclipse.birt.report.model.api.olap.TabularCubeHandle;import org.eclipse.birt.report.model.api.olap.TabularDimensionHandle;import org.eclipse.birt.report.model.api.olap.TabularHierarchyHandle;import org.eclipse.birt.report.model.api.olap.TabularLevelHandle;import org.eclipse.birt.report.model.elements.interfaces.ICubeModel;import com.ibm.icu.util.ULocale;public class CreateDataCube{ReportDesignHandle designHandle = null;ElementFactory designFactory = null;StructureFactory structFactory = null;public static void main( String[] args ){try{CreateDataCube de = new CreateDataCube();de.buildReport();}catch ( IOException e ){e.printStackTrace();}catch ( SemanticException e ){e.printStackTrace();}}void buildDataSource( ) throws SemanticException{OdaDataSourceHandle dsHandle = designFactory.newOdaDataSource("Data Source", "org.eclipse.birt.report.data.oda.jdbc" );dsHandle.setProperty( "odaDriverClass","org.eclipse.birt.report.data.oda.sampledb.Driver" );dsHandle.setProperty( "odaURL", "jdbc:classicmodels:sampledb" );dsHandle.setProperty( "odaUser", "ClassicModels" );dsHandle.setProperty( "odaPassword", "" );designHandle.getDataSources( ).add( dsHandle );}void buildDataSet( ) throws SemanticException{OdaDataSetHandle dsHandle = designFactory.newOdaDataSet( "ds","org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" );dsHandle.setDataSource( "Data Source" );String qry = "Select * from customers";dsHandle.setQueryText( qry );designHandle.getDataSets( ).add( dsHandle );}void buidCube() throws SemanticException{TabularCubeHandle cubeHandle = designHandle.getElementFactory( ).newTabularCube( "MyCube" );cubeHandle.setDataSet((DataSetHandle)designHandle.getDataSets().get(0));designHandle.getCubes( ).add( cubeHandle );// measure groupMeasureGroupHandle measureGroupHandle = designHandle.getElementFactory( ).newTabularMeasureGroup("testMeasureGroup" );cubeHandle.setProperty( ICubeModel.MEASURE_GROUPS_PROP,measureGroupHandle );measureGroupHandle.add( MeasureGroupHandle.MEASURES_PROP, designFactory.newTabularMeasure( null ) );MeasureHandle measure = (MeasureHandle) measureGroupHandle.getContent(MeasureGroupHandle.MEASURES_PROP, 0 );measure.setName( "CREDITLIMIT" );measure.setMeasureExpression( "dataSetRow['CREDITLIMIT']" );measure.setFunction( DesignChoiceConstants.MEASURE_FUNCTION_SUM );measure.setCalculated( false );measure.setDataType( DesignChoiceConstants.COLUMN_DATA_TYPE_FLOAT );TabularDimensionHandle dimension = designFactory.newTabularDimension( null );cubeHandle.add(TabularCubeHandle.DIMENSIONS_PROP, dimension );dimension.setTimeType( false );dimension.add( TabularDimensionHandle.HIERARCHIES_PROP, designFactory.newTabularHierarchy( null ) );TabularHierarchyHandle hierarchy = (TabularHierarchyHandle) dimension.getContent( TabularDimensionHandle.HIERARCHIES_PROP, 0 );hierarchy.setDataSet( (DataSetHandle)designHandle.getDataSets().get(0) ); hierarchy.add( TabularHierarchyHandle.LEVELS_PROP, designFactory.newTabularLevel( dimension, null ) );TabularLevelHandle level = (TabularLevelHandle) hierarchy.getContent(TabularHierarchyHandle.LEVELS_PROP, 0 );level.setName( "testlevel" );level.setColumnName( "CUSTOMERNAME" );level.setDataType( DesignChoiceConstants.COLUMN_DATA_TYPE_STRING );ExtendedItemHandle xtab = CrosstabExtendedItemFactory.createCrosstabReportItem(designHandle, cubeHandle, "MyCrosstab" );designHandle.getBody().add(xtab);IReportItem reportItem = xtab.getReportItem( );CrosstabReportItemHandle xtabHandle = (CrosstabReportItemHandle) reportItem;DimensionViewHandle dvh = xtabHandle.insertDimension(dimension, ICrosstabConstants.ROW_AXIS_TYPE, 0);LevelViewHandle levelViewHandle =dvh.insertLevel(level, 0);CrosstabCellHandle cellHandle = levelViewHandle.getCell( );DesignElementHandle eii = xtabHandle.getModelHandle( );ComputedColumn bindingColumn = StructureFactory.newComputedColumn( eii, level.getName( ) );ComputedColumnHandle bindingHandle = ((ReportItemHandle) eii).addColumnBinding( bindingColumn,false );bindingColumn.setDataType( level.getDataType( ) );String exp = "dimension['" + dimension.getName()+"']['"+level.getName()+"']";bindingColumn.setExpression( exp);DataItemHandle dataHandle = designFactory.newDataItem( level.getName( ) );dataHandle.setResultSetColumn( bindingHandle.getName( ) );cellHandle.addContent( dataHandle );MeasureViewHandle mvh = xtabHandle.insertMeasure(measure, 0);//mvh.addHeader( );LabelHandle labelHandle = designFactory.newLabel( null );labelHandle.setText( measure.getName() );mvh.getHeader( ).addContent( labelHandle );}void buildReport() throws IOException, SemanticException{DesignConfig config = new DesignConfig( );config.setBIRTHome("E:\\birt汉化包\\birt-runtime-3_7_2\\ReportEngine");IDesignEngine engine = null;try{Platform.startup( config );IDesignEngineFactory factory = (IDesignEngineFactory) Platform.createFactoryObject( IDesignEngineFactory.EXTENSION_DESIGN_ENGINE_FACTORY );engine = factory.createDesignEngine( config );}catch( Exception ex){ex.printStackTrace();}SessionHandle session = engine.newSessionHandle( ULocale.ENGLISH ) ;try{//open a design or a templatedesignHandle = session.createDesign();designFactory = designHandle.getElementFactory( );buildDataSource();buildDataSet();buidCube();// Save the design and close it.designHandle.saveAs("d:\\cubetest.rptdesign" );designHandle.close( );Platform.shutdown();System.out.println("Finished");}catch (Exception e){e.printStackTrace();}}}生成的cubetest.rptdesign预览如下：
下面是一个设计图表的例子：
package birtbird;import java.io.IOException;import org.eclipse.birt.chart.model.Chart;import org.eclipse.birt.chart.model.ChartWithAxes;import org.eclipse.birt.chart.model.attribute.AxisType;import org.eclipse.birt.chart.model.attribute.IntersectionType;import org.eclipse.birt.chart.model.attribute.LegendItemType;import org.eclipse.birt.chart.model.attribute.Palette;import org.eclipse.birt.chart.model.attribute.TickStyle;import org.eclipse.birt.chart.model.attribute.impl.ColorDefinitionImpl;import org.eclipse.birt.chart.model.attribute.impl.PaletteImpl;import org.eclipse.birt.chart.model.component.Axis;import org.eclipse.birt.chart.model.component.Series;import org.eclipse.birt.chart.model.component.impl.SeriesImpl;import org.eclipse.birt.chart.model.data.BaseSampleData;import org.eclipse.birt.chart.model.data.DataFactory;import org.eclipse.birt.chart.model.data.OrthogonalSampleData;import org.eclipse.birt.chart.model.data.SampleData;import org.eclipse.birt.chart.model.data.SeriesDefinition;import org.eclipse.birt.chart.model.data.impl.QueryImpl;import org.eclipse.birt.chart.model.data.impl.SeriesDefinitionImpl;import org.eclipse.birt.chart.model.impl.ChartWithAxesImpl;import org.eclipse.birt.chart.model.layout.Legend;import org.eclipse.birt.chart.model.layout.Plot;import org.eclipse.birt.chart.model.type.LineSeries;import org.eclipse.birt.chart.model.type.impl.LineSeriesImpl;import org.eclipse.birt.core.framework.Platform;import org.eclipse.birt.report.model.api.DesignConfig;import org.eclipse.birt.report.model.api.ElementFactory;import org.eclipse.birt.report.model.api.ExtendedItemHandle;import org.eclipse.birt.report.model.api.IDesignEngine;import org.eclipse.birt.report.model.api.IDesignEngineFactory;import org.eclipse.birt.report.model.api.OdaDataSetHandle;import org.eclipse.birt.report.model.api.OdaDataSourceHandle;import org.eclipse.birt.report.model.api.ReportDesignHandle;import org.eclipse.birt.report.model.api.SessionHandle;import org.eclipse.birt.report.model.api.SimpleMasterPageHandle;import org.eclipse.birt.report.model.api.StructureFactory;import org.eclipse.birt.report.model.api.activity.SemanticException;import org.eclipse.birt.report.model.api.command.ContentException;import org.eclipse.birt.report.model.api.command.NameException;import org.eclipse.birt.report.model.api.elements.structures.PropertyBinding;import com.ibm.icu.util.ULocale;public class SimpleChart{ private ReportDesignHandle reportDesignHandle = null; private ElementFactory elementFactory = null; private OdaDataSourceHandle odaDataSourceHandle = null; private String dataSourceName = "datasource"; private String dataSetName = "maindataset"; private SessionHandle sessionHandle =null;org.eclipse.birt.report.model.api.elements.structures.ComputedColumn cs1, cs2 = null; public static void main(String args[]) { try { new SimpleChart().createReport(); } catch (Exception e) { e.printStackTrace(); } } public void createReport() throws SemanticException, IOException { System.out.println("Start"); init(); createMasterPages(); buildDataSource(); buildDataSet(); createBody(); reportDesignHandle.saveAs("d:\\simplechart.rptdesign"); reportDesignHandle.close( );Platform.shutdown();System.out.println("Finished"); } private void init(){DesignConfig config = new DesignConfig( );config.setBIRTHome("");IDesignEngine engine = null; try { Platform.startup(config); IDesignEngineFactory factory = (IDesignEngineFactory) Platform .createFactoryObject(IDesignEngineFactory.EXTENSION_DESIGN_ENGINE_FACTORY); engine = factory.createDesignEngine(config); } catch (Exception ex) { ex.printStackTrace(); } sessionHandle = engine.newSessionHandle(ULocale.ENGLISH); reportDesignHandle = sessionHandle.createDesign(); elementFactory = reportDesignHandle.getElementFactory(); } private void createMasterPages() throws ContentException, NameException { SimpleMasterPageHandle simpleMasterPage = elementFactory.newSimpleMasterPage("Master Page"); reportDesignHandle.getMasterPages().add(simpleMasterPage); }void buildDataSource( ) throws SemanticException{OdaDataSourceHandle dsHandle = elementFactory.newOdaDataSource("Data Source", "org.eclipse.birt.report.data.oda.jdbc" );dsHandle.setProperty( "odaDriverClass","org.eclipse.birt.report.data.oda.sampledb.Driver" );dsHandle.setProperty( "odaURL", "jdbc:classicmodels:sampledb" );dsHandle.setProperty( "odaUser", "ClassicModels" );dsHandle.setProperty( "odaPassword", "" );PropertyBinding pb = new PropertyBinding();reportDesignHandle.getDataSources( ).add( dsHandle );}void buildDataSet( ) throws SemanticException{OdaDataSetHandle dsHandle = elementFactory.newOdaDataSet( dataSetName,"org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet" );dsHandle.setDataSource( "Data Source" );String qry = "Select PRODUCTCODE, QUANTITYORDERED from orderdetails where ordernumber = 10104";dsHandle.setQueryText( qry );reportDesignHandle.getDataSets( ).add( dsHandle );} private void createBody() throws SemanticException { ExtendedItemHandle extendedItemHandle = elementFactory.newExtendedItem("Simple Chart", "Chart"); extendedItemHandle.setWidth("700px"); extendedItemHandle.setHeight("500px"); extendedItemHandle.setProperty(ExtendedItemHandle.DATA_SET_PROP, dataSetName); extendedItemHandle.setProperty("outputFormat","PNG"); Chart c = createChart(); extendedItemHandle.getReportItem().setProperty( "chart.instance", c ); reportDesignHandle.getBody().add(extendedItemHandle);cs1 = StructureFactory.createComputedColumn( );cs1.setName( "PRODUCTCODE" );cs1.setExpression( "dataSetRow[\"PRODUCTCODE\"]");cs1.setDataType( "string" );cs1.setAggregateOn(null);cs2 = StructureFactory.createComputedColumn( );cs2.setName( "QUANTITYORDERED" );cs2.setExpression( "dataSetRow[\"QUANTITYORDERED\"]");cs2.setDataType( "integer" );extendedItemHandle.addColumnBinding(cs1, true);extendedItemHandle.addColumnBinding(cs2, true); } private Chart createChart() { ChartWithAxes cwaLine = ChartWithAxesImpl.create(); cwaLine.setType( "Line Chart" ); //$NON-NLS-1$ cwaLine.setSubType( "Overlay" ); //$NON-NLS-1$ cwaLine.getBlock().getBounds().setWidth(600); cwaLine.getBlock().getBounds().setHeight(400); // Plot cwaLine.getBlock().setBackground( ColorDefinitionImpl.WHITE() ); Plot p = cwaLine.getPlot(); p.getClientArea().setBackground( ColorDefinitionImpl.create( 255, 255, 225 ) ); // Title cwaLine.getTitle().getLabel().getCaption().setValue("Overlay test Line Chart" ); cwaLine.getTitle().setVisible(true); // Legend cwaLine.getLegend().setVisible( true );Legend lg = cwaLine.getLegend();lg.setItemType(LegendItemType.CATEGORIES_LITERAL); // X-Axis Axis xAxisPrimary = cwaLine.getPrimaryBaseAxes()[0]; xAxisPrimary.setType( AxisType.TEXT_LITERAL ); xAxisPrimary.getMajorGrid().setTickStyle( TickStyle.BELOW_LITERAL ); xAxisPrimary.getOrigin().setType( IntersectionType.MIN_LITERAL ); // Y-Axis Axis yAxisPrimary = cwaLine.getPrimaryOrthogonalAxis( xAxisPrimary ); yAxisPrimary.setType(AxisType.LINEAR_LITERAL); yAxisPrimary.getMajorGrid().setTickStyle( TickStyle.RIGHT_LITERAL ); yAxisPrimary.getLabel().getCaption().setValue("TEST"); yAxisPrimary.getLabel().setVisible(true); SampleData sd = DataFactory.eINSTANCE.createSampleData( );BaseSampleData sdBase = DataFactory.eINSTANCE.createBaseSampleData( );sdBase.setDataSetRepresentation( "Category-A, Category-B" );//$NON-NLS-1$sd.getBaseSampleData( ).add( sdBase );OrthogonalSampleData sdOrthogonal = DataFactory.eINSTANCE.createOrthogonalSampleData( );sdOrthogonal.setDataSetRepresentation( "4,12" );//$NON-NLS-1$sdOrthogonal.setSeriesDefinitionIndex( 0 );sd.getOrthogonalSampleData( ).add( sdOrthogonal );cwaLine.setSampleData( sd );Series seCategory = SeriesImpl.create( );seCategory.getDataDefinition( ).add( QueryImpl.create( "row[\"PRODUCTCODE\"]" ) );SeriesDefinition sdX = SeriesDefinitionImpl.create( );Palette palx = PaletteImpl.create(10, false);sdX.setSeriesPalette(palx);xAxisPrimary.getSeriesDefinitions( ).add( sdX );sdX.getSeries( ).add( seCategory );// Y-SeriesLineSeries bs1 = (LineSeries) LineSeriesImpl.create( );bs1.getDataDefinition( ).add( QueryImpl.create( "row[\"QUANTITYORDERED\"]" ) );bs1.getLabel( ).setVisible( true );SeriesDefinition sdY = SeriesDefinitionImpl.create( );sdY.getGrouping().setEnabled(false);yAxisPrimary.getSeriesDefinitions( ).add( sdY );sdY.getSeries( ).add( bs1 ); return cwaLine; }} 生成的simplechart.rptdesign预览如下：
由于图表的设计和展示有单独的API,事件机制的脚本也是，后面我会单独为图表详细描述。
