blob: 88107ea117d232ae3223a2cf64310782094e7011 (
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
|
package scala
package reflect
package api
/**
* <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span>
*
* A refinement of [[scala.reflect.api.Universe]] for runtime reflection using JVM classloaders.
*
* This refinement equips mirrors with reflection capabilities for the JVM. `JavaMirror` can
* convert Scala reflection artifacts (symbols and types) into Java reflection artifacts (classes)
* and vice versa. It can also perform reflective invocations (getting/setting field values,
* calling methods, etc).
*
* See the [[http://docs.scala-lang.org/overviews/reflection/overview.html Reflection Guide]] for details on how to use runtime reflection.
*
* @groupname JavaUniverse Java Mirrors
* @group ReflectionAPI
*
* @contentDiagram hideNodes "*Api"
*/
trait JavaUniverse extends Universe { self =>
/** In runtime reflection universes, runtime representation of a class is `java.lang.Class`.
* @group JavaMirrors
*/
type RuntimeClass = java.lang.Class[_]
implicit val RuntimeClassTag: ClassTag[RuntimeClass] = ClassTag[RuntimeClass](classOf[RuntimeClass])
/** In runtime reflection universes, mirrors are `JavaMirrors`.
* @group JavaMirrors
*/
override type Mirror >: Null <: JavaMirror
/** A refinement of [[scala.reflect.api.Mirror]] for runtime reflection using JVM classloaders.
*
* With this upgrade, mirrors become capable of converting Scala reflection artifacts (symbols and types)
* into Java reflection artifacts (classes) and vice versa. Consequently, refined mirrors
* become capable of performing reflective invocations (getting/setting field values, calling methods, etc).
*
* For more information about `Mirrors`s, see [[scala.reflect.api.Mirrors]] or the
* [[http://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html Reflection Guide: Mirrors]]
*
* @group JavaMirrors
*/
trait JavaMirror extends scala.reflect.api.Mirror[self.type] with RuntimeMirror {
val classLoader: ClassLoader
override def toString = s"JavaMirror with ${runtime.ReflectionUtils.show(classLoader)}"
}
/** Creates a runtime reflection mirror from a JVM classloader.
*
* For more information about `Mirrors`s, see [[scala.reflect.api.Mirrors]] or the
* [[http://docs.scala-lang.org/overviews/reflection/environment-universes-mirrors.html Reflection Guide: Mirrors]]
*
* @group JavaMirrors
*/
def runtimeMirror(cl: ClassLoader): Mirror
}
|
