jdbg

Documentation

Overview

Package jdbg provides a simpler interface to the jdwp package, offering simple type resolving and method invoking functions.

Index

• func Do(conn *jdwp.Connection, thread jdwp.ThreadID, f func(jdbg *JDbg) error) error
• type Array
  • func (t *Array) CastableTo(ty Type) bool
  • func (t *Array) New(size int) Value
  • func (t *Array) String() string
• type Class
  • func (t *Class) Call(method string, args ...interface{}) Value
  • func (t *Class) CastableTo(ty Type) bool
  • func (t *Class) Field(name string) Value
  • func (t *Class) New(args ...interface{}) Value
  • func (t *Class) Signature() string
  • func (t *Class) String() string
  • func (t *Class) Super() Type
• type Errors
  • func (l Errors) Error() string
• type JDbg
  • func (j *JDbg) ArrayOf(elTy Type) *Array
  • func (j *JDbg) BoolObjectType() *Class
  • func (j *JDbg) BoolType() *Simple
  • func (j *JDbg) ByteObjectType() *Class
  • func (j *JDbg) ByteType() *Simple
  • func (j *JDbg) CharObjectType() *Class
  • func (j *JDbg) CharType() *Simple
  • func (j *JDbg) Class(name string) *Class
  • func (j *JDbg) DoubleObjectType() *Class
  • func (j *JDbg) DoubleType() *Simple
  • func (j *JDbg) FloatObjectType() *Class
  • func (j *JDbg) FloatType() *Simple
  • func (j *JDbg) GetStackObject(name string) Value
  • func (j *JDbg) IntObjectType() *Class
  • func (j *JDbg) IntType() *Simple
  • func (j *JDbg) LongObjectType() *Class
  • func (j *JDbg) LongType() *Simple
  • func (j *JDbg) NumberType() *Class
  • func (j *JDbg) ObjectType() *Class
  • func (j *JDbg) SetStackObject(name string, val Value)
  • func (j *JDbg) ShortObjectType() *Class
  • func (j *JDbg) ShortType() *Simple
  • func (j *JDbg) String(val string) Value
  • func (j *JDbg) StringType() *Class
  • func (j *JDbg) This() Value
  • func (j *JDbg) Type(sig string) Type
• type Simple
  • func (t *Simple) Call(method string, args ...interface{}) Value
  • func (t *Simple) CastableTo(ty Type) bool
  • func (t *Simple) Signature() string
  • func (t *Simple) String() string
  • func (t *Simple) Super() Type
• type Type
• type Value
  • func (v Value) Call(method string, args ...interface{}) Value
  • func (v Value) Field(name string) Value
  • func (v Value) Get() interface{}
  • func (v Value) SetArrayValues(values interface{})
  • func (v Value) Type() Type

Functions

func Do

func Do(conn *jdwp.Connection, thread jdwp.ThreadID, f func(jdbg *JDbg) error) error

Do calls f with a JDbg instance, returning the error returned by f. If any JDWP errors are raised during the call to f, then execution of f is immediately terminated, and the JDWP error is returned.

Types

type Array

type Array struct {
	*Class
	// contains filtered or unexported fields
}

Array is the type of an array.

func (*Array) CastableTo

func (t *Array) CastableTo(ty Type) bool

CastableTo returns true if this type can be cast to ty.

func (*Array) New

func (t *Array) New(size int) Value

New constructs a new array of the specified size.

func (*Array) String

func (t *Array) String() string

type Class

type Class struct {
	// contains filtered or unexported fields
}

Class is the type of an object.

func (*Class) Call

func (t *Class) Call(method string, args ...interface{}) Value

Call invokes a static method on the class.

func (*Class) CastableTo

func (t *Class) CastableTo(ty Type) bool

CastableTo returns true if this type can be cast to ty.

func (*Class) Field

func (t *Class) Field(name string) Value

Field returns the value of the static field with the given name.

func (*Class) New

func (t *Class) New(args ...interface{}) Value

New returns a new instance of the class type using the specified parameters.

func (*Class) Signature

func (t *Class) Signature() string

Signature returns the Java signature for the type.

func (*Class) String

func (t *Class) String() string

func (*Class) Super

func (t *Class) Super() Type

Super returns the super type.

type Errors

type Errors []error

Errors is a collection of errors.

func (Errors) Error

func (l Errors) Error() string

type JDbg

type JDbg struct {
	// contains filtered or unexported fields
}

JDbg is a wrapper around a JDWP connection that provides an easier interface for usage.

func (*JDbg) ArrayOf

func (j *JDbg) ArrayOf(elTy Type) *Array

ArrayOf returns the type of the array with specified element type.

func (*JDbg) BoolObjectType

func (j *JDbg) BoolObjectType() *Class

BoolObjectType returns the Java java.lang.Boolean type.

func (*JDbg) BoolType

func (j *JDbg) BoolType() *Simple

BoolType returns the Java java.lang.Boolean type.

func (*JDbg) ByteObjectType

func (j *JDbg) ByteObjectType() *Class

ByteObjectType returns the Java java.lang.Byte type.

func (*JDbg) ByteType

func (j *JDbg) ByteType() *Simple

ByteType returns the Java byte type.

func (*JDbg) CharObjectType

func (j *JDbg) CharObjectType() *Class

CharObjectType returns the Java java.lang.Character type.

func (*JDbg) CharType

func (j *JDbg) CharType() *Simple

CharType returns the Java char type.

func (*JDbg) Class

func (j *JDbg) Class(name string) *Class

Class looks up the specified class by name. For example: "java.io.File"

func (*JDbg) DoubleObjectType

func (j *JDbg) DoubleObjectType() *Class

DoubleObjectType returns the Java java.lang.Double type.

func (*JDbg) DoubleType

func (j *JDbg) DoubleType() *Simple

DoubleType returns the Java double type.

func (*JDbg) FloatObjectType

func (j *JDbg) FloatObjectType() *Class

FloatObjectType returns the Java java.lang.Float type.

func (*JDbg) FloatType

func (j *JDbg) FloatType() *Simple

FloatType returns the Java float type.

func (*JDbg) GetStackObject

func (j *JDbg) GetStackObject(name string) Value

GetStackObject returns an object by name that exists in the current stack-frame.

func (*JDbg) IntObjectType

func (j *JDbg) IntObjectType() *Class

IntObjectType returns the Java java.lang.Integer type.

func (*JDbg) IntType

func (j *JDbg) IntType() *Simple

IntType returns the Java int type.

func (*JDbg) LongObjectType

func (j *JDbg) LongObjectType() *Class

LongObjectType returns the Java java.lang.Long type.

func (*JDbg) LongType

func (j *JDbg) LongType() *Simple

LongType returns the Java long type.

func (*JDbg) NumberType

func (j *JDbg) NumberType() *Class

NumberType returns the Java java.lang.Number type.

func (*JDbg) ObjectType

func (j *JDbg) ObjectType() *Class

ObjectType returns the Java java.lang.Object type.

func (*JDbg) SetStackObject

func (j *JDbg) SetStackObject(name string, val Value)

SetStackObject sets and object in the current stack-frame to the given value.

func (*JDbg) ShortObjectType

func (j *JDbg) ShortObjectType() *Class

ShortObjectType returns the Java java.lang.Short type.

func (*JDbg) ShortType

func (j *JDbg) ShortType() *Simple

ShortType returns the Java short type.

func (*JDbg) String

func (j *JDbg) String(val string) Value

func (*JDbg) StringType

func (j *JDbg) StringType() *Class

StringType returns the Java java.lang.String type.

func (*JDbg) This

func (j *JDbg) This() Value

This returns the this object for the current stack frame.

func (*JDbg) Type

func (j *JDbg) Type(sig string) Type

Type looks up the specified type by signature. For example: "Ljava/io/File;"

type Simple

type Simple struct {
	// contains filtered or unexported fields
}

Simple is a primitive type.

func (*Simple) Call

func (t *Simple) Call(method string, args ...interface{}) Value

Call invokes the static method with the specified arguments.

func (*Simple) CastableTo

func (t *Simple) CastableTo(ty Type) bool

CastableTo returns true if this type can be cast to ty.

func (*Simple) Signature

func (t *Simple) Signature() string

Signature returns the Java signature for the type.

func (*Simple) String

func (t *Simple) String() string

func (*Simple) Super

func (t *Simple) Super() Type

Super returns the super type.

type Type

type Type interface {
	// String returns the string representation of the type.
	String() string
	// Signature returns the Java signature for the type.
	Signature() string
	// CastableTo returns true if this type can be cast to ty.
	CastableTo(ty Type) bool
	// Call invokes the static method with the specified arguments.
	Call(method string, args ...interface{}) Value
	// Super returns the super type.
	Super() Type
	// contains filtered or unexported methods
}

Type represents a Java type.

type Value

type Value struct {
	// contains filtered or unexported fields
}

Value holds the value of a call.

func (Value) Call

func (v Value) Call(method string, args ...interface{}) Value

Call invokes the method on the value.

func (Value) Field

func (v Value) Field(name string) Value

Field returns the value of the specified field.

func (Value) Get

func (v Value) Get() interface{}

Get returns the value, unmarshalled.

func (Value) SetArrayValues

func (v Value) SetArrayValues(values interface{})

SetArrayValues sets the array values to values. This value must be an Array.

func (Value) Type

func (v Value) Type() Type

Type returns the value's type.