1 Star 0 Fork 93

如果爱请珍惜 / Durian

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

Durian


English | 简体中文

Documentation Status License

介绍

榴莲校园,一个专注于Java技术的实践集合,致力于为校园提供一套便捷的技术服务平台。

想法起于这段时间接手的几个校内应用,例如题库,信息发布,校内社交这类的应用。这些应用无一都需要管理一些基本的信息,例如会员,专业,课程等。又或者都需要一些常用的功能,例如评论,全文检索,后台管理等。慢慢发现,其实开发一个简单,低并发的校内应用,特别是在学习时,这些通用的功能其实占据了开发任务的很大一部分,十分冗余,让人很难专注于这个应用本身的业务。

因此我想到了做一个轻量级的校内应用平台,为在这个平台上开发的应用提供一些基本的服务,如搜索引擎服务,校内信息中心,评论系统等,化繁为简,提高你的开发效率,使您专注于业务逻辑的开发。

平台的雏形已基本搭建,为演示效果,我使用一个题库小应用(榴莲题库)作为在此平台上开发的demo。

本项目的后台管理模块是基于我的另一个开源项目Sky,除后台管理模块使用Thymeleaf渲染以外,其他模块皆为restful风格的api,使用微信小程序做的前后端分离。为了专注与业务逻辑,对于持久层的代码,我专为项目设计了与之适应的代码生成器Orange,支持关联结构(非外键)的代码生成,使您的二次开发更加快速。

详细信息,请参考项目开发文档:Durian开发文档

后台演示地址:https://duriantiku.top

搜索演示: 搜索题目

文档地址: Durian开发文档

Gitee地址:https://gitee.com/qiu-qian/Durian

GitHub地址:https://github.com/qiu-qian/Durian

榴莲题库小程序仓库地址:https://gitee.com/qiu-qian/durian-mini

(个人精力有限,暂时只提供了题库模块的后台接口,还未实现全部的小程序页面,欢迎爱好前端,爱好开源的小伙伴来协助我完成这个demo)

特别声明:本项目可用于学习或毕设,(如需商用,请联系我) ! ! !

预览

后台预览

小程序预览

快速部署

在部署前,请确保你已经搭建好了部署环境 Durain部署环境

如果您对ES还不太熟悉,请参考我的实践笔记 ES6.8.11实践笔记

目前项目共有三个服务一个应用,如果你的计算机配置允许,可同时全部部署(大概4G内存占用)顺序为

  • sky-center 校内信息中心,提供课程,专业,学生信息等服务
  • sky-es 搜索引擎服务,为应用提供全文检索服务
  • sky-system 后台管理,管理应用信息
  • sky-tiku 榴莲题库应用

注:每个模块都提供了三个环境配置,本地,测试,生产。并提供了一键运行的脚本,以下使用测试环境(该环境下使用本地的Linux虚拟机部署)来做演示,其他环境请自行参考

sky-center

配置sky-center/sky-center-api/src/main/resources/application-test.yml

 # 此处修改为你自己的数据源
 druid:
      url: jdbc:mysql://127.0.0.1:3306/sky-center
      username: root
      password: 123456

  # 此处修改为你自己的数据源
  redis:
    database: 0
    host: 127.0.0.1
    port: 6379

进入 sky-center 目录下,在Linux中运行以下脚本

chomd +x run-test.sh
./run-test.sh

默认后台运行,不占用主线程,浏览根目录(/root)下的 log-center.log文件即可查看运行日志。

sky-es

配置sky-es/sky-es-api/src/main/resources/application-test.yml

druid:
      # 此处修改为你自己的数据源
      # 信息中心数据源
      center:
        # 从数据源开关
        enabled: true
        url: jdbc:mysql://192.168.111.152:3306/sky-center
        username: root
        password: 123456
      # 题库模块数据源
      tiku:
        # 从数据源开关
        enabled: true
        url: jdbc:mysql://192.168.111.154:3306/sky-tiku
        username: root
        password: 123456

# 配置Elasticsearch (配置你之前部署的ES地址)
elasticsearch:
  hostName: 192.168.111.151
  port: 9200

进入 sky-es 目录下,在Linux中运行以下脚本

chomd +x run-test.sh
./run-test.sh

浏览根目录下的 log-es.log文件即可查看运行日志。

sky-system

配置 sky-system/sky-system-api/src/main/resources/application-test.yml

    druid:
      # 此处修改为你自己的数据源
      # 后台管理数据源
      system:
        url: jdbc:mysql://192.168.111.153:3306/sky-system
        username: root
        password: 123456
      # 信息中心数据源
      center:
        # 从数据源开关/默认关闭
        enabled: true
        url: jdbc:mysql://192.168.111.152:3306/sky-center
        username: root
        password: 123456
      # 题库模块数据源
      tiku:
        # 从数据源开关/默认关闭
        enabled: true
        url: jdbc:mysql://192.168.111.154:3306/sky-tiku
        username: root
        password: 123456

# 当前服务部署地址:用来为其他服务提供访问地址(修改为你上面部署的地址)
innerService:
  #信息中心
  center:
    url: 192.168.111.152:8087
  #搜索引擎中心
  es:
    url: 192.168.111.151:8088

进入 sky-system 目录下,在Linux中运行以下脚本

chomd +x run-test.sh
./run-test.sh

浏览根目录下的 log-system.log文件即可查看运行日志。 访问 ip:8085端口即可进入后台管理界面

sky-tiku

配置 sky-tiku/sky-tiku-api/src/main/resources/application-test.yml

    #修改为你自己的数据源
    druid:
      url: jdbc:mysql://127.0.0.1:3306/sky-tiku
      username: root
      password: 123456

# 当前服务部署地址:用来为其他服务提供访问地址(修改为你上面部署的地址)
innerService:
  #信息中心
  center:
    url: 192.168.111.152:8087
  #搜索引擎中心
  es:
    url: 192.168.111.151:8088

进入 sky-tiku目录下,在Linux中运行以下脚本

chomd +x run-test.sh
./run-test.sh

浏览根目录下的 log-tiku.log文件即可查看运行日志。

至此,题库模块的部署已经基本完成,小程序的部署请参考 Durian小程序的部署文档

项目结构

项目采用模块化的设计,遵循低耦合高内聚的设计思想,各个模块可单独部署,一个独立的项目模块(以信息中心模块举例)是由如下三个(或四个)子模块组成:

sky-center-module 持久层和Service接口,此处代码可完全由生成器生成
sky-center-framework 相关框架,例如spring,mybatis等配置
sky-center-api 对外提供api服务
sky-center-inner 对内提供服务模块

(由于基于RPC的微服务通信框架较为庞大,之后再考虑此方案,目前使用RestFul实现服务间同通信)

ES搜索模型

功能概览

捐赠

多多支持多多star!!!

开源不易,演示服务器每个月还要缴费,可以请作者喝一瓶哇哈哈:

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

榴莲校园,一个专注于Java技术的实践集合,致力于为校园提供一套便捷的技术服务平台 展开 收起
Java
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/love1024_022/Durian.git
git@gitee.com:love1024_022/Durian.git
love1024_022
Durian
Durian
master

搜索帮助

14c37bed 8189591 565d56ea 8189591