com.sun.xml.ws.api

This package hosts classes/interfaces that directly extend the JAX-WS API.

BindingID is an immutable object that represents a binding ID, much like how URL is a representation of an URL. Like URL , this class offers a bunch of methods that let you query various traits/properties of a binding ID.

BindingID is extensible; one can plug in a parser from String to BindingID to interpret binding IDs that the JAX-WS RI does no a-priori knowledge of. Technologies such as Tango uses this to make the JAX-WS RI understand binding IDs defined in their world. Such technologies are free to extend this class and expose more characterstics.

Even though this class defines a few well known constants, BindingID instances do not necessarily have singleton semantics.

This implementation allows one PropertySet to assemble all properties exposed from other "satellite" PropertySet s. (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.

Conceptually this can be really thought of as an URI , but it hides some of the details that improve the performance.

Being an URI allows this class to represent custom made-up URIs (like "jms" for example.) Whenever possible, this object also creates an URL (this is only possible when the address has a registered URLStreamHandler ), so that if the clients of this code wants to use it, it can do so.

How it improves the performance

1. Endpoint address is often eventually turned into an URLConnection , and given that generally this value is read more often than being set, it makes sense to eagerly turn it into an URL , thereby avoiding a repeated conversion.
2. JDK spends a lot of time choosing a list of Proxy to connect to an URL .

This annotation should be used on a constructor of classes extending WebServiceFeature other than Spec defined features, to help JAX-WS runtime recognize feature extensions.

For WebServiceFeature annotations to be recognizable by JAX-WS runtime, the feature annotation should point to a corresponding bean (class extending WebServiceFeature).

This abstract class is used only to improve the static type safety of the JAX-WS internal API.

The class name intentionally doesn't include "Delegate", because the fact that it's a delegate is a detail of the JSR-224 API, and for the layers above us this object nevertheless represents Service .