The widgets provide functionalities to select the files to upload with HTML5's Drag & Drop, or if HTML5 is not supported by the browser then fallback to Flash or IFrame solution.
So the widgets don't really need a form to be able to do their work. All they need is a destination URL to send the bytes to.
Users of Apache Wicket know very well its WebPage component. It is used as a main container of other smaller components that construct the content that is delivered to the client when a given url is requested.
Since file uploading doesn't really need to construct a page and its optional response often is just a piece of data explaining that the upload is successful or not we are going to use Wicket's IResource as an endpoint. IResource could be mounted at a predefined mount path just like pages by using a ResourceReference:
Here we mounted two resources - one as destination for the file uploads and another for managing the uploaded files (it can serve and delete them).
Check Wicket 1.5 - Mounting resources for more information.
Reading the uploaded files
The main problem to solve is how to read the uploaded files from the request parameters.
Actually the solution is quite simple, just few lines of code:
We just asked Wicket to create a WebRequest that knows how to read the multipart request parameters. The final result is a map with keys the name of the request parameter and values the respective FileItems which can be used to get the uploaded file's name, size, input stream, etc.
And basically that's it!
From here on our code is responsible to store somewhere these files and return a response to the client is the format it expects - JSON, HTML, ...
At my GitHub account you may find a demo application that integrates jQuery-File-Upload. I've chosen this widget because it looks very nice and I wanted to contribute it to Wicket Bootstrap project. It appeared that the docs and APIs of this widget are not the best one could wish for. To be able to duplicate the functionalities from its demo page I had to read and debug its internals (specifically jquery.fileupload-ui.js).
There are still some functionalities which do not work completely:
- the cancel button
- the gallery preview of the uploaded files
- the UI is broken in IE (I blame my CSS skills for that!)
But all these are not directly related to the topic of this post - how to upload files to Wicket IResource and how to read them at the server side.
If you need this component for your application and you fix this issues I'll gladly accept your Pull Requests.