mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
72 lines
2.3 KiB
Dart
72 lines
2.3 KiB
Dart
// Copyright 2013 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
part of dart.ui;
|
|
|
|
/// A wrapper for a raw callback handle.
|
|
///
|
|
/// This is the return type for [PluginUtilities.getCallbackHandle].
|
|
class CallbackHandle {
|
|
/// Create an instance using a raw callback handle.
|
|
///
|
|
/// Only values produced by a call to [CallbackHandle.toRawHandle] should be
|
|
/// used, otherwise this object will be an invalid handle.
|
|
CallbackHandle.fromRawHandle(this._handle)
|
|
: assert(_handle != null, "'_handle' must not be null.");
|
|
|
|
final int _handle;
|
|
|
|
/// Get the raw callback handle to pass over a [MethodChannel] or [SendPort]
|
|
/// (to pass to another [Isolate]).
|
|
int toRawHandle() => _handle;
|
|
|
|
@override
|
|
bool operator ==(dynamic other) {
|
|
if (runtimeType != other.runtimeType)
|
|
return false;
|
|
final CallbackHandle typedOther = other;
|
|
return _handle == typedOther._handle;
|
|
}
|
|
|
|
@override
|
|
int get hashCode => _handle.hashCode;
|
|
}
|
|
|
|
/// Functionality for Flutter plugin authors.
|
|
///
|
|
/// See also:
|
|
///
|
|
/// * [IsolateNameServer], which provides utilities for dealing with
|
|
/// [Isolate]s.
|
|
class PluginUtilities {
|
|
// This class is only a namespace, and should not be instantiated or
|
|
// extended directly.
|
|
factory PluginUtilities._() => null;
|
|
|
|
/// Get a handle to a named top-level or static callback function which can
|
|
/// be easily passed between isolates.
|
|
///
|
|
/// The `callback` argument must not be null.
|
|
///
|
|
/// Returns a [CallbackHandle] that can be provided to
|
|
/// [PluginUtilities.getCallbackFromHandle] to retrieve a tear-off of the
|
|
/// original callback. If `callback` is not a top-level or static function,
|
|
/// null is returned.
|
|
static CallbackHandle getCallbackHandle(Function callback) {
|
|
throw UnimplementedError();
|
|
}
|
|
|
|
/// Get a tear-off of a named top-level or static callback represented by a
|
|
/// handle.
|
|
///
|
|
/// The `handle` argument must not be null.
|
|
///
|
|
/// If `handle` is not a valid handle returned by
|
|
/// [PluginUtilities.getCallbackHandle], null is returned. Otherwise, a
|
|
/// tear-off of the callback associated with `handle` is returned.
|
|
static Function getCallbackFromHandle(CallbackHandle handle) {
|
|
throw UnimplementedError();
|
|
}
|
|
}
|