01 /*
02 * Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
03 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
04 *
05 * This code is free software; you can redistribute it and/or modify it
06 * under the terms of the GNU General Public License version 2 only, as
07 * published by the Free Software Foundation. Sun designates this
08 * particular file as subject to the "Classpath" exception as provided
09 * by Sun in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package java.lang.instrument;
27
28 /*
29 * Copyright 2003 Wily Technology, Inc.
30 */
31
32 /**
33 * This class serves as a parameter block to the <code>Instrumentation.redefineClasses</code> method.
34 * Serves to bind the <code>Class</code> that needs redefining together with the new class file bytes.
35 *
36 * @see java.lang.instrument.Instrumentation#redefineClasses
37 * @since 1.5
38 */
39 public final class ClassDefinition {
40 /**
41 * The class to redefine
42 */
43 private final Class mClass;
44
45 /**
46 * The replacement class file bytes
47 */
48 private final byte[] mClassFile;
49
50 /**
51 * Creates a new <code>ClassDefinition</code> binding using the supplied
52 * class and class file bytes. Does not copy the supplied buffer, just captures a reference to it.
53 *
54 * @param theClass the <code>Class</code> that needs redefining
55 * @param theClassFile the new class file bytes
56 *
57 * @throws java.lang.NullPointerException if the supplied class or array is <code>null</code>.
58 */
59 public ClassDefinition(Class<?> theClass, byte[] theClassFile) {
60 if (theClass == null || theClassFile == null) {
61 throw new NullPointerException();
62 }
63 mClass = theClass;
64 mClassFile = theClassFile;
65 }
66
67 /**
68 * Returns the class.
69 *
70 * @return the <code>Class</code> object referred to.
71 */
72 public Class<?> getDefinitionClass() {
73 return mClass;
74 }
75
76 /**
77 * Returns the array of bytes that contains the new class file.
78 *
79 * @return the class file bytes.
80 */
81 public byte[] getDefinitionClassFile() {
82 return mClassFile;
83 }
84 }
|