From be027229ff7f43150e723324bc7e08afe94b497d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=AB=98=E6=9D=B0?= Date: Mon, 9 Oct 2017 12:33:22 +0000 Subject: [PATCH] Updates docs/storage-datasource-config.md Auto commit by GitBook Editor --- docs/images/datasource-tools.png | Bin 0 -> 6657 bytes docs/storage-datasource-config.md | 258 +++++++++++++++++++++++++++++- 2 files changed, 257 insertions(+), 1 deletion(-) create mode 100644 docs/images/datasource-tools.png diff --git a/docs/images/datasource-tools.png b/docs/images/datasource-tools.png new file mode 100644 index 0000000000000000000000000000000000000000..b3b21dd7acf3a8cf5dec4243a84ee50f2e2b7e6b GIT binary patch literal 6657 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 + + /WEB-INF/config.properties + + +``` + +**Note: **The above Bean configuraton is practically a standard configuration of org.springframework.beans.factory.config.PropertyPlaceholderConfigurer class. We know that we can load external properties of Spring by configuring PropertyPlaceholderConfigurer. If the project has been configured with PropertyPlaceholderConfigurer class, the corresponding UReport2 properties can be directly added to the properties file corresponding to the class of the configuration, and it is no need to configure the config.properties file. + +Open the file config.properties and add the attribute named “ureport.fileStoreDir”, while the value of the attribute is applied to define the default file system-based report storage directory provided by UReport2. For example, the attribute can be defined as follows: + +``` +ureport.fileStoreDir=D:/ureportfiles +``` + +It means to save the report files in the directory ureportfiles under the Drive D. It shall be noted that when the specific directory is assigned, we shall save the directory and assure its existence, otherwise it will not be adopted. For an instance, the directory named ureportfiles in Drive D must exist and needs to be created in advance. + +The report storage mechanism known as the “server file system” provided by UReport2 by fault actually realizes the interface of com.bstek.ureport.provider.report.Report Provider provided by UReport2. The source code of the interface is as follows: + +``` +package com.bstek.ureport.provider.report; import java.io.InputStream; +import java.util.List; +/** +* @author Jacky.gao +* @since 2016年12月4日 +* @since Dec. 4 2016 +*/ +public interface ReportProvider { +/** +* 根据报表名加载报表文件 +* Load the report file according to the report name +*@param file 报表名称 +* @param file report name +*@return 返回的InputStream +* @return returned InputStream +*/ +InputStream loadReport(String file); +/** +* 根据报表名，删除指定的报表文件 +* Delete the specific report file according to the report name +* @param file 报表名称 +* @param file report name +*/ +void deleteReport(String file); +/** +* 获取所有的报表文件 +* Acquire all report files +* @return 返回报表文件列表 +* @return return the list of report file +*/ +List getReportFiles(); +/** +* 保存报表文件 +* Save report files +*@param file 报表名称 +* @param file report name +*@param content 报表的XML内容 +* @param content XML content of report +*/ +void saveReport(String file,String content); +/** +* @return 返回存储器名称 +* @return return storage name +*/ +String getName(); +/** +* @return 返回是否禁用 +* @return return if deactivation +*/ +boolean disabled(); +/** +* @return 返回报表文件名前缀 +* @return return prefix of report name +*/ +String getPrefix(); +} +``` + +After realizing the ReportProvider interface, configure the implementation class to Spring and make it a standard Spring Bean. Then UReport2 will detect, find and load it. The source code of the report storage known as the “server file system” provided by UReport2 by default is listed below: + +``` +package com.bstek.ureport.provider.report.file; + +import java.io.File; +import java.io.FileInputStream; +import java.io.FileNotFoundException; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.util.ArrayList; +import java.util.Calendar; +import java.util.Collections; +import java.util.Comparator; +import java.util.List; + +import javax.servlet.ServletContext; + +import org.apache.commons.io.IOUtils; +import org.springframework.beans.BeansException; +import org.springframework.context.ApplicationContext; +import org.springframework.context.ApplicationContextAware; +import org.springframework.web.context.WebApplicationContext; + +import com.bstek.ureport.exception.ReportException; +import com.bstek.ureport.provider.report.ReportFile; +import com.bstek.ureport.provider.report.ReportProvider; + +/** + * @author Jacky.gao + * @since 2017年2月11日 + */ +public class FileReportProvider implements ReportProvider,ApplicationContextAware{ + private String prefix="file:"; + private String fileStoreDir; + private boolean disabled; + @Override + public InputStream loadReport(String file) { + if(file.startsWith(prefix)){ + file=file.substring(prefix.length(),file.length()); + } + String fullPath=fileStoreDir+"/"+file; + try { + return new FileInputStream(fullPath); + } catch (FileNotFoundException e) { + throw new ReportException(e); + } + } + + @Override + public void deleteReport(String file) { + if(file.startsWith(prefix)){ + file=file.substring(prefix.length(),file.length()); + } + String fullPath=fileStoreDir+"/"+file; + File f=new File(fullPath); + if(f.exists()){ + f.delete(); + } + } + + @Override + public List getReportFiles() { + File file=new File(fileStoreDir); + List list=new ArrayList(); + for(File f:file.listFiles()){ + Calendar calendar=Calendar.getInstance(); + calendar.setTimeInMillis(f.lastModified()); + list.add(new ReportFile(f.getName(),calendar.getTime())); + } + Collections.sort(list, new Comparator(){ + @Override + public int compare(ReportFile f1, ReportFile f2) { + return f2.getUpdateDate().compareTo(f1.getUpdateDate()); + } + }); + return list; + } + + @Override + public String getName() { + return "服务器文件系统"; + } + + @Override + public void saveReport(String file,String content) { + if(file.startsWith(prefix)){ + file=file.substring(prefix.length(),file.length()); + } + String fullPath=fileStoreDir+"/"+file; + FileOutputStream outStream=null; + try{ + outStream=new FileOutputStream(new File(fullPath)); + IOUtils.write(content, outStream,"utf-8"); + }catch(Exception ex){ + throw new ReportException(ex); + }finally{ + if(outStream!=null){ + try { + outStream.close(); + } catch (IOException e) { + e.printStackTrace(); + } + } + } + + } + + @Override + public boolean disabled() { + return disabled; + } + + public void setDisabled(boolean disabled) { + this.disabled = disabled; + } + + public void setFileStoreDir(String fileStoreDir) { + this.fileStoreDir = fileStoreDir; + } + + @Override + public void setApplicationContext(ApplicationContext applicationContext) throws BeansException { + File file=new File(fileStoreDir); + if(file.exists()){ + return; + } + if(applicationContext instanceof WebApplicationContext){ + WebApplicationContext context=(WebApplicationContext)applicationContext; + ServletContext servletContext=context.getServletContext(); + String basePath=servletContext.getRealPath("/"); + fileStoreDir=basePath+fileStoreDir; + file=new File(fileStoreDir); + if(!file.exists()){ + file.mkdirs(); + } + } + } + + @Override + public String getPrefix() { + return prefix; + } +} +``` + +Disable the default report storage provided by the system. If we customize the report storage and do not want to use the default report storage of “server file system” provided by the system, we only needs to add an attribute named ureport.disableFileProvider in the config.properties file mentioned above and set its value as true. + +In view of the introduction above, we can easily develop other types of report storages by realizing the ReportProvider interface, such as developing a new report storage to save reports in database and FTP etc. + +# The data source Configuration + +Open the report designer in UReport2. We can see three types of data sources of reports provided by UReport2, as shown in the figure below: + +![](docs/images/datasource-tools.png)![](docs/images/datasource-tools.png)![](docs/images/datasource-tools.png) + + + + + + + + + + + + + + + +![](docs/images/datasource-tools.png)