Mercurial > jdk8-mips64-public > jaxws / file diff

     1.1 --- a/src/share/jaxws_classes/com/sun/xml/internal/ws/api/BindingIDFactory.java	Thu Apr 04 19:05:24 2013 -0700
     1.2 +++ b/src/share/jaxws_classes/com/sun/xml/internal/ws/api/BindingIDFactory.java	Tue Apr 09 14:51:13 2013 +0100
     1.3 @@ -1,5 +1,5 @@
     1.4  /*
     1.5 - * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
     1.6 + * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
     1.7   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     1.8   *
     1.9   * This code is free software; you can redistribute it and/or modify it
    1.10 @@ -63,4 +63,27 @@
    1.11       *      {@link BindingID#parse(String)} will throw the exception.
    1.12       */
    1.13      public abstract @Nullable BindingID parse(@NotNull String lexical) throws WebServiceException;
    1.14 +
    1.15 +    /**
    1.16 +     * Creates a {@link BindingID} for given transport and SOAPVersion.
    1.17 +     *
    1.18 +     * @return
    1.19 +     *      a non-null return value would cause the JAX-WS RI to consider
    1.20 +     *      the creation to be successful. No furhter {@link BindingIDFactory}
    1.21 +     *      will be consulted.
    1.22 +     *
    1.23 +     *      <p>
    1.24 +     *      Retruning a null value indicates that this factory doesn't understand
    1.25 +     *      the transport, in which case the JAX-WS RI will keep asking next
    1.26 +     *      {@link BindingIDFactory}.
    1.27 +     *
    1.28 +     * @throws WebServiceException
    1.29 +     *      if the implementation understood the transport but it is not correct,
    1.30 +     *      this exception can be thrown to abort the creation with error.
    1.31 +     *      No further {@link BindingIDFactory} will be consulted, and
    1.32 +     *      {@link BindingID#create(String, SOAPVersion)} will throw the exception.
    1.33 +     */
    1.34 +    public @Nullable BindingID create(@NotNull String transport, @NotNull SOAPVersion soapVersion) throws WebServiceException {
    1.35 +        return null;
    1.36 +    }
    1.37  }