https://github.com/zycgit/hasor-website

Hasor 主页站点
https://github.com/zycgit/hasor-website

Last synced: 15 days ago
JSON representation

Hasor 主页站点

• Host: GitHub
• URL: https://github.com/zycgit/hasor-website
• Owner: zycgit
• License: apache-2.0
• Created: 2016-08-22T06:13:23.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-10-10T11:23:19.000Z (about 6 years ago)
• Last Synced: 2023-10-20T07:34:51.893Z (about 1 year ago)
• Language: Java
• Homepage: http://www.hasor.net
• Size: 10.4 MB
• Stars: 3
• Watchers: 2
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: readme.txt
  • License: LICENSE

Awesome Lists containing this project

README

        
Hasor首页项目

== 打包构建

    1. website 项目通过 mvn pacakge 产出 war 包。

    2. 无论是线上、预发、日常、开发机。都使用该 war包,无需替换 war 包中任何配置文件。

    3. 一般情况下本地开发测试，通过连接日常开发数据库进行。

    4. 无论连接的是线上数据还是开发库，都通过 docker进行构建。

        docker脚本位于：/conf/work_home

== 环境配置

    1. 本地开发：配置位于 “website-web” 项目中 “env.config” 配置文件中。

    2. 开发环境：位于 /conf/work_home/daily。

    3. 线上环境：位于 /conf/work_home/online。

    4. 使用 openjdk 1.8

== 工程关系

           website-domain       // 模型定义

             ^      ^

             | website-client   // RPC服务接口

             |      ^

           website-core         // 服务类和业务逻辑

             ^  ^   ^

             |  | website-login // OAuth

             |  |   ^

             | website-web      // 处理Web请求和响应

       website-test             // 各类单元测试

== 项目配置

    1. 所有项目中都使用 static-conifg.xml 方式声明模块自身的配置信息。

    2. 主配置文件统一汇聚到 website-web 项目中的 hasor-config.xml。

== 外部依赖

    -- 主要

        net.hasor:hasor-core:jar:3.0.3              基础开发框架

        net.hasor:hasor-rsf:jar:1.2.0               分布式RPC

        org.freemarker:freemarker:jar:2.3.22        渲染引擎

        org.mybatis:mybatis:jar:3.3.0               ORM框架

        org.pegdown:pegdown:jar:1.6.0               Markdown解析

    -- 工具

        c3p0:c3p0:jar:0.9.1.2                       数据库连接池

        com.alibaba:fastjson:jar:1.2.23             JSON序列化

        com.google.guava:guava:jar:21.0             Cache

        org.slf4j:slf4j-api:jar:1.7.21              日志框架

        ch.qos.logback:logback-classic:jar:1.1.3

        junit:junit:jar:4.12                        测试框架

== 线上环境

    1. 地址 : htp://www.hasor.net

    2. conf/tomcat                 为 tomcat 的真实配置。

    3. /conf/work_home/online      为 线上的 WORK_HOME。

    4. 线上运行在 docker 里, Dockerfile 在工程根目录中。

== 发布注意

    1. 分布式部署下，如果模型和逻辑都有变更，请分两次发布，先发模型后发逻辑。

# 代码说明

    01.web启动入口类是：net.hasor.website.web.core.StartModule，定义它的配置文件是：hasor-config.xml

    02.test单元测试的启动入口是：net.hasor.website.core.RootModule

    03.JumpFilter负责处理访问例如：http://xxx.xxx/ 这种目录资源时跳转到对应的 http://xxx.xxx/index.htm

    04.FreemarkerRender 为模板渲染器，负责处理 htm or html 的渲染请求。

    05.文件上传之后是直接保存到“阿里云OSS”不会落盘，文件的访问是通过 CDN 代理 OSS。

    06.负责处理文件上传的类是：UploadToTemp、阿里云OSS初始化代码位于：AliyunModule。

    07.权限功能：目前用户权限功能是保存到：用户表的扩展信息字段中，该字段是json结构。如要加权限请参考片段：

        "userTags":{"newProject":true,"admin":true}

    08.用户登录之后会产生一个快速登录连接，登录过程中通过这个快速登录连接完成用户登录。链接最大有效时间为 1分钟，超时之后必须重新登录。

    09.用户会话信息保存在 Session 中。

    10.目前仅支持 OAuth 登录，已经接入第三方认证有：微博、QQ、Github

    11.可以通过登录（微博、QQ、Github）三个任意一种之后，在个人中心里通过绑定完成混合认证登录。

    12.目前不支持解绑功能。

    13.client工程中保留了三个远程服务接口，消费者可以通过 RSF 或 Hprose 执行远程方法调用。

        端口号是：RSF：2161、Hprose：2162。单元测试模式下远程服务提供者地址为：127.0.0.1位于：env.config配置文件。

    14.RPC 没有连接到任何注册中心，因此不支持服务自动发现。

    15.数据库连接 “env.config” 中已经保留日常开发测试数据库信息，线上数据库的信息通过docker部署时环境变量参数形式传入。

        该功能利用的是 Hasor 模版化配置文件机制实现。

    16.为了保证安全，开发环境没有配置 OAuth 的密钥，因此本地开发中您不可以使用 OAuth 进行登录。

== Bug或缺陷

    1. http://www.hasor.net/my/newVersion.htm?projectID=1  lastVersion 排序错误  0.0.9 居然大于 0.0.10

    2. 各类表单填写验证，必填项目检测。

    3. 版本详情页在登录之后跳转丢失 projectID 参数。

=== Nginx

    1. 安装 BCRE [Mac: brew install pcre]

    2. 站点通过 nginx 代理提供

=== 保留路径

    1. /docs/  -> Nginx 反向代理： http://project.hasor.net/docs

图标库

	https://fontawesome.com/icons?d=gallery

hugo

	https://gohugo.io/commands/hugo_gen/