Skip to content

jiangtour/JYObjectModule

Repository files navigation

#酱游科技数据模型协议 ##JYObjectModuleBuild StatusVersionLicensePlatform

说明

###文档信息管理 文档管理信息表

组件 描述
主题 酱游科技数据模型接口协议
版本 0.1.0
内容 数据模型定义
关键字 开发、协同、接口,数据字典
参考文档
创建时间 2016/08/22
创建人 酱游科技技术部艾星
最新发布日期 2016/08/24
创建时间 2016/08/22

文档变更纪录

更改人 日期 更改内容
技术部艾星 2016/08/22 文档创建
技术部 2016/08/24 文档完善

概述

此文档用于开发前期应用系统所涉及的开发模型的定义,包括字段的定义与命名。

模型定义

模型定义是对每个技术实现细节的规范,相应的模型详见附录,甲方若无特殊要求,App命名空间以JY作为前缀(命名空间),包名统一使用com.jiangyou.jyobjectmodule以规范应用的唯一bundleId。

模型定义

说明

此模块用于定义通用模块的模型

操作

JYObject

####定义

参数名 参数含义 类型 备注
objectId 对象Id string 服务器分配的唯一对象Id
userId 当前用户Id string 当前用户Id
index 对象索引 int 对象索引值,值小于0是不生效,默认值为-1
atCreation 对象创建时间 long 对象创建时间
atUpdation 对象变更时间 long 对象变更时间,值小于0表示不生效,默认值为-1
descriptions 附加表述 string 附加描述,没有可忽略

####说明 此实体类抽象表述存在于服务器数据库的模型对象,所有模型都应该继承与这个对象,便于统一、抽象表示所有的模型对象。

JYImageObject

####关系 JYImageObject:JYObject ####定义

参数名 参数含义 类型 备注
url 图片链接地址 string 图片链接地址

####说明 此对象用于描述网络图片资源。

JYBannerObject

####关系 JYBannerObject:JYObject ####定义

参数名 参数含义 类型 备注
imageURL banner的图片 string banner的图片链接
url banner的链接 string banner的链接,用于跳转
priority banner的优先级 int 从0开始,表示banner的显示优先级,区别于index:index表示存储索引
type 类型 int banner类型,-1表示此字段不生效
subtype 子类型 int banner子类型,-1表示此字段不生效
referenceId 引用id string 引用App内部资源id

####说明 此对象用于描述banner资源。

JYLocationObject

####关系 JYLocationObject:JYObject ####定义

参数名 参数含义 类型 备注
longitude 经度 double 地理位置经度
latitude 纬度 double 地理位置纬度
province 省份 string 省份名称
city 城市 string 城市名称
district 区县 string 区县名称
street 街道 string 街道名称
address 扩展描述 string 详细地址描述

####说明 此实体类用于存储地理位置信息。

JYCommentObject

####关系 JYCommentObject:JYObject ####定义

参数名 参数含义 类型 备注
content 评论内容 string 评论内容
images 评论图片 List<_kind_of_JYImageObject> 评论图片
user 发表评论的用户 _kind_of_JYUserObject 发表评论用户实体
atUser 被评论评论内容的用户 _kind_of_JYUserObject 被评论评论内容的用户

####说明 此实体类用于描述评论对象

JYUserObject

####关系 JYUserObject:JYObject ####定义

参数名 参数含义 类型 备注
avatar 头像 string 图片链接
nickname 昵称 string 用户昵称,不要使用emoji等字符
phone 注册的电话号码 string 注册时使用的手机号码
gender 性别 int 性别,0代表默认,1代表男性,2代表女性
birthday 生日 string 生日字符串

####说明 次实体类用于描述用户对象

JYPostObject

####关系 JYPostObject:JYObject ####定义

参数名 参数含义 类型 备注
user 内容产生用户 _kind_of_JYUserObject 内容产生用户
title 内容标题 string 内容标题
detail 内容摘要 string 内容摘要
content 文字内容 string 文字内容
images 图片内容 List<_kind_of_JYImageObject> 图片内容
readCount 阅读数量 int 帖子阅读数量
commentCount 评论数量 int 帖子评论数量
liked 是否点赞 boolean 是否点赞帖子
likeCount 点赞数量 int 点赞数量
shareCount 分享数量 int 分享数量
comments 评论列表 List 评论实体列表,默认3条

####说明 此模型应用于所有图文内容相关的对象(帖子、动态等) ###JYStringObject ####关系 JYStringObject:JYObject ####定义

参数名 参数含义 类型 备注
storage 实际string内容 string 实际内容

####说明 此模型应用于所有需要保存的string对象

JYPushNotificationObject

####关系 JYPushNotificationObject:JYObject ####定义

参数名 参数含义 类型 备注
content 推送内容 string 推送内容
image 推送图片链接 string 推送图片链接
type 推送类型 int 推送类型
subtype 推送子类型 int 推送子类型

####说明 此模型应用于所有推送对象 ###JYIdentifierObject ####关系 JYIdentifierObject:JYObject ####定义

参数名 参数含义 类型 备注
name 实名名字 string 用户真实名字
identifier 身份证件编号 string 身份证
phone 联系方式 string 注册时使用的手机号码
state 认证状态 int 认证状态描述
substate 认证子状态 int 认证子状态
statements 状态描述 string 状态描述

####说明 此模型应用于实名认证状态对象描述

JYOrderObject

####关系 JYOrderObject:JYObject ####定义

参数名 参数含义 类型 备注
state 订单状态 int 订单状态
substate 订单子状态 int 订单子状态
product 产品 _kind_of_JYProductObject 订单来源产品

####说明 此模型应用于订单对象描述

JYProductObject

####关系 JYProductObject:JYObject ####定义

参数名 参数含义 类型 备注
title 产品名称 string 产品名称
detail 产品详细描述 string 产品详细描述
thumbnail 封面图链接 string 封面图链接
images 图片介绍 List<_kind_of_JYImgaeObject> 产品图片
url 产品介绍链接 string 产品介绍H5链接
state 产品状态 int 产品状态
substate 产品子状态 int 产品子状态
characteristics 产品特性 List<_kind_of_JYIntegerObject> 产品特性
categories 产品类别 List<_kind_of_JYProductCategoryObject> 需要实例化规格的类型

####说明 此模型应用于产品对象描述

JYChainObject

####关系 JYChainObject:JYObject ####定义

参数名 参数含义 类型 备注
superId 父节点Id string 父节点id
title 对象标题 string 对象标题
detail 对象详情 string 对象详情
children 子节点数组 List<_kind_of_JYChainObject> 子节点数组

####说明 此模型应用于链式结构对象

JYProductCategoryObject

####关系 JYProductCategoryObject:JYChainObject ####定义

参数名 参数含义 类型 备注

####说明 此模型应用于产品类别对象描述

JYPageObject

####关系 JYPageObject

定义

参数名 参数含义 类型 备注
index 当前页码 int 当前页码
pageCount 每页包含的纪录数 int 每页包饭的纪录数
totalCount 总数量 int 总数量

说明

此模型用于描述页码对象。

JYWalletObject

####关系 JYWalletObject:JYObject ####定义

参数名 参数含义 类型 备注
amount 钱包余额 long 钱包余额精确到分
withdrawal 可提现余额 long 可提现余额
blocked 冻结资金 long 冻结资金
income 累计收入 long 累计收入
outcome 累计支出 long 累计支出

####说明 此模型用户钱包对象

JYWithdrawalObject

####关系 JYWithdrawalObject:JYObject ####定义

参数名 参数含义 类型 备注
state 提现状态 int 提现状态,待定义
substate 提现子状态 int 待定义
statements 状态描述 string 例如失败原因描述
account 提现账户 string 支付宝账户
amount 提现金额 double 提现金额

####说明 此模型用户钱包提现对象

JYCashbackObject

####关系 JYCashbackObject:JYObject ####定义

参数名 参数含义 类型 备注
user 贡献用户 _kind_of_JYUserObject 贡献用户
type 返现类型 int 待定义
subtype 返现子类型 int 待定义
amount 返现金额 double 返现金额
statements 返现描述 string 返现描述

####说明 此模型用户钱包返现对象 ###JYAddressObject ####关系 JYAddressObject:JYObject ####定义

参数名 参数含义 类型 备注
name 收货人姓名 string 收货人姓名
phone 联系电话 string 联系电话
defaulted 是否是默认地址 boolean 是否是默认收货地址
location 地址信息 _kind_of_JYLocationObject 地址信息

####说明 此模型用户收货地址对象

JYIntegerObject

####关系 JYIntegerObject:JYObject ####定义

参数名 参数含义 类型 备注
integer 实际int值 int 实际int值

####说明 此模型用于描述int对象

JYRewardObject

####关系 JYRewardObject:JYObject ####定义

参数名 参数含义 类型 备注
title 标题描述 string 标题描述
detail 详细描述 string 详细描述
amount 金额大小 long 金额大小
type 类型 int 类型
subtype 子类型 int 子类型
state 状态 int 状态
substate 子状态 int 子状态

####说明 此模型用于描述积分、优惠券、红包等对象

JYNullObject

####关系 JYNullObject ####定义

参数名 参数含义 类型 备注

####说明 此模型用于描述空对象

JYUserVerifyResponseObject

####关系 JYUserVerifyResponseObject ####定义

参数名 参数含义 类型 备注
userId 用户Id string 注册成功之后服务器返回的用户id
token 授权码 string 注册成功之后服务器返回的授权码

####说明 此模型用于注册成功响应对象.

JYPreorderObject

####关系 JYPreorderObject:JYOrderObject ####定义

参数名 参数含义 类型 备注

####说明 此模型用于预购清单对象.

JYChargeObject

####关系 JYChargeObject:JYObject ####定义

参数名 参数含义 类型 备注
amount 金额 double 金额
type 类型 int 类型
subtype 子类型 int 子类型
channel 渠道 int 渠道

####说明 此模型用于账目对象.

JYIncomeObject

####关系 JYIncomeObject:JYChargeObject ####定义

参数名 参数含义 类型 备注

####说明 此模型用于收入对象.

JYOutcomeObject

####关系 JYOutcomeObject:JYChargeObject ####定义

参数名 参数含义 类型 备注

####说明 此模型用于支出对象.