org.eclipse.birt.report.engine.api
Class HTMLServerImageHandler

java.lang.Object
  extended byorg.eclipse.birt.report.engine.api.HTMLImageHandler
      extended byorg.eclipse.birt.report.engine.api.HTMLServerImageHandler
All Implemented Interfaces:
IHTMLImageHandler

public class HTMLServerImageHandler
extends HTMLImageHandler

Default implementation for writing images in a form that is used in a web-application.


Field Summary
protected  java.util.logging.Logger log
           
 
Constructor Summary
HTMLServerImageHandler()
          dummy constructor
 
Method Summary
protected  java.lang.String createUniqueFileName(java.lang.String imageDir, java.lang.String prefix)
          returns a unique file name based on a directory and name prefix
protected  java.lang.String createUniqueFileName(java.lang.String imageDir, java.lang.String prefix, java.lang.String postfix)
          creates a unique tempoary file to store an image
 void getImage(java.io.OutputStream out, java.lang.String imageDir, java.lang.String imageID)
          get image
protected  java.lang.String getImageMapID(IImage image)
          returns the unique identifier for the image
protected  java.lang.String handleImage(IImage image, java.lang.Object context, java.lang.String prefix, boolean needMap)
          handles an image report item and returns an image URL
protected  java.lang.String handleTempImage(IImage image, java.lang.String prefix, boolean needMap)
           
 java.lang.String onCustomImage(IImage image, java.lang.Object context)
          handles a custom image created for example, by chart extension.
 java.lang.String onDesignImage(IImage image, java.lang.Object context)
          handles a design image.
 java.lang.String onDocImage(IImage image, java.lang.Object context)
          handles a database image.
 java.lang.String onFileImage(IImage image, java.lang.Object context)
          handles a image specified as a on-disk URI.
 java.lang.String onURLImage(IImage image, java.lang.Object context)
          handles an image specified as an external URL.
 
Methods inherited from class org.eclipse.birt.report.engine.api.HTMLImageHandler
addCachedImage, getCachedImage, getRenderContext, onCustomImage, onDesignImage, onDocImage, onFileImage, onURLImage
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

log

protected java.util.logging.Logger log
Constructor Detail

HTMLServerImageHandler

public HTMLServerImageHandler()
dummy constructor

Method Detail

onDesignImage

public java.lang.String onDesignImage(IImage image,
                                      java.lang.Object context)
Description copied from interface: IHTMLImageHandler
handles a design image. The implementation supplies a URL and optionally stores the image.

Specified by:
onDesignImage in interface IHTMLImageHandler
Overrides:
onDesignImage in class HTMLImageHandler

onDocImage

public java.lang.String onDocImage(IImage image,
                                   java.lang.Object context)
Description copied from interface: IHTMLImageHandler
handles a database image. The implementation supplies a URL and optionally stores the image.

Specified by:
onDocImage in interface IHTMLImageHandler
Overrides:
onDocImage in class HTMLImageHandler

onURLImage

public java.lang.String onURLImage(IImage image,
                                   java.lang.Object context)
Description copied from interface: IHTMLImageHandler
handles an image specified as an external URL. The implementation supplies a URL and optionally stores the image.

Specified by:
onURLImage in interface IHTMLImageHandler
Overrides:
onURLImage in class HTMLImageHandler

onCustomImage

public java.lang.String onCustomImage(IImage image,
                                      java.lang.Object context)
Description copied from interface: IHTMLImageHandler
handles a custom image created for example, by chart extension. The implementation supplies a URL and optionally stores the image.

Specified by:
onCustomImage in interface IHTMLImageHandler
Overrides:
onCustomImage in class HTMLImageHandler

createUniqueFileName

protected java.lang.String createUniqueFileName(java.lang.String imageDir,
                                                java.lang.String prefix)
returns a unique file name based on a directory and name prefix

Parameters:
imageDir - directory to store the image
prefix - prefix for the file name
Returns:
a file name

createUniqueFileName

protected java.lang.String createUniqueFileName(java.lang.String imageDir,
                                                java.lang.String prefix,
                                                java.lang.String postfix)
creates a unique tempoary file to store an image

Parameters:
imageDir - directory to put image into
prefix - file name prefix
postfix - file name postfix
Returns:
a Java File Object

onFileImage

public java.lang.String onFileImage(IImage image,
                                    java.lang.Object context)
Description copied from interface: IHTMLImageHandler
handles a image specified as a on-disk URI. The implementation supplies a URL and optionally stores the image.

Specified by:
onFileImage in interface IHTMLImageHandler
Overrides:
onFileImage in class HTMLImageHandler

handleImage

protected java.lang.String handleImage(IImage image,
                                       java.lang.Object context,
                                       java.lang.String prefix,
                                       boolean needMap)
handles an image report item and returns an image URL

Parameters:
image - represents the image design information
context - context information
prefix - image prefix in URL
needMap - whether image map is needed
Returns:
URL for the image

handleTempImage

protected java.lang.String handleTempImage(IImage image,
                                           java.lang.String prefix,
                                           boolean needMap)

getImageMapID

protected java.lang.String getImageMapID(IImage image)
returns the unique identifier for the image

Parameters:
image - the image object
Returns:
the image id

getImage

public void getImage(java.io.OutputStream out,
                     java.lang.String imageDir,
                     java.lang.String imageID)
              throws EngineException
get image

Parameters:
out - the output stream of image
imageDir - the image directory
imageID - id of image
Throws:
java.io.IOException
EngineException


Copyright © 2005 Actuate Corp. All rights reserved.