The JavaTM Tutorial

| Start of Tutorial > Start of Trail > Start of Lesson | Search Feedback Form

Trail: The Reflection API
Lesson: Manipulating Objects

## Setting Field Values

> Some debuggers allow users to change field values during a debugging session. If you are writing a tool that has this capability, you must call one of the `Field` class's `set` methods. To modify the value of a field, perform the following steps:
> 1. Create a `Class` object. For more information, see the section Retrieving Class Objects.
> 2. Create a `Field` object by invoking `getField` on the `Class` object. The section Identifying Class Fields shows you how.
> 3. Invoke the appropriate `set` method on the `Field` object.

> The `Field` class provides several `set` methods. Specialized methods, such as `setBoolean` and `setInt`, are for modifying primitive types. If the field you want to change is an object invoke the `set` method. You can call `set` to modify a primitive type, but you must use the appropriate wrapper object for the value parameter.

> The sample program that follows modifies the `width` field of a `Rectangle` object by invoking the `set` method. Since the `width` is a primitive type, an `int`, the value passed by `set` is an `Integer`, which is an object wrapper.

> >     import java.lang.reflect.*;
> >     import java.awt.*;

> >     class SampleSet {

> >        public static void main(String[] args) {
> >           Rectangle r = new Rectangle(100, 20);
> >           System.out.println("original: " + r.toString());
> >           modifyWidth(r, new Integer(300));
> >           System.out.println("modified: " + r.toString());
> >        }

> >        static void modifyWidth(Rectangle r, Integer widthParam ) {
> >           Field widthField;
> >           Integer widthValue;
> >           Class c = r.getClass();
> >           try {
> >             widthField = c.getField("width");
> >             widthField.set(r, widthParam);
> >           } catch (NoSuchFieldException e) {
> >               System.out.println(e);
> >           } catch (IllegalAccessException e) {
> >               System.out.println(e);
> >           }
> >        }
> >     }

> The output of the sample program verifies that the `width` changed from 100 to 300:

> >     original: java.awt.Rectangle[x=0,y=0,width=100,height=20]
> >     modified: java.awt.Rectangle[x=0,y=0,width=300,height=20]

| Start of Tutorial > Start of Trail > Start of Lesson | Search Feedback Form

Copyright 1995-2001 Sun Microsystems, Inc. All rights reserved.