Skip to content

Home

Jump to bottom
cFrost edited this page Mar 3, 2018 · 32 revisions

简介

欧拉框架是一个面向快速建站需求的Java WEB框架，提供丰富的视图渲染支持、ajax支持、统一的异常处理、用户权限控制等功能。使用此框架，开发者可快速构建健壮的WEB站点。

快速开始

<dependency>
    <groupId>net.eulerframework</groupId>
    <artifactId>euler-web-core</artifactId>
    <version>1.0.0-SNAPSHOT</version>
</dependency>

核心说明

基础页面

/
|--signup 注册
|--signup?t=basic 带有基本用户信息的注册页
|--signin 登录
|--signout 注销
|--reset-password 重置密码
|--settings 设置相关
| |--account 账号相关
| | |--change-password 修改密码
|--error-{errorCode} 错误页面
|
|--h/* 前端页面访问, 会按站点语言设置跳转至相应页面, 例如当为简体中文时跳转到pages/zh-cn/*
|
|--pages/zh-cn/* 前端页面目录, 此处的zh-cn为语言代码, 如zh-cn, en-us等
|
|--admin/* 后台管理

AJAX

使用说明

身份验证

Ajax请求通过携带session id进行身份认证，所以使用前必须先登录网站

跨域访问

Ajax请求支持跨域，但需要指定withCredentials = true

未登录或session无效

{
    "cmd": "REDIRECT",
    "location": "http://example.com/signin"
}
字段名 字段说明
cmd 响应指令, 此处固定为REDIRECT, 即页面重定向
location 重定向目标地址, 此处固定为站点登录页面

HTTP Status为401, 对于这种情况, 前端可选择跳转到登录页面, 也可不跳转, 通过其他方式引导用户重新登录

系统可用AJAX列表

API

使用说明

身份验证

未完成

异常响应

{
    "error": "invalid_username_or_password",
    "error_code": 9847213,
    "error_description": "用户名或密码错误"
}
字段名 字段说明
error 错误信息
error_code 错误代码
error_description 友好错误信息, 已国际化

HTTP Status会根据实际情况生成, 如请求参数格式错误为400, 未知的服务器内部异常为500

系统可用API列表

暂无

CMF

CMF是一个附加模块，具有基本的内容管理功能

Maven

<dependency>
    <groupId>net.eulerframework</groupId>
    <artifactId>euler-web-cmf</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

APIs

Clone this wiki locally