##// END OF EJS Templates
Reconnect when the websocket connection closes unexpectedly
Roy Hyunjin Han -
Show More
@@ -1,387 +1,386 b''
1 1 //----------------------------------------------------------------------------
2 2 // Copyright (C) 2008-2011 The IPython Development Team
3 3 //
4 4 // Distributed under the terms of the BSD License. The full license is in
5 5 // the file COPYING, distributed as part of this software.
6 6 //----------------------------------------------------------------------------
7 7
8 8 //============================================================================
9 9 // Kernel
10 10 //============================================================================
11 11
12 12 var IPython = (function (IPython) {
13 13
14 14 var utils = IPython.utils;
15 15
16 16 // Initialization and connection.
17 17
18 18 var Kernel = function (base_url) {
19 19 this.kernel_id = null;
20 20 this.shell_channel = null;
21 21 this.iopub_channel = null;
22 22 this.base_url = base_url;
23 23 this.running = false;
24 24 this.username = "username";
25 25 this.session_id = utils.uuid();
26 26 this._msg_callbacks = {};
27 27
28 28 if (typeof(WebSocket) !== 'undefined') {
29 29 this.WebSocket = WebSocket;
30 30 } else if (typeof(MozWebSocket) !== 'undefined') {
31 31 this.WebSocket = MozWebSocket;
32 32 } else {
33 33 alert('Your browser does not have WebSocket support, please try Chrome, Safari or Firefox β‰₯ 6. Firefox 4 and 5 are also supported by you have to enable WebSockets in about:config.');
34 34 };
35 35 };
36 36
37 37
38 38 Kernel.prototype._get_msg = function (msg_type, content) {
39 39 var msg = {
40 40 header : {
41 41 msg_id : utils.uuid(),
42 42 username : this.username,
43 43 session : this.session_id,
44 44 msg_type : msg_type
45 45 },
46 46 content : content,
47 47 parent_header : {}
48 48 };
49 49 return msg;
50 50 };
51 51
52 52 Kernel.prototype.start = function (notebook_id) {
53 53 var that = this;
54 54 if (!this.running) {
55 55 var qs = $.param({notebook:notebook_id});
56 56 var url = this.base_url + '?' + qs;
57 57 $.post(url,
58 58 $.proxy(that._kernel_started,that),
59 59 'json'
60 60 );
61 61 };
62 62 };
63 63
64 64
65 65 Kernel.prototype.restart = function () {
66 66 $([IPython.events]).trigger('status_restarting.Kernel');
67 67 var that = this;
68 68 if (this.running) {
69 69 this.stop_channels();
70 70 var url = this.kernel_url + "/restart";
71 71 $.post(url,
72 72 $.proxy(that._kernel_started, that),
73 73 'json'
74 74 );
75 75 };
76 76 };
77 77
78 78
79 79 Kernel.prototype._kernel_started = function (json) {
80 80 console.log("Kernel started: ", json.kernel_id);
81 81 this.running = true;
82 82 this.kernel_id = json.kernel_id;
83 83 this.ws_url = json.ws_url;
84 84 this.kernel_url = this.base_url + "/" + this.kernel_id;
85 85 this.start_channels();
86 86 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply,this);
87 87 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_reply,this);
88 88 };
89 89
90 90
91 91 Kernel.prototype._websocket_closed = function(ws_url, early){
92 92 var msg;
93 93 var parent_item = $('body');
94 94 if (early) {
95 95 msg = "Websocket connection to " + ws_url + " could not be established." +
96 96 " You will NOT be able to run code." +
97 97 " Your browser may not be compatible with the websocket version in the server," +
98 98 " or if the url does not look right, there could be an error in the" +
99 99 " server's configuration.";
100 100 } else {
101 msg = "Websocket connection closed unexpectedly." +
102 " The kernel will no longer be responsive.";
103 }
101 this.start_channels();
102 }
104 103 var dialog = $('<div/>');
105 104 dialog.html(msg);
106 105 parent_item.append(dialog);
107 106 dialog.dialog({
108 107 resizable: false,
109 108 modal: true,
110 109 title: "Websocket closed",
111 110 closeText: "",
112 111 close: function(event, ui) {$(this).dialog('destroy').remove();},
113 112 buttons : {
114 113 "OK": function () {
115 114 $(this).dialog('close');
116 115 }
117 116 }
118 117 });
119 118
120 119 };
121 120
122 121 Kernel.prototype.start_channels = function () {
123 122 var that = this;
124 123 this.stop_channels();
125 124 var ws_url = this.ws_url + this.kernel_url;
126 125 console.log("Starting WS:", ws_url);
127 126 this.shell_channel = new this.WebSocket(ws_url + "/shell");
128 127 this.iopub_channel = new this.WebSocket(ws_url + "/iopub");
129 128 send_cookie = function(){
130 129 this.send(document.cookie);
131 130 };
132 131 var already_called_onclose = false; // only alert once
133 132 ws_closed_early = function(evt){
134 133 if (already_called_onclose){
135 134 return;
136 135 }
137 136 already_called_onclose = true;
138 137 if ( ! evt.wasClean ){
139 138 that._websocket_closed(ws_url, true);
140 139 }
141 140 };
142 141 ws_closed_late = function(evt){
143 142 if (already_called_onclose){
144 143 return;
145 144 }
146 145 already_called_onclose = true;
147 146 if ( ! evt.wasClean ){
148 147 that._websocket_closed(ws_url, false);
149 148 }
150 149 };
151 150 this.shell_channel.onopen = send_cookie;
152 151 this.shell_channel.onclose = ws_closed_early;
153 152 this.iopub_channel.onopen = send_cookie;
154 153 this.iopub_channel.onclose = ws_closed_early;
155 154 // switch from early-close to late-close message after 1s
156 155 setTimeout(function(){
157 156 that.shell_channel.onclose = ws_closed_late;
158 157 that.iopub_channel.onclose = ws_closed_late;
159 158 }, 1000);
160 159 };
161 160
162 161
163 162 Kernel.prototype.stop_channels = function () {
164 163 if (this.shell_channel !== null) {
165 164 this.shell_channel.onclose = function (evt) {};
166 165 this.shell_channel.close();
167 166 this.shell_channel = null;
168 167 };
169 168 if (this.iopub_channel !== null) {
170 169 this.iopub_channel.onclose = function (evt) {};
171 170 this.iopub_channel.close();
172 171 this.iopub_channel = null;
173 172 };
174 173 };
175 174
176 175 // Main public methods.
177 176
178 177 Kernel.prototype.object_info_request = function (objname, callbacks) {
179 178 // When calling this method pass a callbacks structure of the form:
180 179 //
181 180 // callbacks = {
182 181 // 'object_info_reply': object_into_reply_callback
183 182 // }
184 183 //
185 184 // The object_info_reply_callback will be passed the content object of the
186 185 // object_into_reply message documented here:
187 186 //
188 187 // http://ipython.org/ipython-doc/dev/development/messaging.html#object-information
189 188 if(typeof(objname)!=null && objname!=null)
190 189 {
191 190 var content = {
192 191 oname : objname.toString(),
193 192 };
194 193 var msg = this._get_msg("object_info_request", content);
195 194 this.shell_channel.send(JSON.stringify(msg));
196 195 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
197 196 return msg.header.msg_id;
198 197 }
199 198 return;
200 199 }
201 200
202 201 Kernel.prototype.execute = function (code, callbacks, options) {
203 202 // The options object should contain the options for the execute call. Its default
204 203 // values are:
205 204 //
206 205 // options = {
207 206 // silent : true,
208 207 // user_variables : [],
209 208 // user_expressions : {},
210 209 // allow_stdin : false
211 210 // }
212 211 //
213 212 // When calling this method pass a callbacks structure of the form:
214 213 //
215 214 // callbacks = {
216 215 // 'execute_reply': execute_reply_callback,
217 216 // 'output': output_callback,
218 217 // 'clear_output': clear_output_callback,
219 218 // 'set_next_input': set_next_input_callback
220 219 // }
221 220 //
222 221 // The execute_reply_callback will be passed the content object of the execute_reply
223 222 // message documented here:
224 223 //
225 224 // http://ipython.org/ipython-doc/dev/development/messaging.html#execute
226 225 //
227 226 // The output_callback will be passed msg_type ('stream','display_data','pyout','pyerr')
228 227 // of the output and the content object of the PUB/SUB channel that contains the
229 228 // output:
230 229 //
231 230 // http://ipython.org/ipython-doc/dev/development/messaging.html#messages-on-the-pub-sub-socket
232 231 //
233 232 // The clear_output_callback will be passed a content object that contains
234 233 // stdout, stderr and other fields that are booleans.
235 234 //
236 235 // The set_next_input_callback will bepassed the text that should become the next
237 236 // input cell.
238 237
239 238 var content = {
240 239 code : code,
241 240 silent : true,
242 241 user_variables : [],
243 242 user_expressions : {},
244 243 allow_stdin : false
245 244 };
246 245 $.extend(true, content, options)
247 246 var msg = this._get_msg("execute_request", content);
248 247 this.shell_channel.send(JSON.stringify(msg));
249 248 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
250 249 return msg.header.msg_id;
251 250 };
252 251
253 252
254 253 Kernel.prototype.complete = function (line, cursor_pos, callbacks) {
255 254 // When calling this method pass a callbacks structure of the form:
256 255 //
257 256 // callbacks = {
258 257 // 'complete_reply': complete_reply_callback
259 258 // }
260 259 //
261 260 // The complete_reply_callback will be passed the content object of the
262 261 // complete_reply message documented here:
263 262 //
264 263 // http://ipython.org/ipython-doc/dev/development/messaging.html#complete
265 264 callbacks = callbacks || {};
266 265 var content = {
267 266 text : '',
268 267 line : line,
269 268 cursor_pos : cursor_pos
270 269 };
271 270 var msg = this._get_msg("complete_request", content);
272 271 this.shell_channel.send(JSON.stringify(msg));
273 272 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
274 273 return msg.header.msg_id;
275 274 };
276 275
277 276
278 277 Kernel.prototype.interrupt = function () {
279 278 if (this.running) {
280 279 $([IPython.events]).trigger('status_interrupting.Kernel');
281 280 $.post(this.kernel_url + "/interrupt");
282 281 };
283 282 };
284 283
285 284
286 285 Kernel.prototype.kill = function () {
287 286 if (this.running) {
288 287 this.running = false;
289 288 var settings = {
290 289 cache : false,
291 290 type : "DELETE"
292 291 };
293 292 $.ajax(this.kernel_url, settings);
294 293 };
295 294 };
296 295
297 296
298 297 // Reply handlers.
299 298
300 299 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
301 300 var callbacks = this._msg_callbacks[msg_id];
302 301 return callbacks;
303 302 };
304 303
305 304
306 305 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
307 306 this._msg_callbacks[msg_id] = callbacks || {};
308 307 }
309 308
310 309
311 310 Kernel.prototype._handle_shell_reply = function (e) {
312 311 reply = $.parseJSON(e.data);
313 312 var header = reply.header;
314 313 var content = reply.content;
315 314 var msg_type = header.msg_type;
316 315 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
317 316 if (callbacks !== undefined) {
318 317 var cb = callbacks[msg_type];
319 318 if (cb !== undefined) {
320 319 cb(content);
321 320 }
322 321 };
323 322
324 323 if (content.payload !== undefined) {
325 324 var payload = content.payload || [];
326 325 this._handle_payload(callbacks, payload);
327 326 }
328 327 };
329 328
330 329
331 330 Kernel.prototype._handle_payload = function (callbacks, payload) {
332 331 var l = payload.length;
333 332 // Payloads are handled by triggering events because we don't want the Kernel
334 333 // to depend on the Notebook or Pager classes.
335 334 for (var i=0; i<l; i++) {
336 335 if (payload[i].source === 'IPython.zmq.page.page') {
337 336 var data = {'text':payload[i].text}
338 337 $([IPython.events]).trigger('open_with_text.Pager', data);
339 338 } else if (payload[i].source === 'IPython.zmq.zmqshell.ZMQInteractiveShell.set_next_input') {
340 339 if (callbacks.set_next_input !== undefined) {
341 340 callbacks.set_next_input(payload[i].text)
342 341 }
343 342 }
344 343 };
345 344 };
346 345
347 346
348 347 Kernel.prototype._handle_iopub_reply = function (e) {
349 348 reply = $.parseJSON(e.data);
350 349 var content = reply.content;
351 350 var msg_type = reply.header.msg_type;
352 351 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
353 352 if (msg_type !== 'status' && callbacks === undefined) {
354 353 // Message not from one of this notebook's cells and there are no
355 354 // callbacks to handle it.
356 355 return;
357 356 }
358 357 var output_types = ['stream','display_data','pyout','pyerr'];
359 358 if (output_types.indexOf(msg_type) >= 0) {
360 359 var cb = callbacks['output'];
361 360 if (cb !== undefined) {
362 361 cb(msg_type, content);
363 362 }
364 363 } else if (msg_type === 'status') {
365 364 if (content.execution_state === 'busy') {
366 365 $([IPython.events]).trigger('status_busy.Kernel');
367 366 } else if (content.execution_state === 'idle') {
368 367 $([IPython.events]).trigger('status_idle.Kernel');
369 368 } else if (content.execution_state === 'dead') {
370 369 this.stop_channels();
371 370 $([IPython.events]).trigger('status_dead.Kernel');
372 371 };
373 372 } else if (msg_type === 'clear_output') {
374 373 var cb = callbacks['clear_output'];
375 374 if (cb !== undefined) {
376 375 cb(content);
377 376 }
378 377 };
379 378 };
380 379
381 380
382 381 IPython.Kernel = Kernel;
383 382
384 383 return IPython;
385 384
386 385 }(IPython));
387 386
General Comments 0
You need to be logged in to leave comments. Login now