|
25 | 25 | import static java.nio.charset.StandardCharsets.UTF_8; |
26 | 26 |
|
27 | 27 | import com.google.cloud.Page; |
| 28 | +import com.google.cloud.storage.Acl; |
| 29 | +import com.google.cloud.storage.Acl.User; |
28 | 30 | import com.google.cloud.storage.Blob; |
29 | 31 | import com.google.cloud.storage.Bucket; |
30 | 32 | import com.google.cloud.storage.Bucket.BucketSourceOption; |
@@ -124,8 +126,8 @@ public Page<Blob> listBlobs() { |
124 | 126 | } |
125 | 127 |
|
126 | 128 | /** |
127 | | - * Example of getting a blob in the bucket, only if its metageneration matches a value, otherwise |
128 | | - * a {@link StorageException} is thrown. |
| 129 | + * Example of getting a blob in the bucket, only if its metageneration matches a value, |
| 130 | + * otherwise a {@link StorageException} is thrown. |
129 | 131 | */ |
130 | 132 | // [TARGET get(String, BlobGetOption...)] |
131 | 133 | // [VARIABLE "my_blob_name"] |
@@ -226,4 +228,130 @@ public Blob createBlobFromInputStreamWithContentType(String blobName) { |
226 | 228 | // [END createBlobFromInputStreamWithContentType] |
227 | 229 | return blob; |
228 | 230 | } |
| 231 | + |
| 232 | + /** |
| 233 | + * Example of getting the ACL entry for an entity. |
| 234 | + */ |
| 235 | + // [TARGET getAcl(Entity)] |
| 236 | + public Acl getAcl() { |
| 237 | + // [START getAcl] |
| 238 | + Acl acl = bucket.getAcl(User.ofAllAuthenticatedUsers()); |
| 239 | + // [END getAcl] |
| 240 | + return acl; |
| 241 | + } |
| 242 | + |
| 243 | + /** |
| 244 | + * Example of deleting the ACL entry for an entity. |
| 245 | + */ |
| 246 | + // [TARGET deleteAcl(Entity)] |
| 247 | + public boolean deleteAcl() { |
| 248 | + // [START deleteAcl] |
| 249 | + boolean deleted = bucket.deleteAcl(User.ofAllAuthenticatedUsers()); |
| 250 | + if (deleted) { |
| 251 | + // the acl entry was deleted |
| 252 | + } else { |
| 253 | + // the acl entry was not found |
| 254 | + } |
| 255 | + // [END deleteAcl] |
| 256 | + return deleted; |
| 257 | + } |
| 258 | + |
| 259 | + /** |
| 260 | + * Example of creating a new ACL entry. |
| 261 | + */ |
| 262 | + // [TARGET createAcl(Acl)] |
| 263 | + public Acl createAcl() { |
| 264 | + // [START createAcl] |
| 265 | + Acl acl = bucket.createAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.READER)); |
| 266 | + // [END createAcl] |
| 267 | + return acl; |
| 268 | + } |
| 269 | + |
| 270 | + /** |
| 271 | + * Example of updating a new ACL entry. |
| 272 | + */ |
| 273 | + // [TARGET updateAcl(Acl)] |
| 274 | + public Acl updateAcl() { |
| 275 | + // [START updateAcl] |
| 276 | + Acl acl = bucket.updateAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.OWNER)); |
| 277 | + // [END updateAcl] |
| 278 | + return acl; |
| 279 | + } |
| 280 | + |
| 281 | + /** |
| 282 | + * Example of listing the ACL entries. |
| 283 | + */ |
| 284 | + // [TARGET listAcls()] |
| 285 | + public List<Acl> listAcls() { |
| 286 | + // [START listAcls] |
| 287 | + List<Acl> acls = bucket.listAcls(); |
| 288 | + for (Acl acl : acls) { |
| 289 | + // do something with ACL entry |
| 290 | + } |
| 291 | + // [END listAcls] |
| 292 | + return acls; |
| 293 | + } |
| 294 | + |
| 295 | + /** |
| 296 | + * Example of getting the default ACL entry for an entity. |
| 297 | + */ |
| 298 | + // [TARGET getDefaultAcl(Entity)] |
| 299 | + public Acl getDefaultAcl() { |
| 300 | + // [START getDefaultAcl] |
| 301 | + Acl acl = bucket.getDefaultAcl(User.ofAllAuthenticatedUsers()); |
| 302 | + // [END getDefaultAcl] |
| 303 | + return acl; |
| 304 | + } |
| 305 | + |
| 306 | + /** |
| 307 | + * Example of deleting the default ACL entry for an entity. |
| 308 | + */ |
| 309 | + // [TARGET deleteDefaultAcl(Entity)] |
| 310 | + public boolean deleteDefaultAcl() { |
| 311 | + // [START deleteDefaultAcl] |
| 312 | + boolean deleted = bucket.deleteDefaultAcl(User.ofAllAuthenticatedUsers()); |
| 313 | + if (deleted) { |
| 314 | + // the acl entry was deleted |
| 315 | + } else { |
| 316 | + // the acl entry was not found |
| 317 | + } |
| 318 | + // [END deleteDefaultAcl] |
| 319 | + return deleted; |
| 320 | + } |
| 321 | + |
| 322 | + /** |
| 323 | + * Example of creating a new default ACL entry. |
| 324 | + */ |
| 325 | + // [TARGET createDefaultAcl(Acl)] |
| 326 | + public Acl createDefaultAcl() { |
| 327 | + // [START createDefaultAcl] |
| 328 | + Acl acl = bucket.createDefaultAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.READER)); |
| 329 | + // [END createDefaultAcl] |
| 330 | + return acl; |
| 331 | + } |
| 332 | + |
| 333 | + /** |
| 334 | + * Example of updating a new default ACL entry. |
| 335 | + */ |
| 336 | + // [TARGET updateDefaultAcl(Acl)] |
| 337 | + public Acl updateDefaultAcl() { |
| 338 | + // [START updateDefaultAcl] |
| 339 | + Acl acl = bucket.updateDefaultAcl(Acl.of(User.ofAllAuthenticatedUsers(), Acl.Role.OWNER)); |
| 340 | + // [END updateDefaultAcl] |
| 341 | + return acl; |
| 342 | + } |
| 343 | + |
| 344 | + /** |
| 345 | + * Example of listing the default ACL entries. |
| 346 | + */ |
| 347 | + // [TARGET listDefaultAcls()] |
| 348 | + public List<Acl> listDefaultAcls() { |
| 349 | + // [START listDefaultAcls] |
| 350 | + List<Acl> acls = bucket.listDefaultAcls(); |
| 351 | + for (Acl acl : acls) { |
| 352 | + // do something with ACL entry |
| 353 | + } |
| 354 | + // [END listDefaultAcls] |
| 355 | + return acls; |
| 356 | + } |
229 | 357 | } |
0 commit comments