diff options
| author | Ahmed Ashour <asashour@yahoo.com> | 2017-10-02 09:09:37 +0200 |
|---|---|---|
| committer | Henri Sara <henri.sara@gmail.com> | 2017-10-02 10:09:37 +0300 |
| commit | 763a5cbe8c13ff4a169aae9062c643ad1588cea0 (patch) | |
| tree | cf41f4ac4c31925f5ca69d66a3fa6a47fbecfd4f | |
| parent | adcf2e2e80c6a05ea5e43be15dc7a2576fd2bbb4 (diff) | |
| download | vaadin-framework-763a5cbe8c13ff4a169aae9062c643ad1588cea0.tar.gz vaadin-framework-763a5cbe8c13ff4a169aae9062c643ad1588cea0.zip | |
First sentence of javadoc should end with a period (#10114)
Also includes minor other javadoc and formatting fixes.
337 files changed, 1347 insertions, 1303 deletions
diff --git a/client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java b/client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java index 96d68914d0..6ed6959592 100644 --- a/client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java +++ b/client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java @@ -249,7 +249,8 @@ public final class CvalChecker { msg = info.getMessage().replace("\\n", "\n"); } else if (info != null && info.isLicenseExpired()) { String type = "evaluation".equals(info.getType()) - ? "Evaluation license" : "License"; + ? "Evaluation license" + : "License"; msg = getErrorMessage("expired", title, majorVers, type); } else if (key == null) { msg = getErrorMessage("none", title, majorVers); @@ -261,7 +262,7 @@ public final class CvalChecker { } /** - * Exception thrown when the license server is unreachable + * Exception thrown when the license server is unreachable. */ public static class UnreachableCvalServerException extends Exception { private static final long serialVersionUID = 1L; diff --git a/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java b/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java index 2f53c24f0d..262f23f0fd 100644 --- a/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java +++ b/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java @@ -204,7 +204,7 @@ public class ApplicationConfiguration implements EntryPoint { } /** - * Wraps a native javascript object containing fields for an error message + * Wraps a native javascript object containing fields for an error message. * * @since 7.0 */ @@ -311,7 +311,7 @@ public class ApplicationConfiguration implements EntryPoint { } /** - * Gets the URL to the context root of the web application + * Gets the URL to the context root of the web application. * * @return the URL to the server-side context root as a string * @@ -833,7 +833,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Registers that callback that the bootstrap javascript uses to start * applications once the widgetset is loaded and all required information is - * available + * available. * * @param widgetsetName * the name of this widgetset @@ -882,7 +882,7 @@ public class ApplicationConfiguration implements EntryPoint { }-*/; /** - * Checks whether debug logging should be quiet + * Checks whether debug logging should be quiet. * * @return <code>true</code> if debug logging should be quiet */ diff --git a/client/src/main/java/com/vaadin/client/ApplicationConnection.java b/client/src/main/java/com/vaadin/client/ApplicationConnection.java index d6a18f485b..15a36315b0 100644 --- a/client/src/main/java/com/vaadin/client/ApplicationConnection.java +++ b/client/src/main/java/com/vaadin/client/ApplicationConnection.java @@ -288,7 +288,7 @@ public class ApplicationConnection implements HasHandlers { /** * Triggered when the {@link ApplicationConnection} marks a previously * running application as stopped by invoking - * {@link ApplicationConnection#setApplicationRunning(false)} + * {@link ApplicationConnection#setApplicationRunning(false)}. * * @param event * the event triggered by the {@link ApplicationConnection} @@ -756,7 +756,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Returns the loading indicator used by this ApplicationConnection + * Returns the loading indicator used by this ApplicationConnection. * * @return The loading indicator for this ApplicationConnection */ @@ -1058,7 +1058,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Returns false + * Returns false. * * @param paintable * @return false, always @@ -1235,7 +1235,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the main view + * Gets the main view. * * @return the main view */ @@ -1306,7 +1306,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Get VTooltip instance related to application connection + * Get VTooltip instance related to application connection. * * @return VTooltip instance */ @@ -1517,7 +1517,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the server RPC queue for this application + * Gets the server RPC queue for this application. * * @since 7.6 * @return the server RPC queue @@ -1527,7 +1527,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the communication error handler for this application + * Gets the communication error handler for this application. * * @since 7.6 * @return the server RPC queue @@ -1537,7 +1537,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the (server to client) message handler for this application + * Gets the (server to client) message handler for this application. * * @since 7.6 * @return the message handler @@ -1547,7 +1547,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the server rpc manager for this application + * Gets the server rpc manager for this application. * * @since 7.6 * @return the server rpc manager @@ -1557,7 +1557,7 @@ public class ApplicationConnection implements HasHandlers { } /** - * Gets the (client to server) message sender for this application + * Gets the (client to server) message sender for this application. * * @since 7.6 * @return the message sender diff --git a/client/src/main/java/com/vaadin/client/BrowserInfo.java b/client/src/main/java/com/vaadin/client/BrowserInfo.java index cf54a045f8..e16b0b4ba0 100644 --- a/client/src/main/java/com/vaadin/client/BrowserInfo.java +++ b/client/src/main/java/com/vaadin/client/BrowserInfo.java @@ -404,7 +404,7 @@ public class BrowserInfo { } /** - * Checks if the browser is run on iOS + * Checks if the browser is run on iOS. * * @return true if the browser is run on iOS, false otherwise */ @@ -423,7 +423,7 @@ public class BrowserInfo { } /** - * Checks if the browser is run on Android + * Checks if the browser is run on Android. * * @return true if the browser is run on Android, false otherwise */ @@ -461,7 +461,7 @@ public class BrowserInfo { /** * Tests if this is an Android devices with a broken scrollTop - * implementation + * implementation. * * @return true if scrollTop cannot be trusted on this device, false * otherwise diff --git a/client/src/main/java/com/vaadin/client/ComponentConnector.java b/client/src/main/java/com/vaadin/client/ComponentConnector.java index e7f29b3b5b..30c48b953b 100644 --- a/client/src/main/java/com/vaadin/client/ComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ComponentConnector.java @@ -39,7 +39,7 @@ public interface ComponentConnector extends ServerConnector { public AbstractComponentState getState(); /** - * Returns the widget for this {@link ComponentConnector} + * Returns the widget for this {@link ComponentConnector}. */ public Widget getWidget(); diff --git a/client/src/main/java/com/vaadin/client/ConnectorMap.java b/client/src/main/java/com/vaadin/client/ConnectorMap.java index 1ccfb74434..f06c3fe779 100644 --- a/client/src/main/java/com/vaadin/client/ConnectorMap.java +++ b/client/src/main/java/com/vaadin/client/ConnectorMap.java @@ -37,7 +37,7 @@ public class ConnectorMap { .create(); /** - * Returns a {@link ServerConnector} by its id + * Returns a {@link ServerConnector} by its id. * * @param connectorId * The connector id @@ -104,7 +104,7 @@ public class ConnectorMap { } /** - * Removes all registered connectors + * Removes all registered connectors. */ public void clear() { idToComponentDetail.clear(); @@ -197,7 +197,7 @@ public class ConnectorMap { } /** - * Gets all registered {@link ComponentConnector} instances + * Gets all registered {@link ComponentConnector} instances. * * @return An array of all registered {@link ComponentConnector} instances * diff --git a/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java b/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java index 3e7b8dbb44..062d8fcf99 100644 --- a/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java +++ b/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java @@ -32,7 +32,7 @@ import com.vaadin.shared.MouseEventDetails.MouseButton; public class MouseEventDetailsBuilder { /** - * Construct a {@link MouseEventDetails} object from the given event + * Construct a {@link MouseEventDetails} object from the given event. * * @param evt * The event to use as a source for the details @@ -43,7 +43,7 @@ public class MouseEventDetailsBuilder { } /** - * Construct a {@link MouseEventDetails} object from the given event + * Construct a {@link MouseEventDetails} object from the given event. * * @param evt * The event to use as a source for the details diff --git a/client/src/main/java/com/vaadin/client/Profiler.java b/client/src/main/java/com/vaadin/client/Profiler.java index caab0bccdc..1b445ff2e4 100644 --- a/client/src/main/java/com/vaadin/client/Profiler.java +++ b/client/src/main/java/com/vaadin/client/Profiler.java @@ -106,7 +106,7 @@ public class Profiler { } /** - * Gets the name of the node + * Gets the name of the node. * * @return the name of the node */ @@ -137,7 +137,7 @@ public class Profiler { /** * Gets the total time spent in this node, including time spent in sub - * nodes + * nodes. * * @return the total time spent, in milliseconds */ @@ -147,7 +147,7 @@ public class Profiler { /** * Gets the minimum time spent for one invocation of this node, - * including time spent in sub nodes + * including time spent in sub nodes. * * @return the time spent for the fastest invocation, in milliseconds */ @@ -157,7 +157,7 @@ public class Profiler { /** * Gets the maximum time spent for one invocation of this node, - * including time spent in sub nodes + * including time spent in sub nodes. * * @return the time spent for the slowest invocation, in milliseconds */ @@ -166,7 +166,7 @@ public class Profiler { } /** - * Gets the number of times this node has been entered + * Gets the number of times this node has been entered. * * @return the number of times the node has been entered */ @@ -176,7 +176,7 @@ public class Profiler { /** * Gets the total time spent in this node, excluding time spent in sub - * nodes + * nodes. * * @return the total time spent, in milliseconds */ @@ -189,7 +189,7 @@ public class Profiler { } /** - * Gets the child nodes of this node + * Gets the child nodes of this node. * * @return a collection of child nodes */ diff --git a/client/src/main/java/com/vaadin/client/ResourceLoader.java b/client/src/main/java/com/vaadin/client/ResourceLoader.java index 12922dca00..ebd0ecbb17 100644 --- a/client/src/main/java/com/vaadin/client/ResourceLoader.java +++ b/client/src/main/java/com/vaadin/client/ResourceLoader.java @@ -163,7 +163,7 @@ public class ResourceLoader { } /** - * Returns the default ResourceLoader + * Returns the default ResourceLoader. * * @return the default ResourceLoader */ @@ -405,12 +405,12 @@ public class ResourceLoader { if (rules === undefined) { rules = sheet.rules; } - + if (rules === null) { // Style sheet loaded, but can't access length because of XSS -> assume there's something there return 1; } - + // Return length so we can distinguish 0 (probably 404 error) from normal case. return rules.length; } catch (err) { diff --git a/client/src/main/java/com/vaadin/client/StyleConstants.java b/client/src/main/java/com/vaadin/client/StyleConstants.java index 8da9ebb06d..96ed58a70e 100644 --- a/client/src/main/java/com/vaadin/client/StyleConstants.java +++ b/client/src/main/java/com/vaadin/client/StyleConstants.java @@ -27,12 +27,12 @@ public class StyleConstants { public static final String HORIZONTAL_SPACING = "hspacing"; /** - * Added to all UI components + * Added to all UI components. */ public static final String UI_WIDGET = "v-widget"; /** - * Added to all layouts to denote they are layouts + * Added to all layouts to denote they are layouts. */ public static final String UI_LAYOUT = "v-layout"; diff --git a/client/src/main/java/com/vaadin/client/Util.java b/client/src/main/java/com/vaadin/client/Util.java index bad1ac1ce2..a27e92bd82 100644 --- a/client/src/main/java/com/vaadin/client/Util.java +++ b/client/src/main/java/com/vaadin/client/Util.java @@ -340,7 +340,7 @@ public class Util { } /** - * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)} + * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)}. * * @deprecated As of 7.4.0, use * {@link WidgetUtil#runWebkitOverflowAutoFixDeferred(Element)} @@ -656,7 +656,7 @@ public class Util { } /** - * Force webkit to redraw an element + * Force webkit to redraw an element. * * @deprecated As of 7.4.0, use * {@link WidgetUtil#forceWebkitRedraw(Element)} instead. @@ -954,7 +954,7 @@ public class Util { } /** - * Gets currently focused element and checks if it's editable + * Gets currently focused element and checks if it's editable. * * @deprecated As of 7.4.0, use * {@link WidgetUtil#isFocusedElementEditable()} instead. @@ -1002,7 +1002,7 @@ public class Util { /** * Checks if the given event is either a touch event or caused by the left - * mouse button + * mouse button. * * @deprecated As of 7.4.0, use * {@link WidgetUtil#isTouchEventOrLeftMouseButton(Event)} diff --git a/client/src/main/java/com/vaadin/client/VCaption.java b/client/src/main/java/com/vaadin/client/VCaption.java index f7d7d55ffe..a1ad2ea8dd 100644 --- a/client/src/main/java/com/vaadin/client/VCaption.java +++ b/client/src/main/java/com/vaadin/client/VCaption.java @@ -265,8 +265,8 @@ public class VCaption extends HTML implements HasErrorIndicatorElement { setErrorIndicatorElementVisible(true); // Hide error indicator from assistive devices - Roles.getTextboxRole() - .setAriaHiddenState(errorIndicatorElement, true); + Roles.getTextboxRole().setAriaHiddenState(errorIndicatorElement, + true); ErrorUtil.setErrorLevelStyle(errorIndicatorElement, StyleConstants.STYLE_NAME_ERROR_INDICATOR, @@ -662,7 +662,7 @@ public class VCaption extends HTML implements HasErrorIndicatorElement { } /** - * Sets the tooltip that should be shown for the caption + * Sets the tooltip that should be shown for the caption. * * @param tooltipInfo * The tooltip that should be shown or null if no tooltip should @@ -673,7 +673,7 @@ public class VCaption extends HTML implements HasErrorIndicatorElement { } /** - * Returns the tooltip that should be shown for the caption + * Returns the tooltip that should be shown for the caption. * * @return The tooltip to show or null if no tooltip should be shown */ diff --git a/client/src/main/java/com/vaadin/client/VLoadingIndicator.java b/client/src/main/java/com/vaadin/client/VLoadingIndicator.java index 8df457b4e8..40bcda9b59 100644 --- a/client/src/main/java/com/vaadin/client/VLoadingIndicator.java +++ b/client/src/main/java/com/vaadin/client/VLoadingIndicator.java @@ -71,7 +71,7 @@ public class VLoadingIndicator { /** * Returns the delay (in ms) which must pass before the loading indicator - * moves into the "first" state and is shown to the user + * moves into the "first" state and is shown to the user. * * @return The delay (in ms) until moving into the "first" state. Counted * from when {@link #trigger()} is called. @@ -82,7 +82,7 @@ public class VLoadingIndicator { /** * Sets the delay (in ms) which must pass before the loading indicator moves - * into the "first" state and is shown to the user + * into the "first" state and is shown to the user. * * @param firstDelay * The delay (in ms) until moving into the "first" state. Counted @@ -190,7 +190,7 @@ public class VLoadingIndicator { /** * Returns the {@link ApplicationConnection} which uses this loading - * indicator + * indicator. * * @return The ApplicationConnection for this loading indicator */ @@ -236,7 +236,7 @@ public class VLoadingIndicator { } /** - * Returns the root element of the loading indicator + * Returns the root element of the loading indicator. * * @return The loading indicator DOM element */ diff --git a/client/src/main/java/com/vaadin/client/VTooltip.java b/client/src/main/java/com/vaadin/client/VTooltip.java index 84647abf9a..b0108dff64 100644 --- a/client/src/main/java/com/vaadin/client/VTooltip.java +++ b/client/src/main/java/com/vaadin/client/VTooltip.java @@ -47,6 +47,8 @@ import com.google.gwt.user.client.ui.Widget; import com.vaadin.client.ui.VOverlay; /** + * A tooltip used by components. + * * TODO open for extension */ public class VTooltip extends VOverlay { @@ -366,8 +368,10 @@ public class VTooltip extends VOverlay { if (roomBelow > heightNeeded) { y = roomAbove; } else { - y = roomAbove - offsetHeight - (currentElement != null - ? currentElement.getOffsetHeight() : 0); + y = roomAbove - offsetHeight + - (currentElement != null + ? currentElement.getOffsetHeight() + : 0); } if (y + offsetHeight - Window.getScrollTop() > Window @@ -503,7 +507,7 @@ public class VTooltip extends VOverlay { } /** - * Replace current open tooltip with new content + * Replace current open tooltip with new content. */ public void replaceCurrentTooltip() { if (closing) { diff --git a/client/src/main/java/com/vaadin/client/WidgetUtil.java b/client/src/main/java/com/vaadin/client/WidgetUtil.java index fed9320edc..7f552950f2 100644 --- a/client/src/main/java/com/vaadin/client/WidgetUtil.java +++ b/client/src/main/java/com/vaadin/client/WidgetUtil.java @@ -48,7 +48,7 @@ import com.vaadin.shared.ui.ErrorLevel; import com.vaadin.shared.util.SharedUtil; /** - * Utility methods which are related to client side code only + * Utility methods which are related to client side code only. */ public class WidgetUtil { @@ -66,7 +66,7 @@ public class WidgetUtil { /** * Redirects the browser to the given url or refreshes the page if url is - * null + * null. * * @since 7.6 * @param url @@ -418,7 +418,7 @@ public class WidgetUtil { } /** - * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)} + * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)}. * * @since 7.2.6 * @param elem @@ -791,7 +791,7 @@ public class WidgetUtil { com.google.gwt.dom.client.Element el, String p) /*-{ try { - + if (el.currentStyle) { // IE return el.currentStyle[p]; @@ -806,7 +806,7 @@ public class WidgetUtil { } catch (e) { return ""; } - + }-*/; /** @@ -820,7 +820,7 @@ public class WidgetUtil { try { el.focus(); } catch (e) { - + } }-*/; @@ -829,10 +829,11 @@ public class WidgetUtil { * DOM upwards from given element. * <p> * <strong>Note:</strong> If {@code element} is inside some widget {@code W} - * , <em>and</em> {@code W} in turn is wrapped in a {@link com.google.gwt.user.client.ui.Composite Composite} - * {@code C}, this method will not find {@code W} but returns {@code C}. - * This may also be the case with other Composite-like classes that hijack - * the event handling of their child widget(s). + * , <em>and</em> {@code W} in turn is wrapped in a + * {@link com.google.gwt.user.client.ui.Composite Composite} {@code C}, this + * method will not find {@code W} but returns {@code C}. This may also be + * the case with other Composite-like classes that hijack the event handling + * of their child widget(s). * * @param element * the element where to start seeking of Widget @@ -848,11 +849,12 @@ public class WidgetUtil { * traversing DOM upwards from given element. * <p> * <strong>Note:</strong> If {@code element} is inside some widget {@code W} - * , <em>and</em> {@code W} in turn is wrapped in a {@link com.google.gwt.user.client.ui.Composite Composite} - * {@code C}, this method will not find {@code W}. It returns either - * {@code C} or null, depending on whether the class parameter matches. This - * may also be the case with other Composite-like classes that hijack the - * event handling of their child widget(s). + * , <em>and</em> {@code W} in turn is wrapped in a + * {@link com.google.gwt.user.client.ui.Composite Composite} {@code C}, this + * method will not find {@code W}. It returns either {@code C} or null, + * depending on whether the class parameter matches. This may also be the + * case with other Composite-like classes that hijack the event handling of + * their child widget(s). * <p> * Only accepts the exact class {@code class1} if not null. * @@ -872,11 +874,12 @@ public class WidgetUtil { * traversing DOM upwards from given element. * <p> * <strong>Note:</strong> If {@code element} is inside some widget {@code W} - * , <em>and</em> {@code W} in turn is wrapped in a {@link com.google.gwt.user.client.ui.Composite Composite} - * {@code C}, this method will not find {@code W}. It returns either - * {@code C} or null, depending on whether the class parameter matches. This - * may also be the case with other Composite-like classes that hijack the - * event handling of their child widget(s). + * , <em>and</em> {@code W} in turn is wrapped in a + * {@link com.google.gwt.user.client.ui.Composite Composite} {@code C}, this + * method will not find {@code W}. It returns either {@code C} or null, + * depending on whether the class parameter matches. This may also be the + * case with other Composite-like classes that hijack the event handling of + * their child widget(s). * * @param element * the element where to start seeking of Widget @@ -927,7 +930,7 @@ public class WidgetUtil { } /** - * Force webkit to redraw an element + * Force webkit to redraw an element. * * @param element * The element that should be redrawn @@ -1173,12 +1176,12 @@ public class WidgetUtil { if ($wnd.document.activeElement) { return $wnd.document.activeElement; } - + return null; }-*/; /** - * Gets currently focused element and checks if it's editable + * Gets currently focused element and checks if it's editable. * * @since 7.4 * @@ -1244,11 +1247,11 @@ public class WidgetUtil { /*-{ var top = elem.offsetTop; var height = elem.offsetHeight; - + if (elem.parentNode != elem.offsetParent) { top -= elem.parentNode.offsetTop; } - + var cur = elem.parentNode; while (cur && (cur.nodeType == 1)) { if (top < cur.scrollTop) { @@ -1257,12 +1260,12 @@ public class WidgetUtil { if (top + height > cur.scrollTop + cur.clientHeight) { cur.scrollTop = (top + height) - cur.clientHeight; } - + var offsetTop = cur.offsetTop; if (cur.parentNode != cur.offsetParent) { offsetTop -= cur.parentNode.offsetTop; } - + top += offsetTop - cur.scrollTop; cur = cur.parentNode; } @@ -1270,7 +1273,7 @@ public class WidgetUtil { /** * Checks if the given event is either a touch event or caused by the left - * mouse button + * mouse button. * * @param event * @return true if the event is a touch event or caused by the left mouse @@ -1711,7 +1714,7 @@ public class WidgetUtil { } var heightWithoutBorder = cloneElement.offsetHeight; parentElement.removeChild(cloneElement); - + return heightWithBorder - heightWithoutBorder; } }-*/; @@ -1881,17 +1884,17 @@ public class WidgetUtil { * {@code prefix-errorLevel} format. * * @param element - * element to apply the style name to + * element to apply the style name to * @param prefix - * part of the style name before the error level string + * part of the style name before the error level string * @param errorLevel - * error level for which the style will be applied + * error level for which the style will be applied */ public static void setErrorLevelStyle(Element element, String prefix, ErrorLevel errorLevel) { for (ErrorLevel errorLevelValue : ErrorLevel.values()) { - String className = - prefix + "-" + errorLevelValue.toString().toLowerCase(); + String className = prefix + "-" + + errorLevelValue.toString().toLowerCase(); if (errorLevel == errorLevelValue) { element.addClassName(className); } else { diff --git a/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java b/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java index ee0aab7b2e..b46245ddaf 100644 --- a/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java +++ b/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java @@ -50,7 +50,7 @@ public class AtmospherePushConnection implements PushConnection { protected enum State { /** - * Opening request has been sent, but still waiting for confirmation + * Opening request has been sent, but still waiting for confirmation. */ CONNECT_PENDING, @@ -381,7 +381,7 @@ public class AtmospherePushConnection implements PushConnection { /** * Called if the transport mechanism cannot be used and the fallback will be - * tried + * tried. */ protected void onTransportFailure() { getLogger().warning("Push connection using primary method (" @@ -525,7 +525,7 @@ public class AtmospherePushConnection implements PushConnection { JavaScriptObject config) /*-{ var self = this; - + config.url = uri; config.onOpen = $entry(function(response) { self.@com.vaadin.client.communication.AtmospherePushConnection::onOpen(*)(response); @@ -551,7 +551,7 @@ public class AtmospherePushConnection implements PushConnection { config.onClientTimeout = $entry(function(request) { self.@com.vaadin.client.communication.AtmospherePushConnection::onClientTimeout(*)(request); }); - + return $wnd.vaadinPush.atmosphere.subscribe(config); }-*/; diff --git a/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java b/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java index 03ab23d43e..61a85661a8 100644 --- a/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java @@ -45,7 +45,7 @@ public interface ConnectionStateHandler { void setConnection(ApplicationConnection connection); /** - * Called when an exception occurs during a {@link Heartbeat} request + * Called when an exception occurs during a {@link Heartbeat} request. * * @param request * The heartbeat request @@ -55,7 +55,8 @@ public interface ConnectionStateHandler { void heartbeatException(Request request, Throwable exception); /** - * Called when a heartbeat request returns a status code other than OK (200) + * Called when a heartbeat request returns a status code other than OK + * (200). * * @param request * The heartbeat request @@ -65,7 +66,7 @@ public interface ConnectionStateHandler { void heartbeatInvalidStatusCode(Request request, Response response); /** - * Called when a {@link Heartbeat} request succeeds + * Called when a {@link Heartbeat} request succeeds. */ void heartbeatOk(); @@ -116,7 +117,7 @@ public interface ConnectionStateHandler { /** * Called when the push connection has lost the connection to the server and - * will proceed to try to re-establish the connection + * will proceed to try to re-establish the connection. * * @param pushConnection * The push connection which will be reconnected @@ -132,7 +133,7 @@ public interface ConnectionStateHandler { void pushOk(PushConnection pushConnection); /** - * Called when the required push script could not be loaded + * Called when the required push script could not be loaded. * * @param resourceUrl * The URL which was used for loading the script @@ -151,11 +152,11 @@ public interface ConnectionStateHandler { /** * Called when invalid content (not JSON) was returned from the server as - * the result of an XmlHttpRequest request + * the result of an XmlHttpRequest request. * * @param xhrConnectionError - * The error containing what was being sent to the server and what - * was returned + * The error containing what was being sent to the server and + * what was returned */ void xhrInvalidContent(XhrConnectionError xhrConnectionError); @@ -164,19 +165,19 @@ public interface ConnectionStateHandler { * the result of an XmlHttpRequest. * * @param xhrConnectionError - * The error containing what was being sent to the server and what - * was returned + * The error containing what was being sent to the server and + * what was returned */ void xhrInvalidStatusCode(XhrConnectionError xhrConnectionError); /** - * Called whenever a XmlHttpRequest to the server completes successfully + * Called whenever a XmlHttpRequest to the server completes successfully. */ void xhrOk(); /** * Called when a message is to be sent to the server through the push - * channel but the push channel is not connected + * channel but the push channel is not connected. * * @param payload * The payload to send to the server @@ -185,7 +186,7 @@ public interface ConnectionStateHandler { /** * Called when invalid content (not JSON) was pushed from the server through - * the push connection + * the push connection. * * @param pushConnection * The push connection used diff --git a/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java b/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java index bb4edcda4c..c228aaf007 100644 --- a/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java +++ b/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java @@ -24,7 +24,7 @@ import elemental.json.Json; import elemental.json.JsonValue; /** - * Client side serializer/deserializer for java.util.Date + * Client side serializer/deserializer for java.util.Date. * * @since 7.2 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java b/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java index f98165b105..2b815a419e 100644 --- a/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java @@ -77,7 +77,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { } /** - * Checks if this type is of higher priority than the given type + * Checks if this type is of higher priority than the given type. * * @param type * the type to compare to @@ -129,7 +129,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { } /** - * Returns the connection this handler is connected to + * Returns the connection this handler is connected to. * * @return the connection for this handler */ @@ -184,7 +184,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Called whenever an error occurs in communication which should be handled * by showing the reconnect dialog and retrying communication until - * successful again + * successful again. * * @param type * The type of failure detected @@ -273,7 +273,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Re-sends the payload to the server (if not null) or re-sends a heartbeat - * request immediately + * request immediately. * * @param payload * the payload that did not reach the server, null if the problem @@ -299,7 +299,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Called whenever a reconnect attempt fails to allow updating of dialog - * contents + * contents. */ protected void updateDialog() { reconnectDialog.setText(getDialogText(reconnectAttempt)); @@ -307,7 +307,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Called when we should give up trying to reconnect and let the user decide - * how to continue + * how to continue. * */ protected void giveUp() { @@ -338,7 +338,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { } /** - * Checks if the reconnect dialog is visible to the user + * Checks if the reconnect dialog is visible to the user. * * @return true if the user can see the dialog, false otherwise */ @@ -370,7 +370,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Gets the text to show in the reconnect dialog after giving up (reconnect - * limit reached) + * limit reached). * * @param reconnectAttempt * The number of the current reconnection attempt @@ -382,7 +382,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { } /** - * Gets the text to show in the reconnect dialog + * Gets the text to show in the reconnect dialog. * * @param reconnectAttempt * The number of the current reconnection attempt diff --git a/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java b/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java index f390a13418..0f8c1a1dc1 100644 --- a/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java +++ b/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java @@ -32,7 +32,7 @@ import com.vaadin.client.WidgetUtil; import com.vaadin.client.ui.VOverlay; /** - * The default implementation of the reconnect dialog + * The default implementation of the reconnect dialog. * * @since 7.6 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/communication/Heartbeat.java b/client/src/main/java/com/vaadin/client/communication/Heartbeat.java index 7690209157..57b5f3d689 100644 --- a/client/src/main/java/com/vaadin/client/communication/Heartbeat.java +++ b/client/src/main/java/com/vaadin/client/communication/Heartbeat.java @@ -30,7 +30,7 @@ import com.vaadin.shared.ui.ui.UIConstants; import com.vaadin.shared.util.SharedUtil; /** - * Handles sending of heartbeats to the server and reacting to the response + * Handles sending of heartbeats to the server and reacting to the response. * * @since 7.2 * @author Vaadin Ltd @@ -53,7 +53,7 @@ public class Heartbeat { } /** - * Initializes the heartbeat for the given application connection + * Initializes the heartbeat for the given application connection. * * @param applicationConnection * the connection @@ -83,7 +83,7 @@ public class Heartbeat { } /** - * Sends a heartbeat to the server + * Sends a heartbeat to the server. */ public void send() { timer.cancel(); diff --git a/client/src/main/java/com/vaadin/client/communication/MessageHandler.java b/client/src/main/java/com/vaadin/client/communication/MessageHandler.java index 6840d92063..f1354f4a92 100644 --- a/client/src/main/java/com/vaadin/client/communication/MessageHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/MessageHandler.java @@ -144,7 +144,7 @@ public class MessageHandler { private int sessionExpirationInterval; /** - * Holds the time spent rendering the last request + * Holds the time spent rendering the last request. */ protected int lastProcessingTime; @@ -936,13 +936,13 @@ public class MessageHandler { Profiler.leave(key); } } else if (legacyConnector == null) { - getLogger().severe( - "Received update for " + uidl.getTag() - + ", but there is no such paintable (" - + connectorId + ") rendered."); + getLogger().severe("Received update for " + + uidl.getTag() + + ", but there is no such paintable (" + + connectorId + ") rendered."); } else { - getLogger() - .severe("Server sent Vaadin 6 style updates for " + getLogger().severe( + "Server sent Vaadin 6 style updates for " + Util.getConnectorString( legacyConnector) + " but this is not a Vaadin 6 Paintable"); @@ -1723,7 +1723,7 @@ public class MessageHandler { } /** - * Checks if the first UIDL has been handled + * Checks if the first UIDL has been handled. * * @return true if the initial UIDL has already been processed, false * otherwise @@ -1777,7 +1777,7 @@ public class MessageHandler { } /** - * Unwraps and parses the given JSON, originating from the server + * Unwraps and parses the given JSON, originating from the server. * * @param jsonText * the json from the server @@ -1811,7 +1811,7 @@ public class MessageHandler { }-*/; /** - * Parse the given wrapped JSON, received from the server, to a ValueMap + * Parse the given wrapped JSON, received from the server, to a ValueMap. * * @param wrappedJsonText * the json, wrapped as done by the server diff --git a/client/src/main/java/com/vaadin/client/communication/MessageSender.java b/client/src/main/java/com/vaadin/client/communication/MessageSender.java index 762e5e2e6b..07855902fb 100644 --- a/client/src/main/java/com/vaadin/client/communication/MessageSender.java +++ b/client/src/main/java/com/vaadin/client/communication/MessageSender.java @@ -363,7 +363,7 @@ public class MessageSender { } /** - * Used internally to update what the server expects + * Used internally to update what the server expects. * * @param nextExpectedId * the new client id to set diff --git a/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java b/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java index 9b99b275f9..ada808992c 100644 --- a/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java +++ b/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java @@ -18,7 +18,7 @@ package com.vaadin.client.communication; import com.vaadin.client.ApplicationConnection; /** - * Interface which must be implemented by the reconnect dialog + * Interface which must be implemented by the reconnect dialog. * * @since 7.6 * @author Vaadin Ltd @@ -26,7 +26,7 @@ import com.vaadin.client.ApplicationConnection; public interface ReconnectDialog { /** - * Sets the main text shown in the dialog + * Sets the main text shown in the dialog. * * @param text * the text to show @@ -44,14 +44,14 @@ public interface ReconnectDialog { void setReconnecting(boolean reconnecting); /** - * Checks if the reconnect dialog is visible to the user + * Checks if the reconnect dialog is visible to the user. * * @return true if the user can see the dialog, false otherwise */ boolean isVisible(); /** - * Shows the dialog to the user + * Shows the dialog to the user. * * @param connection * the application connection this is related to @@ -59,7 +59,7 @@ public interface ReconnectDialog { void show(ApplicationConnection connection); /** - * Hides the dialog from the user + * Hides the dialog from the user. */ void hide(); @@ -87,7 +87,7 @@ public interface ReconnectDialog { /** * Called once after initialization to allow the reconnect dialog to preload * required resources, which might not be available when the server - * connection is gone + * connection is gone. */ void preload(ApplicationConnection connection); } diff --git a/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java b/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java index 250d9c53fa..23b3490231 100644 --- a/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java +++ b/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java @@ -82,7 +82,7 @@ public class ServerRpcQueue { } /** - * Removes any pending invocation of the given method from the queue + * Removes any pending invocation of the given method from the queue. * * @param invocation * The invocation to remove @@ -129,7 +129,7 @@ public class ServerRpcQueue { } /** - * Returns a collection of all queued method invocations + * Returns a collection of all queued method invocations. * <p> * The returned collection must not be modified in any way * @@ -140,7 +140,7 @@ public class ServerRpcQueue { } /** - * Clears the queue + * Clears the queue. */ public void clear() { pendingInvocations.clear(); @@ -150,7 +150,7 @@ public class ServerRpcQueue { } /** - * Returns the current size of the queue + * Returns the current size of the queue. * * @return the number of invocations in the queue */ @@ -159,7 +159,7 @@ public class ServerRpcQueue { } /** - * Returns the server RPC queue for the given application + * Returns the server RPC queue for the given application. * * @param connection * the application connection which owns the queue @@ -170,7 +170,7 @@ public class ServerRpcQueue { } /** - * Checks if the queue is empty + * Checks if the queue is empty. * * @return true if the queue is empty, false otherwise */ @@ -204,7 +204,7 @@ public class ServerRpcQueue { }; /** - * Checks if a flush operation is pending + * Checks if a flush operation is pending. * * @return true if a flush is pending, false otherwise */ @@ -214,7 +214,7 @@ public class ServerRpcQueue { /** * Checks if a loading indicator should be shown when the RPCs have been - * sent to the server and we are waiting for a response + * sent to the server and we are waiting for a response. * * @return true if a loading indicator should be shown, false otherwise */ @@ -236,7 +236,7 @@ public class ServerRpcQueue { } /** - * Returns the current invocations as JSON + * Returns the current invocations as JSON. * * @return the current invocations in a JSON format ready to be sent to the * server @@ -307,7 +307,7 @@ public class ServerRpcQueue { } /** - * Checks if the given method invocation originates from Javascript + * Checks if the given method invocation originates from Javascript. * * @param invocation * the invocation to check @@ -320,7 +320,7 @@ public class ServerRpcQueue { /** * Checks if the given method invocation represents a Vaadin 6 variable - * change + * change. * * @param invocation * the invocation to check diff --git a/client/src/main/java/com/vaadin/client/communication/XhrConnection.java b/client/src/main/java/com/vaadin/client/communication/XhrConnection.java index 8024b4149c..859b3c3024 100644 --- a/client/src/main/java/com/vaadin/client/communication/XhrConnection.java +++ b/client/src/main/java/com/vaadin/client/communication/XhrConnection.java @@ -44,7 +44,7 @@ import elemental.json.JsonObject; /** * Provides a connection to the /UIDL url on the server and knows how to send - * messages to that end point + * messages to that end point. * * @since 7.6 * @author Vaadin Ltd @@ -118,7 +118,7 @@ public class XhrConnection { } /** - * Sets the payload which was sent to the server + * Sets the payload which was sent to the server. * * @param payload * the payload which was sent to the server @@ -226,7 +226,7 @@ public class XhrConnection { } /** - * Retrieves the URI to use when sending RPCs to the server + * Retrieves the URI to use when sending RPCs to the server. * * @return The URI to use for server messages. */ diff --git a/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java b/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java index 75b4b6fb74..2823865d5a 100644 --- a/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java +++ b/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java @@ -22,7 +22,7 @@ import elemental.json.JsonObject; /** * XhrConnectionError provides detail about an error which occured during an XHR - * request to the server + * request to the server. * * @since 7.6 * @author Vaadin Ltd @@ -35,7 +35,7 @@ public class XhrConnectionError { private JsonObject payload; /** - * Constructs an event from the given request, payload and exception + * Constructs an event from the given request, payload and exception. * * @param request * the request which failed @@ -52,7 +52,7 @@ public class XhrConnectionError { } /** - * Constructs an event from the given request, response and payload + * Constructs an event from the given request, response and payload. * * @param request * the request which failed @@ -69,7 +69,7 @@ public class XhrConnectionError { } /** - * Returns the exception which caused the problem, if available + * Returns the exception which caused the problem, if available. * * @return the exception which caused the problem, or null if not available */ @@ -78,7 +78,7 @@ public class XhrConnectionError { } /** - * Returns the request for which the problem occurred + * Returns the request for which the problem occurred. * * @return the request where the problem occurred */ @@ -87,7 +87,7 @@ public class XhrConnectionError { } /** - * Returns the received response, if available + * Returns the received response, if available. * * @return the received response, or null if not available */ @@ -96,11 +96,11 @@ public class XhrConnectionError { } /** - * Returns the payload which was sent to the server + * Returns the payload which was sent to the server. * * @return the payload which was sent, never null */ public JsonObject getPayload() { return payload; } -}
\ No newline at end of file +} 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 1f8b9107f0..187c079997 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 @@ -21,7 +21,7 @@ import com.vaadin.shared.ui.Connect; import com.vaadin.shared.ui.grid.renderers.HtmlRendererState; /** - * A connector for {@link UnsafeHtmlRenderer} + * A connector for {@link UnsafeHtmlRenderer}. * * @since 8.0 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java b/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java index 82c730ade4..681e7f1454 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java @@ -98,7 +98,7 @@ public class DebugButton extends Button { } /** - * Indicates wheter the Button is currently in its active state or not + * Indicates wheter the Button is currently in its active state or not. * * @return true if the Button is active, false otherwise */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java b/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java index d20f1ca351..c0efe72b78 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java @@ -33,7 +33,7 @@ import com.vaadin.shared.Version; import com.vaadin.shared.util.SharedUtil; /** - * Information section of the debug window + * Information section of the debug window. * * @since 7.1 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java b/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java index be6bd231e8..268924b143 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java @@ -168,7 +168,7 @@ public class SelectorPath { } /** - * Returns the name of the component described by given query fragment + * Returns the name of the component described by given query fragment. * * @param fragment * Query fragment diff --git a/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java b/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java index 3e443a54cb..fe69446a7c 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java @@ -748,7 +748,7 @@ public final class VDebugWindow extends VOverlay { } /** - * Called when a response is received + * Called when a response is received. * * @param ac * @param uidl diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java index a570c5c893..9ceeb86994 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java @@ -42,7 +42,7 @@ public class PointerEventSupportImpl { } /** - * Initializes event support + * Initializes event support. */ protected void init() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java index 6f708058d5..2901565f17 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java @@ -18,7 +18,7 @@ package com.vaadin.client.event; import com.vaadin.client.event.PointerEvent.EventType; /** - * Pointer event support class for IE 10 ("ms" prefixed pointer events) + * Pointer event support class for IE 10 ("ms" prefixed pointer events). * * @since 7.2 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java index 713119fcd8..d3c4991db5 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java @@ -20,7 +20,7 @@ import com.google.gwt.user.client.impl.DOMImplStandard; import com.vaadin.client.event.PointerEvent.EventType; /** - * Pointer event support class for IE 11+ (unprefixed pointer events) + * Pointer event support class for IE 11+ (unprefixed pointer events). * * @since 7.2 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java b/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java index 1b196fdb2a..ea694be617 100644 --- a/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java @@ -31,7 +31,7 @@ import com.vaadin.shared.ui.Connect; import com.vaadin.shared.util.SharedUtil; /** - * Client-side code for {@link BrowserWindowOpener} + * Client-side code for {@link BrowserWindowOpener}. * * @author Vaadin Ltd * @since 7.0.0 diff --git a/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java b/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java index 17b37da617..7115c1e3c6 100644 --- a/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java @@ -43,17 +43,17 @@ public class ResponsiveConnector extends AbstractExtensionConnector implements ElementResizeListener { /** - * The target component which we will monitor for width changes + * The target component which we will monitor for width changes. */ protected AbstractComponentConnector target; /** - * All the width breakpoints found for this particular instance + * All the width breakpoints found for this particular instance. */ protected JavaScriptObject widthBreakpoints; /** - * All the height breakpoints found for this particular instance + * All the height breakpoints found for this particular instance. */ protected JavaScriptObject heightBreakpoints; @@ -97,7 +97,7 @@ public class ResponsiveConnector extends AbstractExtensionConnector /** * Construct the list of selectors that should be matched against in the - * range selectors + * range selectors. * * @return The selectors in a comma delimited string. */ diff --git a/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java b/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java index 92b2bae410..cff0152c50 100644 --- a/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java +++ b/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java @@ -25,7 +25,7 @@ import com.vaadin.client.communication.StateChangeEvent; /** * Encapsulates the data that the widgetset compiler generates for supporting a - * connector method annotated with {@link OnStateChange} + * connector method annotated with {@link OnStateChange}. * * @since 7.2 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java b/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java index 11983cec02..08b4ce5121 100644 --- a/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java @@ -23,7 +23,7 @@ import com.google.gwt.i18n.shared.DateTimeFormat.PredefinedFormat; import com.vaadin.client.widget.grid.RendererCellReference; /** - * A renderer for rendering dates into cells + * A renderer for rendering dates into cells. * * @since 7.4 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/renderers/HierarchyRenderer.java b/client/src/main/java/com/vaadin/client/renderers/HierarchyRenderer.java index 9bedf65b70..6ff3e817c8 100644 --- a/client/src/main/java/com/vaadin/client/renderers/HierarchyRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/HierarchyRenderer.java @@ -73,13 +73,13 @@ public class HierarchyRenderer extends ClickableRenderer<Object, Widget> { private static native RowReference<Object> getRowReference( RendererCellReference cell) /*-{ - return cell.@com.vaadin.client.widget.grid.CellReference::getRowReference()(); - }-*/; + return cell.@com.vaadin.client.widget.grid.CellReference::getRowReference()(); + }-*/; private static native FlyweightCell getFlyweightCell( RendererCellReference cell) /*-{ - return cell.@com.vaadin.client.widget.grid.RendererCellReference::cell; - }-*/; + return cell.@com.vaadin.client.widget.grid.RendererCellReference::cell; + }-*/; } private String nodeStyleName; @@ -222,8 +222,8 @@ public class HierarchyRenderer extends ClickableRenderer<Object, Widget> { private boolean isCollapsed(JsonObject rowDescription) { boolean collapsed; - collapsed = rowDescription - .getBoolean(HierarchicalDataCommunicatorConstants.ROW_COLLAPSED); + collapsed = rowDescription.getBoolean( + HierarchicalDataCommunicatorConstants.ROW_COLLAPSED); return collapsed; } @@ -248,7 +248,7 @@ public class HierarchyRenderer extends ClickableRenderer<Object, Widget> { } /** - * Decides whether the element was rendered by {@link HierarchyRenderer} + * Decides whether the element was rendered by {@link HierarchyRenderer}. */ public static boolean isElementInHierarchyWidget(Element element) { Widget w = WidgetUtil.findWidget(element); diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java b/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java index af6f95b33e..d0d109bc74 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java @@ -142,7 +142,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, } /** - * Checks if there is a server side event listener registered for clicks + * Checks if there is a server side event listener registered for clicks. * * @return true if there is a server side event listener registered, false * otherwise diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java index 14aa93893a..083ab3290a 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java @@ -100,7 +100,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector private static final int TOUCH_CONTEXT_MENU_TIMEOUT = 500; /** - * Default constructor + * Default constructor. */ public AbstractComponentConnector() { } @@ -490,7 +490,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector Profiler.leave("AbstractComponentConnector.onStateChanged"); } - @OnStateChange({"errorMessage", "errorLevel"}) + @OnStateChange({ "errorMessage", "errorLevel" }) private void setErrorLevel() { // Add or remove the widget's error level style name ErrorUtil.setErrorLevelStyle(getWidget().getElement(), diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java index 8fbb69a3c4..d9c76ad664 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java @@ -31,7 +31,7 @@ public abstract class AbstractHasComponentsConnector List<ComponentConnector> childComponents; /** - * Default constructor + * Default constructor. */ public AbstractHasComponentsConnector() { addConnectorHierarchyChangeHandler(this); diff --git a/client/src/main/java/com/vaadin/client/ui/Action.java b/client/src/main/java/com/vaadin/client/ui/Action.java index d135c2d235..ed81eefb1c 100644 --- a/client/src/main/java/com/vaadin/client/ui/Action.java +++ b/client/src/main/java/com/vaadin/client/ui/Action.java @@ -34,7 +34,7 @@ public abstract class Action implements Command { } /** - * Executed when action fired + * Executed when action fired. */ @Override public abstract void execute(); diff --git a/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java b/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java index 42259f85ca..00463f6dcb 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java @@ -26,7 +26,8 @@ import com.google.gwt.user.client.ui.Widget; import com.google.gwt.user.client.ui.impl.FocusImpl; /** - * A panel that contains an always visible 0x0 size element that holds the focus + * A panel that contains an always visible 0x0 size element that holds the + * focus. */ public class FocusElementPanel extends SimpleFocusablePanel { diff --git a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java index a60cfd7633..16b3f68456 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java @@ -29,7 +29,7 @@ import com.google.gwt.user.client.ui.Widget; public class FocusUtil { /** - * Sets the access key property + * Sets the access key property. * * @param focusable * The widget for which we want to set the access key. diff --git a/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java b/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java index 1dc0bf5f46..e4b56f85b7 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java @@ -96,7 +96,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, } /** - * Sets the keyboard focus to the panel + * Sets the keyboard focus to the panel. * * @param focus * Should the panel have keyboard focus. If true the keyboard diff --git a/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java b/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java index 9fc4e78d9f..b579e1200e 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java @@ -36,7 +36,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, HasKeyPressHandlers, Focusable { /** - * Constructor + * Constructor. */ public FocusableFlowPanel() { // make focusable, as we don't need access key magic we don't need to @@ -108,7 +108,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, } /** - * Focus the panel + * Focus the panel. */ @Override public void focus() { diff --git a/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java b/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java index b23070f1a5..ba17911e5e 100644 --- a/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java +++ b/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java @@ -23,14 +23,14 @@ import com.google.gwt.user.client.ui.Widget; public class JavaScriptWidget extends Widget { /** - * Creates a JavaScriptWidget based on a <div> element + * Creates a JavaScriptWidget based on a <div> element. */ public JavaScriptWidget() { this("div"); } /** - * Creates a JavaScriptWidget based on an element with the given tag + * Creates a JavaScriptWidget based on an element with the given tag. * * @param tagName * the tag to use for the element diff --git a/client/src/main/java/com/vaadin/client/ui/ShortcutActionHandler.java b/client/src/main/java/com/vaadin/client/ui/ShortcutActionHandler.java index 26d3fd7be0..6b26adfa0a 100644 --- a/client/src/main/java/com/vaadin/client/ui/ShortcutActionHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/ShortcutActionHandler.java @@ -53,7 +53,7 @@ public class ShortcutActionHandler { /** * Returns the ShortCutActionHandler currently used or null if there is - * currently no shortcutactionhandler + * currently no shortcutactionhandler. */ ShortcutActionHandler getShortcutActionHandler(); } diff --git a/client/src/main/java/com/vaadin/client/ui/TreeAction.java b/client/src/main/java/com/vaadin/client/ui/TreeAction.java index 8fdaf2f650..71a877f6d0 100644 --- a/client/src/main/java/com/vaadin/client/ui/TreeAction.java +++ b/client/src/main/java/com/vaadin/client/ui/TreeAction.java @@ -17,7 +17,7 @@ package com.vaadin.client.ui; /** - * This class is used for "row actions" in VTree and ITable + * This class is used for "row actions" in VTree and VScrollTable. */ public class TreeAction extends Action { diff --git a/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java b/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java index 935706babd..d3864d7c03 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java @@ -28,10 +28,10 @@ import com.vaadin.client.VCaption; public class VAbsoluteLayout extends ComplexPanel { - /** Tag name for widget creation */ + /** Tag name for widget creation. */ public static final String TAGNAME = "absolutelayout"; - /** Class name, prefix in styling */ + /** Class name, prefix in styling. */ public static final String CLASSNAME = "v-absolutelayout"; private DivElement marginElement; @@ -39,7 +39,7 @@ public class VAbsoluteLayout extends ComplexPanel { protected final Element canvas = DOM.createDiv(); /** - * Default constructor + * Default constructor. */ public VAbsoluteLayout() { setElement(Document.get().createDivElement()); @@ -83,7 +83,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Does this layout contain a widget + * Does this layout contain a widget. * * @param widget * The widget to check @@ -152,7 +152,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Sets a caption for a contained widget + * Sets a caption for a contained widget. * * @param child * The child widget to set the caption for @@ -192,7 +192,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Get the caption for a widget + * Get the caption for a widget. * * @param child * The child widget to get the caption of @@ -206,7 +206,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Get the pixel width of an slot in the layout + * Get the pixel width of an slot in the layout. * * @param child * The widget in the layout. @@ -221,7 +221,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Get the pixel height of an slot in the layout + * Get the pixel height of an slot in the layout. * * @param child * The widget in the layout @@ -237,7 +237,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Get the wrapper for a widget + * Get the wrapper for a widget. * * @param child * The child to get the wrapper for @@ -281,7 +281,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Updates all style names contained in the layout + * Updates all style names contained in the layout. * * @param primaryStyleName * The style name to use as primary @@ -364,7 +364,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Internal wrapper for wrapping widgets in the Absolute layout + * Internal wrapper for wrapping widgets in the Absolute layout. */ protected class AbsoluteWrapper extends SimplePanel { private String css; @@ -378,7 +378,7 @@ public class VAbsoluteLayout extends ComplexPanel { private String[] extraStyleNames; /** - * Constructor + * Constructor. * * @param child * The child to wrap @@ -388,14 +388,14 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Get the caption of the wrapper + * Get the caption of the wrapper. */ public VCaption getCaption() { return caption; } /** - * Set the caption for the wrapper + * Set the caption for the wrapper. * * @param caption * The caption for the wrapper @@ -410,7 +410,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Removes the wrapper caption and itself from the layout + * Removes the wrapper caption and itself from the layout. */ public void destroy() { if (caption != null) { @@ -420,7 +420,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Set the position for the wrapper in the layout + * Set the position for the wrapper in the layout. * * @param position * The position string @@ -484,7 +484,7 @@ public class VAbsoluteLayout extends ComplexPanel { } /** - * Updates the style names using the primary style name as prefix + * Updates the style names using the primary style name as prefix. */ protected void updateStyleNames() { setStyleName( 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 da5d320c8d..f39210a6fd 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java @@ -87,7 +87,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> } /** - * Blur listener that listens to blur event from the panel + * Blur listener that listens to blur event from the panel. */ public interface FocusOutListener { /** @@ -1294,7 +1294,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> } /** - * Handle the keyboard navigation when the resolution is set to MONTH + * Handle the keyboard navigation when the resolution is set to MONTH. * * @param keycode * The keycode to handle @@ -1350,7 +1350,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> } /** - * Handle keyboard navigation what the resolution is set to DAY + * Handle keyboard navigation what the resolution is set to DAY. * * @param keycode * The keycode to handle @@ -1456,7 +1456,7 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> } /** - * Handles the keyboard navigation + * Handles the keyboard navigation. * * @param keycode * The key code that was pressed @@ -1796,7 +1796,8 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>> } /** - * Returns the submit listener that listens to selection made from the panel + * Returns the submit listener that listens to selection made from the + * panel. * * @return The listener or NULL if no listener has been set */ 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 9d9862ceae..3799a8aff8 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractPopupCalendar.java @@ -299,7 +299,7 @@ public abstract class VAbstractPopupCalendar<PANEL extends VAbstractCalendarPane /** * Set correct tab index for disabled text field in IE as the value set in * setTextFieldEnabled(...) gets overridden in - * TextualDateConnection.updateFromUIDL(...) + * TextualDateConnection.updateFromUIDL(...). * * @since 7.3.1 */ @@ -382,7 +382,7 @@ public abstract class VAbstractPopupCalendar<PANEL extends VAbstractCalendarPane } /** - * Opens the calendar panel popup + * Opens the calendar panel popup. */ public void openCalendarPanel() { @@ -476,7 +476,7 @@ public abstract class VAbstractPopupCalendar<PANEL extends VAbstractCalendarPane /** * Sets the content of a special field for assistive devices, so that they * can recognize the change and inform the user (reading out in case of - * screen reader) + * screen reader). * * @param selectedDate * Date that is currently selected @@ -545,7 +545,7 @@ public abstract class VAbstractPopupCalendar<PANEL extends VAbstractCalendarPane } /** - * Closes the open popup panel + * Closes the open popup panel. */ public void closeCalendarPanel() { if (open) { diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java b/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java index b12adecc62..bdd50934b9 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java @@ -256,10 +256,11 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { private float convertToPixels(String pos) { float posAsFloat; if (pos.indexOf("%") > 0) { - posAsFloat = Math - .round(Float.parseFloat(pos.substring(0, pos.length() - 1)) - / 100 * (orientation == Orientation.HORIZONTAL - ? getOffsetWidth() : getOffsetHeight())); + posAsFloat = Math.round( + Float.parseFloat(pos.substring(0, pos.length() - 1)) / 100 + * (orientation == Orientation.HORIZONTAL + ? getOffsetWidth() + : getOffsetHeight())); } else { posAsFloat = Float.parseFloat(pos.substring(0, pos.length() - 2)); } @@ -278,7 +279,8 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { float pixelPosition = Float .parseFloat(pos.substring(0, pos.length() - 2)); int offsetLength = orientation == Orientation.HORIZONTAL - ? getOffsetWidth() : getOffsetHeight(); + ? getOffsetWidth() + : getOffsetHeight(); // Take splitter size into account at the edge if (pixelPosition + getSplitterSize() >= offsetLength) { @@ -602,21 +604,21 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { } /** - * Called when starting drag resize + * Called when starting drag resize. * * @since 7.5.1 */ protected abstract void startResize(); /** - * Called when stopping drag resize + * Called when stopping drag resize. * * @since 7.5.1 */ protected abstract void stopResize(); /** - * Gets the first container + * Gets the first container. * * @since 7.5.1 * @return the firstContainer @@ -626,7 +628,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { } /** - * Gets the second container + * Gets the second container. * * @since 7.5.1 * @return the secondContainer diff --git a/client/src/main/java/com/vaadin/client/ui/VAccordion.java b/client/src/main/java/com/vaadin/client/ui/VAccordion.java index 642c647a62..6bba4f22eb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAccordion.java +++ b/client/src/main/java/com/vaadin/client/ui/VAccordion.java @@ -209,7 +209,7 @@ public class VAccordion extends VTabsheetBase { } /** - * Returns caption width including padding + * Returns caption width including padding. * * @return */ 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 69d9e39529..f38d76e11d 100644 --- a/client/src/main/java/com/vaadin/client/ui/VComboBox.java +++ b/client/src/main/java/com/vaadin/client/ui/VComboBox.java @@ -1021,7 +1021,7 @@ public class VComboBox extends Composite implements Field, KeyDownHandler, } /** - * The menu where the suggestions are rendered + * The menu where the suggestions are rendered. */ public class SuggestionMenu extends MenuBar implements SubPartAware, LoadHandler { @@ -1361,7 +1361,7 @@ public class VComboBox extends Composite implements Field, KeyDownHandler, } /** - * Overridden to avoid selecting text when text input is disabled + * Overridden to avoid selecting text when text input is disabled. */ @Override public void setSelectionRange(int pos, int length) { diff --git a/client/src/main/java/com/vaadin/client/ui/VContextMenu.java b/client/src/main/java/com/vaadin/client/ui/VContextMenu.java index af5d5ddb4c..2e6f1db697 100644 --- a/client/src/main/java/com/vaadin/client/ui/VContextMenu.java +++ b/client/src/main/java/com/vaadin/client/ui/VContextMenu.java @@ -104,7 +104,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { } /** - * Sets the element from which to build menu + * Sets the element from which to build menu. * * @param ao */ diff --git a/client/src/main/java/com/vaadin/client/ui/VCssLayout.java b/client/src/main/java/com/vaadin/client/ui/VCssLayout.java index 045ad8f264..319dd4f6f7 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCssLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VCssLayout.java @@ -22,15 +22,15 @@ import com.vaadin.client.Profiler; import com.vaadin.client.StyleConstants; /** - * VCCSlayout is a layout which supports configuring it's children with CSS - * selectors + * VCssLayout is a layout which supports configuring it's children with CSS + * selectors. */ public class VCssLayout extends FlowPanel { public static final String CLASSNAME = "v-csslayout"; /** - * Default constructor + * Default constructor. */ public VCssLayout() { super(); diff --git a/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java b/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java index 82a08a4f12..5f681db01a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java @@ -337,7 +337,7 @@ public class VCustomLayout extends ComplexPanel { } } - /** Get the location of an widget */ + /** Get the location of an widget. */ public String getLocation(Widget w) { for (final String location : locationToWidget.keySet()) { if (locationToWidget.get(location) == w) { @@ -347,7 +347,7 @@ public class VCustomLayout extends ComplexPanel { return null; } - /** Removes given widget from the layout */ + /** Removes given widget from the layout. */ @Override public boolean remove(Widget w) { final String location = getLocation(w); @@ -364,13 +364,13 @@ public class VCustomLayout extends ComplexPanel { return false; } - /** Adding widget without specifying location is not supported */ + /** Adding widget without specifying location is not supported. */ @Override public void add(Widget w) { throw new UnsupportedOperationException(); } - /** Clear all widgets from the layout */ + /** Clear all widgets from the layout. */ @Override public void clear() { super.clear(); diff --git a/client/src/main/java/com/vaadin/client/ui/VDateTimeCalendarPanel.java b/client/src/main/java/com/vaadin/client/ui/VDateTimeCalendarPanel.java index 409afd7474..0c2dfc8628 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDateTimeCalendarPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VDateTimeCalendarPanel.java @@ -61,7 +61,7 @@ public class VDateTimeCalendarPanel private ListBox ampm; /** - * Constructor + * Constructor. */ public VTime() { super(); @@ -209,7 +209,7 @@ public class VDateTimeCalendarPanel } /** - * Updates the valus to correspond to the values in value + * Updates the value to correspond to the values in value. */ public void updateTimes() { if (getDate() == null) { @@ -316,7 +316,7 @@ public class VDateTimeCalendarPanel } /** - * Dispatches an event when the panel when time is changed + * Dispatches an event when the panel when time is changed. */ public interface TimeChangeListener { diff --git a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java index 8abc852093..20a0afcf0d 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java +++ b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java @@ -60,8 +60,7 @@ import com.vaadin.shared.ui.dd.HorizontalDropLocation; import com.vaadin.shared.ui.dd.VerticalDropLocation; /** - * - * Must have features pending: + * A wrapper for Drag and Drop. Must have features pending: * * drop details: locations + sizes in document hierarchy up to wrapper * @@ -448,8 +447,8 @@ public class VDragAndDropWrapper extends VCustomComponent } - protected String[] acceptedTypes = { "Text", "Url", - "text/html", "text/plain", "text/rtf" }; + protected String[] acceptedTypes = { "Text", "Url", "text/html", + "text/plain", "text/rtf" }; private boolean isAcceptedType(String type) { for (String t : acceptedTypes) { @@ -467,11 +466,11 @@ public class VDragAndDropWrapper extends VCustomComponent public final native void postFile(VHtml5File file) /*-{ - + this.setRequestHeader('Content-Type', 'multipart/form-data'); // Seems like IE10 will loose the file if we don't keep a reference to it... this.fileBeingUploaded = file; - + this.send(file); }-*/; @@ -627,19 +626,19 @@ public class VDragAndDropWrapper extends VCustomComponent protected native void hookHtml5Events(com.google.gwt.user.client.Element el) /*-{ var me = this; - + el.addEventListener("dragenter", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragEnter(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("dragleave", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragLeave(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("dragover", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragOver(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("drop", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragDrop(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); diff --git a/client/src/main/java/com/vaadin/client/ui/VFormLayout.java b/client/src/main/java/com/vaadin/client/ui/VFormLayout.java index 58ea0c6abb..fd1bd2b385 100644 --- a/client/src/main/java/com/vaadin/client/ui/VFormLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VFormLayout.java @@ -44,7 +44,7 @@ import com.vaadin.shared.ui.ErrorLevel; import com.vaadin.shared.ui.MarginInfo; /** - * Two col Layout that places caption on left col and field on right col + * Two col Layout that places caption on left col and field on right col. */ public class VFormLayout extends SimplePanel { @@ -378,8 +378,8 @@ public class VFormLayout extends SimplePanel { // Hide the error indicator from screen reader, as this // information is set directly at the input field - Roles.getFormRole() - .setAriaHiddenState(errorIndicatorElement, true); + Roles.getFormRole().setAriaHiddenState(errorIndicatorElement, + true); ErrorUtil.setErrorLevelStyle(errorIndicatorElement, StyleConstants.STYLE_NAME_ERROR_INDICATOR, errorLevel); diff --git a/client/src/main/java/com/vaadin/client/ui/VGridLayout.java b/client/src/main/java/com/vaadin/client/ui/VGridLayout.java index 16ae5b46ed..35caea48a2 100644 --- a/client/src/main/java/com/vaadin/client/ui/VGridLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VGridLayout.java @@ -113,7 +113,7 @@ public class VGridLayout extends ComplexPanel { } /** - * Returns the column widths measured in pixels + * Returns the column widths measured in pixels. * * @return */ @@ -122,7 +122,7 @@ public class VGridLayout extends ComplexPanel { } /** - * Returns the row heights measured in pixels + * Returns the row heights measured in pixels. * * @return */ @@ -131,7 +131,7 @@ public class VGridLayout extends ComplexPanel { } /** - * Returns the spacing between the cells horizontally in pixels + * Returns the spacing between the cells horizontally in pixels. * * @return */ @@ -140,7 +140,7 @@ public class VGridLayout extends ComplexPanel { } /** - * Returns the spacing between the cells vertically in pixels + * Returns the spacing between the cells vertically in pixels. * * @return */ diff --git a/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java b/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java index 91660a5fdd..f6f7b6abdb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java @@ -19,14 +19,14 @@ import com.vaadin.client.StyleConstants; import com.vaadin.client.ui.orderedlayout.VAbstractOrderedLayout; /** - * Represents a layout where the children is ordered vertically + * Represents a layout where the children is ordered vertically. */ public class VHorizontalLayout extends VAbstractOrderedLayout { public static final String CLASSNAME = "v-horizontallayout"; /** - * Default constructor + * Default constructor. */ public VHorizontalLayout() { super(false); diff --git a/client/src/main/java/com/vaadin/client/ui/VMenuBar.java b/client/src/main/java/com/vaadin/client/ui/VMenuBar.java index f357a6049e..2a1ba37ac8 100644 --- a/client/src/main/java/com/vaadin/client/ui/VMenuBar.java +++ b/client/src/main/java/com/vaadin/client/ui/VMenuBar.java @@ -94,7 +94,6 @@ public class VMenuBar extends SimpleFocusablePanel */ public static final Command emptyCommand = null; - /** Widget fields **/ protected boolean subMenu; protected List<CustomMenuItem> items; protected Element containerElement; @@ -251,7 +250,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * This is called by the items in the menu and it communicates the - * information to the server + * information to the server. * * @param clickedItemId * id of the item that was clicked @@ -270,14 +269,14 @@ public class VMenuBar extends SimpleFocusablePanel /** Widget methods **/ /** - * Returns a list of items in this menu + * Returns a list of items in this menu. */ public List<CustomMenuItem> getItems() { return items; } /** - * Remove all the items in this menu + * Remove all the items in this menu. */ public void clearItems() { Element e = getContainerElement(); @@ -288,7 +287,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Returns the containing element of the menu + * Returns the containing element of the menu. * * @return */ @@ -298,7 +297,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Add a new item to this menu + * Add a new item to this menu. * * @param html * items text @@ -315,7 +314,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Add a new item to this menu + * Add a new item to this menu. * * @param item */ @@ -340,7 +339,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Remove the given item from this menu + * Remove the given item from this menu. * * @param item */ @@ -437,7 +436,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * When an item is clicked + * When an item is clicked. * * @param item */ @@ -468,7 +467,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * When the user hovers the mouse over the item + * When the user hovers the mouse over the item. * * @param item */ @@ -495,7 +494,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * When the mouse is moved away from an item + * When the mouse is moved away from an item. * * @param item */ @@ -693,7 +692,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Hides the submenu of an item + * Hides the submenu of an item. * * @param item */ @@ -717,7 +716,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Listener method, fired when this menu is closed + * Listener method, fired when this menu is closed. */ @Override public void onClose(CloseEvent<PopupPanel> event) { @@ -731,7 +730,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Recursively hide all child menus + * Recursively hide all child menus. */ public void hideChildren() { hideChildren(true, true); @@ -739,7 +738,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * - * Recursively hide all child menus + * Recursively hide all child menus. * * @param animateIn * enable/disable animate-in animation when hide popup @@ -755,7 +754,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Recursively hide all parent menus + * Recursively hide all parent menus. */ public void hideParents(boolean autoClosed) { if (visibleChildMenu != null) { @@ -771,7 +770,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Returns the parent menu of this menu, or null if this is the top-level - * menu + * menu. * * @return */ @@ -780,7 +779,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Set the parent menu of this menu + * Set the parent menu of this menu. * * @param parent */ @@ -790,7 +789,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Returns the currently selected item of this menu, or null if nothing is - * selected + * selected. * * @return */ @@ -799,7 +798,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Set the currently selected item of this menu + * Set the currently selected item of this menu. * * @param item */ @@ -818,7 +817,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * - * A class to hold information on menu items + * A class to hold information on menu items. * */ public static class CustomMenuItem extends Widget implements HasHTML { @@ -1332,7 +1331,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Handles the keyboard events handled by the MenuBar + * Handles the keyboard events handled by the MenuBar. * * @param keycode * The key code received @@ -1692,7 +1691,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Get menu item with given DOM element + * Get menu item with given DOM element. * * @param element * Element used in search @@ -1721,7 +1720,7 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * Get menu item with given DOM element + * Get menu item with given DOM element. * * @param element * Element used in search diff --git a/client/src/main/java/com/vaadin/client/ui/VPanel.java b/client/src/main/java/com/vaadin/client/ui/VPanel.java index b930d54336..06c5697a0b 100644 --- a/client/src/main/java/com/vaadin/client/ui/VPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VPanel.java @@ -99,7 +99,7 @@ public class VPanel extends SimplePanel implements ShortcutActionHandlerOwner, } /** - * Sets the keyboard focus on the Panel + * Sets the keyboard focus on the Panel. * * @param focus * Should the panel have focus or not. @@ -200,7 +200,7 @@ public class VPanel extends SimplePanel implements ShortcutActionHandlerOwner, sinkEvents(Event.MOUSEEVENTS); captionNode.insertBefore(errorIndicatorElement, captionText); } - } else if (errorIndicatorElement != null){ + } else if (errorIndicatorElement != null) { captionNode.removeChild(errorIndicatorElement); errorIndicatorElement = null; } diff --git a/client/src/main/java/com/vaadin/client/ui/VPopupView.java b/client/src/main/java/com/vaadin/client/ui/VPopupView.java index e28e019b8b..de720e2d0b 100644 --- a/client/src/main/java/com/vaadin/client/ui/VPopupView.java +++ b/client/src/main/java/com/vaadin/client/ui/VPopupView.java @@ -80,7 +80,7 @@ public class VPopupView extends HTML private boolean enabled = true; /** - * loading constructor + * Loading constructor. */ public VPopupView() { super(); diff --git a/client/src/main/java/com/vaadin/client/ui/VSlider.java b/client/src/main/java/com/vaadin/client/ui/VSlider.java index 65aaa56ef0..e067613923 100644 --- a/client/src/main/java/com/vaadin/client/ui/VSlider.java +++ b/client/src/main/java/com/vaadin/client/ui/VSlider.java @@ -460,7 +460,7 @@ public class VSlider extends SimpleFocusablePanel } /** - * Handles the keyboard events handled by the Slider + * Handles the keyboard events handled by the Slider. * * @param keycode * The key code received diff --git a/client/src/main/java/com/vaadin/client/ui/VTabsheet.java b/client/src/main/java/com/vaadin/client/ui/VTabsheet.java index 44814f9e0a..35c8c1c6fb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTabsheet.java +++ b/client/src/main/java/com/vaadin/client/ui/VTabsheet.java @@ -100,7 +100,7 @@ public class VTabsheet extends VTabsheetBase } /** - * Representation of a single "tab" shown in the TabBar + * Representation of a single "tab" shown in the TabBar. * */ public static class Tab extends SimplePanel implements HasFocusHandlers, @@ -198,7 +198,7 @@ public class VTabsheet extends VTabsheetBase } /** - * Toggles the style names for the Tab + * Toggles the style names for the Tab. * * @param selected * true if the Tab is selected diff --git a/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java b/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java index f4c18dd865..2b951034bc 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java +++ b/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java @@ -63,7 +63,7 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { public abstract Iterator<Widget> getWidgetIterator(); /** - * Clears current tabs and contents + * Clears current tabs and contents. */ protected abstract void clearPaintables(); diff --git a/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java b/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java index 3871b120b0..addeffe4ed 100644 --- a/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java @@ -19,14 +19,14 @@ import com.vaadin.client.StyleConstants; import com.vaadin.client.ui.orderedlayout.VAbstractOrderedLayout; /** - * Represents a layout where the children is ordered vertically + * Represents a layout where the children is ordered vertically. */ public class VVerticalLayout extends VAbstractOrderedLayout { public static final String CLASSNAME = "v-verticallayout"; /** - * Default constructor + * Default constructor. */ public VVerticalLayout() { super(true); diff --git a/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java index 88107fa4f2..6f603fe392 100644 --- a/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java @@ -37,7 +37,7 @@ import com.vaadin.ui.AbsoluteLayout; /** * Connects the server side {@link AbsoluteLayout} with the client side - * counterpart {@link VAbsoluteLayout} + * counterpart {@link VAbsoluteLayout}. */ @Connect(AbsoluteLayout.class) public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector diff --git a/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java index 89bd7923cd..24390dab55 100644 --- a/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java @@ -37,7 +37,7 @@ import com.vaadin.ui.CssLayout; /** * Connects the server side widget {@link CssLayout} with the client side - * counterpart {@link VCssLayout} + * counterpart {@link VCssLayout}. */ @Connect(CssLayout.class) public class CssLayoutConnector extends AbstractLayoutConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java index 47c9da6732..2798228176 100644 --- a/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java @@ -40,7 +40,7 @@ public class CustomFieldConnector extends AbstractFieldConnector List<ComponentConnector> childComponents; /** - * Default constructor + * Default constructor. */ public CustomFieldConnector() { addConnectorHierarchyChangeHandler(this); diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java b/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java index 1db1848f56..1c038de772 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java @@ -171,7 +171,9 @@ public class VDragEvent { } /** - * TODO consider using similar smaller (than map) api as in Transferable + * Returns the details of the drag and drop operation. + * + * TODO consider using similar smaller (than map) API as in Transferable * * TODO clean up when drop handler changes * diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java b/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java index 9d4a120660..690ea6b378 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java @@ -77,7 +77,7 @@ public interface VDropHandler { public void dragOver(VDragEvent currentDrag); /** - * Returns the ComponentConnector with which this DropHandler is associated + * Returns the ComponentConnector with which this DropHandler is associated. */ public ComponentConnector getConnector(); diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java index ee8438de22..e111d4993e 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java @@ -50,7 +50,7 @@ import com.vaadin.shared.ui.orderedlayout.AbstractOrderedLayoutServerRpc; import com.vaadin.shared.ui.orderedlayout.AbstractOrderedLayoutState; /** - * Base class for vertical and horizontal ordered layouts + * Base class for vertical and horizontal ordered layouts. */ public abstract class AbstractOrderedLayoutConnector extends AbstractLayoutConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java index 1ab62e6c51..2571c3ac5b 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java @@ -17,7 +17,7 @@ package com.vaadin.client.ui.orderedlayout; /** - * Defines where the caption should be placed + * Defines where the caption should be placed. */ public enum CaptionPosition { TOP, RIGHT, BOTTOM, LEFT diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java index f6dc0f61ae..e2803f6bab 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java @@ -23,7 +23,7 @@ import com.vaadin.ui.HorizontalLayout; /** * Connects the client widget {@link VHorizontalLayout} with the Vaadin server - * side counterpart {@link HorizontalLayout} + * side counterpart {@link HorizontalLayout}. */ @Connect(value = HorizontalLayout.class, loadStyle = LoadStyle.EAGER) public class HorizontalLayoutConnector extends AbstractOrderedLayoutConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java index fb89972d04..2faffeede0 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java @@ -222,7 +222,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Returns the alignment for the slot + * Returns the alignment for the slot. * */ public AlignmentInfo getAlignment() { @@ -230,7 +230,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Sets the style names for the slot containing the widget + * Sets the style names for the slot containing the widget. * * @param stylenames * The style names for the slot @@ -248,7 +248,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Sets how the widget is aligned inside the slot + * Sets how the widget is aligned inside the slot. * * @param alignment * The alignment inside the slot @@ -336,7 +336,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Get the element which is added to make the spacing + * Get the element which is added to make the spacing. * * @return */ @@ -345,14 +345,14 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Does the slot have spacing + * Does the slot have spacing. */ public boolean hasSpacing() { return getSpacingElement() != null; } /** - * Get the vertical amount in pixels of the spacing + * Get the vertical amount in pixels of the spacing. */ protected int getVerticalSpacing() { if (spacer == null) { @@ -364,7 +364,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Get the horizontal amount of pixels of the spacing + * Get the horizontal amount of pixels of the spacing. * * @return */ @@ -378,7 +378,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Set the position of the caption relative to the slot + * Set the position of the caption relative to the slot. * * @param captionPosition * The position of the caption @@ -403,14 +403,14 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Get the position of the caption relative to the slot + * Get the position of the caption relative to the slot. */ public CaptionPosition getCaptionPosition() { return captionPosition; } /** - * Set the caption of the slot + * Set the caption of the slot. * * @param captionText * The text of the caption @@ -448,7 +448,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Set the caption of the slot as text + * Set the caption of the slot as text. * * @param captionText * The text of the caption @@ -473,7 +473,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Set the caption of the slot + * Set the caption of the slot. * * @param captionText * The text of the caption @@ -501,7 +501,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Set the caption of the slot + * Set the caption of the slot. * * @param captionText * The text of the caption @@ -684,14 +684,14 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { } /** - * Does the slot have a caption + * Does the slot have a caption. */ public boolean hasCaption() { return caption != null; } /** - * Get the slots caption element + * Get the slots caption element. */ public com.google.gwt.user.client.Element getCaptionElement() { return DOM.asOld(caption); @@ -700,7 +700,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { private boolean relativeWidth = false; /** - * Set if the slot has a relative width + * Set if the slot has a relative width. * * @param relativeWidth * True if slot uses relative width, false if the slot has a @@ -718,7 +718,7 @@ public class Slot extends SimplePanel implements HasErrorIndicatorElement { private boolean relativeHeight = false; /** - * Set if the slot has a relative height + * Set if the slot has a relative height. * * @param relativeHeight * True if the slot uses a relative height, false if the slot has diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java index 868b01a1f3..6dcc78feeb 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java @@ -36,7 +36,7 @@ import com.vaadin.client.Util; import com.vaadin.shared.ui.MarginInfo; /** - * Base class for ordered layouts + * Base class for ordered layouts. */ public class VAbstractOrderedLayout extends FlowPanel { @@ -206,7 +206,7 @@ public class VAbstractOrderedLayout extends FlowPanel { } /** - * Remove a slot from the layout + * Remove a slot from the layout. * * @param widget * @return @@ -304,7 +304,7 @@ public class VAbstractOrderedLayout extends FlowPanel { } /** - * Set the layout manager for the layout + * Set the layout manager for the layout. * * @param manager * The layout manager to use @@ -314,7 +314,7 @@ public class VAbstractOrderedLayout extends FlowPanel { } /** - * Get the layout manager used by this layout + * Get the layout manager used by this layout. * */ public LayoutManager getLayoutManager() { @@ -451,7 +451,7 @@ public class VAbstractOrderedLayout extends FlowPanel { } /** - * Set the margin of the layout + * Set the margin of the layout. * * @param marginInfo * The margin information @@ -466,7 +466,7 @@ public class VAbstractOrderedLayout extends FlowPanel { } /** - * Turn on or off spacing in the layout + * Turn on or off spacing in the layout. * * @param spacing * True if spacing should be used, false if not diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java index df64248c3b..f1896896f2 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java @@ -23,7 +23,7 @@ import com.vaadin.ui.VerticalLayout; /** * Connects the client widget {@link VVerticalLayout} with the Vaadin server - * side counterpart {@link VerticalLayout} + * side counterpart {@link VerticalLayout}. */ @Connect(value = VerticalLayout.class, loadStyle = LoadStyle.EAGER) public class VerticalLayoutConnector extends AbstractOrderedLayoutConnector { diff --git a/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java b/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java index 6a43b334c1..597dca83c2 100644 --- a/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java @@ -651,7 +651,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector } /** - * Checks if the given sub window is a child of this UI Connector + * Checks if the given sub window is a child of this UI Connector. * * @deprecated Should be replaced by a more generic mechanism for getting * non-ComponentConnector children @@ -873,7 +873,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector } /** - * Invokes the layout analyzer on the server + * Invokes the layout analyzer on the server. * * @since 7.1 */ @@ -942,7 +942,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector } /** - * Loads the new theme and removes references to the old theme + * Loads the new theme and removes references to the old theme. * * @since 7.4.3 * @param oldTheme @@ -1152,7 +1152,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector } /** - * Returns the name of the theme currently in used by the UI + * Returns the name of the theme currently in used by the UI. * * @since 7.3 * @return the theme name used by this UI diff --git a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java index 9bdce28b8a..847fb9f592 100644 --- a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java +++ b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java @@ -19,7 +19,7 @@ import com.google.gwt.dom.client.Element; import com.vaadin.client.ui.VUpload; /** - * IE does not have onload, detect onload via readystatechange + * IE does not have onload, detect onload via readystatechange. * */ public class UploadIFrameOnloadStrategyIE extends UploadIFrameOnloadStrategy { diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java index c105b91a6c..0503a2ef71 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java @@ -18,7 +18,7 @@ package com.vaadin.client.ui.window; import com.google.gwt.event.shared.GwtEvent; /** - * Event for window position updates + * Event for window position updates. * * @since 7.1.9 * @author Vaadin Ltd @@ -31,7 +31,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { private final int newY; /** - * Creates a new event with the given parameters + * Creates a new event with the given parameters. * * @param x * The new x-position for the VWindow @@ -44,7 +44,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { } /** - * Gets the new x position of the window + * Gets the new x position of the window. * * @return the new X position of the VWindow */ @@ -53,7 +53,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { } /** - * Gets the new y position of the window + * Gets the new y position of the window. * * @return the new Y position of the VWindow */ @@ -62,7 +62,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { } /** - * Gets the type of the event + * Gets the type of the event. * * @return the type of the event */ diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java index 47e8158b86..04e19ff650 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java @@ -18,7 +18,7 @@ package com.vaadin.client.ui.window; import com.google.gwt.event.shared.EventHandler; /** - * Handler for {@link WindowMoveEvent}s + * Handler for {@link WindowMoveEvent}s. * * @since 7.1.9 * @author Vaadin Ltd diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java index 7ad0d922a4..f32d6b5b00 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java @@ -24,8 +24,9 @@ import com.vaadin.client.widget.escalator.FlyweightRow.CellIterator; import com.vaadin.client.widgets.Escalator; /** - * A {@link FlyweightCell} represents a cell in the {@link com.vaadin.client.widgets.Grid Grid} or - * {@link Escalator} at a certain point in time. + * A {@link FlyweightCell} represents a cell in the + * {@link com.vaadin.client.widgets.Grid Grid} or {@link Escalator} at a certain + * point in time. * * <p> * Since the {@link FlyweightCell} follows the <code>Flyweight</code>-pattern @@ -51,7 +52,7 @@ public class FlyweightCell { } /** - * Returns the row index of the cell + * Returns the row index of the cell. */ public int getRow() { assertSetup(); @@ -59,7 +60,7 @@ public class FlyweightCell { } /** - * Returns the column index of the cell + * Returns the column index of the cell. */ public int getColumn() { assertSetup(); diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java b/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java index 3a87296b2f..237885ccfd 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java @@ -129,8 +129,7 @@ public interface RowContainer { * row elements. * @since 8.1 */ - public void setNewRowCallback( - Consumer<List<TableRowElement>> consumer); + public void setNewRowCallback(Consumer<List<TableRowElement>> consumer); } /** @@ -289,7 +288,7 @@ public interface RowContainer { throws IndexOutOfBoundsException, IllegalStateException; /** - * Returns the root element of RowContainer + * Returns the root element of RowContainer. * * @return RowContainer root element */ diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java index 0bd2ed0b9c..c223152105 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java @@ -35,7 +35,7 @@ public class RowVisibilityChangeEvent private final Range visibleRows; /** - * Creates a new row visibility change event + * Creates a new row visibility change event. * * @param firstVisibleRow * the index of the first visible row diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java b/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java index cadc17968d..db80553b87 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java @@ -169,7 +169,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { } /** - * Checks whether the scroll handle is currently visible or not + * Checks whether the scroll handle is currently visible or not. * * @return <code>true</code> if the scroll handle is currently visible. * <code>false</code> if not. @@ -373,7 +373,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { protected abstract String internalGetScrollSize(); /** - * Sets the primary style name + * Sets the primary style name. * * @param primaryStyleName * The primary style name to use @@ -496,7 +496,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { protected abstract void internalForceScrollbar(boolean enable); /** - * Gets the length of the scrollbar + * Gets the length of the scrollbar. * * @return the length of the scrollbar in pixels */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java index 186f274d59..a6ccd5f3c0 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java @@ -18,7 +18,7 @@ package com.vaadin.client.widget.grid; import com.vaadin.client.widgets.Grid; /** - * Callback interface for generating custom style names for cells + * Callback interface for generating custom style names for cells. * * @author Vaadin Ltd * @param <T> @@ -37,4 +37,4 @@ public interface CellStyleGenerator<T> { * any style */ public abstract String getStyle(CellReference<T> cellReference); -}
\ No newline at end of file +} diff --git a/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java index dc9969fd51..23e2c5aee5 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java @@ -25,7 +25,7 @@ import com.google.gwt.user.client.ui.Widget; */ public interface DetailsGenerator { - /** A details generator that provides no details */ + /** A details generator that provides no details. */ public static final DetailsGenerator NULL = new DetailsGenerator() { @Override public Widget getDetails(int rowIndex) { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java index 3b1e85c4d4..be70b2a5fe 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java @@ -18,7 +18,7 @@ package com.vaadin.client.widget.grid; import java.io.Serializable; /** - * Callback interface for generating custom style names for data rows + * Callback interface for generating custom style names for data rows. * * @author Vaadin Ltd * @param <T> @@ -38,4 +38,4 @@ public interface RowStyleGenerator<T> extends Serializable { * style */ public abstract String getStyle(RowReference<T> rowReference); -}
\ No newline at end of file +} diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridEnabledEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridEnabledEvent.java index 86c8e66af2..d5506cb158 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridEnabledEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridEnabledEvent.java @@ -25,7 +25,7 @@ import com.google.gwt.event.shared.GwtEvent; */ public class GridEnabledEvent extends GwtEvent<GridEnabledHandler> { /** - * The type of this event + * The type of this event. */ public static final Type<GridEnabledHandler> TYPE = new Type<>(); private final boolean enabled; diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridSelectionAllowedEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridSelectionAllowedEvent.java index e0aeed8871..5197bdf08e 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridSelectionAllowedEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridSelectionAllowedEvent.java @@ -27,7 +27,7 @@ import com.google.gwt.event.shared.GwtEvent; public class GridSelectionAllowedEvent extends GwtEvent<GridSelectionAllowedHandler> { /** - * The type of this event + * The type of this event. */ public static final Type<GridSelectionAllowedHandler> TYPE = new Type<>(); private final boolean isSelectionAllowed; diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java index 97cae2f890..1d176ad69b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java @@ -18,14 +18,14 @@ package com.vaadin.client.widget.grid.events; import com.google.gwt.event.shared.GwtEvent; /** - * An event that signifies that a scrollbar bundle has been scrolled + * An event that signifies that a scrollbar bundle has been scrolled. * * @author Vaadin Ltd * @since 7.4 */ public class ScrollEvent extends GwtEvent<ScrollHandler> { - /** The type of this event */ + /** The type of this event. */ public static final Type<ScrollHandler> TYPE = new Type<>(); @Override diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java index e9bb57b7d8..362117dfc0 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java @@ -18,7 +18,7 @@ package com.vaadin.client.widget.grid.events; import com.google.gwt.event.shared.EventHandler; /** - * A handler that gets called whenever a scrollbar bundle is scrolled + * A handler that gets called whenever a scrollbar bundle is scrolled. * * @author Vaadin Ltd * @since 7.4 diff --git a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java index d75557835d..c82585ab0b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java @@ -60,7 +60,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Static access to the GWT event type identifier associated with this Event - * class + * class. * * @return a type object, uniquely describing this event type. */ @@ -69,7 +69,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get access to the Grid that fired this event + * Get access to the Grid that fired this event. * * @return the grid instance */ @@ -79,7 +79,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get access to the Grid that fired this event + * Get access to the Grid that fired this event. * * @return the grid instance */ @@ -88,7 +88,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get the sort ordering that is to be applied to the Grid + * Get the sort ordering that is to be applied to the Grid. * * @return a list of sort order objects */ diff --git a/client/src/main/java/com/vaadin/client/widget/treegrid/TreeGrid.java b/client/src/main/java/com/vaadin/client/widget/treegrid/TreeGrid.java index 99951d1b4f..016c701deb 100644 --- a/client/src/main/java/com/vaadin/client/widget/treegrid/TreeGrid.java +++ b/client/src/main/java/com/vaadin/client/widget/treegrid/TreeGrid.java @@ -91,21 +91,22 @@ public class TreeGrid extends Grid<JsonObject> { /** * Method for accessing the private {@link Grid#focusCell(int, int)} method - * from this package + * from this package. */ - public native void focusCell(int rowIndex, int columnIndex)/*-{ + public native void focusCell(int rowIndex, int columnIndex) + /*-{ this.@com.vaadin.client.widgets.Grid::focusCell(II)(rowIndex, columnIndex); }-*/; /** * Method for accessing the private - * {@link Grid#isElementInChildWidget(Element)} method from this package + * {@link Grid#isElementInChildWidget(Element)} method from this package. */ - public native boolean isElementInChildWidget(Element e)/*-{ + public native boolean isElementInChildWidget(Element e) + /*-{ return this.@com.vaadin.client.widgets.Grid::isElementInChildWidget(*)(e); }-*/; - @Override public HandlerRegistration addBodyClickHandler(BodyClickHandler handler) { return addHandler(handler, TreeGridClickEvent.TYPE); diff --git a/client/src/main/java/com/vaadin/client/widgets/Escalator.java b/client/src/main/java/com/vaadin/client/widgets/Escalator.java index 81c1ec86b3..a46450fe07 100644 --- a/client/src/main/java/com/vaadin/client/widgets/Escalator.java +++ b/client/src/main/java/com/vaadin/client/widgets/Escalator.java @@ -1574,7 +1574,7 @@ public class Escalator extends Widget } /** - * Gets the child element that is visually at a certain index + * Gets the child element that is visually at a certain index. * * @param index * the index of the element to retrieve @@ -6649,7 +6649,7 @@ public class Escalator extends Widget } /** - * Adds a scroll handler to this escalator + * Adds a scroll handler to this escalator. * * @param handler * the scroll handler to add diff --git a/client/src/main/java/com/vaadin/client/widgets/Grid.java b/client/src/main/java/com/vaadin/client/widgets/Grid.java index 71339e3545..e4ceac93f8 100755 --- a/client/src/main/java/com/vaadin/client/widgets/Grid.java +++ b/client/src/main/java/com/vaadin/client/widgets/Grid.java @@ -483,7 +483,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Merges columns cells in a row + * Merges columns cells in a row. * * @param columns * the columns which header should be merged @@ -521,7 +521,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Merges columns cells in a row + * Merges columns cells in a row. * * @param cells * The cells to merge. Must be from the same row. @@ -961,7 +961,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Returns the events consumed by the header + * Returns the events consumed by the header. * * @return a collection of BrowserEvents */ @@ -2450,11 +2450,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * ignored. * * @param grid - * the {@code Grid} instance from which the event originated + * the {@code Grid} instance from which the event originated * @param targetElement - * the element from which the event originated + * the element from which the event originated * @return {@code true} if the event should be ignored, {@code false} if - * it should be handled + * it should be handled * @since 8.2 */ protected boolean ignoreEventFromTarget(Grid<?> grid, @@ -8523,7 +8523,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Adds a scroll handler to this grid + * Adds a scroll handler to this grid. * * @param handler * the scroll handler to add diff --git a/client/src/main/java/com/vaadin/client/widgets/Overlay.java b/client/src/main/java/com/vaadin/client/widgets/Overlay.java index 073b5c24d2..5836041de4 100644 --- a/client/src/main/java/com/vaadin/client/widgets/Overlay.java +++ b/client/src/main/java/com/vaadin/client/widgets/Overlay.java @@ -145,7 +145,7 @@ public class Overlay extends PopupPanel { /** * Style name for the overlay container element (see - * {@link #getOverlayContainer()} + * {@link #getOverlayContainer()}. */ public static final String CLASSNAME_CONTAINER = "v-overlay-container"; @@ -579,7 +579,7 @@ public class Overlay extends PopupPanel { /** * Get owner (Widget that made this Overlay, not the layout parent) of - * Overlay + * Overlay. * * @return Owner (creator) or null if not defined */ @@ -589,7 +589,7 @@ public class Overlay extends PopupPanel { /** * Set owner (Widget that made this Overlay, not the layout parent) of - * Overlay + * Overlay. * * @param owner * Owner (creator) of Overlay diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/connectors/UnsafeHtmlRendererConnector.java b/compatibility-client/src/main/java/com/vaadin/v7/client/connectors/UnsafeHtmlRendererConnector.java index e9828fc01e..0fc80deaec 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/connectors/UnsafeHtmlRendererConnector.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/connectors/UnsafeHtmlRendererConnector.java @@ -20,7 +20,7 @@ import com.vaadin.v7.client.renderers.Renderer; import com.vaadin.v7.client.widget.grid.RendererCellReference; /** - * A connector for {@link UnsafeHtmlRenderer} + * A connector for {@link UnsafeHtmlRenderer}. * * @since 7.4 * @author Vaadin Ltd diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/renderers/DateRenderer.java b/compatibility-client/src/main/java/com/vaadin/v7/client/renderers/DateRenderer.java index 85d489d389..39d2fdb045 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/renderers/DateRenderer.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/renderers/DateRenderer.java @@ -23,7 +23,7 @@ import com.google.gwt.i18n.shared.DateTimeFormat.PredefinedFormat; import com.vaadin.v7.client.widget.grid.RendererCellReference; /** - * A renderer for rendering dates into cells + * A renderer for rendering dates into cells. * * @since 7.4 * @author Vaadin Ltd diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendar.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendar.java index e657eeeed7..9d6ec62d7b 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendar.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendar.java @@ -45,7 +45,7 @@ import com.vaadin.v7.shared.ui.calendar.CalendarState.EventSortOrder; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * Client side implementation for Calendar + * Client side implementation for Calendar. * * @since 7.1 * @author Vaadin Ltd. @@ -107,11 +107,11 @@ public class VCalendar extends Composite implements VHasDropHandler { private CalendarDropHandler dropHandler; /** - * Listener interface for listening to event click events + * Listener interface for listening to event click events. */ public interface DateClickListener { /** - * Triggered when a date was clicked + * Triggered when a date was clicked. * * @param date * The date and time that was clicked @@ -120,7 +120,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Listener interface for listening to week number click events + * Listener interface for listening to week number click events. */ public interface WeekClickListener { /** @@ -133,29 +133,29 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Listener interface for listening to forward events + * Listener interface for listening to forward events. */ public interface ForwardListener { /** - * Called when the calendar should move one view forward + * Called when the calendar should move one view forward. */ void forward(); } /** - * Listener interface for listening to backward events + * Listener interface for listening to backward events. */ public interface BackwardListener { /** - * Called when the calendar should move one view backward + * Called when the calendar should move one view backward. */ void backward(); } /** - * Listener interface for listening to selection events + * Listener interface for listening to selection events. */ public interface RangeSelectListener { @@ -175,11 +175,11 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Listener interface for listening to click events + * Listener interface for listening to click events. */ public interface EventClickListener { /** - * Called when an event was clicked + * Called when an event was clicked. * * @param event * The event that was clicked @@ -194,7 +194,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface EventMovedListener { /** * Triggered when an event was dragged to a new position and the start - * and end dates was changed + * and end dates was changed. * * @param event * The event that was moved @@ -204,7 +204,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Listener interface for when an event gets resized (its start or end date - * changes) + * changes). */ public interface EventResizeListener { /** @@ -222,7 +222,7 @@ public class VCalendar extends Composite implements VHasDropHandler { */ public interface ScrollListener { /** - * Triggered when the calendar is scrolled + * Triggered when the calendar is scrolled. * * @param scrollPosition * The scroll position in pixels as returned by @@ -236,7 +236,7 @@ public class VCalendar extends Composite implements VHasDropHandler { */ public interface MouseEventListener { /** - * Triggered when a user wants an context menu + * Triggered when a user wants an context menu. * * @param event * The context menu event @@ -348,7 +348,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Default constructor + * Default constructor. */ public VCalendar() { weekToolbar = new SimpleWeekToolbar(this); @@ -368,7 +368,7 @@ public class VCalendar extends Composite implements VHasDropHandler { e.onselectstart = function() { return false; } - + e.ondragstart = function() { return false; } @@ -397,7 +397,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Adds events to the month grid + * Adds events to the month grid. * * @param events * The events to add @@ -531,7 +531,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Remove a month event from the view + * Remove a month event from the view. * * @param target * The event to remove @@ -557,7 +557,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Updates an event in the month grid + * Updates an event in the month grid. * * @param changedEvent * The event that has changed @@ -569,7 +569,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Sort the events by current sort order + * Sort the events by current sort order. * * @param events * The events to sort @@ -598,7 +598,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Sort the event by how long they are + * Sort the event by how long they are. * * @param events * The events to sort @@ -629,7 +629,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Re-render the week grid + * Re-render the week grid. * * @param daysCount * The amount of days to include in the week @@ -681,7 +681,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Updates the events in the Month view + * Updates the events in the Month view. * * @param daysCount * How many days there are @@ -777,7 +777,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Recalculates the heights of the sub-components in the calendar + * Recalculates the heights of the sub-components in the calendar. */ protected void recalculateHeights() { if (monthGrid != null) { @@ -801,7 +801,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Recalculates the widths of the sub-components in the calendar + * Recalculates the widths of the sub-components in the calendar. */ protected void recalculateWidths() { if (!isWidthUndefined) { @@ -835,7 +835,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the date format used to format dates only (excludes time) + * Get the date format used to format dates only (excludes time). * * @return */ @@ -844,7 +844,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the time format used to format time only (excludes date) + * Get the time format used to format time only (excludes date). * * @return */ @@ -857,7 +857,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the date and time format to format the dates (includes both date and - * time) + * time). * * @return */ @@ -866,7 +866,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the calendar either disabled or readonly + * Is the calendar either disabled or readonly. * * @return */ @@ -875,14 +875,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the component disabled + * Is the component disabled. */ public boolean isDisabled() { return disabled; } /** - * Is the component disabled + * Is the component disabled. * * @param disabled * True if disabled @@ -892,14 +892,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the component read-only + * Is the component read-only. */ public boolean isReadOnly() { return readOnly; } /** - * Is the component read-only + * Is the component read-only. * * @param readOnly * True if component is readonly @@ -909,7 +909,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the month grid component + * Get the month grid component. * * @return */ @@ -918,7 +918,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get he week grid component + * Get he week grid component. * * @return */ @@ -981,7 +981,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the date at midnight + * Is the date at midnight. * * @param date * The date to check @@ -995,7 +995,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Are the dates equal (uses second resolution) + * Are the dates equal (uses second resolution). * * @param date1 * The first the to compare @@ -1013,7 +1013,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the calendar event zero seconds long and is occurring at midnight + * Is the calendar event zero seconds long and is occurring at midnight. * * @param event * The event to check @@ -1025,7 +1025,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Should the 24h time format be used + * Should the 24h time format be used. * * @param format * True if the 24h format should be used else the 12h format is @@ -1036,14 +1036,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is the 24h time format used + * Is the 24h time format used. */ public boolean is24HFormat() { return format; } /** - * Set the names of the week days + * Set the names of the week days. * * @param names * The names of the days (Monday, Thursday,...) @@ -1054,14 +1054,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the names of the week days + * Get the names of the week days. */ public String[] getDayNames() { return dayNames; } /** - * Set the names of the months + * Set the names of the months. * * @param names * The names of the months (January, February,...) @@ -1072,14 +1072,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the month names + * Get the month names. */ public String[] getMonthNames() { return monthNames; } /** - * Set the number when a week starts + * Set the number when a week starts. * * @param dayNumber * The number of the day @@ -1090,14 +1090,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the number when a week starts + * Get the number when a week starts. */ public int getFirstDayNumber() { return firstDay; } /** - * Set the number when a week ends + * Set the number when a week ends. * * @param dayNumber * The number of the day @@ -1155,7 +1155,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Re-renders the whole week view + * Re-renders the whole week view. * * @param scroll * The amount of pixels to scroll the week view @@ -1205,7 +1205,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Re-renders the whole month view + * Re-renders the whole month view. * * @param firstDayOfWeek * The first day of the week @@ -1266,7 +1266,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private DateClickListener dateClickListener; /** - * Sets the listener for listening to event clicks + * Sets the listener for listening to event clicks. * * @param listener * The listener to use @@ -1276,7 +1276,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Gets the listener for listening to event clicks + * Gets the listener for listening to event clicks. * * @return */ @@ -1287,7 +1287,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private ForwardListener forwardListener; /** - * Set the listener which listens to forward events from the calendar + * Set the listener which listens to forward events from the calendar. * * @param listener * The listener to use @@ -1297,7 +1297,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the listener which listens to forward events from the calendar + * Get the listener which listens to forward events from the calendar. * * @return */ @@ -1308,7 +1308,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private BackwardListener backwardListener; /** - * Set the listener which listens to backward events from the calendar + * Set the listener which listens to backward events from the calendar. * * @param listener * The listener to use @@ -1318,7 +1318,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set the listener which listens to backward events from the calendar + * Set the listener which listens to backward events from the calendar. * * @return */ @@ -1329,7 +1329,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private WeekClickListener weekClickListener; /** - * Set the listener that listens to user clicking on the week numbers + * Set the listener that listens to user clicking on the week numbers. * * @param listener * The listener to use @@ -1339,7 +1339,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Get the listener that listens to user clicking on the week numbers + * Get the listener that listens to user clicking on the week numbers. * * @return */ @@ -1351,7 +1351,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to the user highlighting a region in the - * calendar + * calendar. * * @param listener * The listener to use @@ -1362,7 +1362,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to the user highlighting a region in the - * calendar + * calendar. * * @return */ @@ -1373,14 +1373,14 @@ public class VCalendar extends Composite implements VHasDropHandler { private EventClickListener eventClickListener; /** - * Get the listener that listens to the user clicking on the events + * Get the listener that listens to the user clicking on the events. */ public EventClickListener getEventClickListener() { return eventClickListener; } /** - * Set the listener that listens to the user clicking on the events + * Set the listener that listens to the user clicking on the events. * * @param listener * The listener to use @@ -1392,7 +1392,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private EventMovedListener eventMovedListener; /** - * Get the listener that listens to when event is dragged to a new location + * Get the listener that listens to when event is dragged to a new location. * * @return */ @@ -1401,7 +1401,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set the listener that listens to when event is dragged to a new location + * Set the listener that listens to when event is dragged to a new location. * * @param eventMovedListener * The listener to use @@ -1413,7 +1413,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private ScrollListener scrollListener; /** - * Get the listener that listens to when the calendar widget is scrolled + * Get the listener that listens to when the calendar widget is scrolled. * * @return */ @@ -1422,7 +1422,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set the listener that listens to when the calendar widget is scrolled + * Set the listener that listens to when the calendar widget is scrolled. * * @param scrollListener * The listener to use @@ -1435,7 +1435,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to when an events time limits are being - * adjusted + * adjusted. * * @return */ @@ -1445,7 +1445,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to when an events time limits are being - * adjusted + * adjusted. * * @param eventResizeListener * The listener to use @@ -1460,7 +1460,7 @@ public class VCalendar extends Composite implements VHasDropHandler { private boolean eventCaptionAsHtml = false; /** - * Get the listener that listen to mouse events + * Get the listener that listen to mouse events. * * @return */ @@ -1469,7 +1469,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set the listener that listen to mouse events + * Set the listener that listen to mouse events. * * @param mouseEventListener * The listener to use @@ -1486,7 +1486,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set selecting a range allowed + * Set selecting a range allowed. * * @param rangeSelectAllowed * Should selecting a range be allowed @@ -1496,7 +1496,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is moving a range allowed + * Is moving a range allowed. * * @return */ @@ -1505,7 +1505,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is moving a range allowed + * Is moving a range allowed. * * @param rangeMoveAllowed * Is it allowed @@ -1515,14 +1515,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is resizing an event allowed + * Is resizing an event allowed. */ public boolean isEventResizeAllowed() { return eventResizeAllowed; } /** - * Is resizing an event allowed + * Is resizing an event allowed. * * @param eventResizeAllowed * True if allowed false if not @@ -1532,14 +1532,14 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Is moving an event allowed + * Is moving an event allowed. */ public boolean isEventMoveAllowed() { return eventMoveAllowed; } /** - * Is moving an event allowed + * Is moving an event allowed. * * @param eventMoveAllowed * True if moving is allowed, false if not @@ -1575,7 +1575,7 @@ public class VCalendar extends Composite implements VHasDropHandler { } /** - * Set the drop handler + * Set the drop handler. * * @param dropHandler * The drophandler to use diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendarPanel.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendarPanel.java index bb4acd257b..bd1740d0fa 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendarPanel.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VCalendarPanel.java @@ -80,7 +80,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Blur listener that listens to blur event from the panel + * Blur listener that listens to blur event from the panel. */ public interface FocusOutListener { /** @@ -98,7 +98,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Dispatches an event when the panel when time is changed + * Dispatches an event when the panel when time is changed. */ public interface TimeChangeListener { @@ -1214,7 +1214,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Handle the keyboard navigation when the resolution is set to MONTH + * Handle the keyboard navigation when the resolution is set to MONTH. * * @param keycode * The keycode to handle @@ -1270,7 +1270,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Handle keyboard navigation what the resolution is set to DAY + * Handle keyboard navigation what the resolution is set to DAY. * * @param keycode * The keycode to handle @@ -1376,7 +1376,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Handles the keyboard navigation + * Handles the keyboard navigation. * * @param keycode * The key code that was pressed @@ -1647,7 +1647,7 @@ public class VCalendarPanel extends FocusableFlexTable implements private ListBox ampm; /** - * Constructor + * Constructor. */ public VTime() { super(); @@ -1799,7 +1799,7 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Updates the valus to correspond to the values in value + * Updates the value to correspond to the values in value. */ public void updateTimes() { if (value == null) { @@ -1985,7 +1985,8 @@ public class VCalendarPanel extends FocusableFlexTable implements } /** - * Returns the submit listener that listens to selection made from the panel + * Returns the submit listener that listens to selection made from the + * panel. * * @return The listener or NULL if no listener has been set */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VDateFieldCalendar.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VDateFieldCalendar.java index 12141f7445..7305ac412c 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VDateFieldCalendar.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VDateFieldCalendar.java @@ -25,7 +25,7 @@ import com.vaadin.v7.client.ui.VCalendarPanel.SubmitListener; import com.vaadin.v7.shared.ui.datefield.Resolution; /** - * A client side implementation for InlineDateField + * A client side implementation for InlineDateField. */ public class VDateFieldCalendar extends VDateField { @@ -105,8 +105,8 @@ public class VDateFieldCalendar extends VDateField { if (getCurrentResolution() .getCalendarField() > Resolution.SECOND .getCalendarField()) { - getClient().updateVariable(getId(), - "msec", DateTimeService + getClient().updateVariable( + getId(), "msec", DateTimeService .getMilliseconds(date2), false); } diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VFilterSelect.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VFilterSelect.java index 0abee9b3b3..cd1754edf8 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VFilterSelect.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VFilterSelect.java @@ -103,7 +103,7 @@ public class VFilterSelect extends Composite HandlesAriaInvalid, HandlesAriaRequired, DeferredWorker { /** - * Represents a suggestion in the suggestion popup box + * Represents a suggestion in the suggestion popup box. */ public class FilterSelectSuggestion implements Suggestion, Command { @@ -113,7 +113,7 @@ public class VFilterSelect extends Composite private String style; /** - * Constructor + * Constructor. * * @param uidl * The UIDL received from the server @@ -256,12 +256,12 @@ public class VFilterSelect extends Composite return $entry(function(e) { var deltaX = e.deltaX ? e.deltaX : -0.5*e.wheelDeltaX; var deltaY = e.deltaY ? e.deltaY : -0.5*e.wheelDeltaY; - + // IE8 has only delta y if (isNaN(deltaY)) { deltaY = -0.5*e.wheelDelta; } - + @com.vaadin.v7.client.ui.VFilterSelect.JsniUtil::moveScrollFromEvent(*)(widget, deltaX, deltaY, e, e.deltaMode); }); }-*/; @@ -406,7 +406,7 @@ public class VFilterSelect extends Composite } /** - * Shows the popup where the user can see the filtered options + * Shows the popup where the user can see the filtered options. * * @param currentSuggestions * The filtered suggestions @@ -538,7 +538,7 @@ public class VFilterSelect extends Composite } /** - * Selects the next item in the filtered selections + * Selects the next item in the filtered selections. */ public void selectNextItem() { debug("VFS.SP: selectNextItem()"); @@ -553,7 +553,7 @@ public class VFilterSelect extends Composite } /** - * Selects the previous item in the filtered selections + * Selects the previous item in the filtered selections. */ public void selectPrevItem() { debug("VFS.SP: selectPrevItem()"); @@ -1023,7 +1023,7 @@ public class VFilterSelect extends Composite } /** - * The menu where the suggestions are rendered + * The menu where the suggestions are rendered. */ public class SuggestionMenu extends MenuBar implements SubPartAware, LoadHandler { @@ -1079,7 +1079,7 @@ public class VFilterSelect extends Composite } /** - * Sets the suggestions rendered in the menu + * Sets the suggestions rendered in the menu. * * @param suggestions * The suggestions to be rendered in the menu @@ -1162,7 +1162,7 @@ public class VFilterSelect extends Composite } /** - * Triggered after a selection has been made + * Triggered after a selection has been made. */ public void doPostFilterSelectedItemAction() { debug("VFS.SM: doPostFilterSelectedItemAction()"); @@ -1361,7 +1361,7 @@ public class VFilterSelect extends Composite } /** - * Overridden to avoid selecting text when text input is disabled + * Overridden to avoid selecting text when text input is disabled. */ @Override public void setSelectionRange(int pos, int length) { @@ -1705,7 +1705,7 @@ public class VFilterSelect extends Composite } /** - * Filters the options at certain page using the given filter + * Filters the options at certain page using the given filter. * * @param page * The page to filter @@ -1840,7 +1840,7 @@ public class VFilterSelect extends Composite } /** - * Triggered when a suggestion is selected + * Triggered when a suggestion is selected. * * @param suggestion * The suggestion that just got selected. @@ -2182,7 +2182,7 @@ public class VFilterSelect extends Composite } /** - * Triggered when a key was depressed + * Triggered when a key was depressed. * * @param event * The KeyUpEvent of the key depressed @@ -2246,7 +2246,7 @@ public class VFilterSelect extends Composite } /** - * Listener for popupopener + * Listener for popupopener. */ @Override diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VPopupCalendar.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VPopupCalendar.java index e93ce4c04c..50a24f1387 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VPopupCalendar.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VPopupCalendar.java @@ -313,7 +313,7 @@ public class VPopupCalendar extends VTextualDate /** * Set correct tab index for disabled text field in IE as the value set in * setTextFieldEnabled(...) gets overridden in - * TextualDateConnection.updateFromUIDL(...) + * TextualDateConnection.updateFromUIDL(...). * * @since 7.3.1 */ @@ -390,7 +390,7 @@ public class VPopupCalendar extends VTextualDate } /** - * Opens the calendar panel popup + * Opens the calendar panel popup. */ public void openCalendarPanel() { @@ -468,7 +468,7 @@ public class VPopupCalendar extends VTextualDate /** * Sets the content of a special field for assistive devices, so that they * can recognize the change and inform the user (reading out in case of - * screen reader) + * screen reader). * * @param selectedDate * Date that is currently selected @@ -531,7 +531,7 @@ public class VPopupCalendar extends VTextualDate } /** - * Closes the open popup panel + * Closes the open popup panel. */ public void closeCalendarPanel() { if (open) { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VRichTextArea.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VRichTextArea.java index d46e73aeb9..445a9b75b6 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VRichTextArea.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VRichTextArea.java @@ -286,7 +286,7 @@ public class VRichTextArea extends Composite } /** - * Set the value of the text area + * Set the value of the text area. * * @param value * The text value. Can be html. @@ -300,7 +300,7 @@ public class VRichTextArea extends Composite } /** - * Get the value the text area + * Get the value the text area. */ public String getValue() { if (rta.isAttached()) { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VScrollTable.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VScrollTable.java index 9894264126..fc91260783 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VScrollTable.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VScrollTable.java @@ -2025,7 +2025,7 @@ public class VScrollTable extends FlowPanel } /** - * Get a rendered row by its key + * Get a rendered row by its key. * * @param key * The key to search with @@ -4071,7 +4071,7 @@ public class VScrollTable extends FlowPanel } /** - * Returns column alignments for visible columns + * Returns column alignments for visible columns. */ public char[] getColumnAlignments() { final char[] aligns = new char[visibleCells.size()]; @@ -4101,7 +4101,7 @@ public class VScrollTable extends FlowPanel } /** - * A cell in the footer + * A cell in the footer. */ public class FooterCell extends Widget { private final Element td = DOM.createTD(); @@ -4139,7 +4139,7 @@ public class VScrollTable extends FlowPanel } /** - * Sets the text of the footer + * Sets the text of the footer. * * @param footerText * The text in the footer @@ -4153,7 +4153,7 @@ public class VScrollTable extends FlowPanel } /** - * Set alignment of the text in the cell + * Set alignment of the text in the cell. * * @param c * The alignment which can be ALIGN_CENTER, ALIGN_LEFT, @@ -4177,7 +4177,7 @@ public class VScrollTable extends FlowPanel } /** - * Get the alignment of the text int the cell + * Get the alignment of the text int the cell. * * @return Returns either ALIGN_CENTER, ALIGN_LEFT or ALIGN_RIGHT */ @@ -4262,7 +4262,7 @@ public class VScrollTable extends FlowPanel } /** - * Sets the width to undefined + * Sets the width to undefined. */ public void setUndefinedWidth() { definedWidth = false; @@ -4289,7 +4289,7 @@ public class VScrollTable extends FlowPanel } /** - * Sets the expand ratio of the cell + * Sets the expand ratio of the cell. * * @param floatAttribute * The expand ratio @@ -4299,7 +4299,7 @@ public class VScrollTable extends FlowPanel } /** - * Returns the expand ratio of the cell + * Returns the expand ratio of the cell. * * @return The expand ratio */ @@ -4317,7 +4317,7 @@ public class VScrollTable extends FlowPanel } /** - * Handle column clicking + * Handle column clicking. */ @Override @@ -4344,7 +4344,7 @@ public class VScrollTable extends FlowPanel } /** - * Handles a event on the captions + * Handles a event on the captions. * * @param event * The event to handle @@ -4375,7 +4375,7 @@ public class VScrollTable extends FlowPanel } /** - * Returns the column key of the column + * Returns the column key of the column. * * @return The column key */ @@ -4545,7 +4545,7 @@ public class VScrollTable extends FlowPanel } /** - * Gets a footer cell which represents the given columnId + * Gets a footer cell which represents the given columnId. * * @param cid * The columnId @@ -4557,7 +4557,7 @@ public class VScrollTable extends FlowPanel } /** - * Gets a footer cell by using a column index + * Gets a footer cell by using a column index. * * @param index * The index of the column @@ -4572,7 +4572,7 @@ public class VScrollTable extends FlowPanel } /** - * Updates the cells contents when updateUIDL request is received + * Updates the cells contents when updateUIDL request is received. * * @param uidl * The UIDL @@ -4643,7 +4643,7 @@ public class VScrollTable extends FlowPanel } /** - * Set a footer cell for a specified column index + * Set a footer cell for a specified column index. * * @param index * The index @@ -4674,7 +4674,7 @@ public class VScrollTable extends FlowPanel } /** - * Remove a cell by using the columnId + * Remove a cell by using the columnId. * * @param colKey * The columnId to remove @@ -4685,7 +4685,7 @@ public class VScrollTable extends FlowPanel } /** - * Enable a column (Sets the footer cell) + * Enable a column (Sets the footer cell). * * @param cid * The columnId @@ -4703,14 +4703,14 @@ public class VScrollTable extends FlowPanel } /** - * Disable browser measurement of the table width + * Disable browser measurement of the table width. */ public void disableBrowserIntelligence() { hTableContainer.getStyle().setWidth(WRAPPER_WIDTH, Unit.PX); } /** - * Enable browser measurement of the table width + * Enable browser measurement of the table width. */ public void enableBrowserIntelligence() { hTableContainer.getStyle().clearWidth(); @@ -4728,7 +4728,7 @@ public class VScrollTable extends FlowPanel } /** - * Swap cells when the column are dragged + * Swap cells when the column are dragged. * * @param oldIndex * The old index of the cell @@ -6523,7 +6523,7 @@ public class VScrollTable extends FlowPanel } /** - * Toggle the selection of the row + * Toggle the selection of the row. */ public void toggleSelection() { selected = !selected; @@ -6791,7 +6791,7 @@ public class VScrollTable extends FlowPanel } /** - * Deselects all items + * Deselects all items. */ public void deselectAll() { for (Widget w : scrollBody) { @@ -7294,7 +7294,7 @@ public class VScrollTable extends FlowPanel } /** - * Helper function to build html snippet for column or row headers + * Helper function to build html snippet for column or row headers. * * @param uidl * possibly with values caption and icon @@ -7328,7 +7328,7 @@ public class VScrollTable extends FlowPanel /** * This method has logic which rows needs to be requested from server when - * user scrolls + * user scrolls. */ @Override @@ -7650,7 +7650,7 @@ public class VScrollTable extends FlowPanel } /** - * Moves the selection head to a specific row + * Moves the selection head to a specific row. * * @param row * The row to where the selection head should move @@ -7711,7 +7711,7 @@ public class VScrollTable extends FlowPanel } /** - * Handles the keyboard events handled by the table + * Handles the keyboard events handled by the table. * * @param keycode * The key code received diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VSlider.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VSlider.java index a5fdc40285..5cd956c9f9 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VSlider.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VSlider.java @@ -466,7 +466,7 @@ public class VSlider extends SimpleFocusablePanel } /** - * Handles the keyboard events handled by the Slider + * Handles the keyboard events handled by the Slider. * * @param keycode * The key code received diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTree.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTree.java index 2dce082305..81d71e809a 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTree.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTree.java @@ -520,7 +520,7 @@ public class VTree extends FocusElementPanel } /** - * Is a node selected in the tree + * Is a node selected in the tree. * * @param treeNode * The node to check @@ -1007,7 +1007,7 @@ public class VTree extends FocusElementPanel } /** - * Returns the children of the node + * Returns the children of the node. * * @return A set of tree nodes */ @@ -1067,7 +1067,7 @@ public class VTree extends FocusElementPanel } /** - * Travels up the hierarchy looking for this node + * Travels up the hierarchy looking for this node. * * @param child * The child which grandparent this is or is not @@ -1149,7 +1149,7 @@ public class VTree extends FocusElementPanel } /** - * Scrolls the caption into view + * Scrolls the caption into view. */ public void scrollIntoView() { WidgetUtil.scrollIntoViewVertically(nodeCaptionDiv); @@ -1189,7 +1189,7 @@ public class VTree extends FocusElementPanel } /** - * Deselects all items in the tree + * Deselects all items in the tree. */ public void deselectAll() { for (String key : selectedIds) { @@ -1510,7 +1510,7 @@ public class VTree extends FocusElementPanel } /** - * Returns the first common parent of two nodes + * Returns the first common parent of two nodes. * * @param node1 * The first node @@ -1560,7 +1560,7 @@ public class VTree extends FocusElementPanel } /** - * Sets the node currently in focus + * Sets the node currently in focus. * * @param node * The node to focus or null to remove the focus completely @@ -1622,7 +1622,7 @@ public class VTree extends FocusElementPanel } /** - * Focuses a node and scrolls it into view + * Focuses a node and scrolls it into view. * * @param node * The node to focus @@ -1708,7 +1708,7 @@ public class VTree extends FocusElementPanel } /** - * Handles the keyboard navigation + * Handles the keyboard navigation. * * @param keycode * The keycode of the pressed key diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTreeTable.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTreeTable.java index 99caa8bf44..5360da09c4 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTreeTable.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTreeTable.java @@ -766,7 +766,7 @@ public class VTreeTable extends VScrollTable { /** * Icons rendered into first actual column in TreeTable, not to row header - * cell + * cell. */ @Override protected String buildCaptionHtmlSnippet(UIDL uidl) { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTwinColSelect.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTwinColSelect.java index c996fdc06a..26d93762c2 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTwinColSelect.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/VTwinColSelect.java @@ -73,7 +73,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, private final Panel panel; /** - * A ListBox which catches double clicks + * A ListBox which catches double clicks. * */ public class DoubleClickListBox extends ListBox diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/CalendarConnector.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/CalendarConnector.java index 968defbe63..7c3910c009 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/CalendarConnector.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/CalendarConnector.java @@ -134,7 +134,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector /** * Registers listeners on the calendar so server can be notified of the - * events + * events. */ protected void registerListeners() { getWidget().setListener(new DateClickListener() { @@ -409,7 +409,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Returns the ApplicationConnection used to connect to the server side + * Returns the ApplicationConnection used to connect to the server side. */ @Override public ApplicationConnection getClient() { @@ -583,7 +583,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Get the original action ID that was passed in from the shared state + * Get the original action ID that was passed in from the shared state. * * @since 7.1.2 * @param actionKey @@ -595,7 +595,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Get the text that is displayed for a context menu item + * Get the text that is displayed for a context menu item. * * @param actionKey * The unique action key @@ -606,7 +606,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Get the icon url for a context menu item + * Get the icon url for a context menu item. * * @param actionKey * The unique action key @@ -617,7 +617,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Get the start date for an action item + * Get the start date for an action item. * * @param actionKey * The unique action key @@ -632,7 +632,7 @@ public class CalendarConnector extends AbstractLegacyComponentConnector } /** - * Get the end date for an action item + * Get the end date for an action item. * * @param actionKey * The unique action key diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/VCalendarAction.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/VCalendarAction.java index 9e81ea22dc..1ca09f7806 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/VCalendarAction.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/VCalendarAction.java @@ -24,7 +24,7 @@ import com.vaadin.v7.shared.ui.calendar.CalendarServerRpc; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * Action performed by the calendar + * Action performed by the calendar. * * @since 7.1 * @author Vaadin Ltd. @@ -53,7 +53,7 @@ public class VCalendarAction extends Action { } /** - * Constructor + * Constructor. * * @param owner * The owner who trigger this kinds of events @@ -90,7 +90,7 @@ public class VCalendarAction extends Action { } /** - * Get the date and time when the action starts + * Get the date and time when the action starts. * * @return */ @@ -99,7 +99,7 @@ public class VCalendarAction extends Action { } /** - * Set the date when the actions start + * Set the date when the actions start. * * @param actionStartDate * The date and time when the action starts @@ -109,7 +109,7 @@ public class VCalendarAction extends Action { } /** - * Get the date and time when the action ends + * Get the date and time when the action ends. * * @return */ @@ -118,7 +118,7 @@ public class VCalendarAction extends Action { } /** - * Set the date and time when the action ends + * Set the date and time when the action ends. * * @param actionEndDate * The date and time when the action ends diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/CalendarEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/CalendarEvent.java index 24f9f60b5a..d60aa7f6de 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/CalendarEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/CalendarEvent.java @@ -21,7 +21,7 @@ import com.google.gwt.i18n.client.DateTimeFormat; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * A client side implementation of a calendar event + * A client side implementation of a calendar event. * * @since 7.1 * @author Vaadin Ltd. @@ -87,7 +87,7 @@ public class CalendarEvent { } /** - * Returns the start time of the event + * Returns the start time of the event. * * @return Time embedded in the {@link Date} object */ @@ -96,7 +96,7 @@ public class CalendarEvent { } /** - * Set the start time of the event + * Set the start time of the event. * * @param startTime * The time of the event. Use the time fields in the {@link Date} @@ -107,7 +107,7 @@ public class CalendarEvent { } /** - * Get the end time of the event + * Get the end time of the event. * * @return Time embedded in the {@link Date} object */ @@ -116,7 +116,7 @@ public class CalendarEvent { } /** - * Set the end time of the event + * Set the end time of the event. * * @param endTime * Time embedded in the {@link Date} object @@ -126,7 +126,7 @@ public class CalendarEvent { } /** - * Get the (server side) index of the event + * Get the (server side) index of the event. * * @return */ @@ -135,7 +135,7 @@ public class CalendarEvent { } /** - * Get the index of the slot where the event in rendered + * Get the index of the slot where the event in rendered. * * @return */ @@ -144,7 +144,7 @@ public class CalendarEvent { } /** - * Set the index of the slot where the event in rendered + * Set the index of the slot where the event in rendered. * * @param index * The index of the slot @@ -154,7 +154,7 @@ public class CalendarEvent { } /** - * Set the (server side) index of the event + * Set the (server side) index of the event. * * @param index * The index @@ -205,7 +205,7 @@ public class CalendarEvent { } /** - * Does the event use the 24h time format + * Does the event use the 24h time format. * * @param format24h * True if it uses the 24h format, false if it uses the 12h time @@ -235,7 +235,7 @@ public class CalendarEvent { } /** - * Get the time as a formatted string + * Get the time as a formatted string. * * @return */ @@ -248,7 +248,7 @@ public class CalendarEvent { } /** - * Get the amount of milliseconds between the start and end of the event + * Get the amount of milliseconds between the start and end of the event. * * @return */ @@ -257,7 +257,7 @@ public class CalendarEvent { } /** - * Get the amount of minutes between the start and end of the event + * Get the amount of minutes between the start and end of the event. * * @return */ @@ -296,7 +296,7 @@ public class CalendarEvent { } /** - * Does the event span several days + * Does the event span several days. * * @return */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellContainer.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellContainer.java index 81366922c2..1127c027c6 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellContainer.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellContainer.java @@ -27,7 +27,7 @@ import com.vaadin.client.WidgetUtil; import com.vaadin.v7.client.ui.VCalendar; /** - * Internally used class by the Calendar + * Internally used class by the Calendar. * * since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellDayEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellDayEvent.java index 7ba6d3f0a2..5855e25a2a 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellDayEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellDayEvent.java @@ -45,7 +45,7 @@ import com.vaadin.client.WidgetUtil; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * Internally used by the calendar + * Internally used by the calendar. * * @since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellGroup.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellGroup.java index af1e1ed9a1..a4f2dd59f6 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellGroup.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateCellGroup.java @@ -20,7 +20,7 @@ import java.util.Date; import java.util.List; /** - * Internally used by the calendar + * Internally used by the calendar. * * @since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateUtil.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateUtil.java index d0ed6f9149..1d06406e5a 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateUtil.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/DateUtil.java @@ -21,7 +21,7 @@ import com.google.gwt.i18n.client.DateTimeFormat; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * Utility class for {@link Date} operations + * Utility class for {@link Date} operations. * * @since 7.1 * @author Vaadin Ltd. diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableComplexPanel.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableComplexPanel.java index 86ff8f280f..088cf40907 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableComplexPanel.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableComplexPanel.java @@ -33,7 +33,7 @@ import com.google.gwt.user.client.ui.impl.FocusImpl; import com.vaadin.client.Focusable; /** - * A ComplexPanel that can be focused + * A ComplexPanel that can be focused. * * @since 7.1 * @author Vaadin Ltd. @@ -113,7 +113,7 @@ public class FocusableComplexPanel extends ComplexPanel } /** - * Focus the panel + * Focus the panel. */ @Override public void focus() { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableGrid.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableGrid.java index 7faae676a2..0f4f6e2c89 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableGrid.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableGrid.java @@ -33,7 +33,7 @@ import com.google.gwt.user.client.ui.impl.FocusImpl; import com.vaadin.client.Focusable; /** - * A Grid that can be focused + * A Grid that can be focused. * * @since 7.1 * @author Vaadin Ltd. @@ -43,7 +43,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, HasKeyPressHandlers, Focusable { /** - * Constructor + * Constructor. */ public FocusableGrid() { super(); @@ -125,7 +125,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, } /** - * Focus the panel + * Focus the panel. */ @Override public void focus() { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableHTML.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableHTML.java index a09cc996dd..d9641c1958 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableHTML.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/FocusableHTML.java @@ -33,7 +33,7 @@ import com.google.gwt.user.client.ui.impl.FocusImpl; import com.vaadin.client.Focusable; /** - * A HTML widget that can be focused + * A HTML widget that can be focused. * * @since 7.1 * @author Vaadin Ltd. @@ -43,7 +43,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, HasKeyPressHandlers, Focusable { /** - * Constructor + * Constructor. */ public FocusableHTML() { // make focusable, as we don't need access key magic we don't need to @@ -115,7 +115,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, } /** - * Focus the panel + * Focus the panel. */ @Override public void focus() { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthEventLabel.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthEventLabel.java index 042c007794..09f77ff9ee 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthEventLabel.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthEventLabel.java @@ -24,7 +24,7 @@ import com.vaadin.client.Util; import com.vaadin.v7.client.ui.VCalendar; /** - * The label in a month cell + * The label in a month cell. * * @since 7.1 */ @@ -41,7 +41,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { private CalendarEvent calendarEvent; /** - * Default constructor + * Default constructor. */ public MonthEventLabel() { setStylePrimaryName(STYLENAME); @@ -62,7 +62,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Set the time of the event label + * Set the time of the event label. * * @param date * The date object that specifies the time @@ -73,7 +73,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Set the caption of the event label + * Set the caption of the event label. * * @param caption * The caption string, can be HTML if @@ -112,7 +112,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Set the (server side) index of the event + * Set the (server side) index of the event. * * @param index * The integer index @@ -122,7 +122,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Set the Calendar instance this label belongs to + * Set the Calendar instance this label belongs to. * * @param calendar * The calendar instance @@ -132,7 +132,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Is the event bound to a specific time + * Is the event bound to a specific time. * * @return */ @@ -141,7 +141,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { } /** - * Is the event bound to a specific time + * Is the event bound to a specific time. * * @param timeSpecificEvent * True if the event is bound to a time, false if it is only diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthGrid.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthGrid.java index c5efcb9feb..e0fd56185c 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthGrid.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/MonthGrid.java @@ -176,7 +176,7 @@ public class MonthGrid extends FocusableGrid implements KeyDownHandler { } /** - * Disable or enable possibility to select ranges + * Disable or enable possibility to select ranges. */ public void setRangeSelect(boolean b) { rangeSelectDisabled = !b; diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/SimpleDayCell.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/SimpleDayCell.java index df0d74d3b5..470ce2f1c6 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/SimpleDayCell.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/SimpleDayCell.java @@ -42,7 +42,7 @@ import com.vaadin.v7.client.ui.VCalendar; import com.vaadin.v7.shared.ui.calendar.DateConstants; /** - * A class representing a single cell within the calendar in month-view + * A class representing a single cell within the calendar in month-view. * * @since 7.1 * @author Vaadin Ltd. diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGrid.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGrid.java index 9ef922b364..b75bcae7c4 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGrid.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGrid.java @@ -493,7 +493,7 @@ public class WeekGrid extends SimplePanel { } /** - * Get width of the single date cell + * Get width of the single date cell. * * @return Date cell width */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java index ad7345e405..dbf2508741 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java @@ -18,7 +18,7 @@ package com.vaadin.v7.client.ui.calendar.schedule; import java.util.Date; /** - * Internally used by the calendar + * Internally used by the calendar. * * @since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekLabel.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekLabel.java index 5f609b87fe..ccea81a324 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekLabel.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeekLabel.java @@ -18,7 +18,7 @@ package com.vaadin.v7.client.ui.calendar.schedule; import com.google.gwt.user.client.ui.Label; /** - * A label in the {@link SimpleWeekToolbar} + * A label in the {@link SimpleWeekToolbar}. * * @since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java index 01f602fdd7..d1d58ad159 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java @@ -21,7 +21,7 @@ import com.google.gwt.user.client.ui.HTML; import com.vaadin.v7.client.ui.VCalendar; /** - * Represents a cell used in {@link WeeklyLongEvents} + * Represents a cell used in {@link WeeklyLongEvents}. * * @since 7.1 */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/dd/CalendarDropHandler.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/dd/CalendarDropHandler.java index 22e65c80f4..081a4b7817 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/dd/CalendarDropHandler.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/calendar/schedule/dd/CalendarDropHandler.java @@ -31,7 +31,7 @@ public abstract class CalendarDropHandler extends VAbstractDropHandler { protected final CalendarConnector calendarConnector; /** - * Constructor + * Constructor. * * @param connector * The connector of the calendar diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/customfield/CustomFieldConnector.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/customfield/CustomFieldConnector.java index f72672b43d..0c4ba8af31 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/customfield/CustomFieldConnector.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/customfield/CustomFieldConnector.java @@ -39,7 +39,7 @@ public class CustomFieldConnector extends AbstractFieldConnector List<ComponentConnector> childComponents; /** - * Default constructor + * Default constructor. */ public CustomFieldConnector() { addConnectorHierarchyChangeHandler(this); diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/upload/UploadIFrameOnloadStrategyIE.java b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/upload/UploadIFrameOnloadStrategyIE.java index cac9481986..d9474a4c1c 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/ui/upload/UploadIFrameOnloadStrategyIE.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/ui/upload/UploadIFrameOnloadStrategyIE.java @@ -19,7 +19,7 @@ import com.google.gwt.dom.client.Element; import com.vaadin.v7.client.ui.VUpload; /** - * IE does not have onload, detect onload via readystatechange + * IE does not have onload, detect onload via readystatechange. * */ public class UploadIFrameOnloadStrategyIE extends UploadIFrameOnloadStrategy { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/FlyweightCell.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/FlyweightCell.java index b96d90078a..cf61dca8ad 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/FlyweightCell.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/FlyweightCell.java @@ -24,8 +24,9 @@ import com.vaadin.v7.client.widget.escalator.FlyweightRow.CellIterator; import com.vaadin.v7.client.widgets.Escalator; /** - * A {@link FlyweightCell} represents a cell in the {@link com.vaadin.v7.client.widgets.Grid Grid} or - * {@link Escalator} at a certain point in time. + * A {@link FlyweightCell} represents a cell in the + * {@link com.vaadin.v7.client.widgets.Grid Grid} or {@link Escalator} at a + * certain point in time. * * <p> * Since the {@link FlyweightCell} follows the <code>Flyweight</code>-pattern @@ -51,7 +52,7 @@ public class FlyweightCell { } /** - * Returns the row index of the cell + * Returns the row index of the cell. */ public int getRow() { assertSetup(); @@ -59,7 +60,7 @@ public class FlyweightCell { } /** - * Returns the column index of the cell + * Returns the column index of the cell. */ public int getColumn() { assertSetup(); diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowContainer.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowContainer.java index 5eb1a8fa95..7058a96f3d 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowContainer.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowContainer.java @@ -273,7 +273,7 @@ public interface RowContainer { throws IndexOutOfBoundsException, IllegalStateException; /** - * Returns the root element of RowContainer + * Returns the root element of RowContainer. * * @return RowContainer root element */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowVisibilityChangeEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowVisibilityChangeEvent.java index ad2b6c65a6..87febd1416 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowVisibilityChangeEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/RowVisibilityChangeEvent.java @@ -35,7 +35,7 @@ public class RowVisibilityChangeEvent private final Range visibleRows; /** - * Creates a new row visibility change event + * Creates a new row visibility change event. * * @param firstVisibleRow * the index of the first visible row diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/ScrollbarBundle.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/ScrollbarBundle.java index cd0d4f1e38..4ffad154e9 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/ScrollbarBundle.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/escalator/ScrollbarBundle.java @@ -169,7 +169,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { } /** - * Checks whether the scroll handle is currently visible or not + * Checks whether the scroll handle is currently visible or not. * * @return <code>true</code> if the scroll handle is currently visible. * <code>false</code> if not. @@ -373,7 +373,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { protected abstract String internalGetScrollSize(); /** - * Sets the primary style name + * Sets the primary style name. * * @param primaryStyleName * The primary style name to use @@ -496,7 +496,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { protected abstract void internalForceScrollbar(boolean enable); /** - * Gets the length of the scrollbar + * Gets the length of the scrollbar. * * @return the length of the scrollbar in pixels */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/CellStyleGenerator.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/CellStyleGenerator.java index 59333bbcb1..07eccc894f 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/CellStyleGenerator.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/CellStyleGenerator.java @@ -18,7 +18,7 @@ package com.vaadin.v7.client.widget.grid; import com.vaadin.v7.client.widgets.Grid; /** - * Callback interface for generating custom style names for cells + * Callback interface for generating custom style names for cells. * * @author Vaadin Ltd * @param <T> diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/DetailsGenerator.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/DetailsGenerator.java index 04c8ff42cd..da693dd4d9 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/DetailsGenerator.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/DetailsGenerator.java @@ -25,7 +25,7 @@ import com.google.gwt.user.client.ui.Widget; */ public interface DetailsGenerator { - /** A details generator that provides no details */ + /** A details generator that provides no details. */ public static final DetailsGenerator NULL = new DetailsGenerator() { @Override public Widget getDetails(int rowIndex) { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/RowStyleGenerator.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/RowStyleGenerator.java index b0e8c0da21..cfde9ef47d 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/RowStyleGenerator.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/RowStyleGenerator.java @@ -18,13 +18,13 @@ package com.vaadin.v7.client.widget.grid; import java.io.Serializable; /** - * Callback interface for generating custom style names for data rows + * Callback interface for generating custom style names for data rows. * * @author Vaadin Ltd * @param <T> * the row type of the target grid * @see com.vaadin.v7.client.widgets.Grid#setRowStyleGenerator(RowStyleGenerator) - * Grid#setRowStyleGenerator(RowStyleGenerator) + * Grid#setRowStyleGenerator(RowStyleGenerator) * @since 7.4 */ public interface RowStyleGenerator<T> extends Serializable { diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/GridEnabledEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/GridEnabledEvent.java index 7d563329a5..f41406e839 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/GridEnabledEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/GridEnabledEvent.java @@ -25,7 +25,7 @@ import com.google.gwt.event.shared.GwtEvent; */ public class GridEnabledEvent extends GwtEvent<GridEnabledHandler> { /** - * The type of this event + * The type of this event. */ public static final Type<GridEnabledHandler> TYPE = new Type<GridEnabledHandler>(); private final boolean enabled; diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollEvent.java index 2dfd6f6693..6427eb0304 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollEvent.java @@ -18,14 +18,14 @@ package com.vaadin.v7.client.widget.grid.events; import com.google.gwt.event.shared.GwtEvent; /** - * An event that signifies that a scrollbar bundle has been scrolled + * An event that signifies that a scrollbar bundle has been scrolled. * * @author Vaadin Ltd * @since 7.4 */ public class ScrollEvent extends GwtEvent<ScrollHandler> { - /** The type of this event */ + /** The type of this event. */ public static final Type<ScrollHandler> TYPE = new Type<ScrollHandler>(); @Override diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollHandler.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollHandler.java index 1e805ce653..97befa3049 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollHandler.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/events/ScrollHandler.java @@ -18,7 +18,7 @@ package com.vaadin.v7.client.widget.grid.events; import com.google.gwt.event.shared.EventHandler; /** - * A handler that gets called whenever a scrollbar bundle is scrolled + * A handler that gets called whenever a scrollbar bundle is scrolled. * * @author Vaadin Ltd * @since 7.4 diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/sort/SortEvent.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/sort/SortEvent.java index 2b07c6ac16..c8a5db6574 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/sort/SortEvent.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widget/grid/sort/SortEvent.java @@ -60,7 +60,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Static access to the GWT event type identifier associated with this Event - * class + * class. * * @return a type object, uniquely describing this event type. */ @@ -69,7 +69,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get access to the Grid that fired this event + * Get access to the Grid that fired this event. * * @return the grid instance */ @@ -79,7 +79,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get access to the Grid that fired this event + * Get access to the Grid that fired this event. * * @return the grid instance */ @@ -88,7 +88,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { } /** - * Get the sort ordering that is to be applied to the Grid + * Get the sort ordering that is to be applied to the Grid. * * @return a list of sort order objects */ diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Escalator.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Escalator.java index 759327f3ae..b8e2c483e8 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Escalator.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Escalator.java @@ -1559,7 +1559,7 @@ public class Escalator extends Widget } /** - * Gets the child element that is visually at a certain index + * Gets the child element that is visually at a certain index. * * @param index * the index of the element to retrieve @@ -6637,7 +6637,7 @@ public class Escalator extends Widget } /** - * Adds a scroll handler to this escalator + * Adds a scroll handler to this escalator. * * @param handler * the scroll handler to add diff --git a/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Grid.java b/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Grid.java index 8b330ad603..366257c0e2 100644 --- a/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Grid.java +++ b/compatibility-client/src/main/java/com/vaadin/v7/client/widgets/Grid.java @@ -488,7 +488,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Merges columns cells in a row + * Merges columns cells in a row. * * @param columns * the columns which header should be merged @@ -526,7 +526,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Merges columns cells in a row + * Merges columns cells in a row. * * @param cells * The cells to merge. Must be from the same row. @@ -963,7 +963,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Returns the events consumed by the header + * Returns the events consumed by the header. * * @return a collection of BrowserEvents */ @@ -4862,7 +4862,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Returns the current header caption for this column + * Returns the current header caption for this column. * * @since 7.6 * @return the header caption string @@ -7212,7 +7212,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Gets the vertical scroll offset + * Gets the vertical scroll offset. * * @return the number of pixels this grid is scrolled down */ @@ -7221,7 +7221,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Sets the horizontal scroll offset + * Sets the horizontal scroll offset. * * @since 7.5.0 * @param px @@ -7232,7 +7232,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Gets the horizontal scroll offset + * Gets the horizontal scroll offset. * * @return the number of pixels this grid is scrolled to the right */ @@ -8490,7 +8490,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Adds a scroll handler to this grid + * Adds a scroll handler to this grid. * * @param handler * the scroll handler to add @@ -8591,7 +8591,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Sets the style generator that is used for generating styles for cells + * Sets the style generator that is used for generating styles for cells. * * @param cellStyleGenerator * the cell style generator to set, or <code>null</code> to @@ -8604,7 +8604,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Gets the style generator that is used for generating styles for cells + * Gets the style generator that is used for generating styles for cells. * * @return the cell style generator, or <code>null</code> if no generator is * set @@ -8614,7 +8614,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Sets the style generator that is used for generating styles for rows + * Sets the style generator that is used for generating styles for rows. * * @param rowStyleGenerator * the row style generator to set, or <code>null</code> to remove @@ -8626,7 +8626,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } /** - * Gets the style generator that is used for generating styles for rows + * Gets the style generator that is used for generating styles for rows. * * @return the row style generator, or <code>null</code> if no generator is * set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/Buffered.java b/compatibility-server/src/main/java/com/vaadin/v7/data/Buffered.java index 8bb2cefccc..3e604841b5 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/Buffered.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/Buffered.java @@ -46,7 +46,8 @@ import com.vaadin.v7.data.Validator.InvalidValueException; * * @author Vaadin Ltd. * @since 3.0 - * @deprecated As of 8.0, no replacement available, see {@link Binder#writeBean(Object)}, {@link Binder#clearFields()} + * @deprecated As of 8.0, no replacement available, see + * {@link Binder#writeBean(Object)}, {@link Binder#clearFields()} * */ @Deprecated @@ -94,7 +95,7 @@ public interface Buffered extends Serializable { public void setBuffered(boolean buffered); /** - * Checks the buffered mode + * Checks the buffered mode. * * @return true if buffered mode is on, false otherwise * @since 7.0 diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/Container.java b/compatibility-server/src/main/java/com/vaadin/v7/data/Container.java index e996d306df..fb0739a1cf 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/Container.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/Container.java @@ -1045,7 +1045,7 @@ public interface Container extends Serializable { public void removeAllContainerFilters(); /** - * Returns the filters which have been applied to the container + * Returns the filters which have been applied to the container. * * @return A collection of filters which have been applied to the * container. An empty collection if no filters have been diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroup.java b/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroup.java index ff4779ee8e..87cc641322 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroup.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroup.java @@ -536,7 +536,7 @@ public class FieldGroup implements Serializable { /** * Exception which wraps InvalidValueExceptions from all invalid fields in a - * FieldGroup + * FieldGroup. * * @since 7.4 */ @@ -648,7 +648,7 @@ public class FieldGroup implements Serializable { } /** - * Returns the field that is bound to the given property id + * Returns the field that is bound to the given property id. * * @param propertyId * The property id to use to lookup the field @@ -660,7 +660,7 @@ public class FieldGroup implements Serializable { } /** - * Returns the property id that is bound to the given field + * Returns the property id that is bound to the given field. * * @param field * The field to use to lookup the property id @@ -748,7 +748,7 @@ public class FieldGroup implements Serializable { } /** - * FIXME javadoc + * The commit event. * */ @Deprecated @@ -760,7 +760,7 @@ public class FieldGroup implements Serializable { } /** - * Returns the field binder that this commit relates to + * Returns the field binder that this commit relates to. * * @return The FieldBinder that is being committed. */ @@ -1120,7 +1120,7 @@ public class FieldGroup implements Serializable { } /** - * Returns the field group where the exception occurred + * Returns the field group where the exception occurred. * * @since 7.4 * @return the field group diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroupFieldFactory.java b/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroupFieldFactory.java index 93a48b8ad1..68e9882e0a 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroupFieldFactory.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroupFieldFactory.java @@ -27,13 +27,14 @@ import com.vaadin.v7.ui.Field; * * @author Vaadin Ltd. * @since 7.0 - * @deprecated As of 8.0, no direct replacement available. {@link Binder#forMemberField(HasValue)} and - * {@link Binder#bindInstanceFields(Object)} should be used instead. + * @deprecated As of 8.0, no direct replacement available. + * {@link Binder#forMemberField(HasValue)} and + * {@link Binder#bindInstanceFields(Object)} should be used instead. */ @Deprecated public interface FieldGroupFieldFactory extends Serializable { /** - * Creates a field based on the data type that we want to edit + * Creates a field based on the data type that we want to edit. * * @param dataType * The type that we want to edit using the field diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/sort/Sort.java b/compatibility-server/src/main/java/com/vaadin/v7/data/sort/Sort.java index e187033ed7..693ac308d3 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/sort/Sort.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/sort/Sort.java @@ -128,7 +128,7 @@ public class Sort implements Serializable { } /** - * Build a sort order list, ready to be passed to Grid + * Build a sort order list, ready to be passed to Grid. * * @return a sort order list. */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/GeneratedPropertyContainer.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/GeneratedPropertyContainer.java index 93cad4b57b..ba0a0fa56b 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/GeneratedPropertyContainer.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/GeneratedPropertyContainer.java @@ -77,7 +77,7 @@ public class GeneratedPropertyContainer extends AbstractContainer private final Set<Object> removedProperties = new HashSet<Object>(); /** - * Property implementation for generated properties + * Property implementation for generated properties. */ @Deprecated protected static class GeneratedProperty<T> implements Property<T> { @@ -208,7 +208,7 @@ public class GeneratedPropertyContainer extends AbstractContainer } /** - * Returns the wrapped Item that belongs to the wrapped container + * Returns the wrapped Item that belongs to the wrapped container. * * @return wrapped item. * @since 7.6.8 diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodProperty.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodProperty.java index d982d98c3f..f2fab292af 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodProperty.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodProperty.java @@ -64,7 +64,8 @@ import com.vaadin.v7.util.SerializerHelper; * @author Vaadin Ltd. * @since 3.0 * - * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder} + * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see + * {@link Binder} */ @Deprecated @SuppressWarnings("serial") @@ -102,8 +103,7 @@ public class MethodProperty<T> extends AbstractProperty<T> { private static final Object[] DEFAULT_SET_ARGS = new Object[1]; /* Special serialization to handle method references */ - private void writeObject(ObjectOutputStream out) - throws IOException { + private void writeObject(ObjectOutputStream out) throws IOException { out.defaultWriteObject(); SerializerHelper.writeClass(out, type); out.writeObject(instance); @@ -752,7 +752,8 @@ public class MethodProperty<T> extends AbstractProperty<T> { */ public MethodProperty getMethodProperty() { return (property instanceof MethodProperty) - ? (MethodProperty) property : null; + ? (MethodProperty) property + : null; } /** @@ -777,7 +778,7 @@ public class MethodProperty<T> extends AbstractProperty<T> { } /** - * The instance used by this property + * The instance used by this property. * * @return the instance used for fetching the property value * @since 7.7.7 diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedMethodProperty.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedMethodProperty.java index 6cbff702ad..48052a7671 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedMethodProperty.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedMethodProperty.java @@ -47,7 +47,8 @@ import com.vaadin.v7.data.util.MethodProperty.MethodException; * * @since 6.6 * - * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder} + * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see + * {@link Binder} */ @Deprecated public class NestedMethodProperty<T> extends AbstractProperty<T> { @@ -70,8 +71,7 @@ public class NestedMethodProperty<T> extends AbstractProperty<T> { private Class<? extends T> type; /* Special serialization to handle method references */ - private void writeObject(ObjectOutputStream out) - throws IOException { + private void writeObject(ObjectOutputStream out) throws IOException { out.defaultWriteObject(); // getMethods and setMethod are reconstructed on read based on // propertyName @@ -276,7 +276,7 @@ public class NestedMethodProperty<T> extends AbstractProperty<T> { } /** - * The instance used by this property + * The instance used by this property. * * @return the instance used for fetching the property value * @since 7.7.7 diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToBooleanConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToBooleanConverter.java index bf972867ce..ceef081def 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToBooleanConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToBooleanConverter.java @@ -42,7 +42,7 @@ public class StringToBooleanConverter implements Converter<String, Boolean> { /** * Creates converter with default string representations - "true" and - * "false" + * "false". * */ public StringToBooleanConverter() { diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToByteConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToByteConverter.java index 40014d4595..3c3ecace81 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToByteConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToByteConverter.java @@ -16,11 +16,11 @@ package com.vaadin.v7.data.util.converter; -import com.vaadin.data.Binder; - import java.text.NumberFormat; import java.util.Locale; +import com.vaadin.data.Binder; + /** * A converter that converts from {@link String} to {@link Byte} and back. Uses * the given locale and a {@link NumberFormat} instance for formatting and @@ -33,7 +33,7 @@ import java.util.Locale; * @since 7.4 * * @deprecated As of 8.0, a lightweight lambda-based converter can be build with - * {@link Binder}{@code .forField(...).withConverter(...)} methods. + * {@link Binder}{@code .forField(...).withConverter(...)} methods. */ @Deprecated public class StringToByteConverter @@ -42,7 +42,7 @@ public class StringToByteConverter /** * Returns the format used by * {@link #convertToPresentation(Byte, Class, Locale)} and - * {@link #convertToModel(String, Class, Locale)} + * {@link #convertToModel(String, Class, Locale)}. * * @param locale * The locale to use diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToEnumConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToEnumConverter.java index 18b1ed70cb..651c92bbfe 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToEnumConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToEnumConverter.java @@ -15,11 +15,11 @@ */ package com.vaadin.v7.data.util.converter; -import com.vaadin.data.Binder; - import java.util.EnumSet; import java.util.Locale; +import com.vaadin.data.Binder; + /** * A converter that converts from {@link String} to an {@link Enum} and back. * <p> @@ -39,7 +39,7 @@ import java.util.Locale; * @since 7.4 * * @deprecated As of 8.0, a lightweight lambda-based converter can be build with - * {@link Binder}{@code .forField(...).withConverter(...)} methods. + * {@link Binder}{@code .forField(...).withConverter(...)} methods. */ @Deprecated public class StringToEnumConverter implements Converter<String, Enum> { @@ -55,7 +55,7 @@ public class StringToEnumConverter implements Converter<String, Enum> { } /** - * Converts the given string to the given enum type using the given locale + * Converts the given string to the given enum type using the given locale. * <p> * Compatible with {@link #enumToString(Enum, Locale)} * @@ -110,7 +110,8 @@ public class StringToEnumConverter implements Converter<String, Enum> { } /** - * Converts the given enum to a human readable string using the given locale + * Converts the given enum to a human readable string using the given + * locale. * <p> * Compatible with {@link #stringToEnum(String, Class, Locale)} * diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToIntegerConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToIntegerConverter.java index ecc381b338..69ae972ec4 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToIntegerConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToIntegerConverter.java @@ -37,7 +37,7 @@ public class StringToIntegerConverter /** * Returns the format used by * {@link #convertToPresentation(Integer, Class, Locale)} and - * {@link #convertToModel(String, Class, Locale)} + * {@link #convertToModel(String, Class, Locale)}. * * @param locale * The locale to use diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToLongConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToLongConverter.java index 2fee7273b7..077f9bbc1d 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToLongConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToLongConverter.java @@ -37,7 +37,7 @@ public class StringToLongConverter /** * Returns the format used by * {@link #convertToPresentation(Long, Class, Locale)} and - * {@link #convertToModel(String, Class, Locale)} + * {@link #convertToModel(String, Class, Locale)}. * * @param locale * The locale to use diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToShortConverter.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToShortConverter.java index 1bb0da0c85..763c9bd9db 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToShortConverter.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/converter/StringToShortConverter.java @@ -30,7 +30,8 @@ import java.util.Locale; * @author Vaadin Ltd * @since 7.4 * - * @deprecated As of 8.0, no direct replacement available, see {@link com.vaadin.data.converter.StringToIntegerConverter} + * @deprecated As of 8.0, no direct replacement available, see + * {@link com.vaadin.data.converter.StringToIntegerConverter} */ @Deprecated public class StringToShortConverter @@ -39,7 +40,7 @@ public class StringToShortConverter /** * Returns the format used by * {@link #convertToPresentation(Short, Class, Locale)} and - * {@link #convertToModel(String, Class, Locale)} + * {@link #convertToModel(String, Class, Locale)}. * * @param locale * The locale to use diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLContainer.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLContainer.java index 5ff356cbfe..7591ca7a75 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLContainer.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLContainer.java @@ -65,7 +65,7 @@ public class SQLContainer implements Container, Container.Filterable, private int pageLength = DEFAULT_PAGE_LENGTH; public static final int DEFAULT_PAGE_LENGTH = 100; - /** Number of items to cache = CACHE_RATIO x pageLength */ + /** Number of items to cache = CACHE_RATIO x pageLength. */ public static final int CACHE_RATIO = 2; /** Amount of cache to overlap with previous page */ @@ -128,7 +128,7 @@ public class SQLContainer implements Container, Container.Filterable, } /** - * Creates and initializes SQLContainer using the given QueryDelegate + * Creates and initializes SQLContainer using the given QueryDelegate. * * @param delegate * QueryDelegate implementation @@ -1493,7 +1493,7 @@ public class SQLContainer implements Container, Container.Filterable, /**************************************************/ /** - * Adds a RowIdChangeListener to the QueryDelegate + * Adds a RowIdChangeListener to the QueryDelegate. * * @param listener */ @@ -1514,7 +1514,7 @@ public class SQLContainer implements Container, Container.Filterable, } /** - * Removes a RowIdChangeListener from the QueryDelegate + * Removes a RowIdChangeListener from the QueryDelegate. * * @param listener */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/TableQuery.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/TableQuery.java index 3cfd95e489..8aa6aa0c26 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/TableQuery.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/TableQuery.java @@ -757,7 +757,7 @@ public class TableQuery extends AbstractTransactionalQuery } /** - * Adds RowIdChangeListener to this query + * Adds RowIdChangeListener to this query. */ @Override public void addRowIdChangeListener(RowIdChangeListener listener) { @@ -778,7 +778,7 @@ public class TableQuery extends AbstractTransactionalQuery } /** - * Removes the given RowIdChangeListener from this query + * Removes the given RowIdChangeListener from this query. */ @Override public void removeRowIdChangeListener(RowIdChangeListener listener) { diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/DefaultSQLGenerator.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/DefaultSQLGenerator.java index 88fc18084c..3f5c60d8e8 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/DefaultSQLGenerator.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/DefaultSQLGenerator.java @@ -47,7 +47,7 @@ public class DefaultSQLGenerator implements SQLGenerator { /** * Create a new DefaultSqlGenerator instance that uses the given - * implementation of {@link StatementHelper} + * implementation of {@link StatementHelper}. * * @param statementHelper */ @@ -285,7 +285,7 @@ public class DefaultSQLGenerator implements SQLGenerator { } /** - * Generates sorting rules as an ORDER BY -clause + * Generates sorting rules as an ORDER BY -clause. * * @param sb * StringBuffer to which the clause is appended. diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/StringDecorator.java b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/StringDecorator.java index 047856d9d8..e6aa7ccc09 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/StringDecorator.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/StringDecorator.java @@ -61,7 +61,7 @@ public class StringDecorator implements Serializable { } /** - * Groups a string by surrounding it in parenthesis + * Groups a string by surrounding it in parenthesis. * * @param str * the string to group diff --git a/compatibility-server/src/main/java/com/vaadin/v7/data/validator/RangeValidator.java b/compatibility-server/src/main/java/com/vaadin/v7/data/validator/RangeValidator.java index f343a0e76b..3889aa890a 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/data/validator/RangeValidator.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/data/validator/RangeValidator.java @@ -65,7 +65,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Checks if the minimum value is part of the accepted range + * Checks if the minimum value is part of the accepted range. * * @return true if the minimum value is part of the range, false otherwise */ @@ -74,7 +74,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Sets if the minimum value is part of the accepted range + * Sets if the minimum value is part of the accepted range. * * @param minValueIncluded * true if the minimum value should be part of the range, false @@ -85,7 +85,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Checks if the maximum value is part of the accepted range + * Checks if the maximum value is part of the accepted range. * * @return true if the maximum value is part of the range, false otherwise */ @@ -94,7 +94,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Sets if the maximum value is part of the accepted range + * Sets if the maximum value is part of the accepted range. * * @param maxValueIncluded * true if the maximum value should be part of the range, false @@ -105,7 +105,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Gets the minimum value of the range + * Gets the minimum value of the range. * * @return the minimum value */ @@ -126,7 +126,7 @@ public class RangeValidator<T extends Comparable> extends AbstractValidator<T> { } /** - * Gets the maximum value of the range + * Gets the maximum value of the range. * * @return the maximum value */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/event/ItemClickEvent.java b/compatibility-server/src/main/java/com/vaadin/v7/event/ItemClickEvent.java index 7de27e3eba..179581acc7 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/event/ItemClickEvent.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/event/ItemClickEvent.java @@ -61,7 +61,7 @@ public class ItemClickEvent extends ClickEvent implements Serializable { } /** - * Gets a possible identifier in source for clicked Item + * Gets a possible identifier in source for clicked Item. * * @return */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/event/SelectionEvent.java b/compatibility-server/src/main/java/com/vaadin/v7/event/SelectionEvent.java index 01fb94b879..5213a7d64a 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/event/SelectionEvent.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/event/SelectionEvent.java @@ -117,7 +117,7 @@ public class SelectionEvent extends EventObject { @Deprecated public interface SelectionNotifier extends Serializable { /** - * Registers a new selection listener + * Registers a new selection listener. * * @param listener * the listener to register @@ -125,7 +125,7 @@ public class SelectionEvent extends EventObject { void addSelectionListener(SelectionListener listener); /** - * Removes a previously registered selection change listener + * Removes a previously registered selection change listener. * * @param listener * the listener to remove diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractColorPicker.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractColorPicker.java index baa8f1b34e..8fb42de9ed 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractColorPicker.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractColorPicker.java @@ -57,13 +57,13 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Interface for converting 2d-coordinates to a Color + * Interface for converting 2d-coordinates to a Color. */ @Deprecated public interface Coordinates2Color extends Serializable { /** - * Calculate color from coordinates + * Calculate color from coordinates. * * @param x * the x-coordinate @@ -75,7 +75,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent public Color calculate(int x, int y); /** - * Calculate coordinates from color + * Calculate coordinates from color. * * @param c * the c @@ -203,7 +203,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Sets the position of the popup window + * Sets the position of the popup window. * * @param x * the x-coordinate @@ -238,7 +238,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Fired when a color change event occurs + * Fired when a color change event occurs. * * @param event * The color change event @@ -249,14 +249,14 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Notifies the listeners that the selected color has changed + * Notifies the listeners that the selected color has changed. */ public void fireColorChanged() { fireEvent(new ColorChangeEvent(this, color)); } /** - * The style for the popup window + * The style for the popup window. * * @param style * The style @@ -286,7 +286,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the style for the popup window + * Gets the style for the popup window. * * @since 7.5.0 * @return popup window style @@ -296,7 +296,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Set the visibility of the RGB Tab + * Set the visibility of the RGB Tab. * * @param visible * The visibility @@ -314,7 +314,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the visibility of the RGB Tab + * Gets the visibility of the RGB Tab. * * @since 7.5.0 * @return visibility of the RGB tab @@ -324,7 +324,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Set the visibility of the HSV Tab + * Set the visibility of the HSV Tab. * * @param visible * The visibility @@ -341,7 +341,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the visibility of the HSV Tab + * Gets the visibility of the HSV Tab. * * @since 7.5.0 * @return visibility of the HSV tab @@ -351,7 +351,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Set the visibility of the Swatches Tab + * Set the visibility of the Swatches Tab. * * @param visible * The visibility @@ -368,7 +368,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the visibility of the Swatches Tab + * Gets the visibility of the Swatches Tab. * * @since 7.5.0 * @return visibility of the swatches tab @@ -378,7 +378,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Sets the visibility of the Color History + * Sets the visibility of the Color History. * * @param visible * The visibility @@ -391,7 +391,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the visibility of the Color History + * Gets the visibility of the Color History. * * @since 7.5.0 * @return visibility of color history @@ -401,7 +401,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Sets the visibility of the CSS color code text field + * Sets the visibility of the CSS color code text field. * * @param visible * The visibility @@ -414,7 +414,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Gets the visibility of CSS color code text field + * Gets the visibility of CSS color code text field. * * @since 7.5.0 * @return visibility of css color code text field @@ -434,7 +434,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Sets the default styles of the component + * Sets the default styles of the component. * */ protected abstract void setDefaultStyles(); @@ -532,7 +532,7 @@ public abstract class AbstractColorPicker extends AbstractLegacyComponent } /** - * Return HTML rendering setting + * Return HTML rendering setting. * * @return <code>true</code> if the caption text is to be rendered as HTML, * <code>false</code> otherwise diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractSelect.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractSelect.java index a6472c61db..620a29f83a 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractSelect.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractSelect.java @@ -558,19 +558,21 @@ public abstract class AbstractSelect extends AbstractField<Object> implements } /** - * TODO refine doc Setter for new item handler that is called when user adds - * new item in newItemAllowed mode. + * TODO refine doc Setter for new item handler, which is called when user + * adds new item in {@code newItemAllowed} mode. * * @param newItemHandler + * The new item handler */ public void setNewItemHandler(NewItemHandler newItemHandler) { this.newItemHandler = newItemHandler; } /** - * TODO refine doc + * Returns the new item handler, which is called when user adds new item in + * {@code newItemAllowed} mode. * - * @return + * @return NewItemHandler */ public NewItemHandler getNewItemHandler() { if (newItemHandler == null) { @@ -821,7 +823,7 @@ public abstract class AbstractSelect extends AbstractField<Object> implements /** * Gets the Property identified by the given itemId and propertyId from the - * Container + * Container. * * @see Container#getContainerProperty(Object, Object) */ @@ -2127,7 +2129,7 @@ public abstract class AbstractSelect extends AbstractField<Object> implements /** * Constructor that automatically converts itemIdOver key to - * corresponding item Id + * corresponding item Id. * */ protected AbstractSelectTargetDetails( @@ -2193,7 +2195,7 @@ public abstract class AbstractSelect extends AbstractField<Object> implements /** * Called by Table when a cell (and row) is painted or a item is painted - * in Tree + * in Tree. * * @param source * The source of the generator, the Tree or Table the diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Calendar.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Calendar.java index a763eccba2..e04888fa91 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Calendar.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Calendar.java @@ -239,7 +239,7 @@ public class Calendar extends AbstractLegacyComponent private Integer customFirstDayOfWeek; /** - * Returns the logger for the calendar + * Returns the logger for the calendar. */ protected Logger getLogger() { return Logger.getLogger(Calendar.class.getName()); @@ -1056,7 +1056,7 @@ public class Calendar extends AbstractLegacyComponent } /** - * Is the user allowed to trigger events which alters the events + * Is the user allowed to trigger events which alters the events. * * @return true if the client is allowed to send changes to server * @see #isEventClickAllowed() @@ -1095,7 +1095,7 @@ public class Calendar extends AbstractLegacyComponent } /** - * Fires an event move event to all server side move listerners + * Fires an event move event to all server side move listeners. * * @param index * The index of the event in the events list @@ -1308,7 +1308,7 @@ public class Calendar extends AbstractLegacyComponent /** * Finds the first day of the week and returns a day representing the start - * of that day + * of that day. * * @param start * The actual date @@ -1339,7 +1339,7 @@ public class Calendar extends AbstractLegacyComponent /** * Finds the last day of the week and returns a day representing the end of - * that day + * that day. * * @param end * The actual date @@ -1496,7 +1496,7 @@ public class Calendar extends AbstractLegacyComponent } /** - * Get the currently active drop handler + * Get the currently active drop handler. */ @Override public DropHandler getDropHandler() { @@ -1713,7 +1713,7 @@ public class Calendar extends AbstractLegacyComponent } /** - * Is the calendar in a mode where all days of the month is shown + * Is the calendar in a mode where all days of the month is shown. * * @return Returns true if calendar is in monthly mode and false if it is in * weekly mode diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Form.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Form.java index b37bcd933b..ea8fa1c528 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Form.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Form.java @@ -1298,7 +1298,7 @@ public class Form extends AbstractField<Object> } /** - * Removes all action handlers + * Removes all action handlers. */ public void removeAllActionHandlers() { if (ownActionManager != null) { diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Grid.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Grid.java index 4349ad49b4..9e8dd1086c 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Grid.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Grid.java @@ -292,7 +292,7 @@ public class Grid extends AbstractComponent @Deprecated public interface DetailsGenerator extends Serializable { - /** A details generator that provides no details */ + /** A details generator that provides no details. */ public DetailsGenerator NULL = new DetailsGenerator() { @Override public Component getDetails(RowReference rowReference) { @@ -618,7 +618,7 @@ public class Grid extends AbstractComponent } /** - * Returns the singleton instance + * Returns the singleton instance. * * @return the singleton instance */ @@ -659,13 +659,13 @@ public class Grid extends AbstractComponent } /** - * Error handler for the editor + * Error handler for the editor. */ @Deprecated public interface EditorErrorHandler extends Serializable { /** - * Called when an exception occurs while the editor row is being saved + * Called when an exception occurs while the editor row is being saved. * * @param event * An event providing more information about the error @@ -742,7 +742,7 @@ public class Grid extends AbstractComponent } /** - * An event which is fired when saving the editor fails + * An event which is fired when saving the editor fails. */ @Deprecated public static class CommitErrorEvent extends Component.Event { @@ -760,7 +760,7 @@ public class Grid extends AbstractComponent } /** - * Retrieves the cause of the failure + * Retrieves the cause of the failure. * * @return the cause of the failure */ @@ -774,7 +774,7 @@ public class Grid extends AbstractComponent } /** - * Checks if validation exceptions caused this error + * Checks if validation exceptions caused this error. * * @return true if the problem was caused by a validation error */ @@ -941,7 +941,7 @@ public class Grid extends AbstractComponent } /** - * Interface for an editor event listener + * Interface for an editor event listener. */ @Deprecated public interface EditorListener extends Serializable { @@ -955,7 +955,7 @@ public class Grid extends AbstractComponent EditorCloseEvent.class); /** - * Called when an editor is opened + * Called when an editor is opened. * * @param e * an editor open event object @@ -963,7 +963,7 @@ public class Grid extends AbstractComponent public void editorOpened(EditorOpenEvent e); /** - * Called when an editor is reopened without closing it first + * Called when an editor is reopened without closing it first. * * @param e * an editor move event object @@ -971,7 +971,7 @@ public class Grid extends AbstractComponent public void editorMoved(EditorMoveEvent e); /** - * Called when an editor is closed + * Called when an editor is closed. * * @param e * an editor close event object @@ -981,7 +981,7 @@ public class Grid extends AbstractComponent } /** - * Base class for editor related events + * Base class for editor related events. */ @Deprecated public abstract static class EditorEvent extends Component.Event { @@ -994,7 +994,7 @@ public class Grid extends AbstractComponent } /** - * Get the item (row) for which this editor was opened + * Get the item (row) for which this editor was opened. */ public Object getItem() { return itemID; @@ -1003,7 +1003,7 @@ public class Grid extends AbstractComponent } /** - * This event gets fired when an editor is opened + * This event gets fired when an editor is opened. */ @Deprecated public static class EditorOpenEvent extends EditorEvent { @@ -1038,7 +1038,7 @@ public class Grid extends AbstractComponent } /** - * Default error handler for the editor + * Default error handler for the editor. * */ @Deprecated @@ -1098,7 +1098,7 @@ public class Grid extends AbstractComponent */ @Deprecated public enum SelectionMode { - /** A SelectionMode that maps to {@link SingleSelectionModel} */ + /** A SelectionMode that maps to {@link SingleSelectionModel}. */ SINGLE { @Override protected SelectionModel createModel() { @@ -1107,7 +1107,7 @@ public class Grid extends AbstractComponent }, - /** A SelectionMode that maps to {@link MultiSelectionModel} */ + /** A SelectionMode that maps to {@link MultiSelectionModel}. */ MULTI { @Override protected SelectionModel createModel() { @@ -1115,7 +1115,7 @@ public class Grid extends AbstractComponent } }, - /** A SelectionMode that maps to {@link NoSelectionModel} */ + /** A SelectionMode that maps to {@link NoSelectionModel}. */ NONE { @Override protected SelectionModel createModel() { @@ -1282,7 +1282,7 @@ public class Grid extends AbstractComponent throws IllegalArgumentException; /** - * Marks all the items in the current Container as selected + * Marks all the items in the current Container as selected. * * @return <code>true</code> if some items were previously not * selected @@ -1291,7 +1291,7 @@ public class Grid extends AbstractComponent boolean selectAll(); /** - * Marks all the items in the current Container as deselected + * Marks all the items in the current Container as deselected. * * @return <code>true</code> if some items were previously selected * @see #selectAll() @@ -2075,7 +2075,7 @@ public class Grid extends AbstractComponent } /** - * Sets the identifying information for this row + * Sets the identifying information for this row. * * @param itemId * the item id of the row @@ -2132,7 +2132,7 @@ public class Grid extends AbstractComponent } /** - * Sets the identifying information for this cell + * Sets the identifying information for this cell. * * @param propertyId * the property id of the column @@ -3431,7 +3431,7 @@ public class Grid extends AbstractComponent } /** - * Returns the property id for the backing property of this Column + * Returns the property id for the backing property of this Column. * * @return property id */ @@ -3598,7 +3598,7 @@ public class Grid extends AbstractComponent /** * Checks if column is attached and throws an - * {@link IllegalStateException} if it is not + * {@link IllegalStateException} if it is not. * * @throws IllegalStateException * if the column is no longer attached to any grid @@ -4359,7 +4359,7 @@ public class Grid extends AbstractComponent } /** - * Null representation for the renderer + * Null representation for the renderer. * * @return a textual representation of {@code null} */ @@ -5217,7 +5217,7 @@ public class Grid extends AbstractComponent } /** - * Returns a column based on the property id + * Returns a column based on the property id. * * @param propertyId * the property id of the column @@ -6777,7 +6777,7 @@ public class Grid extends AbstractComponent /** * Returns the {@code RowDescriptionGenerator} instance used to generate - * descriptions (tooltips) for Grid rows + * descriptions (tooltips) for Grid rows. * * @return the description generator or {@code} null if no generator is set * @@ -6788,7 +6788,7 @@ public class Grid extends AbstractComponent } /** - * Sets the style generator that is used for generating styles for cells + * Sets the style generator that is used for generating styles for cells. * * @param cellStyleGenerator * the cell style generator to set, or <code>null</code> to @@ -6800,7 +6800,7 @@ public class Grid extends AbstractComponent } /** - * Gets the style generator that is used for generating styles for cells + * Gets the style generator that is used for generating styles for cells. * * @return the cell style generator, or <code>null</code> if no generator is * set @@ -6810,7 +6810,7 @@ public class Grid extends AbstractComponent } /** - * Sets the style generator that is used for generating styles for rows + * Sets the style generator that is used for generating styles for rows. * * @param rowStyleGenerator * the row style generator to set, or <code>null</code> to remove @@ -6822,7 +6822,7 @@ public class Grid extends AbstractComponent } /** - * Gets the style generator that is used for generating styles for rows + * Gets the style generator that is used for generating styles for rows. * * @return the row style generator, or <code>null</code> if no generator is * set @@ -7258,7 +7258,7 @@ public class Grid extends AbstractComponent } /** - * Gets the error handler used for the editor + * Gets the error handler used for the editor. * * @see #setErrorHandler(com.vaadin.server.ErrorHandler) * @return the editor error handler, never null @@ -7400,7 +7400,7 @@ public class Grid extends AbstractComponent } /** - * Registers a new column visibility change listener + * Registers a new column visibility change listener. * * @since 7.5.0 * @param listener @@ -7413,7 +7413,7 @@ public class Grid extends AbstractComponent } /** - * Removes a previously registered column visibility change listener + * Removes a previously registered column visibility change listener. * * @since 7.5.0 * @param listener diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Label.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Label.java index ca00a8c7e4..4b8c8ebd6f 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Label.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Label.java @@ -329,7 +329,7 @@ public class Label extends AbstractLegacyComponent implements Property<String>, } /** - * Value change event + * Value change event. * * @author Vaadin Ltd. * @since 3.0 @@ -339,7 +339,7 @@ public class Label extends AbstractLegacyComponent implements Property<String>, implements Property.ValueChangeEvent { /** - * New instance of text change event + * New instance of text change event. * * @param source * the Source of the event. diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Slider.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Slider.java index 9777677e4c..62af89c602 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Slider.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Slider.java @@ -155,7 +155,7 @@ public class Slider extends AbstractField<Double> { } /** - * Gets the maximum slider value + * Gets the maximum slider value. * * @return the largest value the slider can have */ @@ -184,7 +184,7 @@ public class Slider extends AbstractField<Double> { } /** - * Gets the minimum slider value + * Gets the minimum slider value. * * @return the smallest value the slider can have */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Table.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Table.java index 9002f11c77..3c717ac954 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Table.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Table.java @@ -1016,7 +1016,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Gets the pixel width of column + * Gets the pixel width of column. * * @param propertyId * @return width of column or -1 when value not set @@ -1271,7 +1271,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Sets the column header for the specified column; + * Sets the column header for the specified column. * * @param propertyId * the propertyId identifying the column. @@ -1813,7 +1813,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Returns the cause(s) for this exception + * Returns the cause(s) for this exception. * * @return the exception(s) which caused this exception */ @@ -4132,7 +4132,7 @@ public class Table extends AbstractSelect implements Action.Container, /* Action container */ /** - * Registers a new action handler for this container + * Registers a new action handler for this container. * * @see com.vaadin.event.Action.Container#addActionHandler(Action.Handler) */ @@ -4185,7 +4185,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Removes all action handlers + * Removes all action handlers. */ public void removeAllActionHandlers() { actionHandlers = null; @@ -4245,7 +4245,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Notifies the component that it is detached from the application + * Notifies the component that it is detached from the application. * * @see Component#detach() */ @@ -5334,7 +5334,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Gets the property id of the column which header was pressed + * Gets the property id of the column which header was pressed. * * @return The column property id */ @@ -5369,7 +5369,7 @@ public class Table extends AbstractSelect implements Action.Container, private final Object columnPropertyId; /** - * Constructor + * Constructor. * * @param source * The source of the component @@ -5385,7 +5385,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Gets the property id of the column which header was pressed + * Gets the property id of the column which header was pressed. * * @return The column property id */ @@ -5402,7 +5402,7 @@ public class Table extends AbstractSelect implements Action.Container, public interface HeaderClickListener extends Serializable { /** - * Called when a user clicks a header column cell + * Called when a user clicks a header column cell. * * @param event * The event which contains information about the column and @@ -5419,7 +5419,7 @@ public class Table extends AbstractSelect implements Action.Container, public interface FooterClickListener extends Serializable { /** - * Called when a user clicks a footer column cell + * Called when a user clicks a footer column cell. * * @param event * The event which contains information about the column and @@ -5455,7 +5455,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Removes a header click listener + * Removes a header click listener. * * @param listener * The listener to remove. @@ -5501,7 +5501,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Removes a footer click listener + * Removes a footer click listener. * * @param listener * The listener to remove. @@ -5521,7 +5521,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Gets the footer caption beneath the rows + * Gets the footer caption beneath the rows. * * @param propertyId * The propertyId of the column * @@ -5602,7 +5602,7 @@ public class Table extends AbstractSelect implements Action.Container, private final Object columnPropertyId; /** - * Constructor + * Constructor. * * @param source * The source of the event @@ -5631,7 +5631,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Get the width in pixels of the column before the resize event + * Get the width in pixels of the column before the resize event. * * @return Width in pixels */ @@ -5640,7 +5640,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Get the width in pixels of the column after the resize event + * Get the width in pixels of the column after the resize event. * * @return Width in pixels */ @@ -5656,7 +5656,7 @@ public class Table extends AbstractSelect implements Action.Container, public interface ColumnResizeListener extends Serializable { /** - * This method is triggered when the column has been resized + * This method is triggered when the column has been resized. * * @param event * The event which contains the column property id, the @@ -5727,7 +5727,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Constructor + * Constructor. * * @param source * The source of the event @@ -5745,7 +5745,7 @@ public class Table extends AbstractSelect implements Action.Container, public interface ColumnReorderListener extends Serializable { /** - * This method is triggered when the column has been reordered + * This method is triggered when the column has been reordered. * * @param event */ @@ -5766,7 +5766,7 @@ public class Table extends AbstractSelect implements Action.Container, private Object propertyId; /** - * Constructor + * Constructor. * * @param source * The source of the event @@ -5779,7 +5779,7 @@ public class Table extends AbstractSelect implements Action.Container, } /** - * Gets the id of the column whose collapse state changed + * Gets the id of the column whose collapse state changed. * * @return the property id of the column */ @@ -5798,7 +5798,7 @@ public class Table extends AbstractSelect implements Action.Container, /** * This method is triggered when the collapse state for a column has - * changed + * changed. * * @param event */ @@ -5875,7 +5875,7 @@ public class Table extends AbstractSelect implements Action.Container, /** * Set the item description generator which generates tooltips for cells and - * rows in the Table + * rows in the Table. * * @param generator * The generator to use or null to disable @@ -5960,7 +5960,7 @@ public class Table extends AbstractSelect implements Action.Container, /** * Pass one String if spanColumns is used, one String for each visible - * column otherwise + * column otherwise. */ public void setText(String... text) { if (text == null || (text.length == 1 && text[0] == null)) { diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Tree.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Tree.java index 6a2da71bb7..2d6c1e521e 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Tree.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Tree.java @@ -292,7 +292,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, /* Expanding and collapsing */ /** - * Check is an item is expanded + * Check is an item is expanded. * * @param itemId * the item id. @@ -481,7 +481,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, } /** - * Sets the behavior of the multiselect mode + * Sets the behavior of the multiselect mode. * * @param mode * The mode to set @@ -1029,7 +1029,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, private final Object expandedItemId; /** - * New instance of options change event + * New instance of options change event. * * @param source * the Source of the event. @@ -1123,7 +1123,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, /* Collapse event */ /** - * Collapse event + * Collapse event. * * @author Vaadin Ltd. * @since 3.0 @@ -1272,7 +1272,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, } /** - * Removes all action handlers + * Removes all action handlers. */ public void removeAllActionHandlers() { actionHandlers = null; @@ -1758,7 +1758,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, /** * Constructs a criteria that accepts the drag if the targeted Item is a - * descendant of Item identified by given id + * descendant of Item identified by given id. * * @param parentItemId * the item identifier of the parent node @@ -1817,7 +1817,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, /** * Set the item description generator which generates tooltips for the tree - * items + * items. * * @param generator * The generator to use or null to disable @@ -1832,7 +1832,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical, /** * Get the item description generator which generates tooltips for tree - * items + * items. */ public ItemDescriptionGenerator getItemDescriptionGenerator() { return itemDescriptionGenerator; diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/Upload.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/Upload.java index a9a09ae49b..df95453a64 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/Upload.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/Upload.java @@ -623,7 +623,7 @@ public class Upload extends AbstractLegacyComponent } /** - * Listener for {@link ChangeEvent} + * Listener for {@link ChangeEvent}. * * @since 7.2 */ @@ -829,7 +829,7 @@ public class Upload extends AbstractLegacyComponent } /** - * Adds a filename change event listener + * Adds a filename change event listener. * * @param listener * the Listener to add, not null @@ -840,7 +840,7 @@ public class Upload extends AbstractLegacyComponent } /** - * Removes a filename change event listener + * Removes a filename change event listener. * * @param listener * the listener to be removed @@ -1048,7 +1048,7 @@ public class Upload extends AbstractLegacyComponent @Deprecated public interface ProgressListener extends Serializable { /** - * Updates progress to listener + * Updates progress to listener. * * @param readBytes * bytes transferred diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvent.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvent.java index a4b9901f22..afb2783552 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvent.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvent.java @@ -31,7 +31,7 @@ import com.vaadin.v7.ui.Calendar; public class CalendarComponentEvent extends Component.Event { /** - * Set the source of the event + * Set the source of the event. * * @param source * The source calendar diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvents.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvents.java index 0359c72272..f20cce2186 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvents.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvents.java @@ -37,7 +37,7 @@ import com.vaadin.v7.ui.components.calendar.event.CalendarEvent; public interface CalendarComponentEvents extends Serializable { /** - * Notifier interface for notifying listener of calendar events + * Notifier interface for notifying listener of calendar events. */ @Deprecated public interface CalendarEventNotifier extends Serializable { @@ -119,7 +119,7 @@ public interface CalendarComponentEvents extends Serializable { } /** - * Handler interface for when events are being dragged on the calendar + * Handler interface for when events are being dragged on the calendar. * */ @Deprecated @@ -526,7 +526,7 @@ public interface CalendarComponentEvents extends Serializable { } /** - * EventResize is sent when an event is resized + * EventResize is sent when an event is resized. */ @SuppressWarnings("serial") @Deprecated @@ -568,7 +568,7 @@ public interface CalendarComponentEvents extends Serializable { } /** - * Returns the updated start date/time of the event + * Returns the updated start date/time of the event. * * @return The new date for the event */ @@ -587,7 +587,7 @@ public interface CalendarComponentEvents extends Serializable { } /** - * Returns the updates end date/time of the event + * Returns the updates end date/time of the event. * * @return The new date for the event */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarDateRange.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarDateRange.java index ff93a84c35..293975db1b 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarDateRange.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarDateRange.java @@ -39,7 +39,7 @@ public class CalendarDateRange implements Serializable { private final transient TimeZone tz; /** - * Constructor + * Constructor. * * @param start * The start date and time of the date range @@ -54,7 +54,7 @@ public class CalendarDateRange implements Serializable { } /** - * Get the start date of the date range + * Get the start date of the date range. * * @return the start Date of the range */ @@ -63,7 +63,7 @@ public class CalendarDateRange implements Serializable { } /** - * Get the end date of the date range + * Get the end date of the date range. * * @return the end Date of the range */ @@ -72,7 +72,7 @@ public class CalendarDateRange implements Serializable { } /** - * Is a date in the date range + * Is a date in the date range. * * @param date * The date to check diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarTargetDetails.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarTargetDetails.java index 2f81ae3246..6575774c26 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarTargetDetails.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarTargetDetails.java @@ -53,7 +53,7 @@ public class CalendarTargetDetails extends TargetDetailsImpl { } /** - * Does the dropped item have a time associated with it + * Does the dropped item have a time associated with it. * * @param hasDropTime */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/ContainerEventProvider.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/ContainerEventProvider.java index ccaf1f60d5..7b7b409219 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/ContainerEventProvider.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/ContainerEventProvider.java @@ -112,7 +112,7 @@ public class ContainerEventProvider private Object allDayProperty = ALL_DAY_PROPERTY; /** - * Constructor + * Constructor. * * @param container * Container to use as a data source. @@ -123,7 +123,7 @@ public class ContainerEventProvider } /** - * Set the container data source + * Set the container data source. * * @param container * The container to use as datasource @@ -138,7 +138,7 @@ public class ContainerEventProvider } /** - * Returns the container used as data source + * Returns the container used as data source. * */ public Container.Indexed getContainerDataSource() { @@ -299,77 +299,77 @@ public class ContainerEventProvider } /** - * Get the property which provides the caption of the event + * Get the property which provides the caption of the event. */ public Object getCaptionProperty() { return captionProperty; } /** - * Set the property which provides the caption of the event + * Set the property which provides the caption of the event. */ public void setCaptionProperty(Object captionProperty) { this.captionProperty = captionProperty; } /** - * Get the property which provides the description of the event + * Get the property which provides the description of the event. */ public Object getDescriptionProperty() { return descriptionProperty; } /** - * Set the property which provides the description of the event + * Set the property which provides the description of the event. */ public void setDescriptionProperty(Object descriptionProperty) { this.descriptionProperty = descriptionProperty; } /** - * Get the property which provides the starting date and time of the event + * Get the property which provides the starting date and time of the event. */ public Object getStartDateProperty() { return startDateProperty; } /** - * Set the property which provides the starting date and time of the event + * Set the property which provides the starting date and time of the event. */ public void setStartDateProperty(Object startDateProperty) { this.startDateProperty = startDateProperty; } /** - * Get the property which provides the ending date and time of the event + * Get the property which provides the ending date and time of the event. */ public Object getEndDateProperty() { return endDateProperty; } /** - * Set the property which provides the ending date and time of the event + * Set the property which provides the ending date and time of the event. */ public void setEndDateProperty(Object endDateProperty) { this.endDateProperty = endDateProperty; } /** - * Get the property which provides the style name for the event + * Get the property which provides the style name for the event. */ public Object getStyleNameProperty() { return styleNameProperty; } /** - * Set the property which provides the style name for the event + * Set the property which provides the style name for the event. */ public void setStyleNameProperty(Object styleNameProperty) { this.styleNameProperty = styleNameProperty; } /** - * Set the all day property for the event + * Set the all day property for the event. * * @since 7.3.4 */ @@ -378,7 +378,7 @@ public class ContainerEventProvider } /** - * Get the all day property for the event + * Get the all day property for the event. * * @since 7.3.4 */ @@ -451,7 +451,7 @@ public class ContainerEventProvider * If you are reusing the container which previously have been attached to * this ContainerEventProvider call this method to remove this event * providers container listeners before attaching it to an other - * ContainerEventProvider + * ContainerEventProvider. */ public void detachContainerDataSource() { ignoreContainerEvents(); diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEvent.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEvent.java index 114e696058..c0384be12d 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEvent.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEvent.java @@ -43,14 +43,14 @@ public class BasicEvent implements EditableCalendarEvent, EventChangeNotifier { private boolean isAllDay; /** - * Default constructor + * Default constructor. */ public BasicEvent() { } /** - * Constructor for creating an event with the same start and end date + * Constructor for creating an event with the same start and end date. * * @param caption * The caption for the event diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEventProvider.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEventProvider.java index e84a8384f8..5df4939824 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEventProvider.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/BasicEventProvider.java @@ -81,7 +81,7 @@ public class BasicEventProvider implements CalendarEditableEventProvider, } /** - * Does this event provider container this event + * Does this event provider container this event. * * @param event * The event to check for diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEditableEventProvider.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEditableEventProvider.java index 6092fe2208..1fccbfe1ab 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEditableEventProvider.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEditableEventProvider.java @@ -17,7 +17,7 @@ package com.vaadin.v7.ui.components.calendar.event; /** - * An event provider which allows adding and removing events + * An event provider which allows adding and removing events. * * @since 7.1.0 * @author Vaadin Ltd. @@ -26,7 +26,7 @@ package com.vaadin.v7.ui.components.calendar.event; public interface CalendarEditableEventProvider extends CalendarEventProvider { /** - * Adds an event to the event provider + * Adds an event to the event provider. * * @param event * The event to add @@ -34,7 +34,7 @@ public interface CalendarEditableEventProvider extends CalendarEventProvider { void addEvent(CalendarEvent event); /** - * Removes an event from the event provider + * Removes an event from the event provider. * * @param event * The event diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEventProvider.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEventProvider.java index 831b6c1731..70b4c4bb40 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEventProvider.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/CalendarEventProvider.java @@ -106,7 +106,8 @@ public interface CalendarEventProvider extends Serializable { void addEventSetChangeListener(EventSetChangeListener listener); /** - * Remove a listener which listens to {@link EventSetChangeEvent}-events + * Remove a listener which listens to + * {@link EventSetChangeEvent}-events. * * @param listener * The listener to remove diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/EditableCalendarEvent.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/EditableCalendarEvent.java index eb7d12a058..0aa90ebe81 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/EditableCalendarEvent.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/event/EditableCalendarEvent.java @@ -72,7 +72,7 @@ public interface EditableCalendarEvent extends CalendarEvent { void setStart(Date start); /** - * Set the style name for the event used for styling the event cells + * Set the style name for the event used for styling the event cells. * * @param styleName * The stylename to use @@ -81,7 +81,7 @@ public interface EditableCalendarEvent extends CalendarEvent { void setStyleName(String styleName); /** - * Does the event span the whole day. If so then set this to true + * Does the event span the whole day. If so then set this to true. * * @param isAllDay * True if the event spans the whole day. In this case the start diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicBackwardHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicBackwardHandler.java index 7d8206c8f5..2a770204d1 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicBackwardHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicBackwardHandler.java @@ -81,7 +81,7 @@ public class BasicBackwardHandler implements BackwardHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicDateClickHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicDateClickHandler.java index d90d94d774..eca2a31815 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicDateClickHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicDateClickHandler.java @@ -55,7 +55,7 @@ public class BasicDateClickHandler implements DateClickHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventMoveHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventMoveHandler.java index cb1422d90b..3893450c24 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventMoveHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventMoveHandler.java @@ -59,7 +59,7 @@ public class BasicEventMoveHandler implements EventMoveHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventResizeHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventResizeHandler.java index 5a722e9365..d4ac3ae9a2 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventResizeHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicEventResizeHandler.java @@ -55,7 +55,7 @@ public class BasicEventResizeHandler implements EventResizeHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicForwardHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicForwardHandler.java index b354a7cdae..abeb19840c 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicForwardHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicForwardHandler.java @@ -79,7 +79,7 @@ public class BasicForwardHandler implements ForwardHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicWeekClickHandler.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicWeekClickHandler.java index 7827127973..ec7e1bf9e3 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicWeekClickHandler.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/handler/BasicWeekClickHandler.java @@ -66,7 +66,7 @@ public class BasicWeekClickHandler implements WeekClickHandler { } /** - * Set the start and end dates for the event + * Set the start and end dates for the event. * * @param event * The event that the start and end dates should be set diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGradient.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGradient.java index 6dab06e69b..e479fe7ac8 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGradient.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGradient.java @@ -29,8 +29,8 @@ import com.vaadin.v7.ui.AbstractColorPicker.Coordinates2Color; * @since 7.0.0 */ @Deprecated -public class ColorPickerGradient extends AbstractComponent implements - ColorSelector { +public class ColorPickerGradient extends AbstractComponent + implements ColorSelector { private static final Method COLOR_CHANGE_METHOD; static { @@ -129,7 +129,7 @@ public class ColorPickerGradient extends AbstractComponent implements } /** - * Notifies the listeners that the color has changed + * Notifies the listeners that the color has changed. * * @param color * The color which it changed to diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGrid.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGrid.java index 4b96f0de12..0326f1e224 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGrid.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerGrid.java @@ -202,7 +202,7 @@ public class ColorPickerGrid extends AbstractComponent } /** - * Adds a color change listener + * Adds a color change listener. * * @param listener * The color change listener @@ -218,7 +218,7 @@ public class ColorPickerGrid extends AbstractComponent } /** - * Removes a color change listener + * Removes a color change listener. * * @param listener * The listener @@ -261,7 +261,7 @@ public class ColorPickerGrid extends AbstractComponent } /** - * Notifies the listeners that a color change has occurred + * Notifies the listeners that a color change has occurred. * * @param color * The color which it changed to diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerHistory.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerHistory.java index 0cab53c13e..5f4161ccab 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerHistory.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerHistory.java @@ -183,7 +183,7 @@ public class ColorPickerHistory extends CustomComponent } /** - * Adds a color change listener + * Adds a color change listener. * * @param listener * The listener @@ -194,7 +194,7 @@ public class ColorPickerHistory extends CustomComponent } /** - * Removes a color change listener + * Removes a color change listener. * * @param listener * The listener diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPopup.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPopup.java index 71d8ef7a2c..5ce6295d87 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPopup.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPopup.java @@ -490,7 +490,7 @@ public class ColorPickerPopup extends Window } /** - * Notifies the listeners that the color changed + * Notifies the listeners that the color changed. */ public void fireColorChanged() { fireEvent(new ColorChangeEvent(this, getColor())); @@ -627,7 +627,7 @@ public class ColorPickerPopup extends Window } /** - * Set RGB tab visibility + * Set RGB tab visibility. * * @param visible * The visibility of the RGB tab @@ -643,7 +643,7 @@ public class ColorPickerPopup extends Window } /** - * Set HSV tab visibility + * Set HSV tab visibility. * * @param visible * The visibility of the HSV tab @@ -659,7 +659,7 @@ public class ColorPickerPopup extends Window } /** - * Set Swatches tab visibility + * Set Swatches tab visibility. * * @param visible * The visibility of the Swatches tab @@ -675,7 +675,7 @@ public class ColorPickerPopup extends Window } /** - * Set the History visibility + * Set the History visibility. * * @param visible */ @@ -685,7 +685,7 @@ public class ColorPickerPopup extends Window } /** - * Set the preview visibility + * Set the preview visibility. * * @param visible */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPreview.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPreview.java index ba4ba7e82f..bcdf11b3c9 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPreview.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/components/colorpicker/ColorPickerPreview.java @@ -189,7 +189,7 @@ public class ColorPickerPreview extends CssLayout } /** - * Called when the component is refreshing + * Called when the component is refreshing. */ @Override protected String getCss(Component c) { diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/ProgressBarRenderer.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/ProgressBarRenderer.java index 76210bf3bc..470eb9ee3c 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/ProgressBarRenderer.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/ProgressBarRenderer.java @@ -29,7 +29,7 @@ import elemental.json.JsonValue; public class ProgressBarRenderer extends AbstractRenderer<Double> { /** - * Creates a new text renderer + * Creates a new text renderer. */ public ProgressBarRenderer() { super(Double.class, null); diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/TextRenderer.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/TextRenderer.java index 4103e15193..67ae687b1a 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/TextRenderer.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/renderers/TextRenderer.java @@ -27,14 +27,14 @@ import com.vaadin.v7.ui.Grid.AbstractRenderer; public class TextRenderer extends AbstractRenderer<String> { /** - * Creates a new text renderer + * Creates a new text renderer. */ public TextRenderer() { this(""); } /** - * Creates a new text renderer + * Creates a new text renderer. * * @param nullRepresentation * the textual representation of {@code null} value diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/ChameleonTheme.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/ChameleonTheme.java index fabba1a6f9..bc6ba5c0ee 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/ChameleonTheme.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/ChameleonTheme.java @@ -18,8 +18,9 @@ package com.vaadin.v7.ui.themes; import com.vaadin.ui.themes.ValoTheme; /** - * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is supported. -*/ + * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is + * supported. + */ @Deprecated public class ChameleonTheme extends BaseTheme { @@ -30,32 +31,32 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Large font for main application headings + * Large font for main application headings. */ public static final String LABEL_H1 = "h1"; /** - * Large font for different sections in the application + * Large font for different sections in the application. */ public static final String LABEL_H2 = "h2"; /** - * Font for sub-section headers + * Font for sub-section headers. */ public static final String LABEL_H3 = "h3"; /** - * Font for paragraphs headers + * Font for paragraphs headers. */ public static final String LABEL_H4 = "h4"; /** - * Big font for important or emphasized texts + * Big font for important or emphasized texts. */ public static final String LABEL_BIG = "big"; /** - * Small and a little lighter font + * Small and a little lighter font. */ public static final String LABEL_SMALL = "small"; @@ -67,22 +68,23 @@ public class ChameleonTheme extends BaseTheme { public static final String LABEL_TINY = "tiny"; /** - * Adds color to the text (usually the alternate color of the theme) + * Adds color to the text (usually the alternate color of the theme). */ public static final String LABEL_COLOR = "color"; /** - * Adds a warning icon on the left side and a yellow background to the label + * Adds a warning icon on the left side and a yellow background to the + * label. */ public static final String LABEL_WARNING = "warning"; /** - * Adds an error icon on the left side and a red background to the label + * Adds an error icon on the left side and a red background to the label. */ public static final String LABEL_ERROR = "error"; /** - * Adds a spinner icon on the left side of the label + * Adds a spinner icon on the left side of the label. */ public static final String LABEL_LOADING = "loading"; @@ -98,12 +100,12 @@ public class ChameleonTheme extends BaseTheme { public static final String BUTTON_DEFAULT = "default"; /** - * Small sized button, use for context specific actions for example + * Small sized button, use for context specific actions for example. */ public static final String BUTTON_SMALL = "small"; /** - * Big button, use to get more attention for the button action + * Big button, use to get more attention for the button action. */ public static final String BUTTON_BIG = "big"; @@ -138,7 +140,7 @@ public class ChameleonTheme extends BaseTheme { public static final String BUTTON_ICON_ON_RIGHT = "icon-on-right"; /** - * Removes the button caption and only shows its icon + * Removes the button caption and only shows its icon. */ public static final String BUTTON_ICON_ONLY = "icon-only"; @@ -153,17 +155,17 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Small sized text field with small font + * Small sized text field with small font. */ public static final String TEXTFIELD_SMALL = "small"; /** - * Large sized text field with big font + * Large sized text field with big font. */ public static final String TEXTFIELD_BIG = "big"; /** - * Adds a magnifier icon on the left side of the fields text + * Adds a magnifier icon on the left side of the fields text. */ public static final String TEXTFIELD_SEARCH = "search"; @@ -172,22 +174,22 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Small sized select with small font + * Small sized select with small font. */ public static final String SELECT_SMALL = "small"; /** - * Large sized select with big font + * Large sized select with big font. */ public static final String SELECT_BIG = "big"; /** - * Adds a magnifier icon on the left side of the fields text + * Adds a magnifier icon on the left side of the fields text. */ public static final String COMBOBOX_SEARCH = "search"; /** - * Adds a magnifier icon on the left side of the fields text + * Adds a magnifier icon on the left side of the fields text. */ public static final String COMBOBOX_SELECT_BUTTON = "select-button"; @@ -196,12 +198,12 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Small sized date field with small font + * Small sized date field with small font. */ public static final String DATEFIELD_SMALL = "small"; /** - * Large sized date field with big font + * Large sized date field with big font. */ public static final String DATEFIELD_BIG = "big"; @@ -210,19 +212,19 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Removes borders and background color from the panel + * Removes borders and background color from the panel. */ public static final String PANEL_BORDERLESS = "borderless"; /** * Adds a more vibrant header for the panel, using the alternate color of * the theme, and adds slight rounded corners (not supported in all - * browsers) + * browsers). */ public static final String PANEL_BUBBLE = "bubble"; /** - * Removes borders and background color from the panel + * Removes borders and background color from the panel. */ public static final String PANEL_LIGHT = "light"; @@ -231,7 +233,7 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Reduces the split handle to a minimal size (1 pixel) + * Reduces the split handle to a minimal size (1 pixel). */ public static final String SPLITPANEL_SMALL = "small"; @@ -240,7 +242,7 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Removes borders and background color from the tab sheet + * Removes borders and background color from the tab sheet. */ public static final String TABSHEET_BORDERLESS = "borderless"; @@ -249,7 +251,7 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Makes the accordion background opaque (non-transparent) + * Makes the accordion background opaque (non-transparent). */ public static final String ACCORDION_OPAQUE = "opaque"; @@ -258,17 +260,17 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Removes borders and background color from the table + * Removes borders and background color from the table. */ public static final String TABLE_BORDERLESS = "borderless"; /** - * Makes the column header and content font size smaller inside the table + * Makes the column header and content font size smaller inside the table. */ public static final String TABLE_SMALL = "small"; /** - * Makes the column header and content font size bigger inside the table + * Makes the column header and content font size bigger inside the table. */ public static final String TABLE_BIG = "big"; @@ -282,7 +284,7 @@ public class ChameleonTheme extends BaseTheme { **************************************************************************/ /** - * Reduces the height of the progress bar + * Reduces the height of the progress bar. */ public static final String PROGRESS_INDICATOR_SMALL = "small"; diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Reindeer.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Reindeer.java index 2d288a66d9..8e700fe0a4 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Reindeer.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Reindeer.java @@ -24,7 +24,8 @@ import com.vaadin.ui.VerticalSplitPanel; import com.vaadin.ui.themes.ValoTheme; /** - * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is supported. + * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is + * supported. */ @Deprecated public class Reindeer extends BaseTheme { @@ -38,17 +39,17 @@ public class Reindeer extends BaseTheme { **************************************************************************/ /** - * Large font for main application headings + * Large font for main application headings. */ public static final String LABEL_H1 = "h1"; /** - * Large font for different sections in the application + * Large font for different sections in the application. */ public static final String LABEL_H2 = "h2"; /** - * Small and a little lighter font + * Small and a little lighter font. */ public static final String LABEL_SMALL = "light"; @@ -66,7 +67,7 @@ public class Reindeer extends BaseTheme { public static final String BUTTON_DEFAULT = "primary"; /** - * Small sized button, use for context specific actions for example + * Small sized button, use for context specific actions for example. */ public static final String BUTTON_SMALL = "small"; @@ -77,7 +78,7 @@ public class Reindeer extends BaseTheme { **************************************************************************/ /** - * Small sized text field with small font + * Small sized text field with small font. */ public static final String TEXTFIELD_SMALL = "small"; @@ -88,7 +89,7 @@ public class Reindeer extends BaseTheme { **************************************************************************/ /** - * Removes borders and background color from the panel + * Removes borders and background color from the panel. */ public static final String PANEL_LIGHT = "light"; @@ -111,7 +112,7 @@ public class Reindeer extends BaseTheme { **************************************************************************/ /** - * Reduces the split handle to a minimal size (1 pixel) + * Reduces the split handle to a minimal size (1 pixel). */ public static final String SPLITPANEL_SMALL = "small"; @@ -156,7 +157,7 @@ public class Reindeer extends BaseTheme { **************************************************************************/ /** - * Removes borders from the table + * Removes borders from the table. */ public static final String TABLE_BORDERLESS = "borderless"; @@ -173,8 +174,9 @@ public class Reindeer extends BaseTheme { /** * Changes the background of a layout to white. Applies to - * {@link VerticalLayout}, {@link HorizontalLayout}, {@link com.vaadin.ui.GridLayout GridLayout}, - * {@link FormLayout}, {@link CssLayout}, {@link VerticalSplitPanel} and + * {@link VerticalLayout}, {@link HorizontalLayout}, + * {@link com.vaadin.ui.GridLayout GridLayout}, {@link FormLayout}, + * {@link CssLayout}, {@link VerticalSplitPanel} and * {@link HorizontalSplitPanel}. * <p> * <em>Does not revert any contained components back to normal if some @@ -184,8 +186,9 @@ public class Reindeer extends BaseTheme { /** * Changes the background of a layout to a shade of blue. Applies to - * {@link VerticalLayout}, {@link HorizontalLayout}, {@link com.vaadin.ui.GridLayout GridLayout}, - * {@link FormLayout}, {@link CssLayout}, {@link VerticalSplitPanel} and + * {@link VerticalLayout}, {@link HorizontalLayout}, + * {@link com.vaadin.ui.GridLayout GridLayout}, {@link FormLayout}, + * {@link CssLayout}, {@link VerticalSplitPanel} and * {@link HorizontalSplitPanel}. * <p> * <em>Does not revert any contained components back to normal if some @@ -202,7 +205,8 @@ public class Reindeer extends BaseTheme { * </p> * <p> * Applies to {@link VerticalLayout}, {@link HorizontalLayout}, - * {@link com.vaadin.ui.GridLayout GridLayout}, {@link FormLayout} and {@link CssLayout}. + * {@link com.vaadin.ui.GridLayout GridLayout}, {@link FormLayout} and + * {@link CssLayout}. * </p> * */ diff --git a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Runo.java b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Runo.java index 1ab1d3b7fe..727b44ce37 100644 --- a/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Runo.java +++ b/compatibility-server/src/main/java/com/vaadin/v7/ui/themes/Runo.java @@ -18,7 +18,8 @@ package com.vaadin.v7.ui.themes; import com.vaadin.ui.themes.ValoTheme; /** - * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is supported. + * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is + * supported. */ @Deprecated public class Runo extends BaseTheme { @@ -36,12 +37,13 @@ public class Runo extends BaseTheme { **************************************************************************/ /** - * Small sized button, use for context specific actions for example + * Small sized button, use for context specific actions for example. */ public static final String BUTTON_SMALL = "small"; /** - * Big sized button, use to gather much attention for some particular action + * Big sized button, use to gather much attention for some particular + * action. */ public static final String BUTTON_BIG = "big"; @@ -59,7 +61,7 @@ public class Runo extends BaseTheme { **************************************************************************/ /** - * Removes borders and background color from the panel + * Removes borders and background color from the panel. */ public static final String PANEL_LIGHT = "light"; @@ -82,7 +84,7 @@ public class Runo extends BaseTheme { **************************************************************************/ /** - * Smaller tabs, no border and background for content area + * Smaller tabs, no border and background for content area. */ public static final String TABSHEET_SMALL = "light"; @@ -165,7 +167,7 @@ public class Runo extends BaseTheme { **************************************************************************/ /** - * Small sized text field with small font + * Small sized text field with small font. */ public static final String TEXTFIELD_SMALL = "small"; diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/datefield/Resolution.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/datefield/Resolution.java index 3d75c48006..69b80239c7 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/datefield/Resolution.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/datefield/Resolution.java @@ -15,20 +15,22 @@ */ package com.vaadin.v7.shared.ui.datefield; -import com.vaadin.shared.ui.datefield.DateResolution; -import com.vaadin.shared.ui.datefield.DateTimeResolution; - import java.util.ArrayList; import java.util.List; +import com.vaadin.shared.ui.datefield.DateResolution; +import com.vaadin.shared.ui.datefield.DateTimeResolution; + /** - * Resolutions for DateFields + * Resolutions for DateFields. * * @author Vaadin Ltd. * @since 7.0 * - * @deprecated As of 8.0, replaced by {@link DateResolution} and {@link DateTimeResolution}, - * used by new {@code com.vaadin.ui.DateField} and {@code com.vaadin.ui.DateTimeField} + * @deprecated As of 8.0, replaced by {@link DateResolution} and + * {@link DateTimeResolution}, used by new + * {@code com.vaadin.ui.DateField} and + * {@code com.vaadin.ui.DateTimeField} */ public enum Resolution { // Values from Calendar.SECOND etc. Set as ints to avoid Calendar dependency diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/ColumnGroupState.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/ColumnGroupState.java index f3751f449a..00ed95d9f5 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/ColumnGroupState.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/ColumnGroupState.java @@ -21,7 +21,7 @@ import java.util.ArrayList; import java.util.List; /** - * The column group data shared between the server and the client + * The column group data shared between the server and the client. * * @since 7.4 * @author Vaadin Ltd @@ -29,17 +29,17 @@ import java.util.List; public class ColumnGroupState implements Serializable { /** - * The columns that is included in the group + * The columns that is included in the group. */ public List<String> columns = new ArrayList<String>(); /** - * The header text of the group + * The header text of the group. */ public String header; /** - * The footer text of the group + * The footer text of the group. */ public String footer; } diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/DetailsConnectorChange.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/DetailsConnectorChange.java index 877a558563..22d57eb1a2 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/DetailsConnectorChange.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/DetailsConnectorChange.java @@ -49,7 +49,7 @@ public class DetailsConnectorChange implements Serializable { private Integer newIndex; private boolean shouldStillBeVisible; - /** Create a new connector index change */ + /** Create a new connector index change. */ public DetailsConnectorChange() { } @@ -143,7 +143,7 @@ public class DetailsConnectorChange implements Serializable { } /** - * Sets the old index + * Sets the old index. * * @param oldIndex * the old index. May be <code>null</code> if a new connector is @@ -154,7 +154,7 @@ public class DetailsConnectorChange implements Serializable { } /** - * Sets the new index + * Sets the new index. * * @param newIndex * the new index. May be <code>null</code> if a connector is diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridColumnState.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridColumnState.java index b1bf1844e6..07be704bd8 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridColumnState.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridColumnState.java @@ -21,7 +21,7 @@ import com.vaadin.shared.Connector; /** * Column state DTO for transferring column properties from the server to the - * client + * client. * * @since 7.4 * @author Vaadin Ltd @@ -30,7 +30,7 @@ public class GridColumnState implements Serializable { /** * Id used by grid connector to map server side column with client side - * column + * column. */ public String id; @@ -58,7 +58,7 @@ public class GridColumnState implements Serializable { public Connector editorConnector; /** - * Whether this column is sortable by the user + * Whether this column is sortable by the user. */ public boolean sortable = false; @@ -86,7 +86,7 @@ public class GridColumnState implements Serializable { /** The caption for the column hiding toggle. */ public String hidingToggleCaption; - /** Column header caption */ + /** Column header caption. */ public String headerCaption; /** Whether this column is resizable by the user. */ diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridConstants.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridConstants.java index dc9b2207e5..8d9b607f6c 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridConstants.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridConstants.java @@ -74,28 +74,28 @@ public final class GridConstants implements Serializable { public static final double DEFAULT_COLUMN_WIDTH_PX = -1; /** - * Event ID for item click events + * Event ID for item click events. */ public static final String ITEM_CLICK_EVENT_ID = "itemClick"; - /** The default save button caption in the editor */ + /** The default save button caption in the editor. */ public static final String DEFAULT_SAVE_CAPTION = "Save"; - /** The default cancel button caption in the editor */ + /** The default cancel button caption in the editor. */ public static final String DEFAULT_CANCEL_CAPTION = "Cancel"; /** - * Event ID constant for editor open event + * Event ID constant for editor open event. */ public static final String EDITOR_OPEN_EVENT_ID = "editorOpen"; /** - * Event ID constant for editor move event + * Event ID constant for editor move event. */ public static final String EDITOR_MOVE_EVENT_ID = "editorMove"; /** - * Event ID constant for editor close event + * Event ID constant for editor close event. */ public static final String EDITOR_CLOSE_EVENT_ID = "editorClose"; } diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridServerRpc.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridServerRpc.java index 7fcf461244..b50f37bae4 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridServerRpc.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridServerRpc.java @@ -23,7 +23,7 @@ import com.vaadin.shared.data.sort.SortDirection; import com.vaadin.v7.shared.ui.grid.GridConstants.Section; /** - * Client-to-server RPC interface for the Grid component + * Client-to-server RPC interface for the Grid component. * * @since 7.4 * @author Vaadin Ltd diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridState.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridState.java index c333ed0d55..cfefce4326 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridState.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridState.java @@ -24,7 +24,8 @@ import com.vaadin.shared.data.sort.SortDirection; import com.vaadin.shared.ui.TabIndexState; /** - * The shared state for the {@link com.vaadin.ui.components.grid.Grid} component + * The shared state for the {@link com.vaadin.ui.components.grid.Grid} + * component. * * @since 7.4 * @author Vaadin Ltd @@ -43,7 +44,7 @@ public class GridState extends TabIndexState { */ public enum SharedSelectionMode { /** - * Representation of a single selection mode + * Representation of a single selection mode. * * @see com.vaadin.ui.components.grid.Grid.SelectionMode#SINGLE * @see com.vaadin.client.ui.grid.Grid.SelectionMode#SINGLE @@ -51,7 +52,7 @@ public class GridState extends TabIndexState { SINGLE, /** - * Representation of a multiselection mode + * Representation of a multiselection mode. * * @see com.vaadin.ui.components.grid.Grid.SelectionMode#MULTI * @see com.vaadin.client.ui.grid.Grid.SelectionMode#MULTI @@ -59,7 +60,7 @@ public class GridState extends TabIndexState { MULTI, /** - * Representation of a no-selection mode + * Representation of a no-selection mode. * * @see com.vaadin.ui.components.grid.Grid.SelectionMode#NONE * @see com.vaadin.client.ui.grid.Grid.SelectionMode#NONE @@ -70,40 +71,40 @@ public class GridState extends TabIndexState { /** * The default value for height-by-rows for both GWT widgets * {@link com.vaadin.ui.components.grid Grid} and - * {@link com.vaadin.client.ui.grid.Escalator Escalator} + * {@link com.vaadin.client.ui.grid.Escalator Escalator}. */ public static final double DEFAULT_HEIGHT_BY_ROWS = 10.0d; /** - * The key in which a row's data can be found + * The key in which a row's data can be found. * * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) */ public static final String JSONKEY_DATA = "d"; /** - * The key in which a row's own key can be found + * The key in which a row's own key can be found. * * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) */ public static final String JSONKEY_ROWKEY = "k"; /** - * The key in which a row's generated style can be found + * The key in which a row's generated style can be found. * * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) */ public static final String JSONKEY_ROWSTYLE = "rs"; /** - * The key in which a generated styles for a row's cells can be found + * The key in which a generated styles for a row's cells can be found. * * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) */ public static final String JSONKEY_CELLSTYLES = "cs"; /** - * The key in which a row's description can be found + * The key in which a row's description can be found. * * @since 7.6 * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) @@ -111,7 +112,7 @@ public class GridState extends TabIndexState { public static final String JSONKEY_ROWDESCRIPTION = "rd"; /** - * The key in which a cell's description can be found + * The key in which a cell's description can be found. * * @since 7.6 * @see com.vaadin.shared.data.DataProviderRpc#setRowData(int, String) @@ -162,7 +163,7 @@ public class GridState extends TabIndexState { public GridStaticSectionState footer = new GridStaticSectionState(); - /** The number of frozen columns */ + /** The number of frozen columns. */ public int frozenColumnCount = 0; /** The height of the Grid in terms of body rows. */ @@ -173,17 +174,17 @@ public class GridState extends TabIndexState { @DelegateToWidget public HeightMode heightMode = HeightMode.CSS; - /** Keys of the currently sorted columns */ + /** Keys of the currently sorted columns. */ public String[] sortColumns = new String[0]; - /** Directions for each sorted column */ + /** Directions for each sorted column. */ public SortDirection[] sortDirs = new SortDirection[0]; - /** The enabled state of the editor interface */ + /** The enabled state of the editor interface. */ public boolean editorEnabled = false; /** - * Buffered editor mode + * Buffered editor mode. * * @since 7.6 */ @@ -191,21 +192,21 @@ public class GridState extends TabIndexState { public boolean editorBuffered = true; /** - * Whether rows and/or cells have generated descriptions (tooltips) + * Whether rows and/or cells have generated descriptions (tooltips). * * @since 7.6 */ public boolean hasDescriptions; - /** The caption for the save button in the editor */ + /** The caption for the save button in the editor. */ @DelegateToWidget public String editorSaveCaption = GridConstants.DEFAULT_SAVE_CAPTION; - /** The caption for the cancel button in the editor */ + /** The caption for the cancel button in the editor. */ @DelegateToWidget public String editorCancelCaption = GridConstants.DEFAULT_CANCEL_CAPTION; - /** Whether the columns can be reordered */ + /** Whether the columns can be reordered. */ @DelegateToWidget public boolean columnReorderingAllowed; diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridStaticCellType.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridStaticCellType.java index 70da93f573..3cac591be1 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridStaticCellType.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/grid/GridStaticCellType.java @@ -23,17 +23,17 @@ package com.vaadin.v7.shared.ui.grid; */ public enum GridStaticCellType { /** - * Text content + * Text content. */ TEXT, /** - * HTML content + * HTML content. */ HTML, /** - * Widget content + * Widget content. */ WIDGET; } diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/progressindicator/ProgressBarState.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/progressindicator/ProgressBarState.java index a9a98e3395..b23600de02 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/progressindicator/ProgressBarState.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/progressindicator/ProgressBarState.java @@ -21,7 +21,7 @@ import com.vaadin.shared.communication.SharedState; import com.vaadin.v7.shared.AbstractFieldState; /** - * {@link SharedState} for {@link com.vaadin.ui.ProgressBar} + * {@link SharedState} for {@link com.vaadin.ui.ProgressBar}. * * @since 7.1 * @author Vaadin Ltd diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/table/TableServerRpc.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/table/TableServerRpc.java index 18ba4e69e9..5db25da871 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/table/TableServerRpc.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/table/TableServerRpc.java @@ -20,7 +20,7 @@ import com.vaadin.shared.communication.ServerRpc; import com.vaadin.v7.shared.ui.table.TableConstants.Section; /** - * Client-to-server RPC interface for the Table component + * Client-to-server RPC interface for the Table component. * * @since 7.6 * @author Vaadin Ltd @@ -28,7 +28,7 @@ import com.vaadin.v7.shared.ui.table.TableConstants.Section; public interface TableServerRpc extends ServerRpc { /** - * Informs the server that a context click happened inside of Table + * Informs the server that a context click happened inside of Table. */ public void contextClick(String rowKey, String colKey, Section section, MouseEventDetails details); diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/textfield/AbstractTextFieldState.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/textfield/AbstractTextFieldState.java index c74684d19a..f8b54a0b84 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/textfield/AbstractTextFieldState.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/textfield/AbstractTextFieldState.java @@ -42,7 +42,7 @@ public class AbstractTextFieldState extends AbstractFieldState { public String inputPrompt = null; /** - * The text in the field + * The text in the field. */ @NoLayout public String text = null; diff --git a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/tree/TreeServerRpc.java b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/tree/TreeServerRpc.java index 23587a43e8..5d391d3912 100644 --- a/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/tree/TreeServerRpc.java +++ b/compatibility-shared/src/main/java/com/vaadin/v7/shared/ui/tree/TreeServerRpc.java @@ -19,7 +19,7 @@ import com.vaadin.shared.MouseEventDetails; import com.vaadin.shared.communication.ServerRpc; /** - * Client-to-server RPC interface for the Tree component + * Client-to-server RPC interface for the Tree component. * * @since 7.6 * @author Vaadin Ltd @@ -27,8 +27,8 @@ import com.vaadin.shared.communication.ServerRpc; public interface TreeServerRpc extends ServerRpc { /** - * Informs the server that a context click happened inside of Tree + * Informs the server that a context click happened inside of Tree. */ public void contextClick(String rowKey, MouseEventDetails details); -}
\ No newline at end of file +} diff --git a/server/src/main/java/com/vaadin/data/Binder.java b/server/src/main/java/com/vaadin/data/Binder.java index d09a6c1665..2d1f685181 100644 --- a/server/src/main/java/com/vaadin/data/Binder.java +++ b/server/src/main/java/com/vaadin/data/Binder.java @@ -139,7 +139,7 @@ public class Binder<BEAN> implements Serializable { /** * Unbinds the binding from its respective {@code Binder} Removes any * {@code ValueChangeListener} {@code Registration} from associated - * {@code HasValue} + * {@code HasValue}. * * @since 8.2 */ @@ -853,7 +853,7 @@ public class Binder<BEAN> implements Serializable { /** * Removes this binding from its binder and unregisters the - * {@code ValueChangeListener} from any bound {@code HasValue} + * {@code ValueChangeListener} from any bound {@code HasValue}. * * @since 8.2 */ diff --git a/server/src/main/java/com/vaadin/data/provider/DataCommunicator.java b/server/src/main/java/com/vaadin/data/provider/DataCommunicator.java index aba50226f7..9996d8d1aa 100644 --- a/server/src/main/java/com/vaadin/data/provider/DataCommunicator.java +++ b/server/src/main/java/com/vaadin/data/provider/DataCommunicator.java @@ -587,15 +587,18 @@ public class DataCommunicator<T> extends AbstractExtension { * <p> * This method is called from the constructor. * - * @param identifierGetter has to return a unique key for every bean, and the returned key has to - * follow general {@code hashCode()} and {@code equals()} contract, - * see {@link Object#hashCode()} for details. + * @param identifierGetter + * has to return a unique key for every bean, and the returned + * key has to follow general {@code hashCode()} and + * {@code equals()} contract, see {@link Object#hashCode()} for + * details. * @return key mapper * * @since 8.1 * */ - protected DataKeyMapper<T> createKeyMapper(ValueProvider<T, Object> identifierGetter) { + protected DataKeyMapper<T> createKeyMapper( + ValueProvider<T, Object> identifierGetter) { return new KeyMapper<T>(identifierGetter); } @@ -781,7 +784,8 @@ public class DataCommunicator<T> extends AbstractExtension { } /** - * Sets a new {@code DataProvider} and refreshes all the internal structures + * Sets a new {@code DataProvider} and refreshes all the internal + * structures. * * @param dataProvider * @since 8.1 diff --git a/server/src/main/java/com/vaadin/data/provider/DataKeyMapper.java b/server/src/main/java/com/vaadin/data/provider/DataKeyMapper.java index 6db4a491fe..c437c2bae2 100644 --- a/server/src/main/java/com/vaadin/data/provider/DataKeyMapper.java +++ b/server/src/main/java/com/vaadin/data/provider/DataKeyMapper.java @@ -86,11 +86,13 @@ public interface DataKeyMapper<T> extends Serializable { void refresh(T dataObject); /** - * Takes identifier getter into use and updates existing mappings + * Takes identifier getter into use and updates existing mappings. * - * @param identifierGetter has to return a unique key for every bean, and the returned key has to - * follow general {@code hashCode()} and {@code equals()} contract, - * see {@link Object#hashCode()} for details. + * @param identifierGetter + * has to return a unique key for every bean, and the returned + * key has to follow general {@code hashCode()} and + * {@code equals()} contract, see {@link Object#hashCode()} for + * details. * @since 8.1 */ void setIdentifierGetter(ValueProvider<T, Object> identifierGetter); 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 f806def6d1..a37677a3f6 100644 --- a/server/src/main/java/com/vaadin/data/provider/SortOrder.java +++ b/server/src/main/java/com/vaadin/data/provider/SortOrder.java @@ -33,7 +33,7 @@ public class SortOrder<T> implements Serializable { private final SortDirection direction; /** - * Constructs a field sorting information + * Constructs a field sorting information. * * @param sorted * sorting information, usually field id or @@ -47,7 +47,7 @@ public class SortOrder<T> implements Serializable { } /** - * Sorting information + * Sorting information. * * @return sorting entity, usually field id or {@link java.util.Comparator} */ @@ -56,7 +56,7 @@ public class SortOrder<T> implements Serializable { } /** - * Sorting direction + * Sorting direction. * * @return sorting direction */ diff --git a/server/src/main/java/com/vaadin/event/Action.java b/server/src/main/java/com/vaadin/event/Action.java index fceea66a5b..3779ab0756 100644 --- a/server/src/main/java/com/vaadin/event/Action.java +++ b/server/src/main/java/com/vaadin/event/Action.java @@ -178,7 +178,7 @@ public class Action implements Serializable { public interface Container extends Serializable { /** - * Registers a new action handler for this container + * Registers a new action handler for this container. * * @param actionHandler * the new handler to be added. diff --git a/server/src/main/java/com/vaadin/event/ActionManager.java b/server/src/main/java/com/vaadin/event/ActionManager.java index fbc5c8411f..b9e493bce6 100644 --- a/server/src/main/java/com/vaadin/event/ActionManager.java +++ b/server/src/main/java/com/vaadin/event/ActionManager.java @@ -56,7 +56,7 @@ public class ActionManager */ protected HashSet<Handler> actionHandlers = null; - /** Action mapper */ + /** Action mapper. */ protected KeyMapper<Action> actionMapper = null; protected Component viewer; diff --git a/server/src/main/java/com/vaadin/event/FieldEvents.java b/server/src/main/java/com/vaadin/event/FieldEvents.java index c12d683f20..a7a6c65a29 100644 --- a/server/src/main/java/com/vaadin/event/FieldEvents.java +++ b/server/src/main/java/com/vaadin/event/FieldEvents.java @@ -93,7 +93,7 @@ public interface FieldEvents { public static class FocusEvent extends Component.Event { /** - * Identifier for event that can be used in {@link EventRouter} + * Identifier for event that can be used in {@link EventRouter}. */ public static final String EVENT_ID = EventId.FOCUS; @@ -116,7 +116,7 @@ public interface FieldEvents { .findMethod(FocusListener.class, "focus", FocusEvent.class); /** - * Component has been focused + * Component has been focused. * * @param event * Component focus event. @@ -134,7 +134,7 @@ public interface FieldEvents { public static class BlurEvent extends Component.Event { /** - * Identifier for event that can be used in {@link EventRouter} + * Identifier for event that can be used in {@link EventRouter}. */ public static final String EVENT_ID = EventId.BLUR; @@ -157,7 +157,7 @@ public interface FieldEvents { .findMethod(BlurListener.class, "blur", BlurEvent.class); /** - * Component has been blurred + * Component has been blurred. * * @param event * Component blur event. diff --git a/server/src/main/java/com/vaadin/event/LayoutEvents.java b/server/src/main/java/com/vaadin/event/LayoutEvents.java index 6e70687598..bf27cbd036 100644 --- a/server/src/main/java/com/vaadin/event/LayoutEvents.java +++ b/server/src/main/java/com/vaadin/event/LayoutEvents.java @@ -36,7 +36,7 @@ public interface LayoutEvents { LayoutClickEvent.class); /** - * Layout has been clicked + * Layout has been clicked. * * @param event * Component click event. diff --git a/server/src/main/java/com/vaadin/event/ListenerMethod.java b/server/src/main/java/com/vaadin/event/ListenerMethod.java index 07fe664d0d..c631bbec14 100644 --- a/server/src/main/java/com/vaadin/event/ListenerMethod.java +++ b/server/src/main/java/com/vaadin/event/ListenerMethod.java @@ -86,8 +86,7 @@ public class ListenerMethod implements EventListener, Serializable { private int eventArgumentIndex; /* Special serialization to handle method references */ - private void writeObject(ObjectOutputStream out) - throws IOException { + private void writeObject(ObjectOutputStream out) throws IOException { try { out.defaultWriteObject(); String name = method.getName(); @@ -183,10 +182,9 @@ public class ListenerMethod implements EventListener, Serializable { // Checks that the object is of correct type if (!method.getDeclaringClass().isAssignableFrom(target.getClass())) { - throw new IllegalArgumentException( - "The method " + method.getName() - + " cannot be used for the given target: " - + target.getClass().getName()); + throw new IllegalArgumentException("The method " + method.getName() + + " cannot be used for the given target: " + + target.getClass().getName()); } // Checks that the event argument is null @@ -199,10 +197,9 @@ public class ListenerMethod implements EventListener, Serializable { if (eventArgumentIndex >= 0 && !method.getParameterTypes()[eventArgumentIndex] .isAssignableFrom(eventType)) { - throw new IllegalArgumentException( - "The method " + method.getName() - + " does not accept the given eventType: " - + eventType.getName()); + throw new IllegalArgumentException("The method " + method.getName() + + " does not accept the given eventType: " + + eventType.getName()); } this.eventType = eventType; @@ -270,10 +267,9 @@ public class ListenerMethod implements EventListener, Serializable { if (eventArgumentIndex >= 0 && !method.getParameterTypes()[eventArgumentIndex] .isAssignableFrom(eventType)) { - throw new IllegalArgumentException( - "The method " + method.getName() - + " does not accept the given eventType: " - + eventType.getName()); + throw new IllegalArgumentException("The method " + method.getName() + + " does not accept the given eventType: " + + eventType.getName()); } this.eventType = eventType; @@ -314,10 +310,9 @@ public class ListenerMethod implements EventListener, Serializable { // Check that the object is of correct type if (!method.getDeclaringClass().isAssignableFrom(target.getClass())) { - throw new IllegalArgumentException( - "The method " + method.getName() - + " cannot be used for the given target: " - + target.getClass().getName()); + throw new IllegalArgumentException("The method " + method.getName() + + " cannot be used for the given target: " + + target.getClass().getName()); } this.eventType = eventType; @@ -407,10 +402,9 @@ public class ListenerMethod implements EventListener, Serializable { // Checks that the object is of correct type if (!method.getDeclaringClass().isAssignableFrom(target.getClass())) { - throw new IllegalArgumentException( - "The method " + method.getName() - + " cannot be used for the given target: " - + target.getClass().getName()); + throw new IllegalArgumentException("The method " + method.getName() + + " cannot be used for the given target: " + + target.getClass().getName()); } this.eventType = eventType; @@ -523,8 +517,7 @@ public class ListenerMethod implements EventListener, Serializable { } catch (final IllegalAccessException e) { // This should never happen - throw new RuntimeException( - "Internal error - please report", e); + throw new RuntimeException("Internal error - please report", e); } catch (final InvocationTargetException e) { // An exception was thrown by the invocation target. Throw it // forwards. @@ -634,7 +627,7 @@ public class ListenerMethod implements EventListener, Serializable { } /** - * Compares the type of this ListenerMethod to the given type + * Compares the type of this ListenerMethod to the given type. * * @param eventType * The type to compare with @@ -646,7 +639,7 @@ public class ListenerMethod implements EventListener, Serializable { } /** - * Compares the type of this ListenerMethod to the given type + * Compares the type of this ListenerMethod to the given type. * * @param eventType * The type to compare with diff --git a/server/src/main/java/com/vaadin/event/ShortcutAction.java b/server/src/main/java/com/vaadin/event/ShortcutAction.java index e7e5d7cf7b..a100e5d0c6 100644 --- a/server/src/main/java/com/vaadin/event/ShortcutAction.java +++ b/server/src/main/java/com/vaadin/event/ShortcutAction.java @@ -141,15 +141,16 @@ public class ShortcutAction extends Action { * Insert one or more modifier characters before the character to use as * keycode. E.g <code>"&Save"</code> will make a shortcut responding to * ALT-S, <code>"E^xit"</code> will respond to CTRL-X.<br/> - * Multiple modifiers can be used, e.g <code>"&^Delete"</code> will respond - * to CTRL-ALT-D (the order of the modifier characters is not important). + * Multiple modifiers can be used, e.g <code>"&^Delete"</code> will + * respond to CTRL-ALT-D (the order of the modifier characters is not + * important). * </p> * <p> * The modifier characters will be removed from the caption. The modifier * character is be escaped by itself: two consecutive characters are turned * into the original character w/o the special meaning. E.g - * <code>"Save&&&close"</code> will respond to ALT-C, and the caption will - * say "Save&close". + * <code>"Save&&&close"</code> will respond to ALT-C, and the + * caption will say "Save&close". * </p> * * @param shorthandCaption @@ -255,7 +256,7 @@ public class ShortcutAction extends Action { } /** - * Key codes that can be used for shortcuts + * Key codes that can be used for shortcuts. * */ public interface KeyCode extends Serializable { @@ -387,7 +388,7 @@ public class ShortcutAction extends Action { } /** - * Modifier key constants + * Modifier key constants. * */ public interface ModifierKey extends Serializable { diff --git a/server/src/main/java/com/vaadin/event/dd/TargetDetails.java b/server/src/main/java/com/vaadin/event/dd/TargetDetails.java index 710fc5792f..19103d416f 100644 --- a/server/src/main/java/com/vaadin/event/dd/TargetDetails.java +++ b/server/src/main/java/com/vaadin/event/dd/TargetDetails.java @@ -35,7 +35,7 @@ import com.vaadin.ui.dnd.event.DropEvent; public interface TargetDetails extends Serializable { /** - * Gets target data associated with the given string key + * Gets target data associated with the given string key. * * @param key * @return The data associated with the key diff --git a/server/src/main/java/com/vaadin/server/BootstrapHandler.java b/server/src/main/java/com/vaadin/server/BootstrapHandler.java index ed6778bf53..ff9e816013 100644 --- a/server/src/main/java/com/vaadin/server/BootstrapHandler.java +++ b/server/src/main/java/com/vaadin/server/BootstrapHandler.java @@ -895,7 +895,7 @@ public abstract class BootstrapHandler extends SynchronizedRequestHandler { } /** - * Override if required + * Override if required. * * @param context * @return diff --git a/server/src/main/java/com/vaadin/server/BrowserWindowOpener.java b/server/src/main/java/com/vaadin/server/BrowserWindowOpener.java index 70af410e5c..38b6da002f 100644 --- a/server/src/main/java/com/vaadin/server/BrowserWindowOpener.java +++ b/server/src/main/java/com/vaadin/server/BrowserWindowOpener.java @@ -69,7 +69,7 @@ public class BrowserWindowOpener extends AbstractExtension { /** * Creates a window opener that will open windows containing the provided UI - * class + * class. * * @param uiClass * the UI class that should be opened when the extended component @@ -81,7 +81,7 @@ public class BrowserWindowOpener extends AbstractExtension { /** * Creates a window opener that will open windows containing the provided UI - * using the provided path + * using the provided path. * * @param uiClass * the UI class that should be opened when the extended component @@ -97,7 +97,7 @@ public class BrowserWindowOpener extends AbstractExtension { } /** - * Creates a window opener that will open windows to the provided URL + * Creates a window opener that will open windows to the provided URL. * * @param url * the URL to open in the window @@ -107,7 +107,7 @@ public class BrowserWindowOpener extends AbstractExtension { } /** - * Creates a window opener that will open window to the provided resource + * Creates a window opener that will open window to the provided resource. * * @param resource * the resource to open in the window diff --git a/server/src/main/java/com/vaadin/server/ClientConnector.java b/server/src/main/java/com/vaadin/server/ClientConnector.java index d48493b917..127ca25a84 100644 --- a/server/src/main/java/com/vaadin/server/ClientConnector.java +++ b/server/src/main/java/com/vaadin/server/ClientConnector.java @@ -32,7 +32,7 @@ import elemental.json.JsonObject; /** * Interface implemented by all connectors that are capable of communicating - * with the client side + * with the client side. * * @author Vaadin Ltd * @since 7.0.0 @@ -167,7 +167,7 @@ public interface ClientConnector extends Connector { public boolean isConnectorEnabled(); /** - * Returns the type of the shared state for this connector + * Returns the type of the shared state for this connector. * * @return The type of the state. Must never return null. */ @@ -223,11 +223,11 @@ public interface ClientConnector extends Connector { * Notifies the connector that it is connected to a VaadinSession (and * therefore also to a UI). * <p> - * The caller of this method is {@link Connector#setParent(ClientConnector)} if the - * parent is itself already attached to the session. If not, the parent will - * call the {@link #attach()} for all its children when it is attached to - * the session. This method is always called before the connector's data is - * sent to the client-side for the first time. + * The caller of this method is {@link Connector#setParent(ClientConnector)} + * if the parent is itself already attached to the session. If not, the + * parent will call the {@link #attach()} for all its children when it is + * attached to the session. This method is always called before the + * connector's data is sent to the client-side for the first time. * </p> * * <p> @@ -264,7 +264,7 @@ public interface ClientConnector extends Connector { public void removeExtension(Extension extension); /** - * Returns the UI this connector is attached to + * Returns the UI this connector is attached to. * * @return The UI this connector is attached to or null if it is not * attached to any UI diff --git a/server/src/main/java/com/vaadin/server/ComponentSizeValidator.java b/server/src/main/java/com/vaadin/server/ComponentSizeValidator.java index efbce4eeca..04dc907799 100644 --- a/server/src/main/java/com/vaadin/server/ComponentSizeValidator.java +++ b/server/src/main/java/com/vaadin/server/ComponentSizeValidator.java @@ -671,7 +671,7 @@ public class ComponentSizeValidator implements Serializable { } /** - * Validates the layout and returns a collection of errors + * Validates the layout and returns a collection of errors. * * @since 7.1 * @param ui diff --git a/server/src/main/java/com/vaadin/server/Constants.java b/server/src/main/java/com/vaadin/server/Constants.java index 0017d4a818..3482945fc0 100644 --- a/server/src/main/java/com/vaadin/server/Constants.java +++ b/server/src/main/java/com/vaadin/server/Constants.java @@ -19,7 +19,7 @@ import com.vaadin.shared.communication.PushMode; import com.vaadin.ui.declarative.DesignContext; /** - * Internal constants used by both the client and the server side framework + * Internal constants used by both the client and the server side framework. * * @since 6.2 * diff --git a/server/src/main/java/com/vaadin/server/DefaultErrorHandler.java b/server/src/main/java/com/vaadin/server/DefaultErrorHandler.java index ed12d2538b..2f5bf005c8 100644 --- a/server/src/main/java/com/vaadin/server/DefaultErrorHandler.java +++ b/server/src/main/java/com/vaadin/server/DefaultErrorHandler.java @@ -98,7 +98,7 @@ public class DefaultErrorHandler implements ErrorHandler { /** * Returns the AbstractComponent associated with the given error if such can - * be found + * be found. * * @param event * The error to investigate diff --git a/server/src/main/java/com/vaadin/server/FontAwesome.java b/server/src/main/java/com/vaadin/server/FontAwesome.java index c867eb4ce2..f03347a626 100644 --- a/server/src/main/java/com/vaadin/server/FontAwesome.java +++ b/server/src/main/java/com/vaadin/server/FontAwesome.java @@ -778,7 +778,7 @@ public enum FontAwesome implements FontIcon { } /** - * Finds an instance of FontAwesome with given codepoint + * Finds an instance of FontAwesome with given codepoint. * * @since 7.5.0 * @param codepoint diff --git a/server/src/main/java/com/vaadin/server/GenericFontIcon.java b/server/src/main/java/com/vaadin/server/GenericFontIcon.java index 5ba6a8b1a9..0ed9d843b0 100644 --- a/server/src/main/java/com/vaadin/server/GenericFontIcon.java +++ b/server/src/main/java/com/vaadin/server/GenericFontIcon.java @@ -16,7 +16,7 @@ package com.vaadin.server; /** - * A generic implementation of {@link FontIcon} interface + * A generic implementation of {@link FontIcon} interface. * * @since 7.5.0 * @author Vaadin Ltd @@ -28,7 +28,7 @@ public class GenericFontIcon implements FontIcon { /** * Creates a new instance of GenericFontIcon with given font family and - * codepoint + * codepoint. * * @param fontFamily * Name of the type face that is used to display icons @@ -83,7 +83,7 @@ public class GenericFontIcon implements FontIcon { /** * Utility method for generating HTML that displays an icon from specific - * fontFamiliy with a given codePoint in the font + * fontFamiliy with a given codePoint in the font. * * @param fontFamily * Name of the font family diff --git a/server/src/main/java/com/vaadin/server/KeyMapper.java b/server/src/main/java/com/vaadin/server/KeyMapper.java index 08d36458d3..e6a3e1ae7f 100644 --- a/server/src/main/java/com/vaadin/server/KeyMapper.java +++ b/server/src/main/java/com/vaadin/server/KeyMapper.java @@ -41,7 +41,7 @@ public class KeyMapper<V> implements DataKeyMapper<V>, Serializable { private ValueProvider<V, Object> identifierGetter; /** - * Constructs a new mapper + * Constructs a new mapper. * * @param identifierGetter * has to return a unique key for every bean, and the returned @@ -55,7 +55,7 @@ public class KeyMapper<V> implements DataKeyMapper<V>, Serializable { } /** - * Constructs a new mapper with trivial {@code identifierGetter} + * Constructs a new mapper with trivial {@code identifierGetter}. */ public KeyMapper() { this(v -> v); diff --git a/server/src/main/java/com/vaadin/server/LocaleService.java b/server/src/main/java/com/vaadin/server/LocaleService.java index 9e47c4fe9b..9ec7e1282f 100644 --- a/server/src/main/java/com/vaadin/server/LocaleService.java +++ b/server/src/main/java/com/vaadin/server/LocaleService.java @@ -46,7 +46,7 @@ public class LocaleService implements Serializable { private final LocaleServiceState state; /** - * Creates a LocaleService bound to the given UI + * Creates a LocaleService bound to the given UI. * * @since 7.1 * @param ui @@ -58,7 +58,7 @@ public class LocaleService implements Serializable { } /** - * Retrieves the UI this service is bound to + * Retrieves the UI this service is bound to. * * @since 7.1 * @return the UI for this service @@ -110,7 +110,7 @@ public class LocaleService implements Serializable { } /** - * Creates a LocaleData instance for transportation to the client + * Creates a LocaleData instance for transportation to the client. * * @since 7.1 * @param locale diff --git a/server/src/main/java/com/vaadin/server/Page.java b/server/src/main/java/com/vaadin/server/Page.java index 2c82a4a9c2..f73beca90b 100644 --- a/server/src/main/java/com/vaadin/server/Page.java +++ b/server/src/main/java/com/vaadin/server/Page.java @@ -73,7 +73,7 @@ public class Page implements Serializable { private final int height; /** - * Creates a new event + * Creates a new event. * * @param source * the uI for which the browser window has been resized @@ -94,7 +94,7 @@ public class Page implements Serializable { } /** - * Gets the new browser window height + * Gets the new browser window height. * * @return an integer with the new pixel height of the browser window */ @@ -103,7 +103,7 @@ public class Page implements Serializable { } /** - * Gets the new browser window width + * Gets the new browser window width. * * @return an integer with the new pixel width of the browser window */ @@ -345,7 +345,7 @@ public class Page implements Serializable { } /** - * Get the new URI fragment + * Get the new URI fragment. * * @return the new fragment */ @@ -392,7 +392,7 @@ public class Page implements Serializable { } /** - * Get the new URI + * Get the new URI. * * @return the new uri */ @@ -492,7 +492,7 @@ public class Page implements Serializable { } /** - * Injects a CSS resource into the page + * Injects a CSS resource into the page. * * @param resource * The resource to inject. diff --git a/server/src/main/java/com/vaadin/server/PaintTarget.java b/server/src/main/java/com/vaadin/server/PaintTarget.java index 0719fb26aa..8ef05a7abd 100644 --- a/server/src/main/java/com/vaadin/server/PaintTarget.java +++ b/server/src/main/java/com/vaadin/server/PaintTarget.java @@ -145,8 +145,8 @@ public interface PaintTarget extends Serializable { public void endTag(String tagName) throws PaintException; /** - * Adds a boolean attribute to component. Attributes must be added before any - * content is written. + * Adds a boolean attribute to component. Attributes must be added before + * any content is written. * * @param name * the Attribute name. @@ -159,8 +159,8 @@ public interface PaintTarget extends Serializable { public void addAttribute(String name, boolean value) throws PaintException; /** - * Adds a integer attribute to component. Attributes must be added before any - * content is written. + * Adds a integer attribute to component. Attributes must be added before + * any content is written. * * @param name * the Attribute name. @@ -278,8 +278,11 @@ public interface PaintTarget extends Serializable { public void addAttribute(String name, String value) throws PaintException; /** - * TODO + * Adds a {@link Map} attribute to the component. Attributes must be added + * before any content is written. * + * TODO: specify how the map is added + * * @param name * @param value * @throws PaintException diff --git a/server/src/main/java/com/vaadin/server/ServerRpcManager.java b/server/src/main/java/com/vaadin/server/ServerRpcManager.java index d2c8d4d2e9..30c8ec48ba 100644 --- a/server/src/main/java/com/vaadin/server/ServerRpcManager.java +++ b/server/src/main/java/com/vaadin/server/ServerRpcManager.java @@ -42,7 +42,7 @@ public class ServerRpcManager<T extends ServerRpc> implements Serializable { /** * Wrapper exception for exceptions which occur during invocation of an RPC - * call + * call. * * @author Vaadin Ltd * @since 7.0 diff --git a/server/src/main/java/com/vaadin/server/ServiceDestroyListener.java b/server/src/main/java/com/vaadin/server/ServiceDestroyListener.java index 4ce74e28d0..6d85545244 100644 --- a/server/src/main/java/com/vaadin/server/ServiceDestroyListener.java +++ b/server/src/main/java/com/vaadin/server/ServiceDestroyListener.java @@ -31,7 +31,7 @@ import java.io.Serializable; @FunctionalInterface public interface ServiceDestroyListener extends Serializable { /** - * Invoked when a service is destroyed + * Invoked when a service is destroyed. * * @param event * the event diff --git a/server/src/main/java/com/vaadin/server/SessionInitEvent.java b/server/src/main/java/com/vaadin/server/SessionInitEvent.java index 994eb07239..c9b34796b5 100644 --- a/server/src/main/java/com/vaadin/server/SessionInitEvent.java +++ b/server/src/main/java/com/vaadin/server/SessionInitEvent.java @@ -60,7 +60,7 @@ public class SessionInitEvent extends EventObject { } /** - * Gets the Vaadin service from which this event originates + * Gets the Vaadin service from which this event originates. * * @return the Vaadin service instance */ diff --git a/server/src/main/java/com/vaadin/server/Setter.java b/server/src/main/java/com/vaadin/server/Setter.java index 300c7e1b6f..7c8ebf1c69 100644 --- a/server/src/main/java/com/vaadin/server/Setter.java +++ b/server/src/main/java/com/vaadin/server/Setter.java @@ -21,11 +21,11 @@ import java.util.function.BiConsumer; import com.vaadin.data.Binder; /** - * The function to write the field value to the bean property + * The function to write the field value to the bean property. * * @see BiConsumer * @see Binder#bind(com.vaadin.data.HasValue, SerializableFunction, Setter) - * Binder#bind(HasValue, SerializableFunction, Setter) + * Binder#bind(HasValue, SerializableFunction, Setter) * @param <BEAN> * the type of the target bean * @param <FIELDVALUE> @@ -40,7 +40,7 @@ public interface Setter<BEAN, FIELDVALUE> extends BiConsumer<BEAN, FIELDVALUE>, Serializable { /** - * Save value to the bean property + * Save value to the bean property. * * @param bean * the target bean diff --git a/server/src/main/java/com/vaadin/server/Sizeable.java b/server/src/main/java/com/vaadin/server/Sizeable.java index f3fa8ed0cc..b77c182a27 100644 --- a/server/src/main/java/com/vaadin/server/Sizeable.java +++ b/server/src/main/java/com/vaadin/server/Sizeable.java @@ -260,14 +260,14 @@ public interface Sizeable extends Serializable { public void setSizeUndefined(); /** - * Clears any defined width + * Clears any defined width. * * @since 7.3 */ public void setWidthUndefined(); /** - * Clears any defined height + * Clears any defined height. * * @since 7.3 */ diff --git a/server/src/main/java/com/vaadin/server/UICreateEvent.java b/server/src/main/java/com/vaadin/server/UICreateEvent.java index 0ae25ee960..27306f04ea 100644 --- a/server/src/main/java/com/vaadin/server/UICreateEvent.java +++ b/server/src/main/java/com/vaadin/server/UICreateEvent.java @@ -45,7 +45,7 @@ public class UICreateEvent extends UIProviderEvent { /** * Creates a new UI create event for a given VaadinRequest, UI class and UI - * id + * id. * * @param request * the request for which the UI will be created diff --git a/server/src/main/java/com/vaadin/server/UnsupportedBrowserHandler.java b/server/src/main/java/com/vaadin/server/UnsupportedBrowserHandler.java index 1a648a7751..db489560e9 100644 --- a/server/src/main/java/com/vaadin/server/UnsupportedBrowserHandler.java +++ b/server/src/main/java/com/vaadin/server/UnsupportedBrowserHandler.java @@ -30,7 +30,7 @@ import java.io.Writer; @SuppressWarnings("serial") public class UnsupportedBrowserHandler extends SynchronizedRequestHandler { - /** Cookie used to ignore browser checks */ + /** Cookie used to ignore browser checks. */ public static final String FORCE_LOAD_COOKIE = "vaadinforceload=1"; @Override @@ -64,6 +64,7 @@ public class UnsupportedBrowserHandler extends SynchronizedRequestHandler { try (Writer page = response.getWriter()) { WebBrowser b = VaadinSession.getCurrent().getBrowser(); + // @formatter:off page.write( "<html>" + "<head>" @@ -129,11 +130,12 @@ public class UnsupportedBrowserHandler extends SynchronizedRequestHandler { + (b.isIE() ? "<script type=\"text/javascript\" src=\"http://ajax.googleapis.com/ajax/libs/chrome-frame/1/CFInstall.min.js\"></script>" + "<p>If you can not upgrade your browser, please consider trying <a onclick=\"CFInstall.check({mode:'overlay'});return false;\" href=\"http://www.google.com/chromeframe\">Chrome Frame</a>.</p>" - : "") // + : "") + "<p><sub><a onclick=\"document.cookie='" + FORCE_LOAD_COOKIE + "';window.location.reload();return false;\" href=\"#\">Continue without updating</a> (not recommended)</sub></p>" + "</body>\n" + "</html>"); + // @formatter:on } } } diff --git a/server/src/main/java/com/vaadin/server/VaadinPortletRequest.java b/server/src/main/java/com/vaadin/server/VaadinPortletRequest.java index b59eee923a..05decbe967 100644 --- a/server/src/main/java/com/vaadin/server/VaadinPortletRequest.java +++ b/server/src/main/java/com/vaadin/server/VaadinPortletRequest.java @@ -46,7 +46,7 @@ public class VaadinPortletRequest extends PortletRequestWrapper private final VaadinPortletService vaadinService; /** - * Wraps a portlet request and an associated vaadin service + * Wraps a portlet request and an associated vaadin service. * * @param request * the portlet request to wrap diff --git a/server/src/main/java/com/vaadin/server/VaadinPortletResponse.java b/server/src/main/java/com/vaadin/server/VaadinPortletResponse.java index f7a5abadff..602b6d7ea6 100644 --- a/server/src/main/java/com/vaadin/server/VaadinPortletResponse.java +++ b/server/src/main/java/com/vaadin/server/VaadinPortletResponse.java @@ -50,7 +50,7 @@ public class VaadinPortletResponse implements VaadinResponse { private final VaadinPortletService vaadinService; /** - * Wraps a portlet response and an associated vaadin service + * Wraps a portlet response and an associated vaadin service. * * @param response * the portlet response to wrap diff --git a/server/src/main/java/com/vaadin/server/VaadinPortletSession.java b/server/src/main/java/com/vaadin/server/VaadinPortletSession.java index 18e3fee80e..802d0e580e 100644 --- a/server/src/main/java/com/vaadin/server/VaadinPortletSession.java +++ b/server/src/main/java/com/vaadin/server/VaadinPortletSession.java @@ -74,7 +74,7 @@ public class VaadinPortletSession extends VaadinSession { private final Map<String, String> sharedParameterActionValueMap = new HashMap<>(); /** - * Create a portlet service session for the given portlet service + * Create a portlet service session for the given portlet service. * * @param service * the portlet service to which the new session belongs diff --git a/server/src/main/java/com/vaadin/server/VaadinService.java b/server/src/main/java/com/vaadin/server/VaadinService.java index 509b29f9d3..b65ae5ad9d 100644 --- a/server/src/main/java/com/vaadin/server/VaadinService.java +++ b/server/src/main/java/com/vaadin/server/VaadinService.java @@ -159,7 +159,7 @@ public abstract class VaadinService implements Serializable { private boolean initialized = false; /** - * Creates a new vaadin service based on a deployment configuration + * Creates a new vaadin service based on a deployment configuration. * * @param deploymentConfiguration * the deployment configuration for the service @@ -873,7 +873,7 @@ public abstract class VaadinService implements Serializable { } /** - * Creates a new Vaadin session for this service and request + * Creates a new Vaadin session for this service and request. * * @param request * The request for which to create a VaadinSession @@ -1171,7 +1171,7 @@ public abstract class VaadinService implements Serializable { /** * * Finds the given theme resource from the web content folder or using the - * class loader and returns a stream for it + * class loader and returns a stream for it. * * @param ui * The ui for which to find the resource @@ -1400,7 +1400,7 @@ public abstract class VaadinService implements Serializable { } /** - * Called before the framework starts handling a request + * Called before the framework starts handling a request. * * @param request * The request @@ -1833,7 +1833,7 @@ public abstract class VaadinService implements Serializable { } /** - * Checks whether Atmosphere is avilable for use + * Checks whether Atmosphere is available for use. * * @since 7.6 * @return true if Atmosphere is available, false otherwise @@ -2138,7 +2138,7 @@ public abstract class VaadinService implements Serializable { /** * Called when the VaadinSession should be loaded from the underlying HTTP - * session + * session. * * @since 7.6 * @param wrappedSession @@ -2174,7 +2174,7 @@ public abstract class VaadinService implements Serializable { /** * Called when the VaadinSession should be removed from the underlying HTTP - * session + * session. * * @since 7.6 * @param wrappedSession @@ -2187,7 +2187,7 @@ public abstract class VaadinService implements Serializable { /** * Performs the actual removal of the VaadinSession from the underlying HTTP - * session after sanity checks have been performed + * session after sanity checks have been performed. * * @since 7.6 * @param wrappedSession @@ -2200,7 +2200,7 @@ public abstract class VaadinService implements Serializable { /** * Returns the name used for storing the VaadinSession in the underlying - * HTTP session + * HTTP session. * * @since 7.6 * @return the attribute name used for storing the VaadinSession diff --git a/server/src/main/java/com/vaadin/server/VaadinServletRequest.java b/server/src/main/java/com/vaadin/server/VaadinServletRequest.java index 9d166dbf8f..263a67fc05 100644 --- a/server/src/main/java/com/vaadin/server/VaadinServletRequest.java +++ b/server/src/main/java/com/vaadin/server/VaadinServletRequest.java @@ -35,7 +35,7 @@ public class VaadinServletRequest extends HttpServletRequestWrapper private final VaadinServletService vaadinService; /** - * Wraps a http servlet request and associates with a vaadin service + * Wraps a http servlet request and associates with a vaadin service. * * @param request * the http servlet request to wrap diff --git a/server/src/main/java/com/vaadin/server/VaadinServletResponse.java b/server/src/main/java/com/vaadin/server/VaadinServletResponse.java index 6c37c7b440..cd95d0a1ab 100644 --- a/server/src/main/java/com/vaadin/server/VaadinServletResponse.java +++ b/server/src/main/java/com/vaadin/server/VaadinServletResponse.java @@ -34,7 +34,7 @@ public class VaadinServletResponse extends HttpServletResponseWrapper private final VaadinServletService vaadinService; /** - * Wraps a http servlet response and an associated vaadin service + * Wraps a http servlet response and an associated vaadin service. * * @param response * the http servlet response to wrap @@ -48,7 +48,7 @@ public class VaadinServletResponse extends HttpServletResponseWrapper } /** - * Gets the original unwrapped <code>HttpServletResponse</code> + * Gets the original unwrapped <code>HttpServletResponse</code>. * * @return the unwrapped response */ diff --git a/server/src/main/java/com/vaadin/server/VaadinSession.java b/server/src/main/java/com/vaadin/server/VaadinSession.java index a49c286f4a..6bf3a41bd7 100644 --- a/server/src/main/java/com/vaadin/server/VaadinSession.java +++ b/server/src/main/java/com/vaadin/server/VaadinSession.java @@ -83,7 +83,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { private final Runnable runnable; /** - * Creates an instance for the given runnable + * Creates an instance for the given runnable. * * @param session * the session to which the task belongs @@ -439,7 +439,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { /** * Retrieves all {@link VaadinSession}s which are stored in the given HTTP - * session + * session. * * @since 7.2 * @param httpSession @@ -522,7 +522,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { } /** - * Gets the configuration for this session + * Gets the configuration for this session. * * @return the deployment configuration */ @@ -793,7 +793,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable { } /** - * Checks if the current thread has exclusive access to this VaadinSession + * Checks if the current thread has exclusive access to this VaadinSession. * * @return true if the thread has exclusive access, false otherwise * @since 7.1 diff --git a/server/src/main/java/com/vaadin/server/communication/DateSerializer.java b/server/src/main/java/com/vaadin/server/communication/DateSerializer.java index dd2c246eda..6b1ab0f9db 100644 --- a/server/src/main/java/com/vaadin/server/communication/DateSerializer.java +++ b/server/src/main/java/com/vaadin/server/communication/DateSerializer.java @@ -24,7 +24,7 @@ import elemental.json.Json; import elemental.json.JsonValue; /** - * Server side serializer/deserializer for java.util.Date + * Server side serializer/deserializer for java.util.Date. * * @since 7.2 * @author Vaadin Ltd diff --git a/server/src/main/java/com/vaadin/server/communication/FileUploadHandler.java b/server/src/main/java/com/vaadin/server/communication/FileUploadHandler.java index 1323bb1eaa..b54c9622d6 100644 --- a/server/src/main/java/com/vaadin/server/communication/FileUploadHandler.java +++ b/server/src/main/java/com/vaadin/server/communication/FileUploadHandler.java @@ -674,7 +674,7 @@ public class FileUploadHandler implements RequestHandler { } /** - * TODO document + * Sends the upload response. * * @param request * @param response diff --git a/server/src/main/java/com/vaadin/server/communication/JSR356WebsocketInitializer.java b/server/src/main/java/com/vaadin/server/communication/JSR356WebsocketInitializer.java index 2119de6f37..9410b8b230 100644 --- a/server/src/main/java/com/vaadin/server/communication/JSR356WebsocketInitializer.java +++ b/server/src/main/java/com/vaadin/server/communication/JSR356WebsocketInitializer.java @@ -61,7 +61,7 @@ public class JSR356WebsocketInitializer implements ServletContextListener { /** * "ServletConfig" which only provides information from a - * {@link ServletRegistration} and its {@link ServletContext} + * {@link ServletRegistration} and its {@link ServletContext}. */ public static class FakeServletConfig implements ServletConfig { @@ -158,7 +158,7 @@ public class JSR356WebsocketInitializer implements ServletContextListener { /** * Returns the name of the attribute in the servlet context where the - * pre-initialized Atmosphere object is stored + * pre-initialized Atmosphere object is stored. * * @param servletName * The name of the servlet diff --git a/server/src/main/java/com/vaadin/server/communication/PushAtmosphereHandler.java b/server/src/main/java/com/vaadin/server/communication/PushAtmosphereHandler.java index e0840e4067..86bb9435a4 100644 --- a/server/src/main/java/com/vaadin/server/communication/PushAtmosphereHandler.java +++ b/server/src/main/java/com/vaadin/server/communication/PushAtmosphereHandler.java @@ -28,7 +28,7 @@ import org.atmosphere.handler.AbstractReflectorAtmosphereHandler; /** * Handles Atmosphere requests and forwards them to logical methods in - * {@link PushHandler} + * {@link PushHandler}. * * @since 7.5.0 * @author Vaadin Ltd diff --git a/server/src/main/java/com/vaadin/server/communication/PushHandler.java b/server/src/main/java/com/vaadin/server/communication/PushHandler.java index f287b4334f..08e0d798bc 100644 --- a/server/src/main/java/com/vaadin/server/communication/PushHandler.java +++ b/server/src/main/java/com/vaadin/server/communication/PushHandler.java @@ -48,7 +48,7 @@ import elemental.json.JsonException; /** * Handles incoming push connections and messages and dispatches them to the - * correct {@link UI}/ {@link AtmospherePushConnection} + * correct {@link UI}/ {@link AtmospherePushConnection}. * * @author Vaadin Ltd * @since 7.1 @@ -164,7 +164,7 @@ public class PushHandler { } /** - * Suspends the given resource + * Suspends the given resource. * * @since 7.6 * @param resource diff --git a/server/src/main/java/com/vaadin/server/communication/ServerRpcHandler.java b/server/src/main/java/com/vaadin/server/communication/ServerRpcHandler.java index 38c7e4db5f..c4c00a6a61 100644 --- a/server/src/main/java/com/vaadin/server/communication/ServerRpcHandler.java +++ b/server/src/main/java/com/vaadin/server/communication/ServerRpcHandler.java @@ -157,7 +157,7 @@ public class ServerRpcHandler implements Serializable { } /** - * Checks if this is a request to resynchronize the client side + * Checks if this is a request to resynchronize the client side. * * @return true if this is a resynchronization request, false otherwise */ @@ -166,7 +166,7 @@ public class ServerRpcHandler implements Serializable { } /** - * Gets the id of the client to server message + * Gets the id of the client to server message. * * @since 7.6 * @return the server message id @@ -190,7 +190,7 @@ public class ServerRpcHandler implements Serializable { } /** - * Gets the widget set version reported by the client + * Gets the widget set version reported by the client. * * @since 7.6 * @return The widget set version reported by the client or null if the @@ -429,7 +429,7 @@ public class ServerRpcHandler implements Serializable { } /** - * Handles the given RPC method invocation for the given connector + * Handles the given RPC method invocation for the given connector. * * @since 7.7 * @param ui @@ -452,7 +452,7 @@ public class ServerRpcHandler implements Serializable { /** * Handles the given Legacy variable change RPC method invocation for the - * given connector + * given connector. * * @since 7.7 * @param ui diff --git a/server/src/main/java/com/vaadin/server/communication/UidlRequestHandler.java b/server/src/main/java/com/vaadin/server/communication/UidlRequestHandler.java index 6afb6434a4..3aedcd2472 100644 --- a/server/src/main/java/com/vaadin/server/communication/UidlRequestHandler.java +++ b/server/src/main/java/com/vaadin/server/communication/UidlRequestHandler.java @@ -58,7 +58,7 @@ public class UidlRequestHandler extends SynchronizedRequestHandler } /** - * Creates the ServerRpcHandler to use + * Creates the ServerRpcHandler to use. * * @since 7.7 * @return the ServerRpcHandler to use diff --git a/server/src/main/java/com/vaadin/server/themeutils/SASSAddonImportFileCreator.java b/server/src/main/java/com/vaadin/server/themeutils/SASSAddonImportFileCreator.java index 79d87f960a..a313e8c0fe 100644 --- a/server/src/main/java/com/vaadin/server/themeutils/SASSAddonImportFileCreator.java +++ b/server/src/main/java/com/vaadin/server/themeutils/SASSAddonImportFileCreator.java @@ -64,7 +64,8 @@ public class SASSAddonImportFileCreator { } /** - * Updates a themes addons.scss with the addon themes found on the classpath + * Updates a themes addons.scss with the addon themes found on the + * classpath. * * @param themeDirectory * The target theme directory @@ -86,7 +87,7 @@ public class SASSAddonImportFileCreator { .getAvailableWidgetSetsAndStylesheets(); try (PrintStream printStream = new PrintStream( - new FileOutputStream(addonImports))) { + new FileOutputStream(addonImports))) { printStream.println("/* " + ADDON_IMPORTS_FILE_TEXT + " */"); diff --git a/server/src/main/java/com/vaadin/server/widgetsetutils/ClassPathExplorer.java b/server/src/main/java/com/vaadin/server/widgetsetutils/ClassPathExplorer.java index 66ba4d0d9f..1f5bbfff29 100644 --- a/server/src/main/java/com/vaadin/server/widgetsetutils/ClassPathExplorer.java +++ b/server/src/main/java/com/vaadin/server/widgetsetutils/ClassPathExplorer.java @@ -61,7 +61,7 @@ public class ClassPathExplorer { && f.isDirectory(); /** - * Contains information about widgetsets and themes found on the classpath + * Contains information about widgetsets and themes found on the classpath. * * @since 7.1 */ @@ -563,7 +563,7 @@ public class ClassPathExplorer { } /** - * Test method for helper tool + * Test method for helper tool. */ public static void main(String[] args) { log("Searching for available widgetsets and stylesheets..."); diff --git a/server/src/main/java/com/vaadin/ui/AbsoluteLayout.java b/server/src/main/java/com/vaadin/ui/AbsoluteLayout.java index 58e937e8a2..d3f6445bb1 100644 --- a/server/src/main/java/com/vaadin/ui/AbsoluteLayout.java +++ b/server/src/main/java/com/vaadin/ui/AbsoluteLayout.java @@ -433,7 +433,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Sets the 'z-index' attribute; the visual stacking order + * Sets the 'z-index' attribute; the visual stacking order. * * @param zIndex * The z-index for the component. @@ -538,7 +538,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Gets the unit for the 'top' attribute + * Gets the unit for the 'top' attribute. * * @return See {@link Sizeable} UNIT_SYMBOLS for a description of the * available units. @@ -548,7 +548,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Sets the unit for the 'top' attribute + * Sets the unit for the 'top' attribute. * * @param topUnits * See {@link Sizeable} UNIT_SYMBOLS for a description of the @@ -560,7 +560,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Gets the unit for the 'right' attribute + * Gets the unit for the 'right' attribute. * * @return See {@link Sizeable} UNIT_SYMBOLS for a description of the * available units. @@ -570,7 +570,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Sets the unit for the 'right' attribute + * Sets the unit for the 'right' attribute. * * @param rightUnits * See {@link Sizeable} UNIT_SYMBOLS for a description of the @@ -582,7 +582,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Gets the unit for the 'bottom' attribute + * Gets the unit for the 'bottom' attribute. * * @return See {@link Sizeable} UNIT_SYMBOLS for a description of the * available units. @@ -592,7 +592,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Sets the unit for the 'bottom' attribute + * Sets the unit for the 'bottom' attribute. * * @param bottomUnits * See {@link Sizeable} UNIT_SYMBOLS for a description of the @@ -604,7 +604,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Gets the unit for the 'left' attribute + * Gets the unit for the 'left' attribute. * * @return See {@link Sizeable} UNIT_SYMBOLS for a description of the * available units. @@ -614,7 +614,7 @@ public class AbsoluteLayout extends AbstractLayout } /** - * Sets the unit for the 'left' attribute + * Sets the unit for the 'left' attribute. * * @param leftUnits * See {@link Sizeable} UNIT_SYMBOLS for a description of the diff --git a/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java b/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java index 66c4504c6e..8ff818631d 100644 --- a/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java +++ b/server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java @@ -359,7 +359,7 @@ public abstract class AbstractSplitPanel extends AbstractComponentContainer { } /** - * Returns the unit of position of the splitter + * Returns the unit of position of the splitter. * * @return unit of position of the splitter * @see #setSplitPosition(float, Unit) @@ -441,7 +441,7 @@ public abstract class AbstractSplitPanel extends AbstractComponentContainer { } /** - * Returns the unit of the maximum position of the splitter + * Returns the unit of the maximum position of the splitter. * * @return the unit of the maximum position of the splitter */ @@ -520,7 +520,7 @@ public abstract class AbstractSplitPanel extends AbstractComponentContainer { SplitterClickEvent.class); /** - * SplitPanel splitter has been clicked + * SplitPanel splitter has been clicked. * * @param event * SplitterClickEvent event. diff --git a/server/src/main/java/com/vaadin/ui/Button.java b/server/src/main/java/com/vaadin/ui/Button.java index e768831e33..e235097251 100644 --- a/server/src/main/java/com/vaadin/ui/Button.java +++ b/server/src/main/java/com/vaadin/ui/Button.java @@ -159,7 +159,7 @@ public class Button extends AbstractFocusable } /** - * Constructor with mouse details + * Constructor with mouse details. * * @param source * The source where the click took place @@ -564,7 +564,7 @@ public class Button extends AbstractFocusable } /** - * Return HTML rendering setting + * Return HTML rendering setting. * * @return <code>true</code> if the caption text is to be rendered as HTML, * <code>false</code> otherwise diff --git a/server/src/main/java/com/vaadin/ui/Component.java b/server/src/main/java/com/vaadin/ui/Component.java index 206786ee45..955f5f068c 100644 --- a/server/src/main/java/com/vaadin/ui/Component.java +++ b/server/src/main/java/com/vaadin/ui/Component.java @@ -628,7 +628,7 @@ public interface Component extends ClientConnector, Sizeable, Serializable { public void setId(String id); /** - * Gets currently set debug identifier + * Gets currently set debug identifier. * * @return current id, null if not set */ diff --git a/server/src/main/java/com/vaadin/ui/CustomLayout.java b/server/src/main/java/com/vaadin/ui/CustomLayout.java index 2026038316..5ca3d1f785 100644 --- a/server/src/main/java/com/vaadin/ui/CustomLayout.java +++ b/server/src/main/java/com/vaadin/ui/CustomLayout.java @@ -265,12 +265,12 @@ public class CustomLayout extends AbstractLayout implements LegacyComponent { } } - /** Get the name of the template */ + /** Get the name of the template. */ public String getTemplateName() { return getState(false).templateName; } - /** Get the contents of the template */ + /** Get the contents of the template. */ public String getTemplateContents() { return getState(false).templateContents; } diff --git a/server/src/main/java/com/vaadin/ui/DragAndDropWrapper.java b/server/src/main/java/com/vaadin/ui/DragAndDropWrapper.java index 7b8183d3bb..22d25d8953 100644 --- a/server/src/main/java/com/vaadin/ui/DragAndDropWrapper.java +++ b/server/src/main/java/com/vaadin/ui/DragAndDropWrapper.java @@ -175,7 +175,7 @@ public class DragAndDropWrapper extends CustomComponent public enum DragStartMode { /** - * {@link DragAndDropWrapper} does not start drag events at all + * {@link DragAndDropWrapper} does not start drag events at all. */ NONE, /** diff --git a/server/src/main/java/com/vaadin/ui/Flash.java b/server/src/main/java/com/vaadin/ui/Flash.java index affda1a372..dfa51aef27 100644 --- a/server/src/main/java/com/vaadin/ui/Flash.java +++ b/server/src/main/java/com/vaadin/ui/Flash.java @@ -44,7 +44,7 @@ public class Flash extends AbstractEmbedded { } /** - * Creates a new empty Flash component with the given caption + * Creates a new empty Flash component with the given caption. * * @param caption * The caption for the component diff --git a/server/src/main/java/com/vaadin/ui/Grid.java b/server/src/main/java/com/vaadin/ui/Grid.java index 83e0a32d30..a80e8f1729 100644 --- a/server/src/main/java/com/vaadin/ui/Grid.java +++ b/server/src/main/java/com/vaadin/ui/Grid.java @@ -1726,8 +1726,8 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, * * @since 7.5.0 * @param hidable - * <code>true</code> if the column may be hidable by the - * user via UI interaction + * <code>true</code> if the column may be hidable by the user + * via UI interaction * @return this column */ public Column<T, V> setHidable(boolean hidable) { @@ -2420,7 +2420,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, } /** - * Creates a new {@code Grid} using the given caption + * Creates a new {@code Grid} using the given caption. * * @param caption * the caption of the grid @@ -2432,7 +2432,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, /** * Creates a new {@code Grid} using the given caption and - * {@code DataProvider} + * {@code DataProvider}. * * @param caption * the caption of the grid @@ -2445,7 +2445,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, } /** - * Creates a new {@code Grid} using the given {@code DataProvider} + * Creates a new {@code Grid} using the given {@code DataProvider}. * * @param dataProvider * the data provider, not {@code null} @@ -2457,7 +2457,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, /** * Creates a new {@code Grid} using the given caption and collection of - * items + * items. * * @param caption * the caption of the grid @@ -3989,7 +3989,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents, * @param row * zero based index of the item to scroll to in the current view. * @throws IllegalArgumentException - * if the provided row is outside the item range + * if the provided row is outside the item range */ public void scrollTo(int row) throws IllegalArgumentException { scrollTo(row, ScrollDestination.ANY); diff --git a/server/src/main/java/com/vaadin/ui/GridLayout.java b/server/src/main/java/com/vaadin/ui/GridLayout.java index b7bbcd061b..03886dd0e8 100644 --- a/server/src/main/java/com/vaadin/ui/GridLayout.java +++ b/server/src/main/java/com/vaadin/ui/GridLayout.java @@ -1059,7 +1059,7 @@ public class GridLayout extends AbstractLayout } /** - * Returns the expand ratio of given column + * Returns the expand ratio of given column. * * @see #setColumnExpandRatio(int, float) * diff --git a/server/src/main/java/com/vaadin/ui/HorizontalSplitPanel.java b/server/src/main/java/com/vaadin/ui/HorizontalSplitPanel.java index 92190e460d..0c5b01ca40 100644 --- a/server/src/main/java/com/vaadin/ui/HorizontalSplitPanel.java +++ b/server/src/main/java/com/vaadin/ui/HorizontalSplitPanel.java @@ -40,7 +40,7 @@ import com.vaadin.shared.ui.splitpanel.HorizontalSplitPanelState; */ public class HorizontalSplitPanel extends AbstractSplitPanel { /** - * Creates an empty horizontal split panel + * Creates an empty horizontal split panel. */ public HorizontalSplitPanel() { super(); @@ -48,7 +48,7 @@ public class HorizontalSplitPanel extends AbstractSplitPanel { } /** - * Creates a horizontal split panel containing the given components + * Creates a horizontal split panel containing the given components. * * @param firstComponent * The component to be placed to the left of the splitter diff --git a/server/src/main/java/com/vaadin/ui/Layout.java b/server/src/main/java/com/vaadin/ui/Layout.java index 871e1b2b0b..670bdebe62 100644 --- a/server/src/main/java/com/vaadin/ui/Layout.java +++ b/server/src/main/java/com/vaadin/ui/Layout.java @@ -72,7 +72,7 @@ public interface Layout extends ComponentContainer, Serializable { Alignment defaultComponentAlignment); /** - * Returns the alignment used for new components added to this layout + * Returns the alignment used for new components added to this layout. * * @return The default alignment */ @@ -93,8 +93,8 @@ public interface Layout extends ComponentContainer, Serializable { * <strong>NOTE:</strong> This will only affect the space between * components, not the space around all the components in the layout * (i.e. do not confuse this with the cellspacing attribute of a HTML - * Table). Use {@link MarginHandler#setMargin(boolean)} to add space around the - * layout. + * Table). Use {@link MarginHandler#setMargin(boolean)} to add space + * around the layout. * </p> * * <p> @@ -140,8 +140,8 @@ public interface Layout extends ComponentContainer, Serializable { * <p> * <strong>NOTE:</strong> This will only affect the space around the * components in the layout, not space between the components in the - * layout. Use {@link SpacingHandler#setSpacing(boolean)} to add space between the - * components in the layout. + * layout. Use {@link SpacingHandler#setSpacing(boolean)} to add space + * between the components in the layout. * </p> * * <p> diff --git a/server/src/main/java/com/vaadin/ui/LegacyWindow.java b/server/src/main/java/com/vaadin/ui/LegacyWindow.java index 7cb20a82b9..94a4c52c90 100644 --- a/server/src/main/java/com/vaadin/ui/LegacyWindow.java +++ b/server/src/main/java/com/vaadin/ui/LegacyWindow.java @@ -35,7 +35,7 @@ public class LegacyWindow extends UI { private LegacyApplication application; /** - * Create a new legacy window + * Create a new legacy window. */ public LegacyWindow() { super(new VerticalLayout()); @@ -43,7 +43,7 @@ public class LegacyWindow extends UI { } /** - * Creates a new legacy window with the given caption + * Creates a new legacy window with the given caption. * * @param caption * the caption of the window @@ -54,7 +54,7 @@ public class LegacyWindow extends UI { } /** - * Creates a legacy window with the given caption and content layout + * Creates a legacy window with the given caption and content layout. * * @param caption * @param content diff --git a/server/src/main/java/com/vaadin/ui/MenuBar.java b/server/src/main/java/com/vaadin/ui/MenuBar.java index f7682408d4..544b93ea6a 100644 --- a/server/src/main/java/com/vaadin/ui/MenuBar.java +++ b/server/src/main/java/com/vaadin/ui/MenuBar.java @@ -200,7 +200,7 @@ public class MenuBar extends AbstractComponent } /** - * Constructs an empty, horizontal menu + * Constructs an empty, horizontal menu. */ public MenuBar() { menuItems = new ArrayList<>(); @@ -282,7 +282,7 @@ public class MenuBar extends AbstractComponent } /** - * Returns a list with all the MenuItem objects in the menu bar + * Returns a list with all the MenuItem objects in the menu bar. * * @return a list containing the MenuItem objects in the menu bar */ @@ -291,7 +291,7 @@ public class MenuBar extends AbstractComponent } /** - * Remove first occurrence the specified item from the main menu + * Remove first occurrence the specified item from the main menu. * * @param item * The item to be removed @@ -304,7 +304,7 @@ public class MenuBar extends AbstractComponent } /** - * Empty the menu bar + * Empty the menu bar. */ public void removeItems() { menuItems.clear(); @@ -645,7 +645,7 @@ public class MenuBar extends AbstractComponent } /** - * Gets the objects text + * Gets the objects text. * * @return The text */ diff --git a/server/src/main/java/com/vaadin/ui/Panel.java b/server/src/main/java/com/vaadin/ui/Panel.java index 06d4daa9c3..def5893946 100644 --- a/server/src/main/java/com/vaadin/ui/Panel.java +++ b/server/src/main/java/com/vaadin/ui/Panel.java @@ -243,7 +243,7 @@ public class Panel extends AbstractSingleComponentContainer } /** - * Removes all action handlers + * Removes all action handlers. */ public void removeAllActionHandlers() { if (actionManager != null) { diff --git a/server/src/main/java/com/vaadin/ui/PopupView.java b/server/src/main/java/com/vaadin/ui/PopupView.java index 6ce6aafe08..fa51748ea7 100644 --- a/server/src/main/java/com/vaadin/ui/PopupView.java +++ b/server/src/main/java/com/vaadin/ui/PopupView.java @@ -317,7 +317,7 @@ public class PopupView extends AbstractComponent implements HasComponents { public String getMinimizedValueAsHTML(); /** - * This should return the full Component representing the data + * This should return the full Component representing the data. * * @return a Component for the value */ diff --git a/server/src/main/java/com/vaadin/ui/ReconnectDialogConfiguration.java b/server/src/main/java/com/vaadin/ui/ReconnectDialogConfiguration.java index f24045e1a6..c95cbbafec 100644 --- a/server/src/main/java/com/vaadin/ui/ReconnectDialogConfiguration.java +++ b/server/src/main/java/com/vaadin/ui/ReconnectDialogConfiguration.java @@ -27,15 +27,15 @@ import java.io.Serializable; public interface ReconnectDialogConfiguration extends Serializable { /** * Gets the text to show in the reconnect dialog when trying to re-establish - * the server connection + * the server connection. * * @return the text to show in the reconnect dialog */ public String getDialogText(); /** - * Sets the text to show in the reconnect dialog when trying to re-establish - * the server connection + * Sets the text to show in the reconnect dialog when trying to + * re-establish. the server connection * * @param dialogText * the text to show in the reconnect dialog @@ -44,7 +44,7 @@ public interface ReconnectDialogConfiguration extends Serializable { /** * Gets the text to show in the reconnect dialog after giving up trying to - * reconnect ({@link #getReconnectAttempts()} reached) + * reconnect ({@link #getReconnectAttempts()} reached). * * @return the text to show in the reconnect dialog after giving up */ @@ -52,7 +52,7 @@ public interface ReconnectDialogConfiguration extends Serializable { /** * Sets the text to show in the reconnect dialog after giving up trying to - * reconnect ({@link #getReconnectAttempts()} reached) + * reconnect ({@link #getReconnectAttempts()} reached). * * @param dialogTextGaveUp * the text to show in the reconnect dialog after giving up @@ -61,7 +61,7 @@ public interface ReconnectDialogConfiguration extends Serializable { /** * Gets the number of times to try to reconnect to the server before giving - * up + * up. * * @return the number of times to try to reconnect */ @@ -69,7 +69,7 @@ public interface ReconnectDialogConfiguration extends Serializable { /** * Sets the number of times to try to reconnect to the server before giving - * up + * up. * * @param reconnectAttempts * the number of times to try to reconnect @@ -77,14 +77,14 @@ public interface ReconnectDialogConfiguration extends Serializable { public void setReconnectAttempts(int reconnectAttempts); /** - * Gets the interval (in milliseconds) between reconnect attempts + * Gets the interval (in milliseconds) between reconnect attempts. * * @return the interval (in ms) between reconnect attempts */ public int getReconnectInterval(); /** - * Sets the interval (in milliseconds) between reconnect attempts + * Sets the interval (in milliseconds) between reconnect attempts. * * @param reconnectInterval * the interval (in ms) between reconnect attempts diff --git a/server/src/main/java/com/vaadin/ui/TabSheet.java b/server/src/main/java/com/vaadin/ui/TabSheet.java index 8cbd41ccc2..a9ed1e9e02 100644 --- a/server/src/main/java/com/vaadin/ui/TabSheet.java +++ b/server/src/main/java/com/vaadin/ui/TabSheet.java @@ -491,7 +491,7 @@ public class TabSheet extends AbstractComponentContainer } /** - * Sets whether the tab selection part should be shown in the UI + * Sets whether the tab selection part should be shown in the UI. * * @since 7.5 * @param tabsVisible @@ -502,7 +502,7 @@ public class TabSheet extends AbstractComponentContainer } /** - * Checks if the tab selection part should be shown in the UI + * Checks if the tab selection part should be shown in the UI. * * @return true if the tabs are shown in the UI, false otherwise * @since 7.5 @@ -1117,7 +1117,7 @@ public class TabSheet extends AbstractComponentContainer public ErrorMessage getComponentError(); /** - * Get the component related to the Tab + * Get the component related to the Tab. */ public Component getComponent(); @@ -1167,7 +1167,7 @@ public class TabSheet extends AbstractComponentContainer public void setId(String id); /** - * Gets currently set debug identifier + * Gets currently set debug identifier. * * @return current id, null if not set */ @@ -1429,7 +1429,7 @@ public class TabSheet extends AbstractComponentContainer } /** - * Gets the position of the tab + * Gets the position of the tab. * * @param tab * The tab diff --git a/server/src/main/java/com/vaadin/ui/UI.java b/server/src/main/java/com/vaadin/ui/UI.java index 5a8c87f48f..ae02df9c70 100644 --- a/server/src/main/java/com/vaadin/ui/UI.java +++ b/server/src/main/java/com/vaadin/ui/UI.java @@ -1311,7 +1311,7 @@ public abstract class UI extends AbstractSingleComponentContainer } /** - * Gets the theme currently in use by this UI + * Gets the theme currently in use by this UI. * * @return the theme name */ diff --git a/server/src/main/java/com/vaadin/ui/Upload.java b/server/src/main/java/com/vaadin/ui/Upload.java index 6d689c61f4..a23e273e09 100644 --- a/server/src/main/java/com/vaadin/ui/Upload.java +++ b/server/src/main/java/com/vaadin/ui/Upload.java @@ -614,7 +614,7 @@ public class Upload extends AbstractComponent } /** - * Listener for {@link ChangeEvent} + * Listener for {@link ChangeEvent}. * * @since 7.2 */ @@ -757,7 +757,7 @@ public class Upload extends AbstractComponent } /** - * Adds a filename change event listener + * Adds a filename change event listener. * * @param listener * the Listener to add, not null @@ -769,7 +769,7 @@ public class Upload extends AbstractComponent } /** - * Removes a filename change event listener + * Removes a filename change event listener. * * @param listener * the listener to be removed @@ -968,7 +968,7 @@ public class Upload extends AbstractComponent @FunctionalInterface public interface ProgressListener extends Serializable { /** - * Updates progress to listener + * Updates progress to listener. * * @param readBytes * bytes transferred diff --git a/server/src/main/java/com/vaadin/ui/VerticalSplitPanel.java b/server/src/main/java/com/vaadin/ui/VerticalSplitPanel.java index 4bb8c6ebfd..b5a137c3af 100644 --- a/server/src/main/java/com/vaadin/ui/VerticalSplitPanel.java +++ b/server/src/main/java/com/vaadin/ui/VerticalSplitPanel.java @@ -42,7 +42,7 @@ public class VerticalSplitPanel extends AbstractSplitPanel { } /** - * Creates a horizontal split panel containing the given components + * Creates a horizontal split panel containing the given components. * * @param firstComponent * The component to be placed above the splitter diff --git a/server/src/main/java/com/vaadin/ui/Window.java b/server/src/main/java/com/vaadin/ui/Window.java index cd0840e517..ee46c16f49 100644 --- a/server/src/main/java/com/vaadin/ui/Window.java +++ b/server/src/main/java/com/vaadin/ui/Window.java @@ -120,7 +120,7 @@ public class Window extends Panel private int orderPosition = -1; /** - * Creates a new, empty window + * Creates a new, empty window. */ public Window() { this("", null); @@ -285,7 +285,7 @@ public class Window extends Panel /** * Sets the position of the window on the screen using - * {@link #setPositionX(int)} and {@link #setPositionY(int)} + * {@link #setPositionX(int)} and {@link #setPositionY(int)}. * * @since 7.5 * @param x @@ -685,7 +685,7 @@ public class Window extends Panel } /** - * Get the window form which this event originated + * Get the window form which this event originated. * * @return the window */ @@ -911,7 +911,7 @@ public class Window extends Panel } /** - * Sets the mode for the window + * Sets the mode for the window. * * @see WindowMode * @param windowMode diff --git a/server/src/main/java/com/vaadin/ui/declarative/Design.java b/server/src/main/java/com/vaadin/ui/declarative/Design.java index 65565eb47a..8d723ef47e 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/Design.java +++ b/server/src/main/java/com/vaadin/ui/declarative/Design.java @@ -210,7 +210,7 @@ public class Design implements Serializable { } /** - * Default implementation of {@link ComponentMapper}, + * Default implementation of {@link ComponentMapper}. * * @since 7.5.0 */ @@ -741,7 +741,7 @@ public class Design implements Serializable { } /** - * Loads a design from the given input stream + * Loads a design from the given input stream. * * @param design * The stream to read the design from 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 357a9fbdf3..4773fa50e3 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java +++ b/server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java @@ -74,7 +74,7 @@ public class DesignAttributeHandler implements Serializable { } /** - * Clears the children and attributes of the given element + * Clears the children and attributes of the given element. * * @param design * the element to be cleared @@ -136,7 +136,7 @@ public class DesignAttributeHandler implements Serializable { /** * Searches for supported setter and getter types from the specified class - * and returns the list of corresponding design attributes + * and returns the list of corresponding design attributes. * * @param clazz * the class scanned for setters @@ -188,7 +188,7 @@ public class DesignAttributeHandler implements Serializable { /** * Writes the specified attribute to the design if it differs from the - * default value got from the <code> defaultInstance </code> + * default value got from the <code> defaultInstance </code>. * * @param component * the component used to get the attribute value diff --git a/server/src/main/java/com/vaadin/ui/declarative/DesignContext.java b/server/src/main/java/com/vaadin/ui/declarative/DesignContext.java index 042fa77826..61510dfee6 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/DesignContext.java +++ b/server/src/main/java/com/vaadin/ui/declarative/DesignContext.java @@ -337,7 +337,7 @@ public class DesignContext implements Serializable { /** * Gets the package corresponding to the give prefix, or <code>null</code> - * no package has been registered for the prefix + * no package has been registered for the prefix. * * @since 7.5.0 * @see #addPackagePrefix(String, String) @@ -493,7 +493,7 @@ public class DesignContext implements Serializable { } /** - * Reads the given design node and creates the corresponding component tree + * Reads the given design node and creates the corresponding component tree. * * @param componentDesign * The design element containing the description of the component @@ -511,7 +511,7 @@ public class DesignContext implements Serializable { /** * * Reads the given design node and populates the given component with the - * corresponding component tree + * corresponding component tree. * <p> * Additionally registers the component id, local id and caption of the * given component and all its children in the context @@ -670,7 +670,7 @@ public class DesignContext implements Serializable { } /** - * Interface to be implemented by component creation listeners + * Interface to be implemented by component creation listeners. * * @author Vaadin Ltd */ @@ -678,7 +678,7 @@ public class DesignContext implements Serializable { public interface ComponentCreationListener extends Serializable { /** - * Called when component has been created in the design context + * Called when component has been created in the design context. * * @param event * the component creation event containing information on the @@ -688,8 +688,8 @@ public class DesignContext implements Serializable { } /** - * Component creation event that is fired when a component is created in the - * context + * Component creation event that is fired when a component is created in + * the. context * * @author Vaadin Ltd */ @@ -713,7 +713,7 @@ public class DesignContext implements Serializable { } /** - * Returns the local id of the created component or null if not exist + * Returns the local id of the created component or null if not exist. * * @return the localId */ @@ -722,7 +722,7 @@ public class DesignContext implements Serializable { } /** - * Returns the created component + * Returns the created component. * * @return the component */ @@ -733,7 +733,7 @@ public class DesignContext implements Serializable { /** * Helper method for component write implementors to determine whether their - * children should be written out or not + * children should be written out or not. * * @param c * The component being written @@ -810,7 +810,7 @@ public class DesignContext implements Serializable { } /** - * Gets the attributes that the component did not handle + * Gets the attributes that the component did not handle. * * @since 7.7 * @param component diff --git a/server/src/main/java/com/vaadin/ui/declarative/FieldBindingException.java b/server/src/main/java/com/vaadin/ui/declarative/FieldBindingException.java index 54ab899b0c..e5f86481a3 100644 --- a/server/src/main/java/com/vaadin/ui/declarative/FieldBindingException.java +++ b/server/src/main/java/com/vaadin/ui/declarative/FieldBindingException.java @@ -17,7 +17,7 @@ package com.vaadin.ui.declarative; /** * Exception that is thrown when an error occurs during field binding when - * reading a design template + * reading a design template. * * @since 7.4 * @author Vaadin Ltd 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 d8c112110d..eb83738af7 100644 --- a/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java +++ b/server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java @@ -116,7 +116,7 @@ public abstract class AbstractRenderer<T, V> extends AbstractExtension } /** - * Null representation for the renderer + * Null representation for the renderer. * * @return a textual representation of {@code null} */ diff --git a/server/src/main/java/com/vaadin/ui/renderers/ProgressBarRenderer.java b/server/src/main/java/com/vaadin/ui/renderers/ProgressBarRenderer.java index bf851e5567..2494a4aabd 100644 --- a/server/src/main/java/com/vaadin/ui/renderers/ProgressBarRenderer.java +++ b/server/src/main/java/com/vaadin/ui/renderers/ProgressBarRenderer.java @@ -29,7 +29,7 @@ import elemental.json.JsonValue; public class ProgressBarRenderer extends AbstractRenderer<Object, Double> { /** - * Creates a new text renderer + * Creates a new text renderer. */ public ProgressBarRenderer() { super(Double.class, null); diff --git a/server/src/main/java/com/vaadin/ui/themes/ValoTheme.java b/server/src/main/java/com/vaadin/ui/themes/ValoTheme.java index 93235ed00f..e9990b8660 100644 --- a/server/src/main/java/com/vaadin/ui/themes/ValoTheme.java +++ b/server/src/main/java/com/vaadin/ui/themes/ValoTheme.java @@ -602,7 +602,7 @@ public class ValoTheme { public static final String TABLE_NO_STRIPES = "no-stripes"; /** - * See {@link #TABLE_NO_STRIPES} + * See {@link #TABLE_NO_STRIPES}. */ public static final String TREETABLE_NO_STRIPES = TABLE_NO_STRIPES; @@ -613,7 +613,7 @@ public class ValoTheme { public static final String TABLE_NO_VERTICAL_LINES = "no-vertical-lines"; /** - * See {@link #TABLE_NO_VERTICAL_LINES} + * See {@link #TABLE_NO_VERTICAL_LINES}. */ public static final String TREETABLE_NO_VERTICAL_LINES = TABLE_NO_VERTICAL_LINES; @@ -624,7 +624,7 @@ public class ValoTheme { public static final String TABLE_NO_HORIZONTAL_LINES = "no-horizontal-lines"; /** - * See {@link #TABLE_NO_HORIZONTAL_LINES} + * See {@link #TABLE_NO_HORIZONTAL_LINES}. */ public static final String TREETABLE_NO_HORIZONTAL_LINES = TABLE_NO_HORIZONTAL_LINES; @@ -636,7 +636,7 @@ public class ValoTheme { public static final String TABLE_NO_HEADER = "no-header"; /** - * See {@link #TABLE_NO_HEADER} + * See {@link #TABLE_NO_HEADER}. */ public static final String TREETABLE_NO_HEADER = TABLE_NO_HEADER; @@ -647,7 +647,7 @@ public class ValoTheme { public static final String TABLE_BORDERLESS = "borderless"; /** - * See {@link #TABLE_BORDERLESS} + * See {@link #TABLE_BORDERLESS}. */ public static final String TREETABLE_BORDERLESS = TABLE_BORDERLESS; @@ -658,7 +658,7 @@ public class ValoTheme { public static final String TABLE_COMPACT = "compact"; /** - * See {@link #TABLE_COMPACT} + * See {@link #TABLE_COMPACT}. */ public static final String TREETABLE_COMPACT = TABLE_COMPACT; @@ -669,7 +669,7 @@ public class ValoTheme { public static final String TABLE_SMALL = "small"; /** - * See {@link #TABLE_SMALL} + * See {@link #TABLE_SMALL}. */ public static final String TREETABLE_SMALL = TABLE_SMALL; @@ -1041,9 +1041,9 @@ public class ValoTheme { * * <p> * The text content of the logo should be very short, since the logo area - * only shows approximately three letters. Using one of the - * Vaadin Icons is a good way to quickly create a logo for your - * application. Vaadin Icons are included in the Valo theme. + * only shows approximately three letters. Using one of the Vaadin Icons is + * a good way to quickly create a logo for your application. Vaadin Icons + * are included in the Valo theme. * <p> * * <h4>Example</h4> diff --git a/server/src/main/java/com/vaadin/util/ConnectorHelper.java b/server/src/main/java/com/vaadin/util/ConnectorHelper.java index 480724ae5e..d8d66c909b 100644 --- a/server/src/main/java/com/vaadin/util/ConnectorHelper.java +++ b/server/src/main/java/com/vaadin/util/ConnectorHelper.java @@ -30,7 +30,7 @@ import com.vaadin.ui.Component; public class ConnectorHelper { /** - * Creates a string containing debug info for the connector + * Creates a string containing debug info for the connector. * * @since 7.1 * @param connector @@ -56,7 +56,7 @@ public class ConnectorHelper { } /** - * Creates a string containing hierarchy information for the connector + * Creates a string containing hierarchy information for the connector. * * @since 7.1 * @param connector diff --git a/shared/src/main/java/com/vaadin/shared/AbstractComponentState.java b/shared/src/main/java/com/vaadin/shared/AbstractComponentState.java index 9b949111a7..3f942c81a4 100644 --- a/shared/src/main/java/com/vaadin/shared/AbstractComponentState.java +++ b/shared/src/main/java/com/vaadin/shared/AbstractComponentState.java @@ -44,11 +44,11 @@ public class AbstractComponentState extends SharedState { public String id = null; public String primaryStyleName = null; - /** HTML formatted error message for the component */ + /** HTML formatted error message for the component. */ public String errorMessage = null; /** - * Level of error + * Level of error. * * @since 8.2 */ diff --git a/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java b/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java index 4ce1ee0ac0..6a16508afa 100644 --- a/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java +++ b/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java @@ -55,7 +55,7 @@ public class ApplicationConstants implements Serializable { public static final String FRONTEND_PROTOCOL_PREFIX = "frontend://"; /** - * Prefix used for theme resource URLs + * Prefix used for theme resource URLs. * * @see com.vaadin.server.ThemeResource * @since 7.5.0 @@ -156,14 +156,14 @@ public class ApplicationConstants implements Serializable { public static final String PUSH_ID_PARAMETER = "v-pushId"; /** - * The name of the parameter used to transmit RPC invocations + * The name of the parameter used to transmit RPC invocations. * * @since 7.2 */ public static final String RPC_INVOCATIONS = "rpc"; /** - * The name of the parameter used to transmit the CSRF token + * The name of the parameter used to transmit the CSRF token. * * @since 7.2 */ @@ -199,7 +199,7 @@ public class ApplicationConstants implements Serializable { /** * The name of the parameter used for sending the widget set version to the - * server + * server. * * @since 7.6 */ diff --git a/shared/src/main/java/com/vaadin/shared/ContextClickRpc.java b/shared/src/main/java/com/vaadin/shared/ContextClickRpc.java index f51f2fdf95..6288f3ea99 100644 --- a/shared/src/main/java/com/vaadin/shared/ContextClickRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ContextClickRpc.java @@ -18,7 +18,7 @@ package com.vaadin.shared; import com.vaadin.shared.communication.ServerRpc; /** - * Client-to-server RPC interface for context click events + * Client-to-server RPC interface for context click events. * * @since 7.6 * @author Vaadin Ltd diff --git a/shared/src/main/java/com/vaadin/shared/MouseEventDetails.java b/shared/src/main/java/com/vaadin/shared/MouseEventDetails.java index 3954206138..a438f604d5 100644 --- a/shared/src/main/java/com/vaadin/shared/MouseEventDetails.java +++ b/shared/src/main/java/com/vaadin/shared/MouseEventDetails.java @@ -54,7 +54,7 @@ public class MouseEventDetails implements Serializable { } /** - * Returns a human readable text representing the button + * Returns a human readable text representing the button. * * @return */ diff --git a/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java b/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java index fcdbc5bf0e..61161ea3cc 100644 --- a/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java +++ b/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java @@ -358,7 +358,7 @@ public class VBrowserDetails implements Serializable { } /** - * Tests if the browser is using the Gecko engine + * Tests if the browser is using the Gecko engine. * * @return true if it is Gecko, false otherwise */ @@ -367,7 +367,7 @@ public class VBrowserDetails implements Serializable { } /** - * Tests if the browser is using the WebKit engine + * Tests if the browser is using the WebKit engine. * * @return true if it is WebKit, false otherwise */ @@ -376,7 +376,7 @@ public class VBrowserDetails implements Serializable { } /** - * Tests if the browser is using the Presto engine + * Tests if the browser is using the Presto engine. * * @return true if it is Presto, false otherwise */ @@ -385,7 +385,7 @@ public class VBrowserDetails implements Serializable { } /** - * Tests if the browser is using the Trident engine + * Tests if the browser is using the Trident engine. * * @since 7.1.7 * @return true if it is Trident, false otherwise diff --git a/shared/src/main/java/com/vaadin/shared/communication/PushMode.java b/shared/src/main/java/com/vaadin/shared/communication/PushMode.java index cf19c0b39e..b31726b16f 100644 --- a/shared/src/main/java/com/vaadin/shared/communication/PushMode.java +++ b/shared/src/main/java/com/vaadin/shared/communication/PushMode.java @@ -54,7 +54,7 @@ public enum PushMode { AUTOMATIC; /** - * Checks whether the push mode is using push functionality + * Checks whether the push mode is using push functionality. * * @return <code>true</code> if this mode requires push functionality; * <code>false</code> if no push functionality is used for this diff --git a/shared/src/main/java/com/vaadin/shared/communication/URLReference.java b/shared/src/main/java/com/vaadin/shared/communication/URLReference.java index 24bde87b3b..0b993a196d 100644 --- a/shared/src/main/java/com/vaadin/shared/communication/URLReference.java +++ b/shared/src/main/java/com/vaadin/shared/communication/URLReference.java @@ -33,7 +33,7 @@ public class URLReference implements Serializable { } /** - * Sets the URL that this object refers to + * Sets the URL that this object refers to. * * @param URL */ diff --git a/shared/src/main/java/com/vaadin/shared/ui/AlignmentInfo.java b/shared/src/main/java/com/vaadin/shared/ui/AlignmentInfo.java index b595e5ca1f..e2e3f98f8a 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/AlignmentInfo.java +++ b/shared/src/main/java/com/vaadin/shared/ui/AlignmentInfo.java @@ -19,7 +19,7 @@ package com.vaadin.shared.ui; import java.io.Serializable; public final class AlignmentInfo implements Serializable { - /** Bitmask values for client server communication */ + /** Bitmask values for client server communication. */ public static class Bits implements Serializable { public static final int ALIGNMENT_LEFT = 1; public static final int ALIGNMENT_RIGHT = 2; diff --git a/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java b/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java index 95fdf0a0d9..e3196e91ad 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java @@ -17,6 +17,7 @@ package com.vaadin.shared.ui; /** * Represents the error levels displayed on components. + * * @author Vaadin Ltd * @since 8.2 */ @@ -48,7 +49,7 @@ public enum ErrorLevel { SYSTEM; /** - * Integer representation of error severity for comparison + * Integer representation of error severity for comparison. * * @return integer for error severity */ diff --git a/shared/src/main/java/com/vaadin/shared/ui/MultiSelectMode.java b/shared/src/main/java/com/vaadin/shared/ui/MultiSelectMode.java index f4ea23377e..54f30684d4 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/MultiSelectMode.java +++ b/shared/src/main/java/com/vaadin/shared/ui/MultiSelectMode.java @@ -20,12 +20,12 @@ package com.vaadin.shared.ui; */ public enum MultiSelectMode { /** - * The default behavior of the multi select mode + * The default behavior of the multi select mode. */ DEFAULT, /** - * The previous more simple behavior of the multi select + * The previous more simple behavior of the multi select. */ SIMPLE } 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 70f552673f..4103eb9fe2 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 @@ -19,7 +19,7 @@ import java.util.ArrayList; import java.util.List; /** - * Resolutions for DateFields + * Resolutions for DateFields. * * @author Vaadin Ltd. * @since 8.0 diff --git a/shared/src/main/java/com/vaadin/shared/ui/dnd/DropTargetState.java b/shared/src/main/java/com/vaadin/shared/ui/dnd/DropTargetState.java index edd8beddbd..39224e66d8 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/dnd/DropTargetState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/dnd/DropTargetState.java @@ -29,12 +29,12 @@ import com.vaadin.shared.ui.dnd.criteria.Criterion; */ public class DropTargetState extends SharedState { /** - * {@code DataTransfer.dropEffect} parameter for the drag event + * {@code DataTransfer.dropEffect} parameter for the drag event. */ public DropEffect dropEffect; /** - * Criteria script to allow drop event on the element + * Criteria script to allow drop event on the element. */ public String criteriaScript; @@ -45,7 +45,7 @@ public class DropTargetState extends SharedState { /** * Declares whether any or all of the given criteria should match the - * payload + * payload. */ public Criterion.Match criteriaMatch = Criterion.Match.ANY; } diff --git a/shared/src/main/java/com/vaadin/shared/ui/dnd/EffectAllowed.java b/shared/src/main/java/com/vaadin/shared/ui/dnd/EffectAllowed.java index e5afa8f5eb..5181aae9b0 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/dnd/EffectAllowed.java +++ b/shared/src/main/java/com/vaadin/shared/ui/dnd/EffectAllowed.java @@ -63,7 +63,7 @@ public enum EffectAllowed { ALL("all"), /** - * Default state, equivalent to ALL + * Default state, equivalent to ALL. */ UNINITIALIZED("uninitialized"); diff --git a/shared/src/main/java/com/vaadin/shared/ui/dnd/criteria/Criterion.java b/shared/src/main/java/com/vaadin/shared/ui/dnd/criteria/Criterion.java index c90637a6e0..f5dba346e5 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/dnd/criteria/Criterion.java +++ b/shared/src/main/java/com/vaadin/shared/ui/dnd/criteria/Criterion.java @@ -62,13 +62,13 @@ public class Criterion implements Serializable { } /** - * Creates a criterion object with the default comparison operator {@link - * ComparisonOperator#EQUALS}. + * Creates a criterion object with the default comparison operator + * {@link ComparisonOperator#EQUALS}. * * @param key - * key of the payload to be compared + * key of the payload to be compared * @param value - * value of the payload to be compared + * value of the payload to be compared */ public Criterion(String key, String value) { this(key, ComparisonOperator.EQUALS, value, Payload.ValueType.STRING); @@ -78,11 +78,11 @@ public class Criterion implements Serializable { * Creates a criterion object. * * @param key - * key of the payload to be compared + * key of the payload to be compared * @param operator - * comparison operator + * comparison operator * @param value - * value of the payload to be compared + * value of the payload to be compared */ public Criterion(String key, ComparisonOperator operator, int value) { this(key, operator, String.valueOf(value), Payload.ValueType.INTEGER); @@ -92,11 +92,11 @@ public class Criterion implements Serializable { * Creates a criterion object. * * @param key - * key of the payload to be compared + * key of the payload to be compared * @param operator - * comparison operator + * comparison operator * @param value - * value of the payload to be compared + * value of the payload to be compared */ public Criterion(String key, ComparisonOperator operator, double value) { this(key, operator, String.valueOf(value), Payload.ValueType.DOUBLE); @@ -106,13 +106,13 @@ public class Criterion implements Serializable { * Creates a criterion object. * * @param key - * key of the payload to be compared + * key of the payload to be compared * @param operator - * comparison operator + * comparison operator * @param value - * value of the payload to be compared + * value of the payload to be compared * @param valueType - * type of the payload to be compared + * type of the payload to be compared */ private Criterion(String key, ComparisonOperator operator, String value, Payload.ValueType valueType) { @@ -123,7 +123,7 @@ public class Criterion implements Serializable { } /** - * Gets the key of the payload to be compared + * Gets the key of the payload to be compared. * * @return key of the payload to be compared */ @@ -132,7 +132,7 @@ public class Criterion implements Serializable { } /** - * Gets the value of the payload to be compared + * Gets the value of the payload to be compared. * * @return value of the payload to be compared */ @@ -141,7 +141,7 @@ public class Criterion implements Serializable { } /** - * Gets the type of the payload value to be compared + * Gets the type of the payload value to be compared. * * @return type of the payload value to be compared */ @@ -165,15 +165,17 @@ public class Criterion implements Serializable { * and value type. * * @param payloadCollection - * collection of payloads to compare the criterion against + * collection of payloads to compare the criterion against * @return {@code false} if there exists a payload in the collection with - * the same key and value type and it doesn't match the criterion, {@code + * the same key and value type and it doesn't match the criterion, + * {@code * true} otherwise */ public boolean resolve(Collection<Payload> payloadCollection) { Optional<Payload> payload = payloadCollection.stream() - .filter(p -> p.getKey().equals(key) && p.getValueType() - .equals(valueType)).findAny(); + .filter(p -> p.getKey().equals(key) + && p.getValueType().equals(valueType)) + .findAny(); return payload.map(this::compareCriterionValue).orElse(true); } diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/GridConstants.java b/shared/src/main/java/com/vaadin/shared/ui/grid/GridConstants.java index a38ce4cd78..9d3a8744c7 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/grid/GridConstants.java +++ b/shared/src/main/java/com/vaadin/shared/ui/grid/GridConstants.java @@ -74,28 +74,28 @@ public final class GridConstants implements Serializable { public static final double DEFAULT_COLUMN_WIDTH_PX = -1; /** - * Event ID for item click events + * Event ID for item click events. */ public static final String ITEM_CLICK_EVENT_ID = "itemClick"; - /** The default save button caption in the editor */ + /** The default save button caption in the editor. */ public static final String DEFAULT_SAVE_CAPTION = "Save"; - /** The default cancel button caption in the editor */ + /** The default cancel button caption in the editor. */ public static final String DEFAULT_CANCEL_CAPTION = "Cancel"; /** - * Event ID constant for editor open event + * Event ID constant for editor open event. */ public static final String EDITOR_OPEN_EVENT_ID = "editorOpen"; /** - * Event ID constant for editor move event + * Event ID constant for editor move event. */ public static final String EDITOR_MOVE_EVENT_ID = "editorMove"; /** - * Event ID constant for editor close event + * Event ID constant for editor close event. */ public static final String EDITOR_CLOSE_EVENT_ID = "editorClose"; } diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/GridStaticCellType.java b/shared/src/main/java/com/vaadin/shared/ui/grid/GridStaticCellType.java index 5867603912..1c2ecfd1e8 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/grid/GridStaticCellType.java +++ b/shared/src/main/java/com/vaadin/shared/ui/grid/GridStaticCellType.java @@ -23,17 +23,17 @@ package com.vaadin.shared.ui.grid; */ public enum GridStaticCellType { /** - * Text content + * Text content. */ TEXT, /** - * HTML content + * HTML content. */ HTML, /** - * Widget content + * Widget content. */ WIDGET; } diff --git a/shared/src/main/java/com/vaadin/shared/ui/loginform/LoginFormConstants.java b/shared/src/main/java/com/vaadin/shared/ui/loginform/LoginFormConstants.java index 0efa948f52..6679df30e5 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/loginform/LoginFormConstants.java +++ b/shared/src/main/java/com/vaadin/shared/ui/loginform/LoginFormConstants.java @@ -18,7 +18,7 @@ package com.vaadin.shared.ui.loginform; import java.io.Serializable; /** - * Constants for LoginForm + * Constants for LoginForm. * * @since 7.7 * @author Vaadin Ltd diff --git a/shared/src/main/java/com/vaadin/shared/ui/progressindicator/ProgressBarState.java b/shared/src/main/java/com/vaadin/shared/ui/progressindicator/ProgressBarState.java index 13e78b9b2d..cdc6a2bcf0 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/progressindicator/ProgressBarState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/progressindicator/ProgressBarState.java @@ -21,7 +21,7 @@ import com.vaadin.shared.annotations.NoLayout; import com.vaadin.shared.communication.SharedState; /** - * {@link SharedState} for {@link com.vaadin.ui.ProgressBar} + * {@link SharedState} for {@link com.vaadin.ui.ProgressBar}. * * @since 7.1 * @author Vaadin Ltd diff --git a/shared/src/main/java/com/vaadin/shared/ui/tabsheet/TabsheetState.java b/shared/src/main/java/com/vaadin/shared/ui/tabsheet/TabsheetState.java index 2755f48b43..3af0da9b42 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/tabsheet/TabsheetState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/tabsheet/TabsheetState.java @@ -38,10 +38,10 @@ public class TabsheetState extends AbstractComponentContainerState { public List<TabState> tabs = new ArrayList<>(); - /** true to show the tab bar, false to only show the contained component */ + /** true to show the tab bar, false to only show the contained component. */ public boolean tabsVisible = true; - /** the key of the currently selected tab */ + /** the key of the currently selected tab. */ public String selected; @DelegateToWidget diff --git a/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusParentRpc.java b/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusParentRpc.java index 333fc84d35..9f45ba7428 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusParentRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusParentRpc.java @@ -26,7 +26,7 @@ import com.vaadin.shared.communication.ServerRpc; public interface FocusParentRpc extends ServerRpc { /** - * Focuses cell in the row parent + * Focuses cell in the row parent. * * @param rowKey * the row key diff --git a/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusRpc.java b/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusRpc.java index fa02a0d712..5fc89e8152 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/treegrid/FocusRpc.java @@ -27,7 +27,7 @@ import com.vaadin.shared.communication.ClientRpc; public interface FocusRpc extends ClientRpc { /** - * Focuses a cell + * Focuses a cell. * * @param rowIndex * the row index diff --git a/shared/src/main/java/com/vaadin/shared/ui/ui/DebugWindowServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/ui/DebugWindowServerRpc.java index 3a3b04091c..760c7b1abc 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ui/DebugWindowServerRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ui/DebugWindowServerRpc.java @@ -38,7 +38,7 @@ public interface DebugWindowServerRpc extends ServerRpc { public void showServerDebugInfo(Connector connector); /** - * Invokes the layout analyzer on the server + * Invokes the layout analyzer on the server. * * @since 7.1 */ diff --git a/shared/src/main/java/com/vaadin/shared/ui/ui/Transport.java b/shared/src/main/java/com/vaadin/shared/ui/ui/Transport.java index 3e0aea6f1a..c8bd19ef12 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ui/Transport.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ui/Transport.java @@ -17,31 +17,31 @@ package com.vaadin.shared.ui.ui; /** - * Transport modes for Push + * Transport modes for Push. * * @since 7.1 * @author Vaadin Ltd */ public enum Transport { /** - * Websockets + * Websockets. */ WEBSOCKET("websocket"), /** - * Websockets for server to client, XHR for client to server + * Websockets for server to client, XHR for client to server. * * @since 7.6 */ WEBSOCKET_XHR("websocket-xhr"), /** - * HTTP streaming + * HTTP streaming. * * @deprecated Use the more reliable {@link Transport#LONG_POLLING} instead. */ @Deprecated STREAMING("streaming"), /** - * HTTP long polling + * HTTP long polling. */ LONG_POLLING("long-polling"); diff --git a/shared/src/main/java/com/vaadin/shared/ui/ui/UIClientRpc.java b/shared/src/main/java/com/vaadin/shared/ui/ui/UIClientRpc.java index 1b9a31ac6e..30e51234fd 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ui/UIClientRpc.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ui/UIClientRpc.java @@ -18,7 +18,7 @@ package com.vaadin.shared.ui.ui; import com.vaadin.shared.communication.ClientRpc; /** - * Server to Client RPC methods for UI + * Server to Client RPC methods for UI. * * @since 7.1 * @author Vaadin Ltd @@ -26,7 +26,7 @@ import com.vaadin.shared.communication.ClientRpc; public interface UIClientRpc extends ClientRpc { /** - * Informs the client that the UI has been closed + * Informs the client that the UI has been closed. * * @param sessionExpired * true if the ui was closed because the session expired, false diff --git a/shared/src/main/java/com/vaadin/shared/ui/ui/UIConstants.java b/shared/src/main/java/com/vaadin/shared/ui/ui/UIConstants.java index 54da337189..ba76f765b3 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ui/UIConstants.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ui/UIConstants.java @@ -31,7 +31,7 @@ public class UIConstants implements Serializable { public static final String ATTRIBUTE_REPLACE_STATE = "rs"; /** - * Name of the parameter used to transmit UI ids back and forth + * Name of the parameter used to transmit UI ids back and forth. */ public static final String UI_ID_PARAMETER = "v-uiId"; diff --git a/shared/src/main/java/com/vaadin/shared/ui/ui/UIState.java b/shared/src/main/java/com/vaadin/shared/ui/ui/UIState.java index a86d79da05..182363f849 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/ui/UIState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/ui/UIState.java @@ -70,7 +70,7 @@ public class UIState extends AbstractSingleComponentContainerState { */ public LocaleServiceState localeServiceState = new LocaleServiceState(); /** - * Configuration for the push channel + * Configuration for the push channel. */ public PushConfigurationState pushConfiguration = new PushConfigurationState(); /** diff --git a/shared/src/main/java/com/vaadin/shared/ui/upload/UploadState.java b/shared/src/main/java/com/vaadin/shared/ui/upload/UploadState.java index 5245905441..3fb4e32828 100644 --- a/shared/src/main/java/com/vaadin/shared/ui/upload/UploadState.java +++ b/shared/src/main/java/com/vaadin/shared/ui/upload/UploadState.java @@ -24,7 +24,7 @@ import com.vaadin.shared.AbstractComponentState; */ public class UploadState extends AbstractComponentState { - /** Is the upload component in immediate mode or not */ + /** Is the upload component in immediate mode or not. */ public boolean immediateMode = true; { diff --git a/shared/src/main/java/com/vaadin/shared/util/SharedUtil.java b/shared/src/main/java/com/vaadin/shared/util/SharedUtil.java index 4f1b71687b..2cab2fd5b5 100644 --- a/shared/src/main/java/com/vaadin/shared/util/SharedUtil.java +++ b/shared/src/main/java/com/vaadin/shared/util/SharedUtil.java @@ -173,7 +173,7 @@ public class SharedUtil implements Serializable { /** * Capitalizes the first character in the given string in a way suitable for - * use in code (methods, properties etc) + * use in code (methods, properties etc). * * @since 7.4 * @param string @@ -230,8 +230,8 @@ public class SharedUtil implements Serializable { * @param uri * The uri to which the parameters should be added. * @param extraParams - * One or more parameters in the format "a=b" or "c=d&e=f". An - * empty string is allowed but will not modify the url. + * One or more parameters in the format "a=b" or "c=d&e=f". + * An empty string is allowed but will not modify the url. * @return The modified URI with the get parameters in extraParams added. */ public static String addGetParameters(String uri, String extraParams) { diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractComponentElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractComponentElement.java index 7a4963d4ab..39859cf830 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractComponentElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractComponentElement.java @@ -24,7 +24,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; @ServerClass("com.vaadin.ui.AbstractComponent") public class AbstractComponentElement extends AbstractElement { /** - * Returns the caption of the Component element + * Returns the caption of the Component element. * * @since 8.0 * @return component caption diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractFieldElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractFieldElement.java index 566b73883b..d53f1ddc32 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractFieldElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractFieldElement.java @@ -24,7 +24,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; public class AbstractFieldElement extends AbstractComponentElement { /** - * Select contents of TextField Element + * Select contents of TextField Element. * * NOTE: When testing with firefox browser window should have focus in it * diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractTextFieldElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractTextFieldElement.java index 6435f4a096..f619593709 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractTextFieldElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/AbstractTextFieldElement.java @@ -24,7 +24,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; public class AbstractTextFieldElement extends AbstractFieldElement { /** - * Return value of the field element + * Return value of the field element. * * @return value of the field element */ @@ -33,7 +33,7 @@ public class AbstractTextFieldElement extends AbstractFieldElement { } /** - * Set value of the field element + * Set value of the field element. * * @param chars * new value of the field diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/CheckBoxElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/CheckBoxElement.java index 788d4a917d..1a2768161f 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/CheckBoxElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/CheckBoxElement.java @@ -26,7 +26,7 @@ public class CheckBoxElement extends AbstractFieldElement { /** * Return string representation of value of the checkbox Return either - * checked or unchecked + * checked or unchecked. */ public String getValue() { if (isChecked()) { diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/ComboBoxElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/ComboBoxElement.java index 2eaef4f015..211d94cac6 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/ComboBoxElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/ComboBoxElement.java @@ -118,14 +118,14 @@ public class ComboBoxElement extends AbstractSingleSelectElement { } /** - * Open the suggestion popup + * Open the suggestion popup. */ public void openPopup() { findElement(By.vaadin("#button")).click(); } /** - * Gets the text representation of all suggestions on the current page + * Gets the text representation of all suggestions on the current page. * * @return List of suggestion texts */ @@ -191,7 +191,7 @@ public class ComboBoxElement extends AbstractSingleSelectElement { } /** - * Returns the suggestion popup element + * Returns the suggestion popup element. */ public WebElement getSuggestionPopup() { ensurePopupOpen(); diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/GridElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/GridElement.java index 9530f07de3..7f57cc10a7 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/GridElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/GridElement.java @@ -29,7 +29,7 @@ import com.vaadin.testbench.elementsbase.AbstractElement; import com.vaadin.testbench.elementsbase.ServerClass; /** - * TestBench Element API for Grid + * TestBench Element API for Grid. * * @author Vaadin Ltd */ @@ -157,7 +157,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Scrolls Grid element so that wanted row is displayed + * Scrolls Grid element so that wanted row is displayed. * * @param index * Target row @@ -316,7 +316,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get header row count + * Get header row count. * * @return Header row count */ @@ -325,7 +325,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get footer row count + * Get footer row count. * * @return Footer row count */ @@ -334,7 +334,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get a header row by index + * Get a header row by index. * * @param rowIndex * Row index @@ -345,7 +345,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get a footer row by index + * Get a footer row by index. * * @param rowIndex * Row index @@ -356,7 +356,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the vertical scroll element + * Get the vertical scroll element. * * @return The element representing the vertical scrollbar */ @@ -366,7 +366,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the horizontal scroll element + * Get the horizontal scroll element. * * @return The element representing the horizontal scrollbar */ @@ -376,7 +376,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the header element + * Get the header element. * * @return The thead element */ @@ -385,7 +385,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the body element + * Get the body element. * * @return the tbody element */ @@ -394,7 +394,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the footer element + * Get the footer element. * * @return the tfoot element */ @@ -403,7 +403,7 @@ public class GridElement extends AbstractComponentElement { } /** - * Get the element wrapping the table element + * Get the element wrapping the table element. * * @return The element that wraps the table element */ diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/ListSelectElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/ListSelectElement.java index f484854700..e4e12345fa 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/ListSelectElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/ListSelectElement.java @@ -102,7 +102,7 @@ public class ListSelectElement extends AbstractSelectElement { } /** - * Return value of the list select element + * Return value of the list select element. * * @return value of the list select element */ diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/NotificationElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/NotificationElement.java index 6ba2a0f339..584dd6de2b 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/NotificationElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/NotificationElement.java @@ -30,7 +30,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; @ServerClass("com.vaadin.ui.Notification") public class NotificationElement extends AbstractElement { /** - * Closes a notification + * Closes a notification. * * @throws TimeoutException * If a notification can not be closed and the timeout expires. @@ -45,7 +45,7 @@ public class NotificationElement extends AbstractElement { } /** - * Returns the caption of the Notification element + * Returns the caption of the Notification element. * * @since 8.0 * @return the caption of the Notification element @@ -57,7 +57,7 @@ public class NotificationElement extends AbstractElement { } /** - * Returns description of the Notification element + * Returns description of the Notification element. * * @return description of the Notification element */ @@ -68,7 +68,7 @@ public class NotificationElement extends AbstractElement { } /** - * Returns type of the Notification element + * Returns type of the Notification element. * * @return type of the Notification element */ diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/OptionGroupElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/OptionGroupElement.java index 8c5dcea181..b35de4fc83 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/OptionGroupElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/OptionGroupElement.java @@ -56,7 +56,7 @@ public class OptionGroupElement extends AbstractSelectElement { } /** - * Return value of the selected option in the option group + * Return value of the selected option in the option group. * * @return value of the selected option in the option group */ @@ -75,7 +75,7 @@ public class OptionGroupElement extends AbstractSelectElement { } /** - * Select option in the option group with the specified value + * Select option in the option group with the specified value. * * @param chars * value of the option in the option group which will be selected diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/PasswordFieldElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/PasswordFieldElement.java index ed0c8da0c5..d93f45f5a1 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/PasswordFieldElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/PasswordFieldElement.java @@ -20,7 +20,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; @ServerClass("com.vaadin.ui.PasswordField") public class PasswordFieldElement extends AbstractTextFieldElement { /** - * Return value of the password element + * Return value of the password element. * * @since 8.0 * @return value of the password element diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/ProgressBarElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/ProgressBarElement.java index f567dbf904..271983a8dd 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/ProgressBarElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/ProgressBarElement.java @@ -24,7 +24,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; public class ProgressBarElement extends AbstractFieldElement { /** - * Retrns the value of the progress bar + * Returns the value of the progress bar. * * @return */ diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/RadioButtonGroupElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/RadioButtonGroupElement.java index 4cff189ea7..30952c1e00 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/RadioButtonGroupElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/RadioButtonGroupElement.java @@ -55,7 +55,7 @@ public class RadioButtonGroupElement extends AbstractSingleSelectElement { } /** - * Return value of the selected option in the option group + * Return value of the selected option in the option group. * * @return value of the selected option in the option group */ @@ -74,7 +74,7 @@ public class RadioButtonGroupElement extends AbstractSingleSelectElement { } /** - * Select option in the option group with the specified value + * Select option in the option group with the specified value. * * @param chars * value of the option in the option group which will be selected diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/TableElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/TableElement.java index da167805e8..fb6c2c9003 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/TableElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/TableElement.java @@ -52,7 +52,7 @@ public class TableElement extends AbstractSelectElement { } /** - * Return table row element by zero-based index + * Return table row element by zero-based index. * * @return table row element by zero-based index */ @@ -78,7 +78,7 @@ public class TableElement extends AbstractSelectElement { } /** - * Function to get footer cell with given column index + * Function to get footer cell with given column index. * * @param column * 0 based column index @@ -130,7 +130,7 @@ public class TableElement extends AbstractSelectElement { } /** - * Fetches the context menu for the table + * Fetches the context menu for the table. * * @return {@link com.vaadin.testbench.elements.TableElement.ContextMenuElement} * @throws java.util.NoSuchElementException diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/TextAreaElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/TextAreaElement.java index db38820d91..0eda9ae680 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/TextAreaElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/TextAreaElement.java @@ -22,7 +22,7 @@ import com.vaadin.testbench.elementsbase.ServerClass; @ServerClass("com.vaadin.ui.TextArea") public class TextAreaElement extends AbstractTextFieldElement { /** - * Return value of the field element + * Return value of the field element. * * @since 8.0 * @return value of the field element diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/TreeGridElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/TreeGridElement.java index 3eb8b30b5e..52a49c3a4d 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/TreeGridElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/TreeGridElement.java @@ -24,7 +24,7 @@ import org.openqa.selenium.WebElement; import com.vaadin.testbench.By; /** - * TestBench Element API for TreeGrid + * TestBench Element API for TreeGrid. * * @author Vaadin Ltd */ diff --git a/testbench-api/src/main/java/com/vaadin/testbench/elements/WindowElement.java b/testbench-api/src/main/java/com/vaadin/testbench/elements/WindowElement.java index 39b5bfa830..2bcd9d42f0 100644 --- a/testbench-api/src/main/java/com/vaadin/testbench/elements/WindowElement.java +++ b/testbench-api/src/main/java/com/vaadin/testbench/elements/WindowElement.java @@ -35,14 +35,14 @@ public class WindowElement extends PanelElement { private static final String CLOSE_BOX_CLASS = "v-window-closebox"; /** - * Clicks the close button of the window + * Clicks the close button of the window. */ public void close() { getCloseButton().click(); } /** - * Clicks the restore button of the window + * Clicks the restore button of the window. */ public void restore() { if (isMaximized()) { @@ -54,14 +54,14 @@ public class WindowElement extends PanelElement { } /** - * Check if this window is currently maximized + * Check if this window is currently maximized. */ public boolean isMaximized() { return isElementPresent(By.className(RESTORE_BOX_CLASS)); } /** - * Clicks the maximize button of the window + * Clicks the maximize button of the window. */ public void maximize() { if (!isMaximized()) { |