Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(248)

Unified Diff: pkg/polymer/lib/boot.dart

Issue 225043004: Replace bootstrap logic with 'boot.js', use 'component/dart' mime-type and add (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Created 6 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: pkg/polymer/lib/boot.dart
diff --git a/pkg/polymer/lib/boot.dart b/pkg/polymer/lib/boot.dart
new file mode 100644
index 0000000000000000000000000000000000000000..652709d7e642e9e75b69657cb650d0866b8e62a7
--- /dev/null
+++ b/pkg/polymer/lib/boot.dart
@@ -0,0 +1,170 @@
+// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+/// Bootstrap to initialize polymer applications. This library is not in use
+/// yet but it will replace boot.js in the near future (see dartbug.com/18007).
+///
+/// This script contains logic to bootstrap polymer apps during development. It
+/// internally discovers special Dart script tags through HTML imports, and
+/// constructs a new entrypoint for the application that is then launched in an
+/// isolate.
+///
+/// For each script tag found, we will load the corresponding Dart library and
+/// execute all methods annotated with `@initMethod` and register all classes
+/// labeled with `@CustomTag`. We keep track of the order of imports and execute
+/// initializers in the same order.
+///
+/// All polymer applications use this bootstrap logic. It is included
+/// automatically when you include the polymer.html import:
+///
+/// <link rel="import" href="packages/polymer/polymer.html">
+///
+/// There are two important changes compared to previous versions of polymer
+/// (0.10.0-pre.6 and older):
+///
+/// * Use 'application/dart;component=1' instead of 'application/dart':
+/// Dartium already limits to have a single script tag per document, but it
+/// will be changing semantics soon and make them even stricter. Multiple
+/// script tags are not going to be running on the same isolate after this
+/// change. For polymer applications we'll use a parameter on the script tags
+/// mime-type to prevent Dartium from loading them separately. Instead this
+/// bootstrap script combines those special script tags and creates the
+/// application Dartium needs to run.
+///
+// If you had:
+///
+/// <polymer-element name="x-foo"> ...
+/// <script type="application/dart" src="x_foo.dart'></script>
+///
+/// Now you need to write:
+///
+/// <polymer-element name="x-foo"> ...
+/// <script type="application/dart;component=1" src="x_foo.dart'></script>
+///
+/// * `initPolymer` is gone: we used to initialize applications in two
+/// possible ways: using init.dart or invoking initPolymer in your main. Any
+/// of these initialization patterns can be replaced to use an `@initMethod`
+/// instead. For example, If you need to run some initialization code before
+/// any other code is executed, include a "application/dart;component=1"
+/// script tag that contains an initializer method with the body of your old
+/// main, and make sure this tag is placed above other html-imports that load
+/// the rest of the application. Initialization methods are executed in the
+/// order in which they are discovered in the HTML document.
+library polymer.src.boot;
+
+import 'dart:html';
+import 'dart:mirrors';
+
+main() {
+ var scripts = _discoverScripts(document, window.location.href);
+ var sb = new StringBuffer()..write('library bootstrap;\n\n');
+ int count = 0;
+ for (var s in scripts) {
+ sb.writeln("import '$s' as prefix_$count;");
+ count++;
+ }
+ sb.writeln("import 'package:polymer/src/mirror_loader.dart';");
+ sb.write('\nmain() => startPolymerInDevelopment([\n');
+ for (var s in scripts) {
+ sb.writeln(" '$s',");
+ }
+ sb.write(']);\n');
+ var isolateUri = _asDataUri(sb.toString());
+ spawnDomUri(Uri.parse(isolateUri), [], '');
+}
+
+/// Internal state used in [_discoverScripts].
+class _State {
+ /// Documents that we have visited thus far.
+ final Set<Document> seen = new Set();
+
+ /// Scripts that have been discovered, in tree order.
+ final List<String> scripts = [];
+
+ /// Whether we've seen a type="application/dart" script tag, since we expect
+ /// to have only one of those.
+ bool scriptSeen = false;
+}
+
+/// Walks the HTML import structure to discover all script tags that are
+/// implicitly loaded. This code is only used in Dartium and should only be
+/// called after all HTML imports are resolved. Polymer ensures this by asking
+/// users to put their Dart script tags after all HTML imports (this is checked
+/// by the linter, and Dartium will otherwise show an error message).
+List<String> _discoverScripts(Document doc, String baseUri, [_State state]) {
+ if (state == null) state = new _State();
+ if (doc == null) {
+ print('warning: $baseUri not found.');
+ return state.scripts;
+ }
+ if (!state.seen.add(doc)) return state.scripts;
+
+ for (var node in doc.querySelectorAll('script,link[rel="import"]')) {
+ if (node is LinkElement) {
+ _discoverScripts(node.import, node.href, state);
+ } else if (node is ScriptElement) {
+ if (node.type == 'application/dart;component=1') {
+ if (node.src != '' ||
+ node.text != "export 'package:polymer/boot.dart';") {
+ state.scripts.add(_getScriptUrl(node));
+ }
+ }
+
+ if (node.type == 'application/dart') {
+ if (state.scriptSeen) {
+ print('Dartium currently only allows a single Dart script tag '
+ 'per application, and in the future it will run them in '
+ 'separtate isolates. To prepare for this Dart script '
+ 'tags need to be updated to use the mime-type '
+ '"application/dart;component=1" instead of "application/dart":');
+ }
+ state.scriptSeen = true;
+ }
+ }
+ }
+ return state.scripts;
+}
+
+// TODO(sigmund): explore other (cheaper) ways to resolve URIs relative to the
+// root library (see dartbug.com/12612)
+final _rootUri = currentMirrorSystem().isolate.rootLibrary.uri;
+
+/// Returns a URI that can be used to load the contents of [script] in a Dart
+/// import. This is either the source URI if [script] has a `src` attribute, or
+/// a base64 encoded `data:` URI if the [script] contents are inlined.
+String _getScriptUrl(script) {
+ var uriString = script.src;
+ if (uriString != '') {
+ var uri = _rootUri.resolve(uriString);
+ if (!_isHttpStylePackageUrl(uri)) return '$uri';
+ // Use package: urls if available. This rule here is more permissive than
+ // how we translate urls in polymer-build, but we expect Dartium to limit
+ // the cases where there are differences. The polymer-build issues an error
+ // when using packages/ inside lib without properly stepping out all the way
+ // to the packages folder. If users don't create symlinks in the source
+ // tree, then Dartium will also complain because it won't find the file seen
+ // in an HTML import.
+ var packagePath = uri.path.substring(
+ uri.path.lastIndexOf('packages/') + 'packages/'.length);
+ return 'package:$packagePath';
+ }
+
+ return _asDataUri(script.text);
+}
+
+/// Whether [uri] is an http URI that contains a 'packages' segment, and
+/// therefore could be converted into a 'package:' URI.
+bool _isHttpStylePackageUrl(Uri uri) {
+ var uriPath = uri.path;
+ return uri.scheme == _rootUri.scheme &&
+ // Don't process cross-domain uris.
+ uri.authority == _rootUri.authority &&
+ uriPath.endsWith('.dart') &&
+ (uriPath.contains('/packages/') || uriPath.startsWith('packages/'));
+}
+
+/// Returns a base64 `data:` uri with the contents of [s].
+// TODO(sigmund): change back to application/dart: using text/javascript seems
+// wrong but it hides a warning in Dartium (dartbug.com/18000).
+_asDataUri(s) => 'data:text/javascript;base64,${window.btoa(s)}';

Powered by Google App Engine
This is Rietveld 408576698