{@link BindingID} is an immutable object that represents a binding ID,much like how {@link URL} is a representation of an URL.Like {@link URL}, this class offers a bunch of methods that let you query various traits/properties of a binding ID.
{@link BindingID} is extensible; one can plug in a parser from{@link String} to {@link BindingID} to interpret binding IDs thatthe 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, {@link BindingID}instances do not necessarily have singleton semantics. Use {@link #equals(Object)}for the comparison.
{@link WSBinding} is mutable and represents a particular "use" of a {@link BindingID}. As such, it has state like a list of {@link Handler}s, which are inherently local to a particular usage. For example, if you have two proxies, you need two instances. {@link BindingID}, OTOH, is immutable and thus the single instance that represents "SOAP1.2/HTTP" can be shared and reused by all proxies in the same VM. @author Kohsuke Kawaguchi
|
|
|
|
|
|
|
|