Reflection on Host Types
Alpha - subject to change.

Two main entry points: 

* type-reflect reflects on something that implements TypeReference.
* reflect (for REPL use) reflects on the class of an instance, or
  on a class if passed a class

Key features:

* Exposes the read side of reflection as pure data. Reflecting
  on a type returns a map with keys :bases, :flags, and :members.

* Canonicalizes class names as Clojure symbols. Types can extend
  to the TypeReference protocol to indicate that they can be
  unambiguously resolved as a type name. The canonical format
  requires one non-Java-ish convention: array brackets are <>
  instead of [] so they can be part of a Clojure symbol.

* Pluggable Reflectors for different implementations. The default
  JavaReflector is good when you have a class in hand, or use
  the AsmReflector for "hands off" reflection without forcing
  classes to load.

Platform implementers must:

* Create an implementation of Reflector.
* Create one or more implementations of TypeReference.
* def default-reflector to be an instance that satisfies Reflector.

Added in Clojure version 1.3

Protocols

ClassResolver

Protocol

Known implementations: clojure.lang.Fn, java.lang.ClassLoader

resolve-class

function

Usage: (resolve-class this name)

Given a class name, return that typeref's class bytes as an InputStream.

Source

Reflector

Protocol

Protocol for reflection implementers.

Known implementations: AsmReflector, JavaReflector

do-reflect

function

Usage: (do-reflect reflector typeref)

Source

TypeReference

Protocol

A TypeReference can be unambiguously converted to a type name on
the host platform.

All typerefs are normalized into symbols. If you need to
normalize a typeref yourself, call typesym.

Known implementations: clojure.asm.Type, clojure.lang.Symbol, java.lang.Class

typename

function

Usage: (typename o)

Returns Java name as returned by ASM getClassName, e.g. byte[], java.lang.String[]

Source

Types

AsmReflector

type

Fields: [class-resolver]
Protocols: Reflector
Interfaces:

Constructor

record

Fields: [name declaring-class parameter-types exception-types flags]
Protocols:
Interfaces: clojure.lang.IHashEq, clojure.lang.IKeywordLookup, clojure.lang.ILookup, clojure.lang.IObj, clojure.lang.IPersistentMap, java.io.Serializable, java.util.Map

Field

record

Fields: [name type declaring-class flags]
Protocols:
Interfaces: clojure.lang.IHashEq, clojure.lang.IKeywordLookup, clojure.lang.ILookup, clojure.lang.IObj, clojure.lang.IPersistentMap, java.io.Serializable, java.util.Map

JavaReflector

type

Fields: [classloader]
Protocols: Reflector
Interfaces:

Method

record

Fields: [name return-type declaring-class parameter-types exception-types flags]
Protocols:
Interfaces: clojure.lang.IHashEq, clojure.lang.IKeywordLookup, clojure.lang.ILookup, clojure.lang.IObj, clojure.lang.IPersistentMap, java.io.Serializable, java.util.Map

Public Variables and Functions

->AsmReflector

function

Usage: (->AsmReflector class-resolver)

Positional factory function for class clojure.reflect.AsmReflector.

Source

->Constructor

function

Usage: (->Constructor name declaring-class parameter-types exception-types flags)

Positional factory function for class clojure.reflect.Constructor.

Source

->Field

function

Usage: (->Field name type declaring-class flags)

Positional factory function for class clojure.reflect.Field.

Source

->JavaReflector

function

Usage: (->JavaReflector classloader)

Positional factory function for class clojure.reflect.JavaReflector.

Source

->Method

function

Usage: (->Method name return-type declaring-class parameter-types exception-types flags)

Positional factory function for class clojure.reflect.Method.

Source

flag-descriptors

var

The Java access bitflags, along with their friendly names and
the kinds of objects to which they can apply.

Source

map->Constructor

function

Usage: (map->Constructor m#)

Factory function for class clojure.reflect.Constructor, taking a map of keywords to field values.

Source

map->Field

function

Usage: (map->Field m#)

Factory function for class clojure.reflect.Field, taking a map of keywords to field values.

Source

map->Method

function

Usage: (map->Method m#)

Factory function for class clojure.reflect.Method, taking a map of keywords to field values.

Source

reflect

function

Usage: (reflect obj & options)

Alpha - subject to change.
Reflect on the type of obj (or obj itself if obj is a class).
Return value and options are the same as for type-reflect.

Added in Clojure version 1.3
Source

type-reflect

function

Usage: (type-reflect typeref & options)

Alpha - subject to change.
 Reflect on a typeref, returning a map with :bases, :flags, and
:members. In the discussion below, names are always Clojure symbols.

 :bases            a set of names of the type's bases
 :flags            a set of keywords naming the boolean attributes
                   of the type.
 :members          a set of the type's members. Each member is a map
                   and can be a constructor, method, or field.

 Keys common to all members:
 :name             name of the type 
 :declaring-class  name of the declarer
 :flags            keyword naming boolean attributes of the member

 Keys specific to constructors:
 :parameter-types  vector of parameter type names
 :exception-types  vector of exception type names

 Key specific to methods:
 :parameter-types  vector of parameter type names
 :exception-types  vector of exception type names
 :return-type      return type name

 Keys specific to fields:
 :type             type name

 Options:

   :ancestors     in addition to the keys described above, also
                  include an :ancestors key with the entire set of
                  ancestors, and add all ancestor members to
                  :members.
   :reflector     implementation to use. Defaults to JavaReflector,
                  AsmReflector is also an option.

Added in Clojure version 1.3
Source

Logo & site design by Tom Hickey.
Clojure auto-documentation system by Tom Faulhaber.

GeezerVison

Clojure Core API Reference

Table of Contents

API for clojure.reflect - Clojure v1.12.4 (stable)

Overview

Protocols

ClassResolver

resolve-class

Reflector

do-reflect

TypeReference

typename

Types

AsmReflector

Constructor

Field

JavaReflector

Method

Public Variables and Functions

->AsmReflector

->Constructor

->Field

->JavaReflector

->Method

flag-descriptors

map->Constructor

map->Field

map->Method

reflect

type-reflect