# finder-web

**Repository Path**: dwc/finder-web

## Basic Information

- **Project Name**: finder-web
- **Description**: web的文件管理器，浏览、上传文件；web的日志文件浏览，支持任意大小的日志文件，支持直接定位日志文件的任意位置。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2016-10-09
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

概述 Overview
==================

Finder是一个web方式的文件管理器。Finder最主要的功能是超大日志文件的实时查看。

* 类似window的资源管理器方式对文件进行操作。
* 文本文件在线浏览。
* 图片文件在线浏览。
* 音频文件和视频文件直接播放。
* web方式的log文件查看，支持任意大小的文本文件，支持类似于linux系统的tail和less方式查看，并支持任意定位文件位置，无论文件大小，查看体验都近似于本地文件。

运行截图
=================
请到项目附件中查看： [http://git.oschina.net/xuesong123/finder-web/attach_files](http://git.oschina.net/xuesong123/finder-web/attach_files "http://git.oschina.net/xuesong123/finder-web/attach_files")

编译运行
=================

1. 代码导入到eclipse并编译。
2. 修改src/main/resource/META-INF/conf/workspace.xml，指定可管理的目录。
3. 修改logback.xml，如果不修改，windows系统下请确保tomcat所在的磁盘存在 /opt/resin/log 目录。
4. 将webapp目录中的文件拷贝到tomcat的webapps/ROOT目录 或者 直接配置tomcat的server.xml，配置一个context指到webapp目录。
5. 启动应用之后访问： http://localhost/finder/index.html
6. 测试日志功能请找一个较大的日志文件进行测试，太小的日志文件显示不出来效果。


自定义插件
=================
finder允许你自定义自己的插件，finder会根据不同的文件扩展名调用不同的插件打开文件。
插件编写请看考 webapp/resource/finder/plugins.js 和 webapp/resource/finder/plugins/media/media.js

其他系统集成
=================
finder本身不提供任何的权限控制, 所以对于权限敏感的系统，可以通过添加filter的方式，过滤所有/finder/*的请求，并做权限校验。
出于安全考虑，finder对任何文件的访问都需要该文件位于workspace.xml中配置的目录内。

1. 第一种方法，也是推荐的做法，参考web.xml将相关过滤器在你的应用中注册即可。
2. 第二种方法，引入finder-web.jar，根据你的应用所使用的框架自己调用FinderServlet和LessServlet的相关方法，具体代码可参考FinderAction和LessAction。

其他说明
=================
日志监控功能基于拉模式实现，拉模式有优点也有缺点，优点是不受服务器超时限制，推模式一般会使用http长连接，一般服务器或者反向代理服务器都有超时设置，推模式容易导致超时，拉模式没有这个限制，因为每次请求时间都很短。
第二，拉模式在低版本的浏览器或者服务器上也可以很好工作。缺点是需要频繁拉取数据。为了尽可能通用，所以采用了拉模式实现。

BUG反馈
这个东西是我平时常用的一个小工具，我自己发现的bug都会及时修改并提交。使用过程中发现的bug也请反馈给我，我会及时修改。另外发现bug也请及时下载新版本。