diff options
134 files changed, 335 insertions, 101 deletions
diff --git a/client/src/main/java/com/vaadin/client/DependencyLoader.java b/client/src/main/java/com/vaadin/client/DependencyLoader.java index 4a8e054a54..b388bfc00b 100644 --- a/client/src/main/java/com/vaadin/client/DependencyLoader.java +++ b/client/src/main/java/com/vaadin/client/DependencyLoader.java @@ -30,7 +30,7 @@ import com.vaadin.client.ResourceLoader.ResourceLoadListener; * execute a command after all dependencies have finished loading. * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 */ public class DependencyLoader { diff --git a/client/src/main/java/com/vaadin/client/connectors/AbstractFocusableListingConnector.java b/client/src/main/java/com/vaadin/client/connectors/AbstractFocusableListingConnector.java index 67ff070eb0..fc431e3854 100644 --- a/client/src/main/java/com/vaadin/client/connectors/AbstractFocusableListingConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/AbstractFocusableListingConnector.java @@ -27,6 +27,7 @@ import com.vaadin.client.ui.ConnectorFocusAndBlurHandler; * * @param <WIDGET> * widget type which has to allow to register focus/blur handlers + * @since 8.0 */ public abstract class AbstractFocusableListingConnector<WIDGET extends Widget & HasAllFocusHandlers> extends AbstractListingConnector { diff --git a/client/src/main/java/com/vaadin/client/connectors/AbstractSingleSelectConnector.java b/client/src/main/java/com/vaadin/client/connectors/AbstractSingleSelectConnector.java index 96ccf2f7c2..9df4afa084 100644 --- a/client/src/main/java/com/vaadin/client/connectors/AbstractSingleSelectConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/AbstractSingleSelectConnector.java @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.AbstractSingleSelectState; * An abstract class for single selection connectors. * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 */ public abstract class AbstractSingleSelectConnector<WIDGET extends Widget & HasAllFocusHandlers> extends AbstractFocusableListingConnector<WIDGET> diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/AbstractGridRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/AbstractGridRendererConnector.java index 65300d1faf..ff2b9876dd 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/AbstractGridRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/AbstractGridRendererConnector.java @@ -35,7 +35,7 @@ import elemental.json.JsonObject; * @param <T> * the presentation type of the renderer * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ public abstract class AbstractGridRendererConnector<T> diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/DateRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/DateRendererConnector.java index ddda1a778a..386cbfdafd 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/DateRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/DateRendererConnector.java @@ -25,7 +25,7 @@ import com.vaadin.shared.ui.grid.renderers.DateRendererState; * string, and displayed as-is on the client side. This is to be able to support * the server's locale. * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ @Connect(com.vaadin.ui.renderers.DateRenderer.class) diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/NumberRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/NumberRendererConnector.java index 4dd089c555..d532cc570a 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/NumberRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/NumberRendererConnector.java @@ -26,7 +26,7 @@ import com.vaadin.shared.ui.grid.renderers.NumberRendererState; * string, and displayed as-is on the client side. This is to be able to support * the server's locale. * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ @Connect(com.vaadin.ui.renderers.NumberRenderer.class) diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/ProgressBarRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/ProgressBarRendererConnector.java index 5374a87436..ecc0a5d9a5 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/ProgressBarRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/ProgressBarRendererConnector.java @@ -22,7 +22,7 @@ import com.vaadin.shared.ui.grid.renderers.ProgressBarRendererState; /** * A connector for {@link ProgressBarRenderer}. * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ @Connect(com.vaadin.ui.renderers.ProgressBarRenderer.class) diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/TextRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/TextRendererConnector.java index 9d9fe75407..fe49e806a8 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/TextRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/TextRendererConnector.java @@ -22,7 +22,7 @@ import com.vaadin.shared.ui.grid.renderers.TextRendererState; /** * A connector for {@link TextRenderer}. * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ @Connect(com.vaadin.ui.renderers.TextRenderer.class) diff --git a/client/src/main/java/com/vaadin/client/connectors/grid/UnsafeHtmlRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/grid/UnsafeHtmlRendererConnector.java index f91497687a..1f8b9107f0 100644 --- a/client/src/main/java/com/vaadin/client/connectors/grid/UnsafeHtmlRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/grid/UnsafeHtmlRendererConnector.java @@ -23,7 +23,7 @@ import com.vaadin.shared.ui.grid.renderers.HtmlRendererState; /** * A connector for {@link UnsafeHtmlRenderer} * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ @Connect(com.vaadin.ui.renderers.HtmlRenderer.class) diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractTextFieldWidget.java b/client/src/main/java/com/vaadin/client/ui/AbstractTextFieldWidget.java index 256428c83a..49dbbdbd7e 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractTextFieldWidget.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractTextFieldWidget.java @@ -20,6 +20,8 @@ import com.vaadin.client.ui.textfield.AbstractTextFieldConnector; /** * Implemented by all widgets used by a connector extending * {@link AbstractTextFieldConnector}. + * + * @since 8.0 */ public interface AbstractTextFieldWidget { diff --git a/client/src/main/java/com/vaadin/client/ui/HasErrorIndicator.java b/client/src/main/java/com/vaadin/client/ui/HasErrorIndicator.java index 806617b8ee..146f621d48 100644 --- a/client/src/main/java/com/vaadin/client/ui/HasErrorIndicator.java +++ b/client/src/main/java/com/vaadin/client/ui/HasErrorIndicator.java @@ -19,6 +19,8 @@ import com.vaadin.client.ComponentConnector; /** * Implemented by connectors supporting an error indicator. + * + * @since 8.0 */ public interface HasErrorIndicator extends ComponentConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/HasRequiredIndicator.java b/client/src/main/java/com/vaadin/client/ui/HasRequiredIndicator.java index 5575c3a774..32b83ed28f 100644 --- a/client/src/main/java/com/vaadin/client/ui/HasRequiredIndicator.java +++ b/client/src/main/java/com/vaadin/client/ui/HasRequiredIndicator.java @@ -19,6 +19,8 @@ import com.vaadin.client.ComponentConnector; /** * Implemented by connectors supporting a required flag. + * + * @since 8.0 */ public interface HasRequiredIndicator extends ComponentConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java b/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java index e0ae7b9165..6d6f396147 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java @@ -60,11 +60,12 @@ import com.vaadin.shared.util.SharedUtil; /** * Abstract calendar panel to show and select a date using a resolution. The * class is parameterized by the date resolution enumeration type. - * + * * @author Vaadin Ltd * * @param <R> * the resolution type which this field is based on (day, month, ...) + * @since 8.0 */ @SuppressWarnings("deprecation") public abstract class VAbstractCalendarPanel<R extends Enum<R>> @@ -265,7 +266,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns {@code true} if current resolution assumes handling focus event * for day UI component. - * + * * @return {@code true} if day focus events should be handled, {@code false} * otherwise */ @@ -273,7 +274,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns {@code true} if the provided {@code resolution} represents a day. - * + * * @param resolution * the given resolution * @return {@code true} if the {@code resolution} represents a day @@ -283,7 +284,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns {@code true} if the provided {@code resolution} represents a * month. - * + * * @param resolution * the given resolution * @return {@code true} if the {@code resolution} represents a month @@ -293,7 +294,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns {@code true} if the provided {@code resolution} represents an * year. - * + * * @param resolution * the given resolution * @return {@code true} if the {@code resolution} represents a year @@ -305,7 +306,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns {@code true} if the {@code resolution} representation is strictly * below month (day, hour, etc..). - * + * * @param resolution * the given resolution * @return whether the {@code resolution} is below the month resolution @@ -314,7 +315,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns all available resolutions for the widget. - * + * * @return all available resolutions */ protected Stream<R> getResolutions() { @@ -323,7 +324,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Finds the resolution by the {@code filter}. - * + * * @param filter * predicate to filter resolutions * @return the resolution accepted by the {@code filter} @@ -423,7 +424,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Checks whether the widget is not editable (read-only). - * + * * @return {@code true} if the widget is read-only */ protected boolean isReadonly() { @@ -432,7 +433,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Checks whether the widget is enabled. - * + * * @return {@code true} is the widget is enabled */ protected boolean isEnabled() { @@ -595,9 +596,9 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns date time service for the widget. - * + * * @see #setDateTimeService(DateTimeService) - * + * * @return date time service */ protected DateTimeService getDateTimeService() { @@ -606,7 +607,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> /** * Returns the date field which this panel is attached to. - * + * * @return the "parent" date field */ protected VDateField<R> getDateField() { @@ -903,7 +904,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> * Subclasses may override this method to provide a custom implementation * avoiding {@link #renderCalendar(boolean)} override. The latter method * contains a common logic which should not be overriden. - * + * * @param updateDate * The value false prevents setting the selected date of the * calendar based on focusedDate. That can be used when only the @@ -1666,7 +1667,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> * The actual implementation of the logic which sets the data of the Panel. * The method {@link #setDate(Date)} just delegate a call to this method * providing additional config parameters. - * + * * @param currentDate * currentDate The date to set * @param needRerender diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java b/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java index 08feb101f2..a8c356a07c 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java @@ -61,6 +61,7 @@ import com.vaadin.shared.ui.datefield.TextualDateFieldState; * then pass set it by calling the * <code>setCalendarPanel(VAbstractCalendarPanel panel)</code> method. * + * @since 8.0 */ public abstract class VAbstractPopupCalendar<PANEL extends VAbstractCalendarPanel<R>, R extends Enum<R>> extends VAbstractTextualDate<R> diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java b/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java index d99e1c0a6c..2db5cb5bc5 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java @@ -41,11 +41,12 @@ import com.vaadin.shared.EventId; * Abstract textual date field base implementation. Provides a text box as an * editor for a date. The class is parameterized by the date resolution * enumeration type. - * + * * @author Vaadin Ltd * * @param <R> * the resolution type which this field is based on (day, month, ...) + * @since 8.0 */ public abstract class VAbstractTextualDate<R extends Enum<R>> extends VDateField<R> implements Field, ChangeHandler, Focusable, @@ -91,7 +92,7 @@ public abstract class VAbstractTextualDate<R extends Enum<R>> /** * Gets the date format string for the current locale. - * + * * @return the format string */ protected String getFormatString() { @@ -240,9 +241,9 @@ public abstract class VAbstractTextualDate<R extends Enum<R>> /** * Clean date format string to make it suitable for * {@link #getFormatString()}. - * + * * @see #getFormatString() - * + * * @param format * date format string * @return cleaned up string diff --git a/client/src/main/java/com/vaadin/client/ui/VComboBox.java b/client/src/main/java/com/vaadin/client/ui/VComboBox.java index 77e1108417..4cf7ab8856 100644 --- a/client/src/main/java/com/vaadin/client/ui/VComboBox.java +++ b/client/src/main/java/com/vaadin/client/ui/VComboBox.java @@ -87,6 +87,8 @@ import com.vaadin.shared.util.SharedUtil; * Client side implementation of the ComboBox component. * * TODO needs major refactoring (to be extensible etc) + * + * @since 8.0 */ @SuppressWarnings("deprecation") public class VComboBox extends Composite implements Field, KeyDownHandler, diff --git a/client/src/main/java/com/vaadin/client/ui/VDateCalendarPanel.java b/client/src/main/java/com/vaadin/client/ui/VDateCalendarPanel.java index 9685b05f10..21d81fcff0 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDateCalendarPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VDateCalendarPanel.java @@ -19,7 +19,7 @@ import com.vaadin.shared.ui.datefield.DateResolution; /** * @author Vaadin Ltd - * + * @since 8.0 */ public class VDateCalendarPanel extends VAbstractCalendarPanel<DateResolution> { diff --git a/client/src/main/java/com/vaadin/client/ui/VWindow.java b/client/src/main/java/com/vaadin/client/ui/VWindow.java index 9656378f58..98fdcc3707 100644 --- a/client/src/main/java/com/vaadin/client/ui/VWindow.java +++ b/client/src/main/java/com/vaadin/client/ui/VWindow.java @@ -356,7 +356,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Returns window position in list of opened and shown windows. * - * @since 8.0.0 + * @since 8.0 */ public final int getWindowOrder() { return windowOrder.indexOf(this); @@ -1510,7 +1510,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Adds a Handler for window order change event. * - * @since 8.0.0 + * @since 8.0 * * @return registration object to deregister the handler */ diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractInlineDateFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractInlineDateFieldConnector.java index e5bf3e34bb..3d12956247 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractInlineDateFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractInlineDateFieldConnector.java @@ -27,13 +27,14 @@ import com.vaadin.shared.ui.datefield.InlineDateFieldState; /** * Base class for inline data field connector. - * + * * @author Vaadin Ltd * * @param <R> * the resolution type which the field is based on (day, month, ...) * @param <PANEL> * Subclass of VAbstractCalendarPanel specific for the implementation + * @since 8.0 */ public abstract class AbstractInlineDateFieldConnector<PANEL extends VAbstractCalendarPanel<R>, R extends Enum<R>> extends AbstractDateFieldConnector<R> { @@ -122,7 +123,7 @@ public abstract class AbstractInlineDateFieldConnector<PANEL extends VAbstractCa /** * Returns {@code true} is the current resolution of the widget is month or * less specific (e.g. month, year, quarter, etc). - * + * * @return {@code true} if the current resolution is above month */ protected abstract boolean isResolutionMonthOrHigher(); diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractTextualDateConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractTextualDateConnector.java index b9448862e7..87b8d047f9 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractTextualDateConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractTextualDateConnector.java @@ -21,6 +21,15 @@ import com.vaadin.client.UIDL; import com.vaadin.client.ui.VAbstractTextualDate; import com.vaadin.shared.ui.datefield.AbstractTextualDateFieldState; +/** + * Abstract base class for date fields with textual date representation. + * + * @author Vaadin Ltd + * @since 8.0 + * + * @param <R> + * resolution type + */ public abstract class AbstractTextualDateConnector<R extends Enum<R>> extends AbstractDateFieldConnector<R> { diff --git a/client/src/main/java/com/vaadin/client/ui/optiongroup/CheckBoxGroupConnector.java b/client/src/main/java/com/vaadin/client/ui/optiongroup/CheckBoxGroupConnector.java index 4262666943..1936aac79d 100644 --- a/client/src/main/java/com/vaadin/client/ui/optiongroup/CheckBoxGroupConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/optiongroup/CheckBoxGroupConnector.java @@ -33,6 +33,12 @@ import com.vaadin.ui.CheckBoxGroup; import elemental.json.JsonObject; +/** + * CheckBoxGroup client side connector. + * + * @author Vaadin Ltd + * @since 8.0 + */ @Connect(CheckBoxGroup.class) // We don't care about the framework-provided selection model at this point // TODO refactor to extend AbstractMultiSelectConnector, maybe when diff --git a/client/src/main/java/com/vaadin/client/ui/optiongroup/RadioButtonGroupConnector.java b/client/src/main/java/com/vaadin/client/ui/optiongroup/RadioButtonGroupConnector.java index 4331273b1e..de92728712 100644 --- a/client/src/main/java/com/vaadin/client/ui/optiongroup/RadioButtonGroupConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/optiongroup/RadioButtonGroupConnector.java @@ -33,6 +33,12 @@ import com.vaadin.ui.RadioButtonGroup; import elemental.json.JsonObject; +/** + * CheckBoxGroup client side connector. + * + * @author Vaadin Ltd + * @since 8.0 + */ @Connect(RadioButtonGroup.class) public class RadioButtonGroupConnector extends AbstractSingleSelectConnector<VRadioButtonGroup> { diff --git a/client/src/main/java/com/vaadin/client/ui/progressbar/ProgressBarConnector.java b/client/src/main/java/com/vaadin/client/ui/progressbar/ProgressBarConnector.java index 88d01ce2e5..698af6432d 100644 --- a/client/src/main/java/com/vaadin/client/ui/progressbar/ProgressBarConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/progressbar/ProgressBarConnector.java @@ -25,7 +25,7 @@ import com.vaadin.ui.ProgressBar; /** * Connector for {@link VProgressBar}. * - * @since 7.1 + * @since 8.0 * @author Vaadin Ltd */ @Connect(ProgressBar.class) diff --git a/client/src/main/java/com/vaadin/client/ui/textfield/AbstractTextFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/textfield/AbstractTextFieldConnector.java index 11dde21478..23d76d0717 100644 --- a/client/src/main/java/com/vaadin/client/ui/textfield/AbstractTextFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/textfield/AbstractTextFieldConnector.java @@ -28,6 +28,8 @@ import com.vaadin.ui.AbstractTextField; /** * Connector class for AbstractTextField. + * + * @since 8.0 */ public abstract class AbstractTextFieldConnector extends AbstractFieldConnector implements ValueChangeHandler.Owner, DeferredWorker { @@ -137,8 +139,8 @@ public abstract class AbstractTextFieldConnector extends AbstractFieldConnector /** * {@inheritDoc} - * - * @since 8.0.0 + * + * @since 8.0 */ @Override public boolean isWorkPending() { diff --git a/client/src/main/java/com/vaadin/client/ui/textfield/ValueChangeHandler.java b/client/src/main/java/com/vaadin/client/ui/textfield/ValueChangeHandler.java index e8c1ea9c51..4c53551409 100644 --- a/client/src/main/java/com/vaadin/client/ui/textfield/ValueChangeHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/textfield/ValueChangeHandler.java @@ -23,6 +23,8 @@ import com.vaadin.shared.ui.ValueChangeMode; /** * Helper for dealing with scheduling value change events based on a given mode * and possibly timeout. + * + * @since 8.0 */ public class ValueChangeHandler { @@ -136,9 +138,9 @@ public class ValueChangeHandler { /** * Checks whether the value change is scheduled for sending. - * - * @since 8.0.0 - * + * + * @since 8.0 + * * @return {@code true} if value change is scheduled for sending, * {@code false} otherwise */ diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowOrderEvent.java b/client/src/main/java/com/vaadin/client/ui/window/WindowOrderEvent.java index d17e28dc39..921e7d315e 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowOrderEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowOrderEvent.java @@ -23,7 +23,7 @@ import com.vaadin.client.ui.VWindow; /** * Event for window order position updates. * - * @since 8.0.0 + * @since 8.0 * * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowOrderHandler.java b/client/src/main/java/com/vaadin/client/ui/window/WindowOrderHandler.java index f3cffce63c..f1fa1e5e1d 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowOrderHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowOrderHandler.java @@ -20,7 +20,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for {@link WindowOrderEvent}s. * - * @since 8.0.0 + * @since 8.0 * * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widgets/ChildFocusAwareFlowPanel.java b/client/src/main/java/com/vaadin/client/widgets/ChildFocusAwareFlowPanel.java index 56a6164901..19ee7b8a21 100644 --- a/client/src/main/java/com/vaadin/client/widgets/ChildFocusAwareFlowPanel.java +++ b/client/src/main/java/com/vaadin/client/widgets/ChildFocusAwareFlowPanel.java @@ -39,7 +39,7 @@ import com.vaadin.client.ui.FocusableFlowPanel; * (child) elements. * * @author Vaadin Ltd - * + * @since 8.0 */ public class ChildFocusAwareFlowPanel extends FocusableFlowPanel implements HasAllFocusHandlers { diff --git a/client/src/main/java/com/vaadin/client/widgets/FocusableFlowPanelComposite.java b/client/src/main/java/com/vaadin/client/widgets/FocusableFlowPanelComposite.java index eb7640de61..996166df1a 100644 --- a/client/src/main/java/com/vaadin/client/widgets/FocusableFlowPanelComposite.java +++ b/client/src/main/java/com/vaadin/client/widgets/FocusableFlowPanelComposite.java @@ -27,7 +27,7 @@ import com.vaadin.client.Focusable; * panel that tracks focus/blur events from its children). * * @author Vaadin Ltd - * + * @since 8.0 */ public abstract class FocusableFlowPanelComposite extends Composite implements HasAllFocusHandlers, Focusable { diff --git a/server/src/main/java/com/vaadin/annotations/HtmlImport.java b/server/src/main/java/com/vaadin/annotations/HtmlImport.java index f815134dbb..81b4db87ca 100644 --- a/server/src/main/java/com/vaadin/annotations/HtmlImport.java +++ b/server/src/main/java/com/vaadin/annotations/HtmlImport.java @@ -56,7 +56,7 @@ import com.vaadin.server.ClientConnector; * the {@code init()} method of the client side connector is invoked. * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) diff --git a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForHtml.java b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForHtml.java index be009bc4ce..42d71c59e5 100644 --- a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForHtml.java +++ b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForHtml.java @@ -29,6 +29,7 @@ import java.lang.annotation.Target; * {@link HtmlImport @HtmlImport} should be used instead. * * @author Vaadin Ltd + * @since 8.0 */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) diff --git a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForJS.java b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForJS.java index 6b4152dfa0..969362dd24 100644 --- a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForJS.java +++ b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForJS.java @@ -29,6 +29,7 @@ import java.lang.annotation.Target; * {@link JavaScript @JavaScript} should be used instead. * * @author Vaadin Ltd + * @since 8.0 */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) diff --git a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForSS.java b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForSS.java index 2c3d8b19c0..e7039f60b6 100644 --- a/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForSS.java +++ b/server/src/main/java/com/vaadin/annotations/InternalContainerAnnotationForSS.java @@ -29,6 +29,7 @@ import java.lang.annotation.Target; * {@link StyleSheet @StyleSheet} should be used instead. * * @author Vaadin Ltd + * @since 8.0 */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) diff --git a/server/src/main/java/com/vaadin/annotations/PropertyId.java b/server/src/main/java/com/vaadin/annotations/PropertyId.java index 62ac330c17..ecfceda706 100644 --- a/server/src/main/java/com/vaadin/annotations/PropertyId.java +++ b/server/src/main/java/com/vaadin/annotations/PropertyId.java @@ -53,7 +53,7 @@ import com.vaadin.data.HasValue; </pre> * </code> * - * @since 7.0 + * @since 8.0 * @author Vaadin Ltd */ @Target({ ElementType.FIELD }) diff --git a/server/src/main/java/com/vaadin/data/BeanPropertySet.java b/server/src/main/java/com/vaadin/data/BeanPropertySet.java index d6ab364aff..073e9ce62f 100644 --- a/server/src/main/java/com/vaadin/data/BeanPropertySet.java +++ b/server/src/main/java/com/vaadin/data/BeanPropertySet.java @@ -40,7 +40,7 @@ import com.vaadin.util.ReflectTools; * * @author Vaadin Ltd * - * @since + * @since 8.0 * * @param <T> * the type of the bean diff --git a/server/src/main/java/com/vaadin/data/HasItems.java b/server/src/main/java/com/vaadin/data/HasItems.java index 03e85be6fd..18dd9fc99d 100644 --- a/server/src/main/java/com/vaadin/data/HasItems.java +++ b/server/src/main/java/com/vaadin/data/HasItems.java @@ -31,6 +31,8 @@ import com.vaadin.ui.Component; * * @author Vaadin Ltd * + * @since 8.0 + * * @param <T> * the type of the displayed item */ @@ -51,13 +53,13 @@ public interface HasItems<T> extends Component, Serializable { * {@link #setDataProvider(DataProvider)} method. It means that the items * collection can be accessed later on via * {@link ListDataProvider#getItems()}: - * + * * <pre> * <code> * HasDataProvider<String> listing = new CheckBoxGroup<>(); * listing.setItems(Arrays.asList("a","b")); * ... - * + * * Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems(); * </code> * </pre> @@ -81,20 +83,20 @@ public interface HasItems<T> extends Component, Serializable { * {@link #setDataProvider(DataProvider)} method. It means that the items * collection can be accessed later on via * {@link ListDataProvider#getItems()}: - * + * * <pre> * <code> * HasDataProvider<String> listing = new CheckBoxGroup<>(); * listing.setItems(Arrays.asList("a","b")); * ... - * + * * Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems(); * </code> * </pre> * <p> - * + * * @see #setItems(Collection) - * + * * @param items * the data items to display */ @@ -116,13 +118,13 @@ public interface HasItems<T> extends Component, Serializable { * {@link #setDataProvider(DataProvider)} method. It means that the items * collection can be accessed later on via * {@link ListDataProvider#getItems()}: - * + * * <pre> * <code> * HasDataProvider<String> listing = new CheckBoxGroup<>(); * listing.setItems(Arrays.asList("a","b")); * ... - * + * * Collection<String> collection = ((ListDataProvider<String>)listing.getDataProvider()).getItems(); * </code> * </pre> diff --git a/server/src/main/java/com/vaadin/data/PropertyDefinition.java b/server/src/main/java/com/vaadin/data/PropertyDefinition.java index 79bb2159b4..4d11e678a5 100644 --- a/server/src/main/java/com/vaadin/data/PropertyDefinition.java +++ b/server/src/main/java/com/vaadin/data/PropertyDefinition.java @@ -24,7 +24,7 @@ import com.vaadin.server.Setter; * A property from a {@link PropertySet}. * * @author Vaadin Ltd - * @since + * @since 8.0 * * @param <T> * the type of the property set diff --git a/server/src/main/java/com/vaadin/data/PropertySet.java b/server/src/main/java/com/vaadin/data/PropertySet.java index 7b557dc293..5ffae4f384 100644 --- a/server/src/main/java/com/vaadin/data/PropertySet.java +++ b/server/src/main/java/com/vaadin/data/PropertySet.java @@ -25,7 +25,7 @@ import java.util.stream.Stream; * * @author Vaadin Ltd * - * @since + * @since 8.0 * * @param <T> * the type for which the properties are defined diff --git a/server/src/main/java/com/vaadin/data/Result.java b/server/src/main/java/com/vaadin/data/Result.java index cf4b88adf0..4d340a2e88 100644 --- a/server/src/main/java/com/vaadin/data/Result.java +++ b/server/src/main/java/com/vaadin/data/Result.java @@ -36,6 +36,8 @@ import com.vaadin.server.SerializableSupplier; * * @param <R> * the result value type + * + * @since 8.0 */ public interface Result<R> extends Serializable { diff --git a/server/src/main/java/com/vaadin/data/SimpleResult.java b/server/src/main/java/com/vaadin/data/SimpleResult.java index 85dee60c8f..85d8c8ed4e 100644 --- a/server/src/main/java/com/vaadin/data/SimpleResult.java +++ b/server/src/main/java/com/vaadin/data/SimpleResult.java @@ -26,6 +26,8 @@ import com.vaadin.server.SerializableFunction; * * @param <R> * the result value type + * + * @since 8.0 */ class SimpleResult<R> implements Result<R> { diff --git a/server/src/main/java/com/vaadin/data/StatusChangeEvent.java b/server/src/main/java/com/vaadin/data/StatusChangeEvent.java index acef1bac75..07b195330a 100644 --- a/server/src/main/java/com/vaadin/data/StatusChangeEvent.java +++ b/server/src/main/java/com/vaadin/data/StatusChangeEvent.java @@ -41,6 +41,7 @@ import com.vaadin.server.Setter; * * @author Vaadin Ltd * + * @since 8.0 */ public class StatusChangeEvent extends EventObject { diff --git a/server/src/main/java/com/vaadin/data/Validator.java b/server/src/main/java/com/vaadin/data/Validator.java index 8fc5b0785e..6dca15a8ed 100644 --- a/server/src/main/java/com/vaadin/data/Validator.java +++ b/server/src/main/java/com/vaadin/data/Validator.java @@ -41,6 +41,8 @@ import com.vaadin.server.SerializablePredicate; * * @author Vaadin Ltd. * + * @since 8.0 + * * @param <T> * the type of the value to validate * diff --git a/server/src/main/java/com/vaadin/data/converter/LocalDateTimeToDateConverter.java b/server/src/main/java/com/vaadin/data/converter/LocalDateTimeToDateConverter.java index e427d956e3..e5fa45a3fb 100644 --- a/server/src/main/java/com/vaadin/data/converter/LocalDateTimeToDateConverter.java +++ b/server/src/main/java/com/vaadin/data/converter/LocalDateTimeToDateConverter.java @@ -33,6 +33,7 @@ import com.vaadin.ui.InlineDateTimeField; * {@link InlineDateTimeField} is bound to a {@link Date} property. * * @author Vaadin Ltd + * @since 8.0 */ public class LocalDateTimeToDateConverter implements Converter<LocalDateTime, Date> { diff --git a/server/src/main/java/com/vaadin/data/converter/LocalDateToDateConverter.java b/server/src/main/java/com/vaadin/data/converter/LocalDateToDateConverter.java index f649091039..999295d6aa 100644 --- a/server/src/main/java/com/vaadin/data/converter/LocalDateToDateConverter.java +++ b/server/src/main/java/com/vaadin/data/converter/LocalDateToDateConverter.java @@ -33,6 +33,7 @@ import com.vaadin.ui.InlineDateField; * {@link InlineDateField} is bound to a {@link Date} property. * * @author Vaadin Ltd + * @since 8.0 */ public class LocalDateToDateConverter implements Converter<LocalDate, Date> { diff --git a/server/src/main/java/com/vaadin/data/provider/AbstractBackEndDataProvider.java b/server/src/main/java/com/vaadin/data/provider/AbstractBackEndDataProvider.java index 9b08bb8c1d..b829934340 100644 --- a/server/src/main/java/com/vaadin/data/provider/AbstractBackEndDataProvider.java +++ b/server/src/main/java/com/vaadin/data/provider/AbstractBackEndDataProvider.java @@ -29,6 +29,7 @@ import java.util.stream.Stream; * data provider data type * @param <F> * data provider filter type + * @since 8.0 */ public abstract class AbstractBackEndDataProvider<T, F> extends AbstractDataProvider<T, F> implements BackEndDataProvider<T, F> { diff --git a/server/src/main/java/com/vaadin/data/provider/BackEndDataProvider.java b/server/src/main/java/com/vaadin/data/provider/BackEndDataProvider.java index 13694010c7..d2cb5c8c44 100644 --- a/server/src/main/java/com/vaadin/data/provider/BackEndDataProvider.java +++ b/server/src/main/java/com/vaadin/data/provider/BackEndDataProvider.java @@ -26,6 +26,7 @@ import java.util.Objects; * data provider data type * @param <F> * data provider filter type + * @since 8.0 */ public interface BackEndDataProvider<T, F> extends DataProvider<T, F> { @@ -48,9 +49,9 @@ public interface BackEndDataProvider<T, F> extends DataProvider<T, F> { /** * Sets the sort order to use, given a {@link QuerySortOrderBuilder}. * Shorthand for {@code setSortOrders(builder.build())}. - * + * * @see QuerySortOrderBuilder - * + * * @param builder * the sort builder to retrieve the sort order from * @throws NullPointerException diff --git a/server/src/main/java/com/vaadin/data/provider/CallbackDataProvider.java b/server/src/main/java/com/vaadin/data/provider/CallbackDataProvider.java index bd34cc939f..c1705cfe30 100644 --- a/server/src/main/java/com/vaadin/data/provider/CallbackDataProvider.java +++ b/server/src/main/java/com/vaadin/data/provider/CallbackDataProvider.java @@ -26,6 +26,7 @@ import com.vaadin.data.ValueProvider; * another callback for counting the number of available items. * * @author Vaadin Ltd + * @since 8.0 * * @param <T> * data provider data type diff --git a/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProvider.java b/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProvider.java index 8521e5498a..bc9bf805f9 100644 --- a/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProvider.java +++ b/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProvider.java @@ -20,6 +20,7 @@ package com.vaadin.data.provider; * applied to all queries. * * @author Vaadin Ltd + * @since 8.0 * * @param <T> * the data provider item type diff --git a/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProviderWrapper.java b/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProviderWrapper.java index b83fc98013..a711f8e0d4 100644 --- a/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProviderWrapper.java +++ b/server/src/main/java/com/vaadin/data/provider/ConfigurableFilterDataProviderWrapper.java @@ -21,6 +21,7 @@ package com.vaadin.data.provider; * the wrapped provider through the query. * * @author Vaadin Ltd + * @since 8.0 * * @param <T> * the data provider item type @@ -63,7 +64,7 @@ public abstract class ConfigurableFilterDataProviderWrapper<T, Q, C, F> * filter instance that can be passed to the wrapped data provider. Will not * be called if the configured filter is <code>null</code> and the query has * no filter. - * + * * @param queryFilter * the filter received through the query, or <code>null</code> if * no filter was provided in the query diff --git a/server/src/main/java/com/vaadin/data/provider/GridSortOrder.java b/server/src/main/java/com/vaadin/data/provider/GridSortOrder.java index ffb17d301d..cf53718caf 100644 --- a/server/src/main/java/com/vaadin/data/provider/GridSortOrder.java +++ b/server/src/main/java/com/vaadin/data/provider/GridSortOrder.java @@ -23,12 +23,13 @@ import com.vaadin.ui.Grid.Column; * * @param <T> * the grid type + * @since 8.0 */ public class GridSortOrder<T> extends SortOrder<Column<T, ?>> { /** * Construct sorting information for usage in a {@link Grid}. - * + * * @param column * the column to be sorted * @param direction diff --git a/server/src/main/java/com/vaadin/data/provider/GridSortOrderBuilder.java b/server/src/main/java/com/vaadin/data/provider/GridSortOrderBuilder.java index 3aba2eba6b..43509dd318 100644 --- a/server/src/main/java/com/vaadin/data/provider/GridSortOrderBuilder.java +++ b/server/src/main/java/com/vaadin/data/provider/GridSortOrderBuilder.java @@ -22,14 +22,15 @@ import com.vaadin.ui.Grid.Column; * Helper classes with fluent API for constructing {@link GridSortOrder} lists. * When the sort order is ready to be passed on, calling {@link #build()} will * create the list of sort orders. - * + * * @see GridSortOrder * @see #thenAsc(Column) * @see #thenDesc(Column) * @see #build() - * + * * @param <T> * the type of the grid + * @since 8.0 */ public class GridSortOrderBuilder<T> extends SortOrderBuilder<GridSortOrder<T>, Column<T, ?>> { diff --git a/server/src/main/java/com/vaadin/data/provider/ListDataProvider.java b/server/src/main/java/com/vaadin/data/provider/ListDataProvider.java index 2f1e17d673..8fc6d4a364 100644 --- a/server/src/main/java/com/vaadin/data/provider/ListDataProvider.java +++ b/server/src/main/java/com/vaadin/data/provider/ListDataProvider.java @@ -36,6 +36,7 @@ import com.vaadin.ui.UI; * * @param <T> * data type + * @since 8.0 */ public class ListDataProvider<T> extends AbstractDataProvider<T, SerializablePredicate<T>> implements diff --git a/server/src/main/java/com/vaadin/data/provider/QuerySortOrder.java b/server/src/main/java/com/vaadin/data/provider/QuerySortOrder.java index 7f0a76bf91..8e93359432 100644 --- a/server/src/main/java/com/vaadin/data/provider/QuerySortOrder.java +++ b/server/src/main/java/com/vaadin/data/provider/QuerySortOrder.java @@ -21,6 +21,7 @@ import com.vaadin.shared.data.sort.SortDirection; * Sorting information for {@link Query}. * * @see Query + * @since 8.0 */ public class QuerySortOrder extends SortOrder<String> { diff --git a/server/src/main/java/com/vaadin/data/provider/QuerySortOrderBuilder.java b/server/src/main/java/com/vaadin/data/provider/QuerySortOrderBuilder.java index eebe257973..dacda0d669 100644 --- a/server/src/main/java/com/vaadin/data/provider/QuerySortOrderBuilder.java +++ b/server/src/main/java/com/vaadin/data/provider/QuerySortOrderBuilder.java @@ -26,6 +26,7 @@ import com.vaadin.shared.data.sort.SortDirection; * @see #thenDesc(String) * @see #thenDesc(String) * @see #build() + * @since 8.0 */ public class QuerySortOrderBuilder extends SortOrderBuilder<QuerySortOrder, String> { diff --git a/server/src/main/java/com/vaadin/data/provider/SortOrder.java b/server/src/main/java/com/vaadin/data/provider/SortOrder.java index cb6a62668a..f806def6d1 100644 --- a/server/src/main/java/com/vaadin/data/provider/SortOrder.java +++ b/server/src/main/java/com/vaadin/data/provider/SortOrder.java @@ -25,6 +25,7 @@ import com.vaadin.shared.data.sort.SortDirection; * @param <T> * the type of the sorting information, usually a String (field id) * or a {@link java.util.Comparator}. + * @since 8.0 */ public class SortOrder<T> implements Serializable { diff --git a/server/src/main/java/com/vaadin/data/provider/SortOrderBuilder.java b/server/src/main/java/com/vaadin/data/provider/SortOrderBuilder.java index 29488b4415..433fbfafd4 100644 --- a/server/src/main/java/com/vaadin/data/provider/SortOrderBuilder.java +++ b/server/src/main/java/com/vaadin/data/provider/SortOrderBuilder.java @@ -35,6 +35,7 @@ import com.vaadin.shared.data.sort.SortDirection; * @see SortOrderBuilder#thenAsc(Object) * @see SortOrderBuilder#thenDesc(Object) * @see #build() + * @since 8.0 */ public abstract class SortOrderBuilder<T extends SortOrder<V>, V> implements Serializable { diff --git a/server/src/main/java/com/vaadin/event/Action.java b/server/src/main/java/com/vaadin/event/Action.java index b26dac14c9..fceea66a5b 100644 --- a/server/src/main/java/com/vaadin/event/Action.java +++ b/server/src/main/java/com/vaadin/event/Action.java @@ -108,6 +108,15 @@ public class Action implements Serializable { } public interface ShortcutNotifier extends Serializable { + /** + * Add a shortcut listener and return a registration object for + * unregistering it. + * + * @param shortcut + * listener to add + * @return registration for unregistering the listener + * @since 8.0 + */ public Registration addShortcutListener(ShortcutListener shortcut); /** diff --git a/server/src/main/java/com/vaadin/event/ContextClickEvent.java b/server/src/main/java/com/vaadin/event/ContextClickEvent.java index ba62a2ec14..2d6ebfefe9 100644 --- a/server/src/main/java/com/vaadin/event/ContextClickEvent.java +++ b/server/src/main/java/com/vaadin/event/ContextClickEvent.java @@ -71,6 +71,7 @@ public class ContextClickEvent extends ClickEvent { * @param listener * the context click listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addContextClickListener( ContextClickListener listener); diff --git a/server/src/main/java/com/vaadin/event/FieldEvents.java b/server/src/main/java/com/vaadin/event/FieldEvents.java index 75f8b38ff9..2b0a0f6286 100644 --- a/server/src/main/java/com/vaadin/event/FieldEvents.java +++ b/server/src/main/java/com/vaadin/event/FieldEvents.java @@ -192,7 +192,7 @@ public interface FieldEvents { * using a provided event handler. * * @author Vaadin Ltd - * + * @since 8.0 */ public static class FocusAndBlurServerRpcDecorator extends FocusAndBlurServerRpcImpl { diff --git a/server/src/main/java/com/vaadin/event/LayoutEvents.java b/server/src/main/java/com/vaadin/event/LayoutEvents.java index bc30981e51..6e70687598 100644 --- a/server/src/main/java/com/vaadin/event/LayoutEvents.java +++ b/server/src/main/java/com/vaadin/event/LayoutEvents.java @@ -79,6 +79,7 @@ public interface LayoutEvents { * @param listener * The listener to add * @return a registration object for removing the listener + * @since 8.0 */ public Registration addLayoutClickListener( LayoutClickListener listener); diff --git a/server/src/main/java/com/vaadin/event/MethodEventSource.java b/server/src/main/java/com/vaadin/event/MethodEventSource.java index e59ccfd4d4..7e55a5acd1 100644 --- a/server/src/main/java/com/vaadin/event/MethodEventSource.java +++ b/server/src/main/java/com/vaadin/event/MethodEventSource.java @@ -62,6 +62,7 @@ public interface MethodEventSource extends Serializable { * <code>object</code> * @throws NullPointerException * if {@code object} is {@code null} + * @since 8.0 */ public Registration addListener(Class<?> eventType, Object object, Method method); @@ -99,6 +100,7 @@ public interface MethodEventSource extends Serializable { * <code>object</code> * @throws NullPointerException * if {@code object} is {@code null} + * @since 8.0 */ public Registration addListener(Class<?> eventType, Object object, String methodName); diff --git a/server/src/main/java/com/vaadin/event/UIEvents.java b/server/src/main/java/com/vaadin/event/UIEvents.java index 5c91fe78a9..90773b8938 100644 --- a/server/src/main/java/com/vaadin/event/UIEvents.java +++ b/server/src/main/java/com/vaadin/event/UIEvents.java @@ -104,6 +104,7 @@ public interface UIEvents { * @param listener * the {@link PollListener} to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addPollListener(PollListener listener); diff --git a/server/src/main/java/com/vaadin/navigator/Navigator.java b/server/src/main/java/com/vaadin/navigator/Navigator.java index 6a55b36ab8..f6029e7d07 100644 --- a/server/src/main/java/com/vaadin/navigator/Navigator.java +++ b/server/src/main/java/com/vaadin/navigator/Navigator.java @@ -969,6 +969,7 @@ public class Navigator implements Serializable { * * @param listener * Listener to invoke during a view change. + * @since 8.0 */ public Registration addViewChangeListener(ViewChangeListener listener) { listeners.add(listener); diff --git a/server/src/main/java/com/vaadin/server/AbstractClientConnector.java b/server/src/main/java/com/vaadin/server/AbstractClientConnector.java index baab7a04da..3bce462522 100644 --- a/server/src/main/java/com/vaadin/server/AbstractClientConnector.java +++ b/server/src/main/java/com/vaadin/server/AbstractClientConnector.java @@ -751,7 +751,7 @@ public abstract class AbstractClientConnector * @param method * the activation method. * @return a registration object for removing the listener - * @since 6.2 + * @since 8.0 */ protected Registration addListener(String eventIdentifier, Class<?> eventType, Object target, Method method) { @@ -891,6 +891,7 @@ public abstract class AbstractClientConnector * @deprecated As of 7.0. This method should be avoided. Use * {@link #addListener(Class, Object, Method)} or * {@link #addListener(String, Class, Object, Method)} instead. + * @since 8.0 */ @Override @Deprecated diff --git a/server/src/main/java/com/vaadin/server/ClientConnector.java b/server/src/main/java/com/vaadin/server/ClientConnector.java index 97a14bc5c8..9b2df069ba 100644 --- a/server/src/main/java/com/vaadin/server/ClientConnector.java +++ b/server/src/main/java/com/vaadin/server/ClientConnector.java @@ -98,11 +98,27 @@ public interface ClientConnector extends Connector { public void detach(DetachEvent event); } + /** + * Add a listener for connector attach events. + * + * @since 8.0 + * + * @param listener + * @return Registration for unregistering the listener + */ public Registration addAttachListener(AttachListener listener); @Deprecated public void removeAttachListener(AttachListener listener); + /** + * Add a listener for connector detach events. + * + * @since 8.0 + * + * @param listener + * @return Registration for unregistering the listener + */ public Registration addDetachListener(DetachListener listener); @Deprecated diff --git a/server/src/main/java/com/vaadin/server/ErrorMessageProducer.java b/server/src/main/java/com/vaadin/server/ErrorMessageProducer.java index 22cd4a87f4..b6a34ef8de 100644 --- a/server/src/main/java/com/vaadin/server/ErrorMessageProducer.java +++ b/server/src/main/java/com/vaadin/server/ErrorMessageProducer.java @@ -20,6 +20,8 @@ import java.io.Serializable; /** * Interface implemented by old Vaadin 7 exception types to produce the error * message to show in a component. + * + * @since 8.0 */ @Deprecated public interface ErrorMessageProducer extends Serializable { diff --git a/server/src/main/java/com/vaadin/server/Page.java b/server/src/main/java/com/vaadin/server/Page.java index bf55e7ce9f..1cebe42802 100644 --- a/server/src/main/java/com/vaadin/server/Page.java +++ b/server/src/main/java/com/vaadin/server/Page.java @@ -26,7 +26,6 @@ import java.util.LinkedList; import java.util.List; import com.vaadin.event.EventRouter; -import com.vaadin.event.FieldEvents.FocusListener; import com.vaadin.shared.Registration; import com.vaadin.shared.ui.BorderStyle; import com.vaadin.shared.ui.ui.PageClientRpc; @@ -596,6 +595,7 @@ public class Page implements Serializable { * @return a registration object for removing the listener * @deprecated Use {@link Page#addPopStateListener(PopStateListener)} * instead + * @since 8.0 */ @Deprecated public Registration addUriFragmentChangedListener( @@ -845,6 +845,7 @@ public class Page implements Serializable { * @see BrowserWindowResizeListener#browserWindowResized(BrowserWindowResizeEvent) * @see UI#setResizeLazy(boolean) * @see Registration + * @since 8.0 */ public Registration addBrowserWindowResizeListener( BrowserWindowResizeListener resizeListener) { @@ -1135,7 +1136,7 @@ public class Page implements Serializable { * For internal use only. Used to update the server-side location when the * client-side location changes. * - * @since 7.2 + * @since 8.0 * * @param location * the new location URI diff --git a/server/src/main/java/com/vaadin/server/VaadinPortletSession.java b/server/src/main/java/com/vaadin/server/VaadinPortletSession.java index 68a1470e05..18e3fee80e 100644 --- a/server/src/main/java/com/vaadin/server/VaadinPortletSession.java +++ b/server/src/main/java/com/vaadin/server/VaadinPortletSession.java @@ -123,6 +123,7 @@ public class VaadinPortletSession extends VaadinSession { * * @param listener * to add + * @since 8.0 */ public Registration addPortletListener(PortletListener listener) { portletListeners.add(listener); diff --git a/server/src/main/java/com/vaadin/server/VaadinService.java b/server/src/main/java/com/vaadin/server/VaadinService.java index 6d0c442785..80ae39cb35 100644 --- a/server/src/main/java/com/vaadin/server/VaadinService.java +++ b/server/src/main/java/com/vaadin/server/VaadinService.java @@ -442,6 +442,7 @@ public abstract class VaadinService implements Serializable { * @param listener * the Vaadin service session initialization listener * @return a registration object for removing the listener + * @since 8.0 */ public Registration addSessionInitListener(SessionInitListener listener) { sessionInitListeners.add(listener); @@ -477,6 +478,7 @@ public abstract class VaadinService implements Serializable { * @param listener * the vaadin service session destroy listener * @return a registration object for removing the listener + * @since 8.0 */ public Registration addSessionDestroyListener( SessionDestroyListener listener) { @@ -1905,7 +1907,7 @@ public abstract class VaadinService implements Serializable { * it is not guaranteed that listeners will be invoked in the order they * were added. * - * @since 7.2 + * @since 8.0 * @param listener * the service destroy listener to add * diff --git a/server/src/main/java/com/vaadin/server/VaadinServlet.java b/server/src/main/java/com/vaadin/server/VaadinServlet.java index a03979216b..e9c302f7a4 100644 --- a/server/src/main/java/com/vaadin/server/VaadinServlet.java +++ b/server/src/main/java/com/vaadin/server/VaadinServlet.java @@ -1268,6 +1268,16 @@ public class VaadinServlet extends HttpServlet implements Constants { return getStaticFilePath(request) != null; } + /** + * Returns the relative path at which static files are served for a request + * (if any). + * + * @param request + * HTTP request + * @return relative servlet path or null if the request path does not + * contain "/VAADIN/" or the request has no path info + * @since 8.0 + */ protected String getStaticFilePath(HttpServletRequest request) { String pathInfo = request.getPathInfo(); if (pathInfo == null) { diff --git a/server/src/main/java/com/vaadin/server/VaadinSession.java b/server/src/main/java/com/vaadin/server/VaadinSession.java index 5979933285..36692c00c2 100644 --- a/server/src/main/java/com/vaadin/server/VaadinSession.java +++ b/server/src/main/java/com/vaadin/server/VaadinSession.java @@ -615,6 +615,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { * * @param converterFactory * The converter factory used in the session + * @since 8.0 */ @Deprecated public void setConverterFactory(Object converterFactory) { @@ -811,6 +812,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { * @param listener * the bootstrap listener to add * @return a registration object for removing the listener + * @since 8.0 */ public Registration addBootstrapListener(BootstrapListener listener) { assert hasLock(); diff --git a/server/src/main/java/com/vaadin/ui/AbstractComponent.java b/server/src/main/java/com/vaadin/ui/AbstractComponent.java index e2e51a2eca..c95c6cef15 100644 --- a/server/src/main/java/com/vaadin/ui/AbstractComponent.java +++ b/server/src/main/java/com/vaadin/ui/AbstractComponent.java @@ -513,6 +513,7 @@ public abstract class AbstractComponent extends AbstractClientConnector * the new description string for the component. * @param mode * the content mode for the description + * @since 8.0 */ public void setDescription(String description, ContentMode mode) { getState().description = description; @@ -1420,6 +1421,7 @@ public abstract class AbstractComponent extends AbstractClientConnector * @param visible * <code>true</code> to make the required indicator visible, * <code>false</code> if not + * @since 8.0 */ protected void setRequiredIndicatorVisible(boolean visible) { if (getState(false) instanceof AbstractFieldState) { @@ -1443,6 +1445,7 @@ public abstract class AbstractComponent extends AbstractClientConnector * * @return <code>true</code> if visible, <code>false</code> if not * @see #setRequiredIndicatorVisible(boolean) + * @since 8.0 */ protected boolean isRequiredIndicatorVisible() { if (getState(false) instanceof AbstractFieldState) { diff --git a/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java b/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java index 593f350af5..f518b2ba5c 100644 --- a/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java +++ b/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java @@ -594,7 +594,7 @@ public abstract class AbstractSplitPanel extends AbstractComponentContainer { /** * Register a listener to handle {@link SplitPositionChangeEvent}s. * - * @since 7.5.0 + * @since 8.0 * @param listener * {@link SplitPositionChangeListener} to be registered. */ diff --git a/server/src/main/java/com/vaadin/ui/AbstractTextField.java b/server/src/main/java/com/vaadin/ui/AbstractTextField.java index c716c66978..9da5e9eedc 100644 --- a/server/src/main/java/com/vaadin/ui/AbstractTextField.java +++ b/server/src/main/java/com/vaadin/ui/AbstractTextField.java @@ -134,6 +134,7 @@ public abstract class AbstractTextField extends AbstractField<String> * * @param placeholder * the placeholder text to set + * @since 8.0 */ public void setPlaceholder(String placeholder) { getState().placeholder = placeholder; diff --git a/server/src/main/java/com/vaadin/ui/Button.java b/server/src/main/java/com/vaadin/ui/Button.java index e57f8244ed..d0194924c4 100644 --- a/server/src/main/java/com/vaadin/ui/Button.java +++ b/server/src/main/java/com/vaadin/ui/Button.java @@ -313,6 +313,7 @@ public class Button extends AbstractFocusable * @param listener * the Listener to be added. * @return a registration object for removing the listener + * @since 8.0 */ public Registration addClickListener(ClickListener listener) { return addListener(ClickEvent.class, listener, diff --git a/server/src/main/java/com/vaadin/ui/ComboBox.java b/server/src/main/java/com/vaadin/ui/ComboBox.java index ed1e9d8beb..54a3eea430 100644 --- a/server/src/main/java/com/vaadin/ui/ComboBox.java +++ b/server/src/main/java/com/vaadin/ui/ComboBox.java @@ -78,6 +78,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @param <T> * item (bean) type in ComboBox + * @since 8.0 */ @FunctionalInterface public interface FetchItemsCallback<T> extends Serializable { @@ -104,6 +105,8 @@ public class ComboBox<T> extends AbstractSingleSelect<T> /** * Handler that adds a new item based on user input when the new items * allowed mode is active. + * + * @since 8.0 */ @FunctionalInterface public interface NewItemHandler extends SerializableConsumer<String> { @@ -116,6 +119,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @param <T> * item type + * @since 8.0 */ protected static class DeclarativeStyleGenerator<T> implements StyleGenerator<T> { @@ -300,6 +304,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @param listDataProvider * the list data provider to use, not <code>null</code> + * @since 8.0 */ public void setDataProvider(ListDataProvider<T> listDataProvider) { // Cannot use the case insensitive contains shorthand from @@ -323,6 +328,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * into the ComboBox * @param items * the data items to display + * @since 8.0 */ public void setItems(CaptionFilter captionFilter, Collection<T> items) { ListDataProvider<T> listDataProvider = DataProvider.ofCollection(items); @@ -340,6 +346,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * into the ComboBox * @param listDataProvider * the list data provider to use, not <code>null</code> + * @since 8.0 */ public void setDataProvider(CaptionFilter captionFilter, ListDataProvider<T> listDataProvider) { @@ -364,6 +371,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * into the ComboBox * @param items * the data items to display + * @since 8.0 */ public void setItems(CaptionFilter captionFilter, @SuppressWarnings("unchecked") T... items) { @@ -376,6 +384,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @see #setPlaceholder(String) * @return the current placeholder string, or null if not enabled + * @since 8.0 */ public String getPlaceholder() { return getState(false).placeholder; @@ -387,6 +396,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @param placeholder * the desired placeholder, or null to disable + * @since 8.0 */ public void setPlaceholder(String placeholder) { getState().placeholder = placeholder; @@ -468,6 +478,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * Returns whether the user is allowed to select nothing in the combo box. * * @return true if empty selection is allowed, false otherwise + * @since 8.0 */ public boolean isEmptySelectionAllowed() { return getState(false).emptySelectionAllowed; @@ -480,6 +491,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * @param emptySelectionAllowed * true to allow not selecting anything, false to require * selection + * @since 8.0 */ public void setEmptySelectionAllowed(boolean emptySelectionAllowed) { getState().emptySelectionAllowed = emptySelectionAllowed; @@ -496,6 +508,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * @see #isSelected(Object) * * @return the empty selection caption, not {@code null} + * @since 8.0 */ public String getEmptySelectionCaption() { return getState(false).emptySelectionCaption; @@ -513,6 +526,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * @param caption * the caption to set, not {@code null} * @see #isSelected(Object) + * @since 8.0 */ public void setEmptySelectionCaption(String caption) { Objects.nonNull(caption); @@ -592,6 +606,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * the item style generator to set, not null * @throws NullPointerException * if {@code itemStyleGenerator} is {@code null} + * @since 8.0 */ public void setStyleGenerator(StyleGenerator<T> itemStyleGenerator) { Objects.requireNonNull(itemStyleGenerator, @@ -609,6 +624,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * @see #setStyleGenerator(StyleGenerator) * * @return the currently used item style generator, not null + * @since 8.0 */ public StyleGenerator<T> getStyleGenerator() { return itemStyleGenerator; @@ -635,6 +651,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * @param newItemHandler * handler called for new items, null to only permit the * selection of existing items + * @since 8.0 */ public void setNewItemHandler(NewItemHandler newItemHandler) { this.newItemHandler = newItemHandler; @@ -833,6 +850,7 @@ public class ComboBox<T> extends AbstractSingleSelect<T> * * @see #setItems(CaptionFilter, Collection) * @see #setItems(CaptionFilter, Object[]) + * @since 8.0 */ @FunctionalInterface public interface CaptionFilter diff --git a/server/src/main/java/com/vaadin/ui/Component.java b/server/src/main/java/com/vaadin/ui/Component.java index 1215d848aa..c690e945cb 100644 --- a/server/src/main/java/com/vaadin/ui/Component.java +++ b/server/src/main/java/com/vaadin/ui/Component.java @@ -47,8 +47,8 @@ import com.vaadin.ui.declarative.DesignContext; * * <p> * The {@link #getParent()} method allows retrieving the parent component of a - * component. While there is a {@link #setParent(HasComponents)}, you - * rarely need it as you normally add components with the + * component. While there is a {@link #setParent(HasComponents)}, you rarely + * need it as you normally add components with the * {@link ComponentContainer#addComponent(Component) addComponent()} method of * the layout or other {@code ComponentContainer}, which automatically sets the * parent. @@ -900,6 +900,7 @@ public interface Component extends ClientConnector, Sizeable, Serializable { * @return a registration object for removing this listener * @see Component.Event * @see Registration + * @since 8.0 */ public Registration addListener(Component.Listener listener); diff --git a/server/src/main/java/com/vaadin/ui/Dependency.java b/server/src/main/java/com/vaadin/ui/Dependency.java index 8c82dc0275..509b9d3039 100644 --- a/server/src/main/java/com/vaadin/ui/Dependency.java +++ b/server/src/main/java/com/vaadin/ui/Dependency.java @@ -30,6 +30,7 @@ import com.vaadin.server.LegacyCommunicationManager; * Represents a stylesheet or JavaScript to include on the page. * * @author Vaadin Ltd + * @since 8.0 */ public class Dependency implements Serializable { /** diff --git a/server/src/main/java/com/vaadin/ui/Embedded.java b/server/src/main/java/com/vaadin/ui/Embedded.java index 33f5459081..ef31790e8a 100644 --- a/server/src/main/java/com/vaadin/ui/Embedded.java +++ b/server/src/main/java/com/vaadin/ui/Embedded.java @@ -528,6 +528,7 @@ public class Embedded extends AbstractComponent implements LegacyComponent { * @param listener * The listener to add * @return a registration object for removing the listener + * @since 8.0 */ public Registration addClickListener(ClickListener listener) { return addListener(EventId.CLICK_EVENT_IDENTIFIER, ClickEvent.class, diff --git a/server/src/main/java/com/vaadin/ui/HasComponents.java b/server/src/main/java/com/vaadin/ui/HasComponents.java index bb10ca57f6..763f4b67cd 100644 --- a/server/src/main/java/com/vaadin/ui/HasComponents.java +++ b/server/src/main/java/com/vaadin/ui/HasComponents.java @@ -56,6 +56,7 @@ public interface HasComponents extends Component, Iterable<Component> { * @param listener * the listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addComponentAttachListener( ComponentAttachListener listener); @@ -70,6 +71,7 @@ public interface HasComponents extends Component, Iterable<Component> { * the registration object returned from * {@link #addComponentAttachListener(ComponentAttachListener)} * . + * @since 8.0 */ @Deprecated public void removeComponentAttachListener( diff --git a/server/src/main/java/com/vaadin/ui/HasValueChangeMode.java b/server/src/main/java/com/vaadin/ui/HasValueChangeMode.java index a59be6d058..2bed6bc2e9 100644 --- a/server/src/main/java/com/vaadin/ui/HasValueChangeMode.java +++ b/server/src/main/java/com/vaadin/ui/HasValueChangeMode.java @@ -20,6 +20,8 @@ import com.vaadin.shared.ui.ValueChangeMode; /** * Implemented by components which support value change modes. + * + * @since 8.0 */ public interface HasValueChangeMode extends Component { /** diff --git a/server/src/main/java/com/vaadin/ui/HorizontalLayout.java b/server/src/main/java/com/vaadin/ui/HorizontalLayout.java index 95edc69e61..a6187e623b 100644 --- a/server/src/main/java/com/vaadin/ui/HorizontalLayout.java +++ b/server/src/main/java/com/vaadin/ui/HorizontalLayout.java @@ -72,6 +72,7 @@ public class HorizontalLayout extends AbstractOrderedLayout { * * @param components * the components to set, not <code>null</code> + * @since 8.0 */ public void addComponentsAndExpand(Component... components) { addComponents(components); diff --git a/server/src/main/java/com/vaadin/ui/IconGenerator.java b/server/src/main/java/com/vaadin/ui/IconGenerator.java index 50da1c5303..7ea1a9b38c 100644 --- a/server/src/main/java/com/vaadin/ui/IconGenerator.java +++ b/server/src/main/java/com/vaadin/ui/IconGenerator.java @@ -23,6 +23,7 @@ import com.vaadin.server.SerializableFunction; * * @param <T> * item type for which the icon is generated + * @since 8.0 */ @FunctionalInterface public interface IconGenerator<T> extends SerializableFunction<T, Resource> { diff --git a/server/src/main/java/com/vaadin/ui/Image.java b/server/src/main/java/com/vaadin/ui/Image.java index ce19f5c410..ce839961b8 100644 --- a/server/src/main/java/com/vaadin/ui/Image.java +++ b/server/src/main/java/com/vaadin/ui/Image.java @@ -88,6 +88,7 @@ public class Image extends AbstractEmbedded { * @param listener * The listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addClickListener(ClickListener listener) { return addListener(EventId.CLICK_EVENT_IDENTIFIER, ClickEvent.class, diff --git a/server/src/main/java/com/vaadin/ui/Label.java b/server/src/main/java/com/vaadin/ui/Label.java index 22ed77703c..c2fd132060 100644 --- a/server/src/main/java/com/vaadin/ui/Label.java +++ b/server/src/main/java/com/vaadin/ui/Label.java @@ -61,6 +61,7 @@ public class Label extends AbstractComponent { * the text to set * @param contentMode * the content mode to use + * @since 8.0 */ public Label(String text, ContentMode contentMode) { setValue(text); @@ -83,6 +84,7 @@ public class Label extends AbstractComponent { * @return the content mode of the label * * @see ContentMode + * @since 8.0 */ public ContentMode getContentMode() { return getState(false).contentMode; @@ -95,6 +97,7 @@ public class Label extends AbstractComponent { * the content mode to set * * @see ContentMode + * @since 8.0 */ public void setContentMode(ContentMode contentMode) { if (contentMode == null) { diff --git a/server/src/main/java/com/vaadin/ui/ListSelect.java b/server/src/main/java/com/vaadin/ui/ListSelect.java index 515570cc38..60180d2971 100644 --- a/server/src/main/java/com/vaadin/ui/ListSelect.java +++ b/server/src/main/java/com/vaadin/ui/ListSelect.java @@ -62,6 +62,7 @@ public class ListSelect<T> extends AbstractMultiSelect<T> * the caption to set, can be {@code null} * @param dataProvider * the data provider, not {@code null} + * @since 8.0 */ public ListSelect(String caption, DataProvider<T, ?> dataProvider) { this(caption); diff --git a/server/src/main/java/com/vaadin/ui/LoginForm.java b/server/src/main/java/com/vaadin/ui/LoginForm.java index 2dfd1d0483..400a9826fa 100644 --- a/server/src/main/java/com/vaadin/ui/LoginForm.java +++ b/server/src/main/java/com/vaadin/ui/LoginForm.java @@ -271,9 +271,9 @@ public class LoginForm extends AbstractSingleComponentContainer { * implementations, override {@link #createUsernameField()}, * {@link #createPasswordField()} and {@link #createLoginButton()}. If you * only want to change the default captions, override - * {@link #getUsernameCaption()}, {@link #getPasswordCaption()} - * and {@link #getLoginButtonCaption()}. You do not have to use the login - * button in your layout. + * {@link #getUsernameCaption()}, {@link #getPasswordCaption()} and + * {@link #getLoginButtonCaption()}. You do not have to use the login button + * in your layout. * * @param userNameField * the user name text field @@ -359,6 +359,7 @@ public class LoginForm extends AbstractSingleComponentContainer { * @param listener * the listener to add * @return a registration object for removing the listener + * @since 8.0 */ public Registration addLoginListener(LoginListener listener) { return addListener(LoginEvent.class, listener, ON_LOGIN_METHOD); diff --git a/server/src/main/java/com/vaadin/ui/NativeSelect.java b/server/src/main/java/com/vaadin/ui/NativeSelect.java index f7427568ff..2c994b8384 100644 --- a/server/src/main/java/com/vaadin/ui/NativeSelect.java +++ b/server/src/main/java/com/vaadin/ui/NativeSelect.java @@ -145,6 +145,7 @@ public class NativeSelect<T> extends AbstractSingleSelect<T> * Returns whether the user is allowed to select nothing in the combo box. * * @return true if empty selection is allowed, false otherwise + * @since 8.0 */ public boolean isEmptySelectionAllowed() { return getState(false).emptySelectionAllowed; @@ -157,6 +158,7 @@ public class NativeSelect<T> extends AbstractSingleSelect<T> * @param emptySelectionAllowed * true to allow not selecting anything, false to require * selection + * @since 8.0 */ public void setEmptySelectionAllowed(boolean emptySelectionAllowed) { getState().emptySelectionAllowed = emptySelectionAllowed; @@ -173,6 +175,7 @@ public class NativeSelect<T> extends AbstractSingleSelect<T> * @see #isSelected(Object) * * @return the empty selection caption, not {@code null} + * @since 8.0 */ public String getEmptySelectionCaption() { return getState(false).emptySelectionCaption; @@ -190,6 +193,7 @@ public class NativeSelect<T> extends AbstractSingleSelect<T> * @param caption * the caption to set, not {@code null} * @see #isSelected(Object) + * @since 8.0 */ public void setEmptySelectionCaption(String caption) { Objects.nonNull(caption); diff --git a/server/src/main/java/com/vaadin/ui/Panel.java b/server/src/main/java/com/vaadin/ui/Panel.java index ceadf2567d..13d2b4027e 100644 --- a/server/src/main/java/com/vaadin/ui/Panel.java +++ b/server/src/main/java/com/vaadin/ui/Panel.java @@ -271,6 +271,7 @@ public class Panel extends AbstractSingleComponentContainer * @param listener * The listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addClickListener(ClickListener listener) { return addListener(EventId.CLICK_EVENT_IDENTIFIER, ClickEvent.class, diff --git a/server/src/main/java/com/vaadin/ui/PasswordField.java b/server/src/main/java/com/vaadin/ui/PasswordField.java index f0e443434a..41a66f462d 100644 --- a/server/src/main/java/com/vaadin/ui/PasswordField.java +++ b/server/src/main/java/com/vaadin/ui/PasswordField.java @@ -68,6 +68,7 @@ public class PasswordField extends TextField { * * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public PasswordField(ValueChangeListener<String> valueChangeListener) { super(valueChangeListener); @@ -84,6 +85,7 @@ public class PasswordField extends TextField { * the caption for the field * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public PasswordField(String caption, ValueChangeListener<String> valueChangeListener) { @@ -96,13 +98,14 @@ public class PasswordField extends TextField { * <p> * The listener is called when the value of this {@code PasswordField} is * changed either by the user or programmatically. - * + * * @param caption * the caption for the field * @param value * the value for the field, not {@code null} * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public PasswordField(String caption, String value, ValueChangeListener<String> valueChangeListener) { diff --git a/server/src/main/java/com/vaadin/ui/PopupView.java b/server/src/main/java/com/vaadin/ui/PopupView.java index 632f176906..d6671be191 100644 --- a/server/src/main/java/com/vaadin/ui/PopupView.java +++ b/server/src/main/java/com/vaadin/ui/PopupView.java @@ -334,6 +334,7 @@ public class PopupView extends AbstractComponent implements HasComponents { * @param listener * the listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addPopupVisibilityListener( PopupVisibilityListener listener) { diff --git a/server/src/main/java/com/vaadin/ui/ProgressBar.java b/server/src/main/java/com/vaadin/ui/ProgressBar.java index e5d82a62b0..ead781b141 100644 --- a/server/src/main/java/com/vaadin/ui/ProgressBar.java +++ b/server/src/main/java/com/vaadin/ui/ProgressBar.java @@ -71,6 +71,7 @@ public class ProgressBar extends AbstractComponent { * * @param newValue * the current progress value + * @since 8.0 */ public void setValue(float newValue) { getState().state = newValue; @@ -131,6 +132,8 @@ public class ProgressBar extends AbstractComponent { /** * Resets the value of this component, effectively displaying zero progress. + * + * @since 8.0 */ public void reset() { setValue(DEFAULT_VALUE); diff --git a/server/src/main/java/com/vaadin/ui/RichTextArea.java b/server/src/main/java/com/vaadin/ui/RichTextArea.java index b556a5281b..1497e78f77 100644 --- a/server/src/main/java/com/vaadin/ui/RichTextArea.java +++ b/server/src/main/java/com/vaadin/ui/RichTextArea.java @@ -18,7 +18,6 @@ package com.vaadin.ui; import java.util.Objects; -import elemental.json.Json; import org.jsoup.nodes.Element; import com.vaadin.shared.ui.ValueChangeMode; @@ -27,6 +26,8 @@ import com.vaadin.shared.ui.richtextarea.RichTextAreaServerRpc; import com.vaadin.shared.ui.richtextarea.RichTextAreaState; import com.vaadin.ui.declarative.DesignContext; +import elemental.json.Json; + /** * A simple RichTextArea to edit HTML format text. */ @@ -88,6 +89,7 @@ public class RichTextArea extends AbstractField<String> * * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public RichTextArea(ValueChangeListener<String> valueChangeListener) { addValueChangeListener(valueChangeListener); @@ -104,6 +106,7 @@ public class RichTextArea extends AbstractField<String> * the caption for the field * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public RichTextArea(String caption, ValueChangeListener<String> valueChangeListener) { @@ -124,6 +127,7 @@ public class RichTextArea extends AbstractField<String> * the value for the field, not {@code null} * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public RichTextArea(String caption, String value, ValueChangeListener<String> valueChangeListener) { diff --git a/server/src/main/java/com/vaadin/ui/SingleSelect.java b/server/src/main/java/com/vaadin/ui/SingleSelect.java index f2ae85e95e..1c0d5b53eb 100644 --- a/server/src/main/java/com/vaadin/ui/SingleSelect.java +++ b/server/src/main/java/com/vaadin/ui/SingleSelect.java @@ -21,6 +21,7 @@ import com.vaadin.data.HasValue; * Single selection component whose selection is treated as a value. * * @author Vaadin Ltd + * @since 8.0 * * @param <V> * the selection value type diff --git a/server/src/main/java/com/vaadin/ui/TabSheet.java b/server/src/main/java/com/vaadin/ui/TabSheet.java index a94925a263..b48d35592a 100644 --- a/server/src/main/java/com/vaadin/ui/TabSheet.java +++ b/server/src/main/java/com/vaadin/ui/TabSheet.java @@ -829,6 +829,7 @@ public class TabSheet extends AbstractComponentContainer * @param listener * the Listener to be added, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addSelectedTabChangeListener( SelectedTabChangeListener listener) { diff --git a/server/src/main/java/com/vaadin/ui/TextArea.java b/server/src/main/java/com/vaadin/ui/TextArea.java index 06a52e30c9..614343500f 100644 --- a/server/src/main/java/com/vaadin/ui/TextArea.java +++ b/server/src/main/java/com/vaadin/ui/TextArea.java @@ -78,6 +78,7 @@ public class TextArea extends AbstractTextField { * * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public TextArea(ValueChangeListener<String> valueChangeListener) { addValueChangeListener(valueChangeListener); @@ -94,6 +95,7 @@ public class TextArea extends AbstractTextField { * the caption for the field * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public TextArea(String caption, ValueChangeListener<String> valueChangeListener) { @@ -114,6 +116,7 @@ public class TextArea extends AbstractTextField { * the value for the field, not {@code null} * @param valueChangeListener * the value change listener, not {@code null} + * @since 8.0 */ public TextArea(String caption, String value, ValueChangeListener<String> valueChangeListener) { diff --git a/server/src/main/java/com/vaadin/ui/TwinColSelect.java b/server/src/main/java/com/vaadin/ui/TwinColSelect.java index 1b84e32fe0..d0c32f0a3b 100644 --- a/server/src/main/java/com/vaadin/ui/TwinColSelect.java +++ b/server/src/main/java/com/vaadin/ui/TwinColSelect.java @@ -59,6 +59,7 @@ public class TwinColSelect<T> extends AbstractMultiSelect<T> * the caption to set, can be {@code null} * @param dataProvider * the data provider, not {@code null} + * @since 8.0 */ public TwinColSelect(String caption, DataProvider<T, ?> dataProvider) { this(caption); diff --git a/server/src/main/java/com/vaadin/ui/UI.java b/server/src/main/java/com/vaadin/ui/UI.java index 00ccf2b0e2..82d3c82196 100644 --- a/server/src/main/java/com/vaadin/ui/UI.java +++ b/server/src/main/java/com/vaadin/ui/UI.java @@ -968,6 +968,7 @@ public abstract class UI extends AbstractSingleComponentContainer * @param listener * The listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addClickListener(ClickListener listener) { return addListener(EventId.CLICK_EVENT_IDENTIFIER, ClickEvent.class, @@ -1794,7 +1795,7 @@ public abstract class UI extends AbstractSingleComponentContainer * * @param listener * the WindowModeChangeListener to add. - * @since 8.0.0 + * @since 8.0 * * @return a registration object for removing the listener */ @@ -1815,7 +1816,7 @@ public abstract class UI extends AbstractSingleComponentContainer * @see Window.WindowOrderChangeEvent * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 * */ public static class WindowOrderUpdateEvent extends Component.Event { @@ -1842,7 +1843,7 @@ public abstract class UI extends AbstractSingleComponentContainer /** * An interface used for listening to Windows order update events. * - * @since 8.0.0 + * @since 8.0 * * @see Window.WindowOrderChangeEvent */ diff --git a/server/src/main/java/com/vaadin/ui/Upload.java b/server/src/main/java/com/vaadin/ui/Upload.java index d725d157a6..27029f20de 100644 --- a/server/src/main/java/com/vaadin/ui/Upload.java +++ b/server/src/main/java/com/vaadin/ui/Upload.java @@ -634,6 +634,7 @@ public class Upload extends AbstractComponent * * @param listener * the Listener to be added, not null + * @since 8.0 */ public Registration addStartedListener(StartedListener listener) { return addListener(StartedEvent.class, listener, UPLOAD_STARTED_METHOD); @@ -655,6 +656,7 @@ public class Upload extends AbstractComponent * * @param listener * the Listener to be added, not null + * @since 8.0 */ public Registration addFinishedListener(FinishedListener listener) { return addListener(FinishedEvent.class, listener, @@ -677,6 +679,7 @@ public class Upload extends AbstractComponent * * @param listener * the Listener to be added, not null + * @since 8.0 */ public Registration addFailedListener(FailedListener listener) { return addListener(FailedEvent.class, listener, UPLOAD_FAILED_METHOD); @@ -698,6 +701,7 @@ public class Upload extends AbstractComponent * * @param listener * the Listener to be added, not null + * @since 8.0 */ public Registration addSucceededListener(SucceededListener listener) { return addListener(SucceededEvent.class, listener, @@ -720,6 +724,7 @@ public class Upload extends AbstractComponent * * @param listener * the progress listener to be added + * @since 8.0 */ public Registration addProgressListener(ProgressListener listener) { Objects.requireNonNull(listener, "Listener must not be null."); @@ -752,6 +757,7 @@ public class Upload extends AbstractComponent * * @param listener * the Listener to add, not null + * @since 8.0 */ public Registration addChangeListener(ChangeListener listener) { return addListener(EventId.CHANGE, ChangeEvent.class, listener, @@ -1136,6 +1142,7 @@ public class Upload extends AbstractComponent * * @param immediateMode * {@code true} for immediate mode, {@code false} for not + * @since 8.0 */ public void setImmediateMode(boolean immediateMode) { getState().immediateMode = immediateMode; @@ -1149,6 +1156,7 @@ public class Upload extends AbstractComponent * @return {@code true} if the upload is in immediate mode, {@code false} if * the upload is not in immediate mode * @see #setImmediateMode(boolean) + * @since 8.0 */ public boolean isImmediateMode() { return getState(false).immediateMode; diff --git a/server/src/main/java/com/vaadin/ui/VerticalLayout.java b/server/src/main/java/com/vaadin/ui/VerticalLayout.java index b012d46aa8..bafbfe315a 100644 --- a/server/src/main/java/com/vaadin/ui/VerticalLayout.java +++ b/server/src/main/java/com/vaadin/ui/VerticalLayout.java @@ -75,6 +75,7 @@ public class VerticalLayout extends AbstractOrderedLayout { * * @param components * the components to set, not <code>null</code> + * @since 8.0 */ public void addComponentsAndExpand(Component... components) { addComponents(components); diff --git a/server/src/main/java/com/vaadin/ui/Window.java b/server/src/main/java/com/vaadin/ui/Window.java index 7b57927d94..211f4f4e20 100644 --- a/server/src/main/java/com/vaadin/ui/Window.java +++ b/server/src/main/java/com/vaadin/ui/Window.java @@ -338,7 +338,7 @@ public class Window extends Panel * * @see UI#addWindowOrderUpdateListener(com.vaadin.ui.UI.WindowOrderUpdateListener) * - * @since 8.0.0 + * @since 8.0 * * @return window order position. */ @@ -468,6 +468,7 @@ public class Window extends Panel * * @param listener * the WindowModeChangeListener to add. + * @since 8.0 */ public Registration addWindowOrderChangeListener( WindowOrderChangeListener listener) { @@ -528,6 +529,7 @@ public class Window extends Panel * * @param listener * the CloseListener to add, not null + * @since 8.0 */ public Registration addCloseListener(CloseListener listener) { return addListener(CloseEvent.class, listener, WINDOW_CLOSE_METHOD); @@ -627,6 +629,7 @@ public class Window extends Panel * * @param listener * the WindowModeChangeListener to add. + * @since 8.0 */ public Registration addWindowModeChangeListener( WindowModeChangeListener listener) { @@ -710,6 +713,7 @@ public class Window extends Panel * @param listener * the listener to add, not null * @return a registration object for removing the listener + * @since 8.0 */ public Registration addResizeListener(ResizeListener listener) { return addListener(ResizeEvent.class, listener, WINDOW_RESIZE_METHOD); diff --git a/server/src/main/java/com/vaadin/ui/components/grid/EditorImpl.java b/server/src/main/java/com/vaadin/ui/components/grid/EditorImpl.java index 51cf1433b2..b771696aa2 100644 --- a/server/src/main/java/com/vaadin/ui/components/grid/EditorImpl.java +++ b/server/src/main/java/com/vaadin/ui/components/grid/EditorImpl.java @@ -45,6 +45,7 @@ import elemental.json.JsonObject; * * @param <T> * the grid bean type + * @since 8.0 */ public class EditorImpl<T> extends AbstractGridExtension<T> implements Editor<T> { @@ -347,4 +348,4 @@ public class EditorImpl<T> extends AbstractGridExtension<T> public Grid<T> getGrid() { return getParent(); } -}
\ No newline at end of file +} diff --git a/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java b/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java index 8207ce7af6..57bfde47fb 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java +++ b/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java @@ -197,6 +197,7 @@ public class DesignAttributeHandler implements Serializable { * the attribute list where the attribute will be written * @param defaultInstance * the default instance for comparing default values + * @since 8.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public static void writeAttribute(Object component, String attribute, @@ -236,6 +237,7 @@ public class DesignAttributeHandler implements Serializable { * the default attribute value * @param inputType * the type of the input value + * @since 8.0 */ public static <T> void writeAttribute(String attribute, Attributes attributes, T value, T defaultValue, Class<T> inputType, diff --git a/server/src/main/java/com/vaadin/ui/declarative/DesignFormatter.java b/server/src/main/java/com/vaadin/ui/declarative/DesignFormatter.java index 0f40be795b..41efce25dd 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/DesignFormatter.java +++ b/server/src/main/java/com/vaadin/ui/declarative/DesignFormatter.java @@ -195,6 +195,7 @@ public class DesignFormatter implements Serializable { * Type to convert to/from. * @param converter * Converter. + * @since 8.0 */ protected <T> void addConverter(Class<?> type, Converter<String, ?> converter) { @@ -301,6 +302,7 @@ public class DesignFormatter implements Serializable { * be returned. * @return A valid converter for a given type or its supertype, <b>null</b> * if it was not found. + * @since 8.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) protected <T> Converter<String, T> findConverterFor( @@ -336,6 +338,7 @@ public class DesignFormatter implements Serializable { * Type to find a converter for. * @return A valid converter for a given type or its subtype, <b>null</b> if * it was not found. + * @since 8.0 */ protected <T> Converter<String, T> findConverterFor( Class<? extends T> sourceType) { diff --git a/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java b/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java index d34c6d6ba6..d8c112110d 100644 --- a/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java +++ b/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java @@ -40,6 +40,7 @@ import elemental.json.JsonValue; * the grid type this renderer can be attached to * @param <V> * the type this renderer knows how to present + * @since 8.0 */ public abstract class AbstractRenderer<T, V> extends AbstractExtension implements Renderer<V> { diff --git a/server/src/main/java/com/vaadin/ui/renderers/ClickableRenderer.java b/server/src/main/java/com/vaadin/ui/renderers/ClickableRenderer.java index 53d510497d..8af57542de 100644 --- a/server/src/main/java/com/vaadin/ui/renderers/ClickableRenderer.java +++ b/server/src/main/java/com/vaadin/ui/renderers/ClickableRenderer.java @@ -86,6 +86,7 @@ public abstract class ClickableRenderer<T, V> extends AbstractRenderer<T, V> { * Returns the item of the row where the click event originated. * * @return the item of the clicked row + * @since 8.0 */ public T getItem() { return item; @@ -145,6 +146,7 @@ public abstract class ClickableRenderer<T, V> extends AbstractRenderer<T, V> { * * @param listener * the click listener to be added, not null + * @since 8.0 */ public Registration addClickListener(RendererClickListener<T> listener) { return addListener(RendererClickEvent.class, listener, diff --git a/server/src/main/java/com/vaadin/util/CurrentInstance.java b/server/src/main/java/com/vaadin/util/CurrentInstance.java index df23f6c8bc..8c3d93993a 100644 --- a/server/src/main/java/com/vaadin/util/CurrentInstance.java +++ b/server/src/main/java/com/vaadin/util/CurrentInstance.java @@ -215,7 +215,7 @@ public class CurrentInstance implements Serializable { * Gets the currently set instances so that they can later be restored using * {@link #restoreInstances(Map)}. * - * @since 7.1 + * @since 8.0 * * @return a map containing the current instances */ diff --git a/server/src/main/java/com/vaadin/util/ReflectTools.java b/server/src/main/java/com/vaadin/util/ReflectTools.java index beda104230..8ff8ddcbb0 100644 --- a/server/src/main/java/com/vaadin/util/ReflectTools.java +++ b/server/src/main/java/com/vaadin/util/ReflectTools.java @@ -226,7 +226,7 @@ public class ReflectTools implements Serializable { * another class to get the base type for, not <code>null</code> * @return the most specific base class, not <code>null</code> * - * @since + * @since 8.0 */ public static Class<?> findCommonBaseType(Class<?> a, Class<?> b) { if (a.isInterface()) { diff --git a/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java b/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java index 4a94a82fec..ddf13b684c 100644 --- a/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java @@ -21,7 +21,7 @@ import com.vaadin.shared.ui.TabIndexState; * State for components that can show the required indicator. * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 * */ public class AbstractFieldState extends TabIndexState { diff --git a/shared/src/main/java/com/vaadin/shared/Range.java b/shared/src/main/java/com/vaadin/shared/Range.java index 98d9ba54e2..49458d848b 100644 --- a/shared/src/main/java/com/vaadin/shared/Range.java +++ b/shared/src/main/java/com/vaadin/shared/Range.java @@ -27,7 +27,7 @@ import java.io.Serializable; * The range is considered {@link #isEmpty() empty} if the start is the same as * the end. * - * @since 7.4 + * @since 8.0 * @author Vaadin Ltd */ public final class Range implements Serializable { diff --git a/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java b/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java index 1b79dbea29..19930c7e04 100644 --- a/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java @@ -19,6 +19,8 @@ import com.vaadin.shared.communication.ServerRpc; /** * Transmits SelectionModel selection events from the client to the server. + * + * @since 8.0 */ public interface SelectionServerRpc extends ServerRpc { diff --git a/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java b/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java index 081abfa8aa..883ade868e 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java @@ -82,6 +82,7 @@ public final class ComponentStateUtil implements Serializable { * @param eventListenerId * The event identifier to add * @return a registration object for removing the listener + * @since 8.0 */ public static final Registration addRegisteredEventListener( SharedState state, String eventListenerId) { diff --git a/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java b/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java index e283728425..4c604f4291 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java @@ -18,7 +18,7 @@ package com.vaadin.shared.ui; /** * Content modes defining how the client should interpret a Label's value. * - * @since 7.0 + * @since 8.0 */ public enum ContentMode { /** diff --git a/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java b/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java index 82431bf7f1..2ffd08ad7d 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java @@ -17,6 +17,13 @@ package com.vaadin.shared.ui; import java.io.Serializable; +/** + * JSON key constants for common listing item attributes in server-client + * communication. + * + * @author Vaadin Ltd + * @since 8.0 + */ public class ListingJsonConstants implements Serializable { public static final String JSONKEY_ITEM_DISABLED = "d"; diff --git a/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java b/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java index 9e958542d2..327e93bac2 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java +++ b/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java @@ -151,7 +151,7 @@ public class MarginInfo implements Serializable { /** * Checks if this MarginInfo object has no margins enabled. * - * @since 8.0.0 + * @since 8.0 * * @return true if all edges have margins disabled */ diff --git a/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java b/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java index 00c7f2c548..52f54aa27b 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java @@ -19,6 +19,8 @@ package com.vaadin.shared.ui; /** * Different modes for when and how often field value changes are transmitted * from the client to the server. + * + * @since 8.0 */ public enum ValueChangeMode { diff --git a/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java b/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java index 8af9eb12e0..18c735f014 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java @@ -26,7 +26,7 @@ import com.vaadin.shared.communication.ServerRpc; * Notifies server when windows order is changed. * * @author Vaadin Ltd - * @since 8.0.0 + * @since 8.0 * */ public interface WindowOrderRpc extends ServerRpc { diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java index 12a0ebd367..80cd6cbd53 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java @@ -22,8 +22,9 @@ import com.vaadin.shared.annotations.NoLayout; /** * Shared state for the AbstractDateField component. - * + * * @author Vaadin Ltd + * @since 8.0 * */ public class AbstractDateFieldState extends AbstractFieldState { diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java index 843c453f39..2684ab24e2 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java @@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield; /** * Shared state for the AbstractLocalDateField component. - * - * @author Vaadin Ltd * + * @author Vaadin Ltd + * @since 8.0 */ public class AbstractTextualDateFieldState extends AbstractDateFieldState { diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java index ce2871e0a7..70f552673f 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java @@ -22,7 +22,7 @@ import java.util.List; * Resolutions for DateFields * * @author Vaadin Ltd. - * @since 7.0 + * @since 8.0 */ public enum DateResolution { DAY, MONTH, YEAR; diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java index ed64569c7d..c18ab867b1 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java @@ -17,7 +17,7 @@ package com.vaadin.shared.ui.datefield; /** * @author Vaadin Ltd - * + * @since 8.0 */ public class InlineDateTimeFieldState extends AbstractTextualDateFieldState { { diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java index fdfea3eab6..9cb4fbcf56 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java @@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield; /** * Shared state for the DateField component. - * - * @author Vaadin Ltd * + * @author Vaadin Ltd + * @since 8.0 */ public class LocalDateFieldState extends TextualDateFieldState { diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java index 82cfe8ee6f..eb1c9e8e57 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java @@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield; /** * Shared state for the DateTimeField component. - * - * @author Vaadin Ltd * + * @author Vaadin Ltd + * @since 8.0 */ public class LocalDateTimeFieldState extends TextualDateFieldState { diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java b/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java index 05fbb68721..40167ea061 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java @@ -17,6 +17,12 @@ package com.vaadin.shared.ui.grid; import com.vaadin.shared.Connector; +/** + * Shared state for a Grid column. + * + * @author Vaadin Ltd + * @since 8.0 + */ public class ColumnState extends AbstractGridExtensionState { public String caption; diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java index e1be703b41..644ae9b40f 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java @@ -79,7 +79,7 @@ public interface GridServerRpc extends ServerRpc { /** * Informs the server that a column's visibility has been changed. * - * @since 7.5.0 + * @since 8.0 * @param columnInternalId * the internal id of the column * @param hidden diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java b/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java index 7b3e23959f..74eb7bee04 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java @@ -28,7 +28,7 @@ import com.vaadin.shared.Connector; * Shared state for Grid headers and footers. * * @author Vaadin Ltd - * @since 7.4 + * @since 8.0 */ public class SectionState implements Serializable { diff --git a/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java b/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java index add408b868..a749786ae3 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java @@ -22,7 +22,7 @@ import com.vaadin.shared.ui.abstractmultiselect.AbstractMultiSelectState; * Shared state for ListSelect component. * * @author Vaadin Ltd - * + * @since 8.0 */ public class ListSelectState extends AbstractMultiSelectState { { diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java index 34c7e750db..8a21fee9c9 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java @@ -19,6 +19,8 @@ import com.vaadin.shared.communication.ClientRpc; /** * Server to client RPC interface for RichTextArea. + * + * @since 8.0 */ public interface RichTextAreaClientRpc extends ClientRpc { diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java index f8d6d9121d..1e3a3f0a2d 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java @@ -19,7 +19,8 @@ import com.vaadin.shared.communication.ServerRpc; /** * Client to server RPC interface for RichTextArea. - * + * + * @since 8.0 */ public interface RichTextAreaServerRpc extends ServerRpc { diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java index 75ce561ec3..d1459d42ce 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java @@ -22,7 +22,8 @@ import com.vaadin.shared.ui.ValueChangeMode; /** * State for RichTextArea. - * + * + * @since 8.0 */ public class RichTextAreaState extends AbstractFieldState { { diff --git a/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java index d7a1388ef8..bfcd483e5d 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java @@ -17,6 +17,12 @@ package com.vaadin.shared.ui.textarea; import com.vaadin.shared.communication.ServerRpc; +/** + * Client to server RPC interface for TextArea. + * + * @author Vaadin Ltd + * @since 8.0 + */ public interface TextAreaServerRpc extends ServerRpc { public void setHeight(String height); diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java index 171707d848..09d19831aa 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java @@ -19,7 +19,8 @@ import com.vaadin.shared.communication.ClientRpc; /** * Server to client RPC interface for AbstractTextField. - * + * + * @since 8.0 */ public interface AbstractTextFieldClientRpc extends ClientRpc { /** diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java index e11d4cedec..13279fca32 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java @@ -17,6 +17,11 @@ package com.vaadin.shared.ui.textfield; import com.vaadin.shared.communication.ServerRpc; +/** + * Client to server RPC interface for AbstractTextField. + * + * @since 8.0 + */ public interface AbstractTextFieldServerRpc extends ServerRpc { void setText(String text, int cursorPosition); diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java index 02fe1c7f30..8e8b05edce 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java @@ -17,6 +17,8 @@ package com.vaadin.shared.ui.textfield; /** * State class for TextField. + * + * @since 8.0 */ public class TextFieldState extends AbstractTextFieldState { { |