1 /* |
1 /* |
2 * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved. |
2 * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Oracle designates this |
7 * published by the Free Software Foundation. Oracle designates this |
61 * this exception can be thrown to abort the parsing with error. |
61 * this exception can be thrown to abort the parsing with error. |
62 * No further {@link BindingIDFactory} will be consulted, and |
62 * No further {@link BindingIDFactory} will be consulted, and |
63 * {@link BindingID#parse(String)} will throw the exception. |
63 * {@link BindingID#parse(String)} will throw the exception. |
64 */ |
64 */ |
65 public abstract @Nullable BindingID parse(@NotNull String lexical) throws WebServiceException; |
65 public abstract @Nullable BindingID parse(@NotNull String lexical) throws WebServiceException; |
|
66 |
|
67 /** |
|
68 * Creates a {@link BindingID} for given transport and SOAPVersion. |
|
69 * |
|
70 * @return |
|
71 * a non-null return value would cause the JAX-WS RI to consider |
|
72 * the creation to be successful. No furhter {@link BindingIDFactory} |
|
73 * will be consulted. |
|
74 * |
|
75 * <p> |
|
76 * Retruning a null value indicates that this factory doesn't understand |
|
77 * the transport, in which case the JAX-WS RI will keep asking next |
|
78 * {@link BindingIDFactory}. |
|
79 * |
|
80 * @throws WebServiceException |
|
81 * if the implementation understood the transport but it is not correct, |
|
82 * this exception can be thrown to abort the creation with error. |
|
83 * No further {@link BindingIDFactory} will be consulted, and |
|
84 * {@link BindingID#create(String, SOAPVersion)} will throw the exception. |
|
85 */ |
|
86 public @Nullable BindingID create(@NotNull String transport, @NotNull SOAPVersion soapVersion) throws WebServiceException { |
|
87 return null; |
|
88 } |
66 } |
89 } |