Deprecated items

erg144 · July 22, 2025, 10:08am

I noticed a number of deprecated items (e.g. StreamResources) that have just been deprecated and marked for removal.

Suggestion

It would be quite helpful if those items also contained suggested alternatives within the docs.

marcoc_753 · July 22, 2025, 10:28am

Thanks for reporting.
I quickly checked, and at least StreamResource javadoc mentions the alternative

If the information is missing on other components, please create an issue on the Flow GitHub repository.

marcoc_753 · July 22, 2025, 10:30am

But maybe you are talking about the online documentation. In this case you can create a ticket on the docs repository.

erg144 · July 24, 2025, 6:33pm

All of the items i have marked as deprecated do not have any alternative suggestions. I’m using Intelj and when I hover over the item it shows like in the upload photo.

marcoc_753 · July 24, 2025, 7:37pm

Actually, looking at the source code the replacement is indicated in the Javadoc

github.com

vaadin/flow-components/blob/main/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Upload.java#L175-L187


      
          /**
           * Create a new instance of Upload with the given receiver.
           *
           * @param receiver
           *            receiver that handles the upload
           * @deprecated use {@link #Upload(UploadHandler)} instead
           */
          @Deprecated(since = "24.8", forRemoval = true)
          public Upload(Receiver receiver) {
              this();
          
              setReceiver(receiver);
          }

Did you download the javadoc (and optionally sources) inside Intellij IDEA?

erg144 · July 24, 2025, 7:50pm

That is likely the issue (did not download the source or javadocs - relied on IntelleJ decompiling I guess. Thanks for the heads up.