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 7.4 kB

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

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