ServiceControl Interface

Base interface for all Service controls.

# Syntax

    package weblogic.jws.control;

    public interface ServiceControl extends Control

# Remarks

The methods of this interface may be invoked by any web service with a Service control instance.

# Members

## Constructors

String getConversationID()

Retreives the conversation ID of the current conversation with this Service control instance.

Element[] getInputHeaders()

Retrieves the SOAP headers that were included in the most recent arriving callback from the Service control.

String getPassword()

Retrieves the password string that was set by the most recent call to setPassword.

String getUsername()

Retrieves the username string that was set by the most recent call to setUsername.

void reset()

Clears all parameters that were set by previous calls to setConversationID, setOutputHeaders, setPassword or setUsername.

void setConversationID(String conversationID)

Sets the unique key that will be proposed as the conversation ID when initiating a conversation with the Service control.

Note: WebLogic Workshop automatically computes a conversation ID when a WebLogic web service invokes a start method of a Service control. You may use this function to override the automatic value. The only case where it is useful to do so is if you supply the conversation ID of an existing conversation that is currently ongoing on the target web service. You may then invoke methods on the target service that will execute in the context of the specified conversation. However, only the client that originated the conversation may receive callbacks.

void setEndPoint(URL url)

Sets the callback URL that the Service control instance will use it as the base URL for callback invocations. This is set automatically by WebLogic Workshop. You may use this function to override the callback URL if you wish callbacks to be sent to a different destination.

void setOutputHeaders(Element[] headers)

Sets the SOAP headers that will be included in the next outgoing method invocation message to the Service control.

void setPassword(String password)

Sets the password that will be sent with the next outgoing Service control method invocation. Used if the Service control uses HTTP basic authentication.

void setUsername(String username)

Sets the username that will be sent with the next outgoing Service control method invocation. Used if the Service control uses HTTP basic authentication.

## Fields

None.

## Events

None.

Related Topics

Service Control: Using Another Web Service