`Uri` în Dart

O adresă web (URL) sau de fișier, desfăcută în părți: schemă, host, port, cale, parametri și fragment.

Sintaxă

static Uri parse(String uri, [int start = 0, int? end])
Uri({String? scheme, String? userInfo, String? host, int? port, String? path,
    Iterable<String>? pathSegments, String? query,
    Map<String, dynamic>? queryParameters, String? fragment})

Ce face `Uri`

Uri reprezintă o adresă ca https://dexblog.ro:443/invata/dart/?q=uri#exemple, desfăcută în părți: scheme (https), host, port, path, query și fragment (după #). Uri.parse(text) creează obiectul dintr-un text. La un text invalid aruncă FormatException; Uri.tryParse returnează null.

Constructorul Uri(...) face drumul invers: construiește adresa din părți și se ocupă singur de codificarea caracterelor speciale (spații, diacritice). toString() dă adresa completă. Obiectele Uri sunt imutabile; pentru modificări folosești replace.

Pentru parametrii din adresă vezi queryParameters, iar pentru adrese HTTPS construite rapid Uri.https.

Parametri

Parametru	Descriere
`uri`	La `parse`: textul adresei.
`scheme, host, port, path, ...`	La constructor: părțile adresei.

Ce returnează

Un obiect Uri.

Exemple

Exemplul 1: Desfacerea unei adrese

void main() {
  var u = Uri.parse('https://dexblog.ro:8443/invata/dart/uri/?q=adresa&pag=2#exemple');
  print(u.scheme);
  print(u.host);
  print(u.port);
  print(u.path);
  print(u.query);
  print(u.fragment);
  print(u.hasQuery);
  print(Uri.parse('https://dexblog.ro').port);
  print(Uri.tryParse('http://[gresit'));
}

Rezultat

https
dexblog.ro
8443
/invata/dart/uri/
q=adresa&pag=2
exemple
true
443
null

Exemplul 2: Construirea unei adrese din părți

Spațiile și diacriticele sunt codificate automat.

void main() {
  var u = Uri(
    scheme: 'https',
    host: 'exemplu.ro',
    path: '/cauta/orase',
    queryParameters: {'nume': 'Târgu Mureș', 'judet': 'MS'},
    fragment: 'rezultate',
  );
  print(u);
  print(u.queryParameters['nume']);
  var fisier = Uri.file('/home/ana/documente/raport final.pdf');
  print(fisier);
}