01: /*
02: * BEGIN_HEADER - DO NOT EDIT
03: *
04: * The contents of this file are subject to the terms
05: * of the Common Development and Distribution License
06: * (the "License"). You may not use this file except
07: * in compliance with the License.
08: *
09: * You can obtain a copy of the license at
10: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
11: * See the License for the specific language governing
12: * permissions and limitations under the License.
13: *
14: * When distributing Covered Code, include this CDDL
15: * HEADER in each file and include the License file at
16: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
17: * If applicable add the following below this CDDL HEADER,
18: * with the fields enclosed by brackets "[]" replaced with
19: * your own identifying information: Portions Copyright
20: * [year] [name of copyright owner]
21: */
22:
23: /*
24: * @(#)ServiceEndpoint.java
25: * Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved.
26: *
27: * END_HEADER - DO NOT EDIT
28: */
29: package javax.jbi.servicedesc;
30:
31: import javax.xml.namespace.QName;
32:
33: /**
34: * Reference to an endpoint, used to refer to an endpoint as well as query
35: * information about the endpoint. An endpoint is an addressable entity in the
36: * JBI system, used for accessing the provider of a specific service.
37: *
38: * @author JSR208 Expert Group
39: */
40: public interface ServiceEndpoint {
41: /**
42: * Get a reference to this endpoint, using an endpoint reference vocabulary
43: * that is known to the provider.
44: * @param operationName the name of the operation to be performed by a
45: * consumer of the generated endpoint reference. Set to <code>null</code>
46: * if this is not applicable.
47: * @return endpoint reference as an XML fragment; <code>null</code> if the
48: * provider does not support such references.
49: */
50: org.w3c.dom.DocumentFragment getAsReference(QName operationName);
51:
52: /**
53: * Returns the name of this endpoint.
54: * @return the endpoint name.
55: */
56: String getEndpointName();
57:
58: /**
59: * Get the qualified names of all the interfaces implemented by this
60: * service endpoint.
61: * @return array of all interfaces implemented by this service endpoint;
62: * must be non-null and non-empty.
63: */
64: javax.xml.namespace.QName[] getInterfaces();
65:
66: /**
67: * Returns the service name of this endpoint.
68: * @return the qualified service name.
69: */
70: javax.xml.namespace.QName getServiceName();
71: }
|