1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
/* ****************************************************************************
*
* Copyright (c) Microsoft Corporation.
*
* This source code is subject to terms and conditions of the Microsoft Public License. A
* copy of the license can be found in the License.html file at the root of this distribution. If
* you cannot locate the Microsoft Public License, please send an email to
* dlr@microsoft.com. By using this source code in any fashion, you are agreeing to be bound
* by the terms of the Microsoft Public License.
*
* You must not remove this notice, or any other, from this software.
*
*
* ***************************************************************************/
using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Dynamic;
using System.Security.Permissions;
using System.Text;
using Microsoft.Scripting.Utils;
namespace Microsoft.Scripting.Hosting {
/// <summary>
/// ScriptHost is collocated with ScriptRuntime in the same app-domain.
/// The host can implement a derived class to consume some notifications and/or
/// customize operations like TryGetSourceUnit,ResolveSourceUnit, etc.
///
/// The areguments to the the constructor of the derived class are specified in ScriptRuntimeSetup
/// instance that enters ScriptRuntime initialization.
///
/// If the host is remote with respect to DLR (i.e. also with respect to ScriptHost)
/// and needs to access objects living in its app-domain it can pass MarshalByRefObject
/// as an argument to its ScriptHost subclass constructor.
/// </summary>
public class ScriptHost
#if !SILVERLIGHT
: MarshalByRefObject
#endif
{
/// <summary>
/// The runtime the host is attached to.
/// </summary>
private ScriptRuntime _runtime;
public ScriptHost() {
}
// Called by ScriptRuntime when it is completely initialized.
// Notifies the host implementation that the runtime is available now.
internal void SetRuntime(ScriptRuntime runtime) {
Assert.NotNull(runtime);
_runtime = runtime;
RuntimeAttached();
}
public ScriptRuntime Runtime {
get {
if (_runtime == null) {
throw new InvalidOperationException("Host not initialized");
}
return _runtime;
}
}
public virtual PlatformAdaptationLayer PlatformAdaptationLayer {
get {
return PlatformAdaptationLayer.Default;
}
}
#region Notifications
/// <summary>
/// Invoked after the initialization of the associated Runtime is finished.
/// The host can override this method to perform additional initialization of runtime (like loading assemblies etc.).
/// </summary>
protected virtual void RuntimeAttached() {
// nop
}
/// <summary>
/// Invoked after a new language is loaded into the Runtime.
/// The host can override this method to perform additional initialization of language engines.
/// </summary>
internal protected virtual void EngineCreated(ScriptEngine engine) {
// nop
}
#endregion
#if !SILVERLIGHT
// TODO: Figure out what is the right lifetime
[SecurityPermission(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
public override object InitializeLifetimeService() {
return null;
}
#endif
}
}
|
