Package com.thingworx.entities.interfaces

Interface IServiceProvider

All Superinterfaces:

INamedObject, IPersistable

All Known Implementing Classes:

AlertServices, ApplicationKey, Authenticator, CacheThing, CollectionsServices, ContentLoader, CSVFileServices, CustomAuthenticator, DashboardFunctions, DataShape, DataTableThing, DataThing, DataThingWithEvents, DeviceFunctions, DirectoryService, EncryptionServices, EntityServices, ExtensibleRootEntity, ExtensionPackage, FileRepositoryThing, Group, InfoTableFunctions, LocalizationTable, LogRetrievalStrategy, MediaEntity, Menu, Network, NotificationHandler, Organization, PlatformSubsystem, Project, QueueProvider, RemoteThing, RemoteThingWithFileTransfer, RemoteThingWithTunnels, RemoteThingWithTunnelsAndFileTransfer, ReportingStrategy, Resource, RuntimeLocalizationFunctions, SCIMSubsystem, ScriptServices, Searcher, SecurityClaimsAuthenticator, SecurityMonitorThing, SecurityServices, ServiceProviderEntity, SessionInfo, SourceControlFunctions, StreamThing, Subsystem, SubsystemMonitoring, Thing, ThingShape, ThingTemplate, User, UserManagementSubsystem, Vocabulary

@ThingworxExtensionApiClass(since={6,6})
public interface IServiceProvider
extends IPersistable

Method Summary

Modifier and Type	Method	Description
ServiceDefinitionCollection	getInstancePublicServiceDefinitions()
ServiceDefinition	getInstanceServiceDefinition(String serviceName)
ServiceDefinitionCollection	getInstanceServiceDefinitions()
InfoTable	processAPIServiceRequest(String serviceName, ValueCollection params)	Processes a service request invoked via the REST API.
InfoTable	processServiceRequest(String serviceName, ValueCollection params)	Processes an internal or reflected service request.

Methods inherited from interface com.thingworx.types.INamedObject

getDescription, getName

Methods inherited from interface com.thingworx.entities.interfaces.IPersistable

getID, hasID

Method Details

processServiceRequest

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true,
                             requiresSuper=true)
InfoTable processServiceRequest(String serviceName,
 ValueCollection params)
                         throws Exception

Processes an internal or reflected service request. Entities may call this method if they wish to invoke a service call directly on an entity. This method performs a service invoke authorization check against the current security context.

Parameters:

serviceName - - The name of the service to invoke

params - - A collection of parameter mappings

Returns:

The results of the service invocation

Throws:

Exception - If the security check fails, the service does not exist, or an error occurred during the execution of the service

processAPIServiceRequest

@ThingworxExtensionApiMethod(since={7,2,0},
                             canOverride=true,
                             requiresSuper=true)
InfoTable processAPIServiceRequest(String serviceName,
 ValueCollection params)
                            throws Exception

Processes a service request invoked via the REST API. This method performs a service invoke authorization check against the current security context.

Parameters:

serviceName - - The name of the service to invoke

params - - A collection of parameter mappings

Returns:

The results of the service invocation

Throws:

Exception - If the security check fails, the service does not exist, or an error occurred during the execution of the service

getInstanceServiceDefinition

@ThingworxExtensionApiMethod(since={6,6})
ServiceDefinition getInstanceServiceDefinition(String serviceName)

getInstanceServiceDefinitions

@ThingworxExtensionApiMethod(since={6,6})
ServiceDefinitionCollection getInstanceServiceDefinitions()

getInstancePublicServiceDefinitions

@ThingworxExtensionApiMethod(since={6,6})
ServiceDefinitionCollection getInstancePublicServiceDefinitions()