Save This Page
Home » mq4_2-source-20080707.jar » javax » jms » [javadoc | source]
    1   /*
    2    * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    3    *
    4    * Copyright 2000-2007 Sun Microsystems, Inc. All rights reserved. 
    5    *
    6    * The contents of this file are subject to the terms of either the GNU
    7    * General Public License Version 2 only ("GPL") or the Common Development
    8    * and Distribution License ("CDDL") (collectively, the "License").  You may
    9    * not use this file except in compliance with the License.  You can obtain
   10    * a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
   11    * or mq/legal/LICENSE.txt.  See the License for the specific language
   12    * governing permissions and limitations under the License.
   13    * 
   14    * When distributing the software, include this License Header Notice in each
   15    * file and include the License file at mq/legal/LICENSE.txt.  Sun designates
   16    * this particular file as subject to the "Classpath" exception as provided by
   17    * Sun in the GPL Version 2 section of the License file that accompanied this
   18    * code.  If applicable, add the following below the License Header, with the
   19    * fields enclosed by brackets [] replaced by your own identifying information:
   20    * "Portions Copyrighted [year] [name of copyright owner]"
   21    * 
   22    * Contributor(s):
   23    * 
   24    * If you wish your version of this file to be governed by only the CDDL or
   25    * only the GPL Version 2, indicate your decision by adding "[Contributor]
   26    * elects to include this software in this distribution under the [CDDL or GPL
   27    * Version 2] license."  If you don't indicate a single choice of license, a
   28    * recipient has the option to distribute your version of this file under
   29    * either the CDDL, the GPL Version 2 or  to extend the choice of license to
   30    * its licensees as provided above.  However, if you add GPL Version 2 code
   31    * and therefore, elected the GPL Version 2 license, then the option applies
   32    * only if the new code is made subject to such option by the copyright holder. 
   33    */
   34   
   35   /*
   36    * @(#)MessageFormatException.java	1.9 07/02/07
   37    */ 
   38   
   39   package javax.jms;
   40   
   41   /**
   42    * <P> This exception must be thrown when a JMS client 
   43    *     attempts to use a data type not supported by a message or attempts to 
   44    *     read data in a message as the wrong type. It must also be thrown when 
   45    *     equivalent type errors are made with message property values. For 
   46    *     example, this exception must be thrown if 
   47    *     <CODE>StreamMessage.writeObject</CODE> is given an unsupported class or 
   48    *     if <CODE>StreamMessage.readShort</CODE> is used to read a 
   49    *     <CODE>boolean</CODE> value. Note that the special case of a failure 
   50    *     caused by an attempt to read improperly formatted <CODE>String</CODE> 
   51    *     data as numeric values must throw the 
   52    *     <CODE>java.lang.NumberFormatException</CODE>.
   53    *
   54    **/
   55   
   56   public class MessageFormatException extends JMSException {
   57   
   58     /** Constructs a <CODE>MessageFormatException</CODE> with the specified 
   59      *  reason and error code.
   60      *
   61      *  @param  reason        a description of the exception
   62      *  @param  errorCode     a string specifying the vendor-specific
   63      *                        error code
   64      *                        
   65      **/
   66     public 
   67     MessageFormatException(String reason, String errorCode) {
   68       super(reason, errorCode);
   69     }
   70   
   71     /** Constructs a <CODE>MessageFormatException</CODE> with the specified 
   72      *  reason. The error code defaults to null.
   73      *
   74      *  @param  reason        a description of the exception
   75      **/
   76     public 
   77     MessageFormatException(String reason) {
   78       super(reason);
   79     }
   80   
   81   }

Save This Page
Home » mq4_2-source-20080707.jar » javax » jms » [javadoc | source]