developerguide.html

uploadbean数据包

                          </tr>
                        </table>
                      </td>
                    </tr>
                  </table>
                  <p><font size="-2" face="Verdana, Arial, Helvetica, sans-serif"><font size="-1"><u><font color="#333333" size="-2"><b>Notes</b></font></u><font color="#333333"><b><font size="-2"> : </font></b><font size="-2"><br>
1 - &quot;scope=application&quot; is recommended to avoid multiples database connections.&quot;scope=session is acceptable small amount of users. &quot;scope=request&quot; is not recommended without JDBC ConnectionPool.<br>
2 - <b>UploadBean won't close the database connection</b>. You can do it when needed by calling :<br>
upBean.getDatabasestore().close(</font></font></font><font color="#333333" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2">)<br>
3 - </font><font size="-2" face="Verdana, Arial, Helvetica, sans-serif">A full sample is available through <a href="../DatabaseUpload.jsp">DatabaseUpload.jsp</a></font></font><br>
<font color="#333333" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2">4 - </font><font size="-2" face="Verdana, Arial, Helvetica, sans-serif">For DB2 script see <a href="sql/upload_db2.sql">upload_db2.sq</a>l, for PostGreSQL see <a href="sql/upload_postgresql.sql">upload_postgresql.sql</a> and for MySQL script see <a href="sql/upload_mysql.sql">upload_mysql.sql</a></font></font><br>
<font color="#333333" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2">5 - </font><font size="-2" face="Verdana, Arial, Helvetica, sans-serif">If UploadBean database store does not suit to your needs then you could implement your own <a href="api.html">DBStore</a>. A sample is available in&nbsp;<a href="http://www.javazoom.net/jzservlets/uploadbean/uploadbeantools.html">add-ons</a> section.<br>
</font></font><font size="-1"><br>
</font></font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td valign="top" bgcolor="#FFFFCC"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><b><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/right_red-arrow.gif" width="18" height="14" align="absmiddle">&nbsp;</font><font color="#FF0000">Memory </font><font color="#FF0000">:</font><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><a name="memory"></a></font></b></font></td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2" face="Verdana, Arial, Helvetica, sans-serif"><b><img src="img/memory2.gif" width="41" height="44" align="left"></b></font>UploadBean can store uploaded files in JVM memory. Uploaded files will be stored in a &quot;Vector&quot; object. This is a vector of &quot;UploadFile&quot; objects (see <a href="api/index.html" target="_top">API</a> to learn more).<br>
                      <br>
One method is available to initialize the memory store :<br>
</font></p>
                  <ul>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setStoremodel</b>(int storeid)<br>
                        <font color="#666666">Input parameter is a store identifier for MEMORYSTORE.</font></font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
</font></li>
                  </ul>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">Here is a sample.<br>
</font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td bgcolor="#333333"> 
                        <table width="100%" border="0" cellspacing="0" cellpadding="0">
                          <tr> 
                            <td bgcolor="#EEEEEE"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">&lt;jsp:useBean id=&quot;upBean&quot; scope=&quot;session&quot; class=&quot;javazoom.upload.UploadBean&quot;&gt;<br>
&nbsp;&nbsp;&lt;jsp:setProperty name=&quot;<b>upBean</b>&quot; property=&quot;<b><font color="#FF0000">storemodel</font></b>&quot;<br>
&nbsp;&nbsp; value=&quot;<b>&lt;%= UploadBean.MEMORYSTORE %&gt;</b>&quot; /&gt;</font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
&lt;/jsp:useBean&gt;</font></td>
                          </tr>
                        </table>
                      </td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><u><font color="#333333" size="-2"><b>Notes</b></font></u><font color="#333333"><b><font size="-2"> : </font></b><font size="-2"><br>
1 - Using memory store without &quot;scope=session&quot; or </font><font color="#333333" size="-2" face="Verdana, Arial, Helvetica, sans-serif">&quot;scope=application&quot;</font><font size="-2"> is not really useful.<br>
2 - You can access the memory store through upBean.getMemorystore().<br>
3 - All data will be lost when the servlet engine stops (or crashes).<br>
<br>
</font></font> </font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td valign="top" bgcolor="#FFFFCC"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><b><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/right_red-arrow.gif" width="18" height="14" align="absmiddle">&nbsp;</font><font color="#FF0000">Switch to another model </font><font color="#FF0000">:<a name="setstoremodel"></a></font></b></font></td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">One method is available to switch to another store model. It could be useful if, depending on file's Content-Type, you want to switch to folder or zipfile store.<br>
</font></p>
                  <ul>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setStoremodel</b>(int storeid)<br>
                        <font color="#666666">Input parameter is a store identifier..</font></font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
</font></li>
                  </ul>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">Here is a sample.<br>
</font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td bgcolor="#333333"> 
                        <table width="100%" border="0" cellspacing="0" cellpadding="0">
                          <tr> 
                            <td bgcolor="#EEEEEE"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">&lt;some HTML ...<br>
&nbsp;&nbsp;&lt;jsp:setProperty name=&quot;<b>upBean</b>&quot; property=&quot;<b><font color="#FF0000">storemodel</font></b>&quot;<br>
&nbsp;&nbsp; value=&quot;<b>&lt;%= UploadBean.ZIPFILESTORE %&gt;</b>&quot; /&gt;<br>
... some HTML&gt;</font></td>
                          </tr>
                        </table>
                      </td>
                    </tr>
                  </table>
                  <font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><u><font color="#333333" size="-2"><b><br>
Note</b></font></u><font color="#333333"><b><font size="-2"> : </font></b><font size="-2"><br>
- Each storemodel had to been initialized before switching.</font></font></font><br>
                  <br>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td valign="top" bgcolor="#FFFFCC"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><b><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/right_red-arrow.gif" width="18" height="14" align="absmiddle">&nbsp;</font><font color="#FF0000">Blacklist</font><font color="#FF0000">:</font><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><a name="blacklist"></a></font></b></font></td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2" face="Verdana, Arial, Helvetica, sans-serif"><b><img src="img/blacklist.gif" width="48" height="48" align="left"></b></font>UploadBean can filter uploaded files through a blacklist. A blacklist is a list of filenames you don't want to be uploaded/stored (i.e list of denied filenames). If someone try to upload a forbidden file then UploadBean will throw an exception.<br>
                      <br>
One method is available to initialize the blacklist :<br>
</font></p>
                  <ul>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setBlacklist</b>(String list)<br>
                        <font color="#666666">Input parameter is a list of filenames seperated by coma.</font></font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
</font></li>
                  </ul>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">Here is a sample.<br>
</font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td bgcolor="#333333"> 
                        <table width="100%" border="0" cellspacing="0" cellpadding="0">
                          <tr> 
                            <td bgcolor="#EEEEEE"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">&lt;jsp:useBean id=&quot;upBean&quot; scope=&quot;session&quot; class=&quot;javazoom.upload.UploadBean&quot;&gt;<br>
&nbsp;&nbsp;&lt;jsp:setProperty name=&quot;<b>upBean</b>&quot; property=&quot;<b><font color="#FF0000">blacklist</font></b>&quot;<br>
&nbsp;&nbsp; value=&quot;<b>*.zip,*.rar,setup.exe</b>&quot; /&gt;</font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
&lt;/jsp:useBean&gt;</font></td>
                          </tr>
                        </table>
                      </td>
                    </tr>
                  </table>
                  <br>
                  <br>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td valign="top" bgcolor="#FFFFCC"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><b><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/right_red-arrow.gif" width="18" height="14" align="absmiddle">&nbsp;</font><font color="#FF0000">Whitelist</font><font color="#FF0000">:</font><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><a name="whitelist"></a></font></b></font></td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><font size="-2" face="Verdana, Arial, Helvetica, sans-serif"><b><img src="img/blacklist.gif" width="48" height="48" align="left"></b></font>UploadBean can filter uploaded files through a whitelist. A whitelist is a list of filenames that could be uploaded/stored (i.e list of allowed filenames). If someone try to upload a file NOT in whitelist then UploadBean will throw an exception. An empty whitelist means that you can't upload any file. <u>UploadBean allows Blacklist or Whitelist but NOT both</u>. Default is an empty blacklist (all files allowed).<br>
                      <br>
One method is available to initialize the blacklist :<br>
</font></p>
                  <ul>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setWhitelist</b>(String list)<br>
                        <font color="#666666">Input parameter is a list of filenames seperated by coma.</font></font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
</font></li>
                  </ul>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">Here is a sample.<br>
</font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td bgcolor="#333333"> 
                        <table width="100%" border="0" cellspacing="0" cellpadding="0">
                          <tr> 
                            <td bgcolor="#EEEEEE"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">&lt;jsp:useBean id=&quot;upBean&quot; scope=&quot;session&quot; class=&quot;javazoom.upload.UploadBean&quot;&gt;<br>
&nbsp;&nbsp;&lt;jsp:setProperty name=&quot;<b>upBean</b>&quot; property=&quot;<b><font color="#FF0000">whitelist</font></b>&quot; value=&quot;<b>*.ogg,*.mp3</b>&quot; /&gt;</font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
&lt;/jsp:useBean&gt;</font></td>
                          </tr>
                        </table>
                      </td>
                    </tr>
                  </table>
                  <br>
                  <br>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td valign="top" bgcolor="#FFFFCC"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><b><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/right_red-arrow.gif" width="18" height="14" align="absmiddle">&nbsp;</font><font color="#FF0000">Overwrite </font><font color="#FF0000">:</font><font color="#FF0000" size="-1" face="Verdana, Arial, Helvetica, sans-serif"><a name="overwrite"></a></font></b></font></td>
                    </tr>
                  </table>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><img src="img/overwrite.gif" width="35" height="35" align="left">UploadBean can check for duplicates entries on upload. Then it can overwrite the entry or create a new entry by appending a timestamp to filename extension.<br>
                      <br>
One method is available to enable/disable overwriting and one for renaming option :<br>
</font></p>
                  <ul>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setOverwrite</b>(boolean enable)<br>
                    <font color="#666666"> Default is false, so overwrite is disabled. </font></font></li>
                    <li><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">public void <b>setOverwritepolicy</b>(String policy)<br>
                        <font color="#666666"> When overwrite is false, UploadBean could append  unix-like timestamp after the file extension (e.g. filename.zip.123456789) with policy=&quot;filenametimestamp&quot; or after the file name (e.g. filename_123456789.zip) with policy=&quot;nametimestamp&quot;. For  others policy</font> <font color="#666666">values it will insert the given parameter, for instance if overwrite policy=&quot;_test123&quot; then renamed file with be filename_test123.zip. </font></font><font size="-1" face="Verdana, Arial, Helvetica, sans-serif"><br>
                                            </font></li>
                  </ul>
                  <p><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">Here is a sample.<br>
</font></p>
                  <table width="100%" border="0" cellspacing="1" cellpadding="1">
                    <tr> 
                      <td bgcolor="#333333"> 
                        <table width="100%" border="0" cellspacing="0" cellpadding="0">
                          <tr> 
                            <td bgcolor="#EEEEEE"><font size="-1" face="Verdana, Arial, Helvetica, sans-serif">&lt;jsp:useBean id=&quot;upBean&quot; scope=&quot;session&quot; class=&quot;javazoom.upload.UploadBean&quot;&gt;<br>