languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-11-02 15:17:07 +00:00
Code Issues Projects Releases Packages Wiki Activity

Add the @protected annotation

Browse source 
R=ianh@google.com, pquitslund@google.com

Review URL: https://codereview.chromium.org/1706993002 .
This commit is contained in:
Brian Wilkerson 2016-02-18 07:51:27 -08:00
parent 3076bdf321
commit 8df095e6e0
1 changed files with 29 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
pkg/meta/lib/meta.dart
View file

@ -2,22 +2,33 @@
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
/**
* Constants for use in metadata annotations such as `@protected`.
*
* See also `@deprecated` and `@override` in the `dart:core` library.
*
* Annotations provide semantic information
* that tools can use to provide a better user experience.
* For example, an IDE might not autocomplete
* the name of a function that's been marked `@deprecated`,
* or it might display the function's name differently.
*
* For information on installing and importing this library, see the
* [meta package on pub.dartlang.org]
* (http://pub.dartlang.org/packages/meta).
* For examples of using annotations, see
* [Metadata](https://www.dartlang.org/docs/dart-up-and-running/ch02.html#metadata)
* in the language tour.
*/
/// Constants for use in metadata annotations such as `@protected`.
///
/// See also `@deprecated` and `@override` in the `dart:core` library.
///
/// Annotations provide semantic information that tools can use to provide a
/// better user experience. For example, an IDE might not autocomplete the name
/// of a function that's been marked `@deprecated`, or it might display the
/// function's name differently.
///
/// For information on installing and importing this library, see the
/// [meta package on pub.dartlang.org] (http://pub.dartlang.org/packages/meta).
/// For examples of using annotations, see
/// [Metadata](https://www.dartlang.org/docs/dart-up-and-running/ch02.html#metadata)
/// in the language tour.
library meta;
/// Used to annotate an instance method `m` in a class `C`. Indicates that `m`
/// should only be invoked from instance methods of `C` or classes that extend
/// or mix in `C`, either directly or indirectly. Additionally indicates that
/// `m` should only be invoked on `this`, whether explicitly or implicitly.
///
/// Tools, such as the analyzer, can provide feedback if an invocation of a
/// method marked as being protected is used outside of an instance method
/// defined on a class that extends or mixes in the class in which the protected
/// method is defined, or that uses a receiver other than `this`.
const _Protected protected = const _Protected();
class _Protected {
const _Protected();
}