Class LibraryHandleImpl
java.lang.Object
org.eclipse.birt.report.model.api.DesignElementHandle
org.eclipse.birt.report.model.api.ModuleHandleImpl
org.eclipse.birt.report.model.api.ModuleHandle
org.eclipse.birt.report.model.api.LibraryHandleImpl
- All Implemented Interfaces:
IModuleModel
,org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel
,org.eclipse.birt.report.model.elements.interfaces.IInternalLibraryModel
,org.eclipse.birt.report.model.elements.interfaces.ILibraryModel
- Direct Known Subclasses:
LibraryHandle
public abstract class LibraryHandleImpl
extends ModuleHandle
implements org.eclipse.birt.report.model.elements.interfaces.ILibraryModel
-
Field Summary
Fields inherited from class org.eclipse.birt.report.model.api.ModuleHandleImpl
isInitialized
Fields inherited from class org.eclipse.birt.report.model.api.DesignElementHandle
module
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IDesignElementModel
COMMENTS_PROP, CUSTOM_XML_PROP, DISPLAY_NAME_ID_PROP, DISPLAY_NAME_PROP, EVENT_HANDLER_CLASS_PROP, EXTENDS_PROP, FULL_LABEL, ID_SUFFIX, NAME_PROP, NEW_HANDLER_ON_EACH_EVENT_PROP, NO_SLOT, PROPERTY_MASKS_PROP, REF_TEMPLATE_PARAMETER_PROP, SHORT_LABEL, USER_LABEL, USER_PROPERTIES_PROP, VIEW_ACTION_PROP
Fields inherited from interface org.eclipse.birt.report.model.elements.interfaces.IInternalLibraryModel
CUBE_SLOT, SLOT_COUNT, THEMES_SLOT
Fields inherited from interface org.eclipse.birt.report.model.api.core.IModuleModel
AUTHOR_PROP, BASE_PROP, COLOR_PALETTE_PROP, COMPONENT_SLOT, CONFIG_VARS_PROP, CREATED_BY_PROP, DATA_SET_SLOT, DATA_SOURCE_SLOT, DESCRIPTION_ID_PROP, DESCRIPTION_PROP, HELP_GUIDE_PROP, IMAGES_PROP, INCLUDE_RESOURCE_PROP, INCLUDE_SCRIPTS_PROP, INITIALIZE_METHOD, LIBRARIES_PROP, PAGE_SLOT, PARAMETER_SLOT, PROPERTY_BINDINGS_PROP, SCRIPTLIBS_PROP, SUBJECT_PROP, THEME_PROP, TITLE_ID_PROP, TITLE_PROP, UNITS_PROP
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
addConfigVariable
(ConfigVariable configVar) Adds a new config variable.void
addImage
(EmbeddedImage image) Adds a new embedded image.void
addTranslation
(String resourceKey, String locale, String text) Adds a new translation to the design.void
dropConfigVariable
(String name) Drops a config variable.void
Drops an embedded image from the design.void
Drops an embedded image handle list from the design.void
dropLibrary
(LibraryHandle library) Drops the given library from the included libraries of this design file.void
dropLibraryAndBreakExtends
(LibraryHandle library) Drops the given library from the design and break all the parent/child relationships.void
dropTranslation
(String resourceKey, String locale) Drops a translation from the design.Returns all page handles that this modules and the included modules contain.Returns all style element handles that this modules and the included modules contain.Returns a slot handle to work with the top-level components within the report.getCubes()
Gets the slot handle to work with all cube elements within the report.Returns a slot handle to work with the data sets within the report.Returns a slot handle to work with the data sources within the report.Returns the flatten Parameters/ParameterGroups of the design.Returns the host handle which includes the library.Returns a slot handle to work with the master pages within the report.Returns the library namespace, which identifies one library unqiuely in one design file.Returns a slot handle to work with the top-level parameters and parameter groups within the report.Returns parameters and parameter groups on the module.If this library is included by a module, return the relative file name that is defined in the host's xml file.Deprecated.uses the theme insteadReturns a slot handle to work with the themes within the library.getVisibleReportItemThemes
(int level, String type) Returns report item theme handles according the input level.getVisibleThemes
(int level) Returns theme handles according the input level.Returns the iterator over all embedded images of this module instance.void
importCssStyles
(CssStyleSheetHandle stylesheet, List selectedStyles) Import css file to theme.void
importCssStyles
(CssStyleSheetHandle stylesheet, List selectedStyles, String themeName) Imports the selected styles in aCssStyleSheetHandle
to the given theme of the library.Returns the iterator over all included libraries.void
includeLibrary
(String libraryFileName, String namespace) Includes one library with the given library file name.boolean
Examines whether the resolved direction of this design element is Right to Left or not.Gets the result style sheet with given file name of an external CSS2 resource.openCssStyleSheet
(String fileName) Gets the result style sheet with given file name of an external CSS2 resource.void
Reloads all libraries this module included.void
reloadLibrary
(String reloadPath) Reloads the library with the given library file path.void
reloadLibrary
(LibraryHandle libraryToReload) Reloads the library with the given library file path.void
replaceConfigVariable
(ConfigVariable oldVar, ConfigVariable newVar) Replaces the old config variable with the new one.void
replaceImage
(EmbeddedImage oldVar, EmbeddedImage newVar) Replaces the old embedded image with the new one.void
setTheme
(ThemeHandle theme) Sets the theme to a report.void
setThemeName
(String themeName) Sets the theme to a report.void
shiftLibrary
(LibraryHandle library, int toPosn) Shifts the library to new position.Methods inherited from class org.eclipse.birt.report.model.api.ModuleHandleImpl
addAttributeListener, addDisposeListener, addIncludeScript, addResourceChangeListener, addScriptLib, addValidationListener, checkReport, checkReportIfNecessary, close, configVariablesIterator, copy, customColorsIterator, drop, dropAllScriptLibs, dropAndClear, dropIncludeScript, dropScriptLib, dropScriptLib, findCascadingParameterGroup, findColor, findConfigVariable, findCube, findDataSet, findDataSource, findDimension, findElement, findImage, findJointDataSet, findLevel, findLibrary, findMasterPage, findNativeStyle, findParameter, findReportItemTheme, findResource, findResource, findScriptLib, findStyle, findTemplateDataSet, findTheme, generateHandleList, getAllCubes, getAllDataSets, getAllDataSources, getAllImages, getAllIncludeScripts, getAllLibraries, getAllParameters, getAllScriptLibs, getAllSharedDimensions, getAuthor, getCommandStack, getComments, getCreatedBy, getDefaultUnits, getDescription, getDescriptionKey, getDisplayDescription, getElement, getElementByID, getErrorList, getFileEncoding, getFileName, getHelpGuide, getIncludeResource, getIncludeResources, getInitialize, getLibraries, getLibraries, getLibrary, getLineNo, getLineNoByID, getMessage, getMessage, getMessage, getMessageKeys, getNativeStructureList, getOptions, getResourceFolder, getSubject, getSymbolicName, getSystemId, getTheme, getTitle, getTitleKey, getTranslation, getTranslationKeys, getTranslations, getVersion, getVisibleCubes, getVisibleDataSets, getVisibleDataSources, getVisibleImages, getVisibleModules, getWarningList, includeScriptsIterator, initializeModule, isInclude, isReadOnly, needsSave, onSave, removeAttributeListener, removeDisposeListener, removeResourceChangeListener, removeValidationListener, rename, rename, rename, save, saveAs, scriptLibsIterator, serialize, setAuthor, setComments, setCreatedBy, setDefaultUnits, setDescription, setDescriptionKey, setFileName, setHelpGuide, setIncludeResource, setIncludeResources, setInitialize, setOptions, setResourceFolder, setSubject, setSymbolicName, setTitle, setTitleKey, shifIncludeScripts, shiftScriptLibs, sortVisibleElements
Methods inherited from class org.eclipse.birt.report.model.api.DesignElementHandle
add, add, addElement, addElement, addListener, addUserPropertyDefn, cachePropertyHandles, canContain, canContain, canContain, canContain, canDrop, canEdit, canTransformToTemplate, clearAllProperties, clearContents, clearProperty, clientsIterator, copyPropertyTo, createTemplateElement, derivedIterator, doSort, drop, drop, dropAndClear, dropAndClear, dropUserPropertyDefn, findContentSlot, getBooleanProperty, getChoices, getColorProperty, getContainer, getContainerPropertyHandle, getContainerSlotHandle, getContent, getContentCount, getContents, getDefn, getDesign, getDesignHandle, getDimensionProperty, getDisplayLabel, getDisplayLabel, getDisplayProperty, getEffectiveModule, getElementFactory, getElementProperty, getEventHandlerClass, getExpressionProperty, getExtends, getExternalizedValue, getExternalizedValue, getExternalizedValue, getFactoryElementHandle, getFactoryPropertyHandle, getFloatProperty, getFontProperty, getFullName, getHostViewHandle, getID, getIndex, getIntProperty, getListProperty, getListProperty, getMethods, getModule, getModuleHandle, getName, getNumberProperty, getPrivateStyle, getProperty, getPropertyBinding, getPropertyBindingExpression, getPropertyBindings, getPropertyDefn, getPropertyHandle, getPropertyIterator, getQualifiedName, getRoot, getSemanticErrors, getSlot, getStringProperty, getStyle, getTagType, getUserProperties, getUserPropertyDefnHandle, getXPath, hasLocalProperties, hasSemanticError, initializeSlotHandles, isInTemplateParameter, isTemplateParameterValue, isValid, localize, move, move, moveTo, moveTo, moveTo, moveTo, newHandlerOnEachEvent, paste, paste, paste, paste, removeListener, revertToReportItem, revertToTemplate, semanticCheck, setBooleanProperty, setEncryption, setEventHandlerClass, setExpressionProperty, setExtends, setExtendsElement, setExtendsName, setFloatProperty, setIntProperty, setName, setNewHandlerOnEachEvent, setNumberProperty, setProperties, setProperty, setPropertyBinding, setPropertyBinding, setStringProperty, setStyle, setStyleElement, setStyleName, setValid, shift, showError, slotsIterator
-
Constructor Details
-
LibraryHandleImpl
public LibraryHandleImpl(org.eclipse.birt.report.model.core.Module module)
-
-
Method Details
-
getHostHandle
Returns the host handle which includes the library.- Returns:
- the host handle which include this library.
-
getNamespace
Returns the library namespace, which identifies one library unqiuely in one design file.- Returns:
- the library namespace
-
getThemes
Returns a slot handle to work with the themes within the library. Note that the order of the data sets within the slot is unimportant.- Returns:
- A handle for working with the themes.
-
getStyles
Deprecated.uses the theme insteadReturns a slot handle to work with the styles within the library.- Returns:
- A handle for working with the styles. Or
null
if the library has no values for the theme property
-
importCssStyles
Import css file to theme.- Overrides:
importCssStyles
in classModuleHandleImpl
- Parameters:
stylesheet
- the style sheet handle that contains all the selected stylesselectedStyles
- the selected style list
-
importCssStyles
Imports the selected styles in aCssStyleSheetHandle
to the given theme of the library. Each in the list is instance ofSharedStyleHandle
.If any style selected has a duplicate name with that of one style already existing in the report design, this method will rename it and then add it to the design.- Parameters:
stylesheet
- the style sheet handle that contains all the selected stylesselectedStyles
- the selected style listthemeName
- the name of the theme to put styles
-
getCubes
Description copied from class:ModuleHandleImpl
Gets the slot handle to work with all cube elements within the report.- Specified by:
getCubes
in classModuleHandleImpl
- Returns:
- cube slot handle
-
getRelativeFileName
If this library is included by a module, return the relative file name that is defined in the host's xml file.- Returns:
- the relative file name that is defined in the host's xml file
-
isDirectionRTL
public boolean isDirectionRTL()Description copied from class:DesignElementHandle
Examines whether the resolved direction of this design element is Right to Left or not.- Overrides:
isDirectionRTL
in classDesignElementHandle
- Returns:
- true if the direction is RTL, false otherwise
-
addConfigVariable
Description copied from class:ModuleHandleImpl
Adds a new config variable.- Overrides:
addConfigVariable
in classModuleHandleImpl
- Parameters:
configVar
- the config variable- Throws:
SemanticException
- if the name is empty or the same name exists.
-
addImage
Description copied from class:ModuleHandleImpl
Adds a new embedded image.- Overrides:
addImage
in classModuleHandleImpl
- Parameters:
image
- the image to add- Throws:
SemanticException
- if the name is empty, type is invalid, or the same name exists.
-
addTranslation
public void addTranslation(String resourceKey, String locale, String text) throws CustomMsgException Description copied from class:ModuleHandleImpl
Adds a new translation to the design.- Overrides:
addTranslation
in classModuleHandleImpl
- Parameters:
resourceKey
- resource key for the messagelocale
- the string value of a locale for the translation. Locale should be in java-defined format( en, en-US, zh_CN, etc.)text
- translated text for the locale- Throws:
CustomMsgException
- if the resource key is duplicate or missing, or locale is not a valid format.- See Also:
-
dropConfigVariable
Description copied from class:ModuleHandleImpl
Drops a config variable.- Overrides:
dropConfigVariable
in classModuleHandleImpl
- Parameters:
name
- config variable name- Throws:
SemanticException
- if no config variable is found.
-
dropImage
Description copied from class:ModuleHandleImpl
Drops an embedded image handle list from the design. Each one in the list is the instance ofEmbeddedImageHandle
.- Overrides:
dropImage
in classModuleHandleImpl
- Parameters:
images
- the image handle list to remove- Throws:
SemanticException
- if any image in the list is not found.
-
dropImage
Description copied from class:ModuleHandleImpl
Drops an embedded image from the design.- Overrides:
dropImage
in classModuleHandleImpl
- Parameters:
name
- the image name- Throws:
SemanticException
- if the image is not found.
-
dropTranslation
Description copied from class:ModuleHandleImpl
Drops a translation from the design.- Overrides:
dropTranslation
in classModuleHandleImpl
- Parameters:
resourceKey
- resource key of the message in which this translation saves.locale
- the string value of the locale for a translation. Locale should be in java-defined format( en, en-US, zh_CN, etc.)- Throws:
CustomMsgException
- ifresourceKey
isnull
.- See Also:
-
getComponents
Description copied from class:ModuleHandleImpl
Returns a slot handle to work with the top-level components within the report.- Overrides:
getComponents
in classModuleHandleImpl
- Returns:
- A handle for working with the components.
-
getDataSets
Description copied from class:ModuleHandleImpl
Returns a slot handle to work with the data sets within the report. Note that the order of the data sets within the slot is unimportant.- Overrides:
getDataSets
in classModuleHandleImpl
- Returns:
- A handle for working with the data sets.
-
getDataSources
Description copied from class:ModuleHandleImpl
Returns a slot handle to work with the data sources within the report. Note that the order of the data sources within the slot is unimportant.- Overrides:
getDataSources
in classModuleHandleImpl
- Returns:
- A handle for working with the data sources.
-
getFlattenParameters
Description copied from class:ModuleHandleImpl
Returns the flatten Parameters/ParameterGroups of the design. This method put all Parameters and ParameterGroups into a list then return it. The return list is sorted by on the display name of the parameters.- Overrides:
getFlattenParameters
in classModuleHandleImpl
- Returns:
- the sorted, flatten parameters and parameter groups.
-
getMasterPages
Description copied from class:ModuleHandleImpl
Returns a slot handle to work with the master pages within the report. Note that the order of the master pages within the slot is unimportant.- Overrides:
getMasterPages
in classModuleHandleImpl
- Returns:
- A handle for working with the master pages.
-
getParameters
Description copied from class:ModuleHandleImpl
Returns a slot handle to work with the top-level parameters and parameter groups within the report. The order that the items appear within the slot determines the order in which they appear in the "requester" UI.- Overrides:
getParameters
in classModuleHandleImpl
- Returns:
- A handle for working with the parameters and parameter groups.
-
imagesIterator
Description copied from class:ModuleHandleImpl
Returns the iterator over all embedded images of this module instance. Each one is the instance ofEmbeddedImageHandle
- Overrides:
imagesIterator
in classModuleHandleImpl
- Returns:
- the iterator over all embedded images.
- See Also:
-
replaceConfigVariable
public void replaceConfigVariable(ConfigVariable oldVar, ConfigVariable newVar) throws SemanticException Description copied from class:ModuleHandleImpl
Replaces the old config variable with the new one.- Overrides:
replaceConfigVariable
in classModuleHandleImpl
- Parameters:
oldVar
- the old config variablenewVar
- the new config variable- Throws:
SemanticException
- if the old config variable is not found or the name of new one is empty.
-
replaceImage
Description copied from class:ModuleHandleImpl
Replaces the old embedded image with the new one.- Overrides:
replaceImage
in classModuleHandleImpl
- Parameters:
oldVar
- the old embedded imagenewVar
- the new embedded image- Throws:
SemanticException
- if the old image is not found or the name of new one is empty.
-
getAllStyles
Description copied from class:ModuleHandleImpl
Returns all style element handles that this modules and the included modules contain.- Overrides:
getAllStyles
in classModuleHandleImpl
- Returns:
- all style element handles that this modules and the included modules contain.
-
getVisibleThemes
Description copied from class:ModuleHandleImpl
Returns theme handles according the input level.- Overrides:
getVisibleThemes
in classModuleHandleImpl
- Parameters:
level
- anint
value, which should be the one defined inIVisibleLevelControl
.- Returns:
- theme handles according the input level
-
getVisibleReportItemThemes
Description copied from class:ModuleHandleImpl
Returns report item theme handles according the input level.- Overrides:
getVisibleReportItemThemes
in classModuleHandleImpl
- Parameters:
level
- anint
value, which should be the one defined inIVisibleLevelControl
.- Returns:
- theme handles according the input level
-
getParametersAndParameterGroups
Description copied from class:ModuleHandleImpl
Returns parameters and parameter groups on the module. Those parameters included in the parameter groups are not included in the return list.- Overrides:
getParametersAndParameterGroups
in classModuleHandleImpl
- Returns:
- parameters and parameter groups
-
getAllPages
Description copied from class:ModuleHandleImpl
Returns all page handles that this modules and the included modules contain.- Overrides:
getAllPages
in classModuleHandleImpl
- Returns:
- all page handles that this modules and the included modules contain.
-
shiftLibrary
Description copied from class:ModuleHandleImpl
Shifts the library to new position. This method might affect the style reference, because the library order is changed.- Overrides:
shiftLibrary
in classModuleHandleImpl
- Parameters:
library
- the library to shifttoPosn
- the new position- Throws:
SemanticException
- if error is encountered when shifting
-
includeLibrariesIterator
Description copied from class:ModuleHandleImpl
Returns the iterator over all included libraries. Each one is the instance ofIncludeLibraryHandle
- Overrides:
includeLibrariesIterator
in classModuleHandleImpl
- Returns:
- the iterator over all included libraries.
- See Also:
-
includeLibrary
public void includeLibrary(String libraryFileName, String namespace) throws DesignFileException, SemanticException Description copied from class:ModuleHandleImpl
Includes one library with the given library file name. The new library will be appended to the library list.- Overrides:
includeLibrary
in classModuleHandleImpl
- Parameters:
libraryFileName
- library file namenamespace
- library namespace- Throws:
DesignFileException
- if the library file is not found, or has fatal error.SemanticException
- if error is encountered when handlingIncludeLibrary
structure list.
-
dropLibrary
Description copied from class:ModuleHandleImpl
Drops the given library from the included libraries of this design file.- Overrides:
dropLibrary
in classModuleHandleImpl
- Parameters:
library
- the library to drop- Throws:
SemanticException
- if error is encountered when handlingIncludeLibrary
structure list. Or it maybe because that the given library is not found in the design. Or that the library has descedents in the current module
-
reloadLibrary
public void reloadLibrary(LibraryHandle libraryToReload) throws SemanticException, DesignFileException Description copied from class:ModuleHandleImpl
Reloads the library with the given library file path. If the library already is included directly, reload it. If the library is not included, exception will be thrown.Call this method cautiously ONLY on the condition that the library file is REALLY changed outside. After reload successfully, the command stack is cleared.
- Overrides:
reloadLibrary
in classModuleHandleImpl
- Parameters:
libraryToReload
- the library instance- Throws:
SemanticException
- if error is encountered when handlingIncludeLibrary
structure list. Or it maybe because that the given library is not found in the design. Or that the library has descedents in the current moduleDesignFileException
- if the library file is not found, or has fatal error.
-
reloadLibraries
Description copied from class:ModuleHandleImpl
Reloads all libraries this module included.Call this method cautiously ONLY on the condition that the library file is REALLY changed outside. After reload successfully, the command stack is cleared.
ModuleHandleImpl.reloadLibrary(LibraryHandle)
- Overrides:
reloadLibraries
in classModuleHandleImpl
- Throws:
SemanticException
DesignFileException
-
reloadLibrary
Description copied from class:ModuleHandleImpl
Reloads the library with the given library file path. If the library already is included directly or indirectly(that is, the reload path could be the path of grandson of this module), reload it. If the library is not included, exception will be thrown.Call this method cautiously ONLY on the condition that the library file is REALLY changed outside. After reload successfully, the command stack is cleared.
- Overrides:
reloadLibrary
in classModuleHandleImpl
- Parameters:
reloadPath
- this is supposed to be an absolute path, not in url form.- Throws:
SemanticException
- if error is encountered when handlingIncludeLibrary
structure list. Or it maybe because that the given library is not found in the design. Or that the library has descedents in the current moduleDesignFileException
- if the library file is not found, or has fatal error.
-
dropLibraryAndBreakExtends
Description copied from class:ModuleHandleImpl
Drops the given library from the design and break all the parent/child relationships. All child element will be localized in the module.- Overrides:
dropLibraryAndBreakExtends
in classModuleHandleImpl
- Parameters:
library
- the given library to drop- Throws:
SemanticException
- if errors occured when drop the library.It may be because that the library is not found in the design or that some elements can not be localized properly.
-
openCssStyleSheet
Description copied from class:ModuleHandleImpl
Gets the result style sheet with given file name of an external CSS2 resource.- Overrides:
openCssStyleSheet
in classModuleHandleImpl
- Parameters:
fileName
- the file name of the external CSS resource- Returns:
- the
CssStyleSheetHandle
if the external resource is successfully loaded - Throws:
StyleSheetException
- thrown if the resource is not found, or there are syntax errors in the resource
-
openCssStyleSheet
Description copied from class:ModuleHandleImpl
Gets the result style sheet with given file name of an external CSS2 resource.- Overrides:
openCssStyleSheet
in classModuleHandleImpl
- Parameters:
is
- the input stream of the resource- Returns:
- the
CssStyleSheetHandle
if the external resource is successfully loaded - Throws:
StyleSheetException
- thrown if the resource is not found, or there are syntax errors in the resource
-
setThemeName
Description copied from class:ModuleHandleImpl
Sets the theme to a report.- Overrides:
setThemeName
in classModuleHandleImpl
- Parameters:
themeName
- the name of the theme- Throws:
SemanticException
-
setTheme
Description copied from class:ModuleHandleImpl
Sets the theme to a report.- Overrides:
setTheme
in classModuleHandleImpl
- Parameters:
theme
- the theme instance- Throws:
SemanticException
-