src/share/jaxws_classes/com/sun/xml/internal/ws/api/BindingIDFactory.java

changeset 368
0989ad8c0860
parent 286
f50545b5e2f1
child 637
9c07ef4934dd
equal deleted inserted replaced
366:8c0b6bccfe47 368:0989ad8c0860
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 }

mercurial