oss-server 小型對象存儲系統

時間 2019-11-18

標籤 oss server 小型對象存儲系統简体版

原文原文鏈接

oss-server

項目介紹

oss-server是針對項目開發時提供的小型對象存儲系統,開發者在針對文件上傳時業務剝離,同時方便文件遷移，爲知足單個項目，多個系統的狀況下，提供統一的oss服務css

oss-server主要提供功能：html

一、上傳功能前端

二、文件在線管理功能(包括文件的預覽、內部上傳、刪除、改名)java

三、權限管理(上傳api權限用戶維護、oss-server登陸系統維護)jquery

oss-server使用tomcat+nginx的方式，tomcat提供上傳對象存儲的能力，nginx提供在線訪問的能力nginx

oss不提供文件相關日誌存儲功能，是純技術中間件git

server端主要配置(application.properties)以下：github

#素材存儲路徑 -- 以/結尾
material.root=/home/material/ #素材下載路徑根目錄,該目錄是nginx讀取目錄,可使用域名 material.invokingRoot=http://192.168.0.7/

使用以上配置，服務端nginx配置以下：chrome

server{
        listen         80;        server_name 192.168.0.7;        charset utf-8;        location / {           root /home/material/;       }   }

該配置只是簡單配置nginx訪問路徑,server_name能夠是域名.json

管理員預覽

輸入訪問路徑：http://ip:port/

輸入application.properties配置文件中的用戶名密碼:

#驗證用戶名 密碼
oss.security.userName=admin
oss.security.password=adminA123

oss-server提供如下兩種提交方式

base64字符串格式提交

該方式是後端須要將文件轉換成base64字符串,提交給oss-server，該方式oss-server提供了java版的sdk，具體可參看oss-server-sdk-java程序

請求接口：/oss/material/uploadByBinary

接口類型：post

請求類型：application/json;

請求參數：

{
    "project": "",    "files": [       {            "original_name": "test.png",            "file": "文件流base64字符串",            "media_type": "png"       }   ] }

字段說明：

參數	說明
project	項目名稱，oss-server會根據該名稱建立項目目錄,方便後續程序遷移
files	上傳文件數組
original_name	文件原始名稱
file	文件流base64字符串
media_type	文件格式類型

響應json

{
    "code": "8200",    "message": "Success",    "data": [{        "id": "1a4c705d260647cc9be951ead3a449e6",        "url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",        "store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"   }] }

響應參數說明

參數	說明
code	錯誤碼,8200爲成功
message	錯誤信息
data	上傳成功後文件返回信息
id	文件惟一標識
url	文件在線訪問url
store	文件靜態存儲路徑

form表單直接提交

該方式前端可直接經過form提交上傳,後端不須要提供中轉

請求接口：/oss/material/{project}/uploadMaterial

接口類型：post

請求參數：

參數	說明
project	項目名稱，oss-server會根據該名稱建立項目目錄,方便後續程序遷移
module	模塊名稱，可爲空,不少狀況下,咱們但願分模塊來存儲咱們的上傳資源，這個時候，可使用該module字段，例如：`/product/wechat`,此時,oss生成的全路徑是：`{project}/product/wechat/...`
file	上傳文件名稱，能夠是數組多個文件

響應json

{
    "code": "8200",    "message": "Success",    "data": [{        "id": "1a4c705d260647cc9be951ead3a449e6",        "url": "http://192.168.0.7/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg",        "store": "/province_IIII/201805/30/1a4c705d260647cc9be951ead3a449e6.jpg"   }] }

form表單代碼示例以下

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html> <head>    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>    <title>Title</title>    <script src="https://cdn.bootcss.com/jquery/3.2.1/jquery.min.js"></script> </head> <body> <form action="http://192.168.0.7:18000/oss/material/province_III/uploadMaterial" method="post" enctype="multipart/form-data" target="uploadIFrame">    <input type="file" name="file" value="選擇文件"/>    <input type="submit" value="提交"/> </form>  <iframe name="uploadIFrame" style="width: 500px;height: 500px;border: 1px solid gray;"></iframe> </body> </html>

軟件架構

後端框架：SpringBoot 2.0.2.RELEASE

後端模塊：freemarker

前端框架：layer+Bootstrap

安裝教程

一、下載源碼：git clone https://gitee.com/xiaoym/oss-server.git

二、修改application.properties配置文件,主要修改如下oss對外域名路徑已經上傳存儲路徑

#素材存儲路徑 -- 以/結尾 material.root=/home/material/ #素材下載路徑根目錄 material.invokingRoot=http://192.168.0.7/

三、打包：mvn package

四、運行jar包：java -jar oss-server-0.0.1-SNAPSHOT.jar

參與貢獻

Fork 本項目
新建 Feat_xxx 分支
提交代碼
新建 Pull Request

項目地址

若是項目對您有幫助,請前往項目地址給個Star ！！！！

碼雲：https://gitee.com/xiaoym/oss-server

GitHub:https://github.com/xiaoymin/oss-server

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。