动态获取数据

What's the point?

  • Data on the web is often formatted in JSON.
  • JSON is text based and human readable.
  • The dart:convert library provides support for JSON.
  • Use HttpRequest to dynamically load data.

Web apps often useJSON(JavaScript Object Notation)to pass data between clients and servers.Data can be serialized into a JSON string,which is then passed between a client and server,and revived as an object at its destination.This tutorial shows you how to use functions in thedart:convertlibrary to produce and consume JSON data.Because JSON data is typically loaded dynamically,this tutorial also shows how a web appcan use an HTTP request to get data from an HTTP server.For web apps,HTTP requests are served by the browser in which the app is running,and thus are subject to the browser’s security restrictions.

备忘: This page uses embedded DartPads to display runnable examples. If you see empty boxes instead of DartPads, go to theDartPad troubleshooting page.

如果你只看到了空白的框框(而没有任何内容),请查阅DartPad 常见问题页面

About JSON

The JSON data format is easy for humansto write and read because it is lightweight and text based.With JSON, various data typesand simple data structures such as lists and mapscan be serialized and represented by strings.

Try it!The following app, its_all_about_you,displays the JSON string for data of various types.Click Run to start the app.Then change the values of the input elements,and check out the JSON format for each data type.You might prefer toopen the app in DartPadto have more space for the app’s code and UI.

The dart:convert library contains two convenient functionsfor working with JSON strings:
dart:convert functionDescription
json.decode()Builds Dart objects from a string containing JSON data.
json.encode()Serializes a Dart object into a JSON string.
To use these functions,you need to import dart:convert into your Dart code:
  1. import 'dart:convert';
The json.encode() and json.decode() functions can handle these Dart typesautomatically:- num- String- bool- Null- List- Map## Serializing data into JSONUse the json.encode() function to serialize an object that supports JSON.The showJson() function, from the example,converts all of the data to JSON strings.
  1. void showJson(Event ) { // Grab the data that will be converted to JSON. final favNum = int.tryParse(favoriteNumber.value); final pi = double.tryParse(valueOfPi.value); final chocolate = loveChocolate.checked; final sign = horoscope.value; final favoriteThings = <String>[ favOne.value, favTwo.value, favThree.value, ]; final formData = { 'favoriteNumber': favNum, 'valueOfPi': pi, 'chocolate': chocolate, 'horoscope': sign, 'favoriteThings': favoriteThings }; // Convert to JSON and display results. intAsJson.text = json.encode(favNum); doubleAsJson.text = json.encode(pi); boolAsJson.text = json.encode(chocolate); stringAsJson.text = json.encode(sign); listAsJson.text = json.encode(favoriteThings); mapAsJson.text = json.encode(formData);}
Shown below is the JSON string that results from the codeusing the original values from the app:The JSON string for the its_all_about_you app- Numeric and boolean valuesappear as they would if they were literal values in code,without quotes or other delineating marks.- A boolean value is either true or false.- The null value is represented as null.- Strings are contained within _double quotes.- A list is delineated with square brackets;its items are comma-separated.The list in this example contains strings.- A map is delineated with curly brackets;it contains comma-separated key/value pairs,where the key appears first, followed by a colon,followed by the value.In this example,the keys in the map are strings.The values in the map vary in type but they are all JSON-parsable.## Parsing JSON dataUse the json.decode() function from the dart:convert library tocreate Dart objects from a JSON string.The example initially populates the values in the formfrom this JSON string:
  1. final jsonDataAsString = '''{ "favoriteNumber": 73, "valueOfPi": 3.141592, "chocolate": true, "horoscope": "Cancer", "favoriteThings": ["monkeys", "parrots", "lattes"]}''';Map jsonData = json.decode(jsonDataAsString) as Map;
This code calls json.decode() with a properly formatted JSONstring.请注意: Dart strings can use either single or double quotes to denote strings. JSON requires double quotes.In this example, the full JSON string is hard coded into the Dart code,but it could be created by the form itselfor read from a static file or fetched from a server.An example later in this page shows how to dynamically fetchJSON data from a file that is co-located with the code for the app.The json.decode() function reads the string andbuilds Dart objects from it.In this example,the json.decode() function creates a Map object based onthe information in the JSON string.The Map contains objects of various typesincluding an integer, a double, a boolean value, a regular string,and a list.All of the keys in the map are strings.## About URIs and HTTP requestsTo make an HTTP GET request from within a web app,you need to provide a URI (Uniform Resource Identifier) for the resource.A URI is a character stringthat uniquely names a resource.A URL (Uniform Resource Locator) is a specific kind of URIthat also provides the location of a resource.URLs for resources on the World Wide Webcontain three pieces of information:- The protocol used for communication- The hostname of the server- The path to the resourceFor example, the URL for this page breaks down as follows:The tutorial URLThis URL specifies the HTTP protocol.When you enter an HTTP address into a web browser,the browser sends an HTTP GET request to a web server,and the web server sends an HTTP response that contains thecontents of the page (or an error message).Basic HTTP communication between client and serverMost HTTP requests in a web browser are simple GET requestsasking for the contents of a page.However, the HTTP protocol allows for other types of requests,such as POST for sending data from the client.A Dart web app running inside of a browser can make HTTP requests.These HTTP requests are handled by the browser in which the app is running.Even though the browser itself can make HTTP requests anywhere on the web,a Dart web app running inside the browser can make only limited_HTTP requests because of security restrictions.Practically speaking,because of these limitations,HTTP requests from web apps are primarily useful forretrieving information in files specific toand co-located with the app.Security note: Browsers place tight security restrictions on HTTP requests made by embedded apps. Specifically, any resources requested by a web app must be served from the same origin. That is, the resources must be from the same protocol, host, and port as the app itself. This means that your web app cannot request just any resource from the web with HTTP requests through the browser, even if that request is seemingly harmless (like a GET.)Some servers do allow cross-origin requests through a mechanism called CORS (Cross-origin resource sharing), which uses headers in an HTTP request to ask for and receive permission. CORS is server specific.The SDK provides these useful classes forformulating URIs and making HTTP requests:
Dart codeLibraryDescription
Uridart:coreUniform resource identifier
HttpRequestdart:htmlClient-side HTTP request object. For use in web apps.
HttpRequestdart:ioServer-side HTTP request object. Does not work in web apps.
## Using getString() to load a fileOne useful HTTP request your web app _can
make is a GET requestfor a data file served from the same origin as the app.The example below reads a data file called portmanteaux.jsonthat contains a JSON-formatted list of words.When you click the button,the app makes a GET request of the serverand loads the file.Implementation note: The original portmanteaux example loaded the co-located file portmanteaux.json. When we moved the example into DartPad, we couldn’t co-locate the JSON file because DartPad supports at most 3 files: one Dart file, one HTML file, and one CSS file. A workaround was to move portmanteaux.json to dart.dev and configure dart.dev’s CORS headers to allow read-only access from everywhere.Try it! Click Run and then click the Get portmanteaux button.This program uses a convenience method, getString(), provided by theHttpRequest class to request the file from the server.
  1. Future<void> makeRequest(Event _) async { const path = 'https://dart.dev/f/portmanteaux.json&#39;; try { // Make the GET request final jsonString = await HttpRequest.getString(path); // The request succeeded. Process the JSON. processResponse(jsonString); } catch (e) { // The GET request failed. Handle the error. // ··· }}void processResponse(String jsonString) { for (final portmanteau in json.decode(jsonString)) { wordList.children.add(LIElement()..text = portmanteau as String); }}
The getString() method uses a Future object to handle the request.A Future is a way to perform potentially time-consuming operations,such as HTTP requests, asynchronously.If you haven’t encountered futures yet,you can learn about them — as well as the async and await keywords — in theasynchronous programming codelab.Until then, you can use the code above as a guideand provide your own code for the body of the processResponse() functionand your own code to handle the error.## Using an HttpRequest object to load a fileThe getString() method is good for an HTTP GET request that returnsa string loaded from a resource.For other cases,you need to create an HttpRequest object,configure its header and other information,and use the send() method to make the request.This section rewrites the portmanteaux code to explicitly constructan HttpRequest object.

Setting up the HttpRequest object

The mouse-click handler for the buttoncreates an HttpRequest object,configures it with a URI and callback function,and then sends the request.Let’s take a look at the Dart code:

  1. Future<void> makeRequest(Event _) async {
  2. const path = 'https://dart.dev/f/portmanteaux.json';
  3. final httpRequest = HttpRequest();
  4. httpRequest
  5. ..open('GET', path)
  6. ..onLoadEnd.listen((e) => requestComplete(httpRequest))
  7. ..send('');
  8. }

Making an HTTP GET request

Sending the request

The send() method sends the request to the server.

  1. httpRequest.send('');

Because the request in this example is a simple GET request,the code can send an empty string.For other types of requests,such as POST requests,this string can contain relevant data.You can also configure the HttpRequest objectby setting various header parameters using the setRequestHeader() method.

Handling the response

To handle the HTTP response,you need to set up a callback functionbefore calling send().Our example sets up a one-line callback functionfor onLoadEnd eventsthat in turn calls requestComplete().This callback function is called when the request completes,either successfully or unsuccessfully.

Set up a callback function for request completion

The requestComplete() functionchecks the status code for the request.

  1. void requestComplete(HttpRequest request) {
  2. switch (request.status) {
  3. case 200:
  4. processResponse(request.responseText);
  5. return;
  6. default:
  7. // The GET request failed. Handle the error.
  8. // ···
  9. }
  10. }

If the status code is 200,the file was found and loaded successfully.The content of the requested file (portmanteaux.json) isreturned in the responseText property of an HttpRequest object.

Populating the UI from JSON

The data file in the portmanteaux example,portmanteaux.json,contains the following JSON-formatted list of strings:

  1. [
  2. "portmanteau", "fantabulous", "spork", "smog",
  3. "spanglish", "gerrymander", "turducken", "stagflation",
  4. "bromance", "freeware", "oxbridge", "palimony", "netiquette",
  5. "brunch", "blog", "chortle", "Hassenpfeffer", "Schnitzelbank"
  6. ]

Upon request, the server reads the fileand sends it as a single stringto the client program.

Using json.decode(),the app easily converts the JSON-formatted list of wordsto a Dart list of strings,creates a new LIElement for each one,and adds it to the <ul> element on the page.

  1. void processResponse(String jsonString) {
  2. for (final portmanteau in json.decode(jsonString)) {
  3. wordList.children.add(LIElement()..text = portmanteau as String);
  4. }
  5. }

Other resources