01: /**
02: * $Id: RemoteServiceStubManager.java,v 1.6 2004/06/28 17:16:51 jtb Exp $
03: * Copyright 2003 Sun Microsystems, Inc. All
04: * rights reserved. Use of this product is subject
05: * to license terms. Federal Acquisitions:
06: * Commercial Software -- Government Users
07: * Subject to Standard License Terms and
08: * Conditions.
09: *
10: * Sun, Sun Microsystems, the Sun logo, and Sun ONE
11: * are trademarks or registered trademarks of Sun Microsystems,
12: * Inc. in the United States and other countries.
13: */package com.sun.portal.wsrp.consumer.common;
14:
15: import java.net.URL;
16:
17: import com.sun.portal.wsrp.common.stubs.WSRP_v1_Markup_PortType;
18: import com.sun.portal.wsrp.common.stubs.WSRP_v1_Registration_PortType;
19: import com.sun.portal.wsrp.common.stubs.WSRP_v1_ServiceDescription_PortType;
20: import com.sun.portal.wsrp.common.stubs.WSRP_v1_PortletManagement_PortType;
21:
22: public interface RemoteServiceStubManager {
23:
24: //
25: // static names defined by WSRP spec.
26: //
27: public final static String WSRP_SERVICE_NAME = "WSRPService";
28: public final static String MARKUP_PORT_BINDING = "WSRP_v1_Markup_Binding_SOAP";
29: public final static String SERVICE_DESCRIPTION_PORT_BINDING = "WSRP_v1_ServiceDescription_Binding_SOAP";
30: public final static String REGISTRATION_PORT_BINDING = "WSRP_v1_Registration_Binding_SOAP";
31: public final static String PORTLET_MANAGEMENT_PORT_BINDING = "WSRP_v1_PortletManagement_Binding_SOAP";
32:
33: public static final boolean FOR_ALL = false;
34: public static final boolean PER_SESSION = true;
35:
36: /**
37: * Get markup port type. Unlike <code>getRegistrationPortType()</code>,
38: * this method will throw an exception if the markup port type is not
39: * available.
40: *
41: * @param endpoint markup port type endpoint
42: * @param isNew a <code>boolean</code> value
43: * @return a <code>WSRP_v1_Markup_PortType</code>
44: * @exception WSRPConsumerException if the markup port type is not available or an error occurs.
45: */
46: public WSRP_v1_Markup_PortType getMarkupPortType(String endpoint,
47: boolean isNew) throws WSRPConsumerException;
48:
49: /**
50: * Get registration port type. If no registration port is available,
51: * return null - this indicates that in-band registration is not
52: * supported and an out-of-band registration is required.
53: *
54: * @param endpoint registration port type endpoint
55: * @return a <code>WSRP_v1_Registration_PortType</code>
56: * @exception WSRPConsumerException if an error occurs
57: */
58: public WSRP_v1_Registration_PortType getRegistrationPortType(
59: String endpoint) throws WSRPConsumerException;
60:
61: /**
62: * Get service description port type. Unlike <code>getRegistrationPortType()</code>,
63: * this method will throw an exception if the service description port
64: * is not available.
65: *
66: * @param endpoint service description endpoint
67: * @return a <code>WSRP_v1_ServiceDescription_PortType</code>
68: * @exception WSRPConsumerException if service description port type is not available or an error occurs.
69: */
70: public WSRP_v1_ServiceDescription_PortType getServiceDescriptionPortType(
71: String endpoint) throws WSRPConsumerException;
72:
73: public WSRP_v1_PortletManagement_PortType getPortletManagementPortType(
74: String endpoint) throws WSRPConsumerException;
75:
76: /**
77: * Get the endpoint of the given port binding from the WSDL.
78: *
79: * @param producerWsdlURL URL of the producer WSDL.
80: * @param portBinding port binding
81: * @return endpoint
82: * @exception WSRPConsumerException if an error occurs
83: */
84: public String getEndpoint(URL producerWsdlURL, String portBinding)
85: throws WSRPConsumerException;
86: }
|