You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

user_space.go 8.2 kB

7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. package api
  2. import (
  3. "net/http"
  4. "gitlink.org.cn/cloudream/common/sdks"
  5. clitypes "gitlink.org.cn/cloudream/jcs-pub/client/types"
  6. cortypes "gitlink.org.cn/cloudream/jcs-pub/coordinator/types"
  7. )
  8. const UserSpaceDownloadPackagePath = "/userspace/downloadPackage"
  9. type UserSpaceDownloadPackageReq struct {
  10. PackageID clitypes.PackageID `json:"packageID" binding:"required"`
  11. UserSpaceID clitypes.UserSpaceID `json:"userSpaceID" binding:"required"`
  12. RootPath string `json:"rootPath"`
  13. }
  14. func (r *UserSpaceDownloadPackageReq) MakeParam() *sdks.RequestParam {
  15. return sdks.MakeJSONParam(http.MethodPost, UserSpaceDownloadPackagePath, r)
  16. }
  17. type UserSpaceDownloadPackageResp struct{}
  18. func (r *UserSpaceDownloadPackageResp) ParseResponse(resp *http.Response) error {
  19. return sdks.ParseCodeDataJSONResponse(resp, r)
  20. }
  21. func (c *Client) UserSpaceDownloadPackage(req UserSpaceDownloadPackageReq) (*UserSpaceDownloadPackageResp, error) {
  22. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceDownloadPackageResp{})
  23. }
  24. const UserSpaceCreatePackagePath = "/userspace/createPackage"
  25. type UserSpaceCreatePackageReq struct {
  26. UserSpaceID clitypes.UserSpaceID `json:"userSpaceID" binding:"required"`
  27. Path string `json:"path" binding:"required"`
  28. BucketID clitypes.BucketID `json:"bucketID" binding:"required"`
  29. Name string `json:"name" binding:"required"`
  30. SpaceAffinity clitypes.UserSpaceID `json:"spaceAffinity"`
  31. }
  32. func (r *UserSpaceCreatePackageReq) MakeParam() *sdks.RequestParam {
  33. return sdks.MakeJSONParam(http.MethodPost, UserSpaceCreatePackagePath, r)
  34. }
  35. type UserSpaceCreatePackageResp struct {
  36. Package clitypes.Package `json:"package"`
  37. }
  38. func (r *UserSpaceCreatePackageResp) ParseResponse(resp *http.Response) error {
  39. return sdks.ParseCodeDataJSONResponse(resp, r)
  40. }
  41. func (c *Client) UserSpaceCreatePackage(req UserSpaceCreatePackageReq) (*UserSpaceCreatePackageResp, error) {
  42. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceCreatePackageResp{})
  43. }
  44. const UserSpaceGetPath = "/userspace/get"
  45. type UserSpaceGet struct {
  46. UserSpaceID clitypes.UserSpaceID `form:"userSpaceID" url:"userSpaceID" binding:"required"`
  47. }
  48. func (r *UserSpaceGet) MakeParam() *sdks.RequestParam {
  49. return sdks.MakeQueryParam(http.MethodGet, UserSpaceGetPath, r)
  50. }
  51. type UserSpaceGetResp struct {
  52. clitypes.UserSpace
  53. }
  54. func (r *UserSpaceGetResp) ParseResponse(resp *http.Response) error {
  55. return sdks.ParseCodeDataJSONResponse(resp, r)
  56. }
  57. func (c *Client) UserSpaceGet(req UserSpaceGet) (*UserSpaceGetResp, error) {
  58. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceGetResp{})
  59. }
  60. const UserSpaceGetByNamePath = "/userspace/getByName"
  61. type UserSpaceGetByName struct {
  62. Name string `form:"name" url:"name" binding:"required"`
  63. }
  64. func (r *UserSpaceGetByName) MakeParam() *sdks.RequestParam {
  65. return sdks.MakeQueryParam(http.MethodGet, UserSpaceGetByNamePath, r)
  66. }
  67. type UserSpaceGetByNameResp struct {
  68. clitypes.UserSpace
  69. }
  70. func (r *UserSpaceGetByNameResp) ParseResponse(resp *http.Response) error {
  71. return sdks.ParseCodeDataJSONResponse(resp, r)
  72. }
  73. func (c *Client) UserSpaceGetByName(req UserSpaceGetByName) (*UserSpaceGetByNameResp, error) {
  74. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceGetByNameResp{})
  75. }
  76. const UserSpaceGetAllPath = "/userspace/getAll"
  77. type UserSpaceGetAll struct{}
  78. func (r *UserSpaceGetAll) MakeParam() *sdks.RequestParam {
  79. return sdks.MakeQueryParam(http.MethodGet, UserSpaceGetAllPath, nil)
  80. }
  81. type UserSpaceGetAllResp struct {
  82. UserSpaces []clitypes.UserSpace `json:"userSpaces"`
  83. }
  84. func (r *UserSpaceGetAllResp) ParseResponse(resp *http.Response) error {
  85. return sdks.ParseCodeDataJSONResponse(resp, r)
  86. }
  87. func (c *Client) UserSpaceGetAll() (*UserSpaceGetAllResp, error) {
  88. req := UserSpaceGetAll{}
  89. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceGetAllResp{})
  90. }
  91. // 创建用户空间
  92. const UserSpaceCreatePath = "/userspace/create"
  93. type UserSpaceCreate struct {
  94. Name string `json:"name" binding:"required"`
  95. Storage cortypes.StorageType `json:"storage" binding:"required"`
  96. Credential cortypes.StorageCredential `json:"credential" binding:"required"`
  97. ShardStore *cortypes.ShardStoreUserConfig `json:"shardStore"`
  98. Features []cortypes.StorageFeature `json:"features"`
  99. WorkingDir string `json:"workingDir"`
  100. }
  101. func (r *UserSpaceCreate) MakeParam() *sdks.RequestParam {
  102. return sdks.MakeJSONParam(http.MethodPost, UserSpaceCreatePath, r)
  103. }
  104. type UserSpaceCreateResp struct {
  105. clitypes.UserSpace
  106. }
  107. func (r *UserSpaceCreateResp) ParseResponse(resp *http.Response) error {
  108. return sdks.ParseCodeDataJSONResponse(resp, r)
  109. }
  110. func (c *Client) UserSpaceCreate(req UserSpaceCreate) (*UserSpaceCreateResp, error) {
  111. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceCreateResp{})
  112. }
  113. // 更新用户空间。一些重要的配置不可再二次修改
  114. const UserSpaceUpdatePath = "/userspace/update"
  115. type UserSpaceUpdate struct {
  116. UserSpaceID clitypes.UserSpaceID `json:"userSpaceID" binding:"required"`
  117. Name string `json:"name" binding:"required"`
  118. Credential cortypes.StorageCredential `json:"credential" binding:"required"`
  119. Features []cortypes.StorageFeature `json:"features"`
  120. }
  121. func (r *UserSpaceUpdate) MakeParam() *sdks.RequestParam {
  122. return sdks.MakeJSONParam(http.MethodPost, UserSpaceUpdatePath, r)
  123. }
  124. type UserSpaceUpdateResp struct {
  125. clitypes.UserSpace
  126. }
  127. func (r *UserSpaceUpdateResp) ParseResponse(resp *http.Response) error {
  128. return sdks.ParseCodeDataJSONResponse(resp, r)
  129. }
  130. func (c *Client) UserSpaceUpdate(req UserSpaceUpdate) (*UserSpaceUpdateResp, error) {
  131. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceUpdateResp{})
  132. }
  133. // 删除用户空间
  134. const UserSpaceDeletePath = "/userspace/delete"
  135. type UserSpaceDelete struct {
  136. UserSpaceID clitypes.UserSpaceID `json:"userSpaceID" binding:"required"`
  137. }
  138. func (r *UserSpaceDelete) MakeParam() *sdks.RequestParam {
  139. return sdks.MakeJSONParam(http.MethodPost, UserSpaceDeletePath, r)
  140. }
  141. type UserSpaceDeleteResp struct{}
  142. func (r *UserSpaceDeleteResp) ParseResponse(resp *http.Response) error {
  143. return sdks.ParseCodeDataJSONResponse(resp, r)
  144. }
  145. func (c *Client) UserSpaceDelete(req UserSpaceDelete) (*UserSpaceDeleteResp, error) {
  146. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceDeleteResp{})
  147. }
  148. // 测试给定用户空间的配置是否有效
  149. const UserSpaceTestPath = "/userspace/test"
  150. type UserSpaceTest struct {
  151. Storage cortypes.StorageType `json:"storage" binding:"required"`
  152. Credential cortypes.StorageCredential `json:"credential" binding:"required"`
  153. WorikingDir string `json:"workingDir"`
  154. }
  155. func (r *UserSpaceTest) MakeParam() *sdks.RequestParam {
  156. return sdks.MakeJSONParam(http.MethodPost, UserSpaceTestPath, r)
  157. }
  158. type UserSpaceTestResp struct {
  159. // TODO 可以考虑返回WorkingDir内的文件列表
  160. }
  161. func (r *UserSpaceTestResp) ParseResponse(resp *http.Response) error {
  162. return sdks.ParseCodeDataJSONResponse(resp, r)
  163. }
  164. func (c *Client) UserSpaceTest(req UserSpaceTest) (*UserSpaceTestResp, error) {
  165. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceTestResp{})
  166. }
  167. // 存储服务间直传
  168. const UserSpaceSpaceToSpacePath = "/userspace/spaceToSpace"
  169. type UserSpaceSpaceToSpace struct {
  170. SrcUserSpaceID clitypes.UserSpaceID `json:"srcUserSpaceID" binding:"required"`
  171. DstUserSpaceID clitypes.UserSpaceID `json:"dstUserSpaceID" binding:"required"`
  172. SrcPath string `json:"srcPath" binding:"required"`
  173. DstPath string `json:"dstPath" binding:"required"`
  174. }
  175. func (r *UserSpaceSpaceToSpace) MakeParam() *sdks.RequestParam {
  176. return sdks.MakeJSONParam(http.MethodPost, UserSpaceSpaceToSpacePath, r)
  177. }
  178. type UserSpaceSpaceToSpaceResp struct {
  179. clitypes.SpaceToSpaceResult
  180. }
  181. func (r *UserSpaceSpaceToSpaceResp) ParseResponse(resp *http.Response) error {
  182. return sdks.ParseCodeDataJSONResponse(resp, r)
  183. }
  184. func (c *Client) UserSpaceSpaceToSpace(req UserSpaceSpaceToSpace) (*UserSpaceSpaceToSpaceResp, error) {
  185. return JSONAPI(&c.cfg, c.httpCli, &req, &UserSpaceSpaceToSpaceResp{})
  186. }

本项目旨在将云际存储公共基础设施化,使个人及企业可低门槛使用高效的云际存储服务(安装开箱即用云际存储客户端即可,无需关注其他组件的部署),同时支持用户灵活便捷定制云际存储的功能细节。