org.eclipse.birt.report.model.api
Class ModuleUtil

java.lang.Object
  extended byorg.eclipse.birt.report.model.api.ModuleUtil

public class ModuleUtil
extends java.lang.Object

Provides some tool methods about the modules.


Field Summary
static int INVALID_MODULE
          The invalid module.
static int LIBRARY
          The library type.
static int REPORT_DESIGN
          The report design type.
 
Constructor Summary
ModuleUtil()
           
 
Method Summary
static int checkModule(SessionHandle sessionHandle, java.lang.String fileName, java.io.InputStream is)
          Checks the input stream with given file name.
static java.util.List checkVersion(java.lang.String fileName)
          Checks whether the opening design file holds a version number before the some specific features is supported.
static ActionHandle deserializeAction(java.io.InputStream streamData)
          Deserialize an input stream into an Action.
static ActionHandle deserializeAction(java.io.InputStream streamData, DesignElementHandle element)
          Deserialize an input stream into an Action.
static ActionHandle deserializeAction(java.lang.String strData)
          Deserialize a string into an ActionHandle, notice that the handle is faked, the action is not in the design tree, the operation to the handle is not able to be undoned.
static ActionHandle deserializeAction(java.lang.String strData, DesignElementHandle element)
          Deserialize a string into an ActionHandle, notice that the handle is faked, the action is not in the design tree, the operation to the handle is not able to be undoned.
static java.lang.String getExternalizedValue(DesignElementHandle element, java.lang.String key, java.lang.String value, com.ibm.icu.util.ULocale locale)
          Returns externalized message for the given locale.
static boolean isEqualHierarchiesForJointCondition(HierarchyHandle conditionHierarchy, HierarchyHandle cubeHierarchy)
          This API is only for helping GUI to draw the dimension joint condition editor pad.
static boolean isListFilterValue(FilterConditionElementHandle filter)
          Determine if the value1 of this filter condition is a list.
static boolean isListFilterValue(FilterConditionHandle filter)
          Determine if the value1 of this filter condition is a list.
static boolean isValidDesign(SessionHandle sessionHandle, java.lang.String fileName, java.io.InputStream is)
          Justifies whether a given input stream is a valid report design.
static boolean isValidElementName(DesignElementHandle elementHandle)
          checks is the name value is valid for the design element.
static boolean isValidElementName(DesignElementHandle elementHandle, java.lang.String propName, java.lang.String nameValue)
          checks if the name of the element is valid.
static boolean isValidLibrary(SessionHandle sessionHandle, java.lang.String fileName, java.io.InputStream is)
          Justifies whether a library resource with the given file name is a valid library.
static java.lang.String serializeAction(ActionHandle action)
          Serialize an action into a stream, the stream is in UTF-8 encoding.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

LIBRARY

public static final int LIBRARY
The library type.

See Also:
Constant Field Values

REPORT_DESIGN

public static final int REPORT_DESIGN
The report design type.

See Also:
Constant Field Values

INVALID_MODULE

public static final int INVALID_MODULE
The invalid module.

See Also:
Constant Field Values
Constructor Detail

ModuleUtil

public ModuleUtil()
Method Detail

deserializeAction

public static ActionHandle deserializeAction(java.io.InputStream streamData)
                                      throws DesignFileException
Deserialize an input stream into an Action.

Parameters:
streamData - a stream represent an action.
Returns:
an internal Action structure
Throws:
DesignFileException - if the exception occur when interpret the stream data.

deserializeAction

public static ActionHandle deserializeAction(java.io.InputStream streamData,
                                             DesignElementHandle element)
                                      throws DesignFileException
Deserialize an input stream into an Action.

Parameters:
streamData - a stream represent an action.
element -
Returns:
an internal Action structure
Throws:
DesignFileException - if the exception occur when interpret the stream data.

deserializeAction

public static ActionHandle deserializeAction(java.lang.String strData)
                                      throws DesignFileException
Deserialize a string into an ActionHandle, notice that the handle is faked, the action is not in the design tree, the operation to the handle is not able to be undoned.

Parameters:
strData - a string represent an action.
Returns:
a handle to the action.
Throws:
DesignFileException - if the exception occur when interpret the stream data.

deserializeAction

public static ActionHandle deserializeAction(java.lang.String strData,
                                             DesignElementHandle element)
                                      throws DesignFileException
Deserialize a string into an ActionHandle, notice that the handle is faked, the action is not in the design tree, the operation to the handle is not able to be undoned.

Parameters:
strData - a string represent an action.
element -
Returns:
a handle to the action.
Throws:
DesignFileException - if the exception occur when interpret the stream data.

serializeAction

public static java.lang.String serializeAction(ActionHandle action)
                                        throws java.io.IOException
Serialize an action into a stream, the stream is in UTF-8 encoding.

Parameters:
action - a given action structure.
Returns:
an output stream represent the action xml data.
Throws:
java.io.IOException - if I/O exception occur when writing the stream.

isValidDesign

public static boolean isValidDesign(SessionHandle sessionHandle,
                                    java.lang.String fileName,
                                    java.io.InputStream is)
Justifies whether a given input stream is a valid report design.

Parameters:
sessionHandle - the current session of the report design
fileName - the file name of the report design
is - the input stream of the report design
Returns:
true if the input stream is a valid report design, otherwise false

isValidLibrary

public static boolean isValidLibrary(SessionHandle sessionHandle,
                                     java.lang.String fileName,
                                     java.io.InputStream is)
Justifies whether a library resource with the given file name is a valid library.

Parameters:
sessionHandle - the current session of the library
fileName - the file name of the library
is - the input stream of the library
Returns:
true if the library resource is a valid library, otherwise false

checkModule

public static int checkModule(SessionHandle sessionHandle,
                              java.lang.String fileName,
                              java.io.InputStream is)
Checks the input stream with given file name. If it is a valid design/library, return ModuleUtil.REPORT_DESIGN/ModuleUtil.LIBRARY, otherwise, ModuleUtil.INVALID is return.

Parameters:
sessionHandle - the current session of the library
fileName - the file name of the library
is - the input stream of the library
Returns:
ModuleUtil.REPORT_DESIGN if the input stream is a report design, ModuleUtil.LIBRARY if the input stream is a library, ModuleUtil.INVALID otherwise.

checkVersion

public static java.util.List checkVersion(java.lang.String fileName)
Checks whether the opening design file holds a version number before the some specific features is supported. This method is used to remind user that opening the file may need convert the original file automatically.

Parameters:
fileName - the file name with full path of the design file
Returns:
a list whose entry is of IVersionInfo type. Each kind of automatical conversion information is stored in one instance of IVersionInfo. Note that if the design file does not exist, or it is an invalid design file, an instance of IVersionInfo will also generate. If the size of the return list is 0, there is no auto-conversion.

getExternalizedValue

public static java.lang.String getExternalizedValue(DesignElementHandle element,
                                                    java.lang.String key,
                                                    java.lang.String value,
                                                    com.ibm.icu.util.ULocale locale)
Returns externalized message for the given locale.

Parameters:
element - the report element.
key - the display key property value
value - the property value
locale - the locale
Returns:
externalized message.

isEqualHierarchiesForJointCondition

public static boolean isEqualHierarchiesForJointCondition(HierarchyHandle conditionHierarchy,
                                                          HierarchyHandle cubeHierarchy)
This API is only for helping GUI to draw the dimension joint condition editor pad. When user extends an library cube to design, the hierarchy handle from the joint condition should be same with the virtual hierarchy in the reprot design cube.

Parameters:
conditionHierarchy - the hierarchy handle from the dimension joint condition structure.
cubeHierarchy - the hierarchy handle from the cube.
Returns:

isValidElementName

public static boolean isValidElementName(DesignElementHandle elementHandle,
                                         java.lang.String propName,
                                         java.lang.String nameValue)
checks if the name of the element is valid. The following case the name will be considered as invalid.
  • contains the following charactors: "/","\\", ".", "!", ";",","
  • Parameters:
    elementHandle - the design element need to be checked the name property value.
    propName - the property name which is name property type of this design element.
    nameValue - the value of the name property.
    Returns:
    true if the value of the name property is valid, false if it is not valid.

    isValidElementName

    public static boolean isValidElementName(DesignElementHandle elementHandle)
    checks is the name value is valid for the design element.

    Parameters:
    elementHandle - element need to be checked for the name.
    Returns:
    true if the name is valid, false if the name is not valid.

    isListFilterValue

    public static boolean isListFilterValue(FilterConditionHandle filter)
    Determine if the value1 of this filter condition is a list.

    Parameters:
    filter - the filter need to check
    Returns:
    true if the value1 value is a list, false if it is a single value.

    isListFilterValue

    public static boolean isListFilterValue(FilterConditionElementHandle filter)
    Determine if the value1 of this filter condition is a list.

    Parameters:
    filter - the filter need to check
    Returns:
    true if the value1 value is a list, false if it is a single value.


    Copyright © 2005 Actuate Corp. All rights reserved.