Source for java.io.ObjectStreamConstants

   1: /* ObjectStreamConstants.java -- Interface containing constant values
   2:    used in reading and writing serialized objects
   3:    Copyright (C) 1998, 1999, 2003, 2006 Free Software Foundation, Inc.
   4: 
   5: This file is part of GNU Classpath.
   6: 
   7: GNU Classpath is free software; you can redistribute it and/or modify
   8: it under the terms of the GNU General Public License as published by
   9: the Free Software Foundation; either version 2, or (at your option)
  10: any later version.
  11:  
  12: GNU Classpath is distributed in the hope that it will be useful, but
  13: WITHOUT ANY WARRANTY; without even the implied warranty of
  14: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15: General Public License for more details.
  16: 
  17: You should have received a copy of the GNU General Public License
  18: along with GNU Classpath; see the file COPYING.  If not, write to the
  19: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  20: 02110-1301 USA.
  21: 
  22: Linking this library statically or dynamically with other modules is
  23: making a combined work based on this library.  Thus, the terms and
  24: conditions of the GNU General Public License cover the whole
  25: combination.
  26: 
  27: As a special exception, the copyright holders of this library give you
  28: permission to link this library with independent modules to produce an
  29: executable, regardless of the license terms of these independent
  30: modules, and to copy and distribute the resulting executable under
  31: terms of your choice, provided that you also meet, for each linked
  32: independent module, the terms and conditions of the license of that
  33: module.  An independent module is a module which is not derived from
  34: or based on this library.  If you modify this library, you may extend
  35: this exception to your version of the library, but you are not
  36: obligated to do so.  If you do not wish to do so, delete this
  37: exception statement from your version. */
  38: 
  39: 
  40: package java.io;
  41: 
  42: /**
  43:  * This interface contains constants that are used in object
  44:  * serialization.  This interface is used by <code>ObjectOutputStream</code>,
  45:  * <code>ObjectInputStream</code>, and <code>ObjectStreamClass</code>.
  46:  * The values for these constants are specified by the Java library
  47:  * specification.
  48:  * 
  49:  * @since 1.1
  50:  */
  51: public interface ObjectStreamConstants
  52: {
  53:   // FIXME: Javadoc comment these values.
  54:   
  55:   /** 
  56:    * The serialization stream protocol version 1. This version was
  57:    * the default serialization protocol before JDK 1.2.
  58:    * 
  59:    * @see ObjectOutputStream#useProtocolVersion(int)
  60:    * @since 1.2
  61:    */
  62:   int PROTOCOL_VERSION_1 = 1;
  63:   
  64:   /** 
  65:    * The serialization stream protocol version 2. This version is
  66:    * used as the default serialization protocol since JDK 1.2.
  67:    * 
  68:    * @see ObjectOutputStream#useProtocolVersion(int)
  69:    * @since 1.2
  70:    */
  71:   int PROTOCOL_VERSION_2 = 2;
  72: 
  73:   short STREAM_MAGIC = (short)0xaced;
  74:   short STREAM_VERSION = 5;
  75: 
  76:   byte TC_NULL = (byte)112;            //0x70
  77:   byte TC_REFERENCE = (byte)113;       //0x71
  78:   byte TC_CLASSDESC = (byte)114;       //0x72
  79:   byte TC_OBJECT = (byte)115;          //0x73
  80:   byte TC_STRING = (byte)116;          //0x74
  81:   byte TC_ARRAY = (byte)117;           //0x75
  82:   byte TC_CLASS = (byte)118;           //0x76
  83:   byte TC_BLOCKDATA = (byte)119;       //0x77
  84:   byte TC_ENDBLOCKDATA = (byte)120;    //0x78
  85:   byte TC_RESET = (byte)121;           //0x79
  86:   byte TC_BLOCKDATALONG = (byte)122;   //0x7A
  87:   byte TC_EXCEPTION = (byte)123;       //0x7B
  88:   byte TC_LONGSTRING = (byte)124;      //0x7C
  89:   byte TC_PROXYCLASSDESC = (byte)125;  //0x7D
  90: 
  91:   byte TC_BASE = TC_NULL;
  92:   byte TC_MAX = TC_PROXYCLASSDESC;
  93: 
  94:   int baseWireHandle = 0x7e0000;
  95: 
  96:   byte SC_WRITE_METHOD = 0x01;
  97:   byte SC_SERIALIZABLE = 0x02;
  98:   byte SC_EXTERNALIZABLE = 0x04;
  99:   byte SC_BLOCK_DATA = 0x08;
 100: 
 101:   SerializablePermission SUBSTITUTION_PERMISSION
 102:     = new SerializablePermission("enableSubstitution");
 103: 
 104:   SerializablePermission SUBCLASS_IMPLEMENTATION_PERMISSION
 105:     = new SerializablePermission("enableSubclassImplementation");
 106: }