blob: 136f52b05fe126ff565fb62f76112b773d32b184 (
plain) (
blame)
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
|
package scala.reflect
package api
/** A mirror establishes connections of
* runtime entities such as class names and object instances
* with a refexive universe.
*/
trait Mirror extends Universe with RuntimeTypes with TreeBuildUtil {
/** The Scala class symbol that has given fully qualified name
* @param name The fully qualified name of the class to be returned
* @throws java.lang.ClassNotFoundException if no class wiht that name exists
* to do: throws anything else?
*/
def classWithName(name: String): Symbol
/** Return a reference to the companion object of this class symbol
*/
def getCompanionObject(clazz: Symbol): AnyRef
/** The Scala class symbol corresponding to the runtime class of given object
* @param The object from which the class is returned
* @throws ?
*/
def getClass(obj: AnyRef): Symbol
/** The Scala type corresponding to the runtime type of given object.
* If the underlying class is parameterized, this will be an existential type,
* with unknown type arguments.
*
* @param The object from which the type is returned
* @throws ?
*/
def getType(obj: AnyRef): Type
/** The value of a field on a receiver instance.
* @param receiver The receiver instance
* @param field The field
* @return The value contained in `receiver.field`.
*/
def getValue(receiver: AnyRef, field: Symbol): Any
/** Sets the value of a field on a receiver instance.
* @param receiver The receiver instance
* @param field The field
* @param value The new value to be stored in the field.
*/
def setValue(receiver: AnyRef, field: Symbol, value: Any): Unit
/** Invokes a method on a reciver instance with some arguments
* @param receiver The receiver instance
* @param meth The method
* @param args The method call's arguments
* @return The result of invoking `receiver.meth(args)`
*/
def invoke(receiver: AnyRef, meth: Symbol, args: Any*): Any
/** Maps a Java class to a Scala type reference
* @param clazz The Java class object
* @return A type (of kind `TypeRef`, or `ExistentialType` if `clazz` is polymorphic)
* that represents the class with all type parameters unknown
* (i.e. any type parameters of `clazz` are existentially quantified).
* */
def classToType(clazz: java.lang.Class[_]): Type
/** Maps a Java class to a Scala class symbol
* @param clazz The Java class object
* @return A symbol that represents the Scala view of the class.
*/
def classToSymbol(clazz: java.lang.Class[_]): Symbol
/** Maps a Scala type to the corresponding Java class object
*/
def typeToClass(tpe: Type): java.lang.Class[_]
/** Maps a Scala symbol to the corresponding Java class object
* @throws ClassNotFoundException if there is no Java class
* corresponding to the given Scala symbol.
* Note: If the Scala symbol is ArrayClass, a ClassNotFound exception is thrown
* because there is no unique Java class corresponding to a Scala generic array
*/
def symbolToClass(sym: Symbol): java.lang.Class[_]
}
|