1 Star 0 Fork 29

youngerboyes / mongodb-file-server

forked from waylau / mongodb-file-server 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

MongoDB File Server(基于 MongoDB 的文件服务器)

MongoDB File Server is a file server system based on MongoDB. MongoDB File Server is committed to the storage of small files, such as pictures in the blog, ordinary documents and so on.

It's using some very popular technology like:

  • MongoDB 3.6.4
  • Spring Boot 2.0.3.RELEASE
  • Spring Data MongoDB 2.0.8.RELEASE
  • Spring 5.0.7.RELEASE
  • Thymeleaf 3.0.9.RELEASE
  • Thymeleaf Layout Dialect 2.2.0
  • Embedded MongoDB 2.0.2
  • Gradle 4.5.1

基于 MongoDB 的文件服务器。MongoDB File Server 致力于小型文件的存储,比如博客中图片、普通文档等。由于MongoDB 支持多种数据格式的存储,对于二进制的存储自然也是不话下,所以可以很方便的用于存储文件。由于 MongoDB 的 BSON 文档对于数据量大小的限制(每个文档不超过16M),所以本文件服务器主要针对的是小型文件的存储。对于大型文件的存储(比如超过16M),MongoDB 官方已经提供了成熟的产品 GridFS,读者朋友可以自行了解。

本文不会对 MongoDB 的概念、基本用法做过多的介绍,有兴趣的朋友可自行查阅其他文献,比如,笔者所著的《分布式系统常用技术及案例分析》一书,对 MongoDB 方面也有所着墨。

Features 特性

  • Easy to use.(易于使用)
  • RESTful API.
  • Chinese characters friendly.(中文友好)
  • ...

APIs

Here are useful APIs.

  • GET /files/{pageIndex}/{pageSize} : Paging query file list.(分页查询文件列表)
  • GET /files/{id} : Download file.(下载某个文件)
  • GET /view/{id} : View file online.(在线预览某个文件。比如,显示图片)
  • POST /upload : Upload file.(上传文件)
  • DELETE /{id} : Delete file.(删除文件)

How to (如何使用)

It's so easy to start up the MongoDB File Server with 2 steps.

只需要两步。

1. Get source(获取源码)

$ git clone https://github.com/waylau/mongodb-file-server.git

2. Run(运行)

$ gradlew bootRun

then, you can visit the application at http://localhost:8081.

Configuration (配置)

The default configuration is (默认配置如下) :

server.address=localhost
server.port=8081

# Thymeleaf 
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.cache=false
spring.thymeleaf.mode=HTML5

# limit upload file size
spring.http.multipart.max-file-size=1024KB
spring.http.multipart.max-request-size=1024KB

spring.http.multipart.max-file-size and spring.http.multipart.max-request-size limit upload file never larger than 1MB.

NOTE: default configuration will use a embedded Mongo, that means data will never persist when the MongoDB File Server restart.

You can set spring.data.mongodb.uri property to configure additional settings such as the replica set.(支持配置独立运行的 MongoDB 的连接方式):

spring.data.mongodb.uri=mongodb://user:secret@mongo1.example.com:12345,mongo2.example.com:23456/test

If you want to use a stanlne MongoDB server, comment out Embedded MongoDB dependencies in build.gradle file.(如果需要使用独立运行的 MongoDB,就把下面的依赖注释掉):

dependencies {
	...
	// compile('de.flapdoodle.embed:de.flapdoodle.embed.mongo')
	...
}

Detail (详细设计说明)

See detail https://waylau.com/mogodb-file-server-with-spring-boot.

Host(托管)

Contact 联系作者

Donate 捐赠

Support me!

感谢您对老卫开源工作的支持!

开源捐赠

捐赠所得所有款项将用于开源事业!

MIT License Copyright (c) 2017 Way Lau Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

MongoDB File Server is a file server system based on MongoDB. 基于 MongoDB 的文件服务器。 展开 收起
Java
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/youngerboyes/mongodb-file-server.git
git@gitee.com:youngerboyes/mongodb-file-server.git
youngerboyes
mongodb-file-server
mongodb-file-server
master

搜索帮助