org.icefaces.ace.component.listexporter

Class ListExporterBase

java.lang.Object

javax.faces.component.UIComponent

javax.faces.component.UIComponentBase

org.icefaces.ace.component.listexporter.ListExporterBase

All Implemented Interfaces:

java.util.EventListener, javax.faces.component.behavior.ClientBehaviorHolder, javax.faces.component.PartialStateHolder, javax.faces.component.StateHolder, javax.faces.component.TransientStateHolder, javax.faces.event.ComponentSystemEventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListenerHolder, IceClientBehaviorHolder, IListExporter

Direct Known Subclasses:

ListExporter

public abstract class ListExporterBase
extends javax.faces.component.UIComponentBase
implements IListExporter, IceClientBehaviorHolder

Utility to export data from an ace:list component as an Excel, PDF, XML or CSV document. This component renders an HTML button. More components and HTML elements can be nested inside this tag to give a different look to the button.

For more information, see the ListExporter Wiki Documentation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ListExporterBase.PropertyKeys

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMPONENT_TYPE
static java.lang.String	RENDERER_TYPE

Fields inherited from class javax.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Constructor Summary

Constructors

Constructor and Description
ListExporterBase()

Method Summary

Modifier and Type	Method and Description
void	addClientBehavior(java.lang.String eventName, javax.faces.component.behavior.ClientBehavior behavior)
java.lang.String	getAccesskey() Return the value of the accesskey property.
java.lang.Object	getCustomExporter() Return the value of the customExporter property.
java.lang.String	getDefaultEventName()
java.lang.String	getDefaultExecute(java.lang.String event)
java.lang.String	getDefaultRender(java.lang.String event)
java.lang.String	getEncoding() Return the value of the encoding property.
java.util.Collection<java.lang.String>	getEventNames()
java.lang.String	getFamily()
java.lang.String	getFileName() Return the value of the fileName property.
java.lang.String	getLabel() Return the value of the label property.
java.lang.String	getListenerArgument(java.lang.String event)
java.lang.String	getPdfFont() Return the value of the pdfFont property.
javax.el.MethodExpression	getPostProcessor() Return the value of the postProcessor property.
javax.el.MethodExpression	getPreProcessor() Return the value of the preProcessor property.
java.lang.String	getStyle() Return the value of the style property.
java.lang.String	getStyleClass() Return the value of the styleClass property.
java.lang.String	getTarget() Return the value of the target property.
java.lang.String	getTextToExport() Return the value of the textToExport property.
java.lang.String	getType() Return the value of the type property.
boolean	isIncludeHeaders() Return the value of the includeHeaders property.
protected boolean	isPropertySet(java.lang.String finder)
boolean	isSelectedItemsOnly() Return the value of the selectedItemsOnly property.
void	setAccesskey(java.lang.String accesskey) Set the value of the accesskey property.
void	setCustomExporter(java.lang.Object customExporter) Set the value of the customExporter property.
void	setEncoding(java.lang.String encoding) Set the value of the encoding property.
void	setFileName(java.lang.String fileName) Set the value of the fileName property.
void	setIncludeHeaders(boolean includeHeaders) Set the value of the includeHeaders property.
void	setLabel(java.lang.String label) Set the value of the label property.
void	setPdfFont(java.lang.String pdfFont) Set the value of the pdfFont property.
void	setPostProcessor(javax.el.MethodExpression postProcessor) Set the value of the postProcessor property.
void	setPreProcessor(javax.el.MethodExpression preProcessor) Set the value of the preProcessor property.
void	setSelectedItemsOnly(boolean selectedItemsOnly) Set the value of the selectedItemsOnly property.
void	setStyle(java.lang.String style) Set the value of the style property.
void	setStyleClass(java.lang.String styleClass) Set the value of the styleClass property.
void	setTarget(java.lang.String target) Set the value of the target property.
void	setTextToExport(java.lang.String textToExport) Set the value of the textToExport property.
void	setType(java.lang.String type) Set the value of the type property.
void	setValueExpression(java.lang.String name, javax.el.ValueExpression binding)

Methods inherited from class javax.faces.component.UIComponentBase

addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, visitTree

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.faces.component.behavior.ClientBehaviorHolder

getClientBehaviors

Field Detail

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

See Also:

Constant Field Values

RENDERER_TYPE

public static final java.lang.String RENDERER_TYPE

See Also:

Constant Field Values

Constructor Detail

ListExporterBase

public ListExporterBase()

Method Detail

getFamily

public java.lang.String getFamily()

Specified by:

getFamily in class javax.faces.component.UIComponent

setAccesskey

public void setAccesskey(java.lang.String accesskey)

Set the value of the accesskey property.

Contents: Access key that, when pressed, transfers focus to this component.

Specified by:

setAccesskey in interface IListExporter

getAccesskey

public java.lang.String getAccesskey()

Return the value of the accesskey property.

Contents: Access key that, when pressed, transfers focus to this component.

Specified by:

getAccesskey in interface IListExporter

setCustomExporter

public void setCustomExporter(java.lang.Object customExporter)

Set the value of the customExporter property.

Contents: Specifies an object that implements a custom format type to use instead of one of the built-in formats. When this attribute is specified, it will override the "type" attribute. The object must extend org.icefaces.ace.component.listexporter.Exporter.

Specified by:

setCustomExporter in interface IListExporter

getCustomExporter

public java.lang.Object getCustomExporter()

Return the value of the customExporter property.

Contents: Specifies an object that implements a custom format type to use instead of one of the built-in formats. When this attribute is specified, it will override the "type" attribute. The object must extend org.icefaces.ace.component.listexporter.Exporter.

Specified by:

getCustomExporter in interface IListExporter

setEncoding

public void setEncoding(java.lang.String encoding)

Set the value of the encoding property.

Contents: Define a character encoding to use. Valid values will depend on the host system and format in use. For plain text formats (CSV and XML), the encoding has to be supported by the JVM running the server. Typically, these values include UTF-8, UTF-16, US-ASCII, ISO-8859-1, Windows-1252, among others. For the PDF format, this attribute is only applicable if a custom font is also specified via the 'pdfFont' attribute, and the encoding has to be supported by such font. For the XLS format, this attributr is not applicable; Unicode is used by default.

Specified by:

setEncoding in interface IListExporter

getEncoding

public java.lang.String getEncoding()

Return the value of the encoding property.

Contents: Define a character encoding to use. Valid values will depend on the host system and format in use. For plain text formats (CSV and XML), the encoding has to be supported by the JVM running the server. Typically, these values include UTF-8, UTF-16, US-ASCII, ISO-8859-1, Windows-1252, among others. For the PDF format, this attribute is only applicable if a custom font is also specified via the 'pdfFont' attribute, and the encoding has to be supported by such font. For the XLS format, this attributr is not applicable; Unicode is used by default. Default = 'UTF-8'.

Specified by:

getEncoding in interface IListExporter

setFileName

public void setFileName(java.lang.String fileName)

Set the value of the fileName property.

Contents: Define the filename of the generated file, defaults to the target id.

Specified by:

setFileName in interface IListExporter

getFileName

public java.lang.String getFileName()

Return the value of the fileName property.

Contents: Define the filename of the generated file, defaults to the target id.

Specified by:

getFileName in interface IListExporter

setIncludeHeaders

public void setIncludeHeaders(boolean includeHeaders)

Set the value of the includeHeaders property.

Contents: When using ace:listValueExporter components, determine whether the names should be included at the top of the file. This is not applicable when the attribute 'type' is set to 'xml'.

Specified by:

setIncludeHeaders in interface IListExporter

isIncludeHeaders

public boolean isIncludeHeaders()

Return the value of the includeHeaders property.

Contents: When using ace:listValueExporter components, determine whether the names should be included at the top of the file. This is not applicable when the attribute 'type' is set to 'xml'. Default = 'true'.

Specified by:

isIncludeHeaders in interface IListExporter

setLabel

public void setLabel(java.lang.String label)

Set the value of the label property.

Contents: Define the text that will appear on the button to trigger the export. Default value is 'Export'. This attribute applies only if the component has no children.

Specified by:

setLabel in interface IListExporter

getLabel

public java.lang.String getLabel()

Return the value of the label property.

Contents: Define the text that will appear on the button to trigger the export. Default value is 'Export'. This attribute applies only if the component has no children.

Specified by:

getLabel in interface IListExporter

setPdfFont

public void setPdfFont(java.lang.String pdfFont)

Set the value of the pdfFont property.

Contents: The absolute path in the host system (e.g. C:\Windows\Fonts\arial.ttf) to a font file to be used in the PDF exporting instead of the default font. If specifying a custom 'encoding' value, it has to be supported by this custom font. Note that the default font does not support unicode characters, so a custom font has to be set in order to support these characters.

Specified by:

setPdfFont in interface IListExporter

getPdfFont

public java.lang.String getPdfFont()

Return the value of the pdfFont property.

Contents: The absolute path in the host system (e.g. C:\Windows\Fonts\arial.ttf) to a font file to be used in the PDF exporting instead of the default font. If specifying a custom 'encoding' value, it has to be supported by this custom font. Note that the default font does not support unicode characters, so a custom font has to be set in order to support these characters.

Specified by:

getPdfFont in interface IListExporter

setPostProcessor

public void setPostProcessor(javax.el.MethodExpression postProcessor)

Set the value of the postProcessor property.

Contents: Defines a public void method to invoke after the PDF or XLS document has been generated, allowing developers to manipulate the document. It must take a single argument of type Object. The object will be of type com.itextpdf.text.Document (iText library) for PDF documents and of type org.apache.poi.ss.usermodel.Workbook (Apache POI library) for XLS documents. (Note: if the old 2.1.7 iText library is being used, then the object has to be of type com.lowagie.text.Document for PDF documents)

Specified by:

setPostProcessor in interface IListExporter

getPostProcessor

public javax.el.MethodExpression getPostProcessor()

Return the value of the postProcessor property.

Contents: Defines a public void method to invoke after the PDF or XLS document has been generated, allowing developers to manipulate the document. It must take a single argument of type Object. The object will be of type com.itextpdf.text.Document (iText library) for PDF documents and of type org.apache.poi.ss.usermodel.Workbook (Apache POI library) for XLS documents. (Note: if the old 2.1.7 iText library is being used, then the object has to be of type com.lowagie.text.Document for PDF documents)

Specified by:

getPostProcessor in interface IListExporter

setPreProcessor

public void setPreProcessor(javax.el.MethodExpression preProcessor)

Set the value of the preProcessor property.

Contents: Defines a public void method to invoke before the PDF or XLS document is generated, allowing developers to manipulate the document. It must take a single argument of type Object. The object will be of type com.itextpdf.text.Document (iText library) for PDF documents and of type org.apache.poi.ss.usermodel.Workbook (Apache POI library) for XLS documents. (Note: if the old 2.1.7 iText library is being used, then the object has to be of type com.lowagie.text.Document for PDF documents)

Specified by:

setPreProcessor in interface IListExporter

getPreProcessor

public javax.el.MethodExpression getPreProcessor()

Return the value of the preProcessor property.

Contents: Defines a public void method to invoke before the PDF or XLS document is generated, allowing developers to manipulate the document. It must take a single argument of type Object. The object will be of type com.itextpdf.text.Document (iText library) for PDF documents and of type org.apache.poi.ss.usermodel.Workbook (Apache POI library) for XLS documents. (Note: if the old 2.1.7 iText library is being used, then the object has to be of type com.lowagie.text.Document for PDF documents)

Specified by:

getPreProcessor in interface IListExporter

setSelectedItemsOnly

public void setSelectedItemsOnly(boolean selectedItemsOnly)

Set the value of the selectedItemsOnly property.

Contents: Enable to export only the currently selected list items instead of the whole data set.

Specified by:

setSelectedItemsOnly in interface IListExporter

isSelectedItemsOnly

public boolean isSelectedItemsOnly()

Return the value of the selectedItemsOnly property.

Contents: Enable to export only the currently selected list items instead of the whole data set. Default = 'false'.

Specified by:

isSelectedItemsOnly in interface IListExporter

setStyle

public void setStyle(java.lang.String style)

Set the value of the style property.

Contents: Custom inline CSS styles to use for this component. These styles are generally applied to the root DOM element of the component. This is intended for per-component basic style customizations. Note that due to browser CSS precedence rules, CSS rendered on a DOM element will take precedence over the external stylesheets used to provide the ThemeRoller theme on this component. If the CSS properties applied with this attribute do not affect the DOM element you want to style, you may need to create a custom theme styleClass for the theme CSS class that targets the particular DOM elements you wish to customize.

Specified by:

setStyle in interface IListExporter

getStyle

public java.lang.String getStyle()

Return the value of the style property.

Contents: Custom inline CSS styles to use for this component. These styles are generally applied to the root DOM element of the component. This is intended for per-component basic style customizations. Note that due to browser CSS precedence rules, CSS rendered on a DOM element will take precedence over the external stylesheets used to provide the ThemeRoller theme on this component. If the CSS properties applied with this attribute do not affect the DOM element you want to style, you may need to create a custom theme styleClass for the theme CSS class that targets the particular DOM elements you wish to customize.

Specified by:

getStyle in interface IListExporter

setStyleClass

public void setStyleClass(java.lang.String styleClass)

Set the value of the styleClass property.

Contents: Custom CSS style class(es) to use for this component. These style classes can be defined in your page or in a theme CSS file.

Specified by:

setStyleClass in interface IListExporter

getStyleClass

public java.lang.String getStyleClass()

Return the value of the styleClass property.

Contents: Custom CSS style class(es) to use for this component. These style classes can be defined in your page or in a theme CSS file.

Specified by:

getStyleClass in interface IListExporter

setTarget

public void setTarget(java.lang.String target)

Set the value of the target property.

Contents: Define the id of the ace:list component whose data will be exported.

Specified by:

setTarget in interface IListExporter

getTarget

public java.lang.String getTarget()

Return the value of the target property.

Contents: Define the id of the ace:list component whose data will be exported.

Specified by:

getTarget in interface IListExporter

setTextToExport

public void setTextToExport(java.lang.String textToExport)

Set the value of the textToExport property.

Contents: When the model is based on SelectItem's, specify if the exported text should be the label, the actual value or both (the label with the actual value in parentheses).

Specified by:

setTextToExport in interface IListExporter

getTextToExport

public java.lang.String getTextToExport()

Return the value of the textToExport property.

Contents: When the model is based on SelectItem's, specify if the exported text should be the label, the actual value or both (the label with the actual value in parentheses). Default = 'label'.

Specified by:

getTextToExport in interface IListExporter

setType

public void setType(java.lang.String type)

Set the value of the type property.

Contents: Define the format of file export. Available formats: "xls", "pdf", "csv", and "xml".

Specified by:

setType in interface IListExporter

getType

public java.lang.String getType()

Return the value of the type property.

Contents: Define the format of file export. Available formats: "xls", "pdf", "csv", and "xml". Default = 'csv'.

Specified by:

getType in interface IListExporter

isPropertySet

protected boolean isPropertySet(java.lang.String finder)

setValueExpression

public void setValueExpression(java.lang.String name,
                               javax.el.ValueExpression binding)

Overrides:

setValueExpression in class javax.faces.component.UIComponent

getEventNames

public java.util.Collection<java.lang.String> getEventNames()

Specified by:

getEventNames in interface javax.faces.component.behavior.ClientBehaviorHolder

Overrides:

getEventNames in class javax.faces.component.UIComponentBase

getDefaultEventName

public java.lang.String getDefaultEventName()

Specified by:

getDefaultEventName in interface javax.faces.component.behavior.ClientBehaviorHolder

Overrides:

getDefaultEventName in class javax.faces.component.UIComponentBase

getDefaultRender

public java.lang.String getDefaultRender(java.lang.String event)

Specified by:

getDefaultRender in interface IceClientBehaviorHolder

getDefaultExecute

public java.lang.String getDefaultExecute(java.lang.String event)

Specified by:

getDefaultExecute in interface IceClientBehaviorHolder

getListenerArgument

public java.lang.String getListenerArgument(java.lang.String event)

Specified by:

getListenerArgument in interface IceClientBehaviorHolder

addClientBehavior

public void addClientBehavior(java.lang.String eventName,
                              javax.faces.component.behavior.ClientBehavior behavior)

Specified by:

addClientBehavior in interface javax.faces.component.behavior.ClientBehaviorHolder

Overrides:

addClientBehavior in class javax.faces.component.UIComponentBase