Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02

weblogic.management.configuration
Interface IIOPMBean

All Superinterfaces:
ConfigurationMBean

public interface IIOPMBean
extends ConfigurationMBean

Configuration for IIOP properties.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX."


Field Summary
 
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
 
Method Summary
 int getCompleteMessageTimeout()
          Deprecated.  
 String getDefaultCharCodeset()
          The standard character code set that this server will publish as its native code set.
 int getDefaultMinorVersion()
          The default GIOP (General Inter-ORB Protocol) version that this server will negotiate for incoming connections.
 String getDefaultWideCharCodeset()
          The wide character code set that this server will publish as its native code set.
 boolean getEnableIORServlet()
          Enable getior servlet used to publish COS Naming Service IORs
 int getIdleConnectionTimeout()
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()
 int getMaxMessageSize()
          Deprecated.  
 String getSystemSecurity()
          Specify the value System Security.
 String getTxMechanism()
          The transaction mechanism used by IIOP invocations.
 boolean getUseFullRepositoryIdList()
          Specify whether to use full Repository ID lists when sending value type information for custom-marshaled types.
 boolean getUseJavaSerialization()
          Specity whether to use java serialization for marshalling objects.
 boolean getUseSerialFormatVersion2()
          Specify whether to advertise RMI objects and EJBs as supporting RMI-IIOP serial format version 2 for custom marshaled objects.
 boolean getUseStatefulAuthentication()
          Specify whether to advertise RMI objects and EJBs as supporting stateful CSIv2.
 void setCompleteMessageTimeout(int seconds)
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()
 void setDefaultCharCodeset(String codeset)
          Set the value of the DefaultCharacterCodeset attribute.
 void setDefaultMinorVersion(int minor)
          Sets the value of the DefaultMinorVersion attribute.
 void setDefaultWideCharCodeset(String codeset)
          Set the value of the DefaultWideCharacterCodeset attribute.
 void setEnableIORServlet(boolean flag)
           
 void setIdleConnectionTimeout(int seconds)
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()
 void setMaxMessageSize(int maxsize)
          Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()
 void setSystemSecurity(String authValue)
           
 void setTxMechanism(String mech)
          Sets the value of the TXMechanism attribute.
 void setUseFullRepositoryIdList(boolean full)
           
 void setUseJavaSerialization(boolean use)
           
 void setUseSerialFormatVersion2(boolean full)
           
 void setUseStatefulAuthentication(boolean full)
           
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
 

Method Detail

getIdleConnectionTimeout

int getIdleConnectionTimeout()
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()

The maximum number of seconds an IIOP connection is allowed to be idle before it is closed by the server. This timeout helps guard against server deadlock through too many open connections.

Returns:
The idleConnectionTimeout value

setIdleConnectionTimeout

void setIdleConnectionTimeout(int seconds)
                              throws InvalidAttributeValueException,
                                     DistributedManagementException
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getIdleConnectionTimeout()

Sets the value of the IdleConnectionTimeout attribute.

Parameters:
seconds - The new idleConnectionTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
IIOPMBean.getIdleConnectionTimeout()
Default Value:
-1
Minimum Value:
-1

getCompleteMessageTimeout

int getCompleteMessageTimeout()
Deprecated. 

The maximum number of seconds spent waiting for a complete IIOP message to be received. This timeout helps guard against denial of service attacks in which a caller indicates that they will be sending a message of a certain size which they never finish sending.

Returns:
The completeMessageTimeout value

setCompleteMessageTimeout

void setCompleteMessageTimeout(int seconds)
                               throws InvalidAttributeValueException,
                                      DistributedManagementException
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getCompleteMessageTimeout()

Sets the value of the CompleteMessageTimeout attribute.

Parameters:
seconds - The new completeMessageTimeout value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
IIOPMBean.getCompleteMessageTimeout()
Default Value:
-1
Maximum Value:
480
Minimum Value:
-1

getMaxMessageSize

int getMaxMessageSize()
Deprecated. 

The maximum IIOP message size allowable in a message header. This attribute attempts to prevent a denial of service attack whereby a caller attempts to force the server to allocate more memory than is available thereby keeping the server from responding quickly to other requests.

Returns:
The maxMessageSize value

setMaxMessageSize

void setMaxMessageSize(int maxsize)
                       throws InvalidAttributeValueException,
                              DistributedManagementException
Deprecated. 8.1.0.0 use NetworkAccessPointMBean.getMaxMessageSize()

Sets the value of the MaxMessageSize attribute.

Parameters:
maxsize - The new maxMessageSize value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
IIOPMBean.getMaxMessageSize()
Default Value:
-1

getDefaultMinorVersion

int getDefaultMinorVersion()

The default GIOP (General Inter-ORB Protocol) version that this server will negotiate for incoming connections. (You may have to modify the default to work with other vendor's ORBs.)

This attribute is useful for client orbs with broken GIOP 1.2 implementations.

Returns:
The defaultMinorVersion value
Default Value:
2
Maximum Value:
2
Minimum Value:
0

setDefaultMinorVersion

void setDefaultMinorVersion(int minor)
                            throws InvalidAttributeValueException,
                                   DistributedManagementException

Sets the value of the DefaultMinorVersion attribute.

Parameters:
minor - The new defaultMinorVersion value
Throws:
InvalidAttributeValueException
DistributedManagementException
IllegalArgumentException - if the argument is null or represents a negative int.
See Also:
IIOPMBean.getDefaultMinorVersion()

getTxMechanism

String getTxMechanism()

The transaction mechanism used by IIOP invocations. The default is the Object Transaction Service (OTS) required by J2EE 1.3.

Returns:
The txMechanism value
Default Value:
"OTS"
Valid Values:
"OTS","JTA", "OTSv11", "none"

setTxMechanism

void setTxMechanism(String mech)
                    throws InvalidAttributeValueException,
                           DistributedManagementException

Sets the value of the TXMechanism attribute.

Parameters:
mech - The new txMechanism value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
#getTXMechanism

getDefaultWideCharCodeset

String getDefaultWideCharCodeset()

The wide character code set that this server will publish as its native code set. (Older ORBs may have trouble interoperating with anything other than the default.)

Returns:
The defaultWideCharCodeset value
Default Value:
"UCS-2"
Valid Values:
"UCS-2", "UTF-16", "UTF-8", "UTF-16BE", "UTF-16LE"

setDefaultWideCharCodeset

void setDefaultWideCharCodeset(String codeset)
                               throws InvalidAttributeValueException,
                                      DistributedManagementException

Set the value of the DefaultWideCharacterCodeset attribute.

Parameters:
codeset - The new defaultWideCharCodeset value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
#getDefaultWideCharacterCodeset

getDefaultCharCodeset

String getDefaultCharCodeset()

The standard character code set that this server will publish as its native code set. (Older ORBs may have trouble interoperating with anything other than the default.)

Returns:
The defaultCharCodeset value
Default Value:
"US-ASCII"
Valid Values:
"US-ASCII", "UTF-8", "ISO-8859-1"

setDefaultCharCodeset

void setDefaultCharCodeset(String codeset)
                           throws InvalidAttributeValueException,
                                  DistributedManagementException

Set the value of the DefaultCharacterCodeset attribute.

Parameters:
codeset - The new defaultCharCodeset value
Throws:
InvalidAttributeValueException
DistributedManagementException
See Also:
#getDefaultCharacterCodeset

getUseFullRepositoryIdList

boolean getUseFullRepositoryIdList()

Specify whether to use full Repository ID lists when sending value type information for custom-marshaled types. Full Repository ID lists allow C++ ORBS to truncate values to base types. For RMI-IIOP and Java ORBs doing this merely increases transmission overhead. JDK ORBs are known to have problems with these so setting this will prevent JDK ORB access from working.

Returns:
The useFullRepositoyIdList value
Default Value:
false

setUseFullRepositoryIdList

void setUseFullRepositoryIdList(boolean full)
                                throws InvalidAttributeValueException,
                                       DistributedManagementException
Throws:
InvalidAttributeValueException
DistributedManagementException

getUseStatefulAuthentication

boolean getUseStatefulAuthentication()

Specify whether to advertise RMI objects and EJBs as supporting stateful CSIv2. Stateful CSIv2 is more efficient than stateless, requiring only a single authentication step for each remote principal. Stateless CSIv2 requires per-request authentication. Stateful CSIv2 is not required by J2EE 1.3 and so some ORBs do not support it. Stateful CSIv2 is enabled by default. This property can be changed at the object-level by changing the object's <stateful-authentication> runtime descriptor property.

Returns:
The statefulAuthentication property
Default Value:
true

setUseStatefulAuthentication

void setUseStatefulAuthentication(boolean full)
                                  throws InvalidAttributeValueException,
                                         DistributedManagementException
Throws:
InvalidAttributeValueException
DistributedManagementException

getUseSerialFormatVersion2

boolean getUseSerialFormatVersion2()

Specify whether to advertise RMI objects and EJBs as supporting RMI-IIOP serial format version 2 for custom marshaled objects.

Returns:
The useSerialFormatVersion2 property
Default Value:
false

setUseSerialFormatVersion2

void setUseSerialFormatVersion2(boolean full)
                                throws InvalidAttributeValueException,
                                       DistributedManagementException
Throws:
InvalidAttributeValueException
DistributedManagementException

getEnableIORServlet

boolean getEnableIORServlet()
Enable getior servlet used to publish COS Naming Service IORs

Default Value:
false

setEnableIORServlet

void setEnableIORServlet(boolean flag)

getUseJavaSerialization

boolean getUseJavaSerialization()
Specity whether to use java serialization for marshalling objects. Setting this property improves performance when marshalling objects with very large object graphs.

Returns:
The useJavaSerialization value
Default Value:
false

setUseJavaSerialization

void setUseJavaSerialization(boolean use)
                             throws InvalidAttributeValueException,
                                    DistributedManagementException
Throws:
InvalidAttributeValueException
DistributedManagementException

getSystemSecurity

String getSystemSecurity()
Specify the value System Security. The following variables are affected. clientCertAuthentication, clientAuthentication, identityAssertion confidentiality, integrity. The value set in this MBean would only be picked up if the value set in RTD.xml is "config".

Returns:
The System Security value
Default Value:
"supported"
Valid Values:
"none", "supported", "required"

setSystemSecurity

void setSystemSecurity(String authValue)
                       throws InvalidAttributeValueException,
                              DistributedManagementException
Throws:
InvalidAttributeValueException
DistributedManagementException

Documentation is available at
http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm
Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02