com.ibm.twss.spm.admin.svc
Class ServiceAdministrationInterfaceBindingStub

java.lang.Object
  extended by com.ibm.ws.webservices.engine.client.Stub
      extended by com.ibm.twss.spm.admin.svc.ServiceAdministrationInterfaceBindingStub
All Implemented Interfaces:
ServiceAdministrationInterface, java.rmi.Remote, javax.xml.rpc.Stub

public class ServiceAdministrationInterfaceBindingStub
extends com.ibm.ws.webservices.engine.client.Stub
implements ServiceAdministrationInterface

SOAP binding for the service administration interface.


Nested Class Summary
 
Nested classes/interfaces inherited from class com.ibm.ws.webservices.engine.client.Stub
com.ibm.ws.webservices.engine.client.Stub.Invoke
 
Field Summary
 
Fields inherited from class com.ibm.ws.webservices.engine.client.Stub
cachedEndpoint, cachedhttpProxyHost, cachedhttpProxyPassword, cachedhttpProxyPort, cachedhttpProxyUser, cachedhttpRedirectEnabled, cachedhttpsProxyHost, cachedhttpsProxyPassword, cachedhttpsProxyPort, cachedhttpsProxyUser, cachedPassword, cachedPortName, cachedProperties, cachedRequestSoapHeaders, cachedRequestTransportHeaders, cachedResponseSoapHeaders, cachedResponseSoapHeaderTemplates, cachedResponseTransportHeaders, cachedResponseTransportHeadersTemplate, cachedSessionContext, cachedsslCfgName, cachedTimeout, cachedUsername, cachedWriteTimeout, connection, engine, maintainSession, maintainSessionSet, messageContexts, service
 
Fields inherited from interface javax.xml.rpc.Stub
ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, USERNAME_PROPERTY
 
Constructor Summary
ServiceAdministrationInterfaceBindingStub(java.net.URL endpointURL, javax.xml.rpc.Service service)
           
 
Method Summary
 CreateOperationResponse createOperation(CreateOperationRequest request)
          Creates a new operation definition under the specified service name.
 CreateServiceResponse createService(CreateServiceRequest request)
          Creates a new service definition within the hierarchy.
 CreateServiceImplementationResponse createServiceImplementation(CreateServiceImplementationRequest request)
          Create a new service implementation under the specified service.
 FindMatchingServicesResponse findMatchingServices(FindMatchingServicesRequest request)
          Finds all service definitions matching the specified criteria.
 GetAllOperationsResponse getAllOperations(GetAllOperationsRequest request)
          Gets all operation definitions for the specified service.
 GetChildrenResponse getChildren(GetChildrenRequest request)
          Gets all child service definitions for the specified service group.
 GetOperationResponse getOperation(GetOperationRequest request)
          Gets an operation definition for the supplied service and operation name.
 GetParentChainResponse getParentChain(GetParentChainRequest request)
          Gets the chain of parent definitions from the specified service identifier up to the root definition.
 GetServiceResponse getService(GetServiceRequest request)
          Gets the service definition for the specified service name.
 GetServiceImplementationsResponse getServiceImplementations(GetServiceImplementationsRequest request)
          Gets a list of service implementation definitions for the supplied service name.
 RemoveOperationResponse removeOperation(RemoveOperationRequest request)
          Removes an operation from the specified service.
 RemoveServiceResponse removeService(RemoveServiceRequest request)
          Removes the the specified sevice identifier.
 RemoveServiceImplementationResponse removeServiceImplementation(RemoveServiceImplementationRequest request)
          Removes a service implementation definition from the specified service.
 ResolveOperationEnabledResponse resolveOperationEnabled(ResolveOperationEnabledRequest request)
          Performs hierarchical resolution to determine the enablement status of the specified operation.
 ResolveServiceEnabledResponse resolveServiceEnabled(ResolveServiceEnabledRequest request)
          Performs hierarchical resolution to determine the enablement status of the specified service identifier.
 UpdateOperationResponse updateOperation(UpdateOperationRequest request)
          Updates an operation definition.
 UpdateServiceResponse updateService(UpdateServiceRequest request)
          Updates the supplied service definition.
 UpdateServiceImplementationResponse updateServiceImplementation(UpdateServiceImplementationRequest request)
          Updates a service implementation definition.
 
Methods inherited from class com.ibm.ws.webservices.engine.client.Stub
_getProperty, _getPropertyNames, _setProperty, convert, getPassword, getPortName, getTimeout, getTypeMapping, getUsername, primeMessageContext, setMaintainSession, setPassword, setPortName, setPortName, setTimeout, setUsername, setWriteTimeout, validateSoapHeadersHashMap, validateTransportPropertiesHashMap
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ServiceAdministrationInterfaceBindingStub

public ServiceAdministrationInterfaceBindingStub(java.net.URL endpointURL,
                                                 javax.xml.rpc.Service service)
                                          throws com.ibm.ws.webservices.engine.WebServicesFault
Throws:
com.ibm.ws.webservices.engine.WebServicesFault
Method Detail

createService

public CreateServiceResponse createService(CreateServiceRequest request)
                                    throws java.rmi.RemoteException,
                                           ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Creates a new service definition within the hierarchy. Allows for the creation of individual services or service groups. When creating a new service definition, the parent group definition must be provided in order to link the service into the hierarchy. Individual services may not have children. By default, a service that is created will have a corresponding special operation 'ALL'. In addition, individual services will start off with an empty list of associated service implementations.

The service may be an individual service or a service group.

Create service request operation input parameters. Specifies the service definition to create in the service policy manager.

Specified by:
createService in interface ServiceAdministrationInterface
Returns:
Create service response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the supplied service definition is invalid, already exists, or if an internal error occurs.

java.rmi.RemoteException

updateService

public UpdateServiceResponse updateService(UpdateServiceRequest request)
                                    throws java.rmi.RemoteException,
                                           ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Updates the supplied service definition. Only changed values are updated. If optional values are not provided, then they are considered not to have changed. The supplied service definition may refer to either an individual service or a service group.

Update service request operation input parameters. Only the changed values in the supplied definition are considered are updated.

Specified by:
updateService in interface ServiceAdministrationInterface
Returns:
Update service response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the updated definition refers a non-existant service, the update content is invalid, or if an internal error occurs.

java.rmi.RemoteException

getService

public GetServiceResponse getService(GetServiceRequest request)
                              throws java.rmi.RemoteException,
                                     ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets the service definition for the specified service name. May be an individual service or a service group.

Get service request operation input parameters. Specifies the service identifier whose definition to fetch. May be an individual service or a service group.

Specified by:
getService in interface ServiceAdministrationInterface
Returns:
Get service response result. Contains the service definition for the supplied input service identifier.

Throws:
java.rmi.RemoteException
ServicePolicyException

removeService

public RemoveServiceResponse removeService(RemoveServiceRequest request)
                                    throws java.rmi.RemoteException,
                                           ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Removes the the specified sevice identifier. The service may be an individual service or a service group. If the includingChildren flag is set to true, then all service definition children will be removed along with this definition. If this flag is set to false and child definitions exist, then the service definition cannot be removed.

Removing a service will also remove any policies, subscriptions, operations, and service implementations associated with that service. Consider disabling the service status rather than removing the service to preserve that information.

Remove service operation input parameters. Specifies the service to remove. May be an individual service or a service group.

Specified by:
removeService in interface ServiceAdministrationInterface
Returns:
Remove service response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the specified service identifier does not exist, if an attempt was made to remove a definition that contains children without setting the includingChildren flag accordingly, or if an internal error occurs.

java.rmi.RemoteException

createOperation

public CreateOperationResponse createOperation(CreateOperationRequest request)
                                        throws java.rmi.RemoteException,
                                               ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Creates a new operation definition under the specified service name. Operations may only be created under individual services.

Create operation operation input parameters. Specifies the operation definition information to create in the service policy manager.

Specified by:
createOperation in interface ServiceAdministrationInterface
Returns:
Create operation response result. Contains empty content.

Throws:
ServicePolicyException - Raise if the given service does not exist, the given service is a service group, if the given operation already exists, or if an internal error occurs.

java.rmi.RemoteException

updateOperation

public UpdateOperationResponse updateOperation(UpdateOperationRequest request)
                                        throws java.rmi.RemoteException,
                                               ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Updates an operation definition. Only the changed attributes are updated. If an optional attribute is omitted, then it is considered not to have changed. The special 'ALL' operation definition may be updated.

Update operation operation input parameters. Updates the operation definition with the supplied information.

Specified by:
updateOperation in interface ServiceAdministrationInterface
Returns:
Update operation response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the supplied service or operation does not exist, or if an internal error occurs.

java.rmi.RemoteException

getOperation

public GetOperationResponse getOperation(GetOperationRequest request)
                                  throws java.rmi.RemoteException,
                                         ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets an operation definition for the supplied service and operation name. The supplied service may be an individual service or a group. The supplied operation may be the special operation 'ALL'. Service groups will only have the special operation 'ALL' defined.

Get operation operation input parameters. Specifies the operation under what service whose definition to fetch.

Specified by:
getOperation in interface ServiceAdministrationInterface
Returns:
Get operation response result. Returns the operation definition for the specified operation under the specified service.

Throws:
ServicePolicyException - Raised if the supplied service or operation does not exist, or if an internal error occurs.

java.rmi.RemoteException

removeOperation

public RemoveOperationResponse removeOperation(RemoveOperationRequest request)
                                        throws java.rmi.RemoteException,
                                               ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Removes an operation from the specified service. Removing an operation removes all associated policy information and subscriptions associated with that operation. Consider disabling the operation rather than removing the operation to preserve policy and subscription information.

The special operation 'ALL' cannot be removed.

Remove operation operation input parameters. Specifies which operation under what service to remove. The special operation 'ALL' cannot be removed.

Specified by:
removeOperation in interface ServiceAdministrationInterface
Returns:
Remove operation response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the supplied service or operation does not exist, or if an internal error occurs.

java.rmi.RemoteException

createServiceImplementation

public CreateServiceImplementationResponse createServiceImplementation(CreateServiceImplementationRequest request)
                                                                throws java.rmi.RemoteException,
                                                                       ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Create a new service implementation under the specified service. A service implementation must refer to a valid service.

Create service implementation operation input parameters. Creates the service implementation definition in the service policy manager under the specified individual service.

Specified by:
createServiceImplementation in interface ServiceAdministrationInterface
Returns:
Create service implementation response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the supplied service does not exist, the supplied service name corresponds to a service group, the service implementation already exists, or if an internal error occurs.

java.rmi.RemoteException

updateServiceImplementation

public UpdateServiceImplementationResponse updateServiceImplementation(UpdateServiceImplementationRequest request)
                                                                throws java.rmi.RemoteException,
                                                                       ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Updates a service implementation definition. Only the values that have changed are updated. The parent service for a service implementation cannot be updated after creation. Optional fields that are omitted are considered not to have changed.

Update service implementation operation input parameters. Updates all changed definition data in the service policy manager.

Specified by:
updateServiceImplementation in interface ServiceAdministrationInterface
Returns:
Update service implementation response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the supplied service or service implementation does not exist, or if an internal error occurs.

java.rmi.RemoteException

getServiceImplementations

public GetServiceImplementationsResponse getServiceImplementations(GetServiceImplementationsRequest request)
                                                            throws java.rmi.RemoteException,
                                                                   ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets a list of service implementation definitions for the supplied service name. The supplied service must be an individual service and not a service group, as service implementations can only be registered under individual services.

Get sevice implementation operation input parameters. Specifies the service whose service implementations to fetch.

Specified by:
getServiceImplementations in interface ServiceAdministrationInterface
Returns:
Get service implementation response result. Returns a list of all service implementations registered for the specified service.

Throws:
ServicePolicyException - Raised if the supplied service does not exist, is a service group, or if an internal error occurs.

java.rmi.RemoteException

removeServiceImplementation

public RemoveServiceImplementationResponse removeServiceImplementation(RemoveServiceImplementationRequest request)
                                                                throws java.rmi.RemoteException,
                                                                       ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Removes a service implementation definition from the specified service. Removing a service implementation removes corresponding policy information defined at the service implementation scope, and corresponding subscription information. Consider disabling the service implementation rather than removing it in order to preserve policy and subscription information.

Remove service implementation operation input parameters. Specifies the service implementation name, under the which service, to remove from service policy manager.

Specified by:
removeServiceImplementation in interface ServiceAdministrationInterface
Returns:
Remove service implementation response result. Contains empty content.

Throws:
ServicePolicyException - Raised if the specified service or service implementation does not exist, or if an internal error occurs.

java.rmi.RemoteException

resolveServiceEnabled

public ResolveServiceEnabledResponse resolveServiceEnabled(ResolveServiceEnabledRequest request)
                                                    throws java.rmi.RemoteException,
                                                           ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Performs hierarchical resolution to determine the enablement status of the specified service identifier. The service identifier may be an individual service or a service group. The service policy manager will search the hierarchy to determine whether the supplied identifier is enabled. If the service identifier itself or any parent definition along the path up to the root definition in the hierarchy has been disabled, then the specified service identifier is considered disabled.

Resolve service enabled operation input parameters. Specifies the service identifier whose enablement status to resolve.

Specified by:
resolveServiceEnabled in interface ServiceAdministrationInterface
Returns:
Resolve service enabled response result. Returns a boolean indicating the enablement status of the specified service.

Throws:
ServicePolicyException - Raised if the supplied service identifier does not exist, or if an internal error occurs.

java.rmi.RemoteException

resolveOperationEnabled

public ResolveOperationEnabledResponse resolveOperationEnabled(ResolveOperationEnabledRequest request)
                                                        throws java.rmi.RemoteException,
                                                               ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Performs hierarchical resolution to determine the enablement status of the specified operation. The service policy manager will search the hierarchy to determine whether the supplied operation is enabled. If any service higher up in the hierarchy for the parent service of the operation is disabled, or if any parent service's 'ALL' operation is disabled, or if the 'ALL' operation is disabled for the operation's parent service, or if the operation itself is disabled, then the specified operation will be considered disabled.

Resolve operation enabled operation input parameters. Specifies the operation name, under which service, whose enablement status to resolve.

Specified by:
resolveOperationEnabled in interface ServiceAdministrationInterface
Returns:
Resolve operation enable response result. Returns a boolean indicating the enablement status of the specified operation.

Throws:
ServicePolicyException - Raised if the supplied service or operation does not exist, or if an internal error occurs.

java.rmi.RemoteException

findMatchingServices

public FindMatchingServicesResponse findMatchingServices(FindMatchingServicesRequest request)
                                                  throws java.rmi.RemoteException,
                                                         ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Finds all service definitions matching the specified criteria. A pattern can be specified to match different service identifier names, or the search may be restricted to searching under a particular service group in the hierarchy or to a certain type of idenitifer (individual service or service group).

Find matching services operation input parameters. Specifies criteria used to find all matching services while searching the service hierarchy.

Specified by:
findMatchingServices in interface ServiceAdministrationInterface
Returns:
Find matching sevices response result. Returns a list of service definitions that matched the specified criteria. If there are no matches, then an empty list will be returned.

Throws:
ServicePolicyException - Raised if invalid criteria is supplied, or if an internal error occurs.

java.rmi.RemoteException

getAllOperations

public GetAllOperationsResponse getAllOperations(GetAllOperationsRequest request)
                                          throws java.rmi.RemoteException,
                                                 ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets all operation definitions for the specified service. The service may an individual service or a service group.

Get all operations operation input paremeters. Specifies the service whose operations definitions to fetch. May be an individual service or a service group.

Specified by:
getAllOperations in interface ServiceAdministrationInterface
Returns:
Get all operations response result. Returns a list of operation definitions for the specified service.

Throws:
ServicePolicyException - Raised if the specified service does not exist, or if an internal error occurs.

java.rmi.RemoteException

getChildren

public GetChildrenResponse getChildren(GetChildrenRequest request)
                                throws java.rmi.RemoteException,
                                       ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets all child service definitions for the specified service group. An individual service cannot be specified, as it has no children in the service hierarchy. The list of child service definitions may contain both individual services and service groups.

Get children operation input parameters. Specifies the service group whose children to fetch.

Specified by:
getChildren in interface ServiceAdministrationInterface
Returns:
Get children operation response result. Contains a list of service definitions that are the children of the specified service group.

Throws:
ServicePolicyException - Raised if the specified service is an individual service, does not exist, or if an internal error occurs.

java.rmi.RemoteException

getParentChain

public GetParentChainResponse getParentChain(GetParentChainRequest request)
                                      throws java.rmi.RemoteException,
                                             ServicePolicyException
Description copied from interface: ServiceAdministrationInterface
Gets the chain of parent definitions from the specified service identifier up to the root definition. The specified service identifier may be an individual service or a service group. The specified service identifier will not appear in the list. The list of parent definitions will be provided in order of traversing up the hierarchy to the root definition.

Get parent chain operation input parameters. Specifies the service identifier whose parent chain to fetch.

Specified by:
getParentChain in interface ServiceAdministrationInterface
Returns:
Get parent chain operation response result. Returns a list of service definitions, starting from the parent of the specified service up to the root definition.

Throws:
ServicePolicyException - Raised if the specified service identifier does not exist, or if an internal error occurs.

java.rmi.RemoteException


Copyright © IBM Corp. All Rights Reserved.