com.seeyon.apps.bulletin.api

接口 BulletinApi

所有已知实现类:

AbstractBulletinApi

public interface BulletinApi

公告接口

方法概要

限定符和类型	方法和说明
java.util.Map<java.lang.String,java.lang.Object>	bulletinsList4Xiaoz(java.util.Map<java.lang.String,java.lang.String> params) 用于小致语音搜索获取小致数据 Author： wujie
boolean	checkScope(java.lang.Long memberId, java.lang.Long dataId) 校验人员是否在发布范围中 正常: 1、传入正确的人员id和公告id（该人员在发布范围），返回true 2、传入正确的人员id和公告id（该人员不在发布范围），返回false
java.util.List<BulTypeBO>	findAccountBulletinTypes(java.lang.Long accountId) 获取某个单位或某个自定义空间公告板块列表 正常： 1、传入正确的单位id，返回单位板块列表 2、传入正确的自定义空间id，返回自定义空间板块列表 3、传入正确的自定义空间id（该空间没有板块的情况），返回空列表
java.util.List<BulTypeBO>	findAccountBulletinTypesCanIssue(java.lang.Long memberId, java.lang.Long accountId) 获取人员能发布的公告板块列表（某个单位或某个自定义空间） 正常： 1、传入正确的单位id和人员id，返回该人员有发布权限的单位板块列表 2、传入正确的自定义空间id和人员id，返回该人员有发布权限的自定义空间板块列表 3、传入正确的自定义空间id和人员id（人员没有空间板块发布权的情况），返回空列表
java.util.List<BulTypeBO>	findAccountBulletinTypesCanIssue(java.lang.Long memberId, java.lang.Long accountId, java.lang.String spaceType) 获取人员能发布的公告板块列表（某个单位或某个自定义空间） 正常： 1、传入正确的单位id和人员id，返回该人员有发布权限的单位板块列表 2、传入正确的自定义空间id和人员id，返回该人员有发布权限的自定义空间板块列表 3、传入正确的自定义空间id和人员id（人员没有空间板块发布权的情况），返回空列表
java.util.List<BulTypeBO>	findAllBulletinTypesCanIssue(java.lang.Long memberId) 获取人员能发布的公告板块列表（所有） 正常： 1、传入正确的人员id，能正常返回板块列表 2、传入正确的人员id（该人员没有公告发布权限），返回空列表
java.util.List<BulTypeBO>	findAllCustomBulletinTypes() 获取所有自定义空间公告板块列表 正常: 1、调用此接口，返回所有自定义空间公告板块列表
java.util.List<BulDataBO>	findBulletinDatasByTypeId(com.seeyon.ctp.util.FlipInfo fi, java.lang.Long memberId, java.lang.Long typeId, java.lang.String condition, java.lang.String value1, java.lang.String value2) 获取某个板块的公告 正常: 1、所有参数传入正确值且当前查询条件下存在公告，分页显示板块下的公告列表 2、所有参数传入正确值且当前查询条件下不存在公告，返回空列表 异常: 3、所有参数传入null，抛异常
java.util.List<BulTypeBO>	findBulletinTypesByAccountId(com.seeyon.ctp.util.FlipInfo fi, java.lang.Long accountId, java.lang.String condition, java.lang.String value1, java.lang.String value2) 获取某个单位的公告板块 正常: 1、所有参数传入正确值且当前查询条件下存在公告板块，分页显示单位下的公告板块列表 2、所有参数传入正确值且当前查询条件下不存在公告板块，返回空列表 异常: 3、所有参数传入null，抛异常
java.util.List<BulTypeManagersBO>	findBulTypeManagers(java.lang.Long typeId)
java.util.List<BulTypeBO>	findCustomTypesByAccountId(java.lang.Long accountId, java.lang.Integer spaceType) 获取某个单位或某个自定义空间公告板块列表 正常： 1、传入正确的自定义空间id，返回自定义空间板块列表 2、传入正确的自定义空间type（该空间没有板块的情况），返回空列表
java.util.List<BulTypeBO>	findGroupBulletinTypes() 获取集团公告板块列表 正常: 1、调用此接口，返回集团公告板块列表
java.util.List<BulTypeBO>	findGroupBulletinTypesCanIssue(java.lang.Long memberId) 获取人员能发布的公告板块列表（集团） 正常： 1、传入正确的人员id，能正常返回集团板块列表 2、传入正确的人员id（该人员没有集团公告发布权限），返回空列表
BulBodyBO	getBulBody(java.lang.Long id)
BulDataBO	getBulData(java.lang.Long id)
BulTypeBO	getBulletinType(java.lang.Long id) 获取公告板块 正常： 1、获取一个公告板块，能正常返回公告实体
boolean	isBulTypeManager(java.lang.Long typeId, java.lang.Long memberId) 判断用户是否有板块的管理权限 正常: 1、传入正确的人员id和版块id（该人员有版块管理权限），返回true 2、传入正确的人员id和版块id（该人员没有版块管理权限），返回false
java.lang.Long	issueBulletinData(BulletinDataParam bulletinDataParam) 发布公告 正常： 1、有权限的人员发布一个公告，所有必填项都包含在参数中，公告能成功发送，返回公告id 异常： 2、所有参数传入null，抛异常
void	saveBulData(BulDataBO bo)
void	saveBulletinType(BulTypeBO bo)
boolean	updateBulDataTopNumber(java.lang.Long accountId, java.lang.Integer spaceType, java.lang.Integer topNumberMax) 由于总板块置顶个数变需要更新公告数据表多于置顶个数的数据

方法详细资料

getBulletinType

BulTypeBO getBulletinType(java.lang.Long id)
                   throws com.seeyon.ctp.common.exceptions.BusinessException

获取公告板块 正常：
1、获取一个公告板块，能正常返回公告实体

参数:

id - 需要获取公告板块的id

返回:

板块实体，如板块不存在，返回null

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

saveBulletinType

void saveBulletinType(BulTypeBO bo)
               throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findBulTypeManagers

java.util.List<BulTypeManagersBO> findBulTypeManagers(java.lang.Long typeId)
                                               throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getBulData

BulDataBO getBulData(java.lang.Long id)
              throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

saveBulData

void saveBulData(BulDataBO bo)
          throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

getBulBody

BulBodyBO getBulBody(java.lang.Long id)
              throws com.seeyon.ctp.common.exceptions.BusinessException

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findAllCustomBulletinTypes

java.util.List<BulTypeBO> findAllCustomBulletinTypes()
                                              throws com.seeyon.ctp.common.exceptions.BusinessException

获取所有自定义空间公告板块列表 正常:
1、调用此接口，返回所有自定义空间公告板块列表

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findGroupBulletinTypes

java.util.List<BulTypeBO> findGroupBulletinTypes()
                                          throws com.seeyon.ctp.common.exceptions.BusinessException

获取集团公告板块列表 正常:
1、调用此接口，返回集团公告板块列表

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findAccountBulletinTypes

java.util.List<BulTypeBO> findAccountBulletinTypes(java.lang.Long accountId)
                                            throws com.seeyon.ctp.common.exceptions.BusinessException

获取某个单位或某个自定义空间公告板块列表 正常：
1、传入正确的单位id，返回单位板块列表
2、传入正确的自定义空间id，返回自定义空间板块列表
3、传入正确的自定义空间id（该空间没有板块的情况），返回空列表

参数:

accountId - 单位id或空间id

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException - BusinessException异常

findCustomTypesByAccountId

java.util.List<BulTypeBO> findCustomTypesByAccountId(java.lang.Long accountId,
                                                     java.lang.Integer spaceType)
                                              throws com.seeyon.ctp.common.exceptions.BusinessException

获取某个单位或某个自定义空间公告板块列表 正常：
1、传入正确的自定义空间id，返回自定义空间板块列表
2、传入正确的自定义空间type（该空间没有板块的情况），返回空列表

参数:

accountId - 自定义空间id

spaceType - 自定义空间type

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException - BusinessException异常

findAllBulletinTypesCanIssue

java.util.List<BulTypeBO> findAllBulletinTypesCanIssue(java.lang.Long memberId)
                                                throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员能发布的公告板块列表（所有） 正常：
1、传入正确的人员id，能正常返回板块列表
2、传入正确的人员id（该人员没有公告发布权限），返回空列表

参数:

memberId - 人员id

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findGroupBulletinTypesCanIssue

java.util.List<BulTypeBO> findGroupBulletinTypesCanIssue(java.lang.Long memberId)
                                                  throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员能发布的公告板块列表（集团） 正常：
1、传入正确的人员id，能正常返回集团板块列表
2、传入正确的人员id（该人员没有集团公告发布权限），返回空列表

参数:

memberId - 人员id

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findAccountBulletinTypesCanIssue

java.util.List<BulTypeBO> findAccountBulletinTypesCanIssue(java.lang.Long memberId,
                                                           java.lang.Long accountId)
                                                    throws com.seeyon.ctp.common.exceptions.BusinessException

获取人员能发布的公告板块列表（某个单位或某个自定义空间） 正常：
1、传入正确的单位id和人员id，返回该人员有发布权限的单位板块列表
2、传入正确的自定义空间id和人员id，返回该人员有发布权限的自定义空间板块列表
3、传入正确的自定义空间id和人员id（人员没有空间板块发布权的情况），返回空列表

参数:

memberId - 人员id

accountId - 单位id或空间id

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

isBulTypeManager

boolean isBulTypeManager(java.lang.Long typeId,
                         java.lang.Long memberId)
                  throws com.seeyon.ctp.common.exceptions.BusinessException

判断用户是否有板块的管理权限 正常:
1、传入正确的人员id和版块id（该人员有版块管理权限），返回true
2、传入正确的人员id和版块id（该人员没有版块管理权限），返回false

参数:

typeId - 板块id

memberId - 人员id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

issueBulletinData

java.lang.Long issueBulletinData(BulletinDataParam bulletinDataParam)
                          throws com.seeyon.ctp.common.exceptions.BusinessException

发布公告
正常：
1、有权限的人员发布一个公告，所有必填项都包含在参数中，公告能成功发送，返回公告id
异常：
2、所有参数传入null，抛异常

参数:

bulletinDataParam - 以下参数是必须的：
title 标题
typeId 所属板块id
publishScope 发布范围
content 正文内容
categroy 应用标识
memberId 发布人id

返回:

公告id

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

checkScope

boolean checkScope(java.lang.Long memberId,
                   java.lang.Long dataId)
            throws com.seeyon.ctp.common.exceptions.BusinessException

校验人员是否在发布范围中 正常:
1、传入正确的人员id和公告id（该人员在发布范围），返回true
2、传入正确的人员id和公告id（该人员不在发布范围），返回false

参数:

memberId - 人员id

dataId - 公告id

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findBulletinTypesByAccountId

java.util.List<BulTypeBO> findBulletinTypesByAccountId(com.seeyon.ctp.util.FlipInfo fi,
                                                       java.lang.Long accountId,
                                                       java.lang.String condition,
                                                       java.lang.String value1,
                                                       java.lang.String value2)
                                                throws com.seeyon.ctp.common.exceptions.BusinessException

获取某个单位的公告板块 正常:
1、所有参数传入正确值且当前查询条件下存在公告板块，分页显示单位下的公告板块列表
2、所有参数传入正确值且当前查询条件下不存在公告板块，返回空列表
异常:
3、所有参数传入null，抛异常

参数:

fi - 分页对象

accountId - 单位id

condition - 查询条件，如：name,按名称查询

value1 - 要查询的第一个值，如：名称

value2 - 要查询的第二个值，如：时间的结束值

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findBulletinDatasByTypeId

java.util.List<BulDataBO> findBulletinDatasByTypeId(com.seeyon.ctp.util.FlipInfo fi,
                                                    java.lang.Long memberId,
                                                    java.lang.Long typeId,
                                                    java.lang.String condition,
                                                    java.lang.String value1,
                                                    java.lang.String value2)
                                             throws com.seeyon.ctp.common.exceptions.BusinessException

获取某个板块的公告 正常:
1、所有参数传入正确值且当前查询条件下存在公告，分页显示板块下的公告列表
2、所有参数传入正确值且当前查询条件下不存在公告，返回空列表
异常:
3、所有参数传入null，抛异常

参数:

fi - 分页对象

memberId - 人员id

typeId - 板块id

condition - 查询条件，如：title,按标题查询

value1 - 要查询的第一个值，如：标题

value2 - 要查询的第二个值，如：时间的结束值

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

findAccountBulletinTypesCanIssue

java.util.List<BulTypeBO> findAccountBulletinTypesCanIssue(java.lang.Long memberId,
                                                           java.lang.Long accountId,
                                                           java.lang.String spaceType)

获取人员能发布的公告板块列表（某个单位或某个自定义空间） 正常：
1、传入正确的单位id和人员id，返回该人员有发布权限的单位板块列表
2、传入正确的自定义空间id和人员id，返回该人员有发布权限的自定义空间板块列表
3、传入正确的自定义空间id和人员id（人员没有空间板块发布权的情况），返回空列表

参数:

memberId - 人员id

accountId - 单位id或空间id

spaceType - 空间类型

返回:

公告板块列表，如没有板块，返回空集合

抛出:

com.seeyon.ctp.common.exceptions.BusinessException

updateBulDataTopNumber

boolean updateBulDataTopNumber(java.lang.Long accountId,
                               java.lang.Integer spaceType,
                               java.lang.Integer topNumberMax)

由于总板块置顶个数变需要更新公告数据表多于置顶个数的数据

参数:

accountId - 单位ID

spaceType - 空间

topNumberMax -

返回:

bulletinsList4Xiaoz

java.util.Map<java.lang.String,java.lang.Object> bulletinsList4Xiaoz(java.util.Map<java.lang.String,java.lang.String> params)
                                                              throws com.seeyon.ctp.common.exceptions.BusinessException

用于小致语音搜索获取小致数据 Author： wujie

参数:

params - 公告数据的查询条件，可以进行多条件组合查询

     {
         title    标题
         pageNo   页码
         pageSize       页数
         publishStartDate       公告开始时间 格式date
                   publishEndDate       公告结束时间 格式date
                   publishUser  创建人 格式 Member|123434
     }
 

返回:

抛出:

com.seeyon.ctp.common.exceptions.BusinessException