Librerias En Dart

Librerias

En esta sección se explica cómo utilizar import (#import), include (#source), and library (#library) que puede ayudarle a crear una base de código modular y compartible. Las bibliotecas no sólo proporcionan API, pero son una unidad de la privacidad: se pueden ocultar detalles de implementación tales como las variables privadas.
Cada aplicación Dart es una Libreria. incluso si no utiliza #Libreria.
Use # import para especificar cómo un espacio de nombres de una biblioteca se utiliza en el ámbito de otra biblioteca.

Dart aplicaciones web en general, utilizar el dardo: html biblioteca, que importan de esta manera:

Código:

#import('dart:html');

El único argumento necesario para # import es un URI que especifica la biblioteca. Para incorporado en las bibliotecas, el URI tiene la especial de dardos: prefijo. Para otras bibliotecas, el URI puede ser relativo al directorio actual, o puede especificar un archivo en un servidor web. Por ejemplo:

Código:

#import('dart:io');
#import('mylib/mylib.dart');
#import('../../util/utilslib.dart');
#import('http://example.com/examplelib/examplelib.dart')

Especificación de los prefixes
Si se importan dos librerias que cuentan con identificadores en conflicto, entonces usted puede especificar un prefijo para una o ambas librerias. Por ejemplo, si Library1 y library2 tanto definir elemento, entonces usted podría tener un código como este:

Código:

#import('lib1/library1.dart');
#import('lib2/library2.dart', prefix:'lib2');
...
var element1 = new Element();      // utiliza los elementos de la libreria 1
var element2 = new lib2.Element(); // utiliza los elementos de la libreria 2

Ejecución de Librerias
Use # source (también conocido como una directiva include ) para especificar los archivos que forman parte de la librerías actual, y #librería para especificar que un archivo de una librería implementa.

Asociar un archivo con el actual de la biblioteca

Usted puede poner la implementación de su librería en los archivos de múltiples dardos. Mediante el uso de #source principal de la biblioteca. dardo de archivo.

Archivos incluidos no pueden tener directivas. Un solo archivo en cada biblioteca debe contar con todas las directivas (por ejemplo, # import y # librería) que la librería necesita.
Por ejemplo, considere el siguiente código:

Código:

// In Ballgame.dart:
#import('dart:html');

#source('Ball.dart');
#source('Util.dart');
...
main() {
  ...
}

Implementacion De Librerias
Use # source (también conocido como una directiva include ) para especificar los archivos que forman parte de la librería actual, y #libreria para especificar que un archivo de una biblioteca implementa.
Asociar un archivo con el actual de la biblioteca

Archivos incluidos no pueden tener directivas. Un solo archivo en cada libreria debe contar con todas las directivas (por ejemplo, # import y #libreria) que la libreria necesita.
Por ejemplo, considere el siguiente código:

Código:

// In Ballgame.dart:
#import('dart:html');

#source('Ball.dart');
#source('Util.dart');
...
main() {
  ...
}

Declaración de una Librería
Para declarar explícitamente una biblioteca, se utiliza #librarycomunicado. Por ejemplo:

Código:

#library('slider_sample');         
#import('dart:html');               
#import('../ui_lib/view/view.dart');
#source('SliderSample.dart');

Declaracion de miembro privados
Si un identificador comienza con un guión, que es privado de su biblioteca. Por ejemplo, en el siguiente código, la clase Incrementador tiene una variable de instancia llamada _hiddenNum .

Código:

#library('HidingLibrary');

class Incrementer {
  num _hiddenNum = 0;
 
  void incrementNum() {
    _hiddenNum++;
  }
 
  void printNum() {
    print("The hidden number is $_hiddenNum");
  }
}

void main() {
  var o = new Incrementer();
  print("We can read _hiddenNum (${o._hiddenNum}).");
}

El método main () puede referirse a _hiddenNum porque está en la misma biblioteca que Incrementador. Pero fuera de su biblioteca, _hiddenNum es invisible, incluso para las subclases de Incrementador.

Por ejemplo, el siguiente código no se puede utilizar _hiddenNum porque está en una biblioteca diferente de Incrementador (que se lleva a cabo en la biblioteca de HidingLib / hider.dart ):

Código:

#library('SubclassingLibrary');
#import('../HidingLib/hider.dart');

//This class is outside Incrementer's library, so it can't use _hiddenNum.
class DoubleIncrementer extends Incrementer {
  void incrementNum() {
    //_hiddenNum = _hiddenNum + 2; //cannot resolve _hiddenNum
    super.incrementNum();          //the only way to increment _hiddenNum
    super.incrementNum();
  }
}

Resumen De Librerias
Use # import si usted necesita usar una biblioteca, #source para tirar de los archivos en una libreria, y #library para declarar que se está implementando una libreria. Los nombres con el prefijo de subrayado (_) son privados de la biblioteca.