Programação de dardo - símbolo

Os símbolos no Dart são nomes de string opacos e dinâmicos usados ​​para refletir os metadados de uma biblioteca. Simplificando, os símbolos são uma forma de armazenar a relação entre uma string legível por humanos e uma string que é otimizada para ser usada por computadores.

Reflexão é um mecanismo para obter metadados de um tipo em tempo de execução, como o número de métodos em uma classe, o número de construtores que possui ou o número de parâmetros em uma função. Você pode até invocar um método do tipo que é carregado no tempo de execução.

Em classes específicas de reflexão Dart estão disponíveis no dart:mirrorspacote. Esta biblioteca funciona tanto em aplicativos da Web quanto em aplicativos de linha de comando.

Sintaxe

Symbol obj = new Symbol('name');  
// expects a name of class or function or library to reflect

o name deve ser um nome de membro Dart público válido, nome de construtor público ou nome de biblioteca.

Exemplo

Considere o seguinte exemplo. O código declara uma classeFoo numa biblioteca foo_lib. A classe define os métodosm1, m2, e m3.

Foo.dart

library foo_lib;   
// libarary name can be a symbol   

class Foo {         
   // class name can be a symbol  
   m1() {        
      // method name can be a symbol 
      print("Inside m1"); 
   } 
   m2() { 
      print("Inside m2"); 
   } 
   m3() { 
      print("Inside m3"); 
   } 
}

O seguinte código carrega Foo.dartbiblioteca e procura pela classe Foo, com ajuda do tipo Symbol. Como estamos refletindo os metadados da biblioteca acima, o código importadart:mirrors biblioteca.

FooSymbol.dart

import 'dart:core'; 
import 'dart:mirrors'; 
import 'Foo.dart';  

main() { 
   Symbol lib = new Symbol("foo_lib");   
   //library name stored as Symbol 
   
   Symbol clsToSearch = new Symbol("Foo");  
   // class name stored as Symbol  
   
   if(checkIf_classAvailableInlibrary(lib, clsToSearch))  
   // searches Foo class in foo_lib library 
      print("class found.."); 
}  
   
bool checkIf_classAvailableInlibrary(Symbol libraryName, Symbol className) { 
   MirrorSystem mirrorSystem = currentMirrorSystem(); 
   LibraryMirror libMirror = mirrorSystem.findLibrary(libraryName); 
      
   if (libMirror != null) { 
      print("Found Library"); 
      print("checkng...class details.."); 
      print("No of classes found is : ${libMirror.declarations.length}"); 
      libMirror.declarations.forEach((s, d) => print(s));  
         
      if (libMirror.declarations.containsKey(className)) return true; 
      return false; 
   } 
}

Observe que a linha libMirror.declarations.forEach ((s, d) => print (s)); irá iterar em cada declaração na biblioteca em tempo de execução e imprimir as declarações como tipo deSymbol.

Este código deve produzir o seguinte output -

Found Library 
checkng...class details.. 
No of classes found is : 1 
Symbol("Foo") // class name displayed as symbol  
class found.

Exemplo: exibir o número de métodos de instância de uma classe

Vamos agora considerar a exibição do número de métodos de instância em uma classe. A classe predefinidaClassMirror nos ajuda a conseguir o mesmo.

import 'dart:core'; 
import 'dart:mirrors'; 
import 'Foo.dart';  

main() { 
   Symbol lib = new Symbol("foo_lib"); 
   Symbol clsToSearch = new Symbol("Foo");  
   reflect_InstanceMethods(lib, clsToSearch); 
}  
void reflect_InstanceMethods(Symbol libraryName, Symbol className) { 
   MirrorSystem mirrorSystem = currentMirrorSystem(); 
   LibraryMirror libMirror = mirrorSystem.findLibrary(libraryName); 
   
   if (libMirror != null) { 
      print("Found Library"); 
      print("checkng...class details.."); 
      print("No of classes found is : ${libMirror.declarations.length}"); 
      libMirror.declarations.forEach((s, d) => print(s));  
      
      if (libMirror.declarations.containsKey(className)) print("found class");
      ClassMirror classMirror = libMirror.declarations[className]; 
      
      print("No of instance methods found is ${classMirror.instanceMembers.length}");
      classMirror.instanceMembers.forEach((s, v) => print(s)); 
   } 
}

Este código deve produzir o seguinte output -

Found Library 
checkng...class details.. 
No of classes found is : 1 
Symbol("Foo") 
found class 
No of instance methods found is 8 
Symbol("==") 
Symbol("hashCode") 
Symbol("toString") 
Symbol("noSuchMethod") 
Symbol("runtimeType") 
Symbol("m1") 
Symbol("m2") 
Symbol("m3")

Converter símbolo em string

Você pode converter o nome de um tipo como classe ou biblioteca armazenada em um símbolo de volta em string usando MirrorSystemclasse. O código a seguir mostra como você pode converter um símbolo em uma string.

import 'dart:mirrors'; 
void main(){ 
   Symbol lib = new Symbol("foo_lib"); 
   String name_of_lib = MirrorSystem.getName(lib); 
   
   print(lib); 
   print(name_of_lib); 
}

Deve produzir o seguinte output -

Symbol("foo_lib")   

foo_lib