package com.sap.tc.webdynpro.model.webservice.api;
/**
* This interface can be implemented by an application using the Adaptive Web
  Service model in order to modify the web service invocation object just before
  its execution. Invocation modifiers need to be registered with the executable
  model class for which invocation is to be modified.
  */

public interface IWDWSInvocationModifier {
  /**
   * Modification of the invocation is done through Service Extension Interfaces
     offered by the WS-Runtime where instances are created through factories using
     the port parameter passed to this method. Service extension interface
     instances created in this method are only valid for one invocation and must
     not be reused for subsequent invocations.
   * Code sample for modifying the internet proxy used for invocation:
   * <pre>
   *  HTTPControlInterface httpControlIf =
      HTTPControlFactory.getInterface(port);
   *  httpControlIf.setHTTPProxy("proxy", 8080);
   *  httpControlIf.setHTTPProxyUserPass("proxyUser", "proxyPass");
   * </pre>
   * @param port The WS-Runtime invocation port.
   * @see
     com.sap.engine.services.webservices.espbase.client.api.HTTPControlFactory
   * @see
     com.sap.engine.services.webservices.espbase.client.api.HTTPControlInterface
   * @see
     com.sap.engine.services.webservices.espbase.client.api.SOAPHeaderIFactory
   * @see
     com.sap.engine.services.webservices.espbase.client.api.SOAPHeaderInterface
   * @see
     com.sap.engine.services.webservices.espbase.client.api.SessionInterfaceFactory
   * @see
     com.sap.engine.services.webservices.espbase.client.api.SessionInterface
  */
 
  void doModifyInvocation(Object port);
  /**
   * This method can be implemented to call methods on service extension
     interfaces retrieved in the doModifyInvocation(Object) after the invocation
     of the web service.
   */
   void doModifyAfterInvocation();
}