Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

com.vaadin.ui.FieldFactory
FieldFactory was split into two lighter interfaces in 6.0 Use FormFieldFactory or TableFieldFactory or both instead.

Deprecated Classes

com.vaadin.ui.BaseFieldFactory
use DefaultFieldFactory or own implementations on FormFieldFactory or TableFieldFactory instead.

com.vaadin.ui.ExpandLayout
Deprecated in favor of the new OrderedLayout

com.vaadin.terminal.gwt.client.ui.MenuBar

com.vaadin.terminal.gwt.client.ui.MenuItem

com.vaadin.ui.OrderedLayout
Replaced by VerticalLayout/HorizontalLayout. For type checking please not that VerticalLayout/HorizontalLayout do not extend OrderedLayout but AbstractOrderedLayout (which also OrderedLayout extends).

com.vaadin.terminal.gwt.client.UIDL.XML
should not be used anymore

Deprecated Fields

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_BOTTOM
Use of Alignment class and its constants

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_HORIZONTAL_CENTER
Use of Alignment class and its constants

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_LEFT
Use of Alignment class and its constants

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_RIGHT
Use of Alignment class and its constants

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_TOP
Use of Alignment class and its constants

com.vaadin.ui.Layout.AlignmentHandler.ALIGNMENT_VERTICAL_CENTER
Use of Alignment class and its constants

com.vaadin.ui.themes.Reindeer.BUTTON_PRIMARY
Use Reindeer.BUTTON_DEFAULT instead

com.vaadin.ui.Label.CONTENT_UIDL
Use CONTENT_XML instead.

com.vaadin.ui.themes.Reindeer.LABEL_LIGHT
Use Reindeer.LABEL_SMALL instead.

com.vaadin.ui.themes.BaseTheme.PANEL_LIGHT
Base theme does not implement this style, but it is defined here since it has been a part of the framework before multiple themes were available. Use the constant provided by the theme you're using instead, e.g. Reindeer.PANEL_LIGHT or Runo.PANEL_LIGHT.

com.vaadin.ui.Panel.STYLE_LIGHT
this style is no longer part of the core framework and this component, even though most built-in themes implement this style. Use the constant specified in the theme class file that you're using, if it provides one, e.g. Reindeer.PANEL_LIGHT or Runo.PANEL_LIGHT .

com.vaadin.ui.Button.STYLE_LINK
use BaseTheme.BUTTON_LINK instead.

com.vaadin.ui.Slider.STYLE_SCROLLBAR

com.vaadin.ui.themes.Reindeer.TABSHEET_BAR
Use Reindeer.TABSHEET_SMALL instead.

com.vaadin.terminal.gwt.client.ApplicationConnection.UIDL_SECURITY_HEADER
use UIDL_SECURITY_TOKEN_ID instead

Deprecated Methods

com.vaadin.service.ApplicationContext.generateApplicationResourceURL(ApplicationResource, String)
this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager)

com.vaadin.terminal.gwt.client.UIDL.getChildrenAsXML()

com.vaadin.ui.MenuBar.getCollapse()

com.vaadin.ui.Select.getColumns()
see setter function

com.vaadin.ui.CustomComponent.getComponentType()
not more useful as the whole tag system has been removed

com.vaadin.ui.Table.getFieldFactory()
use Table.getTableFieldFactory() instead

com.vaadin.ui.TextField.getFormat()
replaced by PropertyFormatter

com.vaadin.ui.TextField.getFormattedValue()

com.vaadin.ui.Slider.getHandleSize()
The size is dictated by the current theme.

com.vaadin.ui.Panel.getLayout()
A Panel can now contain a ComponentContainer which is not necessarily a Layout. Use Panel.getContent() instead.

com.vaadin.ui.Window.Notification.getMessage()
Use Window.Notification.getDescription() instead.

com.vaadin.ui.PopupView.getPopupVisibility()
Use PopupView.isPopupVisible() instead.

com.vaadin.ui.Upload.getProgressListener()
Replaced with addListener/removeListener

com.vaadin.Application.getRelativeLocation(ApplicationResource)
this method is intended to be used by the terminal only. It may be removed or moved in the future.

com.vaadin.ui.Panel.getScrollOffsetX()
use Panel.getScrollLeft() instead

com.vaadin.ui.Panel.getScrollOffsetY()
use Panel.getScrollTop() instead

com.vaadin.ui.Slider.getSize()
use standard getWidth/getHeight instead

com.vaadin.ui.AbstractComponent.getStyle()
Use getStyleName() instead; renamed for consistency and to indicate that "style" should not be used to switch client side implementation, only to style the component.

com.vaadin.ui.MenuBar.getSubmenuIcon()

com.vaadin.ui.TabSheet.getTabCaption(Component)
Use TabSheet.getTab(Component) and TabSheet.Tab.getCaption() instead.

com.vaadin.ui.TabSheet.getTabIcon(Component)
Use TabSheet.getTab(Component) and TabSheet.Tab.getIcon() instead.

com.vaadin.ui.AbstractComponent.getTag()
tags are no more required for components. Instead of tags we are now using ClientWidget annotations to map server side components to client side counterparts. Generating identifier for component type is delegated to terminal.

com.vaadin.service.ApplicationContext.getURLKey(URL, String)
this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager)

com.vaadin.ui.GridLayout.Area.getX1()
Use getColumn1() instead.

com.vaadin.ui.GridLayout.Area.getX2()
Use getColumn2() instead.

com.vaadin.ui.GridLayout.Area.getY1()
Use getRow1() instead.

com.vaadin.ui.GridLayout.Area.getY2()
Use getRow2() instead.

com.vaadin.Application.handleURI(URL, String)
this method is called be the terminal implementation only and might be removed or moved in the future. Instead of overriding this method, add your URIHandler to a top level Window (eg. getMainWindow().addUriHanler(handler) instead.

com.vaadin.service.ApplicationContext.isApplicationResourceURL(URL, String)
this method is intended for terminal implementation only and is subject to change/removal from the interface (to AbstractCommunicationManager)

com.vaadin.terminal.gwt.client.Util.isFF2()
use BrowserInfo class instead

com.vaadin.terminal.gwt.client.Util.isIE()
use BrowserInfo class instead

com.vaadin.terminal.gwt.client.Util.isIE6()
use BrowserInfo class instead

com.vaadin.terminal.gwt.client.Util.isIE7()
use BrowserInfo class instead

com.vaadin.data.validator.StringLengthValidator.isNullAllowed()

com.vaadin.ui.Table.isPageBufferingEnabled()
functionality is not needed in ajax rendering model

com.vaadin.ui.GridLayout.isSpacingEnabled()

com.vaadin.ui.AbstractOrderedLayout.isSpacingEnabled()

com.vaadin.ui.Layout.SpacingHandler.isSpacingEnabled()
Use Layout.SpacingHandler.isSpacing() instead.

com.vaadin.terminal.PaintTarget.paintReference(Paintable, String)
use PaintTarget.addAttribute(String, Paintable) or PaintTarget.addVariable(VariableOwner, String, Paintable) instead

com.vaadin.terminal.gwt.server.JsonPaintTarget.paintReference(Paintable, String)

com.vaadin.ui.Table.refreshCurrentPage()
should not need to be used

com.vaadin.ui.MenuBar.setCollapse(boolean)
(since 6.2, will be removed in 7.0) Collapsing is always enabled if the MenuBar has a specified width.

com.vaadin.ui.Select.setColumns(int)

com.vaadin.ui.Layout.AlignmentHandler.setComponentAlignment(Component, int, int)
Use Layout.AlignmentHandler.setComponentAlignment(Component, Alignment) instead

com.vaadin.ui.CustomComponent.setComponentType(String)
not more useful as the whole tag system has been removed

com.vaadin.ui.Table.setFieldFactory(FieldFactory)
use Table.setTableFieldFactory(TableFieldFactory) instead

com.vaadin.ui.Form.setFieldFactory(FieldFactory)
use Form.setFormFieldFactory(FormFieldFactory) instead

com.vaadin.ui.TextField.setFormat(Format)
replaced by PropertyFormatter

com.vaadin.ui.Slider.setHandleSize(int)
The size is dictated by the current theme.

com.vaadin.terminal.Sizeable.setHeight(float)
Consider using Sizeable.setHeight(String) or Sizeable.setHeight(float, int) instead. This method works, but is error-prone since the unit must be set separately (and components might have different default unit).

com.vaadin.ui.AbstractComponent.setHeight(float)

com.vaadin.terminal.Sizeable.setHeightUnits(int)
Consider setting height and unit simultaneously using Sizeable.setHeight(String) or Sizeable.setHeight(float, int), which is less error-prone.

com.vaadin.ui.AbstractComponent.setHeightUnits(int)

com.vaadin.ui.Panel.setLayout(Layout)
A Panel can now contain a ComponentContainer which is not necessarily a Layout. Use Panel.setContent(ComponentContainer) instead.

com.vaadin.ui.Window.Notification.setMessage(String)
Use Window.Notification.setDescription(String) instead.

com.vaadin.data.validator.StringLengthValidator.setNullAllowed(boolean)

com.vaadin.ui.OrderedLayout.setOrientation(int)
Use VerticalLayout/HorizontalLayout or define orientation in constructor instead

com.vaadin.ui.Table.setPageBufferingEnabled(boolean)
functionality is not needed in ajax rendering model

com.vaadin.ui.PopupView.setPopupVisibility(boolean)
Use #setPopupVisible() instead.

com.vaadin.ui.Upload.setProgressListener(Upload.ProgressListener)
Use addListener(ProgressListener) instead.

com.vaadin.ui.Panel.setScrollOffsetX(int)
use setScrollLeft() method instead

com.vaadin.ui.Panel.setScrollOffsetY(int)
use setScrollTop() method instead

com.vaadin.ui.Slider.setSize(int)
use standard setWidth/setHeight instead

com.vaadin.ui.AbstractComponent.setStyle(String)
Use setStyleName() instead; renamed for consistency and to indicate that "style" should not be used to switch client side implementation, only to style the component.

com.vaadin.ui.CustomLayout.setStyle(String)
Use CustomLayout.setTemplateName(String) instead

com.vaadin.ui.MenuBar.setSubmenuIcon(Resource)
(since 6.2, will be removed in 7.0) Icon is set in theme, no need to worry about the visual representation here.

com.vaadin.ui.TabSheet.setTabCaption(Component, String)
Use TabSheet.getTab(Component) and TabSheet.Tab.setCaption(String) instead.

com.vaadin.ui.TabSheet.setTabIcon(Component, Resource)
Use TabSheet.getTab(Component) and TabSheet.Tab.setIcon(Resource) instead.

com.vaadin.terminal.Sizeable.setWidth(float)
Consider using Sizeable.setWidth(String) instead. This method works, but is error-prone since the unit must be set separately (and components might have different default unit).

com.vaadin.ui.AbstractComponent.setWidth(float)

com.vaadin.terminal.Sizeable.setWidthUnits(int)
Consider setting width and unit simultaneously using Sizeable.setWidth(String) or Sizeable.setWidth(float, int), which is less error-prone.

com.vaadin.ui.AbstractComponent.setWidthUnits(int)

Deprecated Constructors

com.vaadin.terminal.gwt.server.CommunicationManager(Application, AbstractApplicationServlet)
use CommunicationManager.CommunicationManager(Application) instead

com.vaadin.ui.OrderedLayout()
Use VerticalLayout instead.

com.vaadin.ui.OrderedLayout(int)
Use VerticalLayout/HorizontalLayout instead.