aboutsummaryrefslogtreecommitdiffstats
path: root/server
diff options
context:
space:
mode:
authorAhmed Ashour <asashour@yahoo.com>2017-10-02 09:09:37 +0200
committerHenri Sara <henri.sara@gmail.com>2017-10-02 10:09:37 +0300
commit763a5cbe8c13ff4a169aae9062c643ad1588cea0 (patch)
treecf41f4ac4c31925f5ca69d66a3fa6a47fbecfd4f /server
parentadcf2e2e80c6a05ea5e43be15dc7a2576fd2bbb4 (diff)
downloadvaadin-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.
Diffstat (limited to 'server')
-rw-r--r--server/src/main/java/com/vaadin/data/Binder.java4
-rw-r--r--server/src/main/java/com/vaadin/data/provider/DataCommunicator.java14
-rw-r--r--server/src/main/java/com/vaadin/data/provider/DataKeyMapper.java10
-rw-r--r--server/src/main/java/com/vaadin/data/provider/SortOrder.java6
-rw-r--r--server/src/main/java/com/vaadin/event/Action.java2
-rw-r--r--server/src/main/java/com/vaadin/event/ActionManager.java2
-rw-r--r--server/src/main/java/com/vaadin/event/FieldEvents.java8
-rw-r--r--server/src/main/java/com/vaadin/event/LayoutEvents.java2
-rw-r--r--server/src/main/java/com/vaadin/event/ListenerMethod.java45
-rw-r--r--server/src/main/java/com/vaadin/event/ShortcutAction.java13
-rw-r--r--server/src/main/java/com/vaadin/event/dd/TargetDetails.java2
-rw-r--r--server/src/main/java/com/vaadin/server/BootstrapHandler.java2
-rw-r--r--server/src/main/java/com/vaadin/server/BrowserWindowOpener.java8
-rw-r--r--server/src/main/java/com/vaadin/server/ClientConnector.java16
-rw-r--r--server/src/main/java/com/vaadin/server/ComponentSizeValidator.java2
-rw-r--r--server/src/main/java/com/vaadin/server/Constants.java2
-rw-r--r--server/src/main/java/com/vaadin/server/DefaultErrorHandler.java2
-rw-r--r--server/src/main/java/com/vaadin/server/FontAwesome.java2
-rw-r--r--server/src/main/java/com/vaadin/server/GenericFontIcon.java6
-rw-r--r--server/src/main/java/com/vaadin/server/KeyMapper.java4
-rw-r--r--server/src/main/java/com/vaadin/server/LocaleService.java6
-rw-r--r--server/src/main/java/com/vaadin/server/Page.java12
-rw-r--r--server/src/main/java/com/vaadin/server/PaintTarget.java13
-rw-r--r--server/src/main/java/com/vaadin/server/ServerRpcManager.java2
-rw-r--r--server/src/main/java/com/vaadin/server/ServiceDestroyListener.java2
-rw-r--r--server/src/main/java/com/vaadin/server/SessionInitEvent.java2
-rw-r--r--server/src/main/java/com/vaadin/server/Setter.java6
-rw-r--r--server/src/main/java/com/vaadin/server/Sizeable.java4
-rw-r--r--server/src/main/java/com/vaadin/server/UICreateEvent.java2
-rw-r--r--server/src/main/java/com/vaadin/server/UnsupportedBrowserHandler.java6
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinPortletRequest.java2
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinPortletResponse.java2
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinPortletSession.java2
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinService.java18
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinServletRequest.java2
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinServletResponse.java4
-rw-r--r--server/src/main/java/com/vaadin/server/VaadinSession.java8
-rw-r--r--server/src/main/java/com/vaadin/server/communication/DateSerializer.java2
-rw-r--r--server/src/main/java/com/vaadin/server/communication/FileUploadHandler.java2
-rw-r--r--server/src/main/java/com/vaadin/server/communication/JSR356WebsocketInitializer.java4
-rw-r--r--server/src/main/java/com/vaadin/server/communication/PushAtmosphereHandler.java2
-rw-r--r--server/src/main/java/com/vaadin/server/communication/PushHandler.java4
-rw-r--r--server/src/main/java/com/vaadin/server/communication/ServerRpcHandler.java10
-rw-r--r--server/src/main/java/com/vaadin/server/communication/UidlRequestHandler.java2
-rw-r--r--server/src/main/java/com/vaadin/server/themeutils/SASSAddonImportFileCreator.java5
-rw-r--r--server/src/main/java/com/vaadin/server/widgetsetutils/ClassPathExplorer.java4
-rw-r--r--server/src/main/java/com/vaadin/ui/AbsoluteLayout.java18
-rw-r--r--server/src/main/java/com/vaadin/ui/AbstractSplitPanel.java6
-rw-r--r--server/src/main/java/com/vaadin/ui/Button.java4
-rw-r--r--server/src/main/java/com/vaadin/ui/Component.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/CustomLayout.java4
-rw-r--r--server/src/main/java/com/vaadin/ui/DragAndDropWrapper.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/Flash.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/Grid.java14
-rw-r--r--server/src/main/java/com/vaadin/ui/GridLayout.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/HorizontalSplitPanel.java4
-rw-r--r--server/src/main/java/com/vaadin/ui/Layout.java10
-rw-r--r--server/src/main/java/com/vaadin/ui/LegacyWindow.java6
-rw-r--r--server/src/main/java/com/vaadin/ui/MenuBar.java10
-rw-r--r--server/src/main/java/com/vaadin/ui/Panel.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/PopupView.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/ReconnectDialogConfiguration.java18
-rw-r--r--server/src/main/java/com/vaadin/ui/TabSheet.java10
-rw-r--r--server/src/main/java/com/vaadin/ui/UI.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/Upload.java8
-rw-r--r--server/src/main/java/com/vaadin/ui/VerticalSplitPanel.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/Window.java8
-rw-r--r--server/src/main/java/com/vaadin/ui/declarative/Design.java4
-rw-r--r--server/src/main/java/com/vaadin/ui/declarative/DesignAttributeHandler.java6
-rw-r--r--server/src/main/java/com/vaadin/ui/declarative/DesignContext.java22
-rw-r--r--server/src/main/java/com/vaadin/ui/declarative/FieldBindingException.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/renderers/AbstractRenderer.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/renderers/ProgressBarRenderer.java2
-rw-r--r--server/src/main/java/com/vaadin/ui/themes/ValoTheme.java20
-rw-r--r--server/src/main/java/com/vaadin/util/ConnectorHelper.java4
75 files changed, 242 insertions, 236 deletions
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>"&amp;^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>"&amp;^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&amp;&amp;&amp;close"</code> will respond to ALT-C, and the caption will
- * say "Save&amp;close".
+ * <code>"Save&amp;&amp;&amp;close"</code> will respond to ALT-C, and the
+ * caption will say "Save&amp;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