org.jibx.binding.classes
Class ClassItem

java.lang.Object
  org.jibx.binding.classes.ClassItem

public class ClassItem
extends Object

Wrapper for field or method information. Provides the information needed for access to either existing or added methods in existing classes.

Author:

Dennis M. Sosnoski

Constructor Summary

ClassItem(String name, ClassFile cf, org.apache.bcel.classfile.FieldOrMethod item)
Constructor.

Method Summary

static ClassItem	findStaticMethod(String name, String[] sigs) Get static method by fully qualified name.
static ClassItem	findVirtualMethod(String name, String[] sigs) Get virtual method by fully qualified name.
int	getAccessFlags() Get access flags.
int	getArgumentCount() Get number of arguments for method.
String	getArgumentType(int index) Get argument type as fully qualified class name.
String[]	getArgumentTypes() Get argument types as array of fully qualified class names.
ClassFile	getClassFile() Get owning class information.
String[]	getExceptions() Get names of exceptions thrown by method.
String	getFullName() Get fully-qualified class and method name.
String	getGenericsSignature() Get the generics signature information for item.
String	getName() Get item name.
String	getParameterName(int index) Get method parameter name.
static String[]	getParametersFromSignature(String sig) Get parameter type names from method signature.
static String	getPrimitiveSignature(String type) Get the signature for a primitive.
String	getSignature() Get method signature.
static String[]	getSignatureVariants(String name) Get all variant signatures for a fully qualified class name.
static String	getTypeFromSignature(String sig) Get return type names from method signature.
String	getTypeName() Get item type as fully qualified class name.
static boolean	isAssignable(String from, String to) Check if a value of one type can be directly assigned to another type.
boolean	isInitializer() Check if item is an initializer.
boolean	isMethod() Check if item is a method.
static boolean	isPrimitive(String type) Check if type is a primitive.
boolean	isStatic() Check if item is a static.
void	makeAccessible(ClassFile src) Make accessible item.
void	setAccessFlags(int flags) Set access flags.
static org.apache.bcel.generic.Type	typeFromName(String name) Create type from name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClassItem

public ClassItem(String name,
                 ClassFile cf,
                 org.apache.bcel.classfile.FieldOrMethod item)

Constructor. Builds a wrapper for an item based on an existing field or method.

Parameters:

name - field or method name

cf - owning class information

item - field or method information

Method Detail

getClassFile

public ClassFile getClassFile()

Get owning class information.

Returns:

owning class information

getName

public String getName()

Get item name.

Returns:

item name

getFullName

public String getFullName()

Get fully-qualified class and method name.

Returns:

fully-qualified class and method name

getTypeName

public String getTypeName()

Get item type as fully qualified class name.

Returns:

item type name

getArgumentCount

public int getArgumentCount()

Get number of arguments for method.

Returns:

argument count for method, or zero if not a method

getArgumentType

public String getArgumentType(int index)

Get argument type as fully qualified class name.

Parameters:

index - argument number

Returns:

argument type name

getParameterName

public String getParameterName(int index)

Get method parameter name.

Parameters:

index - parameter index

Returns:

parameter name

getArgumentTypes

public String[] getArgumentTypes()

Get argument types as array of fully qualified class names.

Returns:

array of argument types

getAccessFlags

public int getAccessFlags()

Get access flags.

Returns:

flags for access type of field or method

setAccessFlags

public void setAccessFlags(int flags)

Set access flags.

Parameters:

flags - access flags for field or method

makeAccessible

public void makeAccessible(ClassFile src)

Make accessible item. Check if this field or method is accessible from another class, and if not decreases the access restrictions to make it accessible.

Parameters:

src - class file for required access

isStatic

public boolean isStatic()

Check if item is a static.

Returns:

true if a static, false if member

getSignature

public String getSignature()

Get method signature.

Returns:

encoded method signature

isMethod

public boolean isMethod()

Check if item is a method.

Returns:

true if a method, false if a field

isInitializer

public boolean isInitializer()

Check if item is an initializer.

Returns:

true if an initializer, false if a field or normal method

getExceptions

public String[] getExceptions()

Get names of exceptions thrown by method.

Returns:

array of exceptions thrown by method, or null if a field

getGenericsSignature

public String getGenericsSignature()

Get the generics signature information for item.

Returns:

generics signature (null if none)

isPrimitive

public static boolean isPrimitive(String type)

Check if type is a primitive.

Parameters:

type -

Returns:

true if a primitive, false if not

getPrimitiveSignature

public static String getPrimitiveSignature(String type)

Get the signature for a primitive.

Parameters:

type -

Returns:

signature for a primitive type

getParametersFromSignature

public static String[] getParametersFromSignature(String sig)

Get parameter type names from method signature.

Parameters:

sig - method signature to be decoded

Returns:

array of argument type names

getTypeFromSignature

public static String getTypeFromSignature(String sig)

Get return type names from method signature.

Parameters:

sig - method signature to be decoded

Returns:

return type name

typeFromName

public static org.apache.bcel.generic.Type typeFromName(String name)

Create type from name.

Parameters:

name - fully qualified type name

Returns:

corresponding type

findVirtualMethod

public static ClassItem findVirtualMethod(String name,
                                          String[] sigs)
                                   throws JiBXException

Get virtual method by fully qualified name. This splits the class name from the method name, finds the class, and then tries to find a matching method name in that class or a superclass.

Parameters:

name - fully qualified class and method name

sigs - possible method signatures

Returns:

information for the method, or null if not found

Throws:

JiBXException - if configuration error

findStaticMethod

public static ClassItem findStaticMethod(String name,
                                         String[] sigs)
                                  throws JiBXException

Get static method by fully qualified name. This splits the class name from the method name, finds the class, and then tries to find a matching method name in that class.

Parameters:

name - fully qualified class and method name

sigs - possible method signatures

Returns:

information for the method, or null if not found

Throws:

JiBXException - if configuration error

getSignatureVariants

public static String[] getSignatureVariants(String name)
                                     throws JiBXException

Get all variant signatures for a fully qualified class name. The returned array gives all signatures (for interfaces or classes) which instances of the class can match.

Parameters:

name - fully qualified class name

Returns:

possible signature variations for instances of the class

Throws:

JiBXException - if configuration error

isAssignable

public static boolean isAssignable(String from,
                                   String to)
                            throws JiBXException

Check if a value of one type can be directly assigned to another type. This is basically the equivalent of the instanceof operator, but with application to primitive types as well as object types.

Parameters:

from - fully qualified class name of initial type

to - fully qualified class name of assignment type

Returns:

true if assignable, false if not

Throws:

JiBXException - if configuration error