Home » openjdk-7 » java » lang » instrument » [javadoc | source]

    1   /*
    2    * Copyright (c) 2003, 2006, Oracle and/or its affiliates. All rights reserved.
    3    * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
    4    *
    5    * This code is free software; you can redistribute it and/or modify it
    6    * under the terms of the GNU General Public License version 2 only, as
    7    * published by the Free Software Foundation.  Oracle designates this
    8    * particular file as subject to the "Classpath" exception as provided
    9    * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
   22    * or visit www.oracle.com if you need additional information or have any
   23    * 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
   60       ClassDefinition(    Class<?> theClass,
   61                           byte[]  theClassFile) {
   62           if (theClass == null || theClassFile == null) {
   63               throw new NullPointerException();
   64           }
   65           mClass      = theClass;
   66           mClassFile  = theClassFile;
   67       }
   68   
   69       /**
   70        * Returns the class.
   71        *
   72        * @return    the <code>Class</code> object referred to.
   73        */
   74       public Class<?>
   75       getDefinitionClass() {
   76           return mClass;
   77       }
   78   
   79       /**
   80        * Returns the array of bytes that contains the new class file.
   81        *
   82        * @return    the class file bytes.
   83        */
   84       public byte[]
   85       getDefinitionClassFile() {
   86           return mClassFile;
   87       }
   88   }

Home » openjdk-7 » java » lang » instrument » [javadoc | source]