corba/src/share/classes/com/sun/corba/se/spi/orb/ORBVersionFactory.java
author ohair
Tue, 25 May 2010 15:52:11 -0700
changeset 5555 b2b5ed3f0d0d
parent 4 02bb8761fcce
permissions -rw-r--r--
6943119: Rebrand source copyright notices Reviewed-by: darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     1
/*
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     2
 * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
02bb8761fcce Initial load
duke
parents:
diff changeset
     4
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
02bb8761fcce Initial load
duke
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    10
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
02bb8761fcce Initial load
duke
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
02bb8761fcce Initial load
duke
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
02bb8761fcce Initial load
duke
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
02bb8761fcce Initial load
duke
parents:
diff changeset
    15
 * accompanied this code).
02bb8761fcce Initial load
duke
parents:
diff changeset
    16
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
02bb8761fcce Initial load
duke
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
02bb8761fcce Initial load
duke
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
02bb8761fcce Initial load
duke
parents:
diff changeset
    20
 *
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    23
 * questions.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    24
 */
02bb8761fcce Initial load
duke
parents:
diff changeset
    25
02bb8761fcce Initial load
duke
parents:
diff changeset
    26
package com.sun.corba.se.spi.orb ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    27
02bb8761fcce Initial load
duke
parents:
diff changeset
    28
import com.sun.corba.se.spi.orb.ORBVersion ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    29
import com.sun.corba.se.impl.orb.ORBVersionImpl ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    30
import org.omg.CORBA.portable.InputStream ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    31
import org.omg.CORBA.INTERNAL ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    32
02bb8761fcce Initial load
duke
parents:
diff changeset
    33
public class ORBVersionFactory {
02bb8761fcce Initial load
duke
parents:
diff changeset
    34
    private ORBVersionFactory() {} ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    35
02bb8761fcce Initial load
duke
parents:
diff changeset
    36
    public static ORBVersion getFOREIGN()
02bb8761fcce Initial load
duke
parents:
diff changeset
    37
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    38
        return ORBVersionImpl.FOREIGN ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    39
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    40
02bb8761fcce Initial load
duke
parents:
diff changeset
    41
    public static ORBVersion getOLD()
02bb8761fcce Initial load
duke
parents:
diff changeset
    42
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    43
        return ORBVersionImpl.OLD ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    44
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    45
02bb8761fcce Initial load
duke
parents:
diff changeset
    46
    public static ORBVersion getNEW()
02bb8761fcce Initial load
duke
parents:
diff changeset
    47
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    48
        return ORBVersionImpl.NEW ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    49
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    50
02bb8761fcce Initial load
duke
parents:
diff changeset
    51
    public static ORBVersion getJDK1_3_1_01()
02bb8761fcce Initial load
duke
parents:
diff changeset
    52
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    53
        return ORBVersionImpl.JDK1_3_1_01 ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    54
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    55
02bb8761fcce Initial load
duke
parents:
diff changeset
    56
    public static ORBVersion getNEWER()
02bb8761fcce Initial load
duke
parents:
diff changeset
    57
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    58
        return ORBVersionImpl.NEWER ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    59
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    60
02bb8761fcce Initial load
duke
parents:
diff changeset
    61
    public static ORBVersion getPEORB()
02bb8761fcce Initial load
duke
parents:
diff changeset
    62
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    63
        return ORBVersionImpl.PEORB ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    64
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    65
02bb8761fcce Initial load
duke
parents:
diff changeset
    66
    /** Return the current version of this ORB
02bb8761fcce Initial load
duke
parents:
diff changeset
    67
     */
02bb8761fcce Initial load
duke
parents:
diff changeset
    68
    public static ORBVersion getORBVersion()
02bb8761fcce Initial load
duke
parents:
diff changeset
    69
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    70
        return ORBVersionImpl.PEORB ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    71
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    72
02bb8761fcce Initial load
duke
parents:
diff changeset
    73
    public static ORBVersion create( InputStream is )
02bb8761fcce Initial load
duke
parents:
diff changeset
    74
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    75
        byte value = is.read_octet() ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    76
        return byteToVersion( value ) ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    77
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    78
02bb8761fcce Initial load
duke
parents:
diff changeset
    79
    private static ORBVersion byteToVersion( byte value )
02bb8761fcce Initial load
duke
parents:
diff changeset
    80
    {
02bb8761fcce Initial load
duke
parents:
diff changeset
    81
        /* Throwing an exception here would cause this version to be
02bb8761fcce Initial load
duke
parents:
diff changeset
    82
        * incompatible with future versions of the ORB, to the point
02bb8761fcce Initial load
duke
parents:
diff changeset
    83
        * that this version could
02bb8761fcce Initial load
duke
parents:
diff changeset
    84
        * not even unmarshal objrefs from a newer version that uses
02bb8761fcce Initial load
duke
parents:
diff changeset
    85
        * extended versioning.  Therefore, we will simply treat all
02bb8761fcce Initial load
duke
parents:
diff changeset
    86
        * unknown versions as the latest version.
02bb8761fcce Initial load
duke
parents:
diff changeset
    87
        if (value < 0)
02bb8761fcce Initial load
duke
parents:
diff changeset
    88
            throw new INTERNAL() ;
02bb8761fcce Initial load
duke
parents:
diff changeset
    89
        */
02bb8761fcce Initial load
duke
parents:
diff changeset
    90
02bb8761fcce Initial load
duke
parents:
diff changeset
    91
        /**
02bb8761fcce Initial load
duke
parents:
diff changeset
    92
         * Update: If we treat all unknown versions as the latest version
02bb8761fcce Initial load
duke
parents:
diff changeset
    93
         * then when we send an IOR with a PEORB version to an ORB that
02bb8761fcce Initial load
duke
parents:
diff changeset
    94
         * doesn't know the PEORB version it will treat it as whatever
02bb8761fcce Initial load
duke
parents:
diff changeset
    95
         * its idea of the latest version is.  Then, if that IOR is
02bb8761fcce Initial load
duke
parents:
diff changeset
    96
         * sent back to the server and compared with the original
02bb8761fcce Initial load
duke
parents:
diff changeset
    97
         * the equality check will fail because the versions will be
02bb8761fcce Initial load
duke
parents:
diff changeset
    98
         * different.
02bb8761fcce Initial load
duke
parents:
diff changeset
    99
         *
02bb8761fcce Initial load
duke
parents:
diff changeset
   100
         * Instead, just capture the version bytes.
02bb8761fcce Initial load
duke
parents:
diff changeset
   101
         */
02bb8761fcce Initial load
duke
parents:
diff changeset
   102
02bb8761fcce Initial load
duke
parents:
diff changeset
   103
        switch (value) {
02bb8761fcce Initial load
duke
parents:
diff changeset
   104
            case ORBVersion.FOREIGN : return ORBVersionImpl.FOREIGN ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   105
            case ORBVersion.OLD : return ORBVersionImpl.OLD ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   106
            case ORBVersion.NEW : return ORBVersionImpl.NEW ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   107
            case ORBVersion.JDK1_3_1_01: return ORBVersionImpl.JDK1_3_1_01 ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   108
            case ORBVersion.NEWER : return ORBVersionImpl.NEWER ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   109
            case ORBVersion.PEORB : return ORBVersionImpl.PEORB ;
02bb8761fcce Initial load
duke
parents:
diff changeset
   110
            default : return new ORBVersionImpl(value);
02bb8761fcce Initial load
duke
parents:
diff changeset
   111
        }
02bb8761fcce Initial load
duke
parents:
diff changeset
   112
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
   113
}