mirror of
https://github.com/openjdk/jdk.git
synced 2025-09-23 12:34:32 +02:00
Merge
This commit is contained in:
commit
8609d34dbe
187 changed files with 26533 additions and 4964 deletions
1
.hgtags
1
.hgtags
|
@ -223,3 +223,4 @@ ea73f01b9053e7165e7ba80f242bafecbc6af712 jdk8-b96
|
|||
2d3875b0d18b3ad1c2bebf385a697e309e4005a4 jdk8-b99
|
||||
3d34036aae4ea90b2ca59712d5a69db3221f0875 jdk8-b100
|
||||
edb01c460d4cab21ff0ff13512df7b746efaa0e7 jdk8-b101
|
||||
bbe43d712fe08e650808d774861b256ccb34e500 jdk8-b102
|
||||
|
|
|
@ -223,3 +223,4 @@ a1c1e8bf71f354f3aec0214cf13d6668811e021d jdk8-b97
|
|||
59dc9da813794c924a0383c2a6241af94defdfed jdk8-b99
|
||||
d2dcb110e9dbaf9903c05b211df800e78e4b394e jdk8-b100
|
||||
9f74a220677dc265a724515d8e2617548cef62f1 jdk8-b101
|
||||
5eb3c1dc348f72a7f84f7d9d07834e8bbe09a799 jdk8-b102
|
||||
|
|
|
@ -223,3 +223,4 @@ c8286839d0df04aba819ec4bef12b86babccf30e jdk8-b90
|
|||
3f67804ab61303782df57e54989ef5e0e4629beb jdk8-b99
|
||||
8d492f1dfd1b131a4c7886ee6b59528609f7e4fe jdk8-b100
|
||||
a013024b07475782f1fa8e196e950b34b4077663 jdk8-b101
|
||||
528c7e76eaeee022817ee085668459bc97cf5665 jdk8-b102
|
||||
|
|
|
@ -1,528 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2004, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
package com.sun.corba.se.impl.encoding;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.io.Serializable;
|
||||
import java.math.BigDecimal;
|
||||
import java.nio.ByteBuffer;
|
||||
|
||||
import org.omg.CORBA.TypeCode;
|
||||
import org.omg.CORBA.Principal;
|
||||
import org.omg.CORBA.Any;
|
||||
|
||||
import com.sun.org.omg.SendingContext.CodeBase;
|
||||
|
||||
import com.sun.corba.se.pept.protocol.MessageMediator;
|
||||
|
||||
import com.sun.corba.se.spi.logging.CORBALogDomains;
|
||||
import com.sun.corba.se.spi.orb.ORB;
|
||||
import com.sun.corba.se.spi.ior.iiop.GIOPVersion;
|
||||
import com.sun.corba.se.spi.protocol.CorbaMessageMediator;
|
||||
|
||||
import com.sun.corba.se.impl.logging.ORBUtilSystemException;
|
||||
import com.sun.corba.se.impl.encoding.CodeSetConversion;
|
||||
import com.sun.corba.se.impl.encoding.OSFCodeSetRegistry;
|
||||
|
||||
/**
|
||||
* This is delegates to the real implementation.
|
||||
*
|
||||
* NOTE:
|
||||
*
|
||||
* Before using the stream for valuetype unmarshaling, one must call
|
||||
* performORBVersionSpecificInit().
|
||||
*/
|
||||
public abstract class CDRInputStream
|
||||
extends org.omg.CORBA_2_3.portable.InputStream
|
||||
implements com.sun.corba.se.impl.encoding.MarshalInputStream,
|
||||
org.omg.CORBA.DataInputStream, org.omg.CORBA.portable.ValueInputStream
|
||||
{
|
||||
protected CorbaMessageMediator messageMediator;
|
||||
private CDRInputStreamBase impl;
|
||||
|
||||
// We can move this out somewhere later. For now, it serves its purpose
|
||||
// to create a concrete CDR delegate based on the GIOP version.
|
||||
private static class InputStreamFactory {
|
||||
|
||||
public static CDRInputStreamBase newInputStream(ORB orb, GIOPVersion version)
|
||||
{
|
||||
switch(version.intValue()) {
|
||||
case GIOPVersion.VERSION_1_0:
|
||||
return new CDRInputStream_1_0();
|
||||
case GIOPVersion.VERSION_1_1:
|
||||
return new CDRInputStream_1_1();
|
||||
case GIOPVersion.VERSION_1_2:
|
||||
return new CDRInputStream_1_2();
|
||||
default:
|
||||
ORBUtilSystemException wrapper = ORBUtilSystemException.get( orb,
|
||||
CORBALogDomains.RPC_ENCODING ) ;
|
||||
throw wrapper.unsupportedGiopVersion( version ) ;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Required for the case when a ClientResponseImpl is
|
||||
// created with a SystemException due to a dead server/closed
|
||||
// connection with no warning. Note that the stream will
|
||||
// not be initialized in this case.
|
||||
//
|
||||
// Probably also required by ServerRequestImpl.
|
||||
//
|
||||
// REVISIT.
|
||||
public CDRInputStream() {
|
||||
}
|
||||
|
||||
public CDRInputStream(CDRInputStream is) {
|
||||
impl = is.impl.dup();
|
||||
impl.setParent(this);
|
||||
}
|
||||
|
||||
public CDRInputStream(org.omg.CORBA.ORB orb,
|
||||
ByteBuffer byteBuffer,
|
||||
int size,
|
||||
boolean littleEndian,
|
||||
GIOPVersion version,
|
||||
BufferManagerRead bufMgr)
|
||||
{
|
||||
impl = InputStreamFactory.newInputStream( (ORB)orb, version);
|
||||
|
||||
impl.init(orb, byteBuffer, size, littleEndian, bufMgr);
|
||||
|
||||
impl.setParent(this);
|
||||
}
|
||||
|
||||
// org.omg.CORBA.portable.InputStream
|
||||
public final boolean read_boolean() {
|
||||
return impl.read_boolean();
|
||||
}
|
||||
|
||||
public final char read_char() {
|
||||
return impl.read_char();
|
||||
}
|
||||
|
||||
public final char read_wchar() {
|
||||
return impl.read_wchar();
|
||||
}
|
||||
|
||||
public final byte read_octet() {
|
||||
return impl.read_octet();
|
||||
}
|
||||
|
||||
public final short read_short() {
|
||||
return impl.read_short();
|
||||
}
|
||||
|
||||
public final short read_ushort() {
|
||||
return impl.read_ushort();
|
||||
}
|
||||
|
||||
public final int read_long() {
|
||||
return impl.read_long();
|
||||
}
|
||||
|
||||
public final int read_ulong() {
|
||||
return impl.read_ulong();
|
||||
}
|
||||
|
||||
public final long read_longlong() {
|
||||
return impl.read_longlong();
|
||||
}
|
||||
|
||||
public final long read_ulonglong() {
|
||||
return impl.read_ulonglong();
|
||||
}
|
||||
|
||||
public final float read_float() {
|
||||
return impl.read_float();
|
||||
}
|
||||
|
||||
public final double read_double() {
|
||||
return impl.read_double();
|
||||
}
|
||||
|
||||
public final String read_string() {
|
||||
return impl.read_string();
|
||||
}
|
||||
|
||||
public final String read_wstring() {
|
||||
return impl.read_wstring();
|
||||
}
|
||||
|
||||
public final void read_boolean_array(boolean[] value, int offset, int length) {
|
||||
impl.read_boolean_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_char_array(char[] value, int offset, int length) {
|
||||
impl.read_char_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_wchar_array(char[] value, int offset, int length) {
|
||||
impl.read_wchar_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_octet_array(byte[] value, int offset, int length) {
|
||||
impl.read_octet_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_short_array(short[] value, int offset, int length) {
|
||||
impl.read_short_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ushort_array(short[] value, int offset, int length) {
|
||||
impl.read_ushort_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_long_array(int[] value, int offset, int length) {
|
||||
impl.read_long_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ulong_array(int[] value, int offset, int length) {
|
||||
impl.read_ulong_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_longlong_array(long[] value, int offset, int length) {
|
||||
impl.read_longlong_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ulonglong_array(long[] value, int offset, int length) {
|
||||
impl.read_ulonglong_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_float_array(float[] value, int offset, int length) {
|
||||
impl.read_float_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final void read_double_array(double[] value, int offset, int length) {
|
||||
impl.read_double_array(value, offset, length);
|
||||
}
|
||||
|
||||
public final org.omg.CORBA.Object read_Object() {
|
||||
return impl.read_Object();
|
||||
}
|
||||
|
||||
public final TypeCode read_TypeCode() {
|
||||
return impl.read_TypeCode();
|
||||
}
|
||||
public final Any read_any() {
|
||||
return impl.read_any();
|
||||
}
|
||||
|
||||
public final Principal read_Principal() {
|
||||
return impl.read_Principal();
|
||||
}
|
||||
|
||||
public final int read() throws java.io.IOException {
|
||||
return impl.read();
|
||||
}
|
||||
|
||||
public final java.math.BigDecimal read_fixed() {
|
||||
return impl.read_fixed();
|
||||
}
|
||||
|
||||
public final org.omg.CORBA.Context read_Context() {
|
||||
return impl.read_Context();
|
||||
}
|
||||
|
||||
public final org.omg.CORBA.Object read_Object(java.lang.Class clz) {
|
||||
return impl.read_Object(clz);
|
||||
}
|
||||
|
||||
public final org.omg.CORBA.ORB orb() {
|
||||
return impl.orb();
|
||||
}
|
||||
|
||||
// org.omg.CORBA_2_3.portable.InputStream
|
||||
public final java.io.Serializable read_value() {
|
||||
return impl.read_value();
|
||||
}
|
||||
|
||||
public final java.io.Serializable read_value(java.lang.Class clz) {
|
||||
return impl.read_value(clz);
|
||||
}
|
||||
|
||||
public final java.io.Serializable read_value(org.omg.CORBA.portable.BoxedValueHelper factory) {
|
||||
return impl.read_value(factory);
|
||||
}
|
||||
|
||||
public final java.io.Serializable read_value(java.lang.String rep_id) {
|
||||
return impl.read_value(rep_id);
|
||||
}
|
||||
|
||||
public final java.io.Serializable read_value(java.io.Serializable value) {
|
||||
return impl.read_value(value);
|
||||
}
|
||||
|
||||
public final java.lang.Object read_abstract_interface() {
|
||||
return impl.read_abstract_interface();
|
||||
}
|
||||
|
||||
public final java.lang.Object read_abstract_interface(java.lang.Class clz) {
|
||||
return impl.read_abstract_interface(clz);
|
||||
}
|
||||
// com.sun.corba.se.impl.encoding.MarshalInputStream
|
||||
|
||||
public final void consumeEndian() {
|
||||
impl.consumeEndian();
|
||||
}
|
||||
|
||||
public final int getPosition() {
|
||||
return impl.getPosition();
|
||||
}
|
||||
|
||||
// org.omg.CORBA.DataInputStream
|
||||
|
||||
public final java.lang.Object read_Abstract () {
|
||||
return impl.read_Abstract();
|
||||
}
|
||||
|
||||
public final java.io.Serializable read_Value () {
|
||||
return impl.read_Value();
|
||||
}
|
||||
|
||||
public final void read_any_array (org.omg.CORBA.AnySeqHolder seq, int offset, int length) {
|
||||
impl.read_any_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_boolean_array (org.omg.CORBA.BooleanSeqHolder seq, int offset, int length) {
|
||||
impl.read_boolean_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_char_array (org.omg.CORBA.CharSeqHolder seq, int offset, int length) {
|
||||
impl.read_char_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_wchar_array (org.omg.CORBA.WCharSeqHolder seq, int offset, int length) {
|
||||
impl.read_wchar_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_octet_array (org.omg.CORBA.OctetSeqHolder seq, int offset, int length) {
|
||||
impl.read_octet_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_short_array (org.omg.CORBA.ShortSeqHolder seq, int offset, int length) {
|
||||
impl.read_short_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ushort_array (org.omg.CORBA.UShortSeqHolder seq, int offset, int length) {
|
||||
impl.read_ushort_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_long_array (org.omg.CORBA.LongSeqHolder seq, int offset, int length) {
|
||||
impl.read_long_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ulong_array (org.omg.CORBA.ULongSeqHolder seq, int offset, int length) {
|
||||
impl.read_ulong_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_ulonglong_array (org.omg.CORBA.ULongLongSeqHolder seq, int offset, int length) {
|
||||
impl.read_ulonglong_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_longlong_array (org.omg.CORBA.LongLongSeqHolder seq, int offset, int length) {
|
||||
impl.read_longlong_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_float_array (org.omg.CORBA.FloatSeqHolder seq, int offset, int length) {
|
||||
impl.read_float_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public final void read_double_array (org.omg.CORBA.DoubleSeqHolder seq, int offset, int length) {
|
||||
impl.read_double_array(seq, offset, length);
|
||||
}
|
||||
|
||||
// org.omg.CORBA.portable.ValueBase
|
||||
public final String[] _truncatable_ids() {
|
||||
return impl._truncatable_ids();
|
||||
}
|
||||
|
||||
// java.io.InputStream
|
||||
public final int read(byte b[]) throws IOException {
|
||||
return impl.read(b);
|
||||
}
|
||||
|
||||
public final int read(byte b[], int off, int len) throws IOException {
|
||||
return impl.read(b, off, len);
|
||||
}
|
||||
|
||||
public final long skip(long n) throws IOException {
|
||||
return impl.skip(n);
|
||||
}
|
||||
|
||||
public final int available() throws IOException {
|
||||
return impl.available();
|
||||
}
|
||||
|
||||
public final void close() throws IOException {
|
||||
impl.close();
|
||||
}
|
||||
|
||||
public final void mark(int readlimit) {
|
||||
impl.mark(readlimit);
|
||||
}
|
||||
|
||||
public final void reset() {
|
||||
impl.reset();
|
||||
}
|
||||
|
||||
public final boolean markSupported() {
|
||||
return impl.markSupported();
|
||||
}
|
||||
|
||||
public abstract CDRInputStream dup();
|
||||
|
||||
// Needed by TCUtility
|
||||
public final java.math.BigDecimal read_fixed(short digits, short scale) {
|
||||
return impl.read_fixed(digits, scale);
|
||||
}
|
||||
|
||||
public final boolean isLittleEndian() {
|
||||
return impl.isLittleEndian();
|
||||
}
|
||||
|
||||
protected final ByteBuffer getByteBuffer() {
|
||||
return impl.getByteBuffer();
|
||||
}
|
||||
|
||||
protected final void setByteBuffer(ByteBuffer byteBuffer) {
|
||||
impl.setByteBuffer(byteBuffer);
|
||||
}
|
||||
|
||||
protected final void setByteBufferWithInfo(ByteBufferWithInfo bbwi) {
|
||||
impl.setByteBufferWithInfo(bbwi);
|
||||
}
|
||||
|
||||
public final int getBufferLength() {
|
||||
return impl.getBufferLength();
|
||||
}
|
||||
|
||||
protected final void setBufferLength(int value) {
|
||||
impl.setBufferLength(value);
|
||||
}
|
||||
|
||||
protected final int getIndex() {
|
||||
return impl.getIndex();
|
||||
}
|
||||
|
||||
protected final void setIndex(int value) {
|
||||
impl.setIndex(value);
|
||||
}
|
||||
|
||||
public final void orb(org.omg.CORBA.ORB orb) {
|
||||
impl.orb(orb);
|
||||
}
|
||||
|
||||
public final GIOPVersion getGIOPVersion() {
|
||||
return impl.getGIOPVersion();
|
||||
}
|
||||
|
||||
public final BufferManagerRead getBufferManager() {
|
||||
return impl.getBufferManager();
|
||||
}
|
||||
|
||||
// This should be overridden by any stream (ex: IIOPInputStream)
|
||||
// which wants to read values. Thus, TypeCodeInputStream doesn't
|
||||
// have to do this.
|
||||
public CodeBase getCodeBase() {
|
||||
return null;
|
||||
}
|
||||
|
||||
// Use Latin-1 for GIOP 1.0 or when code set negotiation was not
|
||||
// performed.
|
||||
protected CodeSetConversion.BTCConverter createCharBTCConverter() {
|
||||
return CodeSetConversion.impl().getBTCConverter(OSFCodeSetRegistry.ISO_8859_1,
|
||||
impl.isLittleEndian());
|
||||
}
|
||||
|
||||
// Subclasses must decide what to do here. It's inconvenient to
|
||||
// make the class and this method abstract because of dup().
|
||||
protected abstract CodeSetConversion.BTCConverter createWCharBTCConverter();
|
||||
|
||||
// Prints the current buffer in a human readable form
|
||||
void printBuffer() {
|
||||
impl.printBuffer();
|
||||
}
|
||||
|
||||
/**
|
||||
* Aligns the current position on the given octet boundary
|
||||
* if there are enough bytes available to do so. Otherwise,
|
||||
* it just returns. This is used for some (but not all)
|
||||
* GIOP 1.2 message headers.
|
||||
*/
|
||||
public void alignOnBoundary(int octetBoundary) {
|
||||
impl.alignOnBoundary(octetBoundary);
|
||||
}
|
||||
|
||||
// Needed by request and reply messages for GIOP versions >= 1.2 only.
|
||||
public void setHeaderPadding(boolean headerPadding) {
|
||||
impl.setHeaderPadding(headerPadding);
|
||||
}
|
||||
|
||||
/**
|
||||
* This must be called after determining the proper ORB version,
|
||||
* and setting it on the stream's ORB instance. It can be called
|
||||
* after reading the service contexts, since that is the only place
|
||||
* we can get the ORB version info.
|
||||
*
|
||||
* Trying to unmarshal things requiring repository IDs before calling
|
||||
* this will result in NullPtrExceptions.
|
||||
*/
|
||||
public void performORBVersionSpecificInit() {
|
||||
// In the case of SystemExceptions, a stream is created
|
||||
// with its default constructor (and thus no impl is set).
|
||||
if (impl != null)
|
||||
impl.performORBVersionSpecificInit();
|
||||
}
|
||||
|
||||
/**
|
||||
* Resets any internal references to code set converters.
|
||||
* This is useful for forcing the CDR stream to reacquire
|
||||
* converters (probably from its subclasses) when state
|
||||
* has changed.
|
||||
*/
|
||||
public void resetCodeSetConverters() {
|
||||
impl.resetCodeSetConverters();
|
||||
}
|
||||
|
||||
public void setMessageMediator(MessageMediator messageMediator)
|
||||
{
|
||||
this.messageMediator = (CorbaMessageMediator) messageMediator;
|
||||
}
|
||||
|
||||
public MessageMediator getMessageMediator()
|
||||
{
|
||||
return messageMediator;
|
||||
}
|
||||
|
||||
// ValueInputStream -----------------------------
|
||||
|
||||
public void start_value() {
|
||||
impl.start_value();
|
||||
}
|
||||
|
||||
public void end_value() {
|
||||
impl.end_value();
|
||||
}
|
||||
}
|
|
@ -1,435 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2004, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
package com.sun.corba.se.impl.encoding;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.io.Serializable;
|
||||
import java.math.BigDecimal;
|
||||
import java.nio.ByteBuffer;
|
||||
|
||||
import org.omg.CORBA.TypeCode;
|
||||
import org.omg.CORBA.Principal;
|
||||
import org.omg.CORBA.Any;
|
||||
|
||||
import com.sun.corba.se.pept.protocol.MessageMediator;
|
||||
|
||||
import com.sun.corba.se.spi.orb.ORB;
|
||||
import com.sun.corba.se.spi.logging.CORBALogDomains;
|
||||
import com.sun.corba.se.spi.ior.iiop.GIOPVersion;
|
||||
import com.sun.corba.se.spi.protocol.CorbaMessageMediator;
|
||||
|
||||
import com.sun.corba.se.impl.encoding.CodeSetConversion;
|
||||
import com.sun.corba.se.impl.encoding.OSFCodeSetRegistry;
|
||||
import com.sun.corba.se.impl.orbutil.ORBConstants;
|
||||
import com.sun.corba.se.impl.logging.ORBUtilSystemException;
|
||||
|
||||
/**
|
||||
* This is delegates to the real implementation.
|
||||
*/
|
||||
public abstract class CDROutputStream
|
||||
extends org.omg.CORBA_2_3.portable.OutputStream
|
||||
implements com.sun.corba.se.impl.encoding.MarshalOutputStream,
|
||||
org.omg.CORBA.DataOutputStream, org.omg.CORBA.portable.ValueOutputStream
|
||||
{
|
||||
/*
|
||||
private CDROutputStreamBase impl;
|
||||
protected ORB orb ;
|
||||
protected ORBUtilSystemException wrapper ;
|
||||
protected CorbaMessageMediator corbaMessageMediator;
|
||||
|
||||
|
||||
// We can move this out somewhere later. For now, it serves its purpose
|
||||
// to create a concrete CDR delegate based on the GIOP version.
|
||||
private static class OutputStreamFactory {
|
||||
|
||||
public static CDROutputStreamBase newOutputStream(ORB orb, GIOPVersion version)
|
||||
{
|
||||
switch(version.intValue()) {
|
||||
case GIOPVersion.VERSION_1_0:
|
||||
return new CDROutputStream_1_0();
|
||||
case GIOPVersion.VERSION_1_1:
|
||||
return new CDROutputStream_1_1();
|
||||
case GIOPVersion.VERSION_1_2:
|
||||
return new CDROutputStream_1_2();
|
||||
default:
|
||||
ORBUtilSystemException wrapper = ORBUtilSystemException.get( orb,
|
||||
CORBALogDomains.RPC_ENCODING ) ;
|
||||
// REVISIT - what is appropriate? INTERNAL exceptions
|
||||
// are really hard to track later.
|
||||
throw wrapper.unsupportedGiopVersion( version ) ;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// REVISIT - These two constructors should be re-factored to better hide
|
||||
// the fact that someone extending this class 'can' construct a CDROutputStream
|
||||
// that does not use pooled ByteBuffers. Right now, only EncapsOutputStream
|
||||
// does _not_ use pooled ByteBuffers, see EncapsOutputStream.
|
||||
|
||||
// NOTE: When a stream is constructed for non-channel-backed sockets
|
||||
// it notifies the constructor not to use pooled (i.e, direct)
|
||||
// ByteBuffers.
|
||||
|
||||
public CDROutputStream(ORB orb,
|
||||
GIOPVersion version,
|
||||
boolean littleEndian,
|
||||
BufferManagerWrite bufferManager,
|
||||
byte streamFormatVersion,
|
||||
boolean usePooledByteBuffers)
|
||||
{
|
||||
impl = OutputStreamFactory.newOutputStream(orb, version);
|
||||
impl.init(orb, littleEndian, bufferManager, streamFormatVersion, usePooledByteBuffers);
|
||||
|
||||
impl.setParent(this);
|
||||
this.orb = orb ;
|
||||
this.wrapper = ORBUtilSystemException.get( orb,
|
||||
CORBALogDomains.RPC_ENCODING ) ;
|
||||
}
|
||||
|
||||
public CDROutputStream(ORB orb,
|
||||
GIOPVersion version,
|
||||
boolean littleEndian,
|
||||
BufferManagerWrite bufferManager,
|
||||
byte streamFormatVersion)
|
||||
{
|
||||
this(orb, version, littleEndian, bufferManager, streamFormatVersion, true);
|
||||
}
|
||||
*/
|
||||
|
||||
private ByteArrayOutputStream bos ;
|
||||
private ObjectOutputStream oos ;
|
||||
|
||||
public JavaOutputStream()
|
||||
{
|
||||
bos = new ByteArrayOutputStream() ;
|
||||
oos = new ObjectOutputStream( bos ) ;
|
||||
}
|
||||
|
||||
// Provided by IIOPOutputStream and EncapsOutputStream
|
||||
public org.omg.CORBA.portable.InputStream create_input_stream()
|
||||
{
|
||||
ObjectInputStream ois = new ByteArrayInputStream( bos.toByteArray() ) ;
|
||||
|
||||
return new JavaInputStream( ois ) ;
|
||||
}
|
||||
|
||||
public final void write_boolean(boolean value) {
|
||||
impl.write_boolean(value);
|
||||
}
|
||||
public final void write_char(char value) {
|
||||
impl.write_char(value);
|
||||
}
|
||||
public final void write_wchar(char value) {
|
||||
impl.write_wchar(value);
|
||||
}
|
||||
public final void write_octet(byte value) {
|
||||
impl.write_octet(value);
|
||||
}
|
||||
public final void write_short(short value) {
|
||||
impl.write_short(value);
|
||||
}
|
||||
public final void write_ushort(short value) {
|
||||
impl.write_ushort(value);
|
||||
}
|
||||
public final void write_long(int value) {
|
||||
impl.write_long(value);
|
||||
}
|
||||
public final void write_ulong(int value) {
|
||||
impl.write_ulong(value);
|
||||
}
|
||||
public final void write_longlong(long value) {
|
||||
impl.write_longlong(value);
|
||||
}
|
||||
public final void write_ulonglong(long value) {
|
||||
impl.write_ulonglong(value);
|
||||
}
|
||||
public final void write_float(float value) {
|
||||
impl.write_float(value);
|
||||
}
|
||||
public final void write_double(double value) {
|
||||
impl.write_double(value);
|
||||
}
|
||||
public final void write_string(String value) {
|
||||
impl.write_string(value);
|
||||
}
|
||||
public final void write_wstring(String value) {
|
||||
impl.write_wstring(value);
|
||||
}
|
||||
|
||||
public final void write_boolean_array(boolean[] value, int offset, int length) {
|
||||
impl.write_boolean_array(value, offset, length);
|
||||
}
|
||||
public final void write_char_array(char[] value, int offset, int length) {
|
||||
impl.write_char_array(value, offset, length);
|
||||
}
|
||||
public final void write_wchar_array(char[] value, int offset, int length) {
|
||||
impl.write_wchar_array(value, offset, length);
|
||||
}
|
||||
public final void write_octet_array(byte[] value, int offset, int length) {
|
||||
impl.write_octet_array(value, offset, length);
|
||||
}
|
||||
public final void write_short_array(short[] value, int offset, int length) {
|
||||
impl.write_short_array(value, offset, length);
|
||||
}
|
||||
public final void write_ushort_array(short[] value, int offset, int length){
|
||||
impl.write_ushort_array(value, offset, length);
|
||||
}
|
||||
public final void write_long_array(int[] value, int offset, int length) {
|
||||
impl.write_long_array(value, offset, length);
|
||||
}
|
||||
public final void write_ulong_array(int[] value, int offset, int length) {
|
||||
impl.write_ulong_array(value, offset, length);
|
||||
}
|
||||
public final void write_longlong_array(long[] value, int offset, int length) {
|
||||
impl.write_longlong_array(value, offset, length);
|
||||
}
|
||||
public final void write_ulonglong_array(long[] value, int offset,int length) {
|
||||
impl.write_ulonglong_array(value, offset, length);
|
||||
}
|
||||
public final void write_float_array(float[] value, int offset, int length) {
|
||||
impl.write_float_array(value, offset, length);
|
||||
}
|
||||
public final void write_double_array(double[] value, int offset, int length) {
|
||||
impl.write_double_array(value, offset, length);
|
||||
}
|
||||
public final void write_Object(org.omg.CORBA.Object value) {
|
||||
impl.write_Object(value);
|
||||
}
|
||||
public final void write_TypeCode(TypeCode value) {
|
||||
impl.write_TypeCode(value);
|
||||
}
|
||||
public final void write_any(Any value) {
|
||||
impl.write_any(value);
|
||||
}
|
||||
|
||||
public final void write_Principal(Principal value) {
|
||||
impl.write_Principal(value);
|
||||
}
|
||||
|
||||
public final void write(int b) throws java.io.IOException {
|
||||
impl.write(b);
|
||||
}
|
||||
|
||||
public final void write_fixed(java.math.BigDecimal value) {
|
||||
impl.write_fixed(value);
|
||||
}
|
||||
|
||||
public final void write_Context(org.omg.CORBA.Context ctx,
|
||||
org.omg.CORBA.ContextList contexts) {
|
||||
impl.write_Context(ctx, contexts);
|
||||
}
|
||||
|
||||
public final org.omg.CORBA.ORB orb() {
|
||||
return impl.orb();
|
||||
}
|
||||
|
||||
// org.omg.CORBA_2_3.portable.OutputStream
|
||||
public final void write_value(java.io.Serializable value) {
|
||||
impl.write_value(value);
|
||||
}
|
||||
|
||||
public final void write_value(java.io.Serializable value, java.lang.Class clz) {
|
||||
impl.write_value(value, clz);
|
||||
}
|
||||
|
||||
public final void write_value(java.io.Serializable value, String repository_id) {
|
||||
impl.write_value(value, repository_id);
|
||||
}
|
||||
|
||||
public final void write_value(java.io.Serializable value,
|
||||
org.omg.CORBA.portable.BoxedValueHelper factory) {
|
||||
impl.write_value(value, factory);
|
||||
}
|
||||
|
||||
public final void write_abstract_interface(java.lang.Object obj) {
|
||||
impl.write_abstract_interface(obj);
|
||||
}
|
||||
|
||||
// java.io.OutputStream
|
||||
public final void write(byte b[]) throws IOException {
|
||||
impl.write(b);
|
||||
}
|
||||
|
||||
public final void write(byte b[], int off, int len) throws IOException {
|
||||
impl.write(b, off, len);
|
||||
}
|
||||
|
||||
public final void flush() throws IOException {
|
||||
impl.flush();
|
||||
}
|
||||
|
||||
public final void close() throws IOException {
|
||||
impl.close();
|
||||
}
|
||||
|
||||
// com.sun.corba.se.impl.encoding.MarshalOutputStream
|
||||
public final void start_block() {
|
||||
impl.start_block();
|
||||
}
|
||||
|
||||
public final void end_block() {
|
||||
impl.end_block();
|
||||
}
|
||||
|
||||
public final void putEndian() {
|
||||
impl.putEndian();
|
||||
}
|
||||
|
||||
public void writeTo(java.io.OutputStream s)
|
||||
throws IOException
|
||||
{
|
||||
impl.writeTo(s);
|
||||
}
|
||||
|
||||
public final byte[] toByteArray() {
|
||||
return impl.toByteArray();
|
||||
}
|
||||
|
||||
// org.omg.CORBA.DataOutputStream
|
||||
public final void write_Abstract (java.lang.Object value) {
|
||||
impl.write_Abstract(value);
|
||||
}
|
||||
|
||||
public final void write_Value (java.io.Serializable value) {
|
||||
impl.write_Value(value);
|
||||
}
|
||||
|
||||
public final void write_any_array(org.omg.CORBA.Any[] seq, int offset, int length) {
|
||||
impl.write_any_array(seq, offset, length);
|
||||
}
|
||||
|
||||
public void setMessageMediator(MessageMediator messageMediator)
|
||||
{
|
||||
this.corbaMessageMediator = (CorbaMessageMediator) messageMediator;
|
||||
}
|
||||
|
||||
public MessageMediator getMessageMediator()
|
||||
{
|
||||
return corbaMessageMediator;
|
||||
}
|
||||
|
||||
// org.omg.CORBA.portable.ValueBase
|
||||
public final String[] _truncatable_ids() {
|
||||
return impl._truncatable_ids();
|
||||
}
|
||||
|
||||
// Other
|
||||
protected final int getSize() {
|
||||
return impl.getSize();
|
||||
}
|
||||
|
||||
protected final int getIndex() {
|
||||
return impl.getIndex();
|
||||
}
|
||||
|
||||
protected int getRealIndex(int index) {
|
||||
// Used in indirections. Overridden by TypeCodeOutputStream.
|
||||
return index;
|
||||
}
|
||||
|
||||
protected final void setIndex(int value) {
|
||||
impl.setIndex(value);
|
||||
}
|
||||
|
||||
protected final ByteBuffer getByteBuffer() {
|
||||
return impl.getByteBuffer();
|
||||
}
|
||||
|
||||
protected final void setByteBuffer(ByteBuffer byteBuffer) {
|
||||
impl.setByteBuffer(byteBuffer);
|
||||
}
|
||||
|
||||
public final boolean isLittleEndian() {
|
||||
return impl.isLittleEndian();
|
||||
}
|
||||
|
||||
// XREVISIT - return to final if possible
|
||||
// REVISIT - was protected - need access from msgtypes test.
|
||||
public ByteBufferWithInfo getByteBufferWithInfo() {
|
||||
return impl.getByteBufferWithInfo();
|
||||
}
|
||||
|
||||
protected void setByteBufferWithInfo(ByteBufferWithInfo bbwi) {
|
||||
impl.setByteBufferWithInfo(bbwi);
|
||||
}
|
||||
|
||||
// REVISIT: was protected - but need to access from xgiop.
|
||||
public final BufferManagerWrite getBufferManager() {
|
||||
return impl.getBufferManager();
|
||||
}
|
||||
|
||||
public final void write_fixed(java.math.BigDecimal bigDecimal, short digits, short scale) {
|
||||
impl.write_fixed(bigDecimal, digits, scale);
|
||||
}
|
||||
|
||||
public final void writeOctetSequenceTo(org.omg.CORBA.portable.OutputStream s) {
|
||||
impl.writeOctetSequenceTo(s);
|
||||
}
|
||||
|
||||
public final GIOPVersion getGIOPVersion() {
|
||||
return impl.getGIOPVersion();
|
||||
}
|
||||
|
||||
public final void writeIndirection(int tag, int posIndirectedTo) {
|
||||
impl.writeIndirection(tag, posIndirectedTo);
|
||||
}
|
||||
|
||||
// Use Latin-1 for GIOP 1.0 or when code set negotiation was not
|
||||
// performed.
|
||||
protected CodeSetConversion.CTBConverter createCharCTBConverter() {
|
||||
return CodeSetConversion.impl().getCTBConverter(OSFCodeSetRegistry.ISO_8859_1);
|
||||
}
|
||||
|
||||
// Subclasses must decide what to do here. It's inconvenient to
|
||||
// make the class and this method abstract because of dup().
|
||||
protected abstract CodeSetConversion.CTBConverter createWCharCTBConverter();
|
||||
|
||||
protected final void freeInternalCaches() {
|
||||
impl.freeInternalCaches();
|
||||
}
|
||||
|
||||
void printBuffer() {
|
||||
impl.printBuffer();
|
||||
}
|
||||
|
||||
public void alignOnBoundary(int octetBoundary) {
|
||||
impl.alignOnBoundary(octetBoundary);
|
||||
}
|
||||
|
||||
// Needed by request and reply messages for GIOP versions >= 1.2 only.
|
||||
public void setHeaderPadding(boolean headerPadding) {
|
||||
impl.setHeaderPadding(headerPadding);
|
||||
}
|
||||
|
||||
// ValueOutputStream -----------------------------
|
||||
|
||||
public void start_value(String rep_id) {
|
||||
impl.start_value(rep_id);
|
||||
}
|
||||
|
||||
public void end_value() {
|
||||
impl.end_value();
|
||||
}
|
||||
}
|
|
@ -1,164 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2000, 2002, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.interceptors;
|
||||
|
||||
import com.sun.corba.se.impl.corba.AnyImpl;
|
||||
import org.omg.PortableInterceptor.Current;
|
||||
import org.omg.PortableInterceptor.InvalidSlot;
|
||||
|
||||
import com.sun.corba.se.impl.util.MinorCodes;
|
||||
import com.sun.corba.se.impl.core.ORB;
|
||||
|
||||
/**
|
||||
* ThreadCurrentStack is the container of PICurrent instances for each thread
|
||||
*/
|
||||
public class ThreadCurrentStack
|
||||
{
|
||||
// PICurrentPool is the container for reusable PICurrents
|
||||
private class PICurrentPool {
|
||||
|
||||
// Contains a list of reusable PICurrents
|
||||
private java.util.ArrayList pool;
|
||||
|
||||
// High water mark for the pool
|
||||
// If the pool size reaches this limit then putPICurrent will
|
||||
// not put PICurrent to the pool.
|
||||
private static final int HIGH_WATER_MARK = 5;
|
||||
|
||||
// currentIndex points to the last PICurrent in the list
|
||||
private int currentIndex;
|
||||
|
||||
PICurrentPool( ) {
|
||||
pool = new java.util.ArrayList( HIGH_WATER_MARK );
|
||||
currentIndex = 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Puts PICurrent to the re-usable pool.
|
||||
*/
|
||||
void putPICurrent( PICurrent current ) {
|
||||
// If there are enough PICurrents in the pool, then don't add
|
||||
// this current to the pool.
|
||||
if( currentIndex >= HIGH_WATER_MARK ) {
|
||||
return;
|
||||
}
|
||||
pool.add(currentIndex , current);
|
||||
currentIndex++;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets PICurrent from the re-usable pool.
|
||||
*/
|
||||
PICurrent getPICurrent( ) {
|
||||
// If there are no entries in the pool then return null
|
||||
if( currentIndex == 0 ) {
|
||||
return null;
|
||||
}
|
||||
// Works like a stack, Gets the last one added first
|
||||
currentIndex--;
|
||||
return (PICurrent) pool.get(currentIndex);
|
||||
}
|
||||
}
|
||||
|
||||
// Contains all the active PICurrents for each thread.
|
||||
// The ArrayList is made to behave like a stack.
|
||||
private java.util.ArrayList currentContainer;
|
||||
|
||||
// Keeps track of number of PICurrents in the stack.
|
||||
private int currentIndex;
|
||||
|
||||
// For Every Thread there will be a pool of re-usable ThreadCurrent's
|
||||
// stored in PICurrentPool
|
||||
private PICurrentPool currentPool;
|
||||
|
||||
// The orb associated with this ThreadCurrentStack
|
||||
private ORB piOrb;
|
||||
|
||||
/**
|
||||
* Constructs the stack and and PICurrentPool
|
||||
*/
|
||||
ThreadCurrentStack( ORB piOrb, PICurrent current ) {
|
||||
this.piOrb = piOrb;
|
||||
currentIndex = 0;
|
||||
currentContainer = new java.util.ArrayList( );
|
||||
currentPool = new PICurrentPool( );
|
||||
currentContainer.add( currentIndex, current );
|
||||
currentIndex++;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* pushPICurrent goes through the following steps
|
||||
* 1: Checks to see if there is any PICurrent in PICurrentPool
|
||||
* If present then use that instance to push into the ThreadCurrentStack
|
||||
*
|
||||
* 2:If there is no PICurrent in the pool, then creates a new one and pushes
|
||||
* that into the ThreadCurrentStack
|
||||
*/
|
||||
void pushPICurrent( ) {
|
||||
PICurrent current = currentPool.getPICurrent( );
|
||||
if( current == null ) {
|
||||
// get an existing PICurrent to get the slotSize
|
||||
PICurrent currentTemp = peekPICurrent();
|
||||
current = new PICurrent( piOrb, currentTemp.getSlotSize( ));
|
||||
}
|
||||
currentContainer.add( currentIndex, current );
|
||||
currentIndex++;
|
||||
}
|
||||
|
||||
/**
|
||||
* popPICurrent does the following
|
||||
* 1: pops the top PICurrent in the ThreadCurrentStack
|
||||
*
|
||||
* 2: resets the slots in the PICurrent which resets the slotvalues to
|
||||
* null if there are any previous sets.
|
||||
*
|
||||
* 3: pushes the reset PICurrent into the PICurrentPool to reuse
|
||||
*/
|
||||
void popPICurrent( ) {
|
||||
// Do not pop the PICurrent, If there is only one.
|
||||
// This should not happen, But an extra check for safety.
|
||||
if( currentIndex <= 1 ) {
|
||||
throw new org.omg.CORBA.INTERNAL(
|
||||
"Cannot pop the only PICurrent in the stack",
|
||||
MinorCodes.CANT_POP_ONLY_CURRENT_2,
|
||||
CompletionStatus.COMPLETED_NO );
|
||||
}
|
||||
currentIndex--;
|
||||
PICurrent current = (PICurrent)currentContainer.get( currentIndex );
|
||||
current.resetSlots( );
|
||||
currentPool.putPICurrent( current );
|
||||
}
|
||||
|
||||
/**
|
||||
* peekPICurrent gets the top PICurrent in the ThreadCurrentStack without
|
||||
* popping.
|
||||
*/
|
||||
PICurrent peekPICurrent( ) {
|
||||
return (PICurrent) currentContainer.get( currentIndex - 1);
|
||||
}
|
||||
|
||||
}
|
|
@ -1,145 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2001, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.orbutil ;
|
||||
|
||||
import java.lang.reflect.Method;
|
||||
import java.lang.reflect.Modifier;
|
||||
|
||||
/** This class provides just a main method. Its purpose is to allow -D arguments to
|
||||
* set up the system properties when starting programs with tools like OptimizeIt that
|
||||
* make this difficult or impossible.
|
||||
*
|
||||
* Invocation: {java launcher of some kind} DefineClass -Dxxx=yyy -Dxxx=yyy ... {class name} arg0, arg1, ...
|
||||
* Result: updates system properties with -D args, then uses reflection to invoke {class name}.main with the args
|
||||
*/
|
||||
|
||||
class DefineWrapper {
|
||||
public static void main( String[] args )
|
||||
{
|
||||
int numberDefines = args.length ;
|
||||
String className = null ;
|
||||
|
||||
for (int ctr=0; ctr<args.length; ctr++ ) {
|
||||
String arg = args[ctr] ;
|
||||
|
||||
if ((arg.charAt(0) == '-') && (arg.charAt(1) == 'D')) {
|
||||
int eqIndex = arg.indexOf( '=' ) ;
|
||||
if (eqIndex < 0)
|
||||
throw new Exception( arg + " is not a valid property assignment" ) ;
|
||||
|
||||
final String key = arg.subString( 2, eqIndex ) ;
|
||||
final String value = arg.subStrung( eqIndex + 1 ) ;
|
||||
|
||||
AccessController.doPrivileged( new PrivilegedAction() {
|
||||
public Object run() {
|
||||
System.setProperty( key, value ) ;
|
||||
return null ;
|
||||
}
|
||||
} ) ;
|
||||
} else {
|
||||
numberDefines = ctr ;
|
||||
className = arg ;
|
||||
break ;
|
||||
}
|
||||
}
|
||||
|
||||
if (numberDefines < args.length) {
|
||||
Class cls = getMainClass( className ) ;
|
||||
Method mainMethod = getMainMethod( cls ) ;
|
||||
|
||||
String[] newArgs = new String[ args.length - numberDefines ] ;
|
||||
for (int ctr = numberDefines+1; ctr<args.length; ctr++ ) {
|
||||
newArgs[ ctr-numberDefines-1 ] = args[ ctr ] ;
|
||||
}
|
||||
|
||||
// build args to the main and call it
|
||||
Object params [] = new Object [1];
|
||||
params[0] = newArgs;
|
||||
mainMethod.invoke(null, params);
|
||||
} else {
|
||||
throw new Exception( "No class name given" ) ;
|
||||
}
|
||||
}
|
||||
|
||||
private static Class getMainClass( String name )
|
||||
{
|
||||
// determine the class loader to be used for loading the class
|
||||
// since ServerMain is going to be in JDK and we need to have this
|
||||
// class to load application classes, this is required here.
|
||||
ClassLoader cl = Thread.currentThread().getContextClassLoader();
|
||||
|
||||
if (cl == null)
|
||||
cl = ClassLoader.getSystemClassLoader();
|
||||
|
||||
try {
|
||||
// determine the main class, try loading with current class loader
|
||||
cls = Class.forName( className ) ;
|
||||
} catch (ClassNotFoundException ex) {
|
||||
// eat the exception and try to load using SystemClassLoader
|
||||
cls = Class.forName( className, true, cl);
|
||||
}
|
||||
}
|
||||
|
||||
private static Method getMainMethod( Class serverClass )
|
||||
{
|
||||
Class argTypes[] = new Class[] { String[].class } ;
|
||||
Method method = null ;
|
||||
|
||||
try {
|
||||
method = serverClass.getDeclaredMethod( "main", argTypes ) ;
|
||||
} catch (Exception exc) {
|
||||
throw new Exception( "Could not get main() method: " + exc ) ;
|
||||
}
|
||||
|
||||
if (!isPublicStaticVoid( method ))
|
||||
throw new Exception( "Main method is not public static void" ) ;
|
||||
|
||||
return method ;
|
||||
}
|
||||
|
||||
private static boolean isPublicStaticVoid( Method method )
|
||||
{
|
||||
// check modifiers: public static
|
||||
int modifiers = method.getModifiers ();
|
||||
if (!Modifier.isPublic (modifiers) || !Modifier.isStatic (modifiers)) {
|
||||
logError( method.getName() + " is not public static" ) ;
|
||||
return false ;
|
||||
}
|
||||
|
||||
// check return type and exceptions
|
||||
if (method.getExceptionTypes ().length != 0) {
|
||||
logError( method.getName() + " declares exceptions" ) ;
|
||||
return false ;
|
||||
}
|
||||
|
||||
if (!method.getReturnType().equals (Void.TYPE)) {
|
||||
logError( method.getName() + " does not have a void return type" ) ;
|
||||
return false ;
|
||||
}
|
||||
|
||||
return true ;
|
||||
}
|
||||
}
|
|
@ -1,909 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2004, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.presentation.rmi ;
|
||||
|
||||
import java.lang.reflect.Method;
|
||||
|
||||
import java.math.BigInteger;
|
||||
|
||||
import java.util.Map;
|
||||
import java.util.Set;
|
||||
import java.util.HashSet;
|
||||
import java.util.Iterator;
|
||||
import java.util.HashMap;
|
||||
import java.util.StringTokenizer;
|
||||
|
||||
import com.sun.corba.se.spi.presentation.rmi.IDLNameTranslator ;
|
||||
|
||||
import com.sun.corba.se.impl.presentation.rmi.IDLType ;
|
||||
import com.sun.corba.se.impl.presentation.rmi.IDLTypeException ;
|
||||
import com.sun.corba.se.impl.presentation.rmi.IDLTypesUtil ;
|
||||
import com.sun.corba.se.impl.orbutil.ObjectUtility ;
|
||||
|
||||
/**
|
||||
* Bidirectional translator between RMI-IIOP interface methods and
|
||||
* and IDL Names.
|
||||
*/
|
||||
public class IDLNameTranslatorImpl implements IDLNameTranslator {
|
||||
|
||||
// From CORBA Spec, Table 6 Keywords.
|
||||
// Note that since all IDL identifiers are case
|
||||
// insensitive, java identifier comparisons to these
|
||||
// will be case insensitive also.
|
||||
private static String[] IDL_KEYWORDS = {
|
||||
|
||||
"abstract", "any", "attribute", "boolean", "case", "char",
|
||||
"const", "context", "custom", "default", "double", "enum",
|
||||
"exception", "factory", "FALSE", "fixed", "float", "in", "inout",
|
||||
"interface", "long", "module", "native", "Object", "octet",
|
||||
"oneway", "out", "private", "public", "raises", "readonly", "sequence",
|
||||
"short", "string", "struct", "supports", "switch", "TRUE", "truncatable",
|
||||
"typedef", "unsigned", "union", "ValueBase", "valuetype", "void",
|
||||
"wchar", "wstring"
|
||||
|
||||
};
|
||||
|
||||
private static char[] HEX_DIGITS = {
|
||||
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
|
||||
'A', 'B', 'C', 'D', 'E', 'F'
|
||||
};
|
||||
|
||||
private static final String UNDERSCORE = "_";
|
||||
|
||||
// used to mangle java inner class names
|
||||
private static final String INNER_CLASS_SEPARATOR =
|
||||
UNDERSCORE + UNDERSCORE;
|
||||
|
||||
// used to form IDL array type names
|
||||
private static final String[] BASE_IDL_ARRAY_MODULE_TYPE=
|
||||
new String[] { "org", "omg", "boxedRMI" } ;
|
||||
|
||||
private static final String BASE_IDL_ARRAY_ELEMENT_TYPE = "seq";
|
||||
|
||||
// used to mangling java identifiers that have a leading underscore
|
||||
private static final String LEADING_UNDERSCORE_CHAR = "J";
|
||||
private static final String ID_CONTAINER_CLASH_CHAR = UNDERSCORE;
|
||||
|
||||
// separator used between types in a mangled overloaded method name
|
||||
private static final String OVERLOADED_TYPE_SEPARATOR =
|
||||
UNDERSCORE + UNDERSCORE;
|
||||
|
||||
// string appended to attribute if it clashes with a method name
|
||||
private static final String ATTRIBUTE_METHOD_CLASH_MANGLE_CHARS =
|
||||
UNDERSCORE + UNDERSCORE;
|
||||
|
||||
private static Set idlKeywords_;
|
||||
|
||||
static {
|
||||
|
||||
idlKeywords_ = new HashSet();
|
||||
for(int i = 0; i < IDL_KEYWORDS.length; i++) {
|
||||
String next = (String) IDL_KEYWORDS[i];
|
||||
// Convert keyword to all caps to ease equality
|
||||
// check.
|
||||
String keywordAllCaps = next.toUpperCase();
|
||||
idlKeywords_.add(keywordAllCaps);
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
//
|
||||
// Instance state
|
||||
//
|
||||
|
||||
// Remote interface for name translation.
|
||||
private Class[] interf_;
|
||||
|
||||
// Maps used to hold name translations. These do not need to be
|
||||
// synchronized since the translation is never modified after
|
||||
// initialization.
|
||||
private Map methodToIDLNameMap_;
|
||||
private Map IDLNameToMethodMap_;
|
||||
private Method[] methods_;
|
||||
|
||||
/**
|
||||
* Return an IDLNameTranslator for the given interface.
|
||||
*
|
||||
* @throws IllegalStateException if given class is not a valid
|
||||
* RMI/IIOP Remote Interface
|
||||
*/
|
||||
public static IDLNameTranslator get( Class interf )
|
||||
{
|
||||
|
||||
return new IDLNameTranslatorImpl(new Class[] { interf } );
|
||||
|
||||
}
|
||||
|
||||
/**
|
||||
* Return an IDLNameTranslator for the given interfacex.
|
||||
*
|
||||
* @throws IllegalStateException if given classes are not valid
|
||||
* RMI/IIOP Remote Interfaces
|
||||
*/
|
||||
public static IDLNameTranslator get( Class[] interfaces )
|
||||
{
|
||||
|
||||
return new IDLNameTranslatorImpl(interfaces );
|
||||
|
||||
}
|
||||
|
||||
public static String getExceptionId( Class cls )
|
||||
{
|
||||
// Requirements for this method:
|
||||
// 1. cls must be an exception but not a RemoteException.
|
||||
// 2. If cls has an IDL keyword name, an underscore is prepended (1.3.2.2).
|
||||
// 3. If cls jas a leading underscore, J is prepended (1.3.2.3).
|
||||
// 4. If cls has an illegal IDL ident char, it is mapped to UXXXX where
|
||||
// XXXX is the unicode value in hex of the char (1.3.2.4).
|
||||
// 5. double underscore for inner class (1.3.2.5).
|
||||
// 6. The ID is "IDL:" + name with / separators + ":1.0".
|
||||
IDLType itype = classToIDLType( cls ) ;
|
||||
return itype.getExceptionName() ;
|
||||
}
|
||||
|
||||
public Class[] getInterfaces()
|
||||
{
|
||||
return interf_;
|
||||
}
|
||||
|
||||
public Method[] getMethods()
|
||||
{
|
||||
return methods_ ;
|
||||
}
|
||||
|
||||
public Method getMethod( String idlName )
|
||||
{
|
||||
return (Method) IDLNameToMethodMap_.get(idlName);
|
||||
}
|
||||
|
||||
public String getIDLName( Method method )
|
||||
{
|
||||
return (String) methodToIDLNameMap_.get(method);
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize an IDLNameTranslator for the given interface.
|
||||
*
|
||||
* @throws IllegalStateException if given class is not a valid
|
||||
* RMI/IIOP Remote Interface
|
||||
*/
|
||||
private IDLNameTranslatorImpl(Class[] interfaces)
|
||||
{
|
||||
|
||||
try {
|
||||
IDLTypesUtil idlTypesUtil = new IDLTypesUtil();
|
||||
for (int ctr=0; ctr<interfaces.length; ctr++)
|
||||
idlTypesUtil.validateRemoteInterface(interfaces[ctr]);
|
||||
interf_ = interfaces;
|
||||
buildNameTranslation();
|
||||
} catch( IDLTypeException ite) {
|
||||
String msg = ite.getMessage();
|
||||
IllegalStateException ise = new IllegalStateException(msg);
|
||||
ise.initCause(ite);
|
||||
throw ise;
|
||||
}
|
||||
}
|
||||
|
||||
private void buildNameTranslation()
|
||||
{
|
||||
// holds method info, keyed by method
|
||||
Map allMethodInfo = new HashMap() ;
|
||||
|
||||
for (int ctr=0; ctr<interf_.length; ctr++) {
|
||||
Class interf = interf_[ctr] ;
|
||||
|
||||
IDLTypesUtil idlTypesUtil = new IDLTypesUtil();
|
||||
Method[] methods = interf.getMethods();
|
||||
|
||||
// Take an initial pass through all the methods and create some
|
||||
// information that will be used to track the IDL name
|
||||
// transformation.
|
||||
for(int i = 0; i < methods.length; i++) {
|
||||
|
||||
Method nextMethod = methods[i];
|
||||
|
||||
IDLMethodInfo methodInfo = new IDLMethodInfo();
|
||||
|
||||
methodInfo.method = nextMethod;
|
||||
|
||||
methodInfo.propertyType =
|
||||
idlTypesUtil.propertyAccessorMethodType(
|
||||
nextMethod, interf ) ;
|
||||
|
||||
if (methodInfo.propertyType != null) {
|
||||
String attributeName = idlTypesUtil.
|
||||
getAttributeNameForProperty(nextMethod.getName());
|
||||
methodInfo.originalName = attributeName;
|
||||
methodInfo.mangledName = attributeName;
|
||||
} else {
|
||||
methodInfo.originalName = nextMethod.getName();
|
||||
methodInfo.mangledName = nextMethod.getName();
|
||||
}
|
||||
|
||||
allMethodInfo.put(nextMethod, methodInfo);
|
||||
}
|
||||
}
|
||||
|
||||
// Check for having both is<NAME> and get<NAME> methods.
|
||||
|
||||
|
||||
//
|
||||
// Perform case sensitivity test first. This applies to all
|
||||
// method names AND attributes. Compare each method name and
|
||||
// attribute to all other method names and attributes. If names
|
||||
// differ only in case, apply mangling as defined in section 1.3.2.7
|
||||
// of Java2IDL spec. Note that we compare using the original names.
|
||||
//
|
||||
for(Iterator outerIter=allMethodInfo.values().iterator();
|
||||
outerIter.hasNext();) {
|
||||
IDLMethodInfo outer = (IDLMethodInfo) outerIter.next();
|
||||
for(Iterator innerIter = allMethodInfo.values().iterator();
|
||||
innerIter.hasNext();) {
|
||||
IDLMethodInfo inner = (IDLMethodInfo) innerIter.next();
|
||||
|
||||
if( (outer != inner) &&
|
||||
(!outer.originalName.equals(inner.originalName)) &&
|
||||
outer.originalName.equalsIgnoreCase(inner.originalName) ) {
|
||||
outer.mangledName =
|
||||
mangleCaseSensitiveCollision(outer.originalName);
|
||||
break;
|
||||
}
|
||||
|
||||
}
|
||||
}
|
||||
|
||||
for(Iterator iter = allMethodInfo.values().iterator();
|
||||
iter.hasNext();) {
|
||||
IDLMethodInfo next = (IDLMethodcurrentInfo) iter.next();
|
||||
next.mangledName =
|
||||
mangleIdentifier(next.mangledName,
|
||||
next.propertyType != null);
|
||||
}
|
||||
|
||||
//
|
||||
// Now check for overloaded method names and apply 1.3.2.6.
|
||||
//
|
||||
for(Iterator outerIter=allMethodInfo.values().iterator();
|
||||
outerIter.hasNext();) {
|
||||
IDLMethodInfo outer = (IDLMethodInfo) outerIter.next();
|
||||
if (outer.propertyType != null) {
|
||||
continue;
|
||||
}
|
||||
for(Iterator innerIter = allMethodInfo.values().iterator();
|
||||
innerIter.hasNext();) {
|
||||
IDLMethodInfo inner = (IDLMethodInfo) innerIter.next();
|
||||
|
||||
if( (outer != inner) &&
|
||||
(inner.propertyType == null) &&
|
||||
outer.originalName.equals(inner.originalName) ) {
|
||||
outer.mangledName = mangleOverloadedMethod
|
||||
(outer.mangledName, outer.method);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Now mangle any properties that clash with method names.
|
||||
//
|
||||
for(Iterator outerIter=allMethodInfo.values().iterator();
|
||||
outerIter.hasNext();) {
|
||||
IDLMethodInfo outer = (IDLMethodInfo) outerIter.next();
|
||||
if(outer.propertyType == null) {
|
||||
continue;
|
||||
}
|
||||
for(Iterator innerIter = allMethodInfo.values().iterator();
|
||||
innerIter.hasNext();) {
|
||||
IDLMethodInfo inner = (IDLMethodInfo) innerIter.next();
|
||||
if( (outer != inner) &&
|
||||
(inner.propertyType == null) &&
|
||||
outer.mangledName.equals(inner.mangledName) ) {
|
||||
outer.mangledName = outer.mangledName +
|
||||
ATTRIBUTE_METHOD_CLASH_MANGLE_CHARS;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Ensure that no mapped method names clash with mapped name
|
||||
// of container(1.3.2.9). This is a case insensitive comparison.
|
||||
//
|
||||
for (int ctr=0; ctr<interf_.length; ctr++ ) {
|
||||
Class interf = interf_[ctr] ;
|
||||
String mappedContainerName = getMappedContainerName(interf);
|
||||
for(Iterator iter = allMethodInfo.values().iterator();
|
||||
iter.hasNext();) {
|
||||
IDLMethodInfo next = (IDLMethodInfo) iter.next();
|
||||
if( (next.propertyType == null) &&
|
||||
identifierClashesWithContainer(mappedContainerName,
|
||||
next.mangledName)) {
|
||||
next.mangledName = mangleContainerClash(next.mangledName);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// Populate name translation maps.
|
||||
//
|
||||
methodToIDLNameMap_ = new HashMap();
|
||||
IDLNameToMethodMap_ = new HashMap();
|
||||
methods_ = (Method[])allMethodInfo.keySet().toArray(
|
||||
new Method[0] ) ;
|
||||
|
||||
for(Iterator iter = allMethodInfo.values().iterator();
|
||||
iter.hasNext();) {
|
||||
IDLMethodInfo next = (IDLMethodInfo) iter.next();
|
||||
String idlName = next.mangledName;
|
||||
if (next.propertyType != null) {
|
||||
idlName = javaPropertyPrefixToIDL( next.propertyType ) +
|
||||
next.mangledName ;
|
||||
}
|
||||
|
||||
methodToIDLNameMap_.put(next.method, idlName);
|
||||
|
||||
// Final check to see if there are any clashes after all the
|
||||
// manglings have been applied. If so, this is treated as an
|
||||
// invalid interface. Currently, we do a CASE-SENSITIVE
|
||||
// comparison since that matches the rmic behavior.
|
||||
// @@@ Shouldn't this be a case-insensitive check?
|
||||
// If there is a collision between is<TYPE> and get<TYPE>,
|
||||
// map only is<TYPE> to an attribute, and leave the
|
||||
// get<TYPE> method alone.
|
||||
if( IDLNameToMethodMap_.containsKey(idlName) ) {
|
||||
// @@@ I18N
|
||||
Method clash = (Method) IDLNameToMethodMap_.get(idlName);
|
||||
MethodInfo clashMethodInfo =
|
||||
(MethodInfo)allMethodInfo.get( clash ) ;
|
||||
if (clashMethodInfo.isBooleanProperty() &&
|
||||
next.isReadProperty()) {
|
||||
// fix idlName
|
||||
} else if (clashMethodInfo.isReadProperty() &&
|
||||
next.isBooleanProperty()) {
|
||||
// Remove entry under idlName
|
||||
// put entry into table under correct name
|
||||
} else {
|
||||
throw new IllegalStateException("Error : methods " +
|
||||
clash + " and " + next.method +
|
||||
" both result in IDL name '" + idlName + "'");
|
||||
}
|
||||
}
|
||||
|
||||
IDLNameToMethodMap_.put(idlName, next.method);
|
||||
}
|
||||
|
||||
return;
|
||||
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Perform all necessary stand-alone identifier mangling operations
|
||||
* on a java identifier that is being transformed into an IDL name.
|
||||
* That is, mangling operations that don't require looking at anything
|
||||
* else but the identifier itself. This covers sections 1.3.2.2, 1.3.2.3,
|
||||
* and 1.3.2.4 of the Java2IDL spec. Method overloading and
|
||||
* case-sensitivity checks are handled elsewhere.
|
||||
*/
|
||||
|
||||
private static String mangleIdentifier(String identifier) {
|
||||
return mangleIdentifier(identifier, false);
|
||||
}
|
||||
|
||||
private static String mangleIdentifier(String identifier, boolean attribute) {
|
||||
|
||||
String mangledName = identifier;
|
||||
|
||||
//
|
||||
// Apply leading underscore test (1.3.2.3)
|
||||
// This should be done before IDL Keyword clash test, since clashing
|
||||
// IDL keywords are mangled by adding a leading underscore.
|
||||
//
|
||||
if( hasLeadingUnderscore(mangledName) ) {
|
||||
mangledName = mangleLeadingUnderscore(mangledName);
|
||||
}
|
||||
|
||||
//
|
||||
// Apply IDL keyword clash test (1.3.2.2).
|
||||
// This is not needed for attributes since when the full property
|
||||
// name is composed it cannot clash with an IDL keyword.
|
||||
// (Also, rmic doesn't do it.)
|
||||
//
|
||||
|
||||
if( !attribute && isIDLKeyword(mangledName) ) {
|
||||
mangledName = mangleIDLKeywordClash(mangledName);
|
||||
}
|
||||
|
||||
//
|
||||
// Replace illegal IDL identifier characters (1.3.2.4)
|
||||
// for all method names and attributes.
|
||||
//
|
||||
if( !isIDLIdentifier(mangledName) ) {
|
||||
mangledName = mangleUnicodeChars(mangledName);
|
||||
}
|
||||
|
||||
return mangledName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks whether a java identifier clashes with an
|
||||
* IDL keyword. Note that this is a case-insensitive
|
||||
* comparison.
|
||||
*
|
||||
* Used to implement section 1.3.2.2 of Java2IDL spec.
|
||||
*/
|
||||
private static boolean isIDLKeyword(String identifier) {
|
||||
|
||||
String identifierAllCaps = identifier.toUpperCase();
|
||||
|
||||
return idlKeywords_.contains(identifierAllCaps);
|
||||
}
|
||||
|
||||
private static String mangleIDLKeywordClash(String identifier) {
|
||||
return UNDERSCORE + identifier;
|
||||
}
|
||||
|
||||
private static String mangleLeadingUnderscore(String identifier) {
|
||||
return LEADING_UNDERSCORE_CHAR + identifier;
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks whether a java identifier starts with an underscore.
|
||||
* Used to implement section 1.3.2.3 of Java2IDL spec.
|
||||
*/
|
||||
private static boolean hasLeadingUnderscore(String identifier) {
|
||||
return identifier.startsWith(UNDERSCORE);
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements Section 1.3.2.4 of Java2IDL Mapping.
|
||||
* All non-IDL identifier characters must be replaced
|
||||
* with their Unicode representation.
|
||||
*/
|
||||
static String mangleUnicodeChars(String identifier) {
|
||||
StringBuffer mangledIdentifier = new StringBuffer();
|
||||
|
||||
for(int i = 0; i < identifier.length(); i++) {
|
||||
char nextChar = identifier.charAt(i);
|
||||
if( isIDLIdentifierChar(nextChar) ) {
|
||||
mangledIdentifier.append(nextChar);
|
||||
} else {
|
||||
String unicode = charToUnicodeRepresentation(nextChar);
|
||||
mangledIdentifier.append(unicode);
|
||||
}
|
||||
}
|
||||
|
||||
return mangledIdentifier.toString();
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements mangling portion of Section 1.3.2.7 of Java2IDL spec.
|
||||
* This method only deals with the actual mangling. Decision about
|
||||
* whether case-sensitive collision mangling is required is made
|
||||
* elsewhere.
|
||||
*
|
||||
*
|
||||
* "...a mangled name is generated consisting of the original name
|
||||
* followed by an underscore separated list of decimal indices
|
||||
* into the string, where the indices identify all the upper case
|
||||
* characters in the original string. Indices are zero based."
|
||||
*
|
||||
*/
|
||||
String mangleCaseSensitiveCollision(String identifier) {
|
||||
|
||||
StringBuffer mangledIdentifier = new StringBuffer(identifier);
|
||||
|
||||
// There is always at least one trailing underscore, whether or
|
||||
// not the identifier has uppercase letters.
|
||||
mangledIdentifier.append(UNDERSCORE);
|
||||
|
||||
boolean needUnderscore = false;
|
||||
for(int i = 0; i < identifier.length(); i++) {
|
||||
char next = identifier.charAt(i);
|
||||
if( Character.isUpperCase(next) ) {
|
||||
// This bit of logic is needed to ensure that we have
|
||||
// an underscore separated list of indices but no
|
||||
// trailing underscores. Basically, after we have at least
|
||||
// one uppercase letter, we always put an undercore before
|
||||
// printing the next one.
|
||||
if( needUnderscore ) {
|
||||
mangledIdentifier.append(UNDERSCORE);
|
||||
}
|
||||
mangledIdentifier.append(i);
|
||||
needUnderscore = true;
|
||||
}
|
||||
}
|
||||
|
||||
return mangledIdentifier.toString();
|
||||
}
|
||||
|
||||
private static String mangleContainerClash(String identifier) {
|
||||
return identifier + ID_CONTAINER_CLASH_CHAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements Section 1.3.2.9 of Java2IDL Mapping. Container in this
|
||||
* context means the name of the java Class(excluding package) in which
|
||||
* the identifier is defined. Comparison is case-insensitive.
|
||||
*/
|
||||
private static boolean identifierClashesWithContainer
|
||||
(String mappedContainerName, String identifier) {
|
||||
|
||||
return identifier.equalsIgnoreCase(mappedContainerName);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns Unicode mangling as defined in Section 1.3.2.4 of
|
||||
* Java2IDL spec.
|
||||
*
|
||||
* "For Java identifiers that contain illegal OMG IDL identifier
|
||||
* characters such as '$' or Unicode characters outside of ISO Latin 1,
|
||||
* any such illegal characters are replaced by "U" followed by the
|
||||
* 4 hexadecimal characters(in upper case) representing the Unicode
|
||||
* value. So, the Java name a$b is mapped to aU0024b and
|
||||
* x\u03bCy is mapped to xU03BCy."
|
||||
*/
|
||||
public static String charToUnicodeRepresentation(char c) {
|
||||
|
||||
int orig = (int) c;
|
||||
StringBuffer hexString = new StringBuffer();
|
||||
|
||||
int value = orig;
|
||||
|
||||
while( value > 0 ) {
|
||||
int div = value / 16;
|
||||
int mod = value % 16;
|
||||
hexString.insert(0, HEX_DIGITS[mod]);
|
||||
value = div;
|
||||
}
|
||||
|
||||
int numZerosToAdd = 4 - hexString.length();
|
||||
for(int i = 0; i < numZerosToAdd; i++) {
|
||||
hexString.insert(0, "0");
|
||||
}
|
||||
|
||||
hexString.insert(0, "U");
|
||||
return hexString.toString();
|
||||
}
|
||||
|
||||
private static boolean isIDLIdentifier(String identifier) {
|
||||
|
||||
boolean isIdentifier = true;
|
||||
|
||||
for(int i = 0; i < identifier.length(); i++) {
|
||||
char nextChar = identifier.charAt(i);
|
||||
// 1st char must be alphbetic.
|
||||
isIdentifier = (i == 0) ?
|
||||
isIDLAlphabeticChar(nextChar) :
|
||||
isIDLIdentifierChar(nextChar);
|
||||
if( !isIdentifier ) {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return isIdentifier;
|
||||
|
||||
}
|
||||
|
||||
private static boolean isIDLIdentifierChar(char c) {
|
||||
return (isIDLAlphabeticChar(c) ||
|
||||
isIDLDecimalDigit(c) ||
|
||||
isUnderscore(c));
|
||||
}
|
||||
|
||||
/**
|
||||
* True if character is one of 114 Alphabetic characters as
|
||||
* specified in Table 2 of Chapter 3 in CORBA spec.
|
||||
*/
|
||||
private static boolean isIDLAlphabeticChar(char c) {
|
||||
|
||||
// NOTE that we can't use the java.lang.Character
|
||||
// isUpperCase, isLowerCase, etc. methods since they
|
||||
// include many characters other than the Alphabetic list in
|
||||
// the CORBA spec. Instead, we test for inclusion in the
|
||||
// Unicode value ranges for the corresponding legal characters.
|
||||
|
||||
boolean alphaChar =
|
||||
(
|
||||
// A - Z
|
||||
((c >= 0x0041) && (c <= 0x005A))
|
||||
|
||||
||
|
||||
|
||||
// a - z
|
||||
((c >= 0x0061) && (c <= 0x007A))
|
||||
|
||||
||
|
||||
|
||||
// other letter uppercase, other letter lowercase, which is
|
||||
// the entire upper half of C1 Controls except X and /
|
||||
((c >= 0x00C0) && (c <= 0x00FF)
|
||||
&& (c != 0x00D7) && (c != 0x00F7)));
|
||||
|
||||
return alphaChar;
|
||||
}
|
||||
|
||||
/**
|
||||
* True if character is one of 10 Decimal Digits
|
||||
* specified in Table 3 of Chapter 3 in CORBA spec.
|
||||
*/
|
||||
private static boolean isIDLDecimalDigit(char c) {
|
||||
return ( (c >= 0x0030) && (c <= 0x0039) );
|
||||
}
|
||||
|
||||
private static boolean isUnderscore(char c) {
|
||||
return ( c == 0x005F );
|
||||
}
|
||||
|
||||
/**
|
||||
* Mangle an overloaded method name as defined in Section 1.3.2.6 of
|
||||
* Java2IDL spec. Current value of method name is passed in as argument.
|
||||
* We can't start from original method name since the name might have
|
||||
* been partially mangled as a result of the other rules.
|
||||
*/
|
||||
private static String mangleOverloadedMethod(String mangledName, Method m) {
|
||||
|
||||
IDLTypesUtil idlTypesUtil = new IDLTypesUtil();
|
||||
|
||||
// Start by appending the separator string
|
||||
String newMangledName = mangledName + OVERLOADED_TYPE_SEPARATOR;
|
||||
|
||||
Class[] parameterTypes = m.getParameterTypes();
|
||||
|
||||
for(int i = 0; i < parameterTypes.length; i++) {
|
||||
Class nextParamType = parameterTypes[i];
|
||||
|
||||
if( i > 0 ) {
|
||||
newMangledName = newMangledName + OVERLOADED_TYPE_SEPARATOR;
|
||||
}
|
||||
IDLType idlType = classToIDLType(nextParamType);
|
||||
|
||||
String moduleName = idlType.getModuleName();
|
||||
String memberName = idlType.getMemberName();
|
||||
|
||||
String typeName = (moduleName.length() > 0) ?
|
||||
moduleName + UNDERSCORE + memberName : memberName;
|
||||
|
||||
if( !idlTypesUtil.isPrimitive(nextParamType) &&
|
||||
(idlTypesUtil.getSpecialCaseIDLTypeMapping(nextParamType)
|
||||
== null) &&
|
||||
isIDLKeyword(typeName) ) {
|
||||
typeName = mangleIDLKeywordClash(typeName);
|
||||
}
|
||||
|
||||
typeName = mangleUnicodeChars(typeName);
|
||||
|
||||
newMangledName = newMangledName + typeName;
|
||||
}
|
||||
|
||||
return newMangledName;
|
||||
}
|
||||
|
||||
|
||||
private static IDLType classToIDLType(Class c) {
|
||||
|
||||
IDLType idlType = null;
|
||||
IDLTypesUtil idlTypesUtil = new IDLTypesUtil();
|
||||
|
||||
if( idlTypesUtil.isPrimitive(c) ) {
|
||||
|
||||
idlType = idlTypesUtil.getPrimitiveIDLTypeMapping(c);
|
||||
|
||||
} else if( c.isArray() ) {
|
||||
|
||||
// Calculate array depth, as well as base element type.
|
||||
Class componentType = c.getComponentType();
|
||||
int numArrayDimensions = 1;
|
||||
while(componentType.isArray()) {
|
||||
componentType = componentType.getComponentType();
|
||||
numArrayDimensions++;
|
||||
}
|
||||
IDLType componentIdlType = classToIDLType(componentType);
|
||||
|
||||
String[] modules = BASE_IDL_ARRAY_MODULE_TYPE;
|
||||
if( componentIdlType.hasModule() ) {
|
||||
modules = (String[])ObjectUtility.concatenateArrays( modules,
|
||||
componentIdlType.getModules() ) ;
|
||||
}
|
||||
|
||||
String memberName = BASE_IDL_ARRAY_ELEMENT_TYPE +
|
||||
numArrayDimensions + UNDERSCORE +
|
||||
componentIdlType.getMemberName();
|
||||
|
||||
idlType = new IDLType(c, modules, memberName);
|
||||
|
||||
} else {
|
||||
idlType = idlTypesUtil.getSpecialCaseIDLTypeMapping(c);
|
||||
|
||||
if (idlType == null) {
|
||||
// Section 1.3.2.5 of Java2IDL spec defines mangling rules for
|
||||
// inner classes.
|
||||
String memberName = getUnmappedContainerName(c);
|
||||
|
||||
// replace inner class separator with double underscore
|
||||
memberName = memberName.replaceAll("\\$",
|
||||
INNER_CLASS_SEPARATOR);
|
||||
|
||||
if( hasLeadingUnderscore(memberName) ) {
|
||||
memberName = mangleLeadingUnderscore(memberName);
|
||||
}
|
||||
|
||||
// Get raw package name. If there is a package, it
|
||||
// will still have the "." separators and none of the
|
||||
// mangling rules will have been applied.
|
||||
String packageName = getPackageName(c);
|
||||
|
||||
if (packageName == null) {
|
||||
idlType = new IDLType( c, memberName ) ;
|
||||
} else {
|
||||
// If this is a generated IDL Entity Type we need to
|
||||
// prepend org_omg_boxedIDL per sections 1.3.5 and 1.3.9
|
||||
if (idlTypesUtil.isEntity(c)) {
|
||||
packageName = "org.omg.boxedIDL." + packageName ;
|
||||
}
|
||||
|
||||
// Section 1.3.2.1 and 1.3.2.6 of Java2IDL spec defines
|
||||
// rules for mapping java packages to IDL modules and for
|
||||
// mangling module name portion of type name. NOTE that
|
||||
// of the individual identifier mangling rules,
|
||||
// only the leading underscore test is done here.
|
||||
// The other two(IDL Keyword, Illegal Unicode chars) are
|
||||
// done in mangleOverloadedMethodName.
|
||||
StringTokenizer tokenizer =
|
||||
new StringTokenizer(packageName, ".");
|
||||
|
||||
String[] modules = new String[ tokenizer.countTokens() ] ;
|
||||
int index = 0 ;
|
||||
while (tokenizer.hasMoreElements()) {
|
||||
String next = tokenizer.nextToken();
|
||||
String nextMangled = hasLeadingUnderscore(next) ?
|
||||
mangleLeadingUnderscore(next) : next;
|
||||
|
||||
modules[index++] = nextMangled ;
|
||||
}
|
||||
|
||||
idlType = new IDLType(c, modules, memberName);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return idlType;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return Class' package name or null if there is no package.
|
||||
*/
|
||||
private static String getPackageName(Class c) {
|
||||
Package thePackage = c.getPackage();
|
||||
String packageName = null;
|
||||
|
||||
// Try to get package name by introspection. Some classloaders might
|
||||
// not provide this information, so check for null.
|
||||
if( thePackage != null ) {
|
||||
packageName = thePackage.getName();
|
||||
} else {
|
||||
// brute force method
|
||||
String fullyQualifiedClassName = c.getName();
|
||||
int lastDot = fullyQualifiedClassName.indexOf('.');
|
||||
packageName = (lastDot == -1) ? null :
|
||||
fullyQualifiedClassName.substring(0, lastDot);
|
||||
}
|
||||
return packageName;
|
||||
}
|
||||
|
||||
private static String getMappedContainerName(Class c) {
|
||||
String unmappedName = getUnmappedContainerName(c);
|
||||
|
||||
return mangleIdentifier(unmappedName);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return portion of class name excluding package name.
|
||||
*/
|
||||
private static String getUnmappedContainerName(Class c) {
|
||||
|
||||
String memberName = null;
|
||||
String packageName = getPackageName(c);
|
||||
|
||||
String fullyQualifiedClassName = c.getName();
|
||||
|
||||
if( packageName != null ) {
|
||||
int packageLength = packageName.length();
|
||||
memberName = fullyQualifiedClassName.substring(packageLength + 1);
|
||||
} else {
|
||||
memberName = fullyQualifiedClassName;
|
||||
|
||||
}
|
||||
|
||||
return memberName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Internal helper class for tracking information related to each
|
||||
* interface method while we're building the name translation table.
|
||||
*/
|
||||
private static class IDLMethodInfo
|
||||
{
|
||||
public Method method;
|
||||
public String propertyType;
|
||||
|
||||
// If this is a property, originalName holds the original
|
||||
// attribute name. Otherwise, it holds the original method name.
|
||||
public String originalName;
|
||||
|
||||
// If this is a property, mangledName holds the mangled attribute
|
||||
// name. Otherwise, it holds the mangled method name.
|
||||
public String mangledName;
|
||||
|
||||
}
|
||||
|
||||
public String toString() {
|
||||
|
||||
StringBuffer contents = new StringBuffer();
|
||||
contents.append("IDLNameTranslator[" );
|
||||
for( int ctr=0; ctr<interf_.length; ctr++) {
|
||||
if (ctr != 0)
|
||||
contents.append( " " ) ;
|
||||
contents.append( interf_[ctr].getName() ) ;
|
||||
}
|
||||
contents.append("]\n");
|
||||
for(Iterator iter = methodToIDLNameMap_.keySet().iterator();
|
||||
iter.hasNext();) {
|
||||
|
||||
Method method = (Method) iter.next();
|
||||
String idlName = (String) methodToIDLNameMap_.get(method);
|
||||
|
||||
contents.append(idlName + ":" + method + "\n");
|
||||
|
||||
}
|
||||
|
||||
return contents.toString();
|
||||
}
|
||||
|
||||
public static void main(String[] args) {
|
||||
|
||||
Class remoteInterface = java.rmi.Remote.class;
|
||||
|
||||
if( args.length > 0 ) {
|
||||
String className = args[0];
|
||||
try {
|
||||
remoteInterface = Class.forName(className);
|
||||
} catch(Exception e) {
|
||||
e.printStackTrace();
|
||||
System.exit(-1);
|
||||
}
|
||||
}
|
||||
|
||||
System.out.println("Building name translation for " + remoteInterface);
|
||||
try {
|
||||
IDLNameTranslator nameTranslator =
|
||||
IDLNameTranslatorImpl.get(remoteInterface);
|
||||
System.out.println(nameTranslator);
|
||||
} catch(IllegalStateException ise) {
|
||||
ise.printStackTrace();
|
||||
}
|
||||
}
|
||||
}
|
|
@ -1,544 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2004, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.presentation.rmi ;
|
||||
|
||||
import java.lang.reflect.Method;
|
||||
import java.lang.reflect.Field;
|
||||
import java.util.Set;
|
||||
import java.util.HashSet;
|
||||
import java.util.Iterator;
|
||||
|
||||
/**
|
||||
* Utility class for testing RMI/IDL Types as defined in
|
||||
* Section 1.2 of The Java Language to IDL Mapping. Note that
|
||||
* these are static checks only. Runtime checks, such as those
|
||||
* described in Section 1.2.3, #3, are not covered.
|
||||
*/
|
||||
public class IDLTypesUtil {
|
||||
|
||||
public static final String JAVA_GET_PROPERTY_PREFIX = "get";
|
||||
public static final String JAVA_SET_PROPERTY_PREFIX = "set";
|
||||
public static final String JAVA_IS_PROPERTY_PREFIX = "is";
|
||||
|
||||
public static final int VALID_TYPE = 0;
|
||||
public static final int INVALID_TYPE = 1;
|
||||
|
||||
/**
|
||||
* Validate a class to ensure it conforms to the rules for a
|
||||
* Java RMI/IIOP interface.
|
||||
*
|
||||
* @throws IDLTypeException if not a valid RMI/IIOP interface.
|
||||
*/
|
||||
public void validateRemoteInterface(Class c) throws IDLTypeException
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
if( !c.isInterface() ) {
|
||||
String msg = "Class " + c + " must be a java interface.";
|
||||
throw new IDLTypeException(msg);
|
||||
}
|
||||
|
||||
if( !java.rmi.Remote.class.isAssignableFrom(c) ) {
|
||||
String msg = "Class " + c + " must extend java.rmi.Remote, " +
|
||||
"either directly or indirectly.";
|
||||
throw new IDLTypeException(msg);
|
||||
}
|
||||
|
||||
// Get all methods, including super-interface methods.
|
||||
Method[] methods = c.getMethods();
|
||||
|
||||
for(int i = 0; i < methods.length; i++) {
|
||||
Method next = methods[i];
|
||||
validateExceptions(next);
|
||||
}
|
||||
|
||||
// Removed because of bug 4989053
|
||||
// validateDirectInterfaces(c);
|
||||
validateConstants(c);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
public boolean isRemoteInterface(Class c)
|
||||
{
|
||||
boolean remoteInterface = true;
|
||||
try {
|
||||
validateRemoteInterface(c);
|
||||
} catch(IDLTypeException ite) {
|
||||
remoteInterface = false;
|
||||
}
|
||||
|
||||
return remoteInterface;
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.2 Primitive Types
|
||||
*/
|
||||
public boolean isPrimitive(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
return c.isPrimitive();
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.4
|
||||
*/
|
||||
public boolean isValue(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
return
|
||||
(!c.isInterface() &&
|
||||
java.io.Serializable.class.isAssignableFrom(c) &&
|
||||
!java.rmi.Remote.class.isAssignableFrom(c));
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.5
|
||||
*/
|
||||
public boolean isArray(Class c)
|
||||
{
|
||||
boolean arrayType = false;
|
||||
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
if( c.isArray() ) {
|
||||
Class componentType = c.getComponentType();
|
||||
arrayType =
|
||||
(isPrimitive(componentType) || isRemoteInterface(componentType) ||
|
||||
isEntity(componentType) || isException(componentType) ||
|
||||
isValue(componentType) || isObjectReference(componentType) );
|
||||
}
|
||||
|
||||
return arrayType;
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.6
|
||||
*/
|
||||
public boolean isException(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
// Must be a checked exception, not including RemoteException or
|
||||
// its subclasses.
|
||||
return isCheckedException(c) && !isRemoteException(c) && isValue(c);
|
||||
}
|
||||
|
||||
public boolean isRemoteException(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
return java.rmi.RemoteException.class.isAssignableFrom(c) ;
|
||||
}
|
||||
|
||||
public boolean isCheckedException(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
return Throwable.class.isAssignableFrom(c) &&
|
||||
!RuntimeException.class.isAssignableFrom(c) &&
|
||||
!Error.class.isAssignableFrom(c) ;
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.7
|
||||
*/
|
||||
public boolean isObjectReference(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
return (c.isInterface() &&
|
||||
org.omg.CORBA.Object.class.isAssignableFrom(c));
|
||||
}
|
||||
|
||||
/**
|
||||
* Section 1.2.8
|
||||
*/
|
||||
public boolean isEntity(Class c)
|
||||
{
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
Class superClass = c.getSuperclass();
|
||||
return (!c.isInterface() &&
|
||||
(superClass != null) &&
|
||||
(org.omg.CORBA.portable.IDLEntity.class.isAssignableFrom(c)));
|
||||
}
|
||||
|
||||
public String javaPropertyPrefixToIDL( String javaPrefix )
|
||||
{
|
||||
return "_" + javaPrefix + "_" ;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return the property type if given method is legal property accessor as defined in
|
||||
* Section 1.3.4.3 of Java2IDL spec. Result is one of: JAVA_GET_PROPERTY_PREFIX,
|
||||
* JAVA_SET_PROPERTY_PREFIX, JAVA_IS_PROPERTY_PREFIX.
|
||||
*/
|
||||
public String propertyAccessorMethodType(Method m, Class c) {
|
||||
|
||||
String methodName = m.getName();
|
||||
Class returnType = m.getReturnType();
|
||||
Class[] parameters = m.getParameterTypes();
|
||||
Class[] exceptionTypes = m.getExceptionTypes();
|
||||
String propertyType = null;
|
||||
|
||||
if( methodName.startsWith(JAVA_GET_PROPERTY_PREFIX) ) {
|
||||
|
||||
if((parameters.length == 0) && (returnType != Void.TYPE) &&
|
||||
!hasCorrespondingReadProperty(m, c, JAVA_IS_PROPERTY_PREFIX) {
|
||||
propertyType = JAVA_GET_PROPERTY_PREFIX;
|
||||
}
|
||||
|
||||
} else if( methodName.startsWith(JAVA_SET_PROPERTY_PREFIX) ) {
|
||||
|
||||
if((returnType == Void.TYPE) && (parameters.length == 1)) {
|
||||
if (hasCorrespondingReadProperty(m, c, JAVA_GET_PROPERTY_PREFIX) ||
|
||||
hasCorrespondingReadProperty(m, c, JAVA_IS_PROPERTY_PREFIX)) {
|
||||
propertyType = JAVA_SET_PROPERTY_PREFIX;
|
||||
}
|
||||
}
|
||||
|
||||
} else if( methodName.startsWith(JAVA_IS_PROPERTY_PREFIX) ) {
|
||||
if((parameters.length == 0) && (returnType == Boolean.TYPE)) {
|
||||
propertyType = JAVA_IS_PROPERTY_PREFIX;
|
||||
}
|
||||
}
|
||||
|
||||
// Some final checks that apply to all properties.
|
||||
if( propertyType != null ) {
|
||||
if(!validPropertyExceptions(m) ||
|
||||
(methodName.length() <= propertyType.length())) {
|
||||
propertyType = null;
|
||||
}
|
||||
}
|
||||
|
||||
return propertyType ;
|
||||
}
|
||||
|
||||
private boolean hasCorrespondingReadProperty
|
||||
(Method writeProperty, Class c, String readPropertyPrefix) {
|
||||
|
||||
String writePropertyMethodName = writeProperty.getName();
|
||||
Class[] writePropertyParameters = writeProperty.getParameterTypes();
|
||||
boolean foundReadProperty = false;
|
||||
|
||||
try {
|
||||
// Look for a valid corresponding Read property
|
||||
String readPropertyMethodName =
|
||||
writePropertyMethodName.replaceFirst
|
||||
(JAVA_SET_PROPERTY_PREFIX, readPropertyPrefix);
|
||||
Method readPropertyMethod = c.getMethod(readPropertyMethodName,
|
||||
new Class[] {});
|
||||
foundReadProperty =
|
||||
((propertyAccessorMethodType(readPropertyMethod, c) != null) &&
|
||||
(readPropertyMethod.getReturnType() ==
|
||||
writePropertyParameters[0]));
|
||||
} catch(Exception e) {
|
||||
// ignore. this means we didn't find a corresponding get property.
|
||||
}
|
||||
|
||||
return foundReadProperty;
|
||||
}
|
||||
|
||||
public String getAttributeNameForProperty(String propertyName) {
|
||||
String attributeName = null;
|
||||
String prefix = null;
|
||||
|
||||
if( propertyName.startsWith(JAVA_GET_PROPERTY_PREFIX) ) {
|
||||
prefix = JAVA_GET_PROPERTY_PREFIX;
|
||||
} else if( propertyName.startsWith(JAVA_SET_PROPERTY_PREFIX) ) {
|
||||
prefix = JAVA_SET_PROPERTY_PREFIX;
|
||||
} else if( propertyName.startsWith(JAVA_IS_PROPERTY_PREFIX) ) {
|
||||
prefix = JAVA_IS_PROPERTY_PREFIX;
|
||||
}
|
||||
|
||||
if( (prefix != null) && (prefix.length() < propertyName.length()) ) {
|
||||
String remainder = propertyName.substring(prefix.length());
|
||||
if( (remainder.length() >= 2) &&
|
||||
Character.isUpperCase(remainder.charAt(0)) &&
|
||||
Character.isUpperCase(remainder.charAt(1)) ) {
|
||||
// don't set the first letter to lower-case if the
|
||||
// first two are upper-case
|
||||
attributeName = remainder;
|
||||
} else {
|
||||
attributeName = Character.toLowerCase(remainder.charAt(0)) +
|
||||
remainder.substring(1);
|
||||
}
|
||||
}
|
||||
|
||||
return attributeName;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return IDL Type name for primitive types as defined in
|
||||
* Section 1.3.3 of Java2IDL spec or null if not a primitive type.
|
||||
*/
|
||||
public IDLType getPrimitiveIDLTypeMapping(Class c) {
|
||||
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
if( c.isPrimitive() ) {
|
||||
if( c == Void.TYPE ) {
|
||||
return new IDLType( c, "void" ) ;
|
||||
} else if( c == Boolean.TYPE ) {
|
||||
return new IDLType( c, "boolean" ) ;
|
||||
} else if( c == Character.TYPE ) {
|
||||
return new IDLType( c, "wchar" ) ;
|
||||
} else if( c == Byte.TYPE ) {
|
||||
return new IDLType( c, "octet" ) ;
|
||||
} else if( c == Short.TYPE ) {
|
||||
return new IDLType( c, "short" ) ;
|
||||
} else if( c == Integer.TYPE ) {
|
||||
return new IDLType( c, "long" ) ;
|
||||
} else if( c == Long.TYPE ) {
|
||||
return new IDLType( c, "long_long" ) ;
|
||||
} else if( c == Float.TYPE ) {
|
||||
return new IDLType( c, "float" ) ;
|
||||
} else if( c == Double.TYPE ) {
|
||||
return new IDLType( c, "double" ) ;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return IDL Type name for special case type mappings as defined in
|
||||
* Table 1-1 of Java2IDL spec or null if given class is not a special
|
||||
* type.
|
||||
*/
|
||||
public IDLType getSpecialCaseIDLTypeMapping(Class c) {
|
||||
|
||||
if( c == null ) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
|
||||
if( c == java.lang.Object.class ) {
|
||||
return new IDLType( c, new String[] { "java", "lang" },
|
||||
"Object" ) ;
|
||||
} else if( c == java.lang.String.class ) {
|
||||
return new IDLType( c, new String[] { "CORBA" },
|
||||
"WStringValue" ) ;
|
||||
} else if( c == java.lang.Class.class ) {
|
||||
return new IDLType( c, new String[] { "javax", "rmi", "CORBA" },
|
||||
"ClassDesc" ) ;
|
||||
} else if( c == java.io.Serializable.class ) {
|
||||
return new IDLType( c, new String[] { "java", "io" },
|
||||
"Serializable" ) ;
|
||||
} else if( c == java.io.Externalizable.class ) {
|
||||
return new IDLType( c, new String[] { "java", "io" },
|
||||
"Externalizable" ) ;
|
||||
} else if( c == java.rmi.Remote.class ) {
|
||||
return new IDLType( c, new String[] { "java", "rmi" },
|
||||
"Remote" ) ;
|
||||
} else if( c == org.omg.CORBA.Object.class ) {
|
||||
return new IDLType( c, "Object" ) ;
|
||||
} else {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements 1.2.3 #2 and #4
|
||||
*/
|
||||
private void validateExceptions(Method method) throws IDLTypeException {
|
||||
|
||||
Class[] exceptions = method.getExceptionTypes();
|
||||
|
||||
boolean declaresRemoteExceptionOrSuperClass = false;
|
||||
|
||||
// Section 1.2.3, #2
|
||||
for(int eIndex = 0; eIndex < exceptions.length; eIndex++) {
|
||||
Class exception = exceptions[eIndex];
|
||||
if( isRemoteExceptionOrSuperClass(exception) ) {
|
||||
declaresRemoteExceptionOrSuperClass = true;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
if( !declaresRemoteExceptionOrSuperClass ) {
|
||||
String msg = "Method '" + method + "' must throw at least one " +
|
||||
"exception of type java.rmi.RemoteException or one of its " +
|
||||
"super-classes";
|
||||
throw new IDLTypeException(msg);
|
||||
}
|
||||
|
||||
// Section 1.2.3, #4
|
||||
// See also bug 4972402
|
||||
// For all exceptions E in exceptions,
|
||||
// (isCheckedException(E) => (isValue(E) || RemoteException.isAssignableFrom( E ) )
|
||||
for(int eIndex = 0; eIndex < exceptions.length; eIndex++) {
|
||||
Class exception = exceptions[eIndex];
|
||||
|
||||
if (isCheckedException(exception) && !isValue(exception) &&
|
||||
!isRemoteException(exception))
|
||||
{
|
||||
String msg = "Exception '" + exception + "' on method '" +
|
||||
method + "' is not a allowed RMI/IIOP exception type";
|
||||
throw new IDLTypeException(msg);
|
||||
}
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns true if the method's throw clause conforms to the exception
|
||||
* restrictions for properties as defined in Section 1.3.4.3 of
|
||||
* Java2IDL spec. This means that for all exceptions E declared on the
|
||||
* method, E isChecked => RemoteException.isAssignableFrom( E ).
|
||||
*/
|
||||
private boolean validPropertyExceptions(Method method)
|
||||
{
|
||||
Class[] exceptions = method.getExceptionTypes();
|
||||
|
||||
for(int eIndex = 0; eIndex < exceptions.length; eIndex++) {
|
||||
Class exception = exceptions[eIndex];
|
||||
|
||||
if (isCheckedException(exception) && !isRemoteException(exception))
|
||||
return false ;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements Section 1.2.3, #2.
|
||||
*/
|
||||
private boolean isRemoteExceptionOrSuperClass(Class c) {
|
||||
return
|
||||
((c == java.rmi.RemoteException.class) ||
|
||||
(c == java.io.IOException.class) ||
|
||||
(c == java.lang.Exception.class) ||
|
||||
(c == java.lang.Throwable.class));
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements Section 1.2.3, #5.
|
||||
*/
|
||||
private void validateDirectInterfaces(Class c) throws IDLTypeException {
|
||||
|
||||
Class[] directInterfaces = c.getInterfaces();
|
||||
|
||||
if( directInterfaces.length < 2 ) {
|
||||
return;
|
||||
}
|
||||
|
||||
Set allMethodNames = new HashSet();
|
||||
Set currentMethodNames = new HashSet();
|
||||
|
||||
for(int i = 0; i < directInterfaces.length; i++) {
|
||||
Class next = directInterfaces[i];
|
||||
Method[] methods = next.getMethods();
|
||||
|
||||
// Comparison is based on method names only. First collect
|
||||
// all methods from current interface, eliminating duplicate
|
||||
// names.
|
||||
currentMethodNames.clear();
|
||||
for(int m = 0; m < methods.length; m++) {
|
||||
currentMethodNames.add(methods[m].getName());
|
||||
}
|
||||
|
||||
// Now check each method against list of all unique method
|
||||
// names processed so far.
|
||||
for(Iterator iter=currentMethodNames.iterator(); iter.hasNext();) {
|
||||
String methodName = (String) iter.next();
|
||||
if( allMethodNames.contains(methodName) ) {
|
||||
String msg = "Class " + c + " inherits method " +
|
||||
methodName + " from multiple direct interfaces.";
|
||||
throw new IDLTypeException(msg);
|
||||
} else {
|
||||
allMethodNames.add(methodName);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
/**
|
||||
* Implements 1.2.3 #6
|
||||
*/
|
||||
private void validateConstants(final Class c)
|
||||
throws IDLTypeException {
|
||||
|
||||
Field[] fields = null;
|
||||
|
||||
try {
|
||||
fields = (Field[])
|
||||
java.security.AccessController.doPrivileged
|
||||
(new java.security.PrivilegedExceptionAction() {
|
||||
public java.lang.Object run() throws Exception {
|
||||
return c.getFields();
|
||||
}
|
||||
});
|
||||
} catch(java.security.PrivilegedActionException pae) {
|
||||
IDLTypeException ite = new IDLTypeException();
|
||||
ite.initCause(pae);
|
||||
throw ite;
|
||||
}
|
||||
|
||||
for(int i = 0; i < fields.length; i++) {
|
||||
Field next = fields[i];
|
||||
Class fieldType = next.getType();
|
||||
if( (fieldType != java.lang.String.class) &&
|
||||
!isPrimitive(fieldType) ) {
|
||||
String msg = "Constant field '" + next.getName() +
|
||||
"' in class '" + next.getDeclaringClass().getName() +
|
||||
"' has invalid type' " + next.getType() + "'. Constants" +
|
||||
" in RMI/IIOP interfaces can only have primitive" +
|
||||
" types and java.lang.String types.";
|
||||
throw new IDLTypeException(msg);
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
}
|
|
@ -1,138 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.iiop;
|
||||
|
||||
import com.sun.corba.se.impl.protocol.Request;
|
||||
import com.sun.corba.se.impl.core.ClientRequest;
|
||||
import com.sun.corba.se.impl.core.ServiceContext;
|
||||
import com.sun.corba.se.impl.core.ServiceContexts;
|
||||
import com.sun.corba.se.impl.core.ClientResponse;
|
||||
import com.sun.corba.se.impl.core.ServerRequest;
|
||||
import com.sun.corba.se.impl.core.ServerResponse;
|
||||
import com.sun.corba.se.impl.corba.IOR;
|
||||
import com.sun.corba.se.impl.corba.GIOPVersion;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.MessageBase;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.RequestMessage;
|
||||
import com.sun.corba.se.impl.orbutil.ORBConstants;
|
||||
import com.sun.corba.se.impl.core.ORBVersion;
|
||||
import com.sun.corba.se.impl.core.ORB;
|
||||
import com.sun.corba.se.impl.orbutil.ORBUtility;
|
||||
import com.sun.corba.se.impl.ior.ObjectKeyFactory ;
|
||||
import com.sun.corba.se.impl.ior.ObjectKey ;
|
||||
import com.sun.corba.se.impl.ior.ObjectKeyTemplate ;
|
||||
import com.sun.corba.se.impl.ior.IIOPProfile;
|
||||
|
||||
public class LocalClientRequestImpl extends IIOPOutputStream
|
||||
implements ClientRequest
|
||||
{
|
||||
public LocalClientRequestImpl( GIOPVersion gv,
|
||||
ORB orb, IOR ior, short addrDisposition,
|
||||
String operationName, boolean oneway, ServiceContexts svc,
|
||||
int requestId, byte streamFormatVersion)
|
||||
{
|
||||
super(gv,
|
||||
orb,
|
||||
null,
|
||||
BufferManagerFactory.newBufferManagerWrite(BufferManagerFactory.GROW),
|
||||
streamFormatVersion);
|
||||
|
||||
this.isOneway = oneway;
|
||||
boolean responseExpected = !isOneway;
|
||||
|
||||
IIOPProfile iop = ior.getProfile();
|
||||
ObjectKey okey = iop.getObjectKey();
|
||||
ObjectKeyTemplate oktemp = okey.getTemplate() ;
|
||||
ORBVersion version = oktemp.getORBVersion() ;
|
||||
orb.setORBVersion( version ) ;
|
||||
|
||||
this.request = MessageBase.createRequest(orb, gv, requestId,
|
||||
responseExpected, ior, addrDisposition, operationName, svc, null);
|
||||
setMessage(request);
|
||||
request.write(this);
|
||||
|
||||
// mark beginning of msg body for possible later use
|
||||
bodyBegin = getSize();
|
||||
}
|
||||
|
||||
public int getRequestId() {
|
||||
return request.getRequestId();
|
||||
}
|
||||
|
||||
public boolean isOneWay() {
|
||||
return isOneway;
|
||||
}
|
||||
|
||||
public ServiceContexts getServiceContexts() {
|
||||
return request.getServiceContexts();
|
||||
}
|
||||
|
||||
public String getOperationName() {
|
||||
return request.getOperation();
|
||||
}
|
||||
|
||||
public ObjectKey getObjectKey() {
|
||||
return request.getObjectKey();
|
||||
}
|
||||
|
||||
public ServerRequest getServerRequest()
|
||||
{
|
||||
// Set the size of the marshalled data in the message header.
|
||||
getMessage().setSize( getByteBuffer(), getSize() ) ;
|
||||
|
||||
// Construct a new ServerRequest out of the buffer in this ClientRequest
|
||||
LocalServerRequestImpl serverRequest = new LocalServerRequestImpl(
|
||||
(ORB)orb(), toByteArray(), request ) ;
|
||||
|
||||
// Skip over all of the GIOP header information. This positions
|
||||
// the offset in the buffer so that the skeleton can correctly read
|
||||
// the marshalled arguments.
|
||||
serverRequest.setIndex( bodyBegin ) ;
|
||||
|
||||
return serverRequest ;
|
||||
}
|
||||
|
||||
public ClientResponse invoke()
|
||||
{
|
||||
ORB myORB = (ORB)orb() ;
|
||||
|
||||
ServerResponse serverResponse = myORB.process( getServerRequest() ) ;
|
||||
|
||||
LocalServerResponseImpl lsr = (LocalServerResponseImpl)serverResponse ;
|
||||
|
||||
return lsr.getClientResponse() ;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the request is local.
|
||||
*/
|
||||
public boolean isLocal(){
|
||||
return true;
|
||||
}
|
||||
|
||||
private RequestMessage request;
|
||||
private int bodyBegin;
|
||||
private boolean isOneway;
|
||||
}
|
|
@ -1,162 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.iiop;
|
||||
|
||||
import java.io.IOException;
|
||||
|
||||
import org.omg.CORBA.SystemException;
|
||||
import org.omg.CORBA.CompletionStatus;
|
||||
|
||||
import com.sun.corba.se.impl.core.Response;
|
||||
import com.sun.corba.se.impl.core.ClientResponse;
|
||||
import com.sun.corba.se.impl.corba.IOR;
|
||||
import com.sun.corba.se.impl.core.ORB;
|
||||
import com.sun.corba.se.impl.core.ServiceContext;
|
||||
import com.sun.corba.se.impl.core.ServiceContexts;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.Message;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.ReplyMessage;
|
||||
import com.sun.corba.se.impl.orbutil.MinorCodes;
|
||||
|
||||
class LocalClientResponseImpl extends IIOPInputStream implements ClientResponse
|
||||
{
|
||||
LocalClientResponseImpl(ORB orb, byte[] buf, ReplyMessage header)
|
||||
{
|
||||
super(orb, buf, header.getSize(), header.isLittleEndian(), header, null);
|
||||
|
||||
this.reply = header;
|
||||
|
||||
// NOTE (Ram J) (06/02/2000) if we set result.setIndex(bodyBegin)
|
||||
// in LocalServerResponse.getClientResponse(), then we do not need
|
||||
// to read the headers (done below) anymore.
|
||||
// This will be an optimisation which is can be done to speed up the
|
||||
// local invocation by avoiding reading the headers in the local cases.
|
||||
|
||||
// BUGFIX(Ram Jeyaraman) This has been moved from
|
||||
// LocalServerResponse.getClientResponse()
|
||||
// Skip over all of the GIOP header information. This positions
|
||||
// the offset in the buffer so that the skeleton can correctly read
|
||||
// the marshalled arguments.
|
||||
this.setIndex(Message.GIOPMessageHeaderLength);
|
||||
|
||||
// BUGFIX(Ram Jeyaraman) For local invocations, the reply mesg fields
|
||||
// needs to be set, by reading the response buffer contents
|
||||
// to correctly set the exception type and other info.
|
||||
this.reply.read(this);
|
||||
}
|
||||
|
||||
LocalClientResponseImpl(SystemException ex)
|
||||
{
|
||||
this.systemException = ex;
|
||||
}
|
||||
|
||||
public boolean isSystemException() {
|
||||
if ( reply != null )
|
||||
return reply.getReplyStatus() == ReplyMessage.SYSTEM_EXCEPTION;
|
||||
else
|
||||
return (systemException != null);
|
||||
}
|
||||
|
||||
public boolean isUserException() {
|
||||
if ( reply != null )
|
||||
return reply.getReplyStatus() == ReplyMessage.USER_EXCEPTION;
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
public boolean isLocationForward() {
|
||||
if ( reply != null ) {
|
||||
return ( (reply.getReplyStatus() == ReplyMessage.LOCATION_FORWARD) ||
|
||||
(reply.getReplyStatus() == ReplyMessage.LOCATION_FORWARD_PERM) );
|
||||
//return reply.getReplyStatus() == ReplyMessage.LOCATION_FORWARD;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
public boolean isDifferentAddrDispositionRequested() {
|
||||
if (reply != null) {
|
||||
return reply.getReplyStatus() == ReplyMessage.NEEDS_ADDRESSING_MODE;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
public short getAddrDisposition() {
|
||||
if (reply != null) {
|
||||
return reply.getAddrDisposition();
|
||||
}
|
||||
|
||||
throw new org.omg.CORBA.INTERNAL(
|
||||
"Null reply in getAddrDisposition",
|
||||
MinorCodes.NULL_REPLY_IN_GET_ADDR_DISPOSITION,
|
||||
CompletionStatus.COMPLETED_MAYBE);
|
||||
}
|
||||
|
||||
public IOR getForwardedIOR() {
|
||||
if ( reply != null )
|
||||
return reply.getIOR();
|
||||
else
|
||||
return null;
|
||||
}
|
||||
|
||||
public int getRequestId() {
|
||||
if ( reply != null )
|
||||
return reply.getRequestId();
|
||||
else
|
||||
throw new org.omg.CORBA.INTERNAL("Error in getRequestId");
|
||||
}
|
||||
|
||||
public ServiceContexts getServiceContexts() {
|
||||
if ( reply != null )
|
||||
return reply.getServiceContexts();
|
||||
else
|
||||
return null;
|
||||
}
|
||||
|
||||
public SystemException getSystemException() {
|
||||
if ( reply != null )
|
||||
return reply.getSystemException();
|
||||
else
|
||||
return systemException;
|
||||
}
|
||||
|
||||
public java.lang.String peekUserExceptionId() {
|
||||
mark(Integer.MAX_VALUE);
|
||||
String result = read_string();
|
||||
reset();
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the response is local.
|
||||
*/
|
||||
public boolean isLocal(){
|
||||
return true;
|
||||
}
|
||||
|
||||
private ReplyMessage reply;
|
||||
private SystemException systemException;
|
||||
}
|
|
@ -1,208 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.iiop;
|
||||
|
||||
import org.omg.CORBA.SystemException;
|
||||
|
||||
import com.sun.corba.se.impl.core.ServerRequest;
|
||||
import com.sun.corba.se.impl.core.ServiceContext;
|
||||
import com.sun.corba.se.impl.core.DuplicateServiceContext;
|
||||
import com.sun.corba.se.impl.core.UEInfoServiceContext;
|
||||
import com.sun.corba.se.impl.core.ServiceContexts;
|
||||
import com.sun.corba.se.impl.core.ServerResponse;
|
||||
import com.sun.corba.se.impl.corba.IOR;
|
||||
import com.sun.corba.se.impl.core.ORB;
|
||||
import com.sun.corba.se.impl.orbutil.ORBUtility; //d11638
|
||||
import org.omg.CORBA.portable.UnknownException;
|
||||
import org.omg.CORBA.UNKNOWN;
|
||||
import org.omg.CORBA.CompletionStatus;
|
||||
import com.sun.corba.se.impl.ior.ObjectKey;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.MessageBase;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.ReplyMessage;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.RequestMessage;
|
||||
|
||||
class LocalServerRequestImpl extends IIOPInputStream implements ServerRequest {
|
||||
org.omg.CORBA.portable.OutputStream replyStream;
|
||||
org.omg.CORBA.portable.OutputStream exceptionReplyStream;
|
||||
|
||||
LocalServerRequestImpl(ORB orb, byte[] buf, RequestMessage header)
|
||||
{
|
||||
super(orb, buf, header.getSize(), header.isLittleEndian(), header, null );
|
||||
|
||||
this.request = header;
|
||||
}
|
||||
|
||||
public int getRequestId() {
|
||||
return request.getRequestId();
|
||||
}
|
||||
|
||||
public boolean isOneWay() {
|
||||
return !request.isResponseExpected();
|
||||
}
|
||||
|
||||
public ServiceContexts getServiceContexts() {
|
||||
return request.getServiceContexts();
|
||||
}
|
||||
|
||||
public String getOperationName() {
|
||||
return request.getOperation();
|
||||
}
|
||||
|
||||
public ObjectKey getObjectKey() {
|
||||
return request.getObjectKey();
|
||||
}
|
||||
|
||||
public ServerResponse createResponse(ServiceContexts svc)
|
||||
{
|
||||
return new LocalServerResponseImpl(this, svc);
|
||||
}
|
||||
|
||||
public org.omg.CORBA.portable.OutputStream createReply() {
|
||||
if (replyStream == null) {
|
||||
replyStream = (org.omg.CORBA.portable.OutputStream)
|
||||
createResponse(null);
|
||||
}
|
||||
return replyStream;
|
||||
}
|
||||
|
||||
public org.omg.CORBA.portable.OutputStream createExceptionReply() {
|
||||
if (exceptionReplyStream == null) {
|
||||
exceptionReplyStream = (org.omg.CORBA.portable.OutputStream)
|
||||
createUserExceptionResponse(null);
|
||||
}
|
||||
return exceptionReplyStream;
|
||||
}
|
||||
|
||||
public ServerResponse createUserExceptionResponse(
|
||||
ServiceContexts svc)
|
||||
{
|
||||
return new LocalServerResponseImpl(this, svc, true);
|
||||
}
|
||||
|
||||
public ServerResponse createUnknownExceptionResponse(
|
||||
UnknownException ex) {
|
||||
ServiceContexts contexts = null;
|
||||
SystemException sys = new UNKNOWN( 0,
|
||||
CompletionStatus.COMPLETED_MAYBE);
|
||||
|
||||
try {
|
||||
contexts = new ServiceContexts( (ORB)orb() );
|
||||
UEInfoServiceContext uei = new UEInfoServiceContext(sys);
|
||||
contexts.put(uei) ;
|
||||
} catch (DuplicateServiceContext d) {
|
||||
// can't happen
|
||||
}
|
||||
|
||||
return createSystemExceptionResponse(sys,contexts);
|
||||
}
|
||||
|
||||
public ServerResponse createSystemExceptionResponse(
|
||||
SystemException ex, ServiceContexts svc) {
|
||||
|
||||
// Only do this if interceptors have been initialized on this request
|
||||
// and have not completed their lifecycle (otherwise the info stack
|
||||
// may be empty or have a different request's entry on top).
|
||||
if (executePIInResponseConstructor()) {
|
||||
// Inform Portable Interceptors of the SystemException. This is
|
||||
// required to be done here because the ending interception point
|
||||
// is called in the ServerResponseImpl constructor called below
|
||||
// but we do not currently write the SystemException into the
|
||||
// response until after the ending point is called.
|
||||
ORB orb = (ORB)orb();
|
||||
orb.getPIHandler().setServerPIInfo( ex );
|
||||
}
|
||||
|
||||
if (orb() != null && ((ORB)orb()).subcontractDebugFlag && ex != null)
|
||||
ORBUtility.dprint(this, "Sending SystemException:", ex);
|
||||
|
||||
LocalServerResponseImpl response =
|
||||
new LocalServerResponseImpl(this, svc, false);
|
||||
ORBUtility.writeSystemException(ex, response);
|
||||
return response;
|
||||
}
|
||||
|
||||
public ServerResponse createLocationForward(
|
||||
IOR ior, ServiceContexts svc) {
|
||||
ReplyMessage reply = MessageBase.createReply( (ORB)orb(),
|
||||
request.getGIOPVersion(), request.getRequestId(),
|
||||
ReplyMessage.LOCATION_FORWARD, svc, ior);
|
||||
LocalServerResponseImpl response =
|
||||
new LocalServerResponseImpl(this, reply, ior);
|
||||
|
||||
return response;
|
||||
}
|
||||
|
||||
private RequestMessage request;
|
||||
|
||||
/**
|
||||
* Check to see if the request is local.
|
||||
*/
|
||||
public boolean isLocal(){
|
||||
return true;
|
||||
}
|
||||
|
||||
private boolean _executeReturnServantInResponseConstructor = false;
|
||||
|
||||
public boolean executeReturnServantInResponseConstructor()
|
||||
{
|
||||
return _executeReturnServantInResponseConstructor;
|
||||
}
|
||||
|
||||
public void setExecuteReturnServantInResponseConstructor(boolean b)
|
||||
{
|
||||
_executeReturnServantInResponseConstructor = b;
|
||||
}
|
||||
|
||||
|
||||
private boolean _executeRemoveThreadInfoInResponseConstructor = false;
|
||||
|
||||
public boolean executeRemoveThreadInfoInResponseConstructor()
|
||||
{
|
||||
return _executeRemoveThreadInfoInResponseConstructor;
|
||||
}
|
||||
|
||||
public void setExecuteRemoveThreadInfoInResponseConstructor(boolean b)
|
||||
{
|
||||
_executeRemoveThreadInfoInResponseConstructor = b;
|
||||
}
|
||||
|
||||
|
||||
private boolean _executePIInResponseConstructor = false;
|
||||
|
||||
public boolean executePIInResponseConstructor() {
|
||||
return _executePIInResponseConstructor;
|
||||
}
|
||||
|
||||
public void setExecutePIInResponseConstructor( boolean b ) {
|
||||
_executePIInResponseConstructor = b;
|
||||
}
|
||||
|
||||
// We know that we're talking to the same ValueHandler, so
|
||||
// use the maximum version it supports.
|
||||
public byte getStreamFormatVersionForReply() {
|
||||
return ORBUtility.getMaxStreamFormatVersion();
|
||||
}
|
||||
}
|
|
@ -1,192 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.iiop;
|
||||
|
||||
import org.omg.CORBA.SystemException;
|
||||
|
||||
import com.sun.corba.se.impl.core.ServerResponse;
|
||||
import com.sun.corba.se.impl.core.ORB;
|
||||
import com.sun.corba.se.impl.corba.IOR;
|
||||
import com.sun.corba.se.impl.core.ServiceContext;
|
||||
import com.sun.corba.se.impl.core.ServiceContexts;
|
||||
import com.sun.corba.se.impl.core.ClientResponse;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.MessageBase;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.ReplyMessage;
|
||||
|
||||
class LocalServerResponseImpl
|
||||
extends IIOPOutputStream
|
||||
implements ServerResponse
|
||||
{
|
||||
LocalServerResponseImpl(LocalServerRequestImpl request, ServiceContexts svc)
|
||||
{
|
||||
this(request,
|
||||
MessageBase.createReply(
|
||||
(ORB)request.orb(),
|
||||
request.getGIOPVersion(),
|
||||
request.getRequestId(), ReplyMessage.NO_EXCEPTION,
|
||||
svc, null),
|
||||
null);
|
||||
}
|
||||
|
||||
LocalServerResponseImpl(LocalServerRequestImpl request, ServiceContexts svc,
|
||||
boolean user)
|
||||
{
|
||||
this(request,
|
||||
MessageBase.createReply(
|
||||
(ORB)request.orb(),
|
||||
request.getGIOPVersion(), request.getRequestId(),
|
||||
user ? ReplyMessage.USER_EXCEPTION :
|
||||
ReplyMessage.SYSTEM_EXCEPTION,
|
||||
svc, null),
|
||||
null);
|
||||
}
|
||||
|
||||
LocalServerResponseImpl( LocalServerRequestImpl request, ReplyMessage reply,
|
||||
IOR ior)
|
||||
{
|
||||
super(request.getGIOPVersion(),
|
||||
(ORB)request.orb(),
|
||||
null,
|
||||
BufferManagerFactory.newBufferManagerWrite(BufferManagerFactory.GROW),
|
||||
request.getStreamFormatVersionForReply());
|
||||
|
||||
setMessage(reply);
|
||||
|
||||
ORB orb = (ORB)request.orb();
|
||||
|
||||
ServerResponseImpl.runServantPostInvoke(orb, request);
|
||||
|
||||
if( request.executePIInResponseConstructor() ) {
|
||||
// Invoke server request ending interception points (send_*):
|
||||
// Note: this may end up with a SystemException or an internal
|
||||
// Runtime ForwardRequest.
|
||||
orb.getPIHandler().invokeServerPIEndingPoint( reply );
|
||||
|
||||
// Note this will be executed even if a ForwardRequest or
|
||||
// SystemException is thrown by a Portable Interceptors ending
|
||||
// point since we end up in this constructor again anyway.
|
||||
orb.getPIHandler().cleanupServerPIRequest();
|
||||
|
||||
// See (Local)ServerRequestImpl.createSystemExceptionResponse
|
||||
// for why this is necesary.
|
||||
request.setExecutePIInResponseConstructor(false);
|
||||
}
|
||||
|
||||
// Once you get here then the final reply is available (i.e.,
|
||||
// postinvoke and interceptors have completed.
|
||||
if (request.executeRemoveThreadInfoInResponseConstructor()) {
|
||||
ServerResponseImpl.removeThreadInfo(orb, request);
|
||||
}
|
||||
|
||||
reply.write(this);
|
||||
if (reply.getIOR() != null)
|
||||
reply.getIOR().write(this);
|
||||
|
||||
this.reply = reply;
|
||||
this.ior = reply.getIOR();
|
||||
}
|
||||
|
||||
public boolean isSystemException() {
|
||||
if (reply != null)
|
||||
return reply.getReplyStatus() == ReplyMessage.SYSTEM_EXCEPTION;
|
||||
return false;
|
||||
}
|
||||
|
||||
public boolean isUserException() {
|
||||
if (reply != null)
|
||||
return reply.getReplyStatus() == ReplyMessage.USER_EXCEPTION;
|
||||
return false;
|
||||
}
|
||||
|
||||
public boolean isLocationForward() {
|
||||
if (ior != null)
|
||||
return true;
|
||||
return false;
|
||||
}
|
||||
|
||||
public IOR getForwardedIOR() {
|
||||
return ior;
|
||||
}
|
||||
|
||||
public int getRequestId() {
|
||||
if (reply != null)
|
||||
return reply.getRequestId();
|
||||
return -1;
|
||||
}
|
||||
|
||||
public ServiceContexts getServiceContexts() {
|
||||
if (reply != null)
|
||||
return reply.getServiceContexts();
|
||||
return null;
|
||||
}
|
||||
|
||||
public SystemException getSystemException() {
|
||||
if (reply != null)
|
||||
return reply.getSystemException();
|
||||
return null;
|
||||
}
|
||||
|
||||
public ReplyMessage getReply()
|
||||
{
|
||||
return reply ;
|
||||
}
|
||||
|
||||
public ClientResponse getClientResponse()
|
||||
{
|
||||
// set the size of the marshalled data in the message header
|
||||
getMessage().setSize(getByteBuffer(), getSize());
|
||||
|
||||
// Construct a new ClientResponse out of the buffer in this ClientRequest
|
||||
LocalClientResponseImpl result =
|
||||
new LocalClientResponseImpl( (ORB)orb(), toByteArray(), reply);
|
||||
|
||||
// NOTE (Ram J) (06/02/2000) if we set result.setIndex(bodyBegin) here
|
||||
// then the LocalClientResponse does not need to read the headers anymore.
|
||||
// This will be an optimisation which is can be done to speed up the
|
||||
// local invocation by avoiding reading the headers in the local cases.
|
||||
|
||||
// BUGFIX(Ram Jeyaraman) result.setOffset is now done in
|
||||
// LocalClientResponseImpl constructor.
|
||||
/*
|
||||
// Skip over all of the GIOP header information. This positions
|
||||
// the offset in the buffer so that the skeleton can correctly read
|
||||
// the marshalled arguments.
|
||||
result.setOffset( bodyBegin ) ;
|
||||
*/
|
||||
|
||||
return result ;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check to see if the response is local.
|
||||
*/
|
||||
public boolean isLocal(){
|
||||
return true;
|
||||
}
|
||||
|
||||
private ReplyMessage reply;
|
||||
private IOR ior; // forwarded IOR
|
||||
}
|
|
@ -1,710 +0,0 @@
|
|||
/*
|
||||
* Copyright (c) 2004, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation. Oracle designates this
|
||||
* particular file as subject to the "Classpath" exception as provided
|
||||
* by Oracle in the LICENSE file that accompanied this code.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
package com.sun.corba.se.impl.transport;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.net.InetSocketAddress;
|
||||
import java.net.Socket;
|
||||
import java.nio.ByteBuffer;
|
||||
import java.nio.channels.SelectableChannel;
|
||||
import java.nio.channels.SelectionKey;
|
||||
import java.nio.channels.SocketChannel;
|
||||
import java.security.AccessController;
|
||||
import java.security.PrivilegedAction;
|
||||
import java.util.Collections;
|
||||
import java.util.Hashtable;
|
||||
import java.util.HashMap;
|
||||
import java.util.Map;
|
||||
|
||||
import org.omg.CORBA.COMM_FAILURE;
|
||||
import org.omg.CORBA.CompletionStatus;
|
||||
import org.omg.CORBA.DATA_CONVERSION;
|
||||
import org.omg.CORBA.INTERNAL;
|
||||
import org.omg.CORBA.MARSHAL;
|
||||
import org.omg.CORBA.OBJECT_NOT_EXIST;
|
||||
import org.omg.CORBA.SystemException;
|
||||
|
||||
import com.sun.org.omg.SendingContext.CodeBase;
|
||||
|
||||
import com.sun.corba.se.pept.broker.Broker;
|
||||
import com.sun.corba.se.pept.encoding.InputObject;
|
||||
import com.sun.corba.se.pept.encoding.OutputObject;
|
||||
import com.sun.corba.se.pept.protocol.MessageMediator;
|
||||
import com.sun.corba.se.pept.transport.Acceptor;
|
||||
import com.sun.corba.se.pept.transport.Connection;
|
||||
import com.sun.corba.se.pept.transport.ConnectionCache;
|
||||
import com.sun.corba.se.pept.transport.ContactInfo;
|
||||
import com.sun.corba.se.pept.transport.EventHandler;
|
||||
import com.sun.corba.se.pept.transport.InboundConnectionCache;
|
||||
import com.sun.corba.se.pept.transport.OutboundConnectionCache;
|
||||
import com.sun.corba.se.pept.transport.ResponseWaitingRoom;
|
||||
import com.sun.corba.se.pept.transport.Selector;
|
||||
|
||||
import com.sun.corba.se.spi.ior.IOR;
|
||||
import com.sun.corba.se.spi.ior.iiop.GIOPVersion;
|
||||
import com.sun.corba.se.spi.logging.CORBALogDomains;
|
||||
import com.sun.corba.se.spi.orb.ORB ;
|
||||
import com.sun.corba.se.spi.orbutil.threadpool.Work;
|
||||
import com.sun.corba.se.spi.protocol.CorbaMessageMediator;
|
||||
import com.sun.corba.se.spi.transport.CorbaContactInfo;
|
||||
import com.sun.corba.se.spi.transport.CorbaConnection;
|
||||
import com.sun.corba.se.spi.transport.CorbaResponseWaitingRoom;
|
||||
|
||||
import com.sun.corba.se.impl.encoding.CachedCodeBase;
|
||||
import com.sun.corba.se.impl.encoding.CDRInputStream_1_0;
|
||||
import com.sun.corba.se.impl.encoding.CDROutputObject;
|
||||
import com.sun.corba.se.impl.encoding.CDROutputStream_1_0;
|
||||
import com.sun.corba.se.impl.encoding.CodeSetComponentInfo;
|
||||
import com.sun.corba.se.impl.encoding.OSFCodeSetRegistry;
|
||||
import com.sun.corba.se.impl.logging.ORBUtilSystemException;
|
||||
import com.sun.corba.se.impl.orbutil.ORBConstants;
|
||||
import com.sun.corba.se.impl.orbutil.ORBUtility;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.Message;
|
||||
import com.sun.corba.se.impl.protocol.giopmsgheaders.MessageBase;
|
||||
import com.sun.corba.se.impl.transport.CorbaResponseWaitingRoomImpl;
|
||||
|
||||
/**
|
||||
* @author Ken Cavanaugh
|
||||
*/
|
||||
public class BufferConnectionImpl
|
||||
extends
|
||||
EventHandlerBase
|
||||
implements
|
||||
CorbaConnection,
|
||||
Work
|
||||
{
|
||||
//
|
||||
// New transport.
|
||||
//
|
||||
|
||||
protected long enqueueTime;
|
||||
|
||||
public SocketChannel getSocketChannel()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
// REVISIT:
|
||||
// protected for test: genericRPCMSGFramework.IIOPConnection constructor.
|
||||
|
||||
//
|
||||
// From iiop.Connection.java
|
||||
//
|
||||
|
||||
protected long timeStamp = 0;
|
||||
protected boolean isServer = false;
|
||||
|
||||
// Start at some value other than zero since this is a magic
|
||||
// value in some protocols.
|
||||
protected int requestId = 5;
|
||||
protected CorbaResponseWaitingRoom responseWaitingRoom;
|
||||
protected int state;
|
||||
protected java.lang.Object stateEvent = new java.lang.Object();
|
||||
protected java.lang.Object writeEvent = new java.lang.Object();
|
||||
protected boolean writeLocked;
|
||||
protected int serverRequestCount = 0;
|
||||
|
||||
// Server request map: used on the server side of Connection
|
||||
// Maps request ID to IIOPInputStream.
|
||||
Map serverRequestMap = new HashMap() ;
|
||||
|
||||
// This is a flag associated per connection telling us if the
|
||||
// initial set of sending contexts were sent to the receiver
|
||||
// already...
|
||||
protected boolean postInitialContexts = false;
|
||||
|
||||
// Remote reference to CodeBase server (supplies
|
||||
// FullValueDescription, among other things)
|
||||
protected IOR codeBaseServerIOR;
|
||||
|
||||
// CodeBase cache for this connection. This will cache remote operations,
|
||||
// handle connecting, and ensure we don't do any remote operations until
|
||||
// necessary.
|
||||
protected CachedCodeBase cachedCodeBase = new CachedCodeBase(this);
|
||||
|
||||
protected ORBUtilSystemException wrapper ;
|
||||
|
||||
List buffers ;
|
||||
|
||||
public BufferConnectionImpl(ORB orb, byte[][] data )
|
||||
{
|
||||
this.orb = orb;
|
||||
wrapper = ORBUtilSystemException.get( orb,
|
||||
CORBALogDomains.RPC_TRANSPORT ) ;
|
||||
buffers = new ArrayList() ;
|
||||
}
|
||||
|
||||
////////////////////////////////////////////////////
|
||||
//
|
||||
// framework.transport.Connection
|
||||
//
|
||||
|
||||
public boolean shouldRegisterReadEvent()
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
public boolean shouldRegisterServerReadEvent()
|
||||
{
|
||||
return false;
|
||||
}
|
||||
|
||||
public boolean read()
|
||||
{
|
||||
return true ;
|
||||
}
|
||||
|
||||
protected CorbaMessageMediator readBits()
|
||||
{
|
||||
return null ;
|
||||
}
|
||||
|
||||
protected boolean dispatch(CorbaMessageMediator messageMediator)
|
||||
{
|
||||
}
|
||||
|
||||
public boolean shouldUseDirectByteBuffers()
|
||||
{
|
||||
return false ;
|
||||
}
|
||||
|
||||
// Only called from readGIOPMessage with (12, 0, 12) as arguments
|
||||
// size is size of buffer to create
|
||||
// offset is offset from start of message in buffer
|
||||
// length is length to read
|
||||
public ByteBuffer read(int size, int offset, int length)
|
||||
throws IOException
|
||||
{
|
||||
byte[] buf = new byte[size];
|
||||
readFully( buf, offset, length);
|
||||
ByteBuffer byteBuffer = ByteBuffer.wrap(buf);
|
||||
byteBuffer.limit(size);
|
||||
return byteBuffer;
|
||||
}
|
||||
|
||||
// Only called as read( buf, 12, msgsize-12 ) in readGIOPMessage
|
||||
// We can ignore the byteBuffer parameter
|
||||
// offset is the starting position to place data in the result
|
||||
// length is the length of the data to read
|
||||
public ByteBuffer read(ByteBuffer byteBuffer, int offset, int length)
|
||||
throws IOException
|
||||
{
|
||||
int size = offset + length;
|
||||
byte[] buf = new byte[size];
|
||||
readFully(buf, offset, length);
|
||||
return ByteBuffer.wrap(buf);
|
||||
}
|
||||
|
||||
// Read size bytes from buffer list and place the data
|
||||
// starting at offset in buf.
|
||||
public void readFully(byte[] buf, int offset, int size)
|
||||
throws IOException
|
||||
{
|
||||
int remaining = size ;
|
||||
int position = offset ;
|
||||
while (remaining > 0) {
|
||||
ByteBuffer buff = (ByteBuffer)buffers.get(0) ;
|
||||
int dataSize = buff.remaining() ;
|
||||
int xferSize = dataSize ;
|
||||
if (dataSize >= remaining) :
|
||||
xferSize = remaining ;
|
||||
buffers.remove(0) ;
|
||||
}
|
||||
|
||||
buff.get( buf, offset, xferSize ) ;
|
||||
|
||||
offset += xferSize ;
|
||||
remaining -= xferSize ;
|
||||
}
|
||||
}
|
||||
|
||||
public void write(ByteBuffer byteBuffer)
|
||||
throws IOException
|
||||
{
|
||||
buffers.add( byteBuffer ) ;
|
||||
}
|
||||
|
||||
/**
|
||||
* Note:it is possible for this to be called more than once
|
||||
*/
|
||||
public synchronized void close()
|
||||
{
|
||||
}
|
||||
|
||||
public Acceptor getAcceptor()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
public ContactInfo getContactInfo()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
public EventHandler getEventHandler()
|
||||
{
|
||||
return this;
|
||||
}
|
||||
|
||||
public OutputObject createOutputObject(MessageMediator messageMediator)
|
||||
{
|
||||
// REVISIT - remove this method from Connection and all it subclasses.
|
||||
throw new RuntimeException("*****SocketOrChannelConnectionImpl.createOutputObject - should not be called.");
|
||||
}
|
||||
|
||||
// This is used by the GIOPOutputObject in order to
|
||||
// throw the correct error when handling code sets.
|
||||
// Can we determine if we are on the server side by
|
||||
// other means? XREVISIT
|
||||
public boolean isServer()
|
||||
{
|
||||
return isServer;
|
||||
}
|
||||
|
||||
public boolean isBusy()
|
||||
{
|
||||
return false ;
|
||||
}
|
||||
|
||||
public long getTimeStamp()
|
||||
{
|
||||
return timeStamp;
|
||||
}
|
||||
|
||||
public void setTimeStamp(long time)
|
||||
{
|
||||
timeStamp = time;
|
||||
}
|
||||
|
||||
public void setState(String stateString)
|
||||
{
|
||||
synchronized (stateEvent) {
|
||||
if (stateString.equals("ESTABLISHED")) {
|
||||
state = ESTABLISHED;
|
||||
stateEvent.notifyAll();
|
||||
} else {
|
||||
// REVISIT: ASSERT
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
public void writeLock()
|
||||
{
|
||||
}
|
||||
|
||||
public void writeUnlock()
|
||||
{
|
||||
}
|
||||
|
||||
public void sendWithoutLock(OutputObject outputObject)
|
||||
{
|
||||
}
|
||||
|
||||
public void registerWaiter(MessageMediator messageMediator)
|
||||
{
|
||||
}
|
||||
|
||||
public void unregisterWaiter(MessageMediator messageMediator)
|
||||
{
|
||||
}
|
||||
|
||||
public InputObject waitForResponse(MessageMediator messageMediator)
|
||||
{
|
||||
return null ;
|
||||
}
|
||||
|
||||
public void setConnectionCache(ConnectionCache connectionCache)
|
||||
{
|
||||
}
|
||||
|
||||
public ConnectionCache getConnectionCache()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
////////////////////////////////////////////////////
|
||||
//
|
||||
// EventHandler methods
|
||||
//
|
||||
|
||||
public SelectableChannel getChannel()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
public int getInterestOps()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
// public Acceptor getAcceptor() - already defined above.
|
||||
|
||||
public Connection getConnection()
|
||||
{
|
||||
return this;
|
||||
}
|
||||
|
||||
////////////////////////////////////////////////////
|
||||
//
|
||||
// Work methods.
|
||||
//
|
||||
|
||||
public String getName()
|
||||
{
|
||||
return this.toString();
|
||||
}
|
||||
|
||||
public void doWork()
|
||||
{
|
||||
}
|
||||
|
||||
public void setEnqueueTime(long timeInMillis)
|
||||
{
|
||||
enqueueTime = timeInMillis;
|
||||
}
|
||||
|
||||
public long getEnqueueTime()
|
||||
{
|
||||
return enqueueTime;
|
||||
}
|
||||
|
||||
////////////////////////////////////////////////////
|
||||
//
|
||||
// spi.transport.CorbaConnection.
|
||||
//
|
||||
|
||||
public ResponseWaitingRoom getResponseWaitingRoom()
|
||||
{
|
||||
return null ;
|
||||
}
|
||||
|
||||
// REVISIT - inteface defines isServer but already defined in
|
||||
// higher interface.
|
||||
|
||||
|
||||
public void serverRequestMapPut(int requestId,
|
||||
CorbaMessageMediator messageMediator)
|
||||
{
|
||||
serverRequestMap.put(new Integer(requestId), messageMediator);
|
||||
}
|
||||
|
||||
public CorbaMessageMediator serverRequestMapGet(int requestId)
|
||||
{
|
||||
return (CorbaMessageMediator)
|
||||
serverRequestMap.get(new Integer(requestId));
|
||||
}
|
||||
|
||||
public void serverRequestMapRemove(int requestId)
|
||||
{
|
||||
serverRequestMap.remove(new Integer(requestId));
|
||||
}
|
||||
|
||||
|
||||
// REVISIT: this is also defined in:
|
||||
// com.sun.corba.se.spi.legacy.connection.Connection
|
||||
public java.net.Socket getSocket()
|
||||
{
|
||||
return null;
|
||||
}
|
||||
|
||||
/** It is possible for a Close Connection to have been
|
||||
** sent here, but we will not check for this. A "lazy"
|
||||
** Exception will be thrown in the Worker thread after the
|
||||
** incoming request has been processed even though the connection
|
||||
** is closed before the request is processed. This is o.k because
|
||||
** it is a boundary condition. To prevent it we would have to add
|
||||
** more locks which would reduce performance in the normal case.
|
||||
**/
|
||||
public synchronized void serverRequestProcessingBegins()
|
||||
{
|
||||
serverRequestCount++;
|
||||
}
|
||||
|
||||
public synchronized void serverRequestProcessingEnds()
|
||||
{
|
||||
serverRequestCount--;
|
||||
}
|
||||
|
||||
//
|
||||
//
|
||||
//
|
||||
|
||||
public synchronized int getNextRequestId()
|
||||
{
|
||||
return requestId++;
|
||||
}
|
||||
|
||||
// Negotiated code sets for char and wchar data
|
||||
protected CodeSetComponentInfo.CodeSetContext codeSetContext = null;
|
||||
|
||||
public ORB getBroker()
|
||||
{
|
||||
return orb;
|
||||
}
|
||||
|
||||
public CodeSetComponentInfo.CodeSetContext getCodeSetContext()
|
||||
{
|
||||
// Needs to be synchronized for the following case when the client
|
||||
// doesn't send the code set context twice, and we have two threads
|
||||
// in ServerRequestDispatcher processCodeSetContext.
|
||||
//
|
||||
// Thread A checks to see if there is a context, there is none, so
|
||||
// it calls setCodeSetContext, getting the synch lock.
|
||||
// Thread B checks to see if there is a context. If we didn't synch,
|
||||
// it might decide to outlaw wchar/wstring.
|
||||
if (codeSetContext == null) {
|
||||
synchronized(this) {
|
||||
return codeSetContext;
|
||||
}
|
||||
}
|
||||
|
||||
return codeSetContext;
|
||||
}
|
||||
|
||||
public synchronized void setCodeSetContext(CodeSetComponentInfo.CodeSetContext csc) {
|
||||
// Double check whether or not we need to do this
|
||||
if (codeSetContext == null) {
|
||||
|
||||
if (OSFCodeSetRegistry.lookupEntry(csc.getCharCodeSet()) == null ||
|
||||
OSFCodeSetRegistry.lookupEntry(csc.getWCharCodeSet()) == null) {
|
||||
// If the client says it's negotiated a code set that
|
||||
// isn't a fallback and we never said we support, then
|
||||
// it has a bug.
|
||||
throw wrapper.badCodesetsFromClient() ;
|
||||
}
|
||||
|
||||
codeSetContext = csc;
|
||||
}
|
||||
}
|
||||
|
||||
//
|
||||
// from iiop.IIOPConnection.java
|
||||
//
|
||||
|
||||
// Map request ID to an InputObject.
|
||||
// This is so the client thread can start unmarshaling
|
||||
// the reply and remove it from the out_calls map while the
|
||||
// ReaderThread can still obtain the input stream to give
|
||||
// new fragments. Only the ReaderThread touches the clientReplyMap,
|
||||
// so it doesn't incur synchronization overhead.
|
||||
|
||||
public MessageMediator clientRequestMapGet(int requestId)
|
||||
{
|
||||
return null ;
|
||||
}
|
||||
|
||||
protected MessageMediator clientReply_1_1;
|
||||
|
||||
public void clientReply_1_1_Put(MessageMediator x)
|
||||
{
|
||||
clientReply_1_1 = x;
|
||||
}
|
||||
|
||||
public MessageMediator clientReply_1_1_Get()
|
||||
{
|
||||
return clientReply_1_1;
|
||||
}
|
||||
|
||||
public void clientReply_1_1_Remove()
|
||||
{
|
||||
clientReply_1_1 = null;
|
||||
}
|
||||
|
||||
protected MessageMediator serverRequest_1_1;
|
||||
|
||||
public void serverRequest_1_1_Put(MessageMediator x)
|
||||
{
|
||||
serverRequest_1_1 = x;
|
||||
}
|
||||
|
||||
public MessageMediator serverRequest_1_1_Get()
|
||||
{
|
||||
return serverRequest_1_1;
|
||||
}
|
||||
|
||||
public void serverRequest_1_1_Remove()
|
||||
{
|
||||
serverRequest_1_1 = null;
|
||||
}
|
||||
|
||||
protected String getStateString( int state )
|
||||
{
|
||||
synchronized ( stateEvent ){
|
||||
switch (state) {
|
||||
case OPENING : return "OPENING" ;
|
||||
case ESTABLISHED : return "ESTABLISHED" ;
|
||||
case CLOSE_SENT : return "CLOSE_SENT" ;
|
||||
case CLOSE_RECVD : return "CLOSE_RECVD" ;
|
||||
case ABORT : return "ABORT" ;
|
||||
default : return "???" ;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
public synchronized boolean isPostInitialContexts() {
|
||||
return postInitialContexts;
|
||||
}
|
||||
|
||||
// Can never be unset...
|
||||
public synchronized void setPostInitialContexts(){
|
||||
postInitialContexts = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Wake up the outstanding requests on the connection, and hand them
|
||||
* COMM_FAILURE exception with a given minor code.
|
||||
*
|
||||
* Also, delete connection from connection table and
|
||||
* stop the reader thread.
|
||||
|
||||
* Note that this should only ever be called by the Reader thread for
|
||||
* this connection.
|
||||
*
|
||||
* @param minor_code The minor code for the COMM_FAILURE major code.
|
||||
* @param die Kill the reader thread (this thread) before exiting.
|
||||
*/
|
||||
public void purgeCalls(SystemException systemException,
|
||||
boolean die, boolean lockHeld)
|
||||
{
|
||||
}
|
||||
|
||||
/*************************************************************************
|
||||
* The following methods are for dealing with Connection cleaning for
|
||||
* better scalability of servers in high network load conditions.
|
||||
**************************************************************************/
|
||||
|
||||
public void sendCloseConnection(GIOPVersion giopVersion)
|
||||
throws IOException
|
||||
{
|
||||
Message msg = MessageBase.createCloseConnection(giopVersion);
|
||||
sendHelper(giopVersion, msg);
|
||||
}
|
||||
|
||||
public void sendMessageError(GIOPVersion giopVersion)
|
||||
throws IOException
|
||||
{
|
||||
Message msg = MessageBase.createMessageError(giopVersion);
|
||||
sendHelper(giopVersion, msg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Send a CancelRequest message. This does not lock the connection, so the
|
||||
* caller needs to ensure this method is called appropriately.
|
||||
* @exception IOException - could be due to abortive connection closure.
|
||||
*/
|
||||
public void sendCancelRequest(GIOPVersion giopVersion, int requestId)
|
||||
throws IOException
|
||||
{
|
||||
|
||||
Message msg = MessageBase.createCancelRequest(giopVersion, requestId);
|
||||
sendHelper(giopVersion, msg);
|
||||
}
|
||||
|
||||
protected void sendHelper(GIOPVersion giopVersion, Message msg)
|
||||
throws IOException
|
||||
{
|
||||
// REVISIT: See comments in CDROutputObject constructor.
|
||||
CDROutputObject outputObject =
|
||||
new CDROutputObject((ORB)orb, null, giopVersion, this, msg,
|
||||
ORBConstants.STREAM_FORMAT_VERSION_1);
|
||||
msg.write(outputObject);
|
||||
|
||||
outputObject.writeTo(this);
|
||||
}
|
||||
|
||||
public void sendCancelRequestWithLock(GIOPVersion giopVersion,
|
||||
int requestId)
|
||||
throws IOException
|
||||
{
|
||||
writeLock();
|
||||
try {
|
||||
sendCancelRequest(giopVersion, requestId);
|
||||
} finally {
|
||||
writeUnlock();
|
||||
}
|
||||
}
|
||||
|
||||
// Begin Code Base methods ---------------------------------------
|
||||
//
|
||||
// Set this connection's code base IOR. The IOR comes from the
|
||||
// SendingContext. This is an optional service context, but all
|
||||
// JavaSoft ORBs send it.
|
||||
//
|
||||
// The set and get methods don't need to be synchronized since the
|
||||
// first possible get would occur during reading a valuetype, and
|
||||
// that would be after the set.
|
||||
|
||||
// Sets this connection's code base IOR. This is done after
|
||||
// getting the IOR out of the SendingContext service context.
|
||||
// Our ORBs always send this, but it's optional in CORBA.
|
||||
|
||||
public final void setCodeBaseIOR(IOR ior) {
|
||||
codeBaseServerIOR = ior;
|
||||
}
|
||||
|
||||
public final IOR getCodeBaseIOR() {
|
||||
return codeBaseServerIOR;
|
||||
}
|
||||
|
||||
// Get a CodeBase stub to use in unmarshaling. The CachedCodeBase
|
||||
// won't connect to the remote codebase unless it's necessary.
|
||||
public final CodeBase getCodeBase() {
|
||||
return cachedCodeBase;
|
||||
}
|
||||
|
||||
// End Code Base methods -----------------------------------------
|
||||
|
||||
// Can be overridden in subclass for different options.
|
||||
protected void setSocketOptions(Socket socket)
|
||||
{
|
||||
}
|
||||
|
||||
public String toString()
|
||||
{
|
||||
synchronized ( stateEvent ){
|
||||
return
|
||||
"BufferConnectionImpl[" + " "
|
||||
+ getStateString( state ) + " "
|
||||
+ shouldUseSelectThreadToWait() + " "
|
||||
+ shouldUseWorkerThreadForEvent()
|
||||
+ "]" ;
|
||||
}
|
||||
}
|
||||
|
||||
// Must be public - used in encoding.
|
||||
public void dprint(String msg)
|
||||
{
|
||||
ORBUtility.dprint("SocketOrChannelConnectionImpl", msg);
|
||||
}
|
||||
|
||||
protected void dprint(String msg, Throwable t)
|
||||
{
|
||||
dprint(msg);
|
||||
t.printStackTrace(System.out);
|
||||
}
|
||||
}
|
||||
|
||||
// End of file.
|
|
@ -365,3 +365,5 @@ c9dd82da51ed34a28f7c6b3245163ee962e94572 hs25-b40
|
|||
46487ba40ff225654d0c51787ed3839bafcbd9f3 hs25-b43
|
||||
f6921c876db192bba389cec062855a66372da01c jdk8-b101
|
||||
530fe88b3b2c710f42810b3580d86a0d83ad6c1c hs25-b44
|
||||
c4697c1c448416108743b59118b4a2498b339d0c jdk8-b102
|
||||
7f55137d6aa81efc6eb0035813709f2cb6a26b8b hs25-b45
|
||||
|
|
|
@ -29,11 +29,10 @@ public interface JVMTIThreadState {
|
|||
public static final int JVMTI_THREAD_STATE_ALIVE = 0x0001;
|
||||
public static final int JVMTI_THREAD_STATE_TERMINATED = 0x0002;
|
||||
public static final int JVMTI_THREAD_STATE_RUNNABLE = 0x0004;
|
||||
public static final int JVMTI_THREAD_STATE_WAITING = 0x0008;
|
||||
public static final int JVMTI_THREAD_STATE_WAITING = 0x0080;
|
||||
public static final int JVMTI_THREAD_STATE_WAITING_INDEFINITELY = 0x0010;
|
||||
public static final int JVMTI_THREAD_STATE_WAITING_WITH_TIMEOUT = 0x0020;
|
||||
public static final int JVMTI_THREAD_STATE_SLEEPING = 0x0040;
|
||||
public static final int JVMTI_THREAD_STATE_WAITING_FOR_NOTIFICATION = 0x0080;
|
||||
public static final int JVMTI_THREAD_STATE_IN_OBJECT_WAIT = 0x0100;
|
||||
public static final int JVMTI_THREAD_STATE_PARKED = 0x0200;
|
||||
public static final int JVMTI_THREAD_STATE_BLOCKED_ON_MONITOR_ENTER = 0x0400;
|
||||
|
|
|
@ -32,7 +32,7 @@ import sun.jvm.hotspot.types.*;
|
|||
// to the sys_thread_t structure of the classic JVM implementation.
|
||||
public class OSThread extends VMObject {
|
||||
private static JIntField interruptedField;
|
||||
private static JIntField threadIdField;
|
||||
private static Field threadIdField;
|
||||
static {
|
||||
VM.registerVMInitializedObserver(new Observer() {
|
||||
public void update(Observable o, Object data) {
|
||||
|
@ -44,7 +44,7 @@ public class OSThread extends VMObject {
|
|||
private static synchronized void initialize(TypeDataBase db) {
|
||||
Type type = db.lookupType("OSThread");
|
||||
interruptedField = type.getJIntField("_interrupted");
|
||||
threadIdField = type.getJIntField("_thread_id");
|
||||
threadIdField = type.getField("_thread_id");
|
||||
}
|
||||
|
||||
public OSThread(Address addr) {
|
||||
|
@ -56,7 +56,7 @@ public class OSThread extends VMObject {
|
|||
}
|
||||
|
||||
public int threadId() {
|
||||
return (int)threadIdField.getValue(addr);
|
||||
return threadIdField.getJInt(addr);
|
||||
}
|
||||
|
||||
}
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2002, 2011, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2002, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -74,7 +74,8 @@ public class ClassDump extends Tool {
|
|||
public void run() {
|
||||
// Ready to go with the database...
|
||||
try {
|
||||
// The name of the filter always comes from a System property.
|
||||
if (classFilter == null) {
|
||||
// If not already set, the name of the filter comes from a System property.
|
||||
// If we have a pkgList, pass it, otherwise let the filter read
|
||||
// its own System property for the list of classes.
|
||||
String filterClassName = System.getProperty("sun.jvm.hotspot.tools.jcore.filter",
|
||||
|
@ -90,7 +91,7 @@ public class ClassDump extends Tool {
|
|||
} catch(Exception exp) {
|
||||
System.err.println("Warning: Can not create class filter!");
|
||||
}
|
||||
|
||||
}
|
||||
String outputDirectory = System.getProperty("sun.jvm.hotspot.tools.jcore.outputDir", ".");
|
||||
setOutputDirectory(outputDirectory);
|
||||
|
||||
|
|
|
@ -35,7 +35,7 @@ HOTSPOT_VM_COPYRIGHT=Copyright 2013
|
|||
|
||||
HS_MAJOR_VER=25
|
||||
HS_MINOR_VER=0
|
||||
HS_BUILD_NUMBER=44
|
||||
HS_BUILD_NUMBER=45
|
||||
|
||||
JDK_MAJOR_VER=1
|
||||
JDK_MINOR_VER=8
|
||||
|
|
|
@ -2295,7 +2295,7 @@ void LIRGenerator::do_UnsafeGetObject(UnsafeGetObject* x) {
|
|||
if (gen_type_check) {
|
||||
// We have determined that offset == referent_offset && src != null.
|
||||
// if (src->_klass->_reference_type == REF_NONE) -> continue
|
||||
__ move(new LIR_Address(src.result(), oopDesc::klass_offset_in_bytes(), UseCompressedKlassPointers ? T_OBJECT : T_ADDRESS), src_klass);
|
||||
__ move(new LIR_Address(src.result(), oopDesc::klass_offset_in_bytes(), T_ADDRESS), src_klass);
|
||||
LIR_Address* reference_type_addr = new LIR_Address(src_klass, in_bytes(InstanceKlass::reference_type_offset()), T_BYTE);
|
||||
LIR_Opr reference_type = new_register(T_INT);
|
||||
__ move(reference_type_addr, reference_type);
|
||||
|
|
|
@ -878,7 +878,7 @@ objArrayOop ClassLoader::get_system_packages(TRAPS) {
|
|||
|
||||
instanceKlassHandle ClassLoader::load_classfile(Symbol* h_name, TRAPS) {
|
||||
ResourceMark rm(THREAD);
|
||||
EventMark m("loading class " INTPTR_FORMAT, (address)h_name);
|
||||
EventMark m("loading class %s", h_name->as_C_string());
|
||||
ThreadProfilerMark tpm(ThreadProfilerMark::classLoaderRegion);
|
||||
|
||||
stringStream st;
|
||||
|
|
|
@ -60,6 +60,28 @@
|
|||
#define DEFAULT_VENDOR_URL_BUG "http://bugreport.sun.com/bugreport/crash.jsp"
|
||||
#define DEFAULT_JAVA_LAUNCHER "generic"
|
||||
|
||||
// Disable options not supported in this release, with a warning if they
|
||||
// were explicitly requested on the command-line
|
||||
#define UNSUPPORTED_OPTION(opt, description) \
|
||||
do { \
|
||||
if (opt) { \
|
||||
if (FLAG_IS_CMDLINE(opt)) { \
|
||||
warning(description " is disabled in this release."); \
|
||||
} \
|
||||
FLAG_SET_DEFAULT(opt, false); \
|
||||
} \
|
||||
} while(0)
|
||||
|
||||
#define UNSUPPORTED_GC_OPTION(gc) \
|
||||
do { \
|
||||
if (gc) { \
|
||||
if (FLAG_IS_CMDLINE(gc)) { \
|
||||
warning(#gc " is not supported in this VM. Using Serial GC."); \
|
||||
} \
|
||||
FLAG_SET_DEFAULT(gc, false); \
|
||||
} \
|
||||
} while(0)
|
||||
|
||||
char** Arguments::_jvm_flags_array = NULL;
|
||||
int Arguments::_num_jvm_flags = 0;
|
||||
char** Arguments::_jvm_args_array = NULL;
|
||||
|
@ -3128,14 +3150,17 @@ jint Arguments::finalize_vm_init_args(SysClassPath* scp_p, bool scp_assembly_req
|
|||
FLAG_SET_DEFAULT(UseLargePages, false);
|
||||
}
|
||||
|
||||
// Tiered compilation is undefined with C1.
|
||||
TieredCompilation = false;
|
||||
#else
|
||||
if (!FLAG_IS_DEFAULT(OptoLoopAlignment) && FLAG_IS_DEFAULT(MaxLoopPad)) {
|
||||
FLAG_SET_DEFAULT(MaxLoopPad, OptoLoopAlignment-1);
|
||||
}
|
||||
#endif
|
||||
|
||||
#ifndef TIERED
|
||||
// Tiered compilation is undefined.
|
||||
UNSUPPORTED_OPTION(TieredCompilation, "TieredCompilation");
|
||||
#endif
|
||||
|
||||
// If we are running in a headless jre, force java.awt.headless property
|
||||
// to be true unless the property has already been set.
|
||||
// Also allow the OS environment variable JAVA_AWT_HEADLESS to set headless state.
|
||||
|
@ -3278,29 +3303,6 @@ void Arguments::set_shared_spaces_flags() {
|
|||
}
|
||||
}
|
||||
|
||||
// Disable options not supported in this release, with a warning if they
|
||||
// were explicitly requested on the command-line
|
||||
#define UNSUPPORTED_OPTION(opt, description) \
|
||||
do { \
|
||||
if (opt) { \
|
||||
if (FLAG_IS_CMDLINE(opt)) { \
|
||||
warning(description " is disabled in this release."); \
|
||||
} \
|
||||
FLAG_SET_DEFAULT(opt, false); \
|
||||
} \
|
||||
} while(0)
|
||||
|
||||
|
||||
#define UNSUPPORTED_GC_OPTION(gc) \
|
||||
do { \
|
||||
if (gc) { \
|
||||
if (FLAG_IS_CMDLINE(gc)) { \
|
||||
warning(#gc " is not supported in this VM. Using Serial GC."); \
|
||||
} \
|
||||
FLAG_SET_DEFAULT(gc, false); \
|
||||
} \
|
||||
} while(0)
|
||||
|
||||
#if !INCLUDE_ALL_GCS
|
||||
static void force_serial_gc() {
|
||||
FLAG_SET_DEFAULT(UseSerialGC, true);
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -211,9 +211,9 @@ void GCNotifier::sendNotificationInternal(TRAPS) {
|
|||
NotificationMark nm(request);
|
||||
Handle objGcInfo = createGcInfo(request->gcManager, request->gcStatInfo, THREAD);
|
||||
|
||||
Handle objName = java_lang_String::create_from_platform_dependent_str(request->gcManager->name(), CHECK);
|
||||
Handle objAction = java_lang_String::create_from_platform_dependent_str(request->gcAction, CHECK);
|
||||
Handle objCause = java_lang_String::create_from_platform_dependent_str(request->gcCause, CHECK);
|
||||
Handle objName = java_lang_String::create_from_str(request->gcManager->name(), CHECK);
|
||||
Handle objAction = java_lang_String::create_from_str(request->gcAction, CHECK);
|
||||
Handle objCause = java_lang_String::create_from_str(request->gcCause, CHECK);
|
||||
|
||||
Klass* k = Management::sun_management_GarbageCollectorImpl_klass(CHECK);
|
||||
instanceKlassHandle gc_mbean_klass(THREAD, k);
|
||||
|
|
|
@ -1831,13 +1831,13 @@ class ThreadTimesClosure: public ThreadClosure {
|
|||
private:
|
||||
objArrayHandle _names_strings;
|
||||
char **_names_chars;
|
||||
typeArrayOop _times;
|
||||
typeArrayHandle _times;
|
||||
int _names_len;
|
||||
int _times_len;
|
||||
int _count;
|
||||
|
||||
public:
|
||||
ThreadTimesClosure(objArrayHandle names, typeArrayOop times);
|
||||
ThreadTimesClosure(objArrayHandle names, typeArrayHandle times);
|
||||
~ThreadTimesClosure();
|
||||
virtual void do_thread(Thread* thread);
|
||||
void do_unlocked();
|
||||
|
@ -1845,9 +1845,9 @@ class ThreadTimesClosure: public ThreadClosure {
|
|||
};
|
||||
|
||||
ThreadTimesClosure::ThreadTimesClosure(objArrayHandle names,
|
||||
typeArrayOop times) {
|
||||
typeArrayHandle times) {
|
||||
assert(names() != NULL, "names was NULL");
|
||||
assert(times != NULL, "times was NULL");
|
||||
assert(times() != NULL, "times was NULL");
|
||||
_names_strings = names;
|
||||
_names_len = names->length();
|
||||
_names_chars = NEW_C_HEAP_ARRAY(char*, _names_len, mtInternal);
|
||||
|
@ -1925,7 +1925,7 @@ JVM_ENTRY(jint, jmm_GetInternalThreadTimes(JNIEnv *env,
|
|||
typeArrayOop ta = typeArrayOop(JNIHandles::resolve_non_null(times));
|
||||
typeArrayHandle times_ah(THREAD, ta);
|
||||
|
||||
ThreadTimesClosure ttc(names_ah, times_ah());
|
||||
ThreadTimesClosure ttc(names_ah, times_ah);
|
||||
{
|
||||
MutexLockerEx ml(Threads_lock);
|
||||
Threads::threads_do(&ttc);
|
||||
|
|
|
@ -125,13 +125,13 @@ void Exceptions::_throw_oop(Thread* thread, const char* file, int line, oop exce
|
|||
}
|
||||
|
||||
void Exceptions::_throw(Thread* thread, const char* file, int line, Handle h_exception, const char* message) {
|
||||
ResourceMark rm;
|
||||
assert(h_exception() != NULL, "exception should not be NULL");
|
||||
|
||||
// tracing (do this up front - so it works during boot strapping)
|
||||
if (TraceExceptions) {
|
||||
ttyLocker ttyl;
|
||||
ResourceMark rm;
|
||||
tty->print_cr("Exception <%s>%s%s (" INTPTR_FORMAT " ) \n"
|
||||
tty->print_cr("Exception <%s%s%s> (" INTPTR_FORMAT ") \n"
|
||||
"thrown [%s, line %d]\nfor thread " INTPTR_FORMAT,
|
||||
h_exception->print_value_string(),
|
||||
message ? ": " : "", message ? message : "",
|
||||
|
@ -141,7 +141,9 @@ void Exceptions::_throw(Thread* thread, const char* file, int line, Handle h_exc
|
|||
NOT_PRODUCT(Exceptions::debug_check_abort(h_exception, message));
|
||||
|
||||
// Check for special boot-strapping/vm-thread handling
|
||||
if (special_exception(thread, file, line, h_exception)) return;
|
||||
if (special_exception(thread, file, line, h_exception)) {
|
||||
return;
|
||||
}
|
||||
|
||||
assert(h_exception->is_a(SystemDictionary::Throwable_klass()), "exception is not a subclass of java/lang/Throwable");
|
||||
|
||||
|
@ -149,7 +151,9 @@ void Exceptions::_throw(Thread* thread, const char* file, int line, Handle h_exc
|
|||
thread->set_pending_exception(h_exception(), file, line);
|
||||
|
||||
// vm log
|
||||
Events::log_exception(thread, "Threw " INTPTR_FORMAT " at %s:%d", (address)h_exception(), file, line);
|
||||
Events::log_exception(thread, "Exception <%s%s%s> (" INTPTR_FORMAT ") thrown at [%s, line %d]",
|
||||
h_exception->print_value_string(), message ? ": " : "", message ? message : "",
|
||||
(address)h_exception(), file, line);
|
||||
}
|
||||
|
||||
|
||||
|
|
|
@ -395,7 +395,13 @@ bool GenericTaskQueue<E, F, N>::pop_local_slow(uint localBot, Age oldAge) {
|
|||
template<class E, MEMFLAGS F, unsigned int N>
|
||||
bool GenericTaskQueue<E, F, N>::pop_global(E& t) {
|
||||
Age oldAge = _age.get();
|
||||
uint localBot = _bottom;
|
||||
// Architectures with weak memory model require a barrier here
|
||||
// to guarantee that bottom is not older than age,
|
||||
// which is crucial for the correctness of the algorithm.
|
||||
#if !(defined SPARC || defined IA32 || defined AMD64)
|
||||
OrderAccess::fence();
|
||||
#endif
|
||||
uint localBot = OrderAccess::load_acquire((volatile juint*)&_bottom);
|
||||
uint n_elems = size(localBot, oldAge.top());
|
||||
if (n_elems == 0) {
|
||||
return false;
|
||||
|
@ -644,7 +650,7 @@ public:
|
|||
template<class E, MEMFLAGS F, unsigned int N> inline bool
|
||||
GenericTaskQueue<E, F, N>::push(E t) {
|
||||
uint localBot = _bottom;
|
||||
assert((localBot >= 0) && (localBot < N), "_bottom out of range.");
|
||||
assert(localBot < N, "_bottom out of range.");
|
||||
idx_t top = _age.top();
|
||||
uint dirty_n_elems = dirty_size(localBot, top);
|
||||
assert(dirty_n_elems < N, "n_elems out of range.");
|
||||
|
|
|
@ -35,10 +35,6 @@ public class CheckUpperLimit {
|
|||
ProcessBuilder pb;
|
||||
OutputAnalyzer out;
|
||||
|
||||
pb = ProcessTools.createJavaProcessBuilder("-XX:ReservedCodeCacheSize=2048m", "-version");
|
||||
out = new OutputAnalyzer(pb.start());
|
||||
out.shouldHaveExitValue(0);
|
||||
|
||||
pb = ProcessTools.createJavaProcessBuilder("-XX:ReservedCodeCacheSize=2049m", "-version");
|
||||
out = new OutputAnalyzer(pb.start());
|
||||
out.shouldContain("Invalid ReservedCodeCacheSize=");
|
||||
|
|
|
@ -0,0 +1,71 @@
|
|||
/*
|
||||
* Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
/*
|
||||
* @test
|
||||
* @bug 8016474
|
||||
* @summary The bug only happens with C1 and G1 using a different ObjectAlignmentInBytes than KlassAlignmentInBytes (which is 8)
|
||||
* @run main/othervm -Xbatch -XX:+IgnoreUnrecognizedVMOptions -XX:ObjectAlignmentInBytes=32 GetUnsafeObjectG1PreBarrier
|
||||
*/
|
||||
|
||||
import java.lang.reflect.Field;
|
||||
|
||||
import sun.misc.Unsafe;
|
||||
|
||||
public class GetUnsafeObjectG1PreBarrier {
|
||||
private static final Unsafe unsafe;
|
||||
private static final int N = 100_000;
|
||||
|
||||
static {
|
||||
try {
|
||||
Field theUnsafe = Unsafe.class.getDeclaredField("theUnsafe");
|
||||
theUnsafe.setAccessible(true);
|
||||
unsafe = (Unsafe) theUnsafe.get(null);
|
||||
} catch (NoSuchFieldException | IllegalAccessException e) {
|
||||
throw new IllegalStateException(e);
|
||||
}
|
||||
}
|
||||
|
||||
public Object a;
|
||||
|
||||
public static void main(String[] args) throws Throwable {
|
||||
new GetUnsafeObjectG1PreBarrier();
|
||||
}
|
||||
|
||||
public GetUnsafeObjectG1PreBarrier() throws Throwable {
|
||||
doit();
|
||||
}
|
||||
|
||||
private void doit() throws Throwable {
|
||||
Field field = GetUnsafeObjectG1PreBarrier.class.getField("a");
|
||||
long fieldOffset = unsafe.objectFieldOffset(field);
|
||||
|
||||
for (int i = 0; i < N; i++) {
|
||||
readField(this, fieldOffset);
|
||||
}
|
||||
}
|
||||
|
||||
private void readField(Object o, long fieldOffset) {
|
||||
unsafe.getObject(o, fieldOffset);
|
||||
}
|
||||
}
|
|
@ -1,99 +0,0 @@
|
|||
#
|
||||
# Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
#
|
||||
# This code is free software; you can redistribute it and/or modify it
|
||||
# under the terms of the GNU General Public License version 2 only, as
|
||||
# published by the Free Software Foundation.
|
||||
#
|
||||
# This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
# version 2 for more details (a copy is included in the LICENSE file that
|
||||
# accompanied this code).
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License version
|
||||
# 2 along with this work; if not, write to the Free Software Foundation,
|
||||
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
#
|
||||
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
# or visit www.oracle.com if you need additional information or have any
|
||||
# questions.
|
||||
#
|
||||
|
||||
|
||||
# @test Test8000968.sh
|
||||
# @bug 8000968
|
||||
# @summary NPG: UseCompressedKlassPointers asserts with ObjectAlignmentInBytes=32
|
||||
# @run shell Test8000968.sh
|
||||
#
|
||||
|
||||
if [ "${TESTJAVA}" = "" ]
|
||||
then
|
||||
PARENT=`dirname \`which java\``
|
||||
TESTJAVA=`dirname ${PARENT}`
|
||||
printf "TESTJAVA not set, selecting " ${TESTJAVA}
|
||||
printf " If this is incorrect, try setting the variable manually.\n"
|
||||
fi
|
||||
|
||||
|
||||
# set platform-dependent variables
|
||||
OS=`uname -s`
|
||||
case "$OS" in
|
||||
Windows_* )
|
||||
FS="\\"
|
||||
NULL=NUL
|
||||
;;
|
||||
* )
|
||||
FS="/"
|
||||
NULL=/dev/null
|
||||
;;
|
||||
esac
|
||||
|
||||
JAVA=${TESTJAVA}${FS}bin${FS}java
|
||||
|
||||
#
|
||||
# See if platform has 64 bit java.
|
||||
#
|
||||
${JAVA} ${TESTVMOPTS} -d64 -version 2>&1 | grep -i "does not support" > ${NULL}
|
||||
if [ "$?" != "1" ]
|
||||
then
|
||||
printf "Platform is 32 bit, does not support -XX:ObjectAlignmentInBytes= option.\n"
|
||||
printf "Passed.\n"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
#
|
||||
# Test -XX:ObjectAlignmentInBytes with -XX:+UseCompressedKlassPointers -XX:+UseCompressedOops.
|
||||
#
|
||||
${JAVA} ${TESTVMOPTS} -d64 -XX:+UseCompressedKlassPointers -XX:+UseCompressedOops -XX:ObjectAlignmentInBytes=16 -version 2>&1 > ${NULL}
|
||||
if [ "$?" != "0" ]
|
||||
then
|
||||
printf "FAILED: -XX:ObjectAlignmentInBytes=16 option did not work.\n"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
${JAVA} ${TESTVMOPTS} -d64 -XX:+UseCompressedKlassPointers -XX:+UseCompressedOops -XX:ObjectAlignmentInBytes=32 -version 2>&1 > ${NULL}
|
||||
if [ "$?" != "0" ]
|
||||
then
|
||||
printf "FAILED: -XX:ObjectAlignmentInBytes=32 option did not work.\n"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
${JAVA} ${TESTVMOPTS} -d64 -XX:+UseCompressedKlassPointers -XX:+UseCompressedOops -XX:ObjectAlignmentInBytes=64 -version 2>&1 > ${NULL}
|
||||
if [ "$?" != "0" ]
|
||||
then
|
||||
printf "FAILED: -XX:ObjectAlignmentInBytes=64 option did not work.\n"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
${JAVA} ${TESTVMOPTS} -d64 -XX:+UseCompressedKlassPointers -XX:+UseCompressedOops -XX:ObjectAlignmentInBytes=128 -version 2>&1 > ${NULL}
|
||||
if [ "$?" != "0" ]
|
||||
then
|
||||
printf "FAILED: -XX:ObjectAlignmentInBytes=128 option did not work.\n"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
|
||||
printf "Passed.\n"
|
||||
exit 0
|
|
@ -0,0 +1,63 @@
|
|||
/*
|
||||
* Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
/*
|
||||
* @test
|
||||
* @bug 8000968
|
||||
* @key regression
|
||||
* @summary NPG: UseCompressedKlassPointers asserts with ObjectAlignmentInBytes=32
|
||||
* @library /testlibrary
|
||||
*/
|
||||
|
||||
import com.oracle.java.testlibrary.*;
|
||||
|
||||
public class CompressedKlassPointerAndOops {
|
||||
|
||||
public static void main(String[] args) throws Exception {
|
||||
|
||||
if (!Platform.is64bit()) {
|
||||
// Can't test this on 32 bit, just pass
|
||||
System.out.println("Skipping test on 32bit");
|
||||
return;
|
||||
}
|
||||
|
||||
runWithAlignment(16);
|
||||
runWithAlignment(32);
|
||||
runWithAlignment(64);
|
||||
runWithAlignment(128);
|
||||
}
|
||||
|
||||
private static void runWithAlignment(int alignment) throws Exception {
|
||||
ProcessBuilder pb;
|
||||
OutputAnalyzer output;
|
||||
|
||||
pb = ProcessTools.createJavaProcessBuilder(
|
||||
"-XX:+UseCompressedKlassPointers",
|
||||
"-XX:+UseCompressedOops",
|
||||
"-XX:ObjectAlignmentInBytes=" + alignment,
|
||||
"-version");
|
||||
|
||||
output = new OutputAnalyzer(pb.start());
|
||||
output.shouldHaveExitValue(0);
|
||||
}
|
||||
}
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -25,8 +25,9 @@
|
|||
/*
|
||||
* @test
|
||||
* @bug 7196045
|
||||
* @bug 8014294
|
||||
* @summary Possible JVM deadlock in ThreadTimesClosure when using HotspotInternal non-public API.
|
||||
* @run main/othervm -XX:+UsePerfData Test7196045
|
||||
* @run main/othervm -XX:+UsePerfData -Xmx32m ThreadCpuTimesDeadlock
|
||||
*/
|
||||
|
||||
import java.lang.management.ManagementFactory;
|
||||
|
@ -35,9 +36,10 @@ import javax.management.MBeanServer;
|
|||
import javax.management.MalformedObjectNameException;
|
||||
import javax.management.ObjectName;
|
||||
|
||||
public class Test7196045 {
|
||||
public class ThreadCpuTimesDeadlock {
|
||||
|
||||
public static long duration = 1000 * 60 * 2;
|
||||
public static byte[] dummy;
|
||||
public static long duration = 10 * 1000;
|
||||
private static final String HOTSPOT_INTERNAL = "sun.management:type=HotspotInternal";
|
||||
|
||||
public static void main(String[] args) {
|
||||
|
@ -57,6 +59,18 @@ public class Test7196045 {
|
|||
throw new RuntimeException("Bad object name" + e1);
|
||||
}
|
||||
|
||||
// Thread that allocs memory to generate GC's
|
||||
Thread allocThread = new Thread() {
|
||||
public void run() {
|
||||
while (true) {
|
||||
dummy = new byte[4096];
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
allocThread.setDaemon(true);
|
||||
allocThread.start();
|
||||
|
||||
long endTime = System.currentTimeMillis() + duration;
|
||||
long i = 0;
|
||||
while (true) {
|
124
hotspot/test/testlibrary/OutputAnalyzerReportingTest.java
Normal file
124
hotspot/test/testlibrary/OutputAnalyzerReportingTest.java
Normal file
|
@ -0,0 +1,124 @@
|
|||
/*
|
||||
* Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU General Public License version 2 only, as
|
||||
* published by the Free Software Foundation.
|
||||
*
|
||||
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||
* version 2 for more details (a copy is included in the LICENSE file that
|
||||
* accompanied this code).
|
||||
*
|
||||
* You should have received a copy of the GNU General Public License version
|
||||
* 2 along with this work; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
*
|
||||
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||||
* or visit www.oracle.com if you need additional information or have any
|
||||
* questions.
|
||||
*/
|
||||
|
||||
|
||||
/*
|
||||
* @test
|
||||
* @summary Test the OutputAnalyzer reporting functionality,
|
||||
* such as printing additional diagnostic info
|
||||
* (exit code, stdout, stderr, command line, etc.)
|
||||
* @library /testlibrary
|
||||
*/
|
||||
|
||||
import java.io.ByteArrayOutputStream;
|
||||
import java.io.PrintStream;
|
||||
|
||||
import com.oracle.java.testlibrary.OutputAnalyzer;
|
||||
import com.oracle.java.testlibrary.ProcessTools;
|
||||
|
||||
|
||||
public class OutputAnalyzerReportingTest {
|
||||
|
||||
public static void main(String[] args) throws Exception {
|
||||
// Create the output analyzer under test
|
||||
String stdout = "aaaaaa";
|
||||
String stderr = "bbbbbb";
|
||||
OutputAnalyzer output = new OutputAnalyzer(stdout, stderr);
|
||||
|
||||
// Expected summary values should be the same for all cases,
|
||||
// since the outputAnalyzer object is the same
|
||||
String expectedExitValue = "-1";
|
||||
String expectedSummary =
|
||||
" stdout: [" + stdout + "];\n" +
|
||||
" stderr: [" + stderr + "]\n" +
|
||||
" exitValue = " + expectedExitValue + "\n";
|
||||
|
||||
|
||||
DiagnosticSummaryTestRunner testRunner =
|
||||
new DiagnosticSummaryTestRunner();
|
||||
|
||||
// should have exit value
|
||||
testRunner.init(expectedSummary);
|
||||
int unexpectedExitValue = 2;
|
||||
try {
|
||||
output.shouldHaveExitValue(unexpectedExitValue);
|
||||
} catch (RuntimeException e) { }
|
||||
testRunner.closeAndCheckResults();
|
||||
|
||||
// should not contain
|
||||
testRunner.init(expectedSummary);
|
||||
try {
|
||||
output.shouldNotContain(stdout);
|
||||
} catch (RuntimeException e) { }
|
||||
testRunner.closeAndCheckResults();
|
||||
|
||||
// should contain
|
||||
testRunner.init(expectedSummary);
|
||||
try {
|
||||
output.shouldContain("unexpected-stuff");
|
||||
} catch (RuntimeException e) { }
|
||||
testRunner.closeAndCheckResults();
|
||||
|
||||
// should not match
|
||||
testRunner.init(expectedSummary);
|
||||
try {
|
||||
output.shouldNotMatch("[a]");
|
||||
} catch (RuntimeException e) { }
|
||||
testRunner.closeAndCheckResults();
|
||||
|
||||
// should match
|
||||
testRunner.init(expectedSummary);
|
||||
try {
|
||||
output.shouldMatch("[qwerty]");
|
||||
} catch (RuntimeException e) { }
|
||||
testRunner.closeAndCheckResults();
|
||||
|
||||
}
|
||||
|
||||
private static class DiagnosticSummaryTestRunner {
|
||||
private ByteArrayOutputStream byteStream =
|
||||
new ByteArrayOutputStream(10000);
|
||||
|
||||
private String expectedSummary = "";
|
||||
private PrintStream errStream;
|
||||
|
||||
|
||||
public void init(String expectedSummary) {
|
||||
this.expectedSummary = expectedSummary;
|
||||
byteStream.reset();
|
||||
errStream = new PrintStream(byteStream);
|
||||
System.setErr(errStream);
|
||||
}
|
||||
|
||||
public void closeAndCheckResults() {
|
||||
// check results
|
||||
errStream.close();
|
||||
String stdErrStr = byteStream.toString();
|
||||
if (!stdErrStr.contains(expectedSummary)) {
|
||||
throw new RuntimeException("The output does not contain "
|
||||
+ "the diagnostic message, or the message is incorrect");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
}
|
|
@ -76,7 +76,8 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void shouldContain(String expectedString) {
|
||||
if (!stdout.contains(expectedString) && !stderr.contains(expectedString)) {
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stdout/stderr: [" + stdout + stderr + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stdout/stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -88,7 +89,8 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void stdoutShouldContain(String expectedString) {
|
||||
if (!stdout.contains(expectedString)) {
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stdout: [" + stdout + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stdout \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -100,7 +102,8 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void stderrShouldContain(String expectedString) {
|
||||
if (!stderr.contains(expectedString)) {
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stderr: [" + stderr + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + expectedString + "' missing from stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -112,10 +115,12 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void shouldNotContain(String notExpectedString) {
|
||||
if (stdout.contains(notExpectedString)) {
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stdout: [" + stdout + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stdout \n");
|
||||
}
|
||||
if (stderr.contains(notExpectedString)) {
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stderr: [" + stderr + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -127,7 +132,8 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void stdoutShouldNotContain(String notExpectedString) {
|
||||
if (stdout.contains(notExpectedString)) {
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stdout: [" + stdout + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stdout \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -139,7 +145,8 @@ public final class OutputAnalyzer {
|
|||
*/
|
||||
public void stderrShouldNotContain(String notExpectedString) {
|
||||
if (stderr.contains(notExpectedString)) {
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stderr: [" + stderr + "]\n");
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + notExpectedString + "' found in stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -154,9 +161,9 @@ public final class OutputAnalyzer {
|
|||
Matcher stdoutMatcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stdout);
|
||||
Matcher stderrMatcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stderr);
|
||||
if (!stdoutMatcher.find() && !stderrMatcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' missing from stdout/stderr: [" + stdout + stderr
|
||||
+ "]\n");
|
||||
+ "' missing from stdout/stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -170,8 +177,9 @@ public final class OutputAnalyzer {
|
|||
public void stdoutShouldMatch(String pattern) {
|
||||
Matcher matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stdout);
|
||||
if (!matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' missing from stdout: [" + stdout + "]\n");
|
||||
+ "' missing from stdout \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -185,8 +193,9 @@ public final class OutputAnalyzer {
|
|||
public void stderrShouldMatch(String pattern) {
|
||||
Matcher matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stderr);
|
||||
if (!matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' missing from stderr: [" + stderr + "]\n");
|
||||
+ "' missing from stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -200,13 +209,15 @@ public final class OutputAnalyzer {
|
|||
public void shouldNotMatch(String pattern) {
|
||||
Matcher matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stdout);
|
||||
if (matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' found in stdout: [" + stdout + "]\n");
|
||||
+ "' found in stdout \n");
|
||||
}
|
||||
matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stderr);
|
||||
if (matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' found in stderr: [" + stderr + "]\n");
|
||||
+ "' found in stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -220,8 +231,9 @@ public final class OutputAnalyzer {
|
|||
public void stdoutShouldNotMatch(String pattern) {
|
||||
Matcher matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stdout);
|
||||
if (matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' found in stdout: [" + stdout + "]\n");
|
||||
+ "' found in stdout \n");
|
||||
}
|
||||
}
|
||||
|
||||
|
@ -235,23 +247,45 @@ public final class OutputAnalyzer {
|
|||
public void stderrShouldNotMatch(String pattern) {
|
||||
Matcher matcher = Pattern.compile(pattern, Pattern.MULTILINE).matcher(stderr);
|
||||
if (matcher.find()) {
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("'" + pattern
|
||||
+ "' found in stderr: [" + stderr + "]\n");
|
||||
+ "' found in stderr \n");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Verifiy the exit value of the process
|
||||
* Verify the exit value of the process
|
||||
*
|
||||
* @param expectedExitValue Expected exit value from process
|
||||
* @throws RuntimeException If the exit value from the process did not match the expected value
|
||||
*/
|
||||
public void shouldHaveExitValue(int expectedExitValue) {
|
||||
if (getExitValue() != expectedExitValue) {
|
||||
throw new RuntimeException("Exit value " + getExitValue() + " , expected to get " + expectedExitValue);
|
||||
reportDiagnosticSummary();
|
||||
throw new RuntimeException("Expected to get exit value of ["
|
||||
+ expectedExitValue + "]\n");
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Report summary that will help to diagnose the problem
|
||||
* Currently includes:
|
||||
* - standard input produced by the process under test
|
||||
* - standard output
|
||||
* - exit code
|
||||
* Note: the command line is printed by the ProcessTools
|
||||
*/
|
||||
private void reportDiagnosticSummary() {
|
||||
String msg =
|
||||
" stdout: [" + stdout + "];\n" +
|
||||
" stderr: [" + stderr + "]\n" +
|
||||
" exitValue = " + getExitValue() + "\n";
|
||||
|
||||
System.err.println(msg);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Get the contents of the output buffer (stdout and stderr)
|
||||
*
|
||||
|
|
|
@ -27,6 +27,7 @@ public class Platform {
|
|||
private static final String osName = System.getProperty("os.name");
|
||||
private static final String dataModel = System.getProperty("sun.arch.data.model");
|
||||
private static final String vmVersion = System.getProperty("java.vm.version");
|
||||
private static final String osArch = System.getProperty("os.arch");
|
||||
|
||||
public static boolean is64bit() {
|
||||
return dataModel.equals("64");
|
||||
|
@ -59,4 +60,14 @@ public class Platform {
|
|||
public static String getVMVersion() {
|
||||
return vmVersion;
|
||||
}
|
||||
|
||||
// Returns true for sparc and sparcv9.
|
||||
public static boolean isSparc() {
|
||||
return osArch.toLowerCase().startsWith("sparc");
|
||||
}
|
||||
|
||||
public static String getOsArch() {
|
||||
return osArch;
|
||||
}
|
||||
|
||||
}
|
||||
|
|
|
@ -31,6 +31,7 @@ import java.lang.reflect.Field;
|
|||
import java.lang.reflect.Method;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.List;
|
||||
|
||||
import sun.management.VMManagement;
|
||||
|
||||
|
@ -106,6 +107,22 @@ public final class ProcessTools {
|
|||
return pid;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the string containing input arguments passed to the VM
|
||||
*
|
||||
* @return arguments
|
||||
*/
|
||||
public static String getVmInputArguments() {
|
||||
RuntimeMXBean runtime = ManagementFactory.getRuntimeMXBean();
|
||||
|
||||
List<String> args = runtime.getInputArguments();
|
||||
StringBuilder result = new StringBuilder();
|
||||
for (String arg : args)
|
||||
result.append(arg).append(' ');
|
||||
|
||||
return result.toString();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get platform specific VM arguments (e.g. -d64 on 64bit Solaris)
|
||||
*
|
||||
|
@ -132,8 +149,13 @@ public final class ProcessTools {
|
|||
Collections.addAll(args, getPlatformSpecificVMArgs());
|
||||
Collections.addAll(args, command);
|
||||
|
||||
return new ProcessBuilder(args.toArray(new String[args.size()]));
|
||||
// Reporting
|
||||
StringBuilder cmdLine = new StringBuilder();
|
||||
for (String cmd : args)
|
||||
cmdLine.append(cmd).append(' ');
|
||||
System.out.println("Command line: [" + cmdLine.toString() + "]");
|
||||
|
||||
return new ProcessBuilder(args.toArray(new String[args.size()]));
|
||||
}
|
||||
|
||||
}
|
||||
|
|
|
@ -223,3 +223,4 @@ b8c5f4b6f0fffb44618fc609a584953c4ed67c0b jdk8-b95
|
|||
adf49c3ef83c160d53ece623049b2cdccaf78fc7 jdk8-b99
|
||||
5d1974c1d7b9a86431bc253dc5a6a52d4586622e jdk8-b100
|
||||
0a7432f898e579ea35e8c51e3edab37f949168e4 jdk8-b101
|
||||
7cffafa606e9fb865e7b5e6a56e0a681ce5cf617 jdk8-b102
|
||||
|
|
|
@ -223,3 +223,4 @@ b1fb4612a2caea52b5661b87509e560fa044b194 jdk8-b98
|
|||
8ef83d4b23c933935e28f59b282cea920b1b1f5f jdk8-b99
|
||||
4fd722afae5c02f00bbd44c3a34425ee474afb1c jdk8-b100
|
||||
60b623a361642a0f5aef5f06dad9e5f279b9d9a9 jdk8-b101
|
||||
988a5f2ac559dcab05698b8a8633aa453e012260 jdk8-b102
|
||||
|
|
|
@ -223,3 +223,4 @@ c4908732fef5235f1b98cafe0ce507771ef7892c jdk8-b98
|
|||
6a099a36589bd933957272ba63e5263bede29971 jdk8-b99
|
||||
5be9c5bfcfe9b2a40412b4fb364377d49de014eb jdk8-b100
|
||||
6901612328239fbd471d20823113c1cf3fdaebee jdk8-b101
|
||||
8ed8e2b4b90e0ac9aa5b3efef51cd576a9db96a9 jdk8-b102
|
||||
|
|
|
@ -798,6 +798,16 @@ ifeq ($(OPENJDK_TARGET_OS),solaris)
|
|||
LIBAWT_XAWT_CFLAGS += -DFUNCPROTO=15
|
||||
endif
|
||||
|
||||
ifeq ($(OPENJDK_TARGET_OS),linux)
|
||||
ifndef OPENJDK
|
||||
include $(JDK_TOPDIR)/make/closed/xawt.gmk
|
||||
endif
|
||||
|
||||
ifeq ($(DISABLE_XRENDER),true)
|
||||
LIBAWT_XAWT_CFLAGS += -DDISABLE_XRENDER_BY_DEFAULT=true
|
||||
endif
|
||||
endif
|
||||
|
||||
ifeq ($(MILESTONE),internal)
|
||||
LIBAWT_XAWT_CFLAGS += -DINTERNAL_BUILD
|
||||
endif
|
||||
|
|
|
@ -1856,7 +1856,10 @@ public class AquaTabbedPaneCopyFromBasicUI extends TabbedPaneUI implements Swing
|
|||
// If we're not valid that means we will shortly be validated and
|
||||
// painted, which means we don't have to do anything here.
|
||||
if (!isRunsDirty && index >= 0 && index < tabPane.getTabCount()) {
|
||||
tabPane.repaint(getTabBounds(tabPane, index));
|
||||
Rectangle rect = getTabBounds(tabPane, index);
|
||||
if (rect != null) {
|
||||
tabPane.repaint(rect);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
|
|
@ -701,6 +701,20 @@ public class AquaTabbedPaneUI extends AquaTabbedPaneCopyFromBasicUI {
|
|||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the bounds of the specified tab index. The bounds are
|
||||
* with respect to the JTabbedPane's coordinate space. If the tab at this
|
||||
* index is not currently visible in the UI, then returns null.
|
||||
*/
|
||||
@Override
|
||||
public Rectangle getTabBounds(final JTabbedPane pane, final int i) {
|
||||
if (visibleTabState.needsScrollTabs()
|
||||
&& (visibleTabState.isBefore(i) || visibleTabState.isAfter(i))) {
|
||||
return null;
|
||||
}
|
||||
return super.getTabBounds(pane, i);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the tab index which intersects the specified point
|
||||
* in the JTabbedPane's coordinate space.
|
||||
|
|
|
@ -830,18 +830,19 @@ public class CPlatformWindow extends CFRetainedResource implements PlatformWindo
|
|||
// UTILITY METHODS
|
||||
// ----------------------------------------------------------------------
|
||||
|
||||
/*
|
||||
* Find image to install into Title or into Application icon.
|
||||
* First try icons installed for toplevel. If there is no icon
|
||||
* use default Duke image.
|
||||
* This method shouldn't return null.
|
||||
/**
|
||||
* Find image to install into Title or into Application icon. First try
|
||||
* icons installed for toplevel. Null is returned, if there is no icon and
|
||||
* default Duke image should be used.
|
||||
*/
|
||||
private CImage getImageForTarget() {
|
||||
List<Image> icons = target.getIconImages();
|
||||
if (icons == null || icons.size() == 0) {
|
||||
return null;
|
||||
CImage icon = null;
|
||||
try {
|
||||
icon = CImage.getCreator().createFromImages(target.getIconImages());
|
||||
} catch (Exception ignored) {
|
||||
// Perhaps the icon passed into Java is broken. Skipping this icon.
|
||||
}
|
||||
return CImage.getCreator().createFromImages(icons);
|
||||
return icon;
|
||||
}
|
||||
|
||||
/*
|
||||
|
|
|
@ -42,7 +42,7 @@ import java.util.EventListener;
|
|||
* Container events are provided for notification purposes ONLY;
|
||||
* The AWT will automatically handle add and remove operations
|
||||
* internally so the program works properly regardless of
|
||||
* whether the program registers a <code>ComponentListener</code> or not.
|
||||
* whether the program registers a {@code ContainerListener} or not.
|
||||
*
|
||||
* @see ContainerAdapter
|
||||
* @see ContainerEvent
|
||||
|
|
|
@ -55,7 +55,7 @@ import java.awt.Image;
|
|||
* Alternatively, the contents of the back buffer can be copied, or
|
||||
* <i>blitted</i> forward in a chain instead of moving the video pointer.
|
||||
* <p>
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* Double buffering:
|
||||
*
|
||||
* *********** ***********
|
||||
|
@ -72,7 +72,7 @@ import java.awt.Image;
|
|||
* * * <------ * * <----- * *
|
||||
* *********** *********** ***********
|
||||
*
|
||||
* </pre>
|
||||
* }</pre>
|
||||
* <p>
|
||||
* Here is an example of how buffer strategies can be created and used:
|
||||
* <pre><code>
|
||||
|
|
|
@ -602,12 +602,12 @@ public class BufferedImage extends java.awt.Image
|
|||
* the raster has been premultiplied with alpha.
|
||||
* @param properties <code>Hashtable</code> of
|
||||
* <code>String</code>/<code>Object</code> pairs.
|
||||
* @exception <code>RasterFormatException</code> if the number and
|
||||
* @exception RasterFormatException if the number and
|
||||
* types of bands in the <code>SampleModel</code> of the
|
||||
* <code>Raster</code> do not match the number and types required by
|
||||
* the <code>ColorModel</code> to represent its color and alpha
|
||||
* components.
|
||||
* @exception <code>IllegalArgumentException</code> if
|
||||
* @exception IllegalArgumentException if
|
||||
* <code>raster</code> is incompatible with <code>cm</code>
|
||||
* @see ColorModel
|
||||
* @see Raster
|
||||
|
@ -927,7 +927,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* each color component in the returned data when
|
||||
* using this method. With a specified coordinate (x, y) in the
|
||||
* image, the ARGB pixel can be accessed in this way:
|
||||
* </p>
|
||||
* <p>
|
||||
*
|
||||
* <pre>
|
||||
* pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)]; </pre>
|
||||
|
@ -1131,7 +1131,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* @return an {@link Object} that is the property referred to by the
|
||||
* specified <code>name</code> or <code>null</code> if the
|
||||
* properties of this image are not yet known.
|
||||
* @throws <code>NullPointerException</code> if the property name is null.
|
||||
* @throws NullPointerException if the property name is null.
|
||||
* @see ImageObserver
|
||||
* @see java.awt.Image#UndefinedProperty
|
||||
*/
|
||||
|
@ -1144,7 +1144,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* @param name the property name
|
||||
* @return an <code>Object</code> that is the property referred to by
|
||||
* the specified <code>name</code>.
|
||||
* @throws <code>NullPointerException</code> if the property name is null.
|
||||
* @throws NullPointerException if the property name is null.
|
||||
*/
|
||||
public Object getProperty(String name) {
|
||||
if (name == null) {
|
||||
|
@ -1196,7 +1196,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* @param h the height of the specified rectangular region
|
||||
* @return a <code>BufferedImage</code> that is the subimage of this
|
||||
* <code>BufferedImage</code>.
|
||||
* @exception <code>RasterFormatException</code> if the specified
|
||||
* @exception RasterFormatException if the specified
|
||||
* area is not contained within this <code>BufferedImage</code>.
|
||||
*/
|
||||
public BufferedImage getSubimage (int x, int y, int w, int h) {
|
||||
|
@ -1388,7 +1388,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* @param tileY the y index of the requested tile in the tile array
|
||||
* @return a <code>Raster</code> that is the tile defined by the
|
||||
* arguments <code>tileX</code> and <code>tileY</code>.
|
||||
* @exception <code>ArrayIndexOutOfBoundsException</code> if both
|
||||
* @exception ArrayIndexOutOfBoundsException if both
|
||||
* <code>tileX</code> and <code>tileY</code> are not
|
||||
* equal to 0
|
||||
*/
|
||||
|
@ -1558,7 +1558,7 @@ public class BufferedImage extends java.awt.Image
|
|||
* @return <code>true</code> if the tile specified by the specified
|
||||
* indices is checked out for writing; <code>false</code>
|
||||
* otherwise.
|
||||
* @exception <code>ArrayIndexOutOfBoundsException</code> if both
|
||||
* @exception ArrayIndexOutOfBoundsException if both
|
||||
* <code>tileX</code> and <code>tileY</code> are not equal
|
||||
* to 0
|
||||
*/
|
||||
|
|
|
@ -171,7 +171,7 @@ public class ByteLookupTable extends LookupTable {
|
|||
* @exception ArrayIndexOutOfBoundsException if <code>src</code> is
|
||||
* longer than <code>dst</code> or if for any element
|
||||
* <code>i</code> of <code>src</code>,
|
||||
* <code>(src[i]&0xff)-offset</code> is either less than
|
||||
* {@code (src[i]&0xff)-offset} is either less than
|
||||
* zero or greater than or equal to the length of the
|
||||
* lookup table for any band.
|
||||
*/
|
||||
|
|
|
@ -692,12 +692,12 @@ public abstract class ColorModel implements Transparency{
|
|||
* <code>DataBuffer.TYPE_INT</code>.
|
||||
* @param inData an array of pixel values
|
||||
* @return the value of the green component of the specified pixel.
|
||||
* @throws <code>ClassCastException</code> if <code>inData</code>
|
||||
* @throws ClassCastException if <code>inData</code>
|
||||
* is not a primitive array of type <code>transferType</code>
|
||||
* @throws <code>ArrayIndexOutOfBoundsException</code> if
|
||||
* @throws ArrayIndexOutOfBoundsException if
|
||||
* <code>inData</code> is not large enough to hold a pixel value
|
||||
* for this <code>ColorModel</code>
|
||||
* @throws <code>UnsupportedOperationException</code> if this
|
||||
* @throws UnsupportedOperationException if this
|
||||
* <code>tranferType</code> is not supported by this
|
||||
* <code>ColorModel</code>
|
||||
*/
|
||||
|
|
|
@ -642,12 +642,12 @@ public class DirectColorModel extends PackedColorModel {
|
|||
* @param inData the specified pixel
|
||||
* @return the alpha component of the specified pixel, scaled from
|
||||
* 0 to 255.
|
||||
* @exception <code>ClassCastException</code> if <code>inData</code>
|
||||
* @exception ClassCastException if <code>inData</code>
|
||||
* is not a primitive array of type <code>transferType</code>
|
||||
* @exception <code>ArrayIndexOutOfBoundsException</code> if
|
||||
* @exception ArrayIndexOutOfBoundsException if
|
||||
* <code>inData</code> is not large enough to hold a pixel value
|
||||
* for this <code>ColorModel</code>
|
||||
* @exception <code>UnsupportedOperationException</code> if this
|
||||
* @exception UnsupportedOperationException if this
|
||||
* <code>tranferType</code> is not supported by this
|
||||
* <code>ColorModel</code>
|
||||
*/
|
||||
|
@ -1055,7 +1055,7 @@ public class DirectColorModel extends PackedColorModel {
|
|||
* begin retrieving the color and alpha components
|
||||
* @return an <code>int</code> pixel value in this
|
||||
* <code>ColorModel</code> corresponding to the specified components.
|
||||
* @exception <code>ArrayIndexOutOfBoundsException</code> if
|
||||
* @exception ArrayIndexOutOfBoundsException if
|
||||
* the <code>components</code> array is not large enough to
|
||||
* hold all of the color and alpha components starting at
|
||||
* <code>offset</code>
|
||||
|
@ -1097,9 +1097,9 @@ public class DirectColorModel extends PackedColorModel {
|
|||
* and alpha components
|
||||
* @return an <code>Object</code> representing an array of color and
|
||||
* alpha components.
|
||||
* @exception <code>ClassCastException</code> if <code>obj</code>
|
||||
* @exception ClassCastException if <code>obj</code>
|
||||
* is not a primitive array of type <code>transferType</code>
|
||||
* @exception <code>ArrayIndexOutOfBoundsException</code> if
|
||||
* @exception ArrayIndexOutOfBoundsException if
|
||||
* <code>obj</code> is not large enough to hold a pixel value
|
||||
* for this <code>ColorModel</code> or the <code>components</code>
|
||||
* array is not large enough to hold all of the color and alpha
|
||||
|
|
|
@ -100,11 +100,11 @@ public interface ImageProducer {
|
|||
* <code>ImageProducer</code> should respond by executing
|
||||
* the following minimum set of <code>ImageConsumer</code>
|
||||
* method calls:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* ic.setHints(TOPDOWNLEFTRIGHT | < otherhints >);
|
||||
* ic.setPixels(...); // As many times as needed
|
||||
* ic.imageComplete();
|
||||
* </pre>
|
||||
* }</pre>
|
||||
* @param ic the specified <code>ImageConsumer</code>
|
||||
* @see ImageConsumer#setHints
|
||||
*/
|
||||
|
|
|
@ -98,6 +98,7 @@ import java.math.BigInteger;
|
|||
* Index values greater than or equal to the map size, but less than
|
||||
* 2<sup><em>n</em></sup>, are undefined and return 0 for all color and
|
||||
* alpha components.
|
||||
* </a>
|
||||
* <p>
|
||||
* For those methods that use a primitive array pixel representation of
|
||||
* type <code>transferType</code>, the array length is always one.
|
||||
|
|
|
@ -37,7 +37,7 @@ import java.util.Enumeration;
|
|||
* uses an array to produce pixel values for an Image. Here is an example
|
||||
* which calculates a 100x100 image representing a fade from black to blue
|
||||
* along the X axis and a fade from black to red along the Y axis:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
*
|
||||
* int w = 100;
|
||||
* int h = 100;
|
||||
|
@ -52,12 +52,12 @@ import java.util.Enumeration;
|
|||
* }
|
||||
* Image img = createImage(new MemoryImageSource(w, h, pix, 0, w));
|
||||
*
|
||||
* </pre>
|
||||
* }</pre>
|
||||
* The MemoryImageSource is also capable of managing a memory image which
|
||||
* varies over time to allow animation or custom rendering. Here is an
|
||||
* example showing how to set up the animation source and signal changes
|
||||
* in the data (adapted from the MemoryAnimationSourceDemo by Garth Dickie):
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
*
|
||||
* int pixels[];
|
||||
* MemoryImageSource source;
|
||||
|
@ -96,7 +96,7 @@ import java.util.Enumeration;
|
|||
* }
|
||||
* }
|
||||
*
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*
|
||||
* @see ImageProducer
|
||||
*
|
||||
|
|
|
@ -52,14 +52,14 @@ package java.awt.image;
|
|||
* <code>x, y</code> from <code>DataBuffer</code> <code>data</code>
|
||||
* and storing the pixel data in data elements of type
|
||||
* <code>dataType</code>:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* int dataElementSize = DataBuffer.getDataTypeSize(dataType);
|
||||
* int bitnum = dataBitOffset + x*pixelBitStride;
|
||||
* int element = data.getElem(y*scanlineStride + bitnum/dataElementSize);
|
||||
* int shift = dataElementSize - (bitnum & (dataElementSize-1))
|
||||
* - pixelBitStride;
|
||||
* int pixel = (element >> shift) & ((1 << pixelBitStride) - 1);
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*/
|
||||
|
||||
public class MultiPixelPackedSampleModel extends SampleModel
|
||||
|
|
|
@ -35,7 +35,7 @@ import java.awt.Image;
|
|||
* The PixelGrabber class implements an ImageConsumer which can be attached
|
||||
* to an Image or ImageProducer object to retrieve a subset of the pixels
|
||||
* in that image. Here is an example:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
*
|
||||
* public void handlesinglepixel(int x, int y, int pixel) {
|
||||
* int alpha = (pixel >> 24) & 0xff;
|
||||
|
@ -65,7 +65,7 @@ import java.awt.Image;
|
|||
* }
|
||||
* }
|
||||
*
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*
|
||||
* @see ColorModel#getRGBdefault
|
||||
*
|
||||
|
@ -165,8 +165,8 @@ public class PixelGrabber implements ImageConsumer {
|
|||
* accumulated in the default RGB ColorModel. If the forceRGB
|
||||
* parameter is true, then the pixels will be accumulated in the
|
||||
* default RGB ColorModel anyway. A buffer is allocated by the
|
||||
* PixelGrabber to hold the pixels in either case. If (w < 0) or
|
||||
* (h < 0), then they will default to the remaining width and
|
||||
* PixelGrabber to hold the pixels in either case. If {@code (w < 0)} or
|
||||
* {@code (h < 0)}, then they will default to the remaining width and
|
||||
* height of the source data when that information is delivered.
|
||||
* @param img the image to retrieve the image data from
|
||||
* @param x the x coordinate of the upper left corner of the rectangle
|
||||
|
@ -233,10 +233,10 @@ public class PixelGrabber implements ImageConsumer {
|
|||
* behaves in the following ways, depending on the value of
|
||||
* <code>ms</code>:
|
||||
* <ul>
|
||||
* <li> If <code>ms</code> == 0, waits until all pixels are delivered
|
||||
* <li> If <code>ms</code> > 0, waits until all pixels are delivered
|
||||
* <li> If {@code ms == 0}, waits until all pixels are delivered
|
||||
* <li> If {@code ms > 0}, waits until all pixels are delivered
|
||||
* as timeout expires.
|
||||
* <li> If <code>ms</code> < 0, returns <code>true</code> if all pixels
|
||||
* <li> If {@code ms < 0}, returns <code>true</code> if all pixels
|
||||
* are grabbed, <code>false</code> otherwise and does not wait.
|
||||
* </ul>
|
||||
* @param ms the number of milliseconds to wait for the image pixels
|
||||
|
|
|
@ -39,7 +39,7 @@ import java.awt.image.ColorModel;
|
|||
* The only method which needs to be defined to create a useable image
|
||||
* filter is the filterRGB method. Here is an example of a definition
|
||||
* of a filter which swaps the red and blue components of an image:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
*
|
||||
* class RedBlueSwapFilter extends RGBImageFilter {
|
||||
* public RedBlueSwapFilter() {
|
||||
|
@ -56,7 +56,7 @@ import java.awt.image.ColorModel;
|
|||
* }
|
||||
* }
|
||||
*
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*
|
||||
* @see FilteredImageSource
|
||||
* @see ImageFilter
|
||||
|
|
|
@ -114,7 +114,7 @@ public class ShortLookupTable extends LookupTable {
|
|||
* @exception ArrayIndexOutOfBoundsException if <code>src</code> is
|
||||
* longer than <code>dst</code> or if for any element
|
||||
* <code>i</code> of <code>src</code>,
|
||||
* <code>(src[i]&0xffff)-offset</code> is either less than
|
||||
* {@code (src[i]&0xffff)-offset} is either less than
|
||||
* zero or greater than or equal to the length of the
|
||||
* lookup table for any band.
|
||||
*/
|
||||
|
@ -165,7 +165,7 @@ public class ShortLookupTable extends LookupTable {
|
|||
* @exception ArrayIndexOutOfBoundsException if <code>src</code> is
|
||||
* longer than <code>dst</code> or if for any element
|
||||
* <code>i</code> of <code>src</code>,
|
||||
* <code>(src[i]&0xffff)-offset</code> is either less than
|
||||
* {@code (src[i]&0xffff)-offset} is either less than
|
||||
* zero or greater than or equal to the length of the
|
||||
* lookup table for any band.
|
||||
*/
|
||||
|
|
|
@ -57,10 +57,10 @@ import java.util.Arrays;
|
|||
* The following code illustrates extracting the bits of the sample
|
||||
* representing band <code>b</code> for pixel <code>x,y</code>
|
||||
* from DataBuffer <code>data</code>:
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* int sample = data.getElem(y * scanlineStride + x);
|
||||
* sample = (sample & bitMasks[b]) >>> bitOffsets[b];
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*/
|
||||
|
||||
public class SinglePixelPackedSampleModel extends SampleModel
|
||||
|
|
|
@ -372,13 +372,13 @@ public class WritableRaster extends Raster {
|
|||
* integral type and less than or equal to 32 bits in size, then calling
|
||||
* this method is equivalent to executing the following code for all
|
||||
* <code>x,y</code> addresses valid in both Rasters.
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* Raster srcRaster;
|
||||
* WritableRaster dstRaster;
|
||||
* for (int b = 0; b < srcRaster.getNumBands(); b++) {
|
||||
* dstRaster.setSample(x, y, b, srcRaster.getSample(x, y, b));
|
||||
* }
|
||||
* </pre>
|
||||
* }</pre>
|
||||
* Thus, when copying an integral type source to an integral type
|
||||
* destination, if the source sample size is greater than the destination
|
||||
* sample size for a particular band, the high order bits of the source
|
||||
|
|
|
@ -228,7 +228,7 @@ public final class ImageIO {
|
|||
* be used when creating <code>ImageInputStream</code>s and
|
||||
* <code>ImageOutputStream</code>s.
|
||||
*
|
||||
* <p> When reading from a standard <code>InputStream</code>>, it
|
||||
* <p> When reading from a standard <code>InputStream</code>, it
|
||||
* may be necessary to save previously read information in a cache
|
||||
* since the underlying stream does not allow data to be re-read.
|
||||
* Similarly, when writing to a standard
|
||||
|
|
|
@ -80,7 +80,7 @@ import java.awt.image.BufferedImage;
|
|||
*
|
||||
* <p> The resulting region is then subsampled according to the
|
||||
* factors given in {@link IIOParam#setSourceSubsampling
|
||||
* <code>IIOParam.setSourceSubsampling</code>}. The first pixel,
|
||||
* IIOParam.setSourceSubsampling}. The first pixel,
|
||||
* the number of pixels per row, and the number of rows all depend
|
||||
* on the subsampling settings.
|
||||
* Call the minimum X and Y coordinates of the resulting rectangle
|
||||
|
|
|
@ -230,8 +230,8 @@ public abstract class ImageReader {
|
|||
* increased as each image (or thumbnail, or image metadata) is
|
||||
* read. If <code>seekForwardOnly</code> is true, then a call to
|
||||
* <code>read(index)</code> will throw an
|
||||
* <code>IndexOutOfBoundsException</code> if <code>index <
|
||||
* this.minIndex</code>; otherwise, the value of
|
||||
* <code>IndexOutOfBoundsException</code> if {@code index < this.minIndex};
|
||||
* otherwise, the value of
|
||||
* <code>minIndex</code> will be set to <code>index</code>. If
|
||||
* <code>seekForwardOnly</code> is <code>false</code>, the value of
|
||||
* <code>minIndex</code> will remain 0 regardless of any read
|
||||
|
@ -328,8 +328,8 @@ public abstract class ImageReader {
|
|||
* increased as each image (or thumbnail, or image metadata) is
|
||||
* read. If <code>seekForwardOnly</code> is true, then a call to
|
||||
* <code>read(index)</code> will throw an
|
||||
* <code>IndexOutOfBoundsException</code> if <code>index <
|
||||
* this.minIndex</code>; otherwise, the value of
|
||||
* <code>IndexOutOfBoundsException</code> if {@code index < this.minIndex};
|
||||
* otherwise, the value of
|
||||
* <code>minIndex</code> will be set to <code>index</code>. If
|
||||
* <code>seekForwardOnly</code> is <code>false</code>, the value of
|
||||
* <code>minIndex</code> will remain 0 regardless of any read
|
||||
|
@ -600,8 +600,7 @@ public abstract class ImageReader {
|
|||
* <p> Note that formats that return <code>false</code> from
|
||||
* this method may nonetheless allow tiling (<i>e.g.</i> Restart
|
||||
* Markers in JPEG), and random access will likely be reasonably
|
||||
* efficient on tiles. See {@link #isImageTiled
|
||||
* <code>isImageTiled</code>}.
|
||||
* efficient on tiles. See {@link #isImageTiled isImageTiled}.
|
||||
*
|
||||
* <p> A reader for which all images are guaranteed to support
|
||||
* easy random access, or are guaranteed not to support easy
|
||||
|
@ -1212,11 +1211,10 @@ public abstract class ImageReader {
|
|||
|
||||
/**
|
||||
* Returns <code>true</code> if this plug-in supports reading
|
||||
* just a {@link java.awt.image.Raster <code>Raster</code>} of pixel data.
|
||||
* just a {@link java.awt.image.Raster Raster} of pixel data.
|
||||
* If this method returns <code>false</code>, calls to
|
||||
* {@link #readRaster <code>readRaster</code>} or {@link #readTileRaster
|
||||
* <code>readTileRaster</code>} will throw an
|
||||
* <code>UnsupportedOperationException</code>.
|
||||
* {@link #readRaster readRaster} or {@link #readTileRaster readTileRaster}
|
||||
* will throw an <code>UnsupportedOperationException</code>.
|
||||
*
|
||||
* <p> The default implementation returns <code>false</code>.
|
||||
*
|
||||
|
@ -1236,7 +1234,7 @@ public abstract class ImageReader {
|
|||
* application must determine how to interpret the pixel data by other
|
||||
* means. Any destination or image-type parameters in the supplied
|
||||
* <code>ImageReadParam</code> object are ignored, but all other
|
||||
* parameters are used exactly as in the {@link #read <code>read</code>}
|
||||
* parameters are used exactly as in the {@link #read read}
|
||||
* method, except that any destination offset is used as a logical rather
|
||||
* than a physical offset. The size of the returned <code>Raster</code>
|
||||
* will always be that of the source region clipped to the actual image.
|
||||
|
@ -1249,10 +1247,9 @@ public abstract class ImageReader {
|
|||
*
|
||||
* <p> Any registered <code>readUpdateListener</code>s are ignored, as
|
||||
* there is no <code>BufferedImage</code>, but all other listeners are
|
||||
* called exactly as they are for the {@link #read <code>read</code>}
|
||||
* method.
|
||||
* called exactly as they are for the {@link #read read} method.
|
||||
*
|
||||
* <p> If {@link #canReadRaster <code>canReadRaster()</code>} returns
|
||||
* <p> If {@link #canReadRaster canReadRaster()} returns
|
||||
* <code>false</code>, this method throws an
|
||||
* <code>UnsupportedOperationException</code>.
|
||||
*
|
||||
|
@ -1481,13 +1478,13 @@ public abstract class ImageReader {
|
|||
* The application must determine how to interpret the pixel data by other
|
||||
* means.
|
||||
*
|
||||
* <p> If {@link #canReadRaster <code>canReadRaster()</code>} returns
|
||||
* <p> If {@link #canReadRaster canReadRaster()} returns
|
||||
* <code>false</code>, this method throws an
|
||||
* <code>UnsupportedOperationException</code>.
|
||||
*
|
||||
* <p> The default implementation checks if reading
|
||||
* <code>Raster</code>s is supported, and if so calls {@link
|
||||
* #readRaster <code>readRaster(imageIndex, null)</code>} if
|
||||
* #readRaster readRaster(imageIndex, null)} if
|
||||
* <code>tileX</code> and <code>tileY</code> are 0, or throws an
|
||||
* <code>IllegalArgumentException</code> otherwise.
|
||||
*
|
||||
|
@ -1548,8 +1545,8 @@ public abstract class ImageReader {
|
|||
* source render size or any format-specific settings), they will
|
||||
* be ignored.
|
||||
*
|
||||
* <p> The default implementation just calls {@link #read
|
||||
* <code>read(imageIndex, param)</code>}.
|
||||
* <p> The default implementation just calls
|
||||
* {@link #read read(imageIndex, param)}.
|
||||
*
|
||||
* @param imageIndex the index of the image to be retrieved.
|
||||
* @param param an <code>ImageReadParam</code> used to control
|
||||
|
@ -2544,9 +2541,8 @@ public abstract class ImageReader {
|
|||
* the supplied <code>ImageReadParam</code>. The actual
|
||||
* subsampling factors, destination size, and destination offset
|
||||
* are <em>not</em> taken into consideration, thus further
|
||||
* clipping must take place. The {@link #computeRegions
|
||||
* <code>computeRegions</code>} method performs all necessary
|
||||
* clipping.
|
||||
* clipping must take place. The {@link #computeRegions computeRegions}
|
||||
* method performs all necessary clipping.
|
||||
*
|
||||
* @param param the <code>ImageReadParam</code> being used, or
|
||||
* <code>null</code>.
|
||||
|
@ -2601,7 +2597,7 @@ public abstract class ImageReader {
|
|||
* width or height of 0, an <code>IllegalArgumentException</code>
|
||||
* is thrown.
|
||||
*
|
||||
* <p> The {@link #getSourceRegion <code>getSourceRegion</code>}
|
||||
* <p> The {@link #getSourceRegion getSourceRegion>}
|
||||
* method may be used if only source clipping is desired.
|
||||
*
|
||||
* @param param an <code>ImageReadParam</code>, or <code>null</code>.
|
||||
|
|
|
@ -840,7 +840,7 @@ public class ImageTypeSpecifier {
|
|||
* not one of 1, 2, 4, 8, or 16.
|
||||
* @exception IllegalArgumentException if the
|
||||
* non-<code>null</code> LUT parameters do not have lengths of
|
||||
* exactly <code>1 << bits</code>.
|
||||
* exactly {@code 1 << bits}.
|
||||
* @exception IllegalArgumentException if <code>dataType</code> is
|
||||
* not one of <code>DataBuffer.TYPE_BYTE</code>,
|
||||
* <code>DataBuffer.TYPE_SHORT</code>,
|
||||
|
|
|
@ -49,7 +49,7 @@ import java.util.Locale;
|
|||
* and include additional pixels within the intersected bounds
|
||||
* according to the horizontal and vertical subsampling factors
|
||||
* specified by {@link IIOParam#setSourceSubsampling
|
||||
* <code>IIOParam.setSourceSubsampling</code>}.
|
||||
* IIOParam.setSourceSubsampling}.
|
||||
*
|
||||
* <p> Individual features such as tiling, progressive encoding, and
|
||||
* compression may be set in one of four modes.
|
||||
|
@ -462,9 +462,8 @@ public class ImageWriteParam extends IIOParam {
|
|||
* <code>IllegalStateException</code>.
|
||||
*
|
||||
* <li><code>MODE_EXPLICIT</code> - The image will be tiled
|
||||
* according to parameters given in the {@link #setTiling
|
||||
* <code>setTiling</code>} method. Any previously set tiling
|
||||
* parameters are discarded.
|
||||
* according to parameters given in the {@link #setTiling setTiling}
|
||||
* method. Any previously set tiling parameters are discarded.
|
||||
*
|
||||
* <li><code>MODE_COPY_FROM_METADATA</code> - The image will
|
||||
* conform to the metadata object passed in to a write.
|
||||
|
@ -1421,7 +1420,7 @@ public class ImageWriteParam extends IIOParam {
|
|||
* with <code>getCompressionQualityDescriptions</code> as part of a user
|
||||
* interface for setting or displaying the compression quality
|
||||
* level. See {@link #getCompressionQualityDescriptions
|
||||
* <code>getCompressionQualityDescriptions</code>} for more information.
|
||||
* getCompressionQualityDescriptions} for more information.
|
||||
*
|
||||
* <p> If no descriptions are available, <code>null</code> is
|
||||
* returned. If <code>null</code> is returned from
|
||||
|
|
|
@ -692,7 +692,7 @@ public abstract class ImageWriter implements ImageTranscoder {
|
|||
* output prior to the current seek position may be flushed, and
|
||||
* need not be readable or writable, unless the plug-in needs to
|
||||
* be able to patch up the header information when
|
||||
* <code>endWriteSequence</code> is called (<italic>e.g.</italic> TIFF).
|
||||
* <code>endWriteSequence</code> is called (<i>e.g.</i> TIFF).
|
||||
*
|
||||
* <p> If <code>canWriteSequence</code> returns <code>false</code>,
|
||||
* this method will throw an
|
||||
|
|
|
@ -729,6 +729,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat {
|
|||
* @param required <code>true</code> if an object value must be present.
|
||||
* @param defaultValue the default value for the
|
||||
* <code>Object</code> reference, or <code>null</code>.
|
||||
* @param <T> the type of the object.
|
||||
*
|
||||
* @exception IllegalArgumentException if <code>elementName</code>
|
||||
* is <code>null</code>, or is not a legal element name for this format.
|
||||
|
@ -765,6 +766,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat {
|
|||
* @param enumeratedValues a <code>List</code> of
|
||||
* <code>Object</code>s containing the legal values for the
|
||||
* object reference.
|
||||
* @param <T> the type of the object.
|
||||
*
|
||||
* @exception IllegalArgumentException if <code>elementName</code>
|
||||
* is <code>null</code>, or is not a legal element name for this format.
|
||||
|
@ -836,6 +838,7 @@ public abstract class IIOMetadataFormatImpl implements IIOMetadataFormat {
|
|||
* is inclusive.
|
||||
* @param maxInclusive <code>true</code> if <code>maxValue</code>
|
||||
* is inclusive.
|
||||
* @param <T> the type of the object.
|
||||
*
|
||||
* @exception IllegalArgumentException if <code>elementName</code>
|
||||
* is <code>null</code>, or is not a legal element name for this
|
||||
|
|
|
@ -56,9 +56,9 @@ import com.sun.imageio.plugins.bmp.BMPConstants;
|
|||
* <p><table border=1>
|
||||
* <caption><b>Compression Types</b></caption>
|
||||
* <tr><th>Type String</th> <th>Description</th> <th>Image Types</th></tr>
|
||||
* <tr><td>BI_RGB</td> <td>Uncompressed RLE</td> <td><= 8-bits/sample</td></tr>
|
||||
* <tr><td>BI_RLE8</td> <td>8-bit Run Length Encoding</td> <td><= 8-bits/sample</td></tr>
|
||||
* <tr><td>BI_RLE4</td> <td>4-bit Run Length Encoding</td> <td><= 4-bits/sample</td></tr>
|
||||
* <tr><td>BI_RGB</td> <td>Uncompressed RLE</td> <td>{@literal <= } 8-bits/sample</td></tr>
|
||||
* <tr><td>BI_RLE8</td> <td>8-bit Run Length Encoding</td> <td>{@literal <=} 8-bits/sample</td></tr>
|
||||
* <tr><td>BI_RLE4</td> <td>4-bit Run Length Encoding</td> <td>{@literal <=} 4-bits/sample</td></tr>
|
||||
* <tr><td>BI_BITFIELDS</td> <td>Packed data</td> <td> 16 or 32 bits/sample</td></tr>
|
||||
* </table>
|
||||
*/
|
||||
|
|
|
@ -46,16 +46,15 @@ import javax.imageio.ImageReadParam;
|
|||
* This class allows the tables to be specified directly from client
|
||||
* code. If no tables are specified either in the stream or in a
|
||||
* <code>JPEGImageReadParam</code>, then the stream is presumed to use
|
||||
* the "standard" visually lossless tables. See {@link JPEGQTable
|
||||
* <code>JPEGQTable</code>} and {@link JPEGHuffmanTable
|
||||
* <code>JPEGHuffmanTable</code>} for more information on the default
|
||||
* tables.
|
||||
* the "standard" visually lossless tables. See {@link JPEGQTable JPEGQTable}
|
||||
* and {@link JPEGHuffmanTable JPEGHuffmanTable} for more information
|
||||
* on the default tables.
|
||||
*
|
||||
* <p> The default <code>JPEGImageReadParam</code> returned by the
|
||||
* <code>getDefaultReadParam</code> method of the builtin JPEG reader
|
||||
* contains no tables. Default tables may be obtained from the table
|
||||
* classes {@link JPEGQTable <code>JPEGQTable</code>} and {@link
|
||||
* JPEGHuffmanTable <code>JPEGHuffmanTable</code>}.
|
||||
* classes {@link JPEGQTable JPEGQTable} and
|
||||
* {@link JPEGHuffmanTable JPEGHuffmanTable}.
|
||||
*
|
||||
* <p> If a stream does contain tables, the tables given in a
|
||||
* <code>JPEGImageReadParam</code> are ignored. Furthermore, if the
|
||||
|
@ -64,13 +63,12 @@ import javax.imageio.ImageReadParam;
|
|||
* abbreviated images. Once tables have been read from a stream, they
|
||||
* can be overridden only by tables subsequently read from the same
|
||||
* stream. In order to specify new tables, the {@link
|
||||
* javax.imageio.ImageReader#setInput <code>setInput</code>} method of
|
||||
* javax.imageio.ImageReader#setInput setInput} method of
|
||||
* the reader must be called to change the stream.
|
||||
*
|
||||
* <p> Note that this class does not provide a means for obtaining the
|
||||
* tables found in a stream. These may be extracted from a stream by
|
||||
* consulting the <code>IIOMetadata</code> object returned by the
|
||||
* reader.
|
||||
* consulting the IIOMetadata object returned by the reader.
|
||||
*
|
||||
* <p>
|
||||
* For more information about the operation of the built-in JPEG plug-ins,
|
||||
|
|
|
@ -66,8 +66,8 @@ import com.sun.imageio.plugins.jpeg.JPEG;
|
|||
* when an abbreviated stream must be written without writing any tables
|
||||
* to a stream first. In order to use this class, the metadata object
|
||||
* passed into the writer must contain no tables, and no stream metadata
|
||||
* must be provided. See {@link JPEGQTable <code>JPEGQTable</code>} and
|
||||
* {@link JPEGHuffmanTable <code>JPEGHuffmanTable</code>} for more
|
||||
* must be provided. See {@link JPEGQTable JPEGQTable} and
|
||||
* {@link JPEGHuffmanTable JPEGHuffmanTable} for more
|
||||
* information on the default tables.
|
||||
*
|
||||
* <p> The default <code>JPEGImageWriteParam</code> returned by the
|
||||
|
@ -80,7 +80,7 @@ import com.sun.imageio.plugins.jpeg.JPEG;
|
|||
* set of tables has been written, only tables in the metadata can
|
||||
* override them for subsequent writes, whether to the same stream or
|
||||
* a different one. In order to specify new tables using this class,
|
||||
* the {@link javax.imageio.ImageWriter#reset <code>reset</code>}
|
||||
* the {@link javax.imageio.ImageWriter#reset reset}
|
||||
* method of the writer must be called.
|
||||
*
|
||||
* <p>
|
||||
|
|
|
@ -78,7 +78,7 @@ public abstract class ImageReaderSpi extends ImageReaderWriterSpi {
|
|||
* <code>ImageInputStream.class</code>, to be returned from
|
||||
* <code>getInputTypes</code>.
|
||||
* @deprecated Instead of using this field, directly create
|
||||
* the equivalent array <code>{ ImageInputStream.class }<code>.
|
||||
* the equivalent array <code>{ ImageInputStream.class }</code>.
|
||||
*/
|
||||
@Deprecated
|
||||
public static final Class[] STANDARD_INPUT_TYPE =
|
||||
|
|
|
@ -80,7 +80,7 @@ public abstract class ImageWriterSpi extends ImageReaderWriterSpi {
|
|||
* <code>ImageOutputStream.class</code>, to be returned from
|
||||
* <code>getOutputTypes</code>.
|
||||
* @deprecated Instead of using this field, directly create
|
||||
* the equivalent array <code>{ ImageOutputStream.class }<code>.
|
||||
* the equivalent array <code>{ ImageOutputStream.class }</code>.
|
||||
*/
|
||||
@Deprecated
|
||||
public static final Class[] STANDARD_OUTPUT_TYPE =
|
||||
|
|
|
@ -157,6 +157,8 @@ public class ServiceRegistry {
|
|||
* or <code>null</code> if the system class loader (or, failing that
|
||||
* the bootstrap class loader) is to be used.
|
||||
*
|
||||
* @param <T> the type of the providerClass.
|
||||
*
|
||||
* @return An <code>Iterator</code> that yields provider objects
|
||||
* for the given service, in some arbitrary order. The iterator
|
||||
* will throw an <code>Error</code> if a provider-configuration
|
||||
|
@ -188,6 +190,8 @@ public class ServiceRegistry {
|
|||
* @param providerClass a <code>Class</code>object indicating the
|
||||
* class or interface of the service providers being detected.
|
||||
*
|
||||
* @param <T> the type of the providerClass.
|
||||
*
|
||||
* @return An <code>Iterator</code> that yields provider objects
|
||||
* for the given service, in some arbitrary order. The iterator
|
||||
* will throw an <code>Error</code> if a provider-configuration
|
||||
|
@ -247,6 +251,7 @@ public class ServiceRegistry {
|
|||
* @param provider the service provide object to be registered.
|
||||
* @param category the category under which to register the
|
||||
* provider.
|
||||
* @param <T> the type of the provider.
|
||||
*
|
||||
* @return true if no provider of the same class was previously
|
||||
* registered in the same category category.
|
||||
|
@ -348,6 +353,7 @@ public class ServiceRegistry {
|
|||
* @param provider the service provider object to be deregistered.
|
||||
* @param category the category from which to deregister the
|
||||
* provider.
|
||||
* @param <T> the type of the provider.
|
||||
*
|
||||
* @return <code>true</code> if the provider was previously
|
||||
* registered in the same category category,
|
||||
|
@ -435,6 +441,7 @@ public class ServiceRegistry {
|
|||
* @param category the category to be retrieved from.
|
||||
* @param useOrdering <code>true</code> if pairwise orderings
|
||||
* should be taken account in ordering the returned objects.
|
||||
* @param <T> the type of the category.
|
||||
*
|
||||
* @return an <code>Iterator</code> containing service provider
|
||||
* objects from the given category, possibly in order.
|
||||
|
@ -490,6 +497,7 @@ public class ServiceRegistry {
|
|||
* whose <code>filter</code> method will be invoked.
|
||||
* @param useOrdering <code>true</code> if pairwise orderings
|
||||
* should be taken account in ordering the returned objects.
|
||||
* @param <T> the type of the category.
|
||||
*
|
||||
* @return an <code>Iterator</code> containing service provider
|
||||
* objects from the given category, possibly in order.
|
||||
|
@ -517,6 +525,7 @@ public class ServiceRegistry {
|
|||
*
|
||||
* @param providerClass the <code>Class</code> of the desired
|
||||
* service provider object.
|
||||
* @param <T> the type of the provider.
|
||||
*
|
||||
* @return a currently registered service provider object with the
|
||||
* desired <code>Class</code>type, or <code>null</code> is none is
|
||||
|
@ -561,6 +570,7 @@ public class ServiceRegistry {
|
|||
* @param firstProvider the preferred provider.
|
||||
* @param secondProvider the provider to which
|
||||
* <code>firstProvider</code> is preferred.
|
||||
* @param <T> the type of the category.
|
||||
*
|
||||
* @return <code>true</code> if a previously unset ordering
|
||||
* was established.
|
||||
|
@ -606,6 +616,7 @@ public class ServiceRegistry {
|
|||
* @param firstProvider the formerly preferred provider.
|
||||
* @param secondProvider the provider to which
|
||||
* <code>firstProvider</code> was formerly preferred.
|
||||
* @param <T> the type of the category.
|
||||
*
|
||||
* @return <code>true</code> if a previously set ordering was
|
||||
* disestablished.
|
||||
|
|
|
@ -183,7 +183,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a boolean value from the stream.
|
||||
*
|
||||
* @exception EOFException if the end of the stream is reached.
|
||||
* @exception java.io.EOFException if the end of the stream is reached.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
boolean readBoolean() throws IOException;
|
||||
|
@ -201,7 +201,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a signed byte value from the stream.
|
||||
*
|
||||
* @exception EOFException if the end of the stream is reached.
|
||||
* @exception java.io.EOFException if the end of the stream is reached.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
byte readByte() throws IOException;
|
||||
|
@ -225,7 +225,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return an unsigned byte value from the stream.
|
||||
*
|
||||
* @exception EOFException if the end of the stream is reached.
|
||||
* @exception java.io.EOFException if the end of the stream is reached.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
int readUnsignedByte() throws IOException;
|
||||
|
@ -240,7 +240,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a signed short value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -261,7 +261,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return an unsigned short value from the stream, as an int.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -278,7 +278,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return an unsigned char value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -296,7 +296,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a signed int value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -316,7 +316,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return an unsigned int value from the stream, as a long.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -334,7 +334,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a signed long value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -352,7 +352,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a float value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -370,7 +370,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a double value from the stream.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*
|
||||
|
@ -469,7 +469,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* then a <code>UTFDataFormatException</code> is thrown.
|
||||
*
|
||||
* <p> If end of file is encountered at any time during this
|
||||
* entire process, then an <code>EOFException</code> is thrown.
|
||||
* entire process, then an <code>java.io.EOFException</code> is thrown.
|
||||
*
|
||||
* <p> After every group has been converted to a character by this
|
||||
* process, the characters are gathered, in the same order in
|
||||
|
@ -488,10 +488,10 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @return a String read from the stream.
|
||||
*
|
||||
* @exception EOFException if this stream reaches the end
|
||||
* @exception java.io.EOFException if this stream reaches the end
|
||||
* before reading all the bytes.
|
||||
* @exception UTFDataFormatException if the bytes do not represent a
|
||||
* valid modified UTF-8 encoding of a string.
|
||||
* @exception java.io.UTFDataFormatException if the bytes do not represent
|
||||
* a valid modified UTF-8 encoding of a string.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
String readUTF() throws IOException;
|
||||
|
@ -499,7 +499,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
/**
|
||||
* Reads <code>len</code> bytes from the stream, and stores them
|
||||
* into <code>b</code> starting at index <code>off</code>.
|
||||
* If the end of the stream is reached, an <code>EOFException</code>
|
||||
* If the end of the stream is reached, an <code>java.io.EOFException</code>
|
||||
* will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
|
@ -514,7 +514,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>b.length</code>.
|
||||
* @exception NullPointerException if <code>b</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -523,7 +523,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
/**
|
||||
* Reads <code>b.length</code> bytes from the stream, and stores them
|
||||
* into <code>b</code> starting at index <code>0</code>.
|
||||
* If the end of the stream is reached, an <code>EOFException</code>
|
||||
* If the end of the stream is reached, an <code>java.io.EOFException</code>
|
||||
* will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
|
@ -533,7 +533,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @exception NullPointerException if <code>b</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -544,7 +544,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* stream according to the current byte order, and
|
||||
* stores them into <code>s</code> starting at index
|
||||
* <code>off</code>. If the end of the stream is reached, an
|
||||
* <code>EOFException</code> will be thrown.
|
||||
* <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -558,7 +558,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>s.length</code>.
|
||||
* @exception NullPointerException if <code>s</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -569,7 +569,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* stream according to the current byte order, and
|
||||
* stores them into <code>c</code> starting at index
|
||||
* <code>off</code>. If the end of the stream is reached, an
|
||||
* <code>EOFException</code> will be thrown.
|
||||
* <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -583,7 +583,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>c.length</code>.
|
||||
* @exception NullPointerException if <code>c</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -594,7 +594,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* stream according to the current byte order, and
|
||||
* stores them into <code>i</code> starting at index
|
||||
* <code>off</code>. If the end of the stream is reached, an
|
||||
* <code>EOFException</code> will be thrown.
|
||||
* <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -608,7 +608,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>i.length</code>.
|
||||
* @exception NullPointerException if <code>i</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -619,7 +619,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* stream according to the current byte order, and
|
||||
* stores them into <code>l</code> starting at index
|
||||
* <code>off</code>. If the end of the stream is reached, an
|
||||
* <code>EOFException</code> will be thrown.
|
||||
* <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -633,7 +633,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>l.length</code>.
|
||||
* @exception NullPointerException if <code>l</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -644,7 +644,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* floats) from the stream according to the current byte order,
|
||||
* and stores them into <code>f</code> starting at
|
||||
* index <code>off</code>. If the end of the stream is reached,
|
||||
* an <code>EOFException</code> will be thrown.
|
||||
* an <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -658,7 +658,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>f.length</code>.
|
||||
* @exception NullPointerException if <code>f</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -669,7 +669,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* floats) from the stream according to the current byte order,
|
||||
* and stores them into <code>d</code> starting at
|
||||
* index <code>off</code>. If the end of the stream is reached,
|
||||
* an <code>EOFException</code> will be thrown.
|
||||
* an <code>java.io.EOFException</code> will be thrown.
|
||||
*
|
||||
* <p> The bit offset within the stream is reset to zero before
|
||||
* the read occurs.
|
||||
|
@ -683,7 +683,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* len</code> is greater than <code>d.length</code>.
|
||||
* @exception NullPointerException if <code>d</code> is
|
||||
* <code>null</code>.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -748,7 +748,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* @return an <code>int</code> containing the value <code>0</code>
|
||||
* or <code>1</code>.
|
||||
*
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bits.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -768,13 +768,13 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* the right side of the return value, as shown by the following
|
||||
* pseudo-code:
|
||||
*
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* long accum = 0L;
|
||||
* for (int i = 0; i < numBits; i++) {
|
||||
* accum <<= 1; // Shift left one bit to make room
|
||||
* accum |= readBit();
|
||||
* }
|
||||
* </pre>
|
||||
* }</pre>
|
||||
*
|
||||
* Note that the result of <code>readBits(32)</code> may thus not
|
||||
* be equal to that of <code>readInt()</code> if a reverse network
|
||||
|
@ -782,7 +782,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* false</code>).
|
||||
*
|
||||
* <p> If the end of the stream is encountered before all the bits
|
||||
* have been read, an <code>EOFException</code> is thrown.
|
||||
* have been read, an <code>java.io.EOFException</code> is thrown.
|
||||
*
|
||||
* @param numBits the number of bits to read, as an <code>int</code>
|
||||
* between 0 and 64, inclusive.
|
||||
|
@ -791,7 +791,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
*
|
||||
* @exception IllegalArgumentException if <code>numBits</code>
|
||||
* is not between 0 and 64, inclusive.
|
||||
* @exception EOFException if the stream reaches the end before
|
||||
* @exception java.io.EOFException if the stream reaches the end before
|
||||
* reading all the bits.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
@ -850,7 +850,7 @@ public interface ImageInputStream extends DataInput, Closeable {
|
|||
* returned by <code>getflushedPosition</code>).
|
||||
*
|
||||
* <p> It is legal to seek past the end of the file; an
|
||||
* <code>EOFException</code> will be thrown only if a read is
|
||||
* <code>java.io.EOFException</code> will be thrown only if a read is
|
||||
* performed.
|
||||
*
|
||||
* @param pos a <code>long</code> containing the desired file
|
||||
|
|
|
@ -88,7 +88,7 @@ public abstract class ImageInputStreamImpl implements ImageInputStream {
|
|||
/**
|
||||
* The position prior to which data may be discarded. Seeking
|
||||
* to a smaller position is not allowed. <code>flushedPos</code>
|
||||
* will always be >= 0.
|
||||
* will always be {@literal >= 0}.
|
||||
*/
|
||||
protected long flushedPos = 0;
|
||||
|
||||
|
|
|
@ -59,9 +59,9 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput {
|
|||
* remainder of the current byte is padded with 0s
|
||||
* and written out first. The bit offset will be 0 after the
|
||||
* write. Implementers can use the
|
||||
* {@link ImageOutputStreamImpl#flushBits <code>flushBits</code>}
|
||||
* method of {@link ImageOutputStreamImpl
|
||||
* <code>ImageOutputStreamImpl</code>} to guarantee this.
|
||||
* {@link ImageOutputStreamImpl#flushBits flushBits}
|
||||
* method of {@link ImageOutputStreamImpl ImageOutputStreamImpl}
|
||||
* to guarantee this.
|
||||
*
|
||||
* @param b an <code>int</code> whose lower 8 bits are to be
|
||||
* written.
|
||||
|
@ -99,9 +99,9 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput {
|
|||
* remainder of the current byte is padded with 0s
|
||||
* and written out first. The bit offset will be 0 after the
|
||||
* write. Implementers can use the
|
||||
* {@link ImageOutputStreamImpl#flushBits <code>flushBits</code>}
|
||||
* method of {@link ImageOutputStreamImpl
|
||||
* <code>ImageOutputStreamImpl</code>} to guarantee this.
|
||||
* {@link ImageOutputStreamImpl#flushBits flushBits}
|
||||
* method of {@link ImageOutputStreamImpl ImageOutputStreamImpl}
|
||||
* to guarantee this.
|
||||
*
|
||||
* @param b an array of <code>byte</code>s to be written.
|
||||
* @param off the start offset in the data.
|
||||
|
@ -182,8 +182,7 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput {
|
|||
void writeShort(int v) throws IOException;
|
||||
|
||||
/**
|
||||
* This method is a synonym for
|
||||
* {@link #writeShort <code>writeShort</code>}.
|
||||
* This method is a synonym for {@link #writeShort writeShort}.
|
||||
*
|
||||
* @param v an <code>int</code> containing the char (unsigned
|
||||
* short) value to be written.
|
||||
|
@ -430,7 +429,7 @@ public interface ImageOutputStream extends ImageInputStream, DataOutput {
|
|||
*
|
||||
* @exception NullPointerException if <code>s</code> is
|
||||
* <code>null</code>.
|
||||
* @exception UTFDataFormatException if the modified UTF-8
|
||||
* @exception java.io.UTFDataFormatException if the modified UTF-8
|
||||
* representation of <code>s</code> requires more than 65536 bytes.
|
||||
* @exception IOException if an I/O error occurs.
|
||||
*/
|
||||
|
|
|
@ -286,7 +286,7 @@ import java.io.Serializable;
|
|||
* "autosensing" works is implementation dependent. In general, preformatted
|
||||
* autosense print data is provided in a byte oriented representation class
|
||||
* (byte array, InputStream, URL).
|
||||
*
|
||||
* </UL>
|
||||
* <P>
|
||||
* <HR>
|
||||
* <H3>Service Formatted Print Data</H3>
|
||||
|
@ -545,7 +545,7 @@ public class DocFlavor implements Serializable, Cloneable {
|
|||
* the match.
|
||||
* @return String representing a mime parameter, or
|
||||
* null if that parameter is not in the mime type string.
|
||||
* @exception throws NullPointerException if paramName is null.
|
||||
* @exception NullPointerException if paramName is null.
|
||||
*/
|
||||
public String getParameter(String paramName) {
|
||||
return
|
||||
|
|
|
@ -47,7 +47,7 @@ public interface MultiDocPrintJob extends DocPrintJob {
|
|||
* PrintJobListener.
|
||||
*
|
||||
* @param multiDoc The documents to be printed. ALL must be a flavor
|
||||
* supported by the PrintJob & PrintService.
|
||||
* supported by the PrintJob {@literal &} PrintService.
|
||||
*
|
||||
* @param attributes The job attributes to be applied to this print job.
|
||||
* If this parameter is null then the default attributes are used.
|
||||
|
|
|
@ -40,7 +40,7 @@ import javax.print.event.PrintServiceAttributeListener;
|
|||
* a printer's supported attributes.
|
||||
* <P>
|
||||
* Example:
|
||||
* <PRE>
|
||||
* <PRE>{@code
|
||||
* DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
|
||||
* PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
|
||||
* aset.add(MediaSizeName.ISO_A4);
|
||||
|
@ -56,7 +56,7 @@ import javax.print.event.PrintServiceAttributeListener;
|
|||
* } catch (PrintException e) {
|
||||
* }
|
||||
* }
|
||||
* </PRE>
|
||||
* }</PRE>
|
||||
*/
|
||||
public interface PrintService {
|
||||
|
||||
|
|
|
@ -118,7 +118,7 @@ public class ServiceUI {
|
|||
* any changes made by the user.
|
||||
*
|
||||
* A typical basic usage of this method may be :
|
||||
* <pre>
|
||||
* <pre>{@code
|
||||
* PrintService[] services = PrintServiceLookup.lookupPrintServices(
|
||||
* DocFlavor.INPUT_STREAM.JPEG, null);
|
||||
* PrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet();
|
||||
|
@ -131,7 +131,7 @@ public class ServiceUI {
|
|||
* ... print ...
|
||||
* }
|
||||
* }
|
||||
* </pre>
|
||||
* }</pre>
|
||||
* <p>
|
||||
|
||||
* @param gc used to select screen. null means primary or default screen.
|
||||
|
|
|
@ -39,8 +39,8 @@ package javax.print;
|
|||
* initialize services only when needed without any API dependencies
|
||||
* except in an environment in which they are used.
|
||||
* <p>
|
||||
* Swing UIs are preferred as they provide a more consistent L&F and
|
||||
* can support accessibility APIs.
|
||||
* Swing UIs are preferred as they provide a more consistent {@literal L&F}
|
||||
* and can support accessibility APIs.
|
||||
* <p>
|
||||
* Example usage:
|
||||
* <pre>
|
||||
|
|
|
@ -42,7 +42,7 @@ package javax.print.attribute;
|
|||
* class rather than the attribute object's class itself. An attribute
|
||||
* object's
|
||||
* category is determined by calling the {@link Attribute#getCategory()
|
||||
* <CODE>getCategory()</CODE>} method defined in interface {@link Attribute
|
||||
* getCategory()} method defined in interface {@link Attribute
|
||||
* Attribute}.
|
||||
* <P>
|
||||
* The interfaces of an AttributeSet resemble those of the Java Collections
|
||||
|
@ -217,7 +217,7 @@ public interface AttributeSet {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the =
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with each
|
||||
* element from the specified set.
|
||||
* The behavior of the <CODE>addAll(AttributeSet)</CODE>
|
||||
|
@ -301,7 +301,7 @@ public interface AttributeSet {
|
|||
* This ensures that <tt>t1.equals(t2)</tt> implies that
|
||||
* <tt>t1.hashCode()==t2.hashCode()</tt> for any two attribute sets
|
||||
* <tt>t1</tt> and <tt>t2</tt>, as required by the general contract of
|
||||
* {@link java.lang.Object#hashCode() <CODE>Object.hashCode()</CODE>}.
|
||||
* {@link java.lang.Object#hashCode() Object.hashCode()}.
|
||||
*
|
||||
* @return The hash code value for this attribute set.
|
||||
*/
|
||||
|
|
|
@ -36,9 +36,9 @@ import java.util.Date;
|
|||
* <P>
|
||||
* Under the hood, a date-time attribute is stored as a value of class <code>
|
||||
* java.util.Date</code>. You can get a date-time attribute's Date value by
|
||||
* calling {@link #getValue() <CODE>getValue()</CODE>}. A date-time attribute's
|
||||
* calling {@link #getValue() getValue()}. A date-time attribute's
|
||||
* Date value is established when it is constructed (see {@link
|
||||
* #DateTimeSyntax(Date) <CODE>DateTimeSyntax(Date)</CODE>}). Once
|
||||
* #DateTimeSyntax(Date) DateTimeSyntax(Date)}). Once
|
||||
* constructed, a date-time attribute's value is immutable.
|
||||
* <P>
|
||||
* To construct a date-time attribute from separate values of the year, month,
|
||||
|
|
|
@ -37,8 +37,8 @@ package javax.print.attribute;
|
|||
* constructors and mutating operations guarantee an additional invariant,
|
||||
* namely that all attribute values in the DocAttributeSet must be instances
|
||||
* of interface {@link DocAttribute DocAttribute}.
|
||||
* The {@link #add(Attribute) <CODE>add(Attribute)</CODE>}, and
|
||||
* {@link #addAll(AttributeSet) <CODE>addAll(AttributeSet)</CODE>} operations
|
||||
* The {@link #add(Attribute) add(Attribute)}, and
|
||||
* {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
|
||||
* are respecified below to guarantee this additional invariant.
|
||||
* <P>
|
||||
*
|
||||
|
@ -74,7 +74,7 @@ public interface DocAttributeSet extends AttributeSet {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with
|
||||
* each element from the specified set. If none of the categories in the
|
||||
* specified set are the same as any categories in this attribute set,
|
||||
|
|
|
@ -81,15 +81,15 @@ import java.io.Serializable;
|
|||
* for identical objects (<CODE>==</CODE>).
|
||||
* <P>
|
||||
* You can convert an enumeration value to a string by calling {@link
|
||||
* #toString() <CODE>toString()</CODE>}. The string is obtained from a table
|
||||
* #toString() toString()}. The string is obtained from a table
|
||||
* supplied by the enumeration class.
|
||||
* <P>
|
||||
* Under the hood, an enumeration value is just an integer, a different integer
|
||||
* for each enumeration value within an enumeration class. You can get an
|
||||
* enumeration value's integer value by calling {@link #getValue()
|
||||
* <CODE>getValue()</CODE>}. An enumeration value's integer value is established
|
||||
* getValue()}. An enumeration value's integer value is established
|
||||
* when it is constructed (see {@link #EnumSyntax(int)
|
||||
* <CODE>EnumSyntax(int)</CODE>}). Since the constructor is protected, the only
|
||||
* EnumSyntax(int)}). Since the constructor is protected, the only
|
||||
* possible enumeration values are the singleton objects declared in the
|
||||
* enumeration class; additional enumeration values cannot be created at run
|
||||
* time.
|
||||
|
@ -170,10 +170,10 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
|
|||
*
|
||||
* @return The enumeration singleton value stored at index
|
||||
* <I>i</I>-<I>L</I> in the enumeration value table returned by
|
||||
* {@link #getEnumValueTable() <CODE>getEnumValueTable()</CODE>},
|
||||
* {@link #getEnumValueTable() getEnumValueTable()},
|
||||
* where <I>i</I> is this enumeration value's integer value and
|
||||
* <I>L</I> is the value returned by {@link #getOffset()
|
||||
* <CODE>getOffset()</CODE>}.
|
||||
* getOffset()}.
|
||||
*
|
||||
* @throws ObjectStreamException if the stream can't be deserialised
|
||||
* @throws InvalidObjectException
|
||||
|
@ -220,18 +220,18 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
|
|||
* Returns the string table for this enumeration value's enumeration class.
|
||||
* The enumeration class's integer values are assumed to lie in the range
|
||||
* <I>L</I>..<I>L</I>+<I>N</I>-1, where <I>L</I> is the value returned by
|
||||
* {@link #getOffset() <CODE>getOffset()</CODE>} and <I>N</I> is the length
|
||||
* {@link #getOffset() getOffset()} and <I>N</I> is the length
|
||||
* of the string table. The element in the string table at index
|
||||
* <I>i</I>-<I>L</I> is the value returned by {@link #toString()
|
||||
* <CODE>toString()</CODE>} for the enumeration value whose integer value
|
||||
* toString()} for the enumeration value whose integer value
|
||||
* is <I>i</I>. If an integer within the above range is not used by any
|
||||
* enumeration value, leave the corresponding table element null.
|
||||
* <P>
|
||||
* The default implementation returns null. If the enumeration class (a
|
||||
* subclass of class EnumSyntax) does not override this method to return a
|
||||
* non-null string table, and the subclass does not override the {@link
|
||||
* #toString() <CODE>toString()</CODE>} method, the base class {@link
|
||||
* #toString() <CODE>toString()</CODE>} method will return just a string
|
||||
* #toString() toString()} method, the base class {@link
|
||||
* #toString() toString()} method will return just a string
|
||||
* representation of this enumeration value's integer value.
|
||||
* @return the string table
|
||||
*/
|
||||
|
@ -243,11 +243,11 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
|
|||
* Returns the enumeration value table for this enumeration value's
|
||||
* enumeration class. The enumeration class's integer values are assumed to
|
||||
* lie in the range <I>L</I>..<I>L</I>+<I>N</I>-1, where <I>L</I> is the
|
||||
* value returned by {@link #getOffset() <CODE>getOffset()</CODE>} and
|
||||
* value returned by {@link #getOffset() getOffset()} and
|
||||
* <I>N</I> is the length of the enumeration value table. The element in the
|
||||
* enumeration value table at index <I>i</I>-<I>L</I> is the enumeration
|
||||
* value object whose integer value is <I>i</I>; the {@link #readResolve()
|
||||
* <CODE>readResolve()</CODE>} method needs this to preserve singleton
|
||||
* readResolve()} method needs this to preserve singleton
|
||||
* semantics during deserialization of an enumeration instance. If an
|
||||
* integer within the above range is not used by any enumeration value,
|
||||
* leave the corresponding table element null.
|
||||
|
@ -255,8 +255,8 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
|
|||
* The default implementation returns null. If the enumeration class (a
|
||||
* subclass of class EnumSyntax) does not override this method to return
|
||||
* a non-null enumeration value table, and the subclass does not override
|
||||
* the {@link #readResolve() <CODE>readResolve()</CODE>} method, the base
|
||||
* class {@link #readResolve() <CODE>readResolve()</CODE>} method will throw
|
||||
* the {@link #readResolve() readResolve()} method, the base
|
||||
* class {@link #readResolve() readResolve()} method will throw
|
||||
* an exception whenever an enumeration instance is deserialized from an
|
||||
* object input stream.
|
||||
* @return the value table
|
||||
|
|
|
@ -388,7 +388,7 @@ public class HashAttributeSet implements AttributeSet, Serializable {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with
|
||||
* each element from the specified set.
|
||||
* The behavior of the <CODE>addAll(AttributeSet)</CODE>
|
||||
|
@ -512,7 +512,7 @@ public class HashAttributeSet implements AttributeSet, Serializable {
|
|||
* This ensures that <tt>t1.equals(t2)</tt> implies that
|
||||
* <tt>t1.hashCode()==t2.hashCode()</tt> for any two attribute sets
|
||||
* <tt>t1</tt> and <tt>t2</tt>, as required by the general contract of
|
||||
* {@link java.lang.Object#hashCode() <CODE>Object.hashCode()</CODE>}.
|
||||
* {@link java.lang.Object#hashCode() Object.hashCode()}.
|
||||
*
|
||||
* @return The hash code value for this attribute set.
|
||||
*/
|
||||
|
|
|
@ -33,9 +33,9 @@ import java.io.Serializable;
|
|||
* <P>
|
||||
* Under the hood, an integer attribute is just an integer. You can get an
|
||||
* integer attribute's integer value by calling {@link #getValue()
|
||||
* <CODE>getValue()</CODE>}. An integer attribute's integer value is
|
||||
* getValue()}. An integer attribute's integer value is
|
||||
* established when it is constructed (see {@link #IntegerSyntax(int)
|
||||
* <CODE>IntegerSyntax(int)</CODE>}). Once constructed, an integer attribute's
|
||||
* IntegerSyntax(int)}). Once constructed, an integer attribute's
|
||||
* value is immutable.
|
||||
* <P>
|
||||
*
|
||||
|
|
|
@ -36,8 +36,8 @@ package javax.print.attribute;
|
|||
* constructors and mutating operations guarantee an additional invariant,
|
||||
* namely that all attribute values in the PrintJobAttributeSet must be
|
||||
* instances of interface {@link PrintJobAttribute PrintJobAttribute}.
|
||||
* The {@link #add(Attribute) <CODE>add(Attribute)</CODE>}, and
|
||||
* {@link #addAll(AttributeSet) <CODE>addAll(AttributeSet)</CODE>} operations
|
||||
* The {@link #add(Attribute) add(Attribute)}, and
|
||||
* {@link #addAll(AttributeSet) >addAll(AttributeSet)} operations
|
||||
* are respecified below to guarantee this additional invariant.
|
||||
* <P>
|
||||
*
|
||||
|
@ -72,7 +72,7 @@ public interface PrintJobAttributeSet extends AttributeSet {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with
|
||||
* each element from the specified set. If none of the categories in the
|
||||
* specified set are the same as any categories in this attribute set,
|
||||
|
|
|
@ -37,8 +37,8 @@ package javax.print.attribute;
|
|||
* constructors and mutating operations guarantee an additional invariant,
|
||||
* namely that all attribute values in the PrintRequestAttributeSet must be
|
||||
* instances of interface {@link PrintRequestAttribute PrintRequestAttribute}.
|
||||
* The {@link #add(Attribute) <CODE>add(Attribute)</CODE>}, and
|
||||
* {@link #addAll(AttributeSet) <CODE>addAll(AttributeSet)</CODE>} operations
|
||||
* The {@link #add(Attribute) add(Attribute)}, and
|
||||
* {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
|
||||
* are respecified below to guarantee this additional invariant.
|
||||
* <P>
|
||||
*
|
||||
|
@ -73,7 +73,7 @@ public interface PrintRequestAttributeSet extends AttributeSet {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with
|
||||
* each element from the specified set. If none of the categories in the
|
||||
* specified set are the same as any categories in this attribute set,
|
||||
|
|
|
@ -39,8 +39,8 @@ package javax.print.attribute;
|
|||
* invariant,
|
||||
* namely that all attribute values in the PrintServiceAttributeSet must be
|
||||
* instances of interface {@link PrintServiceAttribute PrintServiceAttribute}.
|
||||
* The {@link #add(Attribute) <CODE>add(Attribute)</CODE>}, and
|
||||
* {@link #addAll(AttributeSet) <CODE>addAll(AttributeSet)</CODE>} operations
|
||||
* The {@link #add(Attribute) add(Attribute)}, and
|
||||
* {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
|
||||
* are respecified below to guarantee this additional invariant.
|
||||
* <P>
|
||||
*
|
||||
|
@ -77,7 +77,7 @@ public interface PrintServiceAttributeSet extends AttributeSet {
|
|||
/**
|
||||
* Adds all of the elements in the specified set to this attribute.
|
||||
* The outcome is the same as if the
|
||||
* {@link #add(Attribute) <CODE>add(Attribute)</CODE>}
|
||||
* {@link #add(Attribute) add(Attribute)}
|
||||
* operation had been applied to this attribute set successively with
|
||||
* each element from the specified set. If none of the categories in the
|
||||
* specified set are the same as any categories in this attribute set,
|
||||
|
|
|
@ -39,7 +39,7 @@ import java.io.Serializable;
|
|||
* resolution attribute's values, indicating the units in which the values are
|
||||
* to be returned. The two most common resolution units are dots per inch (dpi)
|
||||
* and dots per centimeter (dpcm), and exported constants {@link #DPI
|
||||
* <CODE>DPI</CODE>} and {@link #DPCM <CODE>DPCM</CODE>} are provided for
|
||||
* DPI} and {@link #DPCM DPCM} are provided for
|
||||
* indicating those units.
|
||||
* <P>
|
||||
* Once constructed, a resolution attribute's value is immutable.
|
||||
|
@ -68,9 +68,9 @@ import java.io.Serializable;
|
|||
* done, which would not be guaranteed if a floating point representation were
|
||||
* used.
|
||||
* <P>
|
||||
* The exported constant {@link #DPI <CODE>DPI</CODE>} is actually the
|
||||
* The exported constant {@link #DPI DPI} is actually the
|
||||
* conversion factor by which to multiply a value in dpi to get the value in
|
||||
* dphi. Likewise, the exported constant {@link #DPCM <CODE>DPCM</CODE>} is the
|
||||
* dphi. Likewise, the exported constant {@link #DPCM DPCM} is the
|
||||
* conversion factor by which to multiply a value in dpcm to get the value in
|
||||
* dphi. A client can specify a resolution value in units other than dpi or dpcm
|
||||
* by supplying its own conversion factor. However, since the internal units of
|
||||
|
@ -120,12 +120,12 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* @param feedResolution
|
||||
* Feed direction resolution.
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #DPI <CODE>DPI</CODE>} or
|
||||
* {@link #DPCM <CODE>DPCM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #DPI DPI} or
|
||||
* {@link #DPCM DPCM}.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>crossFeedResolution</CODE> <
|
||||
* 1 or <CODE>feedResolution</CODE> < 1 or <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code crossFeedResolution < 1}
|
||||
* or {@code feedResolution < 1} or {@code units < 1}.
|
||||
*/
|
||||
public ResolutionSyntax(int crossFeedResolution, int feedResolution,
|
||||
int units) {
|
||||
|
@ -172,14 +172,14 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* The values are rounded to the nearest integer.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #DPI <CODE>DPI</CODE>} or
|
||||
* {@link #DPCM <CODE>DPCM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #DPI DPI} or
|
||||
* {@link #DPCM DPCM}.
|
||||
*
|
||||
* @return A two-element array with the cross feed direction resolution
|
||||
* at index 0 and the feed direction resolution at index 1.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public int[] getResolution(int units) {
|
||||
return new int[] { getCrossFeedResolution(units),
|
||||
|
@ -192,13 +192,13 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* the given units. The value is rounded to the nearest integer.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #DPI <CODE>DPI</CODE>} or
|
||||
* {@link #DPCM <CODE>DPCM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #DPI DPI} or
|
||||
* {@link #DPCM DPCM}.
|
||||
*
|
||||
* @return Cross feed direction resolution.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public int getCrossFeedResolution(int units) {
|
||||
return convertFromDphi (crossFeedResolution, units);
|
||||
|
@ -209,13 +209,13 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* given units. The value is rounded to the nearest integer.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #DPI <CODE>DPI</CODE>} or {@link
|
||||
* #DPCM <CODE>DPCM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #DPI DPI} or {@link
|
||||
* #DPCM DPCM}.
|
||||
*
|
||||
* @return Feed direction resolution.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public int getFeedResolution(int units) {
|
||||
return convertFromDphi (feedResolution, units);
|
||||
|
@ -229,8 +229,8 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* rounded to the nearest integer.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #DPI <CODE>DPI</CODE>} or {@link
|
||||
* #DPCM <CODE>DPCM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #DPI CODE>DPI} or {@link
|
||||
* #DPCM DPCM}.
|
||||
* @param unitsName
|
||||
* Units name string, e.g. <CODE>"dpi"</CODE> or <CODE>"dpcm"</CODE>. If
|
||||
* null, no units name is appended to the result.
|
||||
|
@ -238,7 +238,7 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
|
|||
* @return String version of this resolution attribute.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public String toString(int units, String unitsName) {
|
||||
StringBuffer result = new StringBuffer();
|
||||
|
|
|
@ -38,8 +38,8 @@ import java.io.Serializable;
|
|||
* values are measured. Methods are provided to return a two-dimensional size
|
||||
* attribute's values, indicating the units in which the values are to be
|
||||
* returned. The two most common size units are inches (in) and millimeters
|
||||
* (mm), and exported constants {@link #INCH <CODE>INCH</CODE>} and {@link #MM
|
||||
* <CODE>MM</CODE>} are provided for indicating those units.
|
||||
* (mm), and exported constants {@link #INCH INCH} and {@link #MM
|
||||
* MM} are provided for indicating those units.
|
||||
* <P>
|
||||
* Once constructed, a two-dimensional size attribute's value is immutable.
|
||||
* <P>
|
||||
|
@ -66,9 +66,9 @@ import java.io.Serializable;
|
|||
* units, you have to search for a media size of 215.9 x 279.4 mm; rounding off
|
||||
* to an integral 216 x 279 mm will not match.
|
||||
* <P>
|
||||
* The exported constant {@link #INCH <CODE>INCH</CODE>} is actually the
|
||||
* The exported constant {@link #INCH INCH} is actually the
|
||||
* conversion factor by which to multiply a value in inches to get the value in
|
||||
* µm. Likewise, the exported constant {@link #MM <CODE>MM</CODE>} is the
|
||||
* µm. Likewise, the exported constant {@link #MM MM} is the
|
||||
* conversion factor by which to multiply a value in mm to get the value in
|
||||
* µm. A client can specify a resolution value in units other than inches
|
||||
* or mm by supplying its own conversion factor. However, since the internal
|
||||
|
@ -117,12 +117,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* @param x X dimension.
|
||||
* @param y Y dimension.
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or
|
||||
* {@link #MM MM}.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
|
||||
* {@code units < 1}.
|
||||
*/
|
||||
protected Size2DSyntax(float x, float y, int units) {
|
||||
if (x < 0.0f) {
|
||||
|
@ -145,12 +145,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* @param x X dimension.
|
||||
* @param y Y dimension.
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or
|
||||
* {@link #MM MM}.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0}
|
||||
* or {@code units < 1}.
|
||||
*/
|
||||
protected Size2DSyntax(int x, int y, int units) {
|
||||
if (x < 0) {
|
||||
|
@ -193,14 +193,13 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* as floating-point values.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
|
||||
*
|
||||
* @return A two-element array with the X dimension at index 0 and the Y
|
||||
* dimension at index 1.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float[] getSize(int units) {
|
||||
return new float[] {getX(units), getY(units)};
|
||||
|
@ -211,13 +210,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* units as a floating-point value.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
|
||||
*
|
||||
* @return X dimension.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getX(int units) {
|
||||
return convertFromMicrometers(x, units);
|
||||
|
@ -228,13 +226,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* units as a floating-point value.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
|
||||
*
|
||||
* @return Y dimension.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getY(int units) {
|
||||
return convertFromMicrometers(y, units);
|
||||
|
@ -248,16 +245,16 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
|
|||
* floating point.
|
||||
*
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. {@link #INCH <CODE>INCH</CODE>} or
|
||||
* {@link #MM <CODE>MM</CODE>}.
|
||||
* Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
|
||||
*
|
||||
* @param unitsName
|
||||
* Units name string, e.g. <CODE>"in"</CODE> or <CODE>"mm"</CODE>. If
|
||||
* Units name string, e.g. {@code in} or {@code mm}. If
|
||||
* null, no units name is appended to the result.
|
||||
*
|
||||
* @return String version of this two-dimensional size attribute.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public String toString(int units, String unitsName) {
|
||||
StringBuffer result = new StringBuffer();
|
||||
|
|
|
@ -40,11 +40,11 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
* can be verified to support color printing.
|
||||
* <P>
|
||||
* The table below shows the effects of specifying a Chromaticity attribute of
|
||||
* {@link #MONOCHROME <CODE>MONOCHROME</CODE>} or {@link #COLOR
|
||||
* <CODE>COLOR</CODE>} for a monochrome or color document.
|
||||
* {@link #MONOCHROME MONOCHROME} or {@link #COLOR COLOR}
|
||||
* for a monochrome or color document.
|
||||
* <P>
|
||||
* <TABLE BORDER=1 CELLPADDING=2 CELLSPACING=1 SUMMARY="Shows effects of specifying MONOCHROME or COLOR Chromaticity attributes">
|
||||
* <TR BGCOLOR="#E5E5E5">
|
||||
* <TR>
|
||||
* <TH>
|
||||
* Chromaticity<BR>Attribute
|
||||
* </TH>
|
||||
|
@ -57,7 +57,7 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
* </TR>
|
||||
* <TR>
|
||||
* <TD>
|
||||
* {@link #MONOCHROME <CODE>MONOCHROME</CODE>}
|
||||
* {@link #MONOCHROME MONOCHROME}
|
||||
* </TD>
|
||||
* <TD>
|
||||
* Printed as is, in monochrome
|
||||
|
@ -68,7 +68,7 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
* </TR>
|
||||
* <TR>
|
||||
* <TD>
|
||||
* {@link #COLOR <CODE>COLOR</CODE>}
|
||||
* {@link #COLOR COLOR}
|
||||
* </TD>
|
||||
* <TD>
|
||||
* Printed as is, in monochrome
|
||||
|
|
|
@ -34,7 +34,7 @@ import javax.print.attribute.DocAttribute;
|
|||
* print data (the doc), not of the Print Job. If a Compression attribute is not
|
||||
* specified for a doc, the printer assumes the doc's print data is uncompressed
|
||||
* (i.e., the default Compression value is always {@link #NONE
|
||||
* <CODE>NONE</CODE>}).
|
||||
* NONE}).
|
||||
* <P>
|
||||
* <B>IPP Compatibility:</B> The category name returned by
|
||||
* <CODE>getName()</CODE> is the IPP attribute name. The enumeration's
|
||||
|
|
|
@ -46,13 +46,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #NONE <CODE>NONE</CODE>}
|
||||
* {@link #NONE NONE}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE <CODE>STAPLE</CODE>}
|
||||
* {@link #STAPLE STAPLE}
|
||||
* </TD>
|
||||
* <TD WIDTH=36%>
|
||||
* {@link #EDGE_STITCH <CODE>EDGE_STITCH</CODE>}
|
||||
* {@link #EDGE_STITCH EDGE_STITCH}
|
||||
* </TD>
|
||||
* </TR>
|
||||
* <TR>
|
||||
|
@ -60,13 +60,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD>
|
||||
* {@link #BIND <CODE>BIND</CODE>}
|
||||
* {@link #BIND BIND}
|
||||
* </TD>
|
||||
* <TD>
|
||||
* {@link #SADDLE_STITCH <CODE>SADDLE_STITCH</CODE>}
|
||||
* {@link #SADDLE_STITCH SADDLE_STITCH}
|
||||
* </TD>
|
||||
* <TD>
|
||||
* {@link #COVER <CODE>COVER</CODE>}
|
||||
* {@link #COVER COVER}
|
||||
* </TD>
|
||||
* <TD>
|
||||
*
|
||||
|
@ -82,13 +82,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_TOP_LEFT <CODE>STAPLE_TOP_LEFT</CODE>}
|
||||
* {@link #STAPLE_TOP_LEFT STAPLE_TOP_LEFT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #EDGE_STITCH_LEFT <CODE>EDGE_STITCH_LEFT</CODE>}
|
||||
* {@link #EDGE_STITCH_LEFT EDGE_STITCH_LEFT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_DUAL_LEFT <CODE>STAPLE_DUAL_LEFT</CODE>}
|
||||
* {@link #STAPLE_DUAL_LEFT STAPLE_DUAL_LEFT}
|
||||
* </TD>
|
||||
* <TD WIDTH=9%>
|
||||
*
|
||||
|
@ -99,13 +99,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_BOTTOM_LEFT <CODE>STAPLE_BOTTOM_LEFT</CODE>}
|
||||
* {@link #STAPLE_BOTTOM_LEFT STAPLE_BOTTOM_LEFT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #EDGE_STITCH_TOP <CODE>EDGE_STITCH_TOP</CODE>}
|
||||
* {@link #EDGE_STITCH_TOP EDGE_STITCH_TOP}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_DUAL_TOP <CODE>STAPLE_DUAL_TOP</CODE>}
|
||||
* {@link #STAPLE_DUAL_TOP STAPLE_DUAL_TOP}
|
||||
* </TD>
|
||||
* <TD WIDTH=9%>
|
||||
*
|
||||
|
@ -116,13 +116,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_TOP_RIGHT <CODE>STAPLE_TOP_RIGHT</CODE>}
|
||||
* {@link #STAPLE_TOP_RIGHT STAPLE_TOP_RIGHT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #EDGE_STITCH_RIGHT <CODE>EDGE_STITCH_RIGHT</CODE>}
|
||||
* {@link #EDGE_STITCH_RIGHT EDGE_STITCH_RIGHT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_DUAL_RIGHT <CODE>STAPLE_DUAL_RIGHT</CODE>}
|
||||
* {@link #STAPLE_DUAL_RIGHT STAPLE_DUAL_RIGHT}
|
||||
* </TD>
|
||||
* <TD WIDTH=9%>
|
||||
*
|
||||
|
@ -133,13 +133,13 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
*
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_BOTTOM_RIGHT <CODE>STAPLE_BOTTOM_RIGHT</CODE>}
|
||||
* {@link #STAPLE_BOTTOM_RIGHT STAPLE_BOTTOM_RIGHT}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #EDGE_STITCH_BOTTOM <CODE>EDGE_STITCH_BOTTOM</CODE>}
|
||||
* {@link #EDGE_STITCH_BOTTOM EDGE_STITCH_BOTTOM}
|
||||
* </TD>
|
||||
* <TD WIDTH=27%>
|
||||
* {@link #STAPLE_DUAL_BOTTOM <CODE>STAPLE_DUAL_BOTTOM</CODE>}
|
||||
* {@link #STAPLE_DUAL_BOTTOM STAPLE_DUAL_BOTTOM}
|
||||
* </TD>
|
||||
* <TD WIDTH=9%>
|
||||
*
|
||||
|
@ -147,16 +147,16 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
* </TR>
|
||||
* </TABLE>
|
||||
* <P>
|
||||
* The <CODE>STAPLE_<I>XXX</I></CODE> values are specified with respect to the
|
||||
* The STAPLE_<I>XXX</I> values are specified with respect to the
|
||||
* document as if the document were a portrait document. If the document is
|
||||
* actually a landscape or a reverse-landscape document, the client supplies the
|
||||
* appropriate transformed value. For example, to position a staple in the upper
|
||||
* left hand corner of a landscape document when held for reading, the client
|
||||
* supplies the <CODE>STAPLE_BOTTOM_LEFT</CODE> value (since landscape is
|
||||
* supplies the STAPLE_BOTTOM_LEFT value (since landscape is
|
||||
* defined as a +90 degree rotation from portrait, i.e., anti-clockwise). On the
|
||||
* other hand, to position a staple in the upper left hand corner of a
|
||||
* reverse-landscape document when held for reading, the client supplies the
|
||||
* <CODE>STAPLE_TOP_RIGHT</CODE> value (since reverse-landscape is defined as a
|
||||
* STAPLE_TOP_RIGHT value (since reverse-landscape is defined as a
|
||||
* -90 degree rotation from portrait, i.e., clockwise).
|
||||
* <P>
|
||||
* The angle (vertical, horizontal, angled) of each staple with respect to the
|
||||
|
|
|
@ -67,7 +67,7 @@ import javax.print.attribute.PrintJobAttribute;
|
|||
* shown in the table below.
|
||||
* <P>
|
||||
* <TABLE BORDER=1 CELLPADDING=2 CELLSPACING=1 SUMMARY="Table showing computation of doc sizes">
|
||||
* <TR BGCOLOR="#E5E5E5">
|
||||
* <TR>
|
||||
* <TH>Representation Class</TH>
|
||||
* <TH>Document Size</TH>
|
||||
* </TR>
|
||||
|
|
|
@ -62,7 +62,7 @@ import javax.print.attribute.PrintRequestAttribute;
|
|||
* The (x,y) origin is positioned at the top-left of the paper in portrait
|
||||
* mode regardless of the orientation specified in the requesting context.
|
||||
* For example a printable area for A4 paper in portrait or landscape
|
||||
* orientation will have height > width.
|
||||
* orientation will have height {@literal >} width.
|
||||
* <p>
|
||||
* A printable area attribute's values are stored
|
||||
* internally as integers in units of micrometers (µm), where 1 micrometer
|
||||
|
@ -107,9 +107,9 @@ public final class MediaPrintableArea
|
|||
* @param units in which the values are expressed.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE> < 0
|
||||
* or <CODE>w</CODE> <= 0 or <CODE>h</CODE> <= 0 or
|
||||
* <CODE>units</CODE> < 1.
|
||||
* Thrown if {@code x < 0} or {@code y < 0}
|
||||
* or {@code w <= 0} or {@code h <= 0} or
|
||||
* {@code units < 1}.
|
||||
*/
|
||||
public MediaPrintableArea(float x, float y, float w, float h, int units) {
|
||||
if ((x < 0.0) || (y < 0.0) || (w <= 0.0) || (h <= 0.0) ||
|
||||
|
@ -133,9 +133,9 @@ public final class MediaPrintableArea
|
|||
* @param units in which the values are expressed.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE> < 0
|
||||
* or <CODE>w</CODE> <= 0 or <CODE>h</CODE> <= 0 or
|
||||
* <CODE>units</CODE> < 1.
|
||||
* Thrown if {@code x < 0} or {@code y < 0}
|
||||
* or {@code w <= 0} or {@code h <= 0} or
|
||||
* {@code units < 1}.
|
||||
*/
|
||||
public MediaPrintableArea(int x, int y, int w, int h, int units) {
|
||||
if ((x < 0) || (y < 0) || (w <= 0) || (h <= 0) ||
|
||||
|
@ -159,7 +159,7 @@ public final class MediaPrintableArea
|
|||
* @return printable area as array of x, y, w, h in the specified units.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float[] getPrintableArea(int units) {
|
||||
return new float[] { getX(units), getY(units),
|
||||
|
@ -177,7 +177,7 @@ public final class MediaPrintableArea
|
|||
* specified units.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getX(int units) {
|
||||
return convertFromMicrometers(x, units);
|
||||
|
@ -194,7 +194,7 @@ public final class MediaPrintableArea
|
|||
* specified units.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getY(int units) {
|
||||
return convertFromMicrometers(y, units);
|
||||
|
@ -209,7 +209,7 @@ public final class MediaPrintableArea
|
|||
* @return width of the printable area in the specified units.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getWidth(int units) {
|
||||
return convertFromMicrometers(w, units);
|
||||
|
@ -224,7 +224,7 @@ public final class MediaPrintableArea
|
|||
* @return height of the printable area in the specified units.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public float getHeight(int units) {
|
||||
return convertFromMicrometers(h, units);
|
||||
|
@ -301,7 +301,7 @@ public final class MediaPrintableArea
|
|||
* @return String version of this two-dimensional size attribute.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code units < 1}.
|
||||
*/
|
||||
public String toString(int units, String unitsName) {
|
||||
if (unitsName == null) {
|
||||
|
|
|
@ -45,7 +45,7 @@ import javax.print.attribute.Attribute;
|
|||
* <code>MediaSize.getMediaSizeForName(MediaSizeName)</code>
|
||||
* to find the physical dimensions of the MediaSizeName instances
|
||||
* enumerated in this API. This is useful for clients which need this
|
||||
* information to format & paginate printing.
|
||||
* information to format {@literal &} paginate printing.
|
||||
* <P>
|
||||
*
|
||||
* @author Phil Race, Alan Kaminsky
|
||||
|
@ -71,8 +71,8 @@ public class MediaSize extends Size2DSyntax implements Attribute {
|
|||
* <CODE>Size2DSyntax.MM</CODE>.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
|
||||
* {@code units < 1} or {@code x > y}.
|
||||
*/
|
||||
public MediaSize(float x, float y,int units) {
|
||||
super (x, y, units);
|
||||
|
@ -92,8 +92,8 @@ public class MediaSize extends Size2DSyntax implements Attribute {
|
|||
* <CODE>Size2DSyntax.MM</CODE>.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
|
||||
* {@code units < 1} or {@code x > y}.
|
||||
*/
|
||||
public MediaSize(int x, int y,int units) {
|
||||
super (x, y, units);
|
||||
|
@ -115,8 +115,8 @@ public class MediaSize extends Size2DSyntax implements Attribute {
|
|||
* @param media a media name to associate with this MediaSize
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
|
||||
* {@code units < 1} or {@code x > y}.
|
||||
*/
|
||||
public MediaSize(float x, float y,int units, MediaSizeName media) {
|
||||
super (x, y, units);
|
||||
|
@ -141,8 +141,8 @@ public class MediaSize extends Size2DSyntax implements Attribute {
|
|||
* @param media a media name to associate with this MediaSize
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (Unchecked exception) Thrown if <CODE>x</CODE> < 0 or <CODE>y</CODE>
|
||||
* < 0 or <CODE>units</CODE> < 1 or <CODE>x</CODE> > <CODE>y</CODE>.
|
||||
* (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
|
||||
* {@code units < 1} or {@code x > y}.
|
||||
*/
|
||||
public MediaSize(int x, int y,int units, MediaSizeName media) {
|
||||
super (x, y, units);
|
||||
|
@ -194,7 +194,8 @@ public class MediaSize extends Size2DSyntax implements Attribute {
|
|||
* Unit conversion factor, e.g. <CODE>Size2DSyntax.INCH</CODE> or
|
||||
* <CODE>Size2DSyntax.MM</CODE>
|
||||
* @return MediaSizeName matching these dimensions, or null.
|
||||
* @exception IllegalArgumentException if x <= 0, y <= 0, or units < 1
|
||||
* @exception IllegalArgumentException if {@code x <= 0},
|
||||
* {@code y <= 0}, or {@code units < 1}.
|
||||
*
|
||||
*/
|
||||
public static MediaSizeName findMedia(float x, float y, int units) {
|
||||
|
|
|
@ -56,56 +56,56 @@ public final class PresentationDirection extends EnumSyntax
|
|||
|
||||
/**
|
||||
* Pages are laid out in columns starting at the top left,
|
||||
* proceeeding towards the bottom & right.
|
||||
* proceeeding towards the bottom {@literal &} right.
|
||||
*/
|
||||
public static final PresentationDirection TOBOTTOM_TORIGHT =
|
||||
new PresentationDirection(0);
|
||||
|
||||
/**
|
||||
* Pages are laid out in columns starting at the top right,
|
||||
* proceeeding towards the bottom & left.
|
||||
* proceeeding towards the bottom {@literal &} left.
|
||||
*/
|
||||
public static final PresentationDirection TOBOTTOM_TOLEFT =
|
||||
new PresentationDirection(1);
|
||||
|
||||
/**
|
||||
* Pages are laid out in columns starting at the bottom left,
|
||||
* proceeeding towards the top & right.
|
||||
* proceeeding towards the top {@literal &} right.
|
||||
*/
|
||||
public static final PresentationDirection TOTOP_TORIGHT =
|
||||
new PresentationDirection(2);
|
||||
|
||||
/**
|
||||
* Pages are laid out in columns starting at the bottom right,
|
||||
* proceeeding towards the top & left.
|
||||
* proceeeding towards the top {@literal &} left.
|
||||
*/
|
||||
public static final PresentationDirection TOTOP_TOLEFT =
|
||||
new PresentationDirection(3);
|
||||
|
||||
/**
|
||||
* Pages are laid out in rows starting at the top left,
|
||||
* proceeeding towards the right & bottom.
|
||||
* proceeeding towards the right {@literal &} bottom.
|
||||
*/
|
||||
public static final PresentationDirection TORIGHT_TOBOTTOM =
|
||||
new PresentationDirection(4);
|
||||
|
||||
/**
|
||||
* Pages are laid out in rows starting at the bottom left,
|
||||
* proceeeding towards the right & top.
|
||||
* proceeeding towards the right {@literal &} top.
|
||||
*/
|
||||
public static final PresentationDirection TORIGHT_TOTOP =
|
||||
new PresentationDirection(5);
|
||||
|
||||
/**
|
||||
* Pages are laid out in rows starting at the top right,
|
||||
* proceeeding towards the left & bottom.
|
||||
* proceeeding towards the left {@literal &} bottom.
|
||||
*/
|
||||
public static final PresentationDirection TOLEFT_TOBOTTOM =
|
||||
new PresentationDirection(6);
|
||||
|
||||
/**
|
||||
* Pages are laid out in rows starting at the bottom right,
|
||||
* proceeeding towards the left & top.
|
||||
* proceeeding towards the left {@literal &} top.
|
||||
*/
|
||||
public static final PresentationDirection TOLEFT_TOTOP =
|
||||
new PresentationDirection(7);
|
||||
|
|
|
@ -40,7 +40,7 @@ import javax.print.attribute.PrintServiceAttribute;
|
|||
* details on color support). The information is intended to be germane to
|
||||
* this kind of printer without regard to site specific modifications or
|
||||
* services.
|
||||
* <P
|
||||
* <P>
|
||||
* In contrast, the {@link PrinterMoreInfo PrinterMoreInfo} attribute is used
|
||||
* to find out more information about this specific printer rather than this
|
||||
* general kind of printer.
|
||||
|
|
|
@ -84,11 +84,11 @@ public final class PrinterResolution extends ResolutionSyntax
|
|||
* Feed direction resolution.
|
||||
* @param units
|
||||
* Unit conversion factor, e.g. <code>ResolutionSyntax.DPI</CODE>
|
||||
* or <code>ResolutionSyntax.>DPCM</CODE>.
|
||||
* or <code>ResolutionSyntax.DPCM</CODE>.
|
||||
*
|
||||
* @exception IllegalArgumentException
|
||||
* (unchecked exception) Thrown if <CODE>crossFeedResolution</CODE> <
|
||||
* 1 or <CODE>feedResolution</CODE> < 1 or <CODE>units</CODE> < 1.
|
||||
* (unchecked exception) Thrown if {@code crossFeedResolution < 1} or
|
||||
* {@code feedResolution < 1} or {@code units < 1}.
|
||||
*/
|
||||
public PrinterResolution(int crossFeedResolution, int feedResolution,
|
||||
int units) {
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -514,7 +514,7 @@ public class GlyphView extends View implements TabableView, Cloneable {
|
|||
int x1 = x0 + (int) painter.getSpan(this, p0, p1, getTabExpander(), x0);
|
||||
|
||||
// calculate y coordinate
|
||||
int y = alloc.y + alloc.height - (int) painter.getDescent(this);
|
||||
int y = alloc.y + (int)(painter.getHeight(this) - painter.getDescent(this));
|
||||
if (underline) {
|
||||
int yTmp = y + 1;
|
||||
g.drawLine(x0, yTmp, x1, yTmp);
|
||||
|
|
|
@ -310,11 +310,13 @@ public final class AppContext {
|
|||
// and excludes applets because by the time applet starts
|
||||
// a number of contexts have already been created by the plugin.
|
||||
if (numAppContexts.get() == 0) {
|
||||
// This check is not necessary, its purpose is to help
|
||||
// Plugin devs to catch all the cases of main AC creation.
|
||||
if (System.getProperty("javaplugin.version") == null &&
|
||||
System.getProperty("javawebstart.version") == null) {
|
||||
initMainAppContext();
|
||||
} else if (System.getProperty("javafx.version") != null &&
|
||||
threadGroup.getParent() != null) {
|
||||
// Swing inside JavaFX case
|
||||
SunToolkit.createNewAppContext();
|
||||
}
|
||||
}
|
||||
|
||||
|
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue