Browse Source

Remove trailing whitespace from code and javadoc

Change-Id: I4c852b7f9928e190572876690d5bef1234494a5d
tags/8.0.0.alpha1
Artur Signell 7 years ago
parent
commit
eeffa805a2
100 changed files with 1063 additions and 1063 deletions
  1. 3
    3
      all/src/main/java/com/vaadin/buildhelpers/FetchReleaseNotesAuthors.java
  2. 3
    3
      buildhelpers/src/main/java/com/vaadin/buildhelpers/CompileTheme.java
  3. 5
    5
      buildhelpers/src/main/java/com/vaadin/buildhelpers/GeneratePackageExports.java
  4. 6
    6
      buildhelpers/src/main/java/com/vaadin/buildhelpers/ManifestWriter.java
  5. 3
    3
      checkstyle/header
  6. 6
    6
      client-compiler/src/main/java/com/vaadin/sass/linker/SassLinker.java
  7. 5
    5
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/AcceptCriteriaFactoryGenerator.java
  8. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ArraySerializer.java
  9. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ClientRpcVisitor.java
  10. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ConnectorInitVisitor.java
  11. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/CustomSerializer.java
  12. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/EnumSerializer.java
  13. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/FieldProperty.java
  14. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/GeneratedSerializer.java
  15. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/JsonSerializer.java
  16. 4
    4
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/MethodProperty.java
  17. 4
    4
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/OnStateChangeVisitor.java
  18. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/Property.java
  19. 5
    5
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/RendererVisitor.java
  20. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ServerRpcVisitor.java
  21. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/StateInitVisitor.java
  22. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/TypeVisitor.java
  23. 3
    3
      client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/WidgetInitVisitor.java
  24. 2
    2
      client-compiler/src/main/java/com/vaadin/tools/CvalAddonsChecker.java
  25. 2
    2
      client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java
  26. 11
    11
      client-compiler/src/main/java/com/vaadin/tools/WidgetsetCompiler.java
  27. 20
    20
      client/src/main/java/com/vaadin/client/AnimationUtil.java
  28. 36
    36
      client/src/main/java/com/vaadin/client/ApplicationConfiguration.java
  29. 71
    71
      client/src/main/java/com/vaadin/client/ApplicationConnection.java
  30. 24
    24
      client/src/main/java/com/vaadin/client/BrowserInfo.java
  31. 11
    11
      client/src/main/java/com/vaadin/client/CSSRule.java
  32. 15
    15
      client/src/main/java/com/vaadin/client/ComponentConnector.java
  33. 4
    4
      client/src/main/java/com/vaadin/client/ComponentDetail.java
  34. 3
    3
      client/src/main/java/com/vaadin/client/ComponentDetailMap.java
  35. 38
    38
      client/src/main/java/com/vaadin/client/ComputedStyle.java
  36. 9
    9
      client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java
  37. 15
    15
      client/src/main/java/com/vaadin/client/ConnectorMap.java
  38. 6
    6
      client/src/main/java/com/vaadin/client/ContainerResizedListener.java
  39. 12
    12
      client/src/main/java/com/vaadin/client/DateTimeService.java
  40. 2
    2
      client/src/main/java/com/vaadin/client/DeferredWorker.java
  41. 3
    3
      client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java
  42. 12
    12
      client/src/main/java/com/vaadin/client/EventHelper.java
  43. 3
    3
      client/src/main/java/com/vaadin/client/FastStringMap.java
  44. 3
    3
      client/src/main/java/com/vaadin/client/FastStringSet.java
  45. 4
    4
      client/src/main/java/com/vaadin/client/Focusable.java
  46. 6
    6
      client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java
  47. 8
    8
      client/src/main/java/com/vaadin/client/HasComponentsConnector.java
  48. 5
    5
      client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java
  49. 3
    3
      client/src/main/java/com/vaadin/client/JavaScriptExtension.java
  50. 3
    3
      client/src/main/java/com/vaadin/client/JsArrayObject.java
  51. 74
    74
      client/src/main/java/com/vaadin/client/LayoutManager.java
  52. 5
    5
      client/src/main/java/com/vaadin/client/LayoutManagerIE8.java
  53. 3
    3
      client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java
  54. 5
    5
      client/src/main/java/com/vaadin/client/LocaleService.java
  55. 3
    3
      client/src/main/java/com/vaadin/client/MeasuredSize.java
  56. 7
    7
      client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java
  57. 4
    4
      client/src/main/java/com/vaadin/client/Paintable.java
  58. 11
    11
      client/src/main/java/com/vaadin/client/Profiler.java
  59. 10
    10
      client/src/main/java/com/vaadin/client/RenderInformation.java
  60. 3
    3
      client/src/main/java/com/vaadin/client/RenderSpace.java
  61. 26
    26
      client/src/main/java/com/vaadin/client/ResourceLoader.java
  62. 21
    21
      client/src/main/java/com/vaadin/client/ServerConnector.java
  63. 6
    6
      client/src/main/java/com/vaadin/client/SimpleTree.java
  64. 3
    3
      client/src/main/java/com/vaadin/client/StyleConstants.java
  65. 11
    11
      client/src/main/java/com/vaadin/client/SuperDevMode.java
  66. 4
    4
      client/src/main/java/com/vaadin/client/TooltipInfo.java
  67. 35
    35
      client/src/main/java/com/vaadin/client/UIDL.java
  68. 86
    86
      client/src/main/java/com/vaadin/client/Util.java
  69. 16
    16
      client/src/main/java/com/vaadin/client/VCaption.java
  70. 4
    4
      client/src/main/java/com/vaadin/client/VCaptionWrapper.java
  71. 5
    5
      client/src/main/java/com/vaadin/client/VConsole.java
  72. 7
    7
      client/src/main/java/com/vaadin/client/VErrorMessage.java
  73. 15
    15
      client/src/main/java/com/vaadin/client/VLoadingIndicator.java
  74. 3
    3
      client/src/main/java/com/vaadin/client/VSchedulerImpl.java
  75. 29
    29
      client/src/main/java/com/vaadin/client/VTooltip.java
  76. 5
    5
      client/src/main/java/com/vaadin/client/VUIDLBrowser.java
  77. 4
    4
      client/src/main/java/com/vaadin/client/ValueMap.java
  78. 3
    3
      client/src/main/java/com/vaadin/client/WidgetInstantiator.java
  79. 3
    3
      client/src/main/java/com/vaadin/client/WidgetLoader.java
  80. 8
    8
      client/src/main/java/com/vaadin/client/WidgetMap.java
  81. 6
    6
      client/src/main/java/com/vaadin/client/WidgetSet.java
  82. 82
    82
      client/src/main/java/com/vaadin/client/WidgetUtil.java
  83. 5
    5
      client/src/main/java/com/vaadin/client/annotations/OnStateChange.java
  84. 4
    4
      client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java
  85. 8
    8
      client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java
  86. 20
    20
      client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java
  87. 4
    4
      client/src/main/java/com/vaadin/client/communication/Date_Serializer.java
  88. 15
    15
      client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java
  89. 4
    4
      client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java
  90. 4
    4
      client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java
  91. 3
    3
      client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java
  92. 6
    6
      client/src/main/java/com/vaadin/client/communication/Heartbeat.java
  93. 7
    7
      client/src/main/java/com/vaadin/client/communication/JSONSerializer.java
  94. 4
    4
      client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java
  95. 3
    3
      client/src/main/java/com/vaadin/client/communication/JsonDecoder.java
  96. 8
    8
      client/src/main/java/com/vaadin/client/communication/JsonEncoder.java
  97. 22
    22
      client/src/main/java/com/vaadin/client/communication/MessageHandler.java
  98. 13
    13
      client/src/main/java/com/vaadin/client/communication/MessageSender.java
  99. 12
    12
      client/src/main/java/com/vaadin/client/communication/PushConnection.java
  100. 0
    0
      client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java

+ 3
- 3
all/src/main/java/com/vaadin/buildhelpers/FetchReleaseNotesAuthors.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
buildhelpers/src/main/java/com/vaadin/buildhelpers/CompileTheme.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 5
- 5
buildhelpers/src/main/java/com/vaadin/buildhelpers/GeneratePackageExports.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -35,7 +35,7 @@ import java.util.regex.Pattern;
* Export-Package attribute, and appends it to the jar's MANIFEST.MF.
* <p>
* See #3521 for details.
*
*
* @author magi
*/
public class GeneratePackageExports {
@@ -148,7 +148,7 @@ public class GeneratePackageExports {
* version.<java package>. Searches for the packge and then its parents
* recursively. Falls back to the "vaadin.version" system property if no
* other properties are found.
*
*
* @param javaPackage
* The package to determine a version for
* @return A version or null if no version has been defined

+ 6
- 6
buildhelpers/src/main/java/com/vaadin/buildhelpers/ManifestWriter.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -33,7 +33,7 @@ public class ManifestWriter {

/**
* Writes a manifest attribute to a temporary buffer.
*
*
* @param name
* Attribute name
* @param value
@@ -56,10 +56,10 @@ public class ManifestWriter {

/**
* Writes the manifest to given JAR file.
*
*
* The manifest must be created with {@code #writeAttribute(String, String)}
* before calling this write.
*
*
* @param jarFilename
* File name of the JAR in which the manifest is written
* @return 0 on success, nonzero value on error

+ 3
- 3
checkstyle/header View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 6
- 6
client-compiler/src/main/java/com/vaadin/sass/linker/SassLinker.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -42,7 +42,7 @@ import com.vaadin.sass.internal.ScssStylesheet;
* Pre-linker that checks for the existence of SASS files in public folders,
* compiles them to CSS files with the SassCompiler from Vaadin and adds the CSS
* back into the artifact.
*
*
*/
@LinkerOrder(Order.PRE)
@Shardable
@@ -160,7 +160,7 @@ public class SassLinker extends AbstractLinker {

/**
* Writes the contents of an InputStream out to a file.
*
*
* @param contents
* @param tempfile
* @throws IOException
@@ -184,7 +184,7 @@ public class SassLinker extends AbstractLinker {

/**
* Create folder in temporary space on disk.
*
*
* @param partialPath
* @return
*/

+ 5
- 5
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/AcceptCriteriaFactoryGenerator.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -37,7 +37,7 @@ import com.vaadin.shared.ui.dd.AcceptCriterion;
* GWT generator to build {@link VAcceptCriterionFactory} implementation
* dynamically based on {@link AcceptCriterion} annotations available in
* classpath.
*
*
*/
public class AcceptCriteriaFactoryGenerator extends Generator {

@@ -67,7 +67,7 @@ public class AcceptCriteriaFactoryGenerator extends Generator {

/**
* Generate source code for WidgetMapImpl
*
*
* @param logger
* Logger object
* @param context

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ArraySerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ClientRpcVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ConnectorInitVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/CustomSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/EnumSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/FieldProperty.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/GeneratedSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/JsonSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 4
- 4
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/MethodProperty.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -63,7 +63,7 @@ public class MethodProperty extends Property {

/**
* Returns a list of all setters found in the beanType or its parent class
*
*
* @param beanType
* The type to check
* @param getters

+ 4
- 4
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/OnStateChangeVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -25,7 +25,7 @@ import com.vaadin.shared.ui.Connect;
/**
* Visits Connector classes and check for methods with @OnStateChange
* annotations.
*
*
* @since 7.2
* @author Vaadin Ltd
*/

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/Property.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 5
- 5
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/RendererVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -37,9 +37,9 @@ import elemental.json.JsonValue;
* {@link AbstractRendererConnector#decode(elemental.json.JsonValue) decode}
* method to work without having to implement a "getPresentationType" method.
* </ul>
*
*
* @see WidgetInitVisitor
*
*
* @since 7.4
* @author Vaadin Ltd
*/

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/ServerRpcVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/StateInitVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/TypeVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client-compiler/src/main/java/com/vaadin/server/widgetsetutils/metadata/WidgetInitVisitor.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 2
- 2
client-compiler/src/main/java/com/vaadin/tools/CvalAddonsChecker.java View File

@@ -79,7 +79,7 @@ public final class CvalAddonsChecker {

/**
* Visit all MANIFEST.MF files in the classpath validating licenses.
*
*
* Return a list of Cval licensed products in order to have enough info to
* generate nag messages in the UI.
*/
@@ -151,7 +151,7 @@ public final class CvalAddonsChecker {

/**
* Set the filter regexp of .jar names which we have to consider.
*
*
* default is '.*touchkit.*'
*/
public CvalAddonsChecker setFilter(String regexp) {

+ 2
- 2
client-compiler/src/main/java/com/vaadin/tools/CvalChecker.java View File

@@ -52,10 +52,10 @@ public final class CvalChecker {

/*
* Class used for binding the JSON gotten from server.
*
*
* It is not in a separate f le, so as it is easier to copy into any product
* which does not depend on vaadin core.
*
*
* We are using elemental.json in order not to use additional dependency
* like auto-beans, gson, etc.
*/

+ 11
- 11
client-compiler/src/main/java/com/vaadin/tools/WidgetsetCompiler.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -23,24 +23,24 @@ import com.vaadin.server.widgetsetutils.WidgetSetBuilder;
/**
* A wrapper for the GWT compiler that runs the compiler in a new thread after
* updating the widgetset file.
*
*
* This class originally existed to allow circumventing a J2SE 5.0 bug (6316197)
* that prevents setting the stack size for the main thread.
*
*
* This class takes the same command line arguments as the
* com.google.gwt.dev.Compiler class.
*
*
* A typical invocation would use e.g. the following arguments
*
*
* "-war WebContent/VAADIN/widgetsets com.vaadin.DefaultWidgetSet"
*
*
* In addition, larger memory usage settings for the VM should be used, e.g.
*
*
* "-Xms256M -Xmx512M -Xss8M"
*
*
* The source directory containing widgetset and related classes must be
* included in the classpath, as well as other relevant JARs.
*
*
* @deprecated with Java 6, can use com.google.gwt.dev.Compiler directly (also
* in Eclipse plug-in etc.)
*/

+ 20
- 20
client/src/main/java/com/vaadin/client/AnimationUtil.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -22,7 +22,7 @@ import com.google.gwt.dom.client.Style;

/**
* Utility methods for working with CSS transitions and animations.
*
*
* @author Vaadin Ltd
* @since 7.3
*/
@@ -30,9 +30,9 @@ public class AnimationUtil {

/**
* For internal use only. May be removed or replaced in the future.
*
*
* Set the animation-duration CSS property.
*
*
* @param elem
* the element whose animation-duration to set
* @param duration
@@ -45,9 +45,9 @@ public class AnimationUtil {

/**
* For internal use only. May be removed or replaced in the future.
*
*
* Set the animation-delay CSS property.
*
*
* @param elem
* the element whose animation-delay to set
* @param delay
@@ -65,15 +65,15 @@ public class AnimationUtil {
var callbackFunc = $entry(function(e) {
listener.@com.vaadin.client.AnimationUtil.AnimationEndListener::onAnimationEnd(Lcom/google/gwt/dom/client/NativeEvent;)(e);
});
elem.addEventListener(@com.vaadin.client.AnimationUtil::ANIMATION_END_EVENT_NAME, callbackFunc, false);
// Store function reference for later removal
if(!elem._vaadin_animationend_callbacks) {
elem._vaadin_animationend_callbacks = [];
}
elem._vaadin_animationend_callbacks.push(callbackFunc);
return callbackFunc;
}-*/;

@@ -111,7 +111,7 @@ public class AnimationUtil {
return event.mozAnimationName;
else if(event.oAnimationName)
return event.oAnimationName;
return "";
}-*/;

@@ -119,22 +119,22 @@ public class AnimationUtil {
public static native String getAnimationName(ComputedStyle cstyle)
/*-{
var cs = cstyle.@com.vaadin.client.ComputedStyle::computedStyle;
if(!cs.getPropertyValue)
return "";
if(cs.getPropertyValue("-webkit-animation-name"))
return cs.getPropertyValue("-webkit-animation-name");
else if(cs.getPropertyValue("animation-name"))
return cs.getPropertyValue("animation-name");
else if(cs.getPropertyValue("-moz-animation-name"))
return cs.getPropertyValue("-moz-animation-name");
else if(cs.getPropertyValue("-o-animation-name"))
return cs.getPropertyValue("-o-animation-name");
return "";
}-*/;

@@ -149,7 +149,7 @@ public class AnimationUtil {
'MozAnimation': 'animationend',
'WebkitAnimation': 'webkitAnimationEnd'
}
for(var a in anims){
if( el.style[a] !== undefined ){
return anims[a];
@@ -168,7 +168,7 @@ public class AnimationUtil {
'mozAnimation',
'webkitAnimation'
]
for(var i=0; i < anims.length; i++) {
if( el.style[anims[i]] !== undefined ){
return anims[i];

+ 36
- 36
client/src/main/java/com/vaadin/client/ApplicationConfiguration.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -62,7 +62,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Helper class for reading configuration options from the bootstap
* javascript
*
*
* @since 7.0
*/
private static class JsoConfiguration extends JavaScriptObject {
@@ -74,7 +74,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Reads a configuration parameter as a string. Please note that the
* javascript value of the parameter should also be a string, or else an
* undefined exception may be thrown.
*
*
* @param name
* name of the configuration parameter
* @return value of the configuration parameter, or <code>null</code> if
@@ -94,7 +94,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Reads a configuration parameter as a boolean object. Please note that
* the javascript value of the parameter should also be a boolean, or
* else an undefined exception may be thrown.
*
*
* @param name
* name of the configuration parameter
* @return boolean value of the configuration paramter, or
@@ -115,7 +115,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Reads a configuration parameter as an integer object. Please note
* that the javascript value of the parameter should also be an integer,
* or else an undefined exception may be thrown.
*
*
* @param name
* name of the configuration parameter
* @return integer value of the configuration paramter, or
@@ -138,7 +138,7 @@ public class ApplicationConfiguration implements EntryPoint {
* an object with appropriate fields, or else an undefined exception may
* be thrown when calling this method or when calling methods on the
* returned object.
*
*
* @param name
* name of the configuration parameter
* @return error message with the given name, or <code>null</code> if no
@@ -152,7 +152,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Returns a native javascript object containing version information
* from the server.
*
*
* @return a javascript object with the version information
*/
private native JavaScriptObject getVersionInfoJSObject()
@@ -162,9 +162,9 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Gets the version of the Vaadin framework used on the server.
*
*
* @return a string with the version
*
*
* @see com.vaadin.server.VaadinServlet#VERSION
*/
private native String getVaadinVersion()
@@ -174,9 +174,9 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Gets the version of the Atmosphere framework.
*
*
* @return a string with the version
*
*
* @see org.atmosphere.util#getRawVersion()
*/
private native String getAtmosphereVersion()
@@ -186,7 +186,7 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Gets the JS version used in the Atmosphere framework.
*
*
* @return a string with the version
*/
private native String getAtmosphereJSVersion()
@@ -206,7 +206,7 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Wraps a native javascript object containing fields for an error message
*
*
* @since 7.0
*/
public static final class ErrorMessage extends JavaScriptObject {
@@ -268,9 +268,9 @@ public class ApplicationConfiguration implements EntryPoint {
* Checks whether path info in requests to the server-side service should be
* in a request parameter (named <code>v-resourcePath</code>) or appended to
* the end of the service URL.
*
*
* @see #getServiceUrl()
*
*
* @return <code>true</code> if path info should be a request parameter;
* <code>false</code> if the path info goes after the service URL
*/
@@ -282,7 +282,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Return the name of the parameter used to to send data to the service url.
* This method should only be called if {@link #useServiceUrlPathParam()} is
* true.
*
*
* @since 7.1.6
* @return The parameter name, by default <code>v-resourcePath</code>
*/
@@ -300,9 +300,9 @@ public class ApplicationConfiguration implements EntryPoint {
* {@link #useServiceUrlPathParam()} return <code>true</code>, the requested
* path info should be in the <code>v-resourcePath</code> query parameter;
* else the path info should be appended to the end of the URL.
*
*
* @see #useServiceUrlPathParam()
*
*
* @return the URL to the server-side service as a string
*/
public String getServiceUrl() {
@@ -321,7 +321,7 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Gets the URL of the VAADIN directory on the server.
*
*
* @return the URL of the VAADIN directory
*/
public String getVaadinDirUrl() {
@@ -335,7 +335,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Gets the initial UIDL from the DOM, if it was provided during the init
* process.
*
*
* @return
*/
public String getUIDL() {
@@ -355,7 +355,7 @@ public class ApplicationConfiguration implements EntryPoint {
* instance. The UI id should be included in every request originating from
* this instance in order to associate the request with the right UI
* instance on the server.
*
*
* @return the UI id
*/
public int getUIId() {
@@ -432,7 +432,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Starts the application with a given id by reading the configuration
* options stored by the bootstrap javascript.
*
*
* @param applicationId
* id of the application to load, this is also the id of the html
* element into which the application should be rendered.
@@ -463,7 +463,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Gets the configuration object for a specific application from the
* bootstrap javascript.
*
*
* @param appId
* the id of the application to get configuration data for
* @return a native javascript object containing the configuration data
@@ -486,9 +486,9 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Return Atmosphere version.
*
*
* @since 7.4
*
*
* @return Atmosphere version.
*/
public String getAtmosphereVersion() {
@@ -497,9 +497,9 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Return Atmosphere JS version.
*
*
* @since 7.4
*
*
* @return Atmosphere JS version.
*/
public String getAtmosphereJSVersion() {
@@ -565,7 +565,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Returns all tags for given class. Tags are used in
* {@link ApplicationConfiguration} to keep track of different classes and
* their hierarchy
*
*
* @since 7.2
* @param classname
* name of class which tags we want
@@ -796,7 +796,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
*
*
* @param widgetsetName
* the name of this widgetset
*/
@@ -811,9 +811,9 @@ public class ApplicationConfiguration implements EntryPoint {
* adding ?debug parameter to URI. Please note that debug mode is always
* disabled if production mode is enabled, but disabling production mode
* does not automatically enable debug mode.
*
*
* @see #isProductionMode()
*
*
* @return true if client side is currently been debugged
*/
public static boolean isDebugMode() {
@@ -825,7 +825,7 @@ public class ApplicationConfiguration implements EntryPoint {
* Checks if production mode is enabled. When production mode is enabled,
* client-side logging is disabled. There may also be other performance
* optimizations.
*
*
* @since 7.1.2
* @return <code>true</code> if production mode is enabled; otherwise
* <code>false</code>.
@@ -845,7 +845,7 @@ public class ApplicationConfiguration implements EntryPoint {

/**
* Checks whether debug logging should be quiet
*
*
* @return <code>true</code> if debug logging should be quiet
*/
public static boolean isQuietDebugMode() {
@@ -857,7 +857,7 @@ public class ApplicationConfiguration implements EntryPoint {
/**
* Checks whether the widget set version has been sent to the server. It is
* sent in the first UIDL request.
*
*
* @return <code>true</code> if browser information has already been sent
*/
public boolean isWidgetsetVersionSent() {

+ 71
- 71
client/src/main/java/com/vaadin/client/ApplicationConnection.java View File

@@ -69,14 +69,14 @@ import com.vaadin.shared.util.SharedUtil;
* This is the client side communication "engine", managing client-server
* communication with its server side counterpart
* com.vaadin.server.VaadinService.
*
*
* Client-side connectors receive updates from the corresponding server-side
* connector (typically component) as state updates or RPC calls. The connector
* has the possibility to communicate back with its server side counter part
* through RPC calls.
*
*
* TODO document better
*
*
* Entry point classes (widgetsets) define <code>onModuleLoad()</code>.
*/
public class ApplicationConnection implements HasHandlers {
@@ -100,12 +100,12 @@ public class ApplicationConnection implements HasHandlers {
* A string that, if found in a non-JSON response to a UIDL request, will
* cause the browser to refresh the page. If followed by a colon, optional
* whitespace, and a URI, causes the browser to synchronously load the URI.
*
*
* <p>
* This allows, for instance, a servlet filter to redirect the application
* to a custom login page when the session expires. For example:
* </p>
*
*
* <pre>
* if (sessionExpired) {
* response.setHeader(&quot;Content-Type&quot;, &quot;text/html&quot;);
@@ -233,12 +233,12 @@ public class ApplicationConnection implements HasHandlers {
/**
* Event triggered when a application is stopped by calling
* {@link ApplicationConnection#setApplicationRunning(false)}.
*
*
* To listen for the event add a {@link ApplicationStoppedHandler} by
* invoking
* {@link ApplicationConnection#addHandler(ApplicationConnection.ApplicationStoppedEvent.Type, ApplicationStoppedHandler)}
* to the {@link ApplicationConnection}
*
*
* @since 7.1.8
* @author Vaadin Ltd
*/
@@ -265,7 +265,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Called when a communication error has occurred. Returning
* <code>true</code> from this method suppresses error handling.
*
*
* @param details
* A string describing the error.
* @param statusCode
@@ -280,7 +280,7 @@ public class ApplicationConnection implements HasHandlers {
* A listener for listening to application stopped events. The listener can
* be added to a {@link ApplicationConnection} by invoking
* {@link ApplicationConnection#addHandler(ApplicationStoppedEvent.Type, ApplicationStoppedHandler)}
*
*
* @since 7.1.8
* @author Vaadin Ltd
*/
@@ -290,7 +290,7 @@ public class ApplicationConnection implements HasHandlers {
* Triggered when the {@link ApplicationConnection} marks a previously
* running application as stopped by invoking
* {@link ApplicationConnection#setApplicationRunning(false)}
*
*
* @param event
* the event triggered by the {@link ApplicationConnection}
*/
@@ -427,7 +427,7 @@ public class ApplicationConnection implements HasHandlers {
* called once this application has started (first response received) or
* failed to start. This ensures that the applications are started in order,
* to avoid session-id problems.
*
*
*/
public void start() {
String jsonText = configuration.getUIDL();
@@ -459,7 +459,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Checks if there is some work to be done on the client side
*
*
* @return true if the client has some work to be done, false otherwise
*/
private boolean isActive() {
@@ -482,7 +482,7 @@ public class ApplicationConnection implements HasHandlers {
return vi;
}
}
client.getProfilingData = $entry(function() {
var smh = ap.@com.vaadin.client.ApplicationConnection::getMessageHandler()();
var pd = [
@@ -497,7 +497,7 @@ public class ApplicationConnection implements HasHandlers {
pd[pd.length] = smh.@com.vaadin.client.communication.MessageHandler::bootstrapTime;
return pd;
});
client.getElementByPath = $entry(function(id) {
return componentLocator.@com.vaadin.client.componentlocator.ComponentLocator::getElementByPath(Ljava/lang/String;)(id);
});
@@ -514,7 +514,7 @@ public class ApplicationConnection implements HasHandlers {
return componentLocator.@com.vaadin.client.componentlocator.ComponentLocator::getPathForElement(Lcom/google/gwt/dom/client/Element;)(element);
});
client.initializing = false;
$wnd.vaadin.clients[TTAppId] = client;
}-*/;

@@ -534,7 +534,7 @@ public class ApplicationConnection implements HasHandlers {
* <li><code>vaadin.postRequestHooks</code> is a map of functions which gets
* called after each XHR made by vaadin application. Note, that it is
* attaching js functions responsibility to create the variable like this:
*
*
* <code><pre>
* if(!vaadin.postRequestHooks) {vaadin.postRequestHooks = new Object();}
* postRequestHooks.myHook = function(appId) {
@@ -545,7 +545,7 @@ public class ApplicationConnection implements HasHandlers {
* </pre></code> First parameter passed to these functions is the identifier
* of Vaadin application that made the request.
* </ul>
*
*
* TODO make this multi-app aware
*/
private native void initializeClientHooks()
@@ -576,7 +576,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Requests an analyze of layouts, to find inconsistencies. Exclusively used
* for debugging during development.
*
*
* @deprecated as of 7.1. Replaced by {@link UIConnector#analyzeLayouts()}
*/
@Deprecated
@@ -588,7 +588,7 @@ public class ApplicationConnection implements HasHandlers {
* Sends a request to the server to print details to console that will help
* the developer to locate the corresponding server-side connector in the
* source code.
*
*
* @param serverConnector
* @deprecated as of 7.1. Replaced by
* {@link UIConnector#showServerDebugInfo(ServerConnector)}
@@ -635,7 +635,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Checks whether or not the CSS is loaded. By default checks the size of
* the loading indicator element.
*
*
* @return
*/
protected boolean isCSSLoaded() {
@@ -645,12 +645,12 @@ public class ApplicationConnection implements HasHandlers {

/**
* Shows the communication error notification.
*
*
* @param details
* Optional details.
* @param statusCode
* The status code returned for the request
*
*
*/
public void showCommunicationError(String details, int statusCode) {
getLogger().severe("Communication error: " + details);
@@ -659,7 +659,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Shows the authentication error notification.
*
*
* @param details
* Optional details.
*/
@@ -670,7 +670,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Shows the session expiration notification.
*
*
* @param details
* Optional details.
*/
@@ -681,7 +681,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Shows an error notification.
*
*
* @param details
* Optional details.
* @param message
@@ -729,7 +729,7 @@ public class ApplicationConnection implements HasHandlers {
* <p>
* Used by the native "client.isActive" function.
* </p>
*
*
* @return true if deferred commands are (potentially) being executed, false
* otherwise
*/
@@ -744,7 +744,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Returns the loading indicator used by this ApplicationConnection
*
*
* @return The loading indicator for this ApplicationConnection
*/
public VLoadingIndicator getLoadingIndicator() {
@@ -753,7 +753,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Determines whether or not the loading indicator is showing.
*
*
* @return true if the loading indicator is visible
* @deprecated As of 7.1. Use {@link #getLoadingIndicator()} and
* {@link VLoadingIndicator#isVisible()}.isVisible() instead.
@@ -862,7 +862,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -884,7 +884,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -907,7 +907,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -930,7 +930,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -953,7 +953,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -976,7 +976,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -999,7 +999,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -1022,7 +1022,7 @@ public class ApplicationConnection implements HasHandlers {
* is true, the update is sent as soon as possible. If immediate is false,
* the update will be sent along with the next immediate update.
* </p>
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -1045,7 +1045,7 @@ public class ApplicationConnection implements HasHandlers {
* the update will be sent along with the next immediate update.
* <p>
* A null array is sent as an empty array.
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -1068,7 +1068,7 @@ public class ApplicationConnection implements HasHandlers {
* the update will be sent along with the next immediate update.
* <p>
* A null array is sent as an empty array.
*
*
* @param paintableId
* the id of the paintable that owns the variable
* @param variableName
@@ -1085,7 +1085,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Does absolutely nothing. Replaced by {@link LayoutManager}.
*
*
* @param container
* @deprecated As of 7.0, serves no purpose
*/
@@ -1107,7 +1107,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Returns false
*
*
* @param paintable
* @return false, always
* @deprecated As of 7.0, serves no purpose
@@ -1119,7 +1119,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Returns false
*
*
* @param paintable
* @return false, always
* @deprecated As of 7.0, serves no purpose
@@ -1140,16 +1140,16 @@ public class ApplicationConnection implements HasHandlers {
/**
* Get either an existing ComponentConnector or create a new
* ComponentConnector with the given type and id.
*
*
* If a ComponentConnector with the given id already exists, returns it.
* Otherwise creates and registers a new ComponentConnector of the given
* type.
*
*
* @param connectorId
* Id of the paintable
* @param connectorType
* Type of the connector, as passed from the server side
*
*
* @return Either an existing ComponentConnector or a new ComponentConnector
* of the given type
*/
@@ -1162,15 +1162,15 @@ public class ApplicationConnection implements HasHandlers {

/**
* Creates a new ServerConnector with the given type and id.
*
*
* Creates and registers a new ServerConnector of the given type. Should
* never be called with the connector id of an existing connector.
*
*
* @param connectorId
* Id of the new connector
* @param connectorType
* Type of the connector, as passed from the server side
*
*
* @return A new ServerConnector of the given type
*/
private ServerConnector createAndRegisterConnector(String connectorId,
@@ -1190,7 +1190,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Gets a resource that has been pre-loaded via UIDL, such as custom
* layouts.
*
*
* @param name
* identifier of the resource to get
* @return the resource
@@ -1202,7 +1202,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Sets a resource that has been pre-loaded via UIDL, such as custom
* layouts.
*
*
* @since 7.6
* @param name
* identifier of the resource to Set
@@ -1215,7 +1215,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Singleton method to get instance of app's context menu.
*
*
* @return VContextMenu object
*/
public VContextMenu getContextMenu() {
@@ -1230,7 +1230,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets an {@link Icon} instance corresponding to a URI.
*
*
* @since 7.2
* @param uri
* @return Icon object
@@ -1252,7 +1252,7 @@ public class ApplicationConnection implements HasHandlers {
* Translates custom protocols in UIDL URI's to be recognizable by browser.
* All uri's from UIDL should be routed via this method before giving them
* to browser due URI's in UIDL may contain custom protocols like theme://.
*
*
* @param uidlUri
* Vaadin URI from uidl
* @return translated URI ready for browser
@@ -1264,7 +1264,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Gets the URI for the current theme. Can be used to reference theme
* resources.
*
*
* @return URI to the current theme
*/
public String getThemeUri() {
@@ -1281,7 +1281,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Use to notify that the given component's caption has changed; layouts may
* have to be recalculated.
*
*
* @param component
* the Paintable whose caption has changed
* @deprecated As of 7.0.2, has not had any effect for a long time
@@ -1293,7 +1293,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the main view
*
*
* @return the main view
*/
public UIConnector getUIConnector() {
@@ -1302,7 +1302,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the {@link ApplicationConfiguration} for the current application.
*
*
* @see ApplicationConfiguration
* @return the configuration for this application
*/
@@ -1315,7 +1315,7 @@ public class ApplicationConnection implements HasHandlers {
* list of events which has server side listeners is updated automatically
* before the component is updated so the value is correct if called from
* updatedFromUIDL.
*
*
* @param connector
* The connector to register event listeners for
* @param eventIdentifier
@@ -1334,7 +1334,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Adds the get parameters to the uri and returns the new uri that contains
* the parameters.
*
*
* @param uri
* The uri to which the parameters should be added.
* @param extraParams
@@ -1364,7 +1364,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Get VTooltip instance related to application connection
*
*
* @return VTooltip instance
*/
public VTooltip getVTooltip() {
@@ -1376,7 +1376,7 @@ public class ApplicationConnection implements HasHandlers {
* this method is now handled by the state change event handler in
* AbstractComponentConnector. The only function this method has is to
* return true if the UIDL is a "cached" update.
*
*
* @param component
* @param uidl
* @param manageCaption
@@ -1427,7 +1427,7 @@ public class ApplicationConnection implements HasHandlers {
* Schedules a heartbeat request to occur after the configured heartbeat
* interval elapses if the interval is a positive number. Otherwise, does
* nothing.
*
*
* @deprecated as of 7.2, use {@link Heartbeat#schedule()} instead
*/
@Deprecated
@@ -1441,7 +1441,7 @@ public class ApplicationConnection implements HasHandlers {
* Heartbeat requests are used to inform the server that the client-side is
* still alive. If the client page is closed or the connection lost, the
* server will eventually close the inactive UI.
*
*
* @deprecated as of 7.2, use {@link Heartbeat#send()} instead
*/
@Deprecated
@@ -1464,7 +1464,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Sets the delegate that is called whenever a communication error occurrs.
*
*
* @param delegate
* the delegate.
*/
@@ -1504,7 +1504,7 @@ public class ApplicationConnection implements HasHandlers {
/**
* Checks if the application is in the {@link ApplicationState#RUNNING}
* state.
*
*
* @since 7.6
* @return true if the application is in the running state, false otherwise
*/
@@ -1536,7 +1536,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the active connector for focused element in browser.
*
*
* @return Connector for focused element or null.
*/
private ComponentConnector getActiveConnector() {
@@ -1564,7 +1564,7 @@ public class ApplicationConnection implements HasHandlers {
* "initializing" to "running" to "stopped". There is no way for an
* application to go back to a previous state, i.e. a stopped application
* can never be re-started
*
*
* @since 7.6
* @return the current state of this application
*/
@@ -1574,7 +1574,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the server RPC queue for this application
*
*
* @since 7.6
* @return the server RPC queue
*/
@@ -1584,7 +1584,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the communication error handler for this application
*
*
* @since 7.6
* @return the server RPC queue
*/
@@ -1594,7 +1594,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the (server to client) message handler for this application
*
*
* @since 7.6
* @return the message handler
*/
@@ -1604,7 +1604,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the server rpc manager for this application
*
*
* @since 7.6
* @return the server rpc manager
*/
@@ -1614,7 +1614,7 @@ public class ApplicationConnection implements HasHandlers {

/**
* Gets the (client to server) message sender for this application
*
*
* @since 7.6
* @return the message sender
*/

+ 24
- 24
client/src/main/java/com/vaadin/client/BrowserInfo.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -21,10 +21,10 @@ import com.vaadin.shared.VBrowserDetails;

/**
* Class used to query information about web browser.
*
*
* Browser details are detected only once and those are stored in this singleton
* class.
*
*
*/
public class BrowserInfo {

@@ -60,7 +60,7 @@ public class BrowserInfo {

/**
* Singleton method to get BrowserInfo object.
*
*
* @return instance of BrowserInfo object
*/
public static BrowserInfo get() {
@@ -122,19 +122,19 @@ public class BrowserInfo {
* Returns a string representing the browser in use, for use in CSS
* classnames. The classnames will be space separated abbreviations,
* optionally with a version appended.
*
*
* Abbreviations: Firefox: ff Internet Explorer: ie Safari: sa Opera: op
*
*
* Browsers that CSS-wise behave like each other will get the same
* abbreviation (this usually depends on the rendering engine).
*
*
* This is quite simple at the moment, more heuristics will be added when
* needed.
*
*
* Examples: Internet Explorer 6: ".v-ie .v-ie6 .v-ie60", Firefox 3.0.4:
* ".v-ff .v-ff3 .v-ff30", Opera 9.60: ".v-op .v-op9 .v-op960", Opera 10.10:
* ".v-op .v-op10 .v-op1010"
*
*
* @return
*/
public String getCSSClass() {
@@ -284,7 +284,7 @@ public class BrowserInfo {
/**
* Returns the Gecko version if the browser is Gecko based. The Gecko
* version for Firefox 2 is 1.8 and 1.9 for Firefox 3.
*
*
* @return The Gecko version or -1 if the browser is not Gecko based
*/
public float getGeckoVersion() {
@@ -298,7 +298,7 @@ public class BrowserInfo {
/**
* Returns the WebKit version if the browser is WebKit based. The WebKit
* version returned is the major version e.g., 523.
*
*
* @return The WebKit version or -1 if the browser is not WebKit based
*/
public float getWebkitVersion() {
@@ -362,7 +362,7 @@ public class BrowserInfo {
/**
* Indicates whether the browser might require juggling to properly update
* sizes inside elements with overflow: auto.
*
*
* @return <code>true</code> if the browser requires the workaround,
* otherwise <code>false</code>
*/
@@ -379,7 +379,7 @@ public class BrowserInfo {
* <p>
* See https://bugs.webkit.org/show_bug.cgi?id=123958 and
* http://code.google.com/p/chromium/issues/detail?id=316549
*
*
* @since 7.1.8
* @return <code>true</code> if the browser requires the workaround,
* otherwise <code>false</code>
@@ -391,7 +391,7 @@ public class BrowserInfo {

/**
* Checks if the browser is run on iOS
*
*
* @return true if the browser is run on iOS, false otherwise
*/
public boolean isIOS() {
@@ -400,7 +400,7 @@ public class BrowserInfo {

/**
* Checks if the browser is run on iOS 6.
*
*
* @since 7.1.1
* @return true if the browser is run on iOS 6, false otherwise
*/
@@ -410,7 +410,7 @@ public class BrowserInfo {

/**
* Checks if the browser is run on Android
*
*
* @return true if the browser is run on Android, false otherwise
*/
public boolean isAndroid() {
@@ -420,7 +420,7 @@ public class BrowserInfo {
/**
* Checks if the browser is capable of handling scrolling natively or if a
* touch scroll helper is needed for scrolling.
*
*
* @return true if browser needs a touch scroll helper, false if the browser
* can handle scrolling natively
*/
@@ -448,7 +448,7 @@ public class BrowserInfo {
/**
* Tests if this is an Android devices with a broken scrollTop
* implementation
*
*
* @return true if scrollTop cannot be trusted on this device, false
* otherwise
*/
@@ -477,7 +477,7 @@ public class BrowserInfo {
* Note that Internet Explorer 8 and newer will return the document mode so
* IE8 rendering as IE7 will return 7.
* </p>
*
*
* @return The major version of the browser.
*/
public int getBrowserMajorVersion() {
@@ -486,9 +486,9 @@ public class BrowserInfo {

/**
* Returns the browser minor version e.g., 5 for Firefox 3.5.
*
*
* @see #getBrowserMajorVersion()
*
*
* @return The minor version of the browser, or -1 if not known/parsed.
*/
public int getBrowserMinorVersion() {
@@ -498,7 +498,7 @@ public class BrowserInfo {
/**
* Checks if the browser version is newer or equal to the given major+minor
* version.
*
*
* @param majorVersion
* The major version to check for
* @param minorVersion

+ 11
- 11
client/src/main/java/com/vaadin/client/CSSRule.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -26,7 +26,7 @@ public class CSSRule {
private JavaScriptObject rules = null;

/**
*
*
* @param selector
* the CSS selector to search for in the stylesheets
* @param deep
@@ -63,11 +63,11 @@ public class CSSRule {
/*-{
if(!$doc.styleSheets)
return null;
selector = selector.toLowerCase();
var allMatches = [];
// IE handles imported sheet differently
if(deep && sheet.imports && sheet.imports.length > 0) {
for(var i=0; i < sheet.imports.length; i++) {
@@ -76,13 +76,13 @@ public class CSSRule {
allMatches.concat(imports);
}
}
var theRules = new Array();
if (sheet.cssRules)
theRules = sheet.cssRules
else if (sheet.rules)
theRules = sheet.rules
var j = theRules.length;
for(var i=0; i<j; i++) {
var r = theRules[i];
@@ -102,13 +102,13 @@ public class CSSRule {
allMatches = allMatches.concat(imports);
}
}
return allMatches;
}-*/;

/**
* Returns a specific property value from this CSS rule.
*
*
* @param propertyName
* camelCase CSS property name
* @return the value of the property as a String

+ 15
- 15
client/src/main/java/com/vaadin/client/ComponentConnector.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -24,7 +24,7 @@ import com.vaadin.shared.AbstractComponentState;
* An interface used by client-side widgets or paintable parts to receive
* updates from the corresponding server-side components in the form of
* {@link UIDL}.
*
*
* Updates can be sent back to the server using the
* {@link ApplicationConnection#updateVariable()} methods.
*/
@@ -32,7 +32,7 @@ public interface ComponentConnector extends ServerConnector {

/*
* (non-Javadoc)
*
*
* @see com.vaadin.client.VPaintable#getState()
*/
@Override
@@ -49,7 +49,7 @@ public interface ComponentConnector extends ServerConnector {
* Returns <code>true</code> if the width of this paintable is currently
* undefined. If the width is undefined, the actual width of the paintable
* is defined by its contents.
*
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
@@ -59,7 +59,7 @@ public interface ComponentConnector extends ServerConnector {
* Returns <code>true</code> if the height of this paintable is currently
* undefined. If the height is undefined, the actual height of the paintable
* is defined by its contents.
*
*
* @return <code>true</code> if the height is undefined, else
* <code>false</code>
*/
@@ -69,7 +69,7 @@ public interface ComponentConnector extends ServerConnector {
* Returns <code>true</code> if the width of this paintable is currently
* relative. If the width is relative, the actual width of the paintable is
* a percentage of the size allocated to it by its parent.
*
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
@@ -79,7 +79,7 @@ public interface ComponentConnector extends ServerConnector {
* Returns <code>true</code> if the height of this paintable is currently
* relative. If the height is relative, the actual height of the paintable
* is a percentage of the size allocated to it by its parent.
*
*
* @return <code>true</code> if the width is undefined, else
* <code>false</code>
*/
@@ -87,7 +87,7 @@ public interface ComponentConnector extends ServerConnector {

/**
* Checks if the connector is read only.
*
*
* @deprecated This belongs in AbstractFieldConnector, see #8514
* @return true
*/
@@ -97,13 +97,13 @@ public interface ComponentConnector extends ServerConnector {
/**
* Return true if parent handles caption, false if the paintable handles the
* caption itself.
*
*
* <p>
* This should always return true and all components should let the parent
* handle the caption and use other attributes for internal texts in the
* component
* </p>
*
*
* @return true if caption handling is delegated to the parent, false if
* parent should not be allowed to render caption
*/
@@ -111,7 +111,7 @@ public interface ComponentConnector extends ServerConnector {

/**
* Sets the enabled state of the widget associated to this connector.
*
*
* @param widgetEnabled
* true if the widget should be enabled, false otherwise
*/
@@ -124,7 +124,7 @@ public interface ComponentConnector extends ServerConnector {
* overridden to return <code>true</code> in all situations where this
* method might return a non-empty result.
* </p>
*
*
* @param element
* The element to lookup a tooltip for
* @return The tooltip for the element or null if no tooltip is defined for
@@ -140,7 +140,7 @@ public interface ComponentConnector extends ServerConnector {
* This is only done to optimize performance, so in cases where the status
* is not known, it's safer to return <code>true</code> so that there will
* be a tooltip handler even though it might not be needed in all cases.
*
*
* @return <code>true</code> if some part of the component might have a
* tooltip, otherwise <code>false</code>
*/

+ 4
- 4
client/src/main/java/com/vaadin/client/ComponentDetail.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -30,7 +30,7 @@ class ComponentDetail {
/**
* Returns a TooltipInfo assosiated with Component. If element is given,
* returns an additional TooltipInfo.
*
*
* @param key
* @return the tooltipInfo
*/

+ 3
- 3
client/src/main/java/com/vaadin/client/ComponentDetailMap.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 38
- 38
client/src/main/java/com/vaadin/client/ComputedStyle.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -29,7 +29,7 @@ public class ComputedStyle {
* <p>
* Note that this method is expensive. Wherever possible, reuse the returned
* object.
*
*
* @param elem
* the element
* @return the computed style
@@ -44,18 +44,18 @@ public class ComputedStyle {
if(elem.nodeType != 1) {
return {};
}
if($wnd.document.defaultView && $wnd.document.defaultView.getComputedStyle) {
return $wnd.document.defaultView.getComputedStyle(elem, null);
}
if(elem.currentStyle) {
return elem.currentStyle;
}
}-*/;

/**
*
*
* @param name
* name of the CSS property in camelCase
* @return the value of the property, normalized for across browsers (each
@@ -65,7 +65,7 @@ public class ComputedStyle {
/*-{
var cs = this.@com.vaadin.client.ComputedStyle::computedStyle;
var elem = this.@com.vaadin.client.ComputedStyle::elem;
// Border values need to be checked separately. The width might have a
// meaningful value even if the border style is "none". In that case the
// value should be 0.
@@ -78,45 +78,45 @@ public class ComputedStyle {
if(borderStyle == "none")
return "0px";
}
if(cs.getPropertyValue) {
// Convert name to dashed format
name = name.replace(/([A-Z])/g, "-$1").toLowerCase();
var ret = cs.getPropertyValue(name);
} else {
var ret = cs[name];
var style = elem.style;
// From the awesome hack by Dean Edwards
// http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291
// If we're not dealing with a regular pixel number
// but a number that has a weird ending, we need to convert it to pixels
if ( !/^\d+(px)?$/i.test( ret ) && /^\d/.test( ret ) ) {
// Remember the original values
var left = style.left, rsLeft = elem.runtimeStyle.left;
// Put in the new values to get a computed value out
elem.runtimeStyle.left = cs.left;
style.left = ret || 0;
ret = style.pixelLeft + "px";
// Revert the changed values
style.left = left;
elem.runtimeStyle.left = rsLeft;
}
}
// Normalize margin values. This is not totally valid, but in most cases
// it is what the user wants to know.
if(name.indexOf("margin") > -1 && ret == "auto") {
return "0px";
}
// Some browsers return undefined width and height values as "auto", so
// we need to retrieve those ourselves.
if (name == "width" && ret == "auto") {
@@ -124,16 +124,16 @@ public class ComputedStyle {
} else if (name == "height" && ret == "auto") {
ret = elem.clientHeight + "px";
}
return ret;
}-*/;

/**
* Retrieves the given computed property as an integer
*
*
* Returns 0 if the property cannot be converted to an integer
*
*
* @param name
* the property to retrieve
* @return the integer value of the property or 0
@@ -148,9 +148,9 @@ public class ComputedStyle {

/**
* Retrieves the given computed property as a double
*
*
* Returns NaN if the property cannot be converted to a double
*
*
* @since 7.5.1
* @param name
* the property to retrieve
@@ -205,7 +205,7 @@ public class ComputedStyle {

/**
* Returns the current width from the DOM.
*
*
* @since 7.5.1
* @return the computed width
*/
@@ -215,7 +215,7 @@ public class ComputedStyle {

/**
* Returns the current height from the DOM.
*
*
* @since 7.5.1
* @return the computed height
*/
@@ -225,13 +225,13 @@ public class ComputedStyle {

/**
* Takes a String value e.g. "12px" and parses that to Integer 12.
*
*
* @param String
* a value starting with a number
* @return Integer the value from the string before any non-numeric
* characters. If the value cannot be parsed to a number, returns
* <code>null</code>.
*
*
* @deprecated Since 7.1.4, the method {@link #parseIntNative(String)} is
* used internally and this method does not belong in the public
* API of {@link ComputedStyle}. {@link #parseInt(String)} might
@@ -250,10 +250,10 @@ public class ComputedStyle {

/**
* Takes a String value e.g. "12px" and parses that to int 12.
*
*
* <p>
* This method returns 0 for <code>NaN</code>.
*
*
* @param String
* a value starting with a number
* @return int the value from the string before any non-numeric characters.
@@ -270,7 +270,7 @@ public class ComputedStyle {

/**
* Takes a String value e.g. "12.3px" and parses that to a double, 12.3.
*
*
* @param String
* a value starting with a number
* @return the value from the string before any non-numeric characters or
@@ -283,7 +283,7 @@ public class ComputedStyle {

/**
* Returns the sum of the top and bottom border width
*
*
* @since 7.5.3
* @return the sum of the top and bottom border
*/
@@ -296,7 +296,7 @@ public class ComputedStyle {

/**
* Returns the sum of the left and right border width
*
*
* @since 7.5.3
* @return the sum of the left and right border
*/
@@ -309,7 +309,7 @@ public class ComputedStyle {

/**
* Returns the sum of the top and bottom padding
*
*
* @since 7.5.3
* @return the sum of the top and bottom padding
*/
@@ -322,7 +322,7 @@ public class ComputedStyle {

/**
* Returns the sum of the top and bottom padding
*
*
* @since 7.5.3
* @return the sum of the left and right padding
*/
@@ -335,7 +335,7 @@ public class ComputedStyle {

/**
* Returns the sum of the top and bottom margin
*
*
* @since 7.5.6
* @return the sum of the top and bottom margin
*/
@@ -348,7 +348,7 @@ public class ComputedStyle {

/**
* Returns the sum of the top and bottom margin
*
*
* @since 7.5.6
* @return the sum of the left and right margin
*/

+ 9
- 9
client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -29,10 +29,10 @@ import com.vaadin.client.ui.AbstractHasComponentsConnector;
* hierarchy. A {@link ConnectorHierarchyChangedEvent} is fired when an update
* from the server has been fully processed and all hierarchy updates have been
* completed.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*
*
*/
public class ConnectorHierarchyChangeEvent
extends AbstractServerConnectorEvent<ConnectorHierarchyChangeHandler> {
@@ -49,7 +49,7 @@ public class ConnectorHierarchyChangeEvent
/**
* Returns a collection of the old children for the connector. This was the
* state before the update was received from the server.
*
*
* @return A collection of old child connectors. Never returns null.
*/
public List<ComponentConnector> getOldChildren() {
@@ -58,7 +58,7 @@ public class ConnectorHierarchyChangeEvent

/**
* Sets the collection of the old children for the connector.
*
*
* @param oldChildren
* The old child connectors. Must not be null.
*/
@@ -68,7 +68,7 @@ public class ConnectorHierarchyChangeEvent

/**
* Returns the {@link HasComponentsConnector} for which this event occurred.
*
*
* @return The {@link HasComponentsConnector} whose child collection has
* changed. Never returns null.
*/
@@ -112,7 +112,7 @@ public class ConnectorHierarchyChangeEvent
* parent connector might not yet have detached a child widget and that
* the widget of a removed child might already have been attached by its
* new parent.
*
*
* @param connectorHierarchyChangeEvent
* the event with information about the hierarchy change
*/

+ 15
- 15
client/src/main/java/com/vaadin/client/ConnectorMap.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -37,7 +37,7 @@ public class ConnectorMap {

/**
* Returns a {@link ServerConnector} by its id
*
*
* @param id
* The connector id
* @return A connector or null if a connector with the given id has not been
@@ -54,7 +54,7 @@ public class ConnectorMap {

/**
* Returns a {@link ComponentConnector} element by its root element.
*
*
* @param element
* Root element of the {@link ComponentConnector}
* @return A connector or null if a connector with the given id has not been
@@ -82,7 +82,7 @@ public class ConnectorMap {

/**
* FIXME: What does this even do and why?
*
*
* @param pid
* @return
*/
@@ -92,7 +92,7 @@ public class ConnectorMap {

/**
* Checks if a connector with the given id has been registered.
*
*
* @param connectorId
* The id to check for
* @return true if a connector has been registered with the given id, false
@@ -111,7 +111,7 @@ public class ConnectorMap {

/**
* Retrieves the connector whose widget matches the parameter.
*
*
* @param widget
* The widget
* @return A connector with {@literal widget} as its root widget or null if
@@ -145,7 +145,7 @@ public class ConnectorMap {
* Gets the connector id using a DOM element - the element should be the
* root element for a connector, otherwise no id will be found. Use
* {@link #getConnectorId(ServerConnector)} instead whenever possible.
*
*
* @see #getConnectorId(ServerConnector)
* @param el
* element of the connector whose id is desired
@@ -159,7 +159,7 @@ public class ConnectorMap {
/**
* Gets the main element for the connector with the given id. The reverse of
* {@link #getConnectorId(Element)}.
*
*
* @param connectorId
* the id of the widget whose element is desired
* @return the element for the connector corresponding to the id
@@ -178,7 +178,7 @@ public class ConnectorMap {
* This method does not remove the connector from the DOM, but marks the
* connector so that ApplicationConnection may clean up its references to
* it. Removing the widget from DOM is component containers responsibility.
*
*
* @param connector
* the connector to remove
*/
@@ -209,9 +209,9 @@ public class ConnectorMap {

/**
* Gets all registered {@link ComponentConnector} instances
*
*
* @return An array of all registered {@link ComponentConnector} instances
*
*
* @deprecated As of 7.0.1, use {@link #getComponentConnectorsAsJsArray()}
* for better performance.
*/
@@ -260,7 +260,7 @@ public class ConnectorMap {

/**
* @return
*
*
* @deprecated As of 7.0.1, use {@link #getConnectorsAsJsArray()} for
* improved performance.
*/
@@ -291,7 +291,7 @@ public class ConnectorMap {

/**
* Tests if the widget is the root widget of a {@link ComponentConnector}.
*
*
* @param widget
* The widget to test
* @return true if the widget is the root widget of a

+ 6
- 6
client/src/main/java/com/vaadin/client/ContainerResizedListener.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -19,7 +19,7 @@ package com.vaadin.client;
/**
* ContainerResizedListener interface is useful for Widgets that support
* relative sizes and who need some additional sizing logic.
*
*
* @deprecated As of 7.0, serves no purpose. Use {@link LayoutManager} and its
* methods instead.
*/
@@ -31,9 +31,9 @@ public interface ContainerResizedListener {
* function on its ancestors that implement NeedsLayout in case their
* container has resized. runAnchestorsLayout(HasWidgets parent) function
* from Util class may be a good helper for this.
*
*
* @deprecated As of 7.0, this method is never called by the framework.
*
*
*/
@Deprecated
public void iLayout();

+ 12
- 12
client/src/main/java/com/vaadin/client/DateTimeService.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -27,9 +27,9 @@ import com.vaadin.shared.ui.datefield.Resolution;
/**
* This class provides date/time parsing services to all components on the
* client side.
*
*
* @author Vaadin Ltd.
*
*
*/
@SuppressWarnings("deprecation")
public class DateTimeService {
@@ -48,7 +48,7 @@ public class DateTimeService {

/**
* Creates a new date time service with a given locale.
*
*
* @param locale
* e.g. fi, en etc.
* @throws LocaleNotLoadedException
@@ -261,7 +261,7 @@ public class DateTimeService {

/**
* Returns the ISO-8601 week number of the given date.
*
*
* @param date
* The date for which the week number should be resolved
* @return The ISO-8601 week number for {@literal date}
@@ -299,11 +299,11 @@ public class DateTimeService {
* it to the month name since DateTimeFormat.format always uses the current
* locale and will replace the month name wrong if current locale is
* different from the locale set for the DateField.
*
*
* MMMM is converted into long month name, MMM is converted into short month
* name. '' are added around the name to avoid that DateTimeFormat parses
* the month name as a pattern.
*
*
* @param date
* The date to convert
* @param formatStr
@@ -417,7 +417,7 @@ public class DateTimeService {
/**
* Replaces month names in the entered date with the name in the current
* browser locale.
*
*
* @param enteredDate
* Date string e.g. "5 May 2010"
* @param formatString
@@ -457,7 +457,7 @@ public class DateTimeService {
/**
* Parses the given date string using the given format string and the locale
* set in this DateTimeService instance.
*
*
* @param dateString
* Date string e.g. "1 February 2010"
* @param formatString
@@ -467,7 +467,7 @@ public class DateTimeService {
* @return A Date object representing the dateString. Never returns null.
* @throws IllegalArgumentException
* if the parsing fails
*
*
*/
public Date parseDate(String dateString, String formatString,
boolean lenient) throws IllegalArgumentException {

+ 2
- 2
client/src/main/java/com/vaadin/client/DeferredWorker.java View File

@@ -20,7 +20,7 @@ package com.vaadin.client;
* there is work scheduled to be executed in the near future and that the
* framework should wait for this work to complete before assuming the UI has
* reached a steady state.
*
*
* @since 7.3
* @author Vaadin Ltd
*/
@@ -28,7 +28,7 @@ public interface DeferredWorker {
/**
* Checks whether there are operations pending for this widget or connector
* that must be executed before reaching a steady state.
*
*
* @returns <code>true</code> iff there are operations pending which must be
* executed before reaching a steady state
*/

+ 3
- 3
client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 12
- 12
client/src/main/java/com/vaadin/client/EventHelper.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -37,9 +37,9 @@ import com.google.gwt.user.client.ui.Widget;
* registration (possibly the same as given, should be store for next update.
* <p>
* Pseudocode what helpers do:
*
*
* <pre>
*
*
* if paintable has event listener in UIDL
* if registration is null
* register paintable as as handler for event
@@ -48,8 +48,8 @@ import com.google.gwt.user.client.ui.Widget;
* if registration is not null
* remove the handler from paintable
* return null
*
*
*
*
* </pre>
*/
public class EventHelper {
@@ -57,7 +57,7 @@ public class EventHelper {
/**
* Adds or removes a focus handler depending on if the connector has focus
* listeners on the server side or not.
*
*
* @param connector
* The connector to update. Must implement focusHandler.
* @param handlerRegistration
@@ -75,7 +75,7 @@ public class EventHelper {
/**
* Adds or removes a focus handler depending on if the connector has focus
* listeners on the server side or not.
*
*
* @param connector
* The connector to update. Must implement focusHandler.
* @param handlerRegistration
@@ -96,7 +96,7 @@ public class EventHelper {
/**
* Adds or removes a blur handler depending on if the connector has blur
* listeners on the server side or not.
*
*
* @param connector
* The connector to update. Must implement BlurHandler.
* @param handlerRegistration
@@ -114,7 +114,7 @@ public class EventHelper {
/**
* Adds or removes a blur handler depending on if the connector has blur
* listeners on the server side or not.
*
*
* @param connector
* The connector to update. Must implement BlurHandler.
* @param handlerRegistration
@@ -122,7 +122,7 @@ public class EventHelper {
* registered previously
* @param widget
* The widget which emits blur events
*
*
* @return a new registration handler that can be used to unregister the
* handler later
*/

+ 3
- 3
client/src/main/java/com/vaadin/client/FastStringMap.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client/src/main/java/com/vaadin/client/FastStringSet.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 4
- 4
client/src/main/java/com/vaadin/client/Focusable.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -19,7 +19,7 @@ package com.vaadin.client;
* GWT's HasFocus is way too overkill for just receiving focus in simple
* components. Vaadin uses this interface in addition to GWT's HasFocus to pass
* focus requests from server to actual ui widgets in browsers.
*
*
* So in to make your server side focusable component receive focus on client
* side it must either implement this or HasFocus interface.
*/

+ 6
- 6
client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -21,7 +21,7 @@ import com.vaadin.client.ui.layout.ElementResizeListener;
/**
* Connector with layout measuring hint. Used to improve granularity of control
* over child component measurements.
*
*
* @since 7.6
* @author Vaadin Ltd
*/
@@ -56,7 +56,7 @@ public interface HasChildMeasurementHintConnector

/**
* Sets the child measurement hint for this component.
*
*
* @param hint
* the value to set
*/
@@ -64,7 +64,7 @@ public interface HasChildMeasurementHintConnector

/**
* Returns the current child measurement hint value.
*
*
* @return a ChildLayoutMeasureMode value
*/
ChildMeasurementHint getChildMeasurementHint();

+ 8
- 8
client/src/main/java/com/vaadin/client/HasComponentsConnector.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -31,14 +31,14 @@ public interface HasComponentsConnector extends ServerConnector {

/**
* Update child components caption, description and error message.
*
*
* <p>
* Each component is responsible for maintaining its caption, description
* and error message. In most cases components doesn't want to do that and
* those elements reside outside of the component. Because of this layouts
* must provide service for it's childen to show those elements for them.
* </p>
*
*
* @param connector
* Child component for which service is requested.
*/
@@ -53,7 +53,7 @@ public interface HasComponentsConnector extends ServerConnector {
* Note that the method {@link ServerConnector#getChildren()} can return a
* larger list of children including both the child components and any
* extensions registered for the connector.
*
*
* @return A collection of child components for this connector. An empty
* collection if there are no children. Never returns null.
*/
@@ -73,7 +73,7 @@ public interface HasComponentsConnector extends ServerConnector {
* {@link ServerConnector#setChildren(List)} and contains only child
* components. Both methods are called separately by the framework if the
* connector implements {@link HasComponentsConnector}.
*
*
* @param children
* The new child connectors (components only)
*/
@@ -82,7 +82,7 @@ public interface HasComponentsConnector extends ServerConnector {
/**
* Adds a handler that is called whenever the child hierarchy of this
* connector has been updated by the server.
*
*
* @param handler
* The handler that should be added.
* @return A handler registration reference that can be used to unregister

+ 5
- 5
client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -83,7 +83,7 @@ public class JavaScriptConnectorHelper {
* javascript is usually initalized the first time a state change event is
* received, but it might in some cases be necessary to make this happen
* earlier.
*
*
* @since 7.4.0
*/
public void ensureJavascriptInited() {
@@ -408,7 +408,7 @@ public class JavaScriptConnectorHelper {
delete state[key];
}
}
for(var key in input) {
if (input.hasOwnProperty(key)) {
state[key] = input[key];

+ 3
- 3
client/src/main/java/com/vaadin/client/JavaScriptExtension.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client/src/main/java/com/vaadin/client/JsArrayObject.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 74
- 74
client/src/main/java/com/vaadin/client/LayoutManager.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -87,7 +87,7 @@ public class LayoutManager {

/**
* Returns the application connection for this layout manager.
*
*
* @return connection
*/
protected ApplicationConnection getConnection() {
@@ -97,7 +97,7 @@ public class LayoutManager {
/**
* Gets the layout manager associated with the given
* {@link ApplicationConnection}.
*
*
* @param connection
* the application connection to get a layout manager for
* @return the layout manager associated with the provided application
@@ -112,7 +112,7 @@ public class LayoutManager {
* This causes this layout manager to measure the element in the beginning
* of every layout phase and call the appropriate layout method of the
* managed layout if the size of the element has changed.
*
*
* @param owner
* the ManagedLayout that depends on an element
* @param element
@@ -164,7 +164,7 @@ public class LayoutManager {
/**
* Assigns a measured size to an element. Method defined as protected to
* allow separate implementation for IE8.
*
*
* @param element
* the dom element to attach the measured size to
* @param measuredSize
@@ -184,7 +184,7 @@ public class LayoutManager {
/**
* Gets the measured size for an element. Method defined as protected to
* allow separate implementation for IE8.
*
*
* @param element
* The element to get measured size for
* @param defaultSize
@@ -209,9 +209,9 @@ public class LayoutManager {
/**
* Registers that a ManagedLayout is no longer depending on the size of an
* Element.
*
*
* @see #registerDependency(ManagedLayout, Element)
*
*
* @param owner
* the ManagedLayout no longer depends on an element
* @param element
@@ -884,7 +884,7 @@ public class LayoutManager {
* to explicitly cause some layout to be considered in an ongoing layout
* phase, you should use {@link #setNeedsMeasure(ComponentConnector)}
* instead.
*
*
* @param layout
* the managed layout that should be layouted
*/
@@ -906,7 +906,7 @@ public class LayoutManager {
* to explicitly cause some layout to be considered in an ongoing layout
* phase, you should use {@link #setNeedsMeasure(ComponentConnector)}
* instead.
*
*
* @param layout
* the managed layout that should be layouted
*/
@@ -931,7 +931,7 @@ public class LayoutManager {
* to explicitly cause some layout to be considered in an ongoing layout
* phase, you should use {@link #setNeedsMeasure(ComponentConnector)}
* instead.
*
*
* @param layout
* the managed layout that should be layouted
*/
@@ -953,13 +953,13 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
* <p>
* The value returned by this method is always rounded up. To get the exact
* outer width, use {@link #getOuterHeightDouble(Element)}
*
*
* @param element
* the element to get the measured size for
* @return the measured outer height (including margins, paddings and
@@ -982,10 +982,10 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
*
*
* @since 7.5.1
* @param element
* the element to get the measured size for
@@ -1008,13 +1008,13 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
* <p>
* The value returned by this method is always rounded up. To get the exact
* outer width, use {@link #getOuterWidthDouble(Element)}
*
*
* @since 7.5.1
* @param element
* the element to get the measured size for
@@ -1038,10 +1038,10 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured outer width (including margins, paddings and
@@ -1063,13 +1063,13 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
* <p>
* The value returned by this method is always rounded up. To get the exact
* outer width, use {@link #getInnerHeightDouble(Element)}
*
*
* @param element
* the element to get the measured size for
* @return the measured inner height (excluding margins, paddings and
@@ -1092,10 +1092,10 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
*
*
* @since 7.5.1
* @param element
* the element to get the measured size for
@@ -1118,13 +1118,13 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
* <p>
* The value returned by this method is always rounded up. To get the exact
* outer width, use {@link #getOuterHeightDouble(Element)}
*
*
* @param element
* the element to get the measured size for
* @return the measured inner width (excluding margins, paddings and
@@ -1147,10 +1147,10 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* -1 is returned if the element has not been measured. If 0 is returned, it
* might indicate that the element is not attached to the DOM.
*
*
* @since 7.5.1
* @param element
* the element to get the measured size for
@@ -1173,11 +1173,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured border height (top border + bottom border) of the
@@ -1199,11 +1199,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured padding height (top padding + bottom padding) of the
@@ -1225,11 +1225,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured border width (left border + right border) of the
@@ -1250,11 +1250,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured top border of the element in pixels.
@@ -1274,11 +1274,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured left border of the element in pixels.
@@ -1298,11 +1298,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured bottom border of the element in pixels.
@@ -1322,11 +1322,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured right border of the element in pixels.
@@ -1347,11 +1347,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured padding width (left padding + right padding) of the
@@ -1372,11 +1372,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured top padding of the element in pixels.
@@ -1396,11 +1396,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured left padding of the element in pixels.
@@ -1420,11 +1420,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured bottom padding of the element in pixels.
@@ -1444,11 +1444,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured right padding of the element in pixels.
@@ -1468,11 +1468,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured top margin of the element in pixels.
@@ -1492,11 +1492,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured right margin of the element in pixels.
@@ -1516,11 +1516,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured bottom margin of the element in pixels.
@@ -1540,11 +1540,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured size for
* @return the measured left margin of the element in pixels.
@@ -1564,11 +1564,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured margin for
* @return the measured top+bottom margin of the element in pixels.
@@ -1586,11 +1586,11 @@ public class LayoutManager {
* <li>Elements for which at least one ManagedLayout has registered a
* dependency
* </ul>
*
*
* A negative number is returned if the element has not been measured. If 0
* is returned, it might indicate that the element is not attached to the
* DOM.
*
*
* @param element
* the element to get the measured margin for
* @return the measured left+right margin of the element in pixels.
@@ -1605,7 +1605,7 @@ public class LayoutManager {
* informing the LayoutManager about what size a component will have, the
* layout propagation can continue directly without first measuring the
* potentially resized elements.
*
*
* @param component
* the component for which the size is reported
* @param outerHeight
@@ -1635,7 +1635,7 @@ public class LayoutManager {
* LayoutManager about what size a component will have, the layout
* propagation can continue directly without first measuring the potentially
* resized elements.
*
*
* @param component
* the relatively sized component for which the size is reported
* @param assignedHeight
@@ -1659,7 +1659,7 @@ public class LayoutManager {
* LayoutManager about what size a component will have, the layout
* propagation can continue directly without first measuring the potentially
* resized elements.
*
*
* @param component
* the relatively sized component for which the size is reported
* @param assignedWidth
@@ -1687,7 +1687,7 @@ public class LayoutManager {
* informing the LayoutManager about what size a component will have, the
* layout propagation can continue directly without first measuring the
* potentially resized elements.
*
*
* @param component
* the component for which the size is reported
* @param outerWidth
@@ -1715,7 +1715,7 @@ public class LayoutManager {
* element changes. Adding a listener to an element also ensures that all
* sizes for that element will be available starting from the next layout
* phase.
*
*
* @param element
* the element that should be checked for size changes
* @param listener
@@ -1738,7 +1738,7 @@ public class LayoutManager {
* Removes an element resize listener from the provided element. This might
* cause this LayoutManager to stop tracking the size of the element if no
* other sources are interested in the size.
*
*
* @param element
* the element to which the element resize listener was
* previously added
@@ -1777,7 +1777,7 @@ public class LayoutManager {
* {@link #setNeedsMeasureRecursively(ComponentConnector)} instead.
* <p>
* If there is no upcoming layout phase, a new layout phase is scheduled.
*
*
* @param component
* the component whose size might have changed.
*/
@@ -1800,7 +1800,7 @@ public class LayoutManager {
* {@link #setNeedsMeasure(ComponentConnector)} instead.
* <p>
* If there is no upcoming layout phase, a new layout phase is scheduled.
*
*
* @since 7.2
* @param component
* the component at the root of the component hierarchy to
@@ -1834,7 +1834,7 @@ public class LayoutManager {

/**
* Checks if there is something waiting for a layout to take place.
*
*
* @since 7.5.6
* @return true if there are connectors waiting for measurement or layout,
* false otherwise

+ 5
- 5
client/src/main/java/com/vaadin/client/LayoutManagerIE8.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -29,10 +29,10 @@ import com.google.gwt.user.client.ui.RootPanel;
* element in IE8 seems to make the browser think the element has changed in a
* way that requires a reflow. To work around that, the MeasureData is instead
* stored in Map for IE8.
*
*
* This implementation is injected for IE8 by a replace-with definition in the
* GWT module.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*/

+ 3
- 3
client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 5
- 5
client/src/main/java/com/vaadin/client/LocaleService.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -27,9 +27,9 @@ import com.vaadin.shared.ui.ui.UIState.LocaleData;
/**
* Date / time etc. localisation service for all widgets. Caches all loaded
* locales as JSONObjects.
*
*
* @author Vaadin Ltd.
*
*
*/
public class LocaleService {


+ 3
- 3
client/src/main/java/com/vaadin/client/MeasuredSize.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 7
- 7
client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -24,16 +24,16 @@ import com.vaadin.shared.MouseEventDetails.MouseButton;
/**
* Helper class for constructing a MouseEventDetails object from a
* {@link NativeEvent}.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*
*
*/
public class MouseEventDetailsBuilder {

/**
* Construct a {@link MouseEventDetails} object from the given event
*
*
* @param evt
* The event to use as a source for the details
* @return a MouseEventDetails containing information from the event
@@ -44,7 +44,7 @@ public class MouseEventDetailsBuilder {

/**
* Construct a {@link MouseEventDetails} object from the given event
*
*
* @param evt
* The event to use as a source for the details
* @param relativeToElement

+ 4
- 4
client/src/main/java/com/vaadin/client/Paintable.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -20,7 +20,7 @@ package com.vaadin.client;
* An interface used by client-side widgets or paintable parts to receive
* updates from the corresponding server-side components in the form of
* {@link UIDL}.
*
*
* Updates can be sent back to the server using the
* {@link ApplicationConnection#updateVariable()} methods.
*/

+ 11
- 11
client/src/main/java/com/vaadin/client/Profiler.java View File

@@ -69,7 +69,7 @@ public class Profiler {
* Interface for getting data from the {@link Profiler}.
* <p>
* <b>Warning!</b> This interface is most likely to change in the future
*
*
* @since 7.1
* @author Vaadin Ltd
*/
@@ -98,7 +98,7 @@ public class Profiler {

/**
* Create a new node with the given name.
*
*
* @param name
*/
public Node(String name) {
@@ -107,7 +107,7 @@ public class Profiler {

/**
* Gets the name of the node
*
*
* @return the name of the node
*/
public String getName() {
@@ -117,7 +117,7 @@ public class Profiler {
/**
* Creates a new child node or retrieves and existing child and updates
* its total time and hit count.
*
*
* @param name
* the name of the child
* @param timestamp
@@ -138,7 +138,7 @@ public class Profiler {
/**
* Gets the total time spent in this node, including time spent in sub
* nodes
*
*
* @return the total time spent, in milliseconds
*/
public double getTimeSpent() {
@@ -148,7 +148,7 @@ public class Profiler {
/**
* Gets the minimum time spent for one invocation of this node,
* including time spent in sub nodes
*
*
* @return the time spent for the fastest invocation, in milliseconds
*/
public double getMinTimeSpent() {
@@ -158,7 +158,7 @@ public class Profiler {
/**
* Gets the maximum time spent for one invocation of this node,
* including time spent in sub nodes
*
*
* @return the time spent for the slowest invocation, in milliseconds
*/
public double getMaxTimeSpent() {
@@ -167,7 +167,7 @@ public class Profiler {

/**
* Gets the number of times this node has been entered
*
*
* @return the number of times the node has been entered
*/
public int getCount() {
@@ -177,7 +177,7 @@ public class Profiler {
/**
* Gets the total time spent in this node, excluding time spent in sub
* nodes
*
*
* @return the total time spent, in milliseconds
*/
public double getOwnTime() {
@@ -190,7 +190,7 @@ public class Profiler {

/**
* Gets the child nodes of this node
*
*
* @return a collection of child nodes
*/
public Collection<Node> getChildren() {
@@ -389,7 +389,7 @@ public class Profiler {
* Returns time relative to the particular page load time. The value should
* not be used directly but rather difference between two values returned by
* this method should be used to compare measurements.
*
*
* @since 7.6
*/
public static double getRelativeTimeMillis() {

+ 10
- 10
client/src/main/java/com/vaadin/client/RenderInformation.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -20,9 +20,9 @@ import com.google.gwt.user.client.DOM;

/**
* Contains size information about a rendered container and its content area.
*
*
* @author Artur Signell
*
*
*/
public class RenderInformation {

@@ -48,9 +48,9 @@ public class RenderInformation {

/**
* Update the size of the widget.
*
*
* @param widget
*
*
* @return true if the size has changed since last update
* @deprecated As of 7.2, call and override {@link #updateSize(Element)}
* instead
@@ -69,11 +69,11 @@ public class RenderInformation {

/**
* Update the size of the widget.
*
*
* @param widget
*
*
* @return true if the size has changed since last update
*
*
* @since 7.2
*/
public boolean updateSize(Element element) {

+ 3
- 3
client/src/main/java/com/vaadin/client/RenderSpace.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 26
- 26
client/src/main/java/com/vaadin/client/ResourceLoader.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -37,11 +37,11 @@ import com.google.gwt.user.client.Timer;
/**
* ResourceLoader lets you dynamically include external scripts and styles on
* the page and lets you know when the resource has been loaded.
*
*
* You can also preload resources, allowing them to get cached by the browser
* without being evaluated. This enables downloading multiple resources at once
* while still controlling in which order e.g. scripts are executed.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*/
@@ -56,7 +56,7 @@ public class ResourceLoader {

/**
* Creates a new event.
*
*
* @param loader
* the resource loader that has loaded the resource
* @param resourceUrl
@@ -74,7 +74,7 @@ public class ResourceLoader {

/**
* Gets the resource loader that has fired this event
*
*
* @return the resource loader
*/
public ResourceLoader getResourceLoader() {
@@ -83,7 +83,7 @@ public class ResourceLoader {

/**
* Gets the absolute url of the loaded resource.
*
*
* @return the absolute url of the loaded resource
*/
public String getResourceUrl() {
@@ -93,9 +93,9 @@ public class ResourceLoader {
/**
* Returns true if the resource has been preloaded, false if it's fully
* loaded
*
*
* @see ResourceLoader#preloadResource(String, ResourceLoadListener)
*
*
* @return true if the resource has been preloaded, false if it's fully
* loaded
*/
@@ -112,9 +112,9 @@ public class ResourceLoader {
* Notifies this ResourceLoadListener that a resource has been loaded.
* Some browsers do not support any way of detecting load errors. In
* these cases, onLoad will be called regardless of the status.
*
*
* @see ResourceLoadEvent
*
*
* @param event
* a resource load event with information about the loaded
* resource
@@ -127,9 +127,9 @@ public class ResourceLoader {
* server did not respond. Some browsers do not support any way of
* detecting load errors. In these cases, onLoad will be called
* regardless of the status.
*
*
* @see ResourceLoadEvent
*
*
* @param event
* a resource load event with information about the resource
* that could not be loaded.
@@ -183,7 +183,7 @@ public class ResourceLoader {

/**
* Returns the default ResourceLoader
*
*
* @return the default ResourceLoader
*/
public static ResourceLoader get() {
@@ -195,8 +195,8 @@ public class ResourceLoader {
* this method when the script is currently loading or already loaded
* doesn't cause the script to be loaded again, but the listener will still
* be notified when appropriate.
*
*
*
*
* @param scriptUrl
* the url of the script to load
* @param resourceLoadListener
@@ -213,8 +213,8 @@ public class ResourceLoader {
* this method when the script is currently loading or already loaded
* doesn't cause the script to be loaded again, but the listener will still
* be notified when appropriate.
*
*
*
*
* @param scriptUrl
* url of script to load
* @param resourceLoadListener
@@ -278,7 +278,7 @@ public class ResourceLoader {
/**
* The current browser supports script.async='false' for maintaining
* execution order for dynamically-added scripts.
*
*
* @return Browser supports script.async='false'
* @since 7.2.4
*/
@@ -292,12 +292,12 @@ public class ResourceLoader {
* preloaded, it will be present in the browser's cache (provided the HTTP
* headers allow caching), making a subsequent load operation complete
* without having to wait for the resource to be downloaded again.
*
*
* Calling this method when the resource is currently loading, currently
* preloading, already preloaded or already loaded doesn't cause the
* resource to be preloaded again, but the listener will still be notified
* when appropriate.
*
*
* @param url
* the url of the resource to preload
* @param resourceLoadListener
@@ -378,7 +378,7 @@ public class ResourceLoader {
* Adds an onload listener to the given element, which should be a link or a
* script tag. The listener is called whenever loading is complete or an
* error occurred.
*
*
* @since 7.3
* @param element
* the element to attach a listener to
@@ -414,7 +414,7 @@ public class ResourceLoader {
* Calling this method when the stylesheet is currently loading or already
* loaded doesn't cause the stylesheet to be loaded again, but the listener
* will still be notified when appropriate.
*
*
* @param stylesheetUrl
* the url of the stylesheet to load
* @param resourceLoadListener
@@ -533,12 +533,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) {

+ 21
- 21
client/src/main/java/com/vaadin/client/ServerConnector.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -29,7 +29,7 @@ import com.vaadin.shared.communication.SharedState;
* Interface implemented by all client side classes that can be communicate with
* the server. Classes implementing this interface are initialized by the
* framework when needed and have the ability to communicate with the server.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*/
@@ -37,7 +37,7 @@ public interface ServerConnector extends Connector {

/**
* Gets ApplicationConnection instance that created this connector.
*
*
* @return The ApplicationConnection as set by
* {@link #doInit(String, ApplicationConnection)}
*/
@@ -47,13 +47,13 @@ public interface ServerConnector extends Connector {
* Tests whether the connector is enabled or not. This method checks that
* the connector is enabled in context, i.e. if the parent connector is
* disabled, this method must return false.
*
*
* @return true if the connector is enabled, false otherwise
*/
public boolean isEnabled();

/**
*
*
* Called once by the framework to initialize the connector.
* <p>
* Note that the shared state is not yet available at this point nor any
@@ -64,9 +64,9 @@ public interface ServerConnector extends Connector {
/**
* For internal use by the framework: returns the registered RPC
* implementations for an RPC interface identifier.
*
*
* TODO interface identifier type or format may change
*
*
* @param rpcInterfaceId
* RPC interface identifier: fully qualified interface type name
* @return RPC interface implementations registered for an RPC interface,
@@ -78,7 +78,7 @@ public interface ServerConnector extends Connector {
/**
* Adds a handler that is called whenever any part of the state has been
* updated by the server.
*
*
* @param handler
* The handler that should be added.
* @return A handler registration reference that can be used to unregister
@@ -90,7 +90,7 @@ public interface ServerConnector extends Connector {
/**
* Removes a handler that is called whenever any part of the state has been
* updated by the server.
*
*
* @param handler
* The handler that should be removed.
*/
@@ -99,7 +99,7 @@ public interface ServerConnector extends Connector {
/**
* Adds a handler that is called whenever the given part of the state has
* been updated by the server.
*
*
* @param propertyName
* the name of the property for which the handler should be
* called
@@ -114,7 +114,7 @@ public interface ServerConnector extends Connector {
/**
* Removes a handler that is called whenever any part of the state has been
* updated by the server.
*
*
* @param propertyName
* the name of the property for which the handler should be
* called
@@ -126,7 +126,7 @@ public interface ServerConnector extends Connector {

/**
* Sends the given event to all registered handlers.
*
*
* @param event
* The event to send.
*/
@@ -140,7 +140,7 @@ public interface ServerConnector extends Connector {
/**
* Returns the parent of this connector. Can be null for only the root
* connector.
*
*
* @return The parent of this connector, as set by
* {@link #setParent(ServerConnector)}.
*/
@@ -155,7 +155,7 @@ public interface ServerConnector extends Connector {
* Note that calling this method does not fire a
* {@link ConnectorHierarchyChangeEvent}. The event is fired only when the
* whole hierarchy has been updated.
*
*
* @param parent
* The new parent of the connector
*/
@@ -172,7 +172,7 @@ public interface ServerConnector extends Connector {
* {@link HasComponentsConnector#setChildComponents(List)} and takes both
* extensions and child components. Both methods are called separately by
* the framework if the connector can have child components.
*
*
* @param children
* The new child connectors (extensions and/or components)
*/
@@ -185,7 +185,7 @@ public interface ServerConnector extends Connector {
* Note that the method {@link HasComponentsConnector#getChildComponents()}
* can be used to obtain the subset of child connectors that correspond to
* components and not extensions.
*
*
* @return A collection of child connectors (components or extensions) for
* this connector. An empty collection if there are no children.
* Never returns null.
@@ -194,12 +194,12 @@ public interface ServerConnector extends Connector {

/**
* Gets the current shared state of the connector.
*
*
* Note that state is considered an internal part of the connector. You
* should not rely on the state object outside of the connector who owns it.
* If you depend on the state of other connectors you should use their
* public API instead of their state object directly.
*
*
* @since 7.0.
* @return state The shared state object. Can be any sub type of
* {@link SharedState}. Never null.
@@ -209,7 +209,7 @@ public interface ServerConnector extends Connector {
/**
* Checks if an event listener has been registered on the server side for
* the given event identifier.
*
*
* @param eventIdentifier
* The identifier for the event
* @return true if a listener has been registered on the server side, false

+ 6
- 6
client/src/main/java/com/vaadin/client/SimpleTree.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -38,7 +38,7 @@ import com.google.gwt.user.client.ui.Widget;

/**
* @author Vaadin Ltd
*
*
* @deprecated as of 7.1. This class was mainly used by the old debug console
* but is retained for now for backwards compatibility.
*/
@@ -147,7 +147,7 @@ public class SimpleTree extends ComplexPanel implements HasDoubleClickHandlers {

/**
* {@inheritDoc}
*
*
* @deprecated As of 7.2, call and override {@link #add(Widget, Element)}
* instead.
*/
@@ -162,7 +162,7 @@ public class SimpleTree extends ComplexPanel implements HasDoubleClickHandlers {

/**
* {@inheritDoc}
*
*
* @since 7.2
*/
@Override

+ 3
- 3
client/src/main/java/com/vaadin/client/StyleConstants.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 11
- 11
client/src/main/java/com/vaadin/client/SuperDevMode.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -30,10 +30,10 @@ import com.vaadin.client.ui.VNotification.HideEvent;

/**
* Class that enables SuperDevMode using a ?superdevmode parameter in the url.
*
*
* @author Vaadin Ltd
* @since 7.0
*
*
*/
public class SuperDevMode {

@@ -125,13 +125,13 @@ public class SuperDevMode {
private native static String getRecompileParameters(String moduleName)
/*-{
var prop_map = $wnd.__gwt_activeModules[moduleName].bindings();
// convert map to URL parameter string
var props = [];
for (var key in prop_map) {
props.push(encodeURIComponent(key) + '=' + encodeURIComponent(prop_map[key]))
}
return props.join('&') + '&';
}-*/;

@@ -177,7 +177,7 @@ public class SuperDevMode {
/**
* The URL of the code server. The default URL (http://localhost:9876/) will
* be used if this is empty or null.
*
*
* @param serverUrl
* The url of the code server or null to use the default
* @return true if recompile started, false if we are running in
@@ -225,12 +225,12 @@ public class SuperDevMode {
var mod = $wnd.__gwt_activeModules[moduleName];
if (!mod)
return false;
if (mod.superdevmode) {
// Running in super dev mode already, it is supported
return true;
}
return !!mod.canRedirect;
}-*/;

@@ -241,7 +241,7 @@ public class SuperDevMode {
* method returns true. The application will be restarted once compilation
* is done and then this method will return false.
* </p>
*
*
* @return true if a recompile operation has started and the page will be
* reloaded once it is done, false if no recompilation will be done.
*/

+ 4
- 4
client/src/main/java/com/vaadin/client/TooltipInfo.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -71,7 +71,7 @@ public class TooltipInfo {

/**
* Checks is a message has been defined for the tooltip.
*
*
* @return true if title or error message is present, false if both are
* empty
*/

+ 35
- 35
client/src/main/java/com/vaadin/client/UIDL.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -52,7 +52,7 @@ public final class UIDL extends JavaScriptObject {
* Shorthand for getting the attribute named "id", which for Paintables is
* the essential paintableId which binds the server side component to the
* client side widget.
*
*
* @return the value of the id attribute, if available
*/
public String getId() {
@@ -69,7 +69,7 @@ public final class UIDL extends JavaScriptObject {
* internally and is not needed within
* {@link ComponentConnector#updateFromUIDL(UIDL, ApplicationConnection)
* updateFromUIDL()}.
*
*
* @return the name for this section
*/
public native String getTag()
@@ -94,7 +94,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a String.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -105,7 +105,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the names of the attributes available.
*
*
* @return the names of available attributes
*/
public Set<String> getAttributeNames() {
@@ -116,7 +116,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the names of variables available.
*
*
* @return the names of available variables
*/
public Set<String> getVariableNames() {
@@ -130,7 +130,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as an int.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -141,7 +141,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a long.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -152,7 +152,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a float.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -163,7 +163,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a double.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -174,7 +174,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a boolean.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -185,7 +185,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as a Map of named values (key/value pairs).
*
*
* @param name
* the name of the attribute to get
* @return the attribute Map
@@ -196,7 +196,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as an array of Strings.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -207,7 +207,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the named attribute as an int array.
*
*
* @param name
* the name of the attribute to get
* @return the attribute value
@@ -218,7 +218,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Get attributes value as string whatever the type is
*
*
* @param name
* @return string presentation of attribute
*/
@@ -234,7 +234,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Indicates whether or not the named attribute is available.
*
*
* @param name
* the name of the attribute to check
* @return true if the attribute is available, false otherwise
@@ -245,7 +245,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the UIDL for the child at the given index.
*
*
* @param i
* the index of the child to get
* @return the UIDL of the child if it exists
@@ -257,7 +257,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the child at the given index as a String.
*
*
* @param i
* the index of the child to get
* @return the String representation of the child if it exists
@@ -286,7 +286,7 @@ public final class UIDL extends JavaScriptObject {
* if <code>getTag()</code> returns "color", one would update the widgets
* color to reflect the value of the "color" section.
* </p>
*
*
* @return an iterator for iterating over UIDL children
*/
public Iterator<Object> getChildIterator() {
@@ -359,7 +359,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Checks if the named variable is available.
*
*
* @param name
* the name of the variable desired
* @return true if the variable exists, false otherwise
@@ -370,7 +370,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -381,7 +381,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -392,7 +392,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -403,7 +403,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -414,7 +414,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -425,7 +425,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -436,7 +436,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -447,7 +447,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named String[] variable as a Set of Strings.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -463,7 +463,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the value of the named variable.
*
*
* @param name
* the name of the variable
* @return the value of the variable
@@ -499,7 +499,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Returns the number of children.
*
*
* @return the number of children
*/
public native int getChildCount()
@@ -514,7 +514,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the Paintable with the id found in the named attributes's value.
*
*
* @param name
* the name of the attribute
* @return the Paintable referenced by the attribute, if it exists
@@ -527,7 +527,7 @@ public final class UIDL extends JavaScriptObject {

/**
* Gets the Paintable with the id found in the named variable's value.
*
*
* @param name
* the name of the variable
* @return the Paintable referenced by the variable, if it exists
@@ -541,7 +541,7 @@ public final class UIDL extends JavaScriptObject {
/**
* Returns the child UIDL by its name. If several child nodes exist with the
* given name, the first child UIDL will be returned.
*
*
* @param tagName
* @return the child UIDL or null if child wit given name was not found
*/

+ 86
- 86
client/src/main/java/com/vaadin/client/Util.java View File

@@ -52,9 +52,9 @@ public class Util {

/**
* Helper method for debugging purposes.
*
*
* Stops execution on firefox browsers on a breakpoint.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#browserDebugger()}
* instead.
*/
@@ -67,10 +67,10 @@ public class Util {
* Helper method for a bug fix #14041. For mozilla getKeyCode return 0 for
* space bar (because space is considered as char). If return 0 use
* getCharCode.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#getKeyCode(KeyEvent)}
* instead.
*
*
* @param event
* @return return key code
* @since 7.2.4
@@ -81,15 +81,15 @@ public class Util {
}

/**
*
*
* Returns the topmost element of from given coordinates.
*
*
* TODO fix crossplat issues clientX vs pageX. See quircksmode. Not critical
* for vaadin as we scroll div istead of page.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getElementFromPoint(int, int)} instead.
*
*
* @param x
* @param y
* @return the element at given coordinates
@@ -104,18 +104,18 @@ public class Util {
* This helper method can be called if components size have been changed
* outside rendering phase. It notifies components parent about the size
* change so it can react.
*
*
* When using this method, developer should consider if size changes could
* be notified lazily. If lazy flag is true, method will save widget and
* wait for a moment until it notifies parents in chunks. This may vastly
* optimize layout in various situation. Example: if component have a lot of
* images their onload events may fire "layout phase" many times in a short
* period.
*
*
* @param widget
* @param lazy
* run componentSizeUpdated lazyly
*
*
* @deprecated As of 7.0, use
* {@link LayoutManager#setNeedsMeasure(ComponentConnector)}
* instead
@@ -159,10 +159,10 @@ public class Util {

/**
* Converts html entities to text.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#escapeHTML(String)}
* instead.
*
*
* @param html
* @return escaped string presentation of given html
*/
@@ -173,10 +173,10 @@ public class Util {

/**
* Escapes the string so it is safe to write inside an HTML attribute.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#escapeAttribute(String)}
* instead.
*
*
* @param attribute
* The string to escape
* @return An escaped version of <literal>attribute</literal>.
@@ -188,12 +188,12 @@ public class Util {

/**
* Clones given element as in JavaScript.
*
*
* Deprecate this if there appears similar method into GWT someday.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#cloneNode(Element, boolean)} instead.
*
*
* @param element
* @param deep
* clone child tree also
@@ -341,11 +341,11 @@ public class Util {

/**
* Defers the execution of {@link #runWebkitOverflowAutoFix(Element)}
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#runWebkitOverflowAutoFixDeferred(Element)}
* instead.
*
*
* @since 7.2.6
* @param elem
* with overflow auto
@@ -357,12 +357,12 @@ public class Util {

/**
* Run workaround for webkits overflow auto issue.
*
*
* See: our bug #2138 and https://bugs.webkit.org/show_bug.cgi?id=21462
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#runWebkitOverflowAutoFix(Element)} instead.
*
*
* @param elem
* with overflow auto
*/
@@ -376,7 +376,7 @@ public class Util {
* dimension is not specified as relative it will return -1. If the shared
* state does not contain width or height specifications this will return
* null.
*
*
* @param state
* @return
*/
@@ -411,7 +411,7 @@ public class Util {
* Checks if a and b are equals using {@link #equals(Object)}. Handles null
* values as well. Does not ensure that objects are of the same type.
* Assumes that the first object's equals method handle equals properly.
*
*
* @param a
* The first value to compare
* @param b
@@ -432,10 +432,10 @@ public class Util {
/**
* Gets the border-box width for the given element, i.e. element width +
* border + padding. Always rounds up to nearest integer.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#getRequiredWidth(Element)}
* instead.
*
*
* @param element
* The element to check
* @return The border-box width for the element
@@ -449,10 +449,10 @@ public class Util {
/**
* Gets the border-box height for the given element, i.e. element height +
* border + padding. Always rounds up to nearest integer.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getRequiredHeight(Element)} instead.
*
*
* @param element
* The element to check
* @return The border-box height for the element
@@ -527,10 +527,10 @@ public class Util {

/**
* Detects what is currently the overflow style attribute in given element.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#mayHaveScrollBars(Element)} instead.
*
*
* @param pe
* the element to detect
* @return true if auto or scroll
@@ -547,9 +547,9 @@ public class Util {
* also returned if "element" is part of its caption. If
* <literal>element</literal> is not part of any child component, null is
* returned.
*
*
* This method returns the deepest nested VPaintableWidget.
*
*
* @param client
* A reference to ApplicationConnection
* @param parent
@@ -608,9 +608,9 @@ public class Util {

/**
* Will (attempt) to focus the given DOM Element.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#focus(Element)} instead.
*
*
* @param el
* the element to focus
*/
@@ -622,7 +622,7 @@ public class Util {
/**
* Helper method to find the nearest parent paintable instance by traversing
* the DOM upwards from given element.
*
*
* @param element
* the element to start from
*/
@@ -640,10 +640,10 @@ public class Util {
/**
* Helper method to find first instance of given Widget type found by
* traversing DOM upwards from given element.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#findWidget(Element, Class)} instead.
*
*
* @param element
* the element where to start seeking of Widget
* @param class1
@@ -657,10 +657,10 @@ public class Util {

/**
* Force webkit to redraw an element
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#forceWebkitRedraw(Element)} instead.
*
*
* @param element
* The element that should be redrawn
*/
@@ -673,10 +673,10 @@ public class Util {
* Performs a hack to trigger a re-layout in the IE8. This is usually
* necessary in cases where IE8 "forgets" to update child elements when they
* resize.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#forceIE8Redraw(Element)}
* instead.
*
*
* @param e
* The element to perform the hack on
*/
@@ -689,10 +689,10 @@ public class Util {
* Performs a hack to trigger a re-layout in the IE browser. This is usually
* necessary in cases where IE "forgets" to update child elements when they
* resize.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#forceIERedraw(Element)}
* instead.
*
*
* @since 7.3
* @param e
* The element to perform the hack on
@@ -705,12 +705,12 @@ public class Util {
/**
* Detaches and re-attaches the element from its parent. The element is
* reattached at the same position in the DOM as it was before.
*
*
* Does nothing if the element is not attached to the DOM.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#detachAttach(Element)}
* instead.
*
*
* @param element
* The element to detach and re-attach
*/
@@ -730,10 +730,10 @@ public class Util {

/**
* Returns the index of the childElement within its parent.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getChildElementIndex(Element)} instead.
*
*
* @param subElement
* @return
*/
@@ -760,7 +760,7 @@ public class Util {
/**
* Produces a string representation of a method invocation, suitable for
* debug output
*
*
* @since 7.5
* @param invocation
* @return
@@ -819,11 +819,11 @@ public class Util {
* Temporarily sets the {@code styleProperty} to {@code tempValue} and then
* resets it to its current value. Used mainly to work around rendering
* issues in IE (and possibly in other browsers)
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#setStyleTemporarily(Element, String, String)}
* instead.
*
*
* @param element
* The target element
* @param styleProperty
@@ -841,10 +841,10 @@ public class Util {
* A helper method to return the client position from an event. Returns
* position from either first changed touch (if touch event) or from the
* event itself.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getTouchOrMouseClientX(Event)} instead.
*
*
* @param event
* @return
*/
@@ -857,10 +857,10 @@ public class Util {
* Find the element corresponding to the coordinates in the passed mouse
* event. Please note that this is not always the same as the target of the
* event e.g. if event capture is used.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getElementUnderMouse(NativeEvent)} instead.
*
*
* @param event
* the mouse event to get coordinates from
* @return the element at the coordinates of the event
@@ -875,10 +875,10 @@ public class Util {
* A helper method to return the client position from an event. Returns
* position from either first changed touch (if touch event) or from the
* event itself.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getTouchOrMouseClientY(Event)} instead.
*
*
* @param event
* @return
*/
@@ -891,7 +891,7 @@ public class Util {
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getTouchOrMouseClientY(NativeEvent)}
* instead.
*
*
* @see #getTouchOrMouseClientY(Event)
* @param currentGwtEvent
* @return
@@ -905,9 +905,9 @@ public class Util {
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#getTouchOrMouseClientX(NativeEvent)}
* instead.
*
*
* @see #getTouchOrMouseClientX(Event)
*
*
* @param event
* @return
*/
@@ -947,10 +947,10 @@ public class Util {

/**
* Gets the currently focused element.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#getFocusedElement()}
* instead.
*
*
* @return The active element or null if no active element could be found.
*/
@Deprecated
@@ -960,7 +960,7 @@ public class Util {

/**
* Gets the currently focused element for Internet Explorer.
*
*
* @return The currently focused element
* @deprecated Use #getFocusedElement instead
*/
@@ -971,12 +971,12 @@ public class Util {

/**
* Gets currently focused element and checks if it's editable
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#isFocusedElementEditable()} instead.
*
*
* @since 7.4
*
*
* @return true if focused element is editable
*/
@Deprecated
@@ -989,10 +989,10 @@ public class Util {
* this method checks that this widget nor any of its parents is hidden. Can
* be e.g used to check whether component should react to some events or
* not.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#isAttachedAndDisplayed(Widget)} instead.
*
*
* @param widget
* @return true if attached and displayed
*/
@@ -1004,10 +1004,10 @@ public class Util {
/**
* Scrolls an element into view vertically only. Modified version of
* Element.scrollIntoView.
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#scrollIntoViewVertically(Element)} instead.
*
*
* @param elem
* The element to scroll into view
*/
@@ -1019,11 +1019,11 @@ public class Util {
/**
* Checks if the given event is either a touch event or caused by the left
* mouse button
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#isTouchEventOrLeftMouseButton(Event)}
* instead.
*
*
* @param event
* @return true if the event is a touch event or caused by the left mouse
* button, false otherwise
@@ -1035,7 +1035,7 @@ public class Util {

/**
* Performs a shallow comparison of the collections.
*
*
* @param collection1
* The first collection
* @param collection2
@@ -1080,10 +1080,10 @@ public class Util {
/**
* Resolve a relative URL to an absolute URL based on the current document's
* location.
*
*
* @deprecated As of 7.4.0, use {@link WidgetUtil#getAbsoluteUrl(String)}
* instead.
*
*
* @param url
* a string with the relative URL to resolve
* @return the corresponding absolute URL as a string
@@ -1095,16 +1095,16 @@ public class Util {

/**
* Sets the selection range of an input element.
*
*
* We need this JSNI function to set selection range so that we can use the
* optional direction attribute to set the anchor to the end and the focus
* to the start. This makes Firefox work the same way as other browsers
* (#13477)
*
*
* @deprecated As of 7.4.0, use
* {@link WidgetUtil#setSelectionRange(Element, int, int, String)}
* instead.
*
*
* @param elem
* the html input element.
* @param pos
@@ -1115,7 +1115,7 @@ public class Util {
* a string indicating the direction in which the selection was
* performed. This may be "forward" or "backward", or "none" if
* the direction is unknown or irrelevant.
*
*
* @since 7.3
*/
@Deprecated
@@ -1128,7 +1128,7 @@ public class Util {
* Converts a native {@link JavaScriptObject} into a {@link JsonValue}. This
* is a no-op in GWT code compiled to javascript, but needs some special
* handling to work when run in JVM.
*
*
* @param jso
* the java script object to represent as json
* @return the json representation
@@ -1145,7 +1145,7 @@ public class Util {
* Converts a {@link JsonValue} into a native {@link JavaScriptObject}. This
* is a no-op in GWT code compiled to javascript, but needs some special
* handling to work when run in JVM.
*
*
* @param jsonValue
* the json value
* @return a native javascript object representation of the json value
@@ -1160,7 +1160,7 @@ public class Util {

/**
* Convert a {@link JavaScriptObject} into a string representation.
*
*
* @param json
* a JavaScript object to be converted to a string
* @return JSON in string representation
@@ -1172,7 +1172,7 @@ public class Util {

/**
* Parse a string containing JSON into a {@link JavaScriptObject}.
*
*
* @param <T>
* the overlay type to expect from the parse
* @param jsonAsString
@@ -1186,7 +1186,7 @@ public class Util {

/**
* Round {@code num} up to {@code exp} decimal positions.
*
*
* @since 7.6
*/
public static native double round(double num, int exp)
@@ -1226,7 +1226,7 @@ public class Util {
* appropriate mode set.
*
* This version of the method tries to recursively locate such a parent.
*
*
* For internal use only. May be removed or replaced in the future.
*/
public static boolean shouldSkipMeasurementOfConnector(

+ 16
- 16
client/src/main/java/com/vaadin/client/VCaption.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -67,9 +67,9 @@ public class VCaption extends HTML {

/**
* Creates a caption that is not linked to a {@link ComponentConnector}.
*
*
* When using this constructor, {@link #getOwner()} returns null.
*
*
* @param client
* ApplicationConnection
* @deprecated all captions should be associated with a paintable widget and
@@ -88,7 +88,7 @@ public class VCaption extends HTML {

/**
* Creates a caption for a {@link ComponentConnector}.
*
*
* @param component
* owner of caption, not null
* @param client
@@ -130,10 +130,10 @@ public class VCaption extends HTML {

/**
* Updates the caption from UIDL.
*
*
* This method may only be called when the caption has an owner - otherwise,
* use {@link #updateCaptionWithoutOwner(UIDL, String, boolean, boolean)}.
*
*
* @return true if the position where the caption should be placed has
* changed
*/
@@ -477,7 +477,7 @@ public class VCaption extends HTML {
/**
* Checks whether anything in a given state change might cause the caption
* to change.
*
*
* @param event
* the state change event to check
* @return <code>true</code> if the caption might have changed; otherwise
@@ -499,7 +499,7 @@ public class VCaption extends HTML {

/**
* Returns Paintable for which this Caption belongs to.
*
*
* @return owner Widget
*/
public ComponentConnector getOwner() {
@@ -664,7 +664,7 @@ public class VCaption extends HTML {

/**
* Sets the tooltip that should be shown for the caption
*
*
* @param tooltipInfo
* The tooltip that should be shown or null if no tooltip should
* be shown
@@ -675,7 +675,7 @@ public class VCaption extends HTML {

/**
* Returns the tooltip that should be shown for the caption
*
*
* @return The tooltip to show or null if no tooltip should be shown
*/
public TooltipInfo getTooltipInfo() {
@@ -704,7 +704,7 @@ public class VCaption extends HTML {
* Sets whether the caption is rendered as HTML.
* <p>
* Default is false
*
*
* @param captionAsHtml
* true if the captions are rendered as HTML, false if rendered
* as plain text
@@ -717,7 +717,7 @@ public class VCaption extends HTML {
* Checks whether captions are rendered as HTML.
* <p>
* Default is false
*
*
* @return true if the captions are rendered as HTML, false if rendered as
* plain text
*/
@@ -731,7 +731,7 @@ public class VCaption extends HTML {
* <p>
* Uses {@link AbstractComponentState#captionAsHtml} to determine whether to
* set the caption as html or plain text
*
*
* @since 7.4
* @param captionElement
* the target element
@@ -753,7 +753,7 @@ public class VCaption extends HTML {
* <p>
* Uses {@link AbstractComponentState#captionAsHtml} to determine whether to
* set the caption as html or plain text
*
*
* @since 7.4
* @param widget
* the target widget

+ 4
- 4
client/src/main/java/com/vaadin/client/VCaptionWrapper.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -26,7 +26,7 @@ public class VCaptionWrapper extends FlowPanel {

/**
* Creates a new caption wrapper panel.
*
*
* @param toBeWrapped
* paintable that the caption is associated with, not null
* @param client

+ 5
- 5
client/src/main/java/com/vaadin/client/VConsole.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -23,7 +23,7 @@ import com.vaadin.client.debug.internal.VDebugWindow;

/**
* A helper class to do some client side logging.
*
*
* @deprecated as of 7.1, use {@link Logger} from java.util.logging instead.
*/
@Deprecated
@@ -32,7 +32,7 @@ public class VConsole {

/**
* Used by ApplicationConfiguration to initialize VConsole.
*
*
* @param console
*/
static void setImplementation(VDebugWindow console) {

+ 7
- 7
client/src/main/java/com/vaadin/client/VErrorMessage.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -38,7 +38,7 @@ public class VErrorMessage extends FlowPanel {
* The owner must be set if the {@link VErrorMessage} is created
* 'stand-alone' (not within a {@link VOverlay}), or theming might not work
* properly.
*
*
* @see VOverlay#setOwner(Widget)
* @param owner
* the owner (creator Widget)
@@ -59,7 +59,7 @@ public class VErrorMessage extends FlowPanel {

/**
* Shows this error message next to given element.
*
*
* @param indicatorElement
* @deprecated As of 7.2, call and override {@link #showAt(Element)} instead
*/
@@ -84,9 +84,9 @@ public class VErrorMessage extends FlowPanel {

/**
* Shows this error message next to given element.
*
*
* @param indicatorElement
*
*
* @since 7.2
*/
public void showAt(Element indicatorElement) {

+ 15
- 15
client/src/main/java/com/vaadin/client/VLoadingIndicator.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -28,7 +28,7 @@ import com.google.gwt.user.client.Timer;
* {@link #trigger()} is called the indicator moves to its "triggered" state and
* then transitions from one state to the next when the timeouts specified using
* the set*StateDelay methods occur.
*
*
* @author Vaadin Ltd
* @since 7.1
*/
@@ -72,7 +72,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
*
*
* @return The delay (in ms) until moving into the "first" state. Counted
* from when {@link #trigger()} is called.
*/
@@ -83,7 +83,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
*
*
* @param firstDelay
* The delay (in ms) until moving into the "first" state. Counted
* from when {@link #trigger()} is called.
@@ -95,7 +95,7 @@ public class VLoadingIndicator {
/**
* Returns the delay (in ms) which must pass before the loading indicator
* moves to its "second" state.
*
*
* @return The delay (in ms) until the loading indicator moves into its
* "second" state. Counted from when {@link #trigger()} is called.
*/
@@ -106,7 +106,7 @@ public class VLoadingIndicator {
/**
* Sets the delay (in ms) which must pass before the loading indicator moves
* to its "second" state.
*
*
* @param secondDelay
* The delay (in ms) until the loading indicator moves into its
* "second" state. Counted from when {@link #trigger()} is
@@ -119,7 +119,7 @@ public class VLoadingIndicator {
/**
* Returns the delay (in ms) which must pass before the loading indicator
* moves to its "third" state.
*
*
* @return The delay (in ms) until the loading indicator moves into its
* "third" state. Counted from when {@link #trigger()} is called.
*/
@@ -130,7 +130,7 @@ public class VLoadingIndicator {
/**
* Sets the delay (in ms) which must pass before the loading indicator moves
* to its "third" state.
*
*
* @param thirdDelay
* The delay (in ms) from the event until changing the loading
* indicator into its "third" state. Counted from when
@@ -156,7 +156,7 @@ public class VLoadingIndicator {
/**
* Triggers displaying of this loading indicator unless it's already visible
* or scheduled to be shown after a delay.
*
*
* @since 7.4
*/
public void ensureTriggered() {
@@ -191,7 +191,7 @@ public class VLoadingIndicator {
/**
* Returns the {@link ApplicationConnection} which uses this loading
* indicator
*
*
* @return The ApplicationConnection for this loading indicator
*/
public ApplicationConnection getConnection() {
@@ -201,7 +201,7 @@ public class VLoadingIndicator {
/**
* Sets the {@link ApplicationConnection} which uses this loading indicator.
* Only used internally.
*
*
* @param connection
* The ApplicationConnection for this loading indicator
*/
@@ -223,7 +223,7 @@ public class VLoadingIndicator {

/**
* Returns whether or not the loading indicator is showing.
*
*
* @return true if the loading indicator is visible, false otherwise
*/
public boolean isVisible() {
@@ -237,7 +237,7 @@ public class VLoadingIndicator {

/**
* Returns the root element of the loading indicator
*
*
* @return The loading indicator DOM element
*/
public com.google.gwt.user.client.Element getElement() {

+ 3
- 3
client/src/main/java/com/vaadin/client/VSchedulerImpl.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 29
- 29
client/src/main/java/com/vaadin/client/VTooltip.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -79,7 +79,7 @@ public class VTooltip extends VOverlay {
* Used to show tooltips; usually used via the singleton in
* {@link ApplicationConnection}. NOTE that #setOwner(Widget)} should be
* called after instantiating.
*
*
* @see ApplicationConnection#getVTooltip()
*/
public VTooltip() {
@@ -107,7 +107,7 @@ public class VTooltip extends VOverlay {

/**
* Show the tooltip with the provided info for assistive devices.
*
*
* @param info
* with the content of the tooltip
*/
@@ -119,7 +119,7 @@ public class VTooltip extends VOverlay {

/**
* Initialize the tooltip overlay for assistive devices.
*
*
* @param info
* with the content of the tooltip
* @since 7.2.4
@@ -147,12 +147,12 @@ public class VTooltip extends VOverlay {
* element we need to clear style width of its parent DIV from old
* value (in some strange cases this width=[tooltip MAX_WIDTH] after
* tooltip text has been already updated to new shortly value:
*
*
* <div class="popupContent"> <div style="width:500px;"> <div
* class="v-errormessage" aria-hidden="true" style="display: none;">
* <div class="gwt-HTML"> </div> </div> <div
* class="v-tooltip-text">This is a short tooltip</div> </div>
*
*
* and it leads to error during calculation offsetWidth (it is
* native GWT method getSubPixelOffsetWidth()) of description
* element")
@@ -168,7 +168,7 @@ public class VTooltip extends VOverlay {

/**
* Show a popup containing the currentTooltipInfo
*
*
*/
private void showTooltip() {
if (currentTooltipInfo.hasMessage()) {
@@ -212,7 +212,7 @@ public class VTooltip extends VOverlay {
* Return the final X-coordinate of the tooltip based on cursor
* position, size of the tooltip, size of the page and necessary
* margins.
*
*
* @param offsetWidth
* @return The final X-coordinate
*/
@@ -285,10 +285,10 @@ public class VTooltip extends VOverlay {
* Return the final Y-coordinate of the tooltip based on cursor
* position, size of the tooltip, size of the page and necessary
* margins.
*
*
* @param offsetHeight
* @return The final y-coordinate
*
*
*/
private int getFinalY(int offsetHeight) {
int y = 0;
@@ -381,7 +381,7 @@ public class VTooltip extends VOverlay {
* and attached to the DOM well in advance. For this reason both isShowing
* and isVisible return false positives. We can't override either of them as
* external code may depend on this behavior.
*
*
* @return boolean
*/
public boolean isTooltipOpen() {
@@ -507,7 +507,7 @@ public class VTooltip extends VOverlay {

/**
* Locate the tooltip for given element
*
*
* @param element
* Element used in search
* @return TooltipInfo if connector and tooltip found, null if not
@@ -547,7 +547,7 @@ public class VTooltip extends VOverlay {

/**
* Handle hide event
*
*
*/
private void handleHideEvent() {
hideTooltip();
@@ -570,7 +570,7 @@ public class VTooltip extends VOverlay {

/**
* Displays Tooltip when page is navigated with the keyboard.
*
*
* Tooltip is not visible. This makes it possible for assistive devices
* to recognize the tooltip.
*/
@@ -581,7 +581,7 @@ public class VTooltip extends VOverlay {

/**
* Hides Tooltip when the page is navigated with the keyboard.
*
*
* Removes the Tooltip from page to make sure assistive devices don't
* recognize it by accident.
*/
@@ -685,7 +685,7 @@ public class VTooltip extends VOverlay {

/**
* Connects DOM handlers to widget that are needed for tooltip presentation.
*
*
* @param widget
* Widget which DOM handlers are connected
*/
@@ -702,7 +702,7 @@ public class VTooltip extends VOverlay {

/**
* Returns the unique id of the tooltip element.
*
*
* @return String containing the unique id of the tooltip, which always has
* a value
*/
@@ -723,7 +723,7 @@ public class VTooltip extends VOverlay {
* Returns the time (in ms) the tooltip should be displayed after an event
* that will cause it to be closed (e.g. mouse click outside the component,
* key down).
*
*
* @return The close timeout (in ms)
*/
public int getCloseTimeout() {
@@ -734,7 +734,7 @@ public class VTooltip extends VOverlay {
* Sets the time (in ms) the tooltip should be displayed after an event that
* will cause it to be closed (e.g. mouse click outside the component, key
* down).
*
*
* @param closeTimeout
* The close timeout (in ms)
*/
@@ -747,7 +747,7 @@ public class VTooltip extends VOverlay {
* be used instead of {@link #getOpenDelay()}. The quick open delay is used
* when the tooltip has very recently been shown, is currently hidden but
* about to be shown again.
*
*
* @return The quick open timeout (in ms)
*/
public int getQuickOpenTimeout() {
@@ -759,7 +759,7 @@ public class VTooltip extends VOverlay {
* should be used instead of {@link #getOpenDelay()}. The quick open delay
* is used when the tooltip has very recently been shown, is currently
* hidden but about to be shown again.
*
*
* @param quickOpenTimeout
* The quick open timeout (in ms)
*/
@@ -771,7 +771,7 @@ public class VTooltip extends VOverlay {
* Returns the time (in ms) that should elapse before a tooltip will be
* shown, in the situation when a tooltip has very recently been shown
* (within {@link #getQuickOpenDelay()} ms).
*
*
* @return The quick open delay (in ms)
*/
public int getQuickOpenDelay() {
@@ -782,7 +782,7 @@ public class VTooltip extends VOverlay {
* Sets the time (in ms) that should elapse before a tooltip will be shown,
* in the situation when a tooltip has very recently been shown (within
* {@link #getQuickOpenDelay()} ms).
*
*
* @param quickOpenDelay
* The quick open delay (in ms)
*/
@@ -795,7 +795,7 @@ public class VTooltip extends VOverlay {
* tooltip showing has occurred (e.g. mouse over) before the tooltip is
* shown. If a tooltip has recently been shown, then
* {@link #getQuickOpenDelay()} is used instead of this.
*
*
* @return The open delay (in ms)
*/
public int getOpenDelay() {
@@ -807,7 +807,7 @@ public class VTooltip extends VOverlay {
* tooltip showing has occurred (e.g. mouse over) before the tooltip is
* shown. If a tooltip has recently been shown, then
* {@link #getQuickOpenDelay()} is used instead of this.
*
*
* @param openDelay
* The open delay (in ms)
*/
@@ -817,7 +817,7 @@ public class VTooltip extends VOverlay {

/**
* Sets the maximum width of the tooltip popup.
*
*
* @param maxWidth
* The maximum width the tooltip popup (in pixels)
*/
@@ -827,7 +827,7 @@ public class VTooltip extends VOverlay {

/**
* Returns the maximum width of the tooltip popup.
*
*
* @return The maximum width the tooltip popup (in pixels)
*/
public int getMaxWidth() {

+ 5
- 5
client/src/main/java/com/vaadin/client/VUIDLBrowser.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -14,7 +14,7 @@
* the License.
*/
/**
*
*
*/
package com.vaadin.client;

@@ -45,7 +45,7 @@ import elemental.json.JsonValue;

/**
* @author Vaadin Ltd
*
*
* @deprecated as of 7.1. This class was mainly used by the old debug console
* but is retained for now for backwards compatibility.
*/

+ 4
- 4
client/src/main/java/com/vaadin/client/ValueMap.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -14,7 +14,7 @@
* the License.
*/
/**
*
*
*/
package com.vaadin.client;


+ 3
- 3
client/src/main/java/com/vaadin/client/WidgetInstantiator.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 3
- 3
client/src/main/java/com/vaadin/client/WidgetLoader.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 8
- 8
client/src/main/java/com/vaadin/client/WidgetMap.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -20,7 +20,7 @@ import java.util.HashMap;
/**
* Abstract class mapping between {@link ComponentConnector} instances and their
* instances.
*
*
* A concrete implementation of this class is generated by WidgetMapGenerator or
* one of its subclasses during widgetset compilation.
*/
@@ -30,7 +30,7 @@ abstract class WidgetMap {

/**
* Create a new instance of a connector based on its type.
*
*
* @param classType
* {@link ComponentConnector} class to instantiate
* @return new instance of the connector
@@ -43,7 +43,7 @@ abstract class WidgetMap {
/**
* Return the connector class to use for a fully qualified server side
* component class name.
*
*
* @param fullyqualifiedName
* fully qualified name of the server side component class
* @return component connector class to use
@@ -54,7 +54,7 @@ abstract class WidgetMap {
/**
* Return the connector classes to load after the initial widgetset load and
* start.
*
*
* @return component connector class to load after the initial widgetset
* loading
*/
@@ -64,7 +64,7 @@ abstract class WidgetMap {
* Make sure the code for a (deferred or lazy) component connector type has
* been loaded, triggering the load and waiting for its completion if
* necessary.
*
*
* @param classType
* component connector class
*/

+ 6
- 6
client/src/main/java/com/vaadin/client/WidgetSet.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -31,13 +31,13 @@ public class WidgetSet {
/**
* Create an uninitialized connector that best matches given UIDL. The
* connector must implement {@link ServerConnector}.
*
*
* @param tag
* connector type tag for the connector to create
* @param conf
* the application configuration to use when creating the
* connector
*
*
* @return New uninitialized and unregistered connector that can paint given
* UIDL.
*/
@@ -108,7 +108,7 @@ public class WidgetSet {
* Due its nature, GWT does not support dynamic classloading. To bypass this
* limitation, widgetset must have function that returns Class by its fully
* qualified name.
*
*
* @param tag
* @param applicationConfiguration
* @return

+ 82
- 82
client/src/main/java/com/vaadin/client/WidgetUtil.java View File

@@ -54,9 +54,9 @@ public class WidgetUtil {

/**
* Helper method for debugging purposes.
*
*
* Stops execution on firefox browsers on a breakpoint.
*
*
*/
public static native void browserDebugger()
/*-{
@@ -67,7 +67,7 @@ public class WidgetUtil {
/**
* Redirects the browser to the given url or refreshes the page if url is
* null
*
*
* @since 7.6
* @param url
* The url to redirect to or null to refresh
@@ -85,7 +85,7 @@ public class WidgetUtil {
* Helper method for a bug fix #14041. For mozilla getKeyCode return 0 for
* space bar (because space is considered as char). If return 0 use
* getCharCode.
*
*
* @param event
* @return return key code
* @since 7.2.4
@@ -99,12 +99,12 @@ public class WidgetUtil {
}

/**
*
*
* Returns the topmost element of from given coordinates.
*
*
* TODO fix crossplat issues clientX vs pageX. See quircksmode. Not critical
* for vaadin as we scroll div istead of page.
*
*
* @param x
* @param y
* @return the element at given coordinates
@@ -137,7 +137,7 @@ public class WidgetUtil {

/**
* Converts html entities to text.
*
*
* @param html
* @return escaped string presentation of given html
*/
@@ -155,7 +155,7 @@ public class WidgetUtil {

/**
* Escapes the string so it is safe to write inside an HTML attribute.
*
*
* @param attribute
* The string to escape
* @return An escaped version of <literal>attribute</literal>.
@@ -174,9 +174,9 @@ public class WidgetUtil {

/**
* Clones given element as in JavaScript.
*
*
* Deprecate this if there appears similar method into GWT someday.
*
*
* @param element
* @param deep
* clone child tree also
@@ -427,7 +427,7 @@ public class WidgetUtil {

/**
* Defers the execution of {@link #runWebkitOverflowAutoFix(Element)}
*
*
* @since 7.2.6
* @param elem
* with overflow auto
@@ -445,9 +445,9 @@ public class WidgetUtil {

/**
* Run workaround for webkits overflow auto issue.
*
*
* See: our bug #2138 and https://bugs.webkit.org/show_bug.cgi?id=21462
*
*
* @param elem
* with overflow auto
*/
@@ -537,7 +537,7 @@ public class WidgetUtil {
/**
* Gets the border-box width for the given element, i.e. element width +
* border + padding. Always rounds up to nearest integer.
*
*
* @param element
* The element to check
* @return The border-box width for the element
@@ -563,7 +563,7 @@ public class WidgetUtil {
/**
* Gets the border-box width for the given element, i.e. element width +
* border + padding.
*
*
* @since 7.5.1
* @param element
* The element to check
@@ -588,7 +588,7 @@ public class WidgetUtil {
/**
* Gets the border-box height for the given element, i.e. element height +
* border + padding. Always rounds up to nearest integer.
*
*
* @param element
* The element to check
* @return The border-box height for the element
@@ -614,7 +614,7 @@ public class WidgetUtil {
/**
* Gets the border-box height for the given element, i.e. element height +
* border + padding.
*
*
* @since 7.5.1
* @param element
* The element to check
@@ -644,7 +644,7 @@ public class WidgetUtil {
* <p>
* In case the browser doesn't support bounding rectangles, the returned
* value is the offset width.
*
*
* @param element
* the element of which to calculate the width
* @return the width of the element
@@ -661,7 +661,7 @@ public class WidgetUtil {
* <p>
* In case the browser doesn't support bounding rectangles, the returned
* value is the offset width.
*
*
* @param element
* the element of which to calculate the width
* @return the subpixel-accurate width of the element
@@ -723,7 +723,7 @@ public class WidgetUtil {
* <p>
* In case the browser doesn't support bounding rectangles, the returned
* value is the offset height.
*
*
* @param element
* the element of which to calculate the height
* @return the height of the element
@@ -740,7 +740,7 @@ public class WidgetUtil {
* <p>
* In case the browser doesn't support bounding rectangles, the returned
* value is the offset height.
*
*
* @param element
* the element of which to calculate the height
* @return the subpixel-accurate height of the element
@@ -769,7 +769,7 @@ public class WidgetUtil {

/**
* Detects what is currently the overflow style attribute in given element.
*
*
* @param pe
* the element to detect
* @return true if auto or scroll
@@ -792,7 +792,7 @@ public class WidgetUtil {
* A simple helper method to detect "computed style" (aka style sheets +
* element styles). Values returned differ a lot depending on browsers.
* Always be very careful when using this.
*
*
* @param el
* the element from which the style property is detected
* @param p
@@ -803,7 +803,7 @@ public class WidgetUtil {
com.google.gwt.dom.client.Element el, String p)
/*-{
try {
if (el.currentStyle) {
// IE
return el.currentStyle[p];
@@ -818,12 +818,12 @@ public class WidgetUtil {
} catch (e) {
return "";
}
}-*/;

/**
* Will (attempt) to focus the given DOM Element.
*
*
* @param el
* the element to focus
*/
@@ -832,7 +832,7 @@ public class WidgetUtil {
try {
el.focus();
} catch (e) {
}
}-*/;

@@ -846,7 +846,7 @@ public class WidgetUtil {
* {@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
* @param class1
@@ -883,7 +883,7 @@ public class WidgetUtil {

/**
* Force webkit to redraw an element
*
*
* @param element
* The element that should be redrawn
*/
@@ -901,7 +901,7 @@ public class WidgetUtil {
* Performs a hack to trigger a re-layout in the IE8. This is usually
* necessary in cases where IE8 "forgets" to update child elements when they
* resize.
*
*
* @param e
* The element to perform the hack on
*/
@@ -915,7 +915,7 @@ public class WidgetUtil {
* Performs a hack to trigger a re-layout in the IE browser. This is usually
* necessary in cases where IE "forgets" to update child elements when they
* resize.
*
*
* @since 7.3
* @param e
* The element to perform the hack on
@@ -929,9 +929,9 @@ public class WidgetUtil {
/**
* Detaches and re-attaches the element from its parent. The element is
* reattached at the same position in the DOM as it was before.
*
*
* Does nothing if the element is not attached to the DOM.
*
*
* @param element
* The element to detach and re-attach
*/
@@ -966,7 +966,7 @@ public class WidgetUtil {

/**
* Returns the index of the childElement within its parent.
*
*
* @param subElement
* @return
*/
@@ -984,7 +984,7 @@ public class WidgetUtil {
* Temporarily sets the {@code styleProperty} to {@code tempValue} and then
* resets it to its current value. Used mainly to work around rendering
* issues in IE (and possibly in other browsers)
*
*
* @param element
* The target element
* @param styleProperty
@@ -1010,7 +1010,7 @@ public class WidgetUtil {
* A helper method to return the client position from an event. Returns
* position from either first changed touch (if touch event) or from the
* event itself.
*
*
* @param event
* @return
*/
@@ -1026,7 +1026,7 @@ public class WidgetUtil {
* Find the element corresponding to the coordinates in the passed mouse
* event. Please note that this is not always the same as the target of the
* event e.g. if event capture is used.
*
*
* @param event
* the mouse event to get coordinates from
* @return the element at the coordinates of the event
@@ -1042,7 +1042,7 @@ public class WidgetUtil {
* A helper method to return the client position from an event. Returns
* position from either first changed touch (if touch event) or from the
* event itself.
*
*
* @param event
* @return
*/
@@ -1055,7 +1055,7 @@ public class WidgetUtil {
}

/**
*
*
* @see #getTouchOrMouseClientY(Event)
* @param currentGwtEvent
* @return
@@ -1066,7 +1066,7 @@ public class WidgetUtil {

/**
* @see #getTouchOrMouseClientX(Event)
*
*
* @param event
* @return
*/
@@ -1134,7 +1134,7 @@ public class WidgetUtil {

/**
* Gets the currently focused element.
*
*
* @return The active element or null if no active element could be found.
*/
public native static Element getFocusedElement()
@@ -1142,15 +1142,15 @@ public class WidgetUtil {
if ($wnd.document.activeElement) {
return $wnd.document.activeElement;
}
return null;
}-*/;

/**
* Gets currently focused element and checks if it's editable
*
*
* @since 7.4
*
*
* @return true if focused element is editable
*/
public static boolean isFocusedElementEditable() {
@@ -1172,7 +1172,7 @@ public class WidgetUtil {
* this method checks that this widget nor any of its parents is hidden. Can
* be e.g used to check whether component should react to some events or
* not.
*
*
* @param widget
* @return true if attached and displayed
*/
@@ -1205,7 +1205,7 @@ public class WidgetUtil {
/**
* Scrolls an element into view vertically only. Modified version of
* Element.scrollIntoView.
*
*
* @param elem
* The element to scroll into view
*/
@@ -1213,11 +1213,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) {
@@ -1226,12 +1226,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;
}
@@ -1240,7 +1240,7 @@ public class WidgetUtil {
/**
* Checks if the given event is either a touch event or caused by the left
* mouse button
*
*
* @param event
* @return true if the event is a touch event or caused by the left mouse
* button, false otherwise
@@ -1253,7 +1253,7 @@ public class WidgetUtil {
/**
* Resolve a relative URL to an absolute URL based on the current document's
* location.
*
*
* @param url
* a string with the relative URL to resolve
* @return the corresponding absolute URL as a string
@@ -1282,12 +1282,12 @@ public class WidgetUtil {

/**
* Sets the selection range of an input element.
*
*
* We need this JSNI function to set selection range so that we can use the
* optional direction attribute to set the anchor to the end and the focus
* to the start. This makes Firefox work the same way as other browsers
* (#13477)
*
*
* @param elem
* the html input element.
* @param pos
@@ -1298,7 +1298,7 @@ public class WidgetUtil {
* a string indicating the direction in which the selection was
* performed. This may be "forward" or "backward", or "none" if
* the direction is unknown or irrelevant.
*
*
* @since 7.3
*/
public native static void setSelectionRange(Element elem, int pos,
@@ -1313,7 +1313,7 @@ public class WidgetUtil {

/**
* JavaScript hack to prevent text selection in various browsers.
*
*
* @since 7.6
* @param e
* element for enabling or disabling text selection
@@ -1336,7 +1336,7 @@ public class WidgetUtil {

/**
* JavaScript hack to clear text selection in various browsers.
*
*
* @since 7.6
*/
public native static void clearTextSelection()
@@ -1358,13 +1358,13 @@ public class WidgetUtil {
/**
* Compares two double values with the error margin of
* {@link #PIXEL_EPSILON} (i.e. {@value #PIXEL_EPSILON})
*
*
* @param num1
* the first value for which to compare equality
* @param num2
* the second value for which to compare equality
* @since 7.4
*
*
* @return true if the values are considered equals; false otherwise
*/
public static boolean pixelValuesEqual(final double num1,
@@ -1416,7 +1416,7 @@ public class WidgetUtil {
* Wrap a css size value and its unit and translate back and forth to the
* string representation.<br/>
* Eg. 50%, 123px, ...
*
*
* @since 7.2.6
* @author Vaadin Ltd
*/
@@ -1435,7 +1435,7 @@ public class WidgetUtil {

/**
* Gets the unit value by its type.
*
*
* @param type
* the type of the unit as found in the style.
* @return the unit value.
@@ -1452,7 +1452,7 @@ public class WidgetUtil {

/**
* Parse the size from string format to {@link CssSize}.
*
*
* @param s
* the size as string.
* @return a {@link CssSize} object.
@@ -1492,7 +1492,7 @@ public class WidgetUtil {

/**
* Creates a {@link CssSize} using a value and its measurement unit.
*
*
* @param value
* the value.
* @param unit
@@ -1520,7 +1520,7 @@ public class WidgetUtil {

/**
* Gets the value for this css size.
*
*
* @return the value.
*/
public float getValue() {
@@ -1529,7 +1529,7 @@ public class WidgetUtil {

/**
* Gets the measurement unit for this css size.
*
*
* @return the unit.
*/
public Unit getUnit() {
@@ -1553,7 +1553,7 @@ public class WidgetUtil {

/**
* Check whether the two sizes are equals.
*
*
* @param cssSize1
* the first size to compare.
* @param cssSize2
@@ -1576,7 +1576,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1591,7 +1591,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1608,7 +1608,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1624,7 +1624,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1639,7 +1639,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1654,7 +1654,7 @@ public class WidgetUtil {
* <p>
* The value is determined using computed style when available and
* calculated otherwise.
*
*
* @since 7.5.0
* @param element
* the element to measure
@@ -1688,20 +1688,20 @@ public class WidgetUtil {
}
var heightWithoutBorder = cloneElement.offsetHeight;
parentElement.removeChild(cloneElement);
return heightWithBorder - heightWithoutBorder;
}
}-*/;

/**
* Rounds the given size up to a value which the browser will accept.
*
*
* Safari/WebKit uses 1/64th of a pixel to enable using integer math
* (http://trac.webkit.org/wiki/LayoutUnit).
*
*
* Firefox uses 1/60th of a pixel because it is divisible by three
* (https://bugzilla.mozilla.org/show_bug.cgi?id=1070940)
*
*
* @since 7.5.1
* @param size
* the value to round
@@ -1713,15 +1713,15 @@ public class WidgetUtil {

/**
* Rounds the given size down to a value which the browser will accept.
*
*
* Safari/WebKit uses 1/64th of a pixel to enable using integer math
* (http://trac.webkit.org/wiki/LayoutUnit).
*
*
* Firefox uses 1/60th of a pixel because it is divisible by three
* (https://bugzilla.mozilla.org/show_bug.cgi?id=1070940)
*
*
* IE9+ uses 1/100th of a pixel
*
*
* @since 7.5.1
* @param size
* the value to round
@@ -1754,7 +1754,7 @@ public class WidgetUtil {

/**
* Returns the factor used by browsers to round subpixel values
*
*
* @since 7.5.1
* @return the factor N used by the browser when storing subpixels as X+Y/N
*/

+ 5
- 5
client/src/main/java/com/vaadin/client/annotations/OnStateChange.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -33,7 +33,7 @@ import com.vaadin.client.communication.StateChangeEvent;
* <p>
* If there is no state variable with the provided name, the widgetset
* compilation will fail.
*
*
* @since 7.2
* @author Vaadin Ltd
*/
@@ -43,7 +43,7 @@ import com.vaadin.client.communication.StateChangeEvent;
public @interface OnStateChange {
/**
* Defines a list of property names to listen for.
*
*
* @return an array of property names, should contain at least one item
*/
public String[] value();

+ 4
- 4
client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -36,7 +36,7 @@ public abstract class AbstractServerConnectorEvent<H extends EventHandler>

/**
* Sends this event to the given handler.
*
*
* @param handler
* The handler to dispatch.
*/

+ 8
- 8
client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java View File

@@ -42,7 +42,7 @@ import elemental.json.JsonObject;
/**
* The default {@link PushConnection} implementation that uses Atmosphere for
* handling the communication channel.
*
*
* @author Vaadin Ltd
* @since 7.1
*/
@@ -140,7 +140,7 @@ public class AtmospherePushConnection implements PushConnection {

/*
* (non-Javadoc)
*
*
* @see
* com.vaadin.client.communication.PushConnection#init(ApplicationConnection
* , Map<String, String>, CommunicationErrorHandler)
@@ -308,9 +308,9 @@ public class AtmospherePushConnection implements PushConnection {
/**
* Called whenever a server push connection is established (or
* re-established).
*
*
* @param response
*
*
* @since 7.2
*/
protected void onConnect(AtmosphereResponse response) {
@@ -338,7 +338,7 @@ public class AtmospherePushConnection implements PushConnection {

/*
* (non-Javadoc)
*
*
* @see com.vaadin.client.communication.PushConenction#disconnect()
*/
@Override
@@ -392,7 +392,7 @@ public class AtmospherePushConnection implements PushConnection {
/**
* Called if the push connection fails. Atmosphere will automatically retry
* the connection until successful.
*
*
*/
protected void onError(AtmosphereResponse response) {
state = State.DISCONNECTED;
@@ -526,7 +526,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);
@@ -552,7 +552,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);
}-*/;


+ 20
- 20
client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -25,11 +25,11 @@ import elemental.json.JsonObject;
/**
* Interface for handling problems and other events which occur during
* communication with the server.
*
*
* The handler is responsible for handling any problem in XHR, heartbeat and
* push connections in a way it sees fit. The default implementation is
* {@link DefaultConnectionStateHandler}.
*
*
* @since 7.6
* @author Vaadin Ltd
*/
@@ -46,7 +46,7 @@ public interface ConnectionStateHandler {

/**
* Called when an exception occurs during a {@link Heartbeat} request
*
*
* @param request
* The heartbeat request
* @param exception
@@ -56,7 +56,7 @@ public interface ConnectionStateHandler {

/**
* Called when a heartbeat request returns a status code other than OK (200)
*
*
* @param request
* The heartbeat request
* @param response
@@ -74,7 +74,7 @@ public interface ConnectionStateHandler {
* result in the push connection trying a fallback connection method, trying
* to reconnect to the server or might just be an indication that the
* connection was intentionally closed ("unsubscribe"),
*
*
* @param pushConnection
* The push connection which was closed
* @param response
@@ -86,10 +86,10 @@ public interface ConnectionStateHandler {
/**
* Called when a client side timeout occurs before a push connection to the
* server completes.
*
*
* The client side timeout causes a disconnection of the push connection and
* no reconnect will be attempted after this method is called,
*
*
* @param pushConnection
* The push connection which timed out
* @param response
@@ -100,13 +100,13 @@ public interface ConnectionStateHandler {

/**
* Called when a fatal error fatal error occurs in the push connection.
*
*
* The push connection will not try to recover from this situation itself
* and typically the problem handler should not try to do automatic recovery
* either. The cause can be e.g. maximum number of reconnection attempts
* have been reached, neither the selected transport nor the fallback
* transport can be used or similar.
*
*
* @param pushConnection
* The push connection where the error occurred
* @param response
@@ -117,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
*
*
* @param pushConnection
* The push connection which will be reconnected
*/
@@ -125,7 +125,7 @@ public interface ConnectionStateHandler {

/**
* Called when the push connection to the server has been established.
*
*
* @param pushConnection
* The push connection which was established
*/
@@ -133,7 +133,7 @@ public interface ConnectionStateHandler {

/**
* Called when the required push script could not be loaded
*
*
* @param resourceUrl
* The URL which was used for loading the script
*/
@@ -142,7 +142,7 @@ public interface ConnectionStateHandler {
/**
* Called when an exception occurs during an XmlHttpRequest request to the
* server.
*
*
* @param xhrConnectionError
* An event containing what was being sent to the server and what
* exception occurred
@@ -152,7 +152,7 @@ public interface ConnectionStateHandler {
/**
* Called when invalid content (not JSON) was returned from the server as
* the result of an XmlHttpRequest request
*
*
* @param communicationProblemEvent
* An event containing what was being sent to the server and what
* was returned
@@ -162,7 +162,7 @@ public interface ConnectionStateHandler {
/**
* Called when invalid status code (not 200) was returned by the server as
* the result of an XmlHttpRequest.
*
*
* @param communicationProblemEvent
* An event containing what was being sent to the server and what
* was returned
@@ -177,7 +177,7 @@ public interface ConnectionStateHandler {
/**
* Called when a message is to be sent to the server through the push
* channel but the push channel is not connected
*
*
* @param payload
* The payload to send to the server
*/
@@ -186,7 +186,7 @@ public interface ConnectionStateHandler {
/**
* Called when invalid content (not JSON) was pushed from the server through
* the push connection
*
*
* @param communicationProblemEvent
* An event containing what was being sent to the server and what
* was returned

+ 4
- 4
client/src/main/java/com/vaadin/client/communication/Date_Serializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -25,7 +25,7 @@ import elemental.json.JsonValue;

/**
* Client side serializer/deserializer for java.util.Date
*
*
* @since 7.2
* @author Vaadin Ltd
*/

+ 15
- 15
client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -42,7 +42,7 @@ import elemental.json.JsonObject;
* <p>
* Handles permanent errors by showing a critical system notification to the
* user
*
*
* @since 7.6
* @author Vaadin Ltd
*/
@@ -78,7 +78,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Checks if this type is of higher priority than the given type
*
*
* @param type
* the type to compare to
* @return true if this type has higher priority than the given type,
@@ -116,7 +116,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Checks if we are currently trying to reconnect
*
*
* @return true if we have noted a problem and are trying to re-establish
* server connection, false otherwise
*/
@@ -130,7 +130,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Returns the connection this handler is connected to
*
*
* @return the connection for this handler
*/
protected ApplicationConnection getConnection() {
@@ -185,7 +185,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
*
*
* @param type
* The type of failure detected
* @param payload
@@ -243,10 +243,10 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Called after a problem occurred.
*
*
* This method is responsible for re-sending the payload to the server (if
* not null) or re-send a heartbeat request at some point
*
*
* @param payload
* the payload that did not reach the server, null if the problem
* was detected by a heartbeat
@@ -274,7 +274,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {
/**
* Re-sends the payload to the server (if not null) or re-sends a heartbeat
* request immediately
*
*
* @param payload
* the payload that did not reach the server, null if the problem
* was detected by a heartbeat
@@ -308,7 +308,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {
/**
* Called when we should give up trying to reconnect and let the user decide
* how to continue
*
*
*/
protected void giveUp() {
reconnectionCause = null;
@@ -339,7 +339,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Checks if the reconnect dialog is visible to the user
*
*
* @return true if the user can see the dialog, false otherwise
*/
protected boolean isDialogVisible() {
@@ -371,7 +371,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {
/**
* Gets the text to show in the reconnect dialog after giving up (reconnect
* limit reached)
*
*
* @param reconnectAttempt
* The number of the current reconnection attempt
* @return The text to show in the reconnect dialog after giving up
@@ -383,7 +383,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler {

/**
* Gets the text to show in the reconnect dialog
*
*
* @param reconnectAttempt
* The number of the current reconnection attempt
* @return The text to show in the reconnect dialog

+ 4
- 4
client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -33,7 +33,7 @@ import com.vaadin.client.ui.VOverlay;

/**
* The default implementation of the reconnect dialog
*
*
* @since 7.6
* @author Vaadin Ltd
*/

+ 4
- 4
client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -22,7 +22,7 @@ import elemental.json.JsonValue;
public interface DiffJSONSerializer<T> extends JSONSerializer<T> {
/**
* Update the target object in place based on the passed JSON data.
*
*
* @param target
* @param jsonValue
* @param connection

+ 3
- 3
client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 6
- 6
client/src/main/java/com/vaadin/client/communication/Heartbeat.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -31,7 +31,7 @@ import com.vaadin.shared.util.SharedUtil;

/**
* Handles sending of heartbeats to the server and reacting to the response
*
*
* @since 7.2
* @author Vaadin Ltd
*/
@@ -54,7 +54,7 @@ public class Heartbeat {

/**
* Initializes the heartbeat for the given application connection
*
*
* @param connection
* the connection
*/
@@ -161,7 +161,7 @@ public class Heartbeat {

/**
* Changes the heartbeatInterval in runtime and applies it.
*
*
* @param heartbeatInterval
* new interval in seconds.
*/

+ 7
- 7
client/src/main/java/com/vaadin/client/communication/JSONSerializer.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -34,7 +34,7 @@ import elemental.json.JsonValue;
* <p>
* This is the client side interface, see
* com.vaadin.server.communication.JSONSerializer for the server side interface.
*
*
* @since 7.0
*/
public interface JSONSerializer<T> {
@@ -43,14 +43,14 @@ public interface JSONSerializer<T> {
* Creates and deserializes an object received from the server. Must be
* compatible with {@link #serialize(Object, ApplicationConnection)} and
* also with the server side JsonCodec.encode method.
*
*
* @param type
* the type to deserialize
* @param jsonValue
* JSON map from property name to property value
* @param connection
* the application connection providing the context
*
*
* @return A deserialized object
*/
T deserialize(Type type, JsonValue jsonValue,
@@ -60,7 +60,7 @@ public interface JSONSerializer<T> {
* Serialize the given object into JSON. Must be compatible with
* {@link #deserialize(Type, JsonValue, ApplicationConnection)} and also
* with the server side JsonCodec.decodeCustomType method.
*
*
* @param value
* The object to serialize
* @param connection

+ 4
- 4
client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -21,7 +21,7 @@ import com.vaadin.shared.communication.MethodInvocation;
/**
* A {@link MethodInvocation} that originates from JavaScript. This means that
* there might not be any type information available on the client.
*
*
* @author Vaadin Ltd
* @since 7.0.0
*/

+ 3
- 3
client/src/main/java/com/vaadin/client/communication/JsonDecoder.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ 8
- 8
client/src/main/java/com/vaadin/client/communication/JsonEncoder.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -39,12 +39,12 @@ import elemental.json.JsonValue;
/**
* Encoder for converting RPC parameters and other values to JSON for transfer
* between the client and the server.
*
*
* Currently, basic data types as well as Map, String[] and Object[] are
* supported, where maps and Object[] can contain other supported data types.
*
*
* TODO extensible type support
*
*
* @since 7.0
*/
public class JsonEncoder {
@@ -52,7 +52,7 @@ public class JsonEncoder {
/**
* Encode a value to a JSON representation for transport from the client to
* the server.
*
*
* @param value
* value to convert
* @param connection
@@ -292,7 +292,7 @@ public class JsonEncoder {
/**
* Returns the transport type for the given value. Only returns a transport
* type for internally handled values.
*
*
* @param value
* The value that should be transported
* @return One of the JsonEncode.VTYPE_ constants or null if the value

+ 22
- 22
client/src/main/java/com/vaadin/client/communication/MessageHandler.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -79,7 +79,7 @@ import elemental.json.JsonObject;
* A MessageHandler is responsible for handling all incoming messages (JSON)
* from the server (state changes, RPCs and other updates) and ensuring that the
* connectors are updated accordingly.
*
*
* @since 7.6
* @author Vaadin Ltd
*/
@@ -156,7 +156,7 @@ public class MessageHandler {
* has not yet been rendered (or that your browser is very fast). -1 means
* that the browser does not support the performance.timing feature used to
* get this measurement.
*
*
* Note: also used for tracking whether the first UIDL has been handled
*/
private int bootstrapTime = 0;
@@ -209,7 +209,7 @@ public class MessageHandler {
/**
* Sets the application connection this instance is connected to. Called
* internally by the framework.
*
*
* @param connection
* the application connection this instance is connected to
*/
@@ -224,7 +224,7 @@ public class MessageHandler {
/**
* Handles a received UIDL JSON text, parsing it, and passing it on to the
* appropriate handlers, while logging timing information.
*
*
* @param jsonText
* The JSON to handle
*/
@@ -743,13 +743,13 @@ public class MessageHandler {
/**
* Sends the state change events created while updating the state
* information.
*
*
* This must be called after hierarchy change listeners have been
* called. At least caption updates for the parent are strange if
* fired from state change listeners and thus calls the parent
* BEFORE the parent is aware of the child (through a
* ConnectorHierarchyChangedEvent)
*
*
* @param pendingStateChangeEvents
* The events to send
*/
@@ -1122,7 +1122,7 @@ public class MessageHandler {
* Updates the connector hierarchy and returns a list of events that
* should be fired after update of the hierarchy and the state is
* done.
*
*
* @param json
* The JSON containing the hierarchy information
* @return A collection of events that should be fired when update
@@ -1203,7 +1203,7 @@ public class MessageHandler {

/**
* Updates the hierarchy for a connector
*
*
* @param connectorId
* the id of the connector to update
* @param childConnectorIds
@@ -1590,7 +1590,7 @@ public class MessageHandler {
/**
* This method can be used to postpone rendering of a response for a short
* period of time (e.g. to avoid the rendering process during animation).
*
*
* @param lock
*/
public void suspendReponseHandling(Object lock) {
@@ -1599,7 +1599,7 @@ public class MessageHandler {

/**
* Resumes the rendering process once all locks have been removed.
*
*
* @param lock
*/
public void resumeResponseHandling(Object lock) {
@@ -1629,7 +1629,7 @@ public class MessageHandler {
/**
* Finds the next pending UIDL message and handles it (next pending is
* decided based on the server id)
*
*
* @return true if a message was handled, false otherwise
*/
private boolean handlePendingMessages() {
@@ -1682,7 +1682,7 @@ public class MessageHandler {
* server is received.
* <p>
* The initial id when no request has yet been processed is -1.
*
*
* @return an id identifying the response
*/
public int getLastSeenServerSyncId() {
@@ -1692,7 +1692,7 @@ public class MessageHandler {
/**
* Gets the token (aka double submit cookie) that the server uses to protect
* against Cross Site Request Forgery attacks.
*
*
* @return the CSRF token string
*/
public String getCsrfToken() {
@@ -1704,7 +1704,7 @@ public class MessageHandler {
* operations are not allowed when the internal state of the application
* might be in an inconsistent state because some state changes have been
* applied but others not. This includes running layotus.
*
*
* @return <code>true</code> if the internal state might be inconsistent
* because changes are being processed; <code>false</code> if the
* state should be consistent
@@ -1715,7 +1715,7 @@ public class MessageHandler {

/**
* Checks if the first UIDL has been handled
*
*
* @return true if the initial UIDL has already been processed, false
* otherwise
*/
@@ -1745,9 +1745,9 @@ public class MessageHandler {

/**
* Strips the JSON wrapping from the given json string with wrapping.
*
*
* If the given string is not wrapped as expected, returns null
*
*
* @since 7.6
* @param jsonWithWrapping
* the JSON received from the server
@@ -1769,7 +1769,7 @@ public class MessageHandler {

/**
* Unwraps and parses the given JSON, originating from the server
*
*
* @param jsonText
* the json from the server
* @return A parsed ValueMap or null if the input could not be parsed (or
@@ -1803,7 +1803,7 @@ public class MessageHandler {

/**
* Parse the given wrapped JSON, received from the server, to a ValueMap
*
*
* @param wrappedJsonText
* the json, wrapped as done by the server
* @return a ValueMap, or null if the wrapping was incorrect or json could

+ 13
- 13
client/src/main/java/com/vaadin/client/communication/MessageSender.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -40,7 +40,7 @@ import elemental.json.JsonValue;
* <p>
* Internally uses {@link XhrConnection} and/or {@link PushConnection} for
* delivering messages, depending on the application configuration.
*
*
* @since 7.6
* @author Vaadin Ltd
*/
@@ -94,7 +94,7 @@ public class MessageSender {
/**
* Sends all pending method invocations (server RPC and legacy variable
* changes) to the server.
*
*
*/
private void doSendInvocationsToServer() {

@@ -137,7 +137,7 @@ public class MessageSender {

/**
* Makes an UIDL request to the server.
*
*
* @param reqInvocations
* Data containing RPC invocations and all related information.
* @param extraParams
@@ -172,7 +172,7 @@ public class MessageSender {
/**
* Sends an asynchronous or synchronous UIDL request to the server using the
* given URI.
*
*
* @param uri
* The URI to use for the request. May includes GET parameters
* @param payload
@@ -188,7 +188,7 @@ public class MessageSender {

/**
* Sets the status for the push connection.
*
*
* @param enabled
* <code>true</code> to enable the push connection;
* <code>false</code> to disable the push connection.
@@ -275,7 +275,7 @@ public class MessageSender {
/**
* Runs possibly registered client side post request hooks. This is expected
* to be run after each uidl request made by Vaadin application.
*
*
* @param appId
*/
public static native void runPostRequestHooks(String appId)
@@ -295,7 +295,7 @@ public class MessageSender {
/**
* If on Liferay and logged in, ask the client side session management
* JavaScript to extend the session duration.
*
*
* Otherwise, Liferay client side JavaScript will explicitly expire the
* session even though the server side considers the session to be active.
* See ticket #8305 for more information.
@@ -314,7 +314,7 @@ public class MessageSender {
/**
* Indicates whether or not there are currently active UIDL requests. Used
* internally to sequence requests properly, seldom needed in Widgets.
*
*
* @return true if there are active requests
*/
public boolean hasActiveRequest() {
@@ -324,7 +324,7 @@ public class MessageSender {
/**
* Returns a human readable string representation of the method used to
* communicate with the server.
*
*
* @return A string representation of the current transport type
*/
public String getCommunicationMethodName() {
@@ -366,7 +366,7 @@ public class MessageSender {

/**
* Used internally to update what the server expects
*
*
* @param clientToServerMessageId
* the new client id to set
* @param force

+ 12
- 12
client/src/main/java/com/vaadin/client/communication/PushConnection.java View File

@@ -1,12 +1,12 @@
/*
* Copyright 2000-2014 Vaadin Ltd.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
*
* http://www.apache.org/licenses/LICENSE-2.0
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -28,7 +28,7 @@ import elemental.json.JsonObject;
* receive UIDL messages from the server (either asynchronously or as a response
* to a UIDL request.) Delegates the UIDL handling to the
* {@link ApplicationConnection}.
*
*
* @author Vaadin Ltd
* @since 7.1
*/
@@ -36,7 +36,7 @@ public interface PushConnection {

/**
* Two-phase construction to allow using GWT.create().
*
*
* @param connection
* The ApplicationConnection
*/
@@ -54,12 +54,12 @@ public interface PushConnection {
* <p>
* This method must not be called if the push connection is not
* bidirectional (if {@link #isBidirectional()} returns false)
*
*
* @param payload
* the payload to push
* @throws IllegalStateException
* if this connection is not active
*
*
* @see #isActive()
*/
public void push(JsonObject payload);
@@ -68,7 +68,7 @@ public interface PushConnection {
* Checks whether this push connection is in a state where it can push
* messages to the server. A connection is active until
* {@link #disconnect(Command)} has been called.
*
*
* @return <code>true</code> if this connection can accept new messages;
* <code>false</code> if this connection is disconnected or
* disconnecting.
@@ -85,7 +85,7 @@ public interface PushConnection {
* After this method has been called, {@link #isActive()} returns
* <code>false</code>. Calling this method for a connection that is no
* longer active will throw an exception.
*
*
* @param command
* callback command invoked when the connection has been properly
* disconnected
@@ -97,7 +97,7 @@ public interface PushConnection {
/**
* Returns a human readable string representation of the transport type used
* to communicate with the server.
*
*
* @since 7.1
* @return A human readable string representation of the transport type
*/
@@ -107,10 +107,10 @@ public interface PushConnection {
* Checks whether this push connection should be used for communication in
* both directions or if an XHR should be used for client to server
* communication.
*
*
* A bidirectional push connection must be able to reliably inform about its
* connection state.
*
*
* @since 7.6
* @return true if the push connection should be used for messages in both
* directions, false if it should only be used for server to client

+ 0
- 0
client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java View File


Some files were not shown because too many files changed in this diff

Loading…
Cancel
Save