19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.xml.internal.ws.api;
  27 
  28 import com.sun.istack.internal.Nullable;
  29 import com.sun.istack.internal.NotNull;
  30 
  31 import javax.xml.ws.WebServiceException;
  32 
  33 /**
  34  * Extension point to plug in additional {@link BindingID} parsing logic.
  35  *
  36  * <p>
  37  * When the JAX-WS RI is asked to parse a binding ID string into a {@link BindingID}
  38  * object, it uses service idiom to look for the implementations of this class
  39  * in the <tt>META-INF/services/...</tt>.
  40  *
  41  * @since JAX-WS 2.0.next
  42  * @author Kohsuke Kawaguchi
  43  * @see BindingID#parse(String)
  44  */
  45 public abstract class BindingIDFactory {
  46     /**
  47      * Parses a binding ID string into {@link BindingID} if possible.
  48      *
  49      * @return
  50      *      a non-null return value would cause the JAX-WS RI to consider
  51      *      the parsing to be successful. No furhter {@link BindingIDFactory}
  52      *      will be consulted.
  53      *
  54      *      <p>
  55      *      Retruning a null value indicates that this factory doesn't understand
  56      *      this string, in which case the JAX-WS RI will keep asking next
  57      *      {@link BindingIDFactory}.
  58      *
  59      * @throws WebServiceException

  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.xml.internal.ws.api;
  27 
  28 import com.sun.istack.internal.Nullable;
  29 import com.sun.istack.internal.NotNull;
  30 
  31 import javax.xml.ws.WebServiceException;
  32 
  33 /**
  34  * Extension point to plug in additional {@link BindingID} parsing logic.
  35  *
  36  * <p>
  37  * When the JAX-WS RI is asked to parse a binding ID string into a {@link BindingID}
  38  * object, it uses service idiom to look for the implementations of this class
  39  * in the {@code META-INF/services/...}.
  40  *
  41  * @since JAX-WS 2.0.next
  42  * @author Kohsuke Kawaguchi
  43  * @see BindingID#parse(String)
  44  */
  45 public abstract class BindingIDFactory {
  46     /**
  47      * Parses a binding ID string into {@link BindingID} if possible.
  48      *
  49      * @return
  50      *      a non-null return value would cause the JAX-WS RI to consider
  51      *      the parsing to be successful. No furhter {@link BindingIDFactory}
  52      *      will be consulted.
  53      *
  54      *      <p>
  55      *      Retruning a null value indicates that this factory doesn't understand
  56      *      this string, in which case the JAX-WS RI will keep asking next
  57      *      {@link BindingIDFactory}.
  58      *
  59      * @throws WebServiceException