OLD | NEW |
1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 /// This library provides access to Google Cloud Storage. | 5 /// This library provides access to Google Cloud Storage. |
6 /// | 6 /// |
7 /// Google Cloud Storage is an object store for binary objects. Each | 7 /// Google Cloud Storage is an object store for binary objects. Each |
8 /// object has a set of metadata attached to it. For more information on | 8 /// object has a set of metadata attached to it. For more information on |
9 /// Google Cloud Sorage see https://developers.google.com/storage/. | 9 /// Google Cloud Sorage see https://developers.google.com/storage/. |
10 /// | 10 /// |
(...skipping 54 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
65 part 'src/storage_impl.dart'; | 65 part 'src/storage_impl.dart'; |
66 | 66 |
67 const Symbol _storageKey = #_gcloud.storage; | 67 const Symbol _storageKey = #_gcloud.storage; |
68 | 68 |
69 /// Access the [Storage] object available in the current service scope. | 69 /// Access the [Storage] object available in the current service scope. |
70 /// | 70 /// |
71 /// The returned object will be the one which was previously registered with | 71 /// The returned object will be the one which was previously registered with |
72 /// [registerStorageService] within the current (or a parent) service scope. | 72 /// [registerStorageService] within the current (or a parent) service scope. |
73 /// | 73 /// |
74 /// Accessing this getter outside of a service scope will result in an error. | 74 /// Accessing this getter outside of a service scope will result in an error. |
| 75 /// See the `package:gcloud/service_scope.dart` library for more information. |
75 Storage get storageService => ss.lookup(_storageKey); | 76 Storage get storageService => ss.lookup(_storageKey); |
76 | 77 |
77 /// Registers the [storage] object within the current service scope. | 78 /// Registers the [storage] object within the current service scope. |
78 /// | 79 /// |
79 /// The provided `storage` object will be avilable via the top-level `storage` | 80 /// The provided `storage` object will be avilable via the top-level `storage` |
80 /// getter. | 81 /// getter. |
81 /// | 82 /// |
82 /// Calling this function outside of a service scope will result in an error. | 83 /// Calling this function outside of a service scope will result in an error. |
83 /// Calling this function more than once inside the same service scope is not | 84 /// Calling this function more than once inside the same service scope is not |
84 /// allowed. | 85 /// allowed. |
(...skipping 686 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
771 /// Start paging through objects in the bucket. | 772 /// Start paging through objects in the bucket. |
772 /// | 773 /// |
773 /// The maximum number of objects in each page is specified in [pageSize]. | 774 /// The maximum number of objects in each page is specified in [pageSize]. |
774 /// | 775 /// |
775 /// See [list] for more information on the other arguments. | 776 /// See [list] for more information on the other arguments. |
776 /// | 777 /// |
777 /// Returns a `Future` which completes with a `Page` object holding the | 778 /// Returns a `Future` which completes with a `Page` object holding the |
778 /// first page. Use the `Page` object to move to the next page. | 779 /// first page. Use the `Page` object to move to the next page. |
779 Future<Page<BucketEntry>> page({String prefix, int pageSize: 50}); | 780 Future<Page<BucketEntry>> page({String prefix, int pageSize: 50}); |
780 } | 781 } |
OLD | NEW |