```
public interface FileRetriever
```
FileRetriever接口用于实现文件检索器。

方法概要

所有方法实例方法抽象方法
修饰符和类型	方法	说明
`void`	`finish()`	用于结束文件检索器的运行或者清除文件检索器的运行状态。
`void`	`initialize()`	用于初始化文件检索器。
`File`	`retrieve(ThreadContext tc, Connection conn, java.lang.String urlPath)`	检索虚拟文件并且返回检索得到的虚拟文件。
`java.lang.String`	`update(java.lang.String str)`	update()实例方法用于更新文件检索器的内部状态。

- 方法详细资料
  - initialize
```
void initialize()
         throws java.lang.Throwable
```
    用于初始化文件检索器。当qhs创建文件检索器时就调用本方法。
    
    抛出:
    
    java.lang.Throwable
  - retrieve
```
File retrieve(ThreadContext tc,
              Connection conn,
              java.lang.String urlPath)
       throws java.lang.Throwable
```
    检索虚拟文件并且返回检索得到的虚拟文件。
    
    参数:
    
    tc - 线程上下文。
    
    conn - 正在检索虚拟文件的http连接。
    
    urlPath - 用于尝试定位虚拟文件的URL路径。
    
    返回:
    
    非null值表示找到了虚拟文件。null值表示未找到虚拟文件。
    
    抛出:
    
    java.lang.Throwable
  - update
```
java.lang.String update(java.lang.String str)
                 throws java.lang.Throwable
```
    update()实例方法用于更新文件检索器的内部状态。用户代码通过调用定义在sysThreadSpecificObjectPool 系统对象上的updateFileRetriever()方法来更新文件检索器的内部状态，updateFileRetriever()方法直接调用此处说明的update()方法。
    
    参数:
    
    str - 任意字符串。
    
    返回:
    
    返回值可任意。本方法的返回值通过sysThreadSpecificObjectPool.updateFileRetriever()传递给用户代码。
    
    抛出:
    
    java.lang.Throwable
  - finish
```
void finish()
     throws java.lang.Throwable
```
    用于结束文件检索器的运行或者清除文件检索器的运行状态。当qhs终止运行或者qhs创建一个新的文件检索器， qhs就调用本方法。
    
    抛出:
    
    java.lang.Throwable

接口 FileRetriever

方法概要

方法详细资料

initialize

retrieve

update

finish