Interface IReportContext


public interface IReportContext
An interface used to share information between the event methods in scripting. Gives access to report parameters and configuration values. Also provides a way for the report developer to register and retrieve custom properties.
  • Field Details

  • Method Details

    • getReportRunnable

      org.eclipse.birt.report.engine.api.IReportRunnable getReportRunnable()
      return the report runnable used to create/render this report
      Returns:
    • getParameterValue

      Object getParameterValue(String name)
      Parameters:
      name -
      Returns:
    • setParameterValue

      void setParameterValue(String name, Object value)
      Parameters:
      name -
      value -
    • getParameterDisplayText

      Object getParameterDisplayText(String name)
      Parameters:
      name -
      Returns:
    • setParameterDisplayText

      void setParameterDisplayText(String name, String value)
      Parameters:
      name -
      value -
    • getLocale

      Locale getLocale()
      Returns:
    • getTimeZone

      com.ibm.icu.util.TimeZone getTimeZone()
      Get time zone informations.
      Returns:
    • getOutputFormat

      String getOutputFormat()
      Returns:
    • getRenderOption

      org.eclipse.birt.report.engine.api.IRenderOption getRenderOption()
      get the render options used to render the report.
      Returns:
    • getAppContext

      Map getAppContext()
      Get the application context
    • getHttpServletRequest

      Object getHttpServletRequest()
      Get the http servlet request object
    • setGlobalVariable

      void setGlobalVariable(String name, Object obj)
      Add the object to runtime scope. This object can only be retrieved in the same phase, i.e. it is not persisted between generation and presentation.
    • deleteGlobalVariable

      void deleteGlobalVariable(String name)
      Remove an object from runtime scope.
    • getGlobalVariable

      Object getGlobalVariable(String name)
      Retireve an object from runtime scope.
    • setPersistentGlobalVariable

      void setPersistentGlobalVariable(String name, Serializable obj)
      Add the object to report document scope. This object can be retrieved later. It is persisted between phases, i.e. between generation and presentation.
    • deletePersistentGlobalVariable

      void deletePersistentGlobalVariable(String name)
      Remove an object from report document scope.
    • getPersistentGlobalVariable

      Object getPersistentGlobalVariable(String name)
      Retireve an object from report document scope.
    • getPageVariable

      Object getPageVariable(String name)
    • setPageVariable

      void setPageVariable(String name, Object value)
    • getMessage

      String getMessage(String key)
      Finds user-defined messages for the current thread's locale.
      Parameters:
      key - resource key of the user-defined message.
      Returns:
      the corresponding locale-dependent messages. Return null if resoueceKey is blank.
    • getMessage

      String getMessage(String key, Locale locale)
      Finds user-defined messages for the given locale.

      First we look up in the report itself, then look into the referenced message file. Each search uses a reduced form of Java locale-driven search algorithm: Language&Country, language, default.

      Parameters:
      key - resource key of the user defined message.
      locale - locale of message, if the input locale is null, the locale for the current thread will be used instead.
      Returns:
      the corresponding locale-dependent messages. Return null if resoueceKey is blank.
    • getMessage

      String getMessage(String key, Object[] params)
      Finds user-defined messages for the current thread's locale using parameters
      Parameters:
      key - resource key of the user-defined message.
      params - string arguments used to format error messages
      Returns:
      the corresponding locale-dependent messages. Return null if resoueceKey is blank.
    • getMessage

      String getMessage(String key, Locale locale, Object[] params)
      Finds user-defined messages for the given locale using parameters

      First we look up in the report itself, then look into the referenced message file. Each search uses a reduced form of Java locale-driven search algorithm: Language&Country, language, default.

      Parameters:
      key - resource key of the user defined message.
      locale - locale of message, if the input locale is null, the locale for the current thread will be used instead.
      params - string arguments used to format error messages
      Returns:
      the corresponding locale-dependent messages. Return null if resoueceKey is blank.
    • getTaskType

      int getTaskType()
      Get the type of the current task.
      Returns:
      task type including:
    • 0 for GetParameterDefinition Task
    • 1 for Run Task
    • 2 for Render Task
    • 3 for Run and Render Task
    • 4 for DataExtraction Task
    • -1 default value for unknown task
    • getDesignHandle

      org.eclipse.birt.report.model.api.ReportDesignHandle getDesignHandle()
      get the report design handle.
      Returns:
      report design handle
    • getResource

      URL getResource(String resourceName)
      get the URL for the resource. The url can only be used in the server side.
      Parameters:
      resourceName - resource name
      Returns:
      resource URL
    • getResourceRenderURL

      String getResourceRenderURL(String resourceName)
      get the render URL for a resource.
      Parameters:
      resourceName - resource name
      Returns:
      the URL which can be used in the client side.
    • evaluate

      Object evaluate(String script) throws org.eclipse.birt.core.exception.BirtException
      evaluate the script with default script language.
      Parameters:
      script -
      Returns:
      Throws:
      org.eclipse.birt.core.exception.BirtException
    • evaluate

      Object evaluate(String language, String script) throws org.eclipse.birt.core.exception.BirtException
      evaluate the script with specified script language.
      Parameters:
      language -
      script -
      Returns:
      Throws:
      org.eclipse.birt.core.exception.BirtException
    • evaluate

      Object evaluate(org.eclipse.birt.report.engine.ir.Expression script) throws org.eclipse.birt.core.exception.BirtException
      Evaluate the script.
      Parameters:
      script -
      Returns:
      Throws:
      org.eclipse.birt.core.exception.BirtException
    • getApplicationClassLoader

      ClassLoader getApplicationClassLoader()
      get the application classLoader of the current report context
      Returns:
      application classLoader
    • cancel

      void cancel()
      cancel the current engine task
    • cancel

      void cancel(String reason)
      cancel the current engine task
    • isReportDocumentFinished

      boolean isReportDocumentFinished()
      check if the report document generation is finished. It should be used at render time. The default value is false
      Returns: