org.jvnet.ws.message
Class BaseDistributedPropertySet

java.lang.Object
  com.oracle.webservices.api.message.BasePropertySet
      com.oracle.webservices.api.message.BaseDistributedPropertySet
          org.jvnet.ws.message.BaseDistributedPropertySet

All Implemented Interfaces:

DistributedPropertySet, PropertySet

Deprecated.

@Deprecated
public abstract class BaseDistributedPropertySet
extends BaseDistributedPropertySet
implements DistributedPropertySet

PropertySet that combines properties exposed from multiple PropertySets into one.

This implementation allows one PropertySet to assemble all properties exposed from other "satellite" PropertySets. (A satellite may itself be a DistributedPropertySet, so in general this can form a tree.)

This is useful for JAX-WS because the properties we expose to the application are contributed by different pieces, and therefore we'd like each of them to have a separate PropertySet implementation that backs up the properties. For example, this allows FastInfoset to expose its set of properties to RequestContext by using a strongly-typed fields.

This is also useful for a client-side transport to expose a bunch of properties into ResponseContext. It simply needs to create a PropertySet object with methods for each property it wants to expose, and then add that PropertySet to Packet. This allows property values to be lazily computed (when actually asked by users), thus improving the performance of the typical case where property values are not asked.

A similar benefit applies on the server-side, for a transport to expose a bunch of properties to WebServiceContext.

To achieve these benefits, access to DistributedPropertySet is slower compared to PropertySet (such as get/set), while adding a satellite object is relatively fast.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.webservices.api.message.BasePropertySet

BasePropertySet.Accessor, BasePropertySet.PropertyMap, BasePropertySet.PropertyMapEntry

Nested classes/interfaces inherited from interface com.oracle.webservices.api.message.PropertySet

PropertySet.Property

Constructor Summary

BaseDistributedPropertySet()
Deprecated.

Method Summary

void	addSatellite(Class keyClass, PropertySet satellite) Deprecated.
void	addSatellite(PropertySet satellite) Deprecated.
void	copySatelliteInto(MessageContext r) Deprecated.
void	removeSatellite(PropertySet satellite) Deprecated.

Methods inherited from class com.oracle.webservices.api.message.BaseDistributedPropertySet

addSatellite, addSatellite, asMapLocal, containsKey, copySatelliteInto, copySatelliteInto, createEntrySet, createView, get, getSatellite, getSatellites, put, remove, removeSatellite, supports, supportsLocal

Methods inherited from class com.oracle.webservices.api.message.BasePropertySet

asMap, createMapView, getPropertyMap, mapAllowsAdditionalProperties, parse

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.oracle.webservices.api.message.DistributedPropertySet

addSatellite, addSatellite, copySatelliteInto, getSatellite, getSatellites, removeSatellite

Methods inherited from interface com.oracle.webservices.api.message.PropertySet

asMap, containsKey, createMapView, get, put, remove, supports

Constructor Detail

BaseDistributedPropertySet

public BaseDistributedPropertySet()

Deprecated.

Method Detail

addSatellite

public void addSatellite(PropertySet satellite)

Deprecated.

addSatellite

public void addSatellite(Class keyClass,
                         PropertySet satellite)

Deprecated.

removeSatellite

public void removeSatellite(PropertySet satellite)

Deprecated.

copySatelliteInto

public void copySatelliteInto(MessageContext r)

Deprecated.