com.sas.servlet.tbeans.graphics.html
Class LinePlot

com.sas.servlet.tbeans.graphics.html.LinePlot

All Implemented Interfaces:

ActionProviderViewInterface, HttpActionProviderInterface, HttpActionProviderViewInterface, com.sas.beans.PropertyChangeSource, com.sas.lang.ObjectDataInterface, com.sas.servlet.tbeans.features.FeatureListInterface, FormViewInterface, GraphStyleKeysInterface, RenderableInterface, TransformationInterface, com.sas.util.WriteToPrintWriterInterface, java.io.Serializable

public class LinePlot
implements GraphStyleKeysInterface, FormViewInterface

The LinePlot TransformationBean is a servlet component that produces line plots that support the visualization of multiple response variables. Line plots show the relationship of one variable to another.

When generating a graph, a LinePlot does not summarize the data from a LinePlotTableDataModel.

Note. A LinePlot is typically used to plot scientific data with X and Y variables that have continuous values. For generating more business-oriented graphs that plot response values against discrete categorical values, the LineChart is better suited than the LinePlot.

A LinePlot is similar to a ScatterPlot and differs as follows:

• The defaults of a LinePlot are set to connect plot points with an interpolated line. The defaults of a ScatterPlot are set for displaying plot points with no interpolation lines. (Only the defaults differ; either plot can enable or disable the display of plot markers or interpolated lines.)
• A ScatterPlot can use a Size variable to set the size of plot markers. The Size variable is useful for producing Bubble plots. A LinePlot cannot use a Size variable and cannot produce Bubble plots.

Note. This class can be used to render server-side graphs in Java servlets or JavaServer Pages (JSP). The com.sas.graphics.components.LinePlot class can be used to render client-side graphs in Java applications or applets. Both classes use the models in the com.sas.graphics.components package.

Topics:

Minimum Specification
Functional Overview
Data Access
Display Properties
Titles and Footnotes
Usage Examples
Behavior

Servlet-based Samples

See Also:

LinePlotModel, LinePlotDataModel, LinePlotTableDataModel, LinePlotOLAPDataModel, GraphStyle, Serialized Form

Field Summary

Fields inherited from interface com.sas.servlet.tbeans.graphics.html.GraphStyleKeysInterface

GRAPH_STYLE

Constructor Summary

LinePlot()
Constructs a new LinePlot Transformation Bean

LinePlot(LinePlotTableDataModel dataModel)

Method Summary

java.util.HashMap	getAdditionalParameters() Returns an HashMap containing additional parameters that should be added to the form used to perform the various actions on the table.
LinePlotDataModel	getDataModel() Gets the model on the viewer.
Form	getDefaultFormObject() Returns the FORM object used if no FORM object is specifed.
Form	getFormObject() Returns the FORM Object used to execute commands.
boolean	isFormEnabled() Determines if the tbean should render its formObject.
void	setAdditionalParameter(java.lang.String name, java.lang.String value) Sets an additional parameter to be added to the form used to perform the various actions on the table.
void	setAdditionalParameters(java.util.HashMap map) Sets an HashMap containing additional parameters that should be added to the form used to perform the various actions on the table.
void	setDataModel(LinePlotTableDataModel dataModel) Sets the model on the viewer.
void	setFormEnabled(boolean value) Sets whether the tbean should render its formObject.
void	setFormObject(Form formObject) Returns the FORM Object used to execute commands.
void	write(java.io.PrintWriter out) Writes the transformed representation of the object This method calls the cleanUpResources method at the end to reset the request and response back to null.

Methods inherited from class com.sas.servlet.tbeans.graphics.BaseLinePlot

applyColorScheme, applyGraphStyle, getGraphModel, getImageMapInfo, setDataModel, setGraphModel

Methods inherited from class com.sas.servlet.tbeans.BaseActionTransformation

dispose, getActionProvider, getActionSupportType, getUniqueId, isActionVisible, listActionTypes, listAreaTypes, setActionProvider, setActionSupportType, setActionVisible, setUniqueId

Methods inherited from class com.sas.servlet.tbeans.BaseTransformation

addPropertyChangeListener, addPropertyChangeListener, cleanUpResources, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getCustomAttributes, getDescription, getId, getInputTransform, getLocale, getName, getObjectData, getObjectDataProperty, getOutputTransform, getRequest, getResponse, getTagEpilog, getTagProlog, hasListeners, isCleanUpResourcesOn, isVisible, removePropertyChangeListener, removePropertyChangeListener, setCleanUpResourcesOn, setCustomAttributes, setDescription, setId, setInputTransform, setLocale, setLocaleDependentProperties, setName, setObjectData, setObjectDataProperty, setOutputTransform, setRequest, setResponse, setTagEpilog, setTagProlog, setVisible, toString, write, write, write

Methods inherited from interface com.sas.actionprovider.HttpActionProviderViewInterface

getRequest, setRequest

Constructor Detail

LinePlot

public LinePlot()

Constructs a new LinePlot Transformation Bean

LinePlot

public LinePlot(LinePlotTableDataModel dataModel)

Method Detail

setDataModel

public void setDataModel(LinePlotTableDataModel dataModel)

Sets the model on the viewer.

Parameters:

dataModel - an instance of the LineChartTableDataModel

getDataModel

public LinePlotDataModel getDataModel()

Gets the model on the viewer.

getDefaultFormObject

public Form getDefaultFormObject()

Returns the FORM object used if no FORM object is specifed.

Specified by:

getDefaultFormObject in interface FormViewInterface

Returns:

FORM object

See Also:

getFormObject()

getFormObject

public Form getFormObject()

Returns the FORM Object used to execute commands.

Specified by:

getFormObject in interface FormViewInterface

Returns:

FORM object

See Also:

setFormObject(com.sas.servlet.tbeans.form.html.Form)

setFormObject

public void setFormObject(Form formObject)

Returns the FORM Object used to execute commands.

Specified by:

setFormObject in interface FormViewInterface

Parameters:

formObject - FORM object

See Also:

getFormObject()

getAdditionalParameters

public java.util.HashMap getAdditionalParameters()

Returns an HashMap containing additional parameters that should be added to the form used to perform the various actions on the table. The default value is null. In the html version, each parameter will be added to the form as a hidden field using the name of the item as the name= parameter on the <input> tag and the value of the item as the value= parameter on the input tag.

Specified by:

getAdditionalParameters in interface FormViewInterface

Returns:

a HashMap containing additional parameters that should be added to the form

See Also:

HashMap

setAdditionalParameters

public void setAdditionalParameters(java.util.HashMap map)

Sets an HashMap containing additional parameters that should be added to the form used to perform the various actions on the table. The default value is null. In the html version, each parameter will be added to the form as a hidden field using the name of the item as the name= parameter on the <input> tag and the value of the item as the value= parameter on the input tag.

Specified by:

setAdditionalParameters in interface FormViewInterface

Parameters:

map - HashMap object

See Also:

HashMap

setAdditionalParameter

public void setAdditionalParameter(java.lang.String name,
                                   java.lang.String value)

Sets an additional parameter to be added to the form used to perform the various actions on the table. In the html version, Each parameter will be added to the form as a hidden field using the name of the item as the name= parameter on the <input> tag and the value of the item as the value= parameter on the input tag.

Specified by:

setAdditionalParameter in interface FormViewInterface

Parameters:

name - name of the list item

value - value of the list item

See Also:

HashMap

isFormEnabled

public boolean isFormEnabled()

Determines if the tbean should render its formObject. If true, then the tbean is responsible for rendering the formObject via the formObject's writeHeader and writeFooter methods. If false then the tbean does not render the formObject and the user is responsible for rendering the formObject.

Specified by:

isFormEnabled in interface FormViewInterface

Returns:

true if the tbean should render its formObject

setFormEnabled

public void setFormEnabled(boolean value)

Sets whether the tbean should render its formObject. If so, then set to true. If set to false, the the user is responsible for rendering the formObject via its writeHeader and writeFooter methods.

Specified by:

setFormEnabled in interface FormViewInterface

Parameters:

value - true if the formObject should be rendered by the tbean

write

public void write(java.io.PrintWriter out)
           throws java.io.IOException

Writes the transformed representation of the object This method calls the cleanUpResources method at the end to reset the request and response back to null.

Specified by:

write in interface TransformationInterface

Specified by:

write in interface com.sas.util.WriteToPrintWriterInterface

Overrides:

write in class BaseActionTransformation

Parameters:

out - The output stream

Throws:

java.io.IOException - Thrown if some type of I/O error occurs