定制待定常量 · FA+Ecloud互聯網應用開發平臺綜合技術入門指南(READ)

## 一、概述平臺預留了一些待定的常量，在業務系統中，進行實例化（具體化），使得平臺的某些系統模塊功能起作用；以下分章節，分別闡述各種預留的待定產量及其用法；清單： | 序號 | 待定常量 | | --- | --- | | 1 | RayPromisedDepartmentType | | 2 | RayPromisedDepartmentId | | 3 | RayPromisedDepartmentType | | 4 | RayPromisedDomainType| | 5 | RayPromisedRoleId| | 6 | RayPromisedStaffBusinessId| | 7 | RayPromisedStaffIdentityId| | 8 | RayPromisedStaffLevelId| | 9 | RayPromisedStaffRelationType | | 10 | RayPromisedStaffType| | 11| RayPromisedStaffTrackType| | 12| RayPromisedStaffAccountChangeMethod| ## 二、定制單位類型、部門類型和賬號類型單位、部門和賬號，有時候需要結合業務的需要，進行類型的定制化，這里就可以使用平臺預留的這三個類型機制待定常量進行定制化定義了；默認情況下，如果業務系統不需要啟用這三個類型，則使用三個類型對應字段的地方都賦值0即可； ``` RayPromisedDepartmentType RayPromisedDomainType RayPromisedStaffType ``` ``` public class RayAppDepartmentType extends RayPromisedAware implements RayPromisedDepartmentType { public static final long schoolClass = 1; public static final long schoolDepartment = 2; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(schoolClass, "班級")); list.add(new StaticDict(schoolDepartment, "行政部門")); return list; } } ``` ## 三、定制賬號關系 SysStaffRelation記錄賬號之間的關系，這個是一個通用設定，在不同的業務系統中，可以有不同的用途，下面以物聯卡系統的代理關系作為實例，說明如何使用； ### **定義業務用的賬戶關系常量** ``` public class RayiotSysStaffRelationType extends RayPromisedAware implements RayPromisedStaffRelationType { public static final long parent_agent = 1;// public static final long topagent_creator = 2;// @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(parent_agent, "父級代理商")); list.add(new StaticDict(topagent_creator, "頂級代理商創建者")); return list; } } ``` >[danger] 這些配置都是按照約定配置，無需特別配置，按照接口實現即可，如果配置了多個同接口實現，則需要用@RayConventionEnabled來注解啟用的那個實現； ### **使用** 上面定義了業務系統中賬號關系的具體用法，這樣，就可以在業務中，具體使用賬號關系了； ``` SysStaff staffobj = staffCreateExecutor.create("", mobile, staffName, 0, RayiotFrameworkLevelConstants.agentDepartment, RayiotFrameworkLevelConstants.agentRole, RayiotFrameworkLevelConstants.agentIdentity, 0, "", "", model.getCurLoginData().getCurStaffId(), RayiotSysStaffRelationType.parent_agent, "", 0); ``` >[danger] > 1、上面就是創建一個代理商的下級代理商代碼，里面用了賬號關系了，通過這個來記錄代理關系； > 2、可以通過平臺提供的接口（015平臺約定參數，如/api/system/common/raypromise/staff/relationtype/list），查看所有業務定義的相關屬性元素了； ## 四、定制角色、部門、賬號身份、賬號等級、賬戶業務業務系統中，有時候需要一些特定的角色、部門、賬號身份及賬號業務；定制賬號身份舉例： ``` public class RmallPromisedStaffIdentityId extends RayPromisedAware implements RayPromisedStaffIdentityId { public static final long memberIdentity = 1; public static final long lobbyIdentity = 2; public static final long countyIdentity = 3; public static final long cityIdentity = 4; public static final long provinceIdentity = 5; public static final long resourceProviderIdentity = 100; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(memberIdentity, "會員")); list.add(new StaticDict(lobbyIdentity, "營業廳")); list.add(new StaticDict(countyIdentity, "縣級分公司")); list.add(new StaticDict(cityIdentity, "市級分公司")); list.add(new StaticDict(provinceIdentity, "省級子公司")); return list; } } ``` 定制部門舉例： ``` public class RayiotPromisedDepartmentId extends RayPromisedAware implements RayPromisedDepartmentId { public static final long cardUserDepartment = 3; public static final long topAgentDepartment = 4; public static final long wechatTopAgentDepartment = 5; public static final long apiTopAgentDepartment = 6; public static final long agentDepartment = 7; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(cardUserDepartment, "用戶部門")); list.add(new StaticDict(topAgentDepartment, "頂級代理商部門")); list.add(new StaticDict(wechatTopAgentDepartment, "微信接入代理部門")); list.add(new StaticDict(apiTopAgentDepartment, "api接入代理部門")); list.add(new StaticDict(agentDepartment, "代理商部門")); return list; } } ``` 定制賬號角色舉例： ``` public class RayiotPromisedRoleId extends RayPromisedAware implements RayPromisedRoleId { public static final long cardUserRole = 100; public static final long topAgentRole = 101; public static final long wechatTopAgentRole = 102; public static final long apiTopAgentRole = 103; public static final long agentRole = 104; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(cardUserRole, "用戶角色")); list.add(new StaticDict(topAgentRole, "頂級代理商角色")); list.add(new StaticDict(wechatTopAgentRole, "微信接入代理角色")); list.add(new StaticDict(apiTopAgentRole, "api接入代理角色")); list.add(new StaticDict(agentRole, "代理商角色")); return list; } } ``` 定制賬號業務舉例： ``` public class RayiotPromisedStaffBusinessId extends RayPromisedAware implements RayPromisedStaffBusinessId { public static final long innerUser = 1; public static final long wechatUser = 2; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(0, "所有")); list.add(new StaticDict(innerUser, "平臺內部用戶")); list.add(new StaticDict(wechatUser, "微信接入用戶")); return list; } } ``` 定制賬號等級舉例： ``` public class RmallPromisedStaffLevelId extends RayPromisedAware implements RayPromisedStaffLevelId { public static final long l1 = 1; public static final long l2 = 2; public static final long l3 = 3; public static final long l4 = 4; public static final long l5 = 5; public static final long l6 = 6; public static final long l7 = 7; public static final long l8 = 8; public static final long l9 = 9; public static final long l10 = 10; public static final long l11 = 11; public static final long l12 = 12; public static final long l13 = 13; public static final long l14 = 14; public static final long l15 = 15; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(l1, "1級")); list.add(new StaticDict(l2, "2級")); list.add(new StaticDict(l3, "3級")); list.add(new StaticDict(l4, "4級")); list.add(new StaticDict(l5, "5級")); list.add(new StaticDict(l6, "6級")); list.add(new StaticDict(l7, "7級")); list.add(new StaticDict(l8, "8級")); list.add(new StaticDict(l9, "9級")); list.add(new StaticDict(l10, "10級")); list.add(new StaticDict(l11, "11級")); list.add(new StaticDict(l12, "12級")); list.add(new StaticDict(l13, "13級")); list.add(new StaticDict(l14, "14級")); list.add(new StaticDict(l15, "15級")); return list; } } ``` ## 五、定制異步執行事件類型業務系統中，有時候需要在應用中產生一些異步任務，由調度服務去執行這些具體的異步任務，為了通用化處理，平臺引入了定制的異步執行事件類型； ``` public class RayiotPromisedAsynExecuteType extends RayPromisedAware implements RayPromisedAsynExecuteType { public static final long activateCard = 1; public static final long addWhiteNumber = 2; @Override public List<StaticDict> getDataListForSelect() { list.add(new StaticDict(activateCard, "激活卡片")); list.add(new StaticDict(addWhiteNumber, "白名單")); return list; } } ``` 用途可參考：[項目實戰/后端開發/多線程與并發/異步事件機制](../%E5%A4%9A%E7%BA%BF%E7%A8%8B%E4%B8%8E%E5%B9%B6%E5%8F%91/%E5%BC%82%E6%AD%A5%E4%BA%8B%E4%BB%B6%E6%9C%BA%E5%88%B6.md)