org.omg.CosPropertyService
Class PropertySetPOA

java.lang.Object
  extended by org.omg.PortableServer.Servant
      extended by org.omg.CosPropertyService.PropertySetPOA
All Implemented Interfaces:
org.omg.CORBA.portable.InvokeHandler, PropertySetOperations
Direct Known Subclasses:
PropertySetImpl, PropertySetPOATie

public abstract class PropertySetPOA
extends org.omg.PortableServer.Servant
implements PropertySetOperations, org.omg.CORBA.portable.InvokeHandler

The PropertySet interface provides operations to define and modify properties, list and get properties, and delete properties.

The PropertySet interface also provides "batch" operations, such as define_properties, to deal with sets of properties as a whole. The execution of the "batch" operations is considered best effort (i.e., not an atomic set) in that not all suboperations need succeed for any suboperation to succeed.

For define_properties and delete_properties, if any suboperation fails, a MultipleExceptions exception is returned to identify which property name had which exception.

For example, a client may invoke define_properties using three property structures. The first property could be accepted (added or modified), the second could fail due to an InvalidPropertyName, and the third could fail due to a ConflictingProperty. In this case a property is either added or modified in the PropertySet, and a MultipleExceptions is raised with two items in the PropertyExceptions sequence.

The get_properties and delete_all_properties "batch" operations utilize a boolean flag to identify that mixed results occurred and additional processing may be required to fully analyze the exceptions.

Making "batch" operations behave in an atomic manner is considered an implementation issue that could be accomplished via specialization of this property service.


Constructor Summary
PropertySetPOA()
           
 
Method Summary
 java.lang.String[] _all_interfaces(org.omg.PortableServer.POA poa, byte[] objectId)
           
 org.omg.CORBA.portable.OutputStream _invoke(java.lang.String opName, org.omg.CORBA.portable.InputStream _is, org.omg.CORBA.portable.ResponseHandler handler)
           
 PropertySet _this()
           
 PropertySet _this(org.omg.CORBA.ORB orb)
           
 
Methods inherited from class org.omg.PortableServer.Servant
_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.omg.CosPropertyService.PropertySetOperations
define_properties, define_property, delete_all_properties, delete_properties, delete_property, get_all_properties, get_all_property_names, get_number_of_properties, get_properties, get_property_value, is_property_defined
 

Constructor Detail

PropertySetPOA

public PropertySetPOA()
Method Detail

_this

public PropertySet _this()

_this

public PropertySet _this(org.omg.CORBA.ORB orb)

_all_interfaces

public java.lang.String[] _all_interfaces(org.omg.PortableServer.POA poa,
                                          byte[] objectId)
Specified by:
_all_interfaces in class org.omg.PortableServer.Servant

_invoke

public final org.omg.CORBA.portable.OutputStream _invoke(java.lang.String opName,
                                                         org.omg.CORBA.portable.InputStream _is,
                                                         org.omg.CORBA.portable.ResponseHandler handler)
Specified by:
_invoke in interface org.omg.CORBA.portable.InvokeHandler