To configure the GifUploadServlet, it is necessary to add it in the admintool.
Manage the Webserver, and select the servlets button. On the lefthand side of
the tool, select add. Add the servlet with a name of gifup
and
a servlet class of GifUploadServlet
.
Once you have added the servlet, you will need to configure it. The
arguments field is used to configure initialization parameters.
You will need to add at least one initialization parameter. The
required parameter is tempDirectory
, which is the value
the value of the directory used to store the uploaded files. In our example,
we'll set it to public_html/temp
. There are two additional,
optional parameters which you can set. The first is urlAvail
.
This parameter tells the servlet what the URL path is that can be used to find
the gif directory. Do not set if you do not want the users to be able to see
the uploaded files. For our example, we'll set it to /temp/
.
The last parameter is maxSize
, the maximum size of an uploaded
file. We'll leave this at the default of 1MB for our example.
So, for our example, we'd set the Argument field to be:
tempDirectory=public_html/temp,urlAvail=/temp/
WARNING: File upload opens up the potential for huge security holes. Please be very careful in all your implementations of this technology. As in all matters related to security, it is best to have your work reveiwed for security implications by a qualified professional. This example is believed safe, however it is still recommended that this example not be enabled on a production webserver. At the least, no real attempt has been made to stop a denial of service attack on your diskspace. An unscrupulous programmer could use this servlet to quickly fill even the largest harddrive.