目录

SemanticsManager - 语义层管理类

4.5. SemanticsManager - 语义层管理类

  • 类说明 在报表设计器中，对语义层查看或者编辑，一般是通过语义层设计器，如果用API对语义层进行操作呢？SemanticsManager这个类将是你使用API操作语义层的入口。 从功能上讲，这个类主要完成语义层文件及枚举文件的创建、加载与保存，并且把语义文件解析成视图、编辑风络、外部参数、数据管道等四种对象，我们可以根据解析的结果，直接获取得到这些对象。

    使用举例请参考应用开发教程第3章第3.1.3、3.3.1、3.5.3.2、3.6.2小节

  • 可用方法

    createXMLString

    语 法： public static java.lang.String createXMLString(java.lang.String s)

    参数说明： s -输入字符串

    功能说明： 调整xml的字符串，将其中的"<"和"&"替换为"<"和"&"，并将结果按照UTF-8编码，也可以用它来创建一个空的语义层文件。

    Returns : 调整后的字符串

    调用举例： SemanticsManager sm = new SemanticsManager(); sm.createXMLString("");//创建一个新的语义层文件

    editTableRelation

    语 法： public TableRelations editTableRelation(TableRelations trs)

    参数说明： trs -表视图的填报属性

    功能说明： 在填报中，将表视图的填报属性修改为实际表的填报属性

    Returns : 实际表的填报属性

    调用举例： 略

    getAttributes

    语 法： public java.util.ArrayList getAttributes()

    功能说明： 取会话变量列表

    Returns : 会话变量列表

    调用举例： 略

    getDataPipeList

    语 法： public DataPipeList getDataPipeList()

    功能说明： 取数据管道列表

    Returns : 数据管道列表对象

    调用举例： 略

    setDataPipeList

    语 法： public void setDataPipeList(DataPipeList dataPipeList)

    参数说明： dataPipeList –数据管道列表

    功能说明： 设数据管道列表

    调用举例： 略

    getEditStyleList

    语 法： public EditStyleList getEditStyleList()

    功能说明： 取编辑风格列表

    Returns : 编辑风格列表对象

    调用举例： 略

    setEditStyleList

    语 法： public void setEditStyleList(EditStyleList editStyleList)

    参数说明： dataPipeList –编辑风格列表

    功能说明： 设编辑风格列表

    调用举例： 略

    getView

    语 法： public View getView(java.lang.String viewName)

    参数说明： viewName - 视图名称

    功能说明： 按名称取视图对象，视图主要分四种，他们放在同一个视图列表中，所以不管是SQL视图，还是表视图，他们取名必须是互斥，比如，在SQL视图中，有一个视图名为emp，那么，在同一个语义文件中，表视图中不可能再会有emp。 Returns : 视图，我们可以通过instanceof语句来判断具体属于哪一种视图。

    调用举例： View v = sm.getView(“员工表”); if (v instanceof SQLView) { SQLView new_v = (SQLView) v; }

    getViewList

    语 法： public ViewList getViewList()

    功能说明： 取视图列表。

    Returns : 视图列表

    调用举例： 略

    setViewList

    语 法： public void setViewList(ViewList viewList)

    参数说明： viewList - 视图列表

    功能说明： 设视图列表

    调用举例： 略

    readXMLStream

    语 法： public void readXMLStream(java.io.InputStream is)

    参数说明： is –文件输入流

    功能说明： 以流的方式读取语义层文件

    调用举例： 略

    readXML

    语 法： public void readXML(java.lang.String fileName)

    参数说明： fileName–文件的绝对路径

    功能说明： 读取给定绝对路径的语义层文件

    调用举例： 略

    writeXML

    语 法： public void writeXML(java.lang.String fileName)

    参数说明： fileName–文件的绝对路径

    功能说明： 输出语义层到指定的文件

    调用举例： 略