org.eclipse.birt.report.model.api
Interface IResourceLocator

All Known Implementing Classes:
DefaultResourceLocator

public interface IResourceLocator

Implements this interface to provide a custom file search algorithm. This class defines the file search algorithm used to locate files referenced in the design. For example, when parsing a design file and a library is encountered, a file locator will be used to locate the library. This interface is implemented differently for each environment. For example, the GUI might have its own file search requirement, while the deployment environment in application server has another.

The default file locator is DefaultResourceLocator.

The customized file search must be installed before opening designs. Set the file locator using SessionHandle.setResourceLocator(IResourceLocator) method.


Field Summary
static int CASCADING_STYLE_SHEET
          The type of the cascading style sheet to search.
static int IMAGE
          The type of the images to search
static int LIBRARY
          The type of the libraries to search
 
Method Summary
 java.net.URL findResource(ModuleHandle moduleHandle, java.lang.String filename, int type)
          Searches the file by the given file name.
 

Field Detail

IMAGE

public static final int IMAGE
The type of the images to search

See Also:
Constant Field Values

LIBRARY

public static final int LIBRARY
The type of the libraries to search

See Also:
Constant Field Values

CASCADING_STYLE_SHEET

public static final int CASCADING_STYLE_SHEET
The type of the cascading style sheet to search.

See Also:
Constant Field Values
Method Detail

findResource

public java.net.URL findResource(ModuleHandle moduleHandle,
                                 java.lang.String filename,
                                 int type)
Searches the file by the given file name. The actual search algorithm will be different in different environment. The file type is just helpful when different file searching steps for different files are required. Because new file type will be added if design file includes new file, the default searching steps are encouraged for unknown file type to improve robustness.

Parameters:
moduleHandle - The module to tell the search context. This could be null if the search algorithm does not need the design. It can be the instance of one of ReportDesignHandle and LibraryHandle.
filename - The file name to be searched. This could be an absolute path or a relative path.
type - The type of the file to search. The value must be one of IMAGE,LIBRARY and CASCADING_STYLE_SHEET.
Returns:
The URL object. null if the file can not be found.


Copyright © 2005 Actuate Corp. All rights reserved.