Birt支持自定義導出中文名稱

BIRT 是以 Java 和 JavaEE 為基礎為 Web 應用程序開發的基于 Eclipse 的開源報表系統，雖然支持文件導出功能，但不支持導出時動態自定義文件名稱，尤其不支持中文。

Birt默認提供了兩種導出文件時自定義名稱的方法，如下：

• DefaultFilenameGenerator：報表文件名稱.后綴名
• TimestampFilenameGenerator：報表文件名稱+yyyyMMdd-HHmmss.后綴名

Birt若實現自定義導出文件名稱，需要實現org.eclipse.birt.report.utility.filename包下的IFilenameGenerator接口，具體操作如下：

1. 自定義實現IFilenameGenerator 接口

public class CustomExportGenerator implements IFilenameGenerator {
    @Override
    public String getFilename( String baseName, String fileExtension, String outputType, Map options) {
        return baseName  + "." + fileExtension;
    }
}

從上面的代碼看出，IFilenameGenerator 中的方法默認沒有提供自定義文件名稱，這時候只能夠從Map options參數中獲取，當然如果不嫌麻煩的話，也可以重寫getFilename接口。

Object obj = options.get("httpRequest");
    if(obj !=null && obj instanceof RequestFacade){
        RequestFacade request = (RequestFacade)obj;
        exportName = ParameterAccessor.getParameter(request,"__filename");
    }

2. 配置Birt的導出文件生成類

修改web.xml

<context-param>
        <param-name>BIRT_FILENAME_GENERATOR_CLASS</param-name>
        <param-value>org.eclipse.birt.report.utility.filename.CustomExportGenerator</param-value>
    </context-param>

3. 支持中文

文件名稱：org.eclipse.birt.report.presentation.aggregation.layout.FramesetFragment
方法： doPreService( HttpServletRequest request, HttpServletResponse response )
操作：

String filename = ParameterAccessor.getExportFilename( new BirtContext( request, response ), format, emitterId );
        String displayName = URLEncoder.encode(filename,"utf-8");
        displayName = displayName .replace("+","%20");
        response.setCharacterEncoding("utf-8");
        response.setHeader("contentType", "text/html; charset=utf-8");
        response.setHeader( "Content-Disposition", //$NON-NLS-1$
                ParameterAccessor.htmlEncode( openType )
                        + "; filename=\"" 
                        + ParameterAccessor.htmlEncode(displayName )
                        + "\"" ); 

4. 修改Tomcat的編碼

<Connector URIEncoding="UTF-8" connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

5. 訪問方式：
   frameset?report=test.rptdesign&format=docx&__filename=測試