| OLD | NEW |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, 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 library barback.pool; | 5 library barback.utils.pool; |
| 6 | 6 |
| 7 import 'dart:async'; | 7 import 'dart:async'; |
| 8 import 'dart:collection'; | 8 import 'dart:collection'; |
| 9 | 9 |
| 10 import 'package:stack_trace/stack_trace.dart'; | 10 import 'package:stack_trace/stack_trace.dart'; |
| 11 | 11 |
| 12 import 'utils.dart'; | 12 import '../utils.dart'; |
| 13 | 13 |
| 14 // TODO(nweiz): put this somewhere that it can be shared between packages. | 14 // TODO(nweiz): put this somewhere that it can be shared between packages. |
| 15 /// Manages an abstract pool of resources with a limit on how many may be in use | 15 /// Manages an abstract pool of resources with a limit on how many may be in use |
| 16 /// at once. | 16 /// at once. |
| 17 /// | 17 /// |
| 18 /// When a resource is needed, the user should call [request]. When the returned | 18 /// When a resource is needed, the user should call [request]. When the returned |
| 19 /// future completes with a [PoolResource], the resource may be allocated. Once | 19 /// future completes with a [PoolResource], the resource may be allocated. Once |
| 20 /// the resource has been released, the user should call [PoolResource.release]. | 20 /// the resource has been released, the user should call [PoolResource.release]. |
| 21 /// The pool will ensure that only a certain number of [PoolResource]s may be | 21 /// The pool will ensure that only a certain number of [PoolResource]s may be |
| 22 /// allocated at once. | 22 /// allocated at once. |
| (...skipping 109 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 132 /// Tells the parent [Pool] that the resource associated with this resource is | 132 /// Tells the parent [Pool] that the resource associated with this resource is |
| 133 /// no longer allocated, and that a new [PoolResource] may be allocated. | 133 /// no longer allocated, and that a new [PoolResource] may be allocated. |
| 134 void release() { | 134 void release() { |
| 135 if (_released) { | 135 if (_released) { |
| 136 throw new StateError("A PoolResource may only be released once."); | 136 throw new StateError("A PoolResource may only be released once."); |
| 137 } | 137 } |
| 138 _released = true; | 138 _released = true; |
| 139 _pool._onResourceReleased(); | 139 _pool._onResourceReleased(); |
| 140 } | 140 } |
| 141 } | 141 } |
| OLD | NEW |