7.BDF2-UPLOADER

BDF2-UPLOADER模块的依赖
<dependency>
 <groupId>com.bstek.bdf2</groupId>
 <artifactId>bdf2-uploader</artifactId>
 <version>2.0.0</version>
</dependency>

注意
实际上，BDF2-JASPERREPORTS模块就依赖BDF2-UPLOADER模块，所以在之前我们介绍BDF2-JASPERREPORTS模块中，在上传jasper格式报表及相关资源，用的就是BDF2-UPLOADER模块提供的上传功能。

IFileProcessor接口源码
package com.bstek.bdf2.uploader.processor;
import java.io.InputStream;
import com.bstek.bdf2.uploader.model.UploadDefinition;
/**
 * @author Jacky.gao
 * @since 2013-5-1
 */
public interface IFileProcessor {
 /**
 * 保存上传的文件
 * @param uploadDefinition 可以从这个对象中取到上传文件的ID、名称、大小等信息
 * @param inputStream 上传文件的流对象
 */
 void saveFile(UploadDefinition uploadDefinition,InputStream inputStream);
 /**
 * 根据给出的文件上传对象，返回对应的文件流
 * @param uploadDefinition 文件上传对象
 * @return 要取回的文件流
 */
 InputStream loadFile(UploadDefinition uploadDefinition);
 /**
 * 根据文件上传对象，删除对应的文件
 * @param uploadDefinition 文件上传对象
 */
 void deleteFile(UploadDefinition uploadDefinition);
 /**
 * @return 返回当前处理器的ID
 */
 String key();
 /**
 * @return 是否禁用当前处理器
 */
 boolean isDisabled();
}

Database文件上传处理器
package com.bstek.bdf2.uploader.processor.impl;
import java.io.InputStream;
import com.bstek.bdf2.uploader.model.UploadDefinition;
import com.bstek.bdf2.uploader.processor.IFileProcessor;
import com.bstek.bdf2.uploader.service.ILobStoreService;
/**
 * @author Jacky.gao
 * @since 2013-5-20
 */
public class DatabaseFileProcessor implements IFileProcessor {
 private boolean disabled;
 private ILobStoreService lobStoreService;
 public void saveFile(UploadDefinition uploadDefinition,InputStream inputStream) {
 try {
 lobStoreService.storeBinaryStream(inputStream, inputStream.available(),uploadDefinition.getId());
 } catch (Exception e) {
 throw new RuntimeException(e);
 }
 }
 public InputStream loadFile(UploadDefinition uploadDefinition) {
 try {
 return lobStoreService.getBinaryStream(uploadDefinition.getId());
 } catch (Exception e) {
 throw new RuntimeException(e);
 }
 }
 public void deleteFile(UploadDefinition uploadDefinition) {
 try {
 lobStoreService.deleteBinaryStream(uploadDefinition.getId());
 } catch (Exception e) {
 throw new RuntimeException(e);
 }
 }
 public String key() {
 return "Database";
 }
 public boolean isDisabled() {
 return disabled;
 }
 ......
}

<contextPath>/dorado/bdf2/uploader/process.download?id=<通过RichUploader上传文件成功后拿到的文件的id>

<contextPath>/dorado/bdf2/uploader/process.display?id=<通过RichUploader上传文件成功后拿到的文件的id>

IFileService源码
package com.bstek.bdf2.uploader.service;
import java.io.InputStream;
import com.bstek.bdf2.uploader.model.UploadDefinition;
/**
 * @author Jacky.gao
 * @since 2013-5-12
 */
public interface IFileService {
 public static final String BEAN_ID="bdf2.uploader.fileService";
 UploadDefinition getUploadDefinition(String id);
 InputStream getFile(UploadDefinition definition);
 InputStream getFile(String id);
 void deleteUploadDefinition(String id);
}

ILobStoreService接口源码
package com.bstek.bdf2.uploader.service;
import java.io.InputStream;
import java.io.Reader;
import java.sql.SQLException;
/**
 * 大对象仓库服务接口，对外提供二进制数据，超长文本等的储存、更新、取出等操作。
 * <p>
 * 这里的操作分为两组:<br/>
 * <ol>
 *
<li>byte及binaryStream相关的为第一组，代表了对二进制数据，如图片、声音、视频等的操作，在数据库中通常以B
LOB或IMAGE类型表示</li>
 *
<li>string、asciiString及characterStream相关的为第二组，代表了对大文本对象，如文本文件、新闻公告等的操作
，
 * 在数据库中通常以CLOB或TEXT类型表示</li>
 * </ol>
 * 需要注意的是，不管为哪种类型的大对象，仓库中均不允许其内容为空，
若业务数据允许引用一个空对象，请将业务表中的允许为空的记录的相关字段设置为NULL。<br/>
 * 对于不再需要的大对象，请及时使用delete*函数清理，以免造成空间的浪费。<br/>
 * 此接口中的所有函数均不能保证一定能完成指定的操作，请在使用时处理抛出的异常<br/>
 * </p>
 * @author jacky.gao@bstek.com
 * @since 2.0
 */
public interface ILobStoreService {
 /**
 * 保存一个byte数组，并返回它在仓库中的主键。
 * 
 * @param content
 * 需要保存的内容，不能为空
 * @return 保存后的内容在仓库中的主键，稍后可通过{@link #getBytes(String)}取得仓库中的内容
 * @throws SQLException
 * 将byte数组保存到数据库时可能抛出此异常
 */
 String storeBytes(byte[] content) throws SQLException;
 /**
 * 保存一个byte数组，并返回它在仓库中的主键。
 * @param content 需要保存的内容，不能为空
 * @param id 需要保存的内容的ID
 * @throws SQLException
 * 将byte数组保存到数据库时可能抛出此异常
 */
 void storeBytes(byte[] content,String id) throws SQLException;
 /**
 * 根据内容在仓库中的主键，删除对应的记录。
 * 
 * @param id
 * 需要删除的内容在仓库中的主键
 * @throws SQLException
 * 在从数据库中删除数据时可能抛出此异常；
此外，如果删除不成功，如与主键对应的记录不存在，也抛出此异常。
 */
 void deleteBytes(String id) throws SQLException;
 /**
 * 更新主键所指的内容。
 * <p>
 * 保证此内容的名称<font color="red">不</font>变。
 * </p>
 * 
 * @param id
 * 需要被更新的内容的主键
 * @param content
 * 新的值
 * @throws SQLException
 * 
在更新数据库的过程中可能抛出此异常；此外，如果更新不成功，如与主键对应的记录不存在，也抛出此异常。
 */
 void updateBytes(String id, byte[] content) throws SQLException;
 /**
 * 根据主键查询内容，若未找到，返回<code>null</code>。
 * 
 * @param id
 * 内容的主键，通常由业务记录中的某一字段保有
 * @return 与主键相对应的内容
 * @throws SQLException
 * 在查询数据库的过程中可能抛出此异常。
 */
 byte[] getBytes(String id) throws SQLException;
 /**
 * 保存一个二进制数据流中的数据，并返回其在仓库中的主键。
 * 
 * @param inputStream
 * 需要保存的内容，不能为空
 * @param contentLength
 * 内容的长度。如若保存一个{@link java.io.File}对象，则通常此长度由
 * {@link java.io.File#length}取得
 * @return 保存后的内容在仓库中的主键，稍后可通过{@link #getBinaryStream(String)}取得仓库中的内容
 * @throws SQLException
 */
 String storeBinaryStream(InputStream inputStream, int contentLength) throws SQLException;
 /**
 * 保存一个二进制数据流中的数据，并返回其在仓库中的主键。
 * 
 * @param inputStream
 * 需要保存的内容，不能为空
 * @param contentLength
 * 内容的长度。如若保存一个{@link java.io.File}对象，则通常此长度由
 * {@link java.io.File#length}取得
 * @param id
 * 需要保存的内容ID
 * @throws SQLException
 */
 void storeBinaryStream(InputStream inputStream, int contentLength,String id) throws SQLException;
 /**
 * 根据内容在仓库中的主键，删除对应的记录。
 * 
 * @param id
 * 需要被删除的内容的主键
 * @throws SQLException
 * 
在删除数据库中的记录时可能抛出此异常；此外，如果删除不成功，如与主键对应的记录不存在，也抛出此异常。
 */
 void deleteBinaryStream(String id) throws SQLException;
 /**
 * 更新指定主键代表的内容。
 * <p>
 * 保证此内容的名称<font color="red">不</font>变。
 * </p>
 * 
 * @param id
 * 需要被更新的内容的主键
 * @param inputStream
 * 用于更新内容的二进制输入流
 * @param contentLength
 * 二进制输入流的长度
 * @throws SQLException
 * 
在更新数据库中的记录时可能抛出此异常；此外，如果更新不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void updateBinaryStream(String id, InputStream inputStream,
 int contentLength) throws SQLException;
 /**
 * 根据主键取得内容的二进制输入流，若未找到，返回<code>null</code>。
 * 
 * @param id
 * 需要查询的内容的主键
 * @return 代表内容的二进制输入流
 * @throws SQLException
 * 在查询数据库的过程中可能抛出此异常
 */
 InputStream getBinaryStream(String id) throws SQLException;
 /**
 * 保存一个超长的字符串，并返回其在仓库中的主键。
 * 
 * @param content
 * 需要保存的内容。
 * @return 保存后的内容在仓库中的主键，稍后可通过{@link #getString(String)}取得仓库中的内容
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 String storeString(String content) throws SQLException;
 /**
 * 保存一个超长的字符串，并返回其在仓库中的主键。
 * 
 * @param content 需要保存的内容。
 * @param id 需要保存的内容ID。
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 void storeString(String content,String id) throws SQLException;
 /**
 * 根据内容在仓库中的主键删除对应的记录。
 * 
 * @param id
 * 需要删除的内容在仓库中的主键
 * @throws SQLException
 * 
在从数据库中删除记录时可能抛出此异常；此外，如果删除不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void deleteString(String id) throws SQLException;
 /**
 * 更新指定的主键代表的内容。
 * 
 * @param id
 * 需要更新的内容的主键
 * @param content
 * 用于更新的值
 * @throws SQLException
 * 
在更新数据库中的记录时可能抛出此异常；此外，如果更新不成功，如与主键对应的记录不存在，也抛出此异常。
 */
 void updateString(String id, String content) throws SQLException;
 /**
 * 根据主键查询其在仓库中的内容，若未找到，返回<code>null</code>。
 * 
 * @param id
 * 需要查询的内容的主键
 * @return 代表查询内容的字符串
 * @throws SQLException
 * 在查询数据库的过程中可能抛出此异常
 */
 String getString(String id) throws SQLException;
 /**
 * 保存一个字节流，并返回其在仓库中的主键。
 * 
 * @param asciiSrteam
 * 需要保存到仓库中的字节流。
 * @param contentLength
 * 字节流的长度。
 * @return 保存后的内容在仓库中的主键，稍后可通过{@link #getAsciiStream(String)}取得仓库中的内容
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 String storeAsciiStream(InputStream asciiSrteam, int contentLength)
 throws SQLException;
 /**
 * 保存一个字节流，并返回其在仓库中的主键。
 * 
 * @param asciiSrteam
 * 需要保存到仓库中的字节流。
 * @param contentLength
 * 字节流的长度。
 * @param id 保存的ID
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 void storeAsciiStream(InputStream asciiSrteam, int contentLength,String id)
 throws SQLException;
 /**
 * 根据内容在仓库中的主键删除对应的记录。
 * 
 * @param id
 * 需要删除的内容在仓库中的主键
 * @throws SQLException
 * 
在从数据库中删除记录时可能抛出此异常；此外，如果删除不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void deleteAsciiStream(String id) throws SQLException;
 /**
 * 更新指定的主键代表的内容。
 * 
 * @param id
 * 需要更新的内容的主键
 * @param asciiStream
 * 用于更新的字节流
 * @param contentLength
 * 字节流的长度
 * @throws SQLException
 * 
在更新数据库中的记录时可能抛出此异常；此外，如果更新不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void updateAsciiStream(String id, InputStream asciiStream,
115
 int contentLength) throws SQLException;
 /**
 * 根据主键查询其在仓库中的内容，若未找到，返回<code>null</code>。
 * 
 * @param id
 * 需要查询的内容的主键
 * @return 代表内容的字节流
 * @throws SQLException
 * 在查询数据库的过程中可能抛出此异常
 */
 InputStream getAsciiStream(String id) throws SQLException;
 /**
 * 保存一个字符流，并返回其在仓库中的主键。
 * 
 * @param reader
 * 需要保存的字符流
 * @param contentLength
 * 字符流的长度
 * @return 保存后的内容在仓库中的主键，稍后可通过{@link #getCharacterStream(String)}取得仓库中的内容
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 String storeCharacterStream(Reader reader, int contentLength)
 throws SQLException;
 /**
 * 保存一个字符流，并返回其在仓库中的主键。
 * 
 * @param reader
 * 需要保存的字符流
 * @param contentLength
 * 字符流的长度
 * @param reader
 * 需要保存的字符流ID
 * @throws SQLException
 * 在将内容保存到数据库的过程中可能抛出此异常。
 */
 void storeCharacterStream(Reader reader, int contentLength,String id)
 throws SQLException;
 /**
 * 根据内容在仓库中的主键删除对应的记录。
 * 
 * @param id
 * 需要删除的内容在仓库中的主键
 * @throws SQLException
 * 
在从数据库中删除记录时可能抛出此异常；此外，如果删除不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void deleteCharacterStream(String id) throws SQLException;
 /**
 * 更新指定的主键代表的内容。
 * 
 * @param id
 * 需要更新的内容的主键
 * @param reader
 * 用于更新的字符流
 * @param contentLength
 * 字符流的长度
 * @throws SQLException
 * 
在更新数据库中的记录时可能抛出此异常；此外，如果更新不成功，如与主键对应的记录不存在，也抛出此异常。;
 */
 void updateCharacterStream(String id, Reader reader,
 int contentLength) throws SQLException;
 /**
 * 根据主键查询其在仓库中的内容，若未找到，返回<code>null</code>。
 * 
 * @param id
 * 需要查询的内容的主键
 * @return 代表内容的字符流
 * @throws SQLException
 * 在查询数据库的过程中可能抛出此异常
 */
 Reader getCharacterStream(String id) throws SQLException;
 /**
 * 服务ID，代表了其在spring中的beanName。
 */
 public static final String BEAN_ID = "bdf2.lobStoreService";
}