Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

com.vaadin.terminal.gwt.client.Paintable

com.vaadin.terminal.VariableOwner
in 7.0. Only provided to ease porting of Vaadin 6 components. Do not implement this directly, implement Vaadin6Component.

Deprecated Classes

com.vaadin.Application.LegacyApplication
This class is only intended to ease migration and should not be used for new projects.

com.vaadin.terminal.gwt.client.ClientExceptionHandler

com.vaadin.data.validator.DoubleValidator
in Vaadin 7.0. Use an Double converter on the field instead.

com.vaadin.ui.Form
Use FieldGroup instead of Form for more flexibility.

com.vaadin.data.validator.IntegerValidator
in Vaadin 7.0. Use an Integer converter on the field instead.

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

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

com.vaadin.data.util.PropertyFormatter
Since 7.0 replaced by Converter

com.vaadin.data.util.QueryContainer
will be removed in the future, use the SQLContainer add-on

com.vaadin.ui.Root.LegacyWindow

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

com.vaadin.tools.WidgetsetCompiler
with Java 6, can use com.google.gwt.dev.Compiler directly (also in Eclipse plug-in etc.)

Deprecated Fields

com.vaadin.ui.Table.ALIGN_CENTER
from 7.0, use Table.Align.CENTER instead

com.vaadin.ui.Table.ALIGN_LEFT
from 7.0, use Table.Align.LEFT instead

com.vaadin.ui.Table.ALIGN_RIGHT
from 7.0, use Table.Align.RIGHT instead

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.Table.COLUMN_HEADER_MODE_EXPLICIT
from 7.0, use Table.ColumnHeaderMode.EXPLICIT instead

com.vaadin.ui.Table.COLUMN_HEADER_MODE_EXPLICIT_DEFAULTS_ID
from 7.0, use Table.ColumnHeaderMode.EXPLICIT_DEFAULTS_ID instead

com.vaadin.ui.Table.COLUMN_HEADER_MODE_HIDDEN
from 7.0, use Table.ColumnHeaderMode.HIDDEN instead

com.vaadin.ui.Table.COLUMN_HEADER_MODE_ID
from 7.0, use Table.ColumnHeaderMode.ID instead

com.vaadin.ui.Label.CONTENT_DEFAULT
From 7.0, use ContentMode.TEXT instead

com.vaadin.terminal.UserError.CONTENT_PREFORMATTED
from 7.0, use ContentMode#PREFORMATTED instead

com.vaadin.ui.Label.CONTENT_PREFORMATTED
From 7.0, use ContentMode.PREFORMATTED instead

com.vaadin.ui.Label.CONTENT_RAW
From 7.0, use ContentMode.RAW instead

com.vaadin.terminal.UserError.CONTENT_TEXT
from 7.0, use ContentMode#TEXT instead

com.vaadin.ui.Label.CONTENT_TEXT
From 7.0, use ContentMode.TEXT instead

com.vaadin.terminal.UserError.CONTENT_XHTML
from 7.0, use ContentMode#XHTML instead

com.vaadin.ui.Label.CONTENT_XHTML
From 7.0, use ContentMode.XHTML instead

com.vaadin.ui.Label.CONTENT_XML
From 7.0, use ContentMode.XML instead

com.vaadin.terminal.ErrorMessage.CRITICAL
from 7.0, use ErrorMessage.ErrorLevel.CRITICAL instead

com.vaadin.terminal.ErrorMessage.ERROR
from 7.0, use ErrorMessage.ErrorLevel.ERROR instead

com.vaadin.terminal.ErrorMessage.INFORMATION
from 7.0, use ErrorMessage.ErrorLevel.INFORMATION instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_EXPLICIT
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_ICON_ONLY
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_ID
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_INDEX
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_ITEM
from 7.0, use ItemCaptionMode.ID instead

com.vaadin.ui.AbstractSelect.ITEM_CAPTION_MODE_PROPERTY
from 7.0, use ItemCaptionMode.ID instead

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

com.vaadin.data.validator.CompositeValidator.MODE_AND
from 7.0, use CompositeValidator.CombinationMode.AND instead

com.vaadin.data.validator.CompositeValidator.MODE_OR
from 7.0, use CompositeValidator.CombinationMode.OR 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.DateField.RESOLUTION_DAY
Use DateField.Resolution.DAY

com.vaadin.ui.DateField.RESOLUTION_HOUR
Use DateField.Resolution.HOUR

com.vaadin.ui.DateField.RESOLUTION_MIN
Use DateField.Resolution.MINUTE

com.vaadin.ui.DateField.RESOLUTION_MONTH
Use DateField.Resolution.MONTH

com.vaadin.ui.DateField.RESOLUTION_SEC
Use DateField.Resolution.SECOND

com.vaadin.ui.DateField.RESOLUTION_YEAR
Use DateField.Resolution.YEAR

com.vaadin.ui.Table.ROW_HEADER_MODE_EXPLICIT
from 7.0, use Table.RowHeaderMode.EXPLICIT instead

com.vaadin.ui.Table.ROW_HEADER_MODE_EXPLICIT_DEFAULTS_ID
from 7.0, use Table.RowHeaderMode.EXPLICIT_DEFAULTS_ID instead

com.vaadin.ui.Table.ROW_HEADER_MODE_HIDDEN
from 7.0, use Table.RowHeaderMode.HIDDEN instead

com.vaadin.ui.Table.ROW_HEADER_MODE_ICON_ONLY
from 7.0, use Table.RowHeaderMode.ICON_ONLY instead

com.vaadin.ui.Table.ROW_HEADER_MODE_ID
from 7.0, use Table.RowHeaderMode.ID instead

com.vaadin.ui.Table.ROW_HEADER_MODE_INDEX
from 7.0, use Table.RowHeaderMode.INDEX instead

com.vaadin.ui.Table.ROW_HEADER_MODE_ITEM
from 7.0, use Table.RowHeaderMode.ITEM instead

com.vaadin.ui.Table.ROW_HEADER_MODE_PROPERTY
from 7.0, use Table.RowHeaderMode.PROPERTY instead

com.vaadin.terminal.ErrorMessage.SYSTEMERROR
from 7.0, use ErrorMessage.ErrorLevel.SYSTEMERROR instead

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

com.vaadin.terminal.Sizeable.UNITS_CM
from 7.0, use Sizeable.Unit.CM instead

com.vaadin.terminal.Sizeable.UNITS_EM
from 7.0, use Sizeable.Unit.EM instead

com.vaadin.terminal.Sizeable.UNITS_EX
from 7.0, use Sizeable.Unit.EX instead

com.vaadin.terminal.Sizeable.UNITS_INCH
from 7.0, use Sizeable.Unit.INCH instead

com.vaadin.terminal.Sizeable.UNITS_MM
from 7.0, use Sizeable.Unit.MM instead

com.vaadin.terminal.Sizeable.UNITS_PERCENTAGE
from 7.0, use Sizeable.Unit.PERCENTAGE instead

com.vaadin.terminal.Sizeable.UNITS_PICAS
from 7.0, use Sizeable.Unit.PICAS instead

com.vaadin.terminal.Sizeable.UNITS_PIXELS
from 7.0, use Sizeable.Unit.PIXELS instead

com.vaadin.terminal.Sizeable.UNITS_POINTS
from 7.0, use Sizeable.Unit.POINTS instead

com.vaadin.terminal.ErrorMessage.WARNING
from 7.0, use ErrorMessage.ErrorLevel.WARNING instead

Deprecated Methods

com.vaadin.ui.Root.LegacyWindow.addListener(Page.BrowserWindowResizeListener)
As of 7.0, use the similarly named api in Page instead

com.vaadin.ui.CheckBox.booleanValue()
Use AbstractField.getValue() instead and, if needed, handle null values.

com.vaadin.data.util.IndexedContainer.clone()
cloning support might be removed from IndexedContainer in the future

com.vaadin.terminal.gwt.server.AbstractApplicationServlet.createCommunicationManager(Application)
Instead of overriding this method, override WebApplicationContext implementation via AbstractApplicationServlet.getApplicationContext(HttpSession) method and in that customized implementation return your CommunicationManager in WebApplicationContext.getApplicationManager(Application, AbstractApplicationServlet) method.

com.vaadin.terminal.gwt.client.ClientExceptionHandler.displayError(String)

com.vaadin.terminal.gwt.client.ClientExceptionHandler.displayError(String, Throwable)

com.vaadin.ui.Root.LegacyWindow.executeJavaScript(String)
as of 7.0, use JavaScript.getCurrent().execute(String) instead

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.ui.Root.LegacyWindow.getBrowserWindowHeight()
As of 7.0, use the similarly named api in Page instead

com.vaadin.ui.Root.LegacyWindow.getBrowserWindowWidth()
As of 7.0, use the similarly named api in Page instead

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

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

com.vaadin.ui.HasComponents.getComponentIterator()
Use Iterable.iterator() instead.

com.vaadin.terminal.gwt.client.ApplicationConnection.getConsole()
Developers should use VConsole since 6.4.5

com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getContainsRowQueryString(Object...)
Implement FreeformStatementDelegate instead of FreeformQueryDelegate

com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getCountQuery()
Implement FreeformStatementDelegate instead of FreeformQueryDelegate

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

com.vaadin.ui.RichTextArea.getFormattedValue()

com.vaadin.terminal.gwt.client.ui.dd.DDUtil.getHorizontalDropLocation(Element, int, double)
use the version with the actual event

com.vaadin.terminal.gwt.client.ApplicationConnection.getPaintable(UIDL)

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

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

com.vaadin.data.util.sqlcontainer.query.FreeformQueryDelegate.getQueryString(int, int)
Implement FreeformStatementDelegate instead of FreeformQueryDelegate

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.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.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.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.terminal.gwt.client.ui.dd.DDUtil.getVerticalDropLocation(Element, int, double)
use the version with the actual event instead of detected clientY value

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

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

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

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

com.vaadin.terminal.gwt.client.ApplicationConnection.hasEventListeners(ComponentConnector, String)
Use ComponentState#hasEventListener(String) instead

com.vaadin.terminal.gwt.client.ApplicationConnection.hasEventListeners(Widget, String)

com.vaadin.terminal.gwt.client.ui.root.RootConnector.hasSubWindow(WindowConnector)
Should be replaced by a more generic mechanism for getting non-ComponentConnector children

com.vaadin.ui.DragAndDropWrapper.WrapperTargetDetails.horizontalDropLocation()
use DragAndDropWrapper.WrapperTargetDetails.getHorizontalDropLocation() 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.isCached(UIDL)

com.vaadin.terminal.gwt.client.ApplicationConnection.isDebugMode()
use ApplicationConfiguration isDebugMode instead.

com.vaadin.ui.Select.isMultiSelect()
use ListSelect, OptionGroup or TwinColSelect instead

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

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

com.vaadin.terminal.gwt.client.ComponentConnector.isReadOnly()
This belongs in AbstractFieldConnector, see #8514

com.vaadin.terminal.gwt.client.ui.AbstractComponentConnector.isReadOnly()

com.vaadin.data.Buffered.isReadThrough()
Use #isBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.ui.Form.isReadThrough()

com.vaadin.terminal.gwt.client.ui.AbstractComponentConnector.isRealUpdate(UIDL)

com.vaadin.ui.Table.isSortDisabled()
Use Table.isSortEnabled() instead

com.vaadin.data.Buffered.isWriteThrough()
Use Buffered.setBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.ui.Form.isWriteThrough()

com.vaadin.terminal.gwt.client.Util.notifyParentOfSizeChange(Widget, boolean)
since 7.0, use LayoutManager.setNeedsMeasure(ComponentConnector) instead

com.vaadin.ui.Root.LegacyWindow.open(Resource)
As of 7.0, use getPage().open instead

com.vaadin.ui.Root.LegacyWindow.open(Resource, String)
As of 7.0, use getPage().open instead

com.vaadin.ui.Root.LegacyWindow.open(Resource, String, int, int, int)
As of 7.0, use getPage().open instead

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

com.vaadin.ui.Root.LegacyWindow.removeListener(Page.BrowserWindowResizeListener)
As of 7.0, use the similarly named api in Page instead

com.vaadin.data.util.AbstractInMemoryContainer.setAllItemIds(List)

com.vaadin.ui.Root.setCaption(String)
as of 7.0.0, use Page.setTitle(String)

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

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

com.vaadin.terminal.gwt.client.ui.dd.VHtml5DragEvent.setDragEffect(String)
As of Vaadin 6.8, replaced by VHtml5DragEvent.setDropEffect(String).

com.vaadin.data.util.AbstractInMemoryContainer.setFilteredItemIds(List)

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

com.vaadin.ui.Select.setMultiSelect(boolean)
use ListSelect, OptionGroup or TwinColSelect instead

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

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.data.Buffered.setReadThrough(boolean)
Use Buffered.setBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.ui.AbstractField.setReadThrough(boolean)
Use AbstractField.setBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.ui.Table.setSortDisabled(boolean)
Use Table.setSortEnabled(boolean) 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.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.gwt.client.ui.AbstractComponentConnector.setWidgetStyleNameWithPrefix(String, String, boolean)
This will be removed once styles are no longer added with prefixes.

com.vaadin.data.Buffered.setWriteThrough(boolean)
Use Buffered.setBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.ui.AbstractField.setWriteThrough(boolean)
Use AbstractField.setBuffered(boolean) instead. Note that setReadThrough(true), setWriteThrough(true) equals setBuffered(false)

com.vaadin.terminal.Page.showNotification(Notification)
Use Notification.show(Page) instead.

com.vaadin.ui.Root.showNotification(Notification)
As of 7.0, use Notification.show instead

com.vaadin.ui.Root.showNotification(String)
As of 7.0, use Notification.show instead but be aware that Notification.show does not allow HTML.

com.vaadin.ui.Root.showNotification(String, int)
As of 7.0, use Notification.show instead but be aware that Notification.show does not allow HTML.

com.vaadin.ui.Root.showNotification(String, String)
As of 7.0, use new Notification(...).show(Page) instead but be aware that HTML by default not allowed.

com.vaadin.ui.Root.showNotification(String, String, int)
As of 7.0, use new Notification(...).show(Page) instead but be aware that HTML by default not allowed.

com.vaadin.ui.Root.showNotification(String, String, int, boolean)
As of 7.0, use new Notification(...).show(Page).

com.vaadin.data.util.AbstractProperty.toString()
use Property.getValue() instead and possibly toString on that

com.vaadin.data.util.sqlcontainer.ColumnProperty.toString()
get the string representation from the value

com.vaadin.ui.Label.toString()
Use Label.getValue() instead

com.vaadin.ui.AbstractField.toString()
Instead use AbstractField.getValue() to get the value of the field, AbstractField.getConvertedValue() to get the field value converted to the data model type or AbstractField.getPropertyDataSource() .getValue() to get the value of the data source.

com.vaadin.terminal.gwt.client.ApplicationConnection.unregisterPaintable(ServerConnector)

com.vaadin.terminal.gwt.client.VCaption.updateCaptionWithoutOwner(String, boolean, boolean, boolean, String)

com.vaadin.terminal.gwt.client.ApplicationConnection.updateComponent(Widget, UIDL, boolean)

com.vaadin.ui.DragAndDropWrapper.WrapperTargetDetails.verticalDropLocation()
use DragAndDropWrapper.WrapperTargetDetails.getVerticalDropLocation() instead

com.vaadin.terminal.gwt.client.ui.root.VRoot.windowSizeMaybeChanged(int, int)
use VRoot.performSizeCheck()

Deprecated Constructors

com.vaadin.data.util.BeanItemContainer(Collection)
use BeanItemContainer.BeanItemContainer(Class, Collection) instead

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

com.vaadin.data.validator.DoubleValidator(String)
in Vaadin 7.0. Use a Double converter on the field instead and/or use a DoubleRangeValidator for validating that the value is inside a given range.

com.vaadin.data.util.sqlcontainer.query.FreeformQuery(String, List, JDBCConnectionPool)
@see FreeformQuery.FreeformQuery(String, JDBCConnectionPool, String...)

com.vaadin.data.validator.IntegerValidator(String)
in Vaadin 7.0. Use an Integer converter on the field instead and/or use an IntegerRangeValidator for validating that the value is inside a given range.

com.vaadin.terminal.gwt.client.VCaption(ApplicationConnection)
all captions should be associated with a paintable widget and be updated from shared state, not UIDL

com.vaadin.terminal.gwt.client.ui.menubar.VMenuBar.CustomMenuItem(String, Command)
use the default constructor and VMenuBar.CustomMenuItem.setHTML(String) and VMenuBar.CustomMenuItem.setCommand(Command) instead

com.vaadin.terminal.gwt.client.ui.notification.VNotification(int)
Use static VNotification.createNotification(int) instead to enable GWT deferred binding.

com.vaadin.terminal.gwt.client.ui.notification.VNotification(int, int, int)
Use static #createNotification(int, int, int) instead to enable GWT deferred binding.

Deprecated Enum Constants

com.vaadin.terminal.gwt.client.ui.label.ContentMode.RAW
Use ContentMode.XHTML instead

com.vaadin.terminal.gwt.client.ui.label.ContentMode.XML
Use ContentMode.XHTML instead