com.plumtree.server
Interface IPTWebService

All Superinterfaces:
IPTLocalizable, IPTObject, IPTUnknown

public interface IPTWebService
extends IPTObject

This interface wraps access to a specific web service instance. A web service object contains common settings and methods used by all types of web services in the portal, including portlets, AWS, CWS, SWS, PWS, etc.

See Also:
IPTGadgetContentServer

Method Summary
 java.lang.String GetAbsoluteURL(java.lang.String bstrSettingName)
          Constructs an absolute URL relative to the remote server base URL from a ProviderInfo setting.
 int GetCardSubmitType()
          Gets the type of CardSubmission a web service supports.
 java.lang.String GetDisabledMessage()
          Get the message to show when the web service has been disabled.
 boolean GetEnabled()
          Get the status of the web service, enabled or disabled.
 java.lang.String GetProviderCLSID()
          Needed by Web Service Editor to support Web Service types.
 com.plumtree.openfoundation.util.IXPPropertyBag GetProviderInfo()
          Get additional provider-specific settings.
 int GetRemoteServerID()
          Get the remote server associated with this web service.
 int GetSupportsPersonalization()
          Flag set by the web service creator that indicates whether or not this web service allows personalization.
 boolean GetSupportsUserInterface(java.lang.String bstrUserInterfaceName)
          Indicates whether this web service supports a particular user interface.
 java.lang.Object[] GetUserInterfaces()
          Gets the UserInterfaces a web service supports.
 void SetCardSubmitType(int Value)
          Sets the type of CardSubmission a web service supports.
 void SetDisabledMessage(java.lang.String Value)
          Set the message to show when the web service has been disabled.
 void SetEnabled(boolean Value)
          Set the status of the web service, enabled or disabled.
 void SetProviderCLSID(java.lang.String Value)
          Needed by Web Service Editor to support Web Service types.
 void SetProviderInfo(com.plumtree.openfoundation.util.IXPPropertyBag Value)
          Set additional provider-specific settings.
 void SetProviderInfo(java.lang.String Value)
          Set additional provider-specific settings.
 void SetRemoteServerID(int Value)
          Set the remote server associated with this web service.
 void SetSupportsPersonalization(int Value)
          Flag set by the web service creator that indicates whether or not this web service allows personalization.
 void SetupHTTPRequest(java.lang.Object pHttpRequestParallel, IPTSSOInfo pSSOInfo)
          Sets the basic auth headers on an IPTHttpRequestParallel.
 void SetUserInterfaces(java.lang.Object[] Value)
          Deprecated.  
 void SetUserInterfaces(java.lang.String[] Value)
          Sets the UserInterfaces a web service supports.
 
Methods inherited from interface com.plumtree.server.IPTObject
GetAdminFolderID, GetClassID, GetCreated, GetImageUUID, GetLastModified, GetObjectProperties, SetAdminFolderID, SetImageUUID, SetLastModified
 
Methods inherited from interface com.plumtree.server.IPTLocalizable
GetDescription, GetIsLocalized, GetLocalizedDescription, GetLocalizedDescriptions, GetLocalizedName, GetLocalizedNames, GetName, GetPrimaryLang, GetSupportsLocalization, SetDescription, SetIsLocalized, SetLocalizedDescriptions, SetLocalizedNames, SetName, SetPrimaryLang
 
Methods inherited from interface com.plumtree.server.IPTUnknown
GetInterfaces
 

Method Detail

GetEnabled

public boolean GetEnabled()
Get the status of the web service, enabled or disabled. You should set a web service to disabled before taking it offline for routine maintainence or upgrades.
Returns:
True if enabled.

SetEnabled

public void SetEnabled(boolean Value)
Set the status of the web service, enabled or disabled. You should set a web service to disabled before taking it offline for routine maintainence or upgrades.
Parameters:
Value - true if enabled.

GetDisabledMessage

public java.lang.String GetDisabledMessage()
Get the message to show when the web service has been disabled.
Returns:
The message.

SetDisabledMessage

public void SetDisabledMessage(java.lang.String Value)
Set the message to show when the web service has been disabled.
Parameters:
Value - the message.

GetProviderInfo

public com.plumtree.openfoundation.util.IXPPropertyBag GetProviderInfo()
Get additional provider-specific settings.
Returns:
The format varies by provider.

SetProviderInfo

public void SetProviderInfo(com.plumtree.openfoundation.util.IXPPropertyBag Value)
Set additional provider-specific settings.
Parameters:
Value - the format varies by provider.

SetProviderInfo

public void SetProviderInfo(java.lang.String Value)
Set additional provider-specific settings.
Parameters:
Value - a property bag serialized to XML.

GetRemoteServerID

public int GetRemoteServerID()
Get the remote server associated with this web service. OPTIONAL: ID 0 indicates that no remote server is associated with this web service
Returns:
The ID of a remote server object.

SetRemoteServerID

public void SetRemoteServerID(int Value)
Set the remote server associated with this web service. OPTIONAL: ID 0 indicates that no remote server is associated with this web service
Parameters:
Value - the ID of a remote server object.

GetUserInterfaces

public java.lang.Object[] GetUserInterfaces()
Gets the UserInterfaces a web service supports.
Returns:
Array of user interface URIs.

SetUserInterfaces

public void SetUserInterfaces(java.lang.String[] Value)
Sets the UserInterfaces a web service supports.
Parameters:
Value - array of user interface URIs.

SetUserInterfaces

public void SetUserInterfaces(java.lang.Object[] Value)
Deprecated.  

Sets the UserInterfaces a web service supports.
Parameters:
Value - array of user interface URIs.

GetCardSubmitType

public int GetCardSubmitType()
Gets the type of CardSubmission a web service supports.
Returns:
See PT_WEBSERVICE_CARDSUBMIT_TYPES.

SetCardSubmitType

public void SetCardSubmitType(int Value)
Sets the type of CardSubmission a web service supports.
Parameters:
Value - see PT_WEBSERVICE_CARDSUBMIT_TYPES.

GetProviderCLSID

public java.lang.String GetProviderCLSID()
Needed by Web Service Editor to support Web Service types.
Returns:
CLSID of the provider.

SetProviderCLSID

public void SetProviderCLSID(java.lang.String Value)
Needed by Web Service Editor to support Web Service types.
Parameters:
Value - CLSID of the provider.

GetSupportsPersonalization

public int GetSupportsPersonalization()
Flag set by the web service creator that indicates whether or not this web service allows personalization.
Returns:
Bitmasked int of PT_GADGETPERSONALIZATION_ROLES.

SetSupportsPersonalization

public void SetSupportsPersonalization(int Value)
Flag set by the web service creator that indicates whether or not this web service allows personalization.
Parameters:
Value - bitmasked int of PT_GADGETPERSONALIZATION_ROLES.

SetupHTTPRequest

public void SetupHTTPRequest(java.lang.Object pHttpRequestParallel,
                             IPTSSOInfo pSSOInfo)
Sets the basic auth headers on an IPTHttpRequestParallel.
Parameters:
pHttpRequestParallel - the request object.
pSSOInfo - optional, can be null, but required for per-user basic auth.

GetAbsoluteURL

public java.lang.String GetAbsoluteURL(java.lang.String bstrSettingName)
Constructs an absolute URL relative to the remote server base URL from a ProviderInfo setting.
Parameters:
bstrSettingName - the name of the relative URL in ProviderInfo.
Returns:
The URL.

GetSupportsUserInterface

public boolean GetSupportsUserInterface(java.lang.String bstrUserInterfaceName)
Indicates whether this web service supports a particular user interface.
Parameters:
bstrUserInterfaceName - the URI of a user interface.
Returns:
True if this user interface is supported.


Copyright © 2003 Plumtree Software Inc. All Rights Reserved.