FileDocCategorySizeDatePackage
EncapsOutputStream.javaAPI DocJava SE 5 API4700Fri Aug 26 14:54:20 BST 2005com.sun.corba.se.impl.encoding

EncapsOutputStream

public class EncapsOutputStream extends com.sun.corba.se.impl.encoding.CDROutputStream
Encapsulations are supposed to explicitly define their code sets and GIOP version. The original resolution to issue 2784 said that the defaults were UTF-8 and UTF-16, but that was not agreed upon. These streams currently use CDR 1.2 with ISO8859-1 for char/string and UTF16 for wchar/wstring. If no byte order marker is available, the endianness of the encapsulation is used. When more encapsulations arise that have their own special code sets defined, we can make all constructors take such parameters.

Fields Summary
static final boolean
usePooledByteBuffers
Constructors Summary
public EncapsOutputStream(com.sun.corba.se.spi.orb.ORB orb)


    // REVISIT - Right now, valuetypes in encapsulations will
    // only use stream format version 1, which may create problems
    // for service contexts or codecs (?).

    // corba/ORB
    // corba/ORBSingleton
    // iiop/ORB
    // iiop/GIOPImpl
    // corba/AnyImpl
       
        // GIOP version 1.2 with no fragmentation, big endian,
        // UTF8 for char data and UTF-16 for wide char data;
        this(orb, GIOPVersion.V1_2);
public EncapsOutputStream(com.sun.corba.se.spi.orb.ORB orb, com.sun.corba.se.spi.ior.iiop.GIOPVersion version)

        this(orb, version, false);
public EncapsOutputStream(com.sun.corba.se.spi.orb.ORB orb, boolean isLittleEndian)

        this(orb, GIOPVersion.V1_2, isLittleEndian);
public EncapsOutputStream(com.sun.corba.se.spi.orb.ORB orb, com.sun.corba.se.spi.ior.iiop.GIOPVersion version, boolean isLittleEndian)

        super(orb, version, Message.CDR_ENC_VERSION, isLittleEndian,
	      BufferManagerFactory.newBufferManagerWrite(
                                        BufferManagerFactory.GROW,
					Message.CDR_ENC_VERSION,
					orb),
	      ORBConstants.STREAM_FORMAT_VERSION_1,
              usePooledByteBuffers);
Methods Summary
protected CodeSetConversion.CTBConvertercreateCharCTBConverter()

        return CodeSetConversion.impl().getCTBConverter(OSFCodeSetRegistry.ISO_8859_1);
protected CodeSetConversion.CTBConvertercreateWCharCTBConverter()

        if (getGIOPVersion().equals(GIOPVersion.V1_0))
	    throw wrapper.wcharDataInGiop10(CompletionStatus.COMPLETED_MAYBE);            

        // In the case of GIOP 1.1, we take the byte order of the stream and don't
        // use byte order markers since we're limited to a 2 byte fixed width encoding.
        if (getGIOPVersion().equals(GIOPVersion.V1_1))
            return CodeSetConversion.impl().getCTBConverter(OSFCodeSetRegistry.UTF_16,
                                                            isLittleEndian(),
                                                            false);

        // Assume anything else meets GIOP 1.2 requirements
        //
        // Use byte order markers?  If not, use big endian in GIOP 1.2.  
        // (formal 00-11-03 15.3.16)

        boolean useBOM = ((ORB)orb()).getORBData().useByteOrderMarkersInEncapsulations();

        return CodeSetConversion.impl().getCTBConverter(OSFCodeSetRegistry.UTF_16, 
                                                        false, 
                                                        useBOM);
public org.omg.CORBA.portable.InputStreamcreate_input_stream()

        freeInternalCaches();

        return new EncapsInputStream(orb(),
                                     getByteBuffer(),
                                     getSize(),
                                     isLittleEndian(),
                                     getGIOPVersion());