com.thingworx.system.subsystems

Class Subsystem

java.lang.Object

com.thingworx.types.NamedObject

com.thingworx.persistence.common.PersistableNamedObject

com.thingworx.entities.RootEntity

com.thingworx.entities.ServiceProviderEntity

com.thingworx.entities.ExtensibleRootEntity

com.thingworx.system.subsystems.Subsystem

All Implemented Interfaces:

IConfigurableObject, INotScriptFriendly, IDiffableObject, IAvatar, IEntityLifeCycleEvent, IPersistable, IServiceProvider, ITaggableObject, IDependencyScannableObject, IEntityDefinition, IPersistableObject<java.lang.String>, IDesignTimeSecurable, IDesignTimeSecurableEntity, IRunTimeSecurable, IRunTimeSecurableEntity, ISecurable, IVisibilitySecurable, IVisibilitySecurableEntity, IAspectContainer, INamedObject, java.io.Serializable

Direct Known Subclasses:

PlatformSubsystem, SCIMSubsystem, UserManagementSubsystem

@ThingworxExtensionApiClass(since={6,6},
                            canExtendOrImplement=true)
public class Subsystem
extends ExtensibleRootEntity

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_AUTOSTART
static boolean	DEFAULT_ENABLED
static java.lang.String	METRICS_DATA_SHAPE

Fields inherited from class com.thingworx.entities.RootEntity

BASIC_PROPERTIES

Fields inherited from class com.thingworx.types.NamedObject

NAME_COMPARATOR

Constructor Summary

Constructors

Constructor and Description
Subsystem()

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDependsOn()
RelationshipTypes.ThingworxRelationshipTypes	getEntityType()
java.lang.String	getFriendlyName()
InfoTable	GetPerformanceMetrics() Service Category: Service Description: Get information on how the subsystem is performing.
protected InfoTable	getSubsystemPerformanceMetrics()
SubsystemState	getSubsystemState()
java.lang.String	GetSubsystemState() Service Category: Monitoring Service Description: Get the subscriber state.
protected void	initializeSubsystem()
boolean	isAutoStart()
boolean	isEnabled()
boolean	isRunning()
java.lang.Boolean	IsRunning() Service Category: Lifecycle Service Description: Check the run status of this subsystem.
void	ResetPerformanceMetrics() Service Category: Service Description: Get information on how the subsystem is performing.
protected void	resetSubsystemPerformanceMetrics()
void	Restart() Service Category: Lifecycle Service Description: Stops and restarts the sub-system.
void	setAutoStart(boolean autoStart)
void	setDependsOn(java.lang.String value)
void	setFriendlyName(java.lang.String value)
void	setRunning(boolean value)
void	Start() Service Category: Lifecycle Service Description: Starts the sub-system.
protected void	startSubsystem()
void	Stop() Service Category: Lifecycle Service Description: Stops the sub-system.
protected void	stopSubsystem()

Methods inherited from class com.thingworx.entities.ServiceProviderEntity

getInstancePublicServiceDefinitions, getInstanceServiceDefinition, getInstanceServiceDefinitions, initializeEntity, preInitializeEntity, processAPIServiceRequest, processServiceRequest

Methods inherited from class com.thingworx.entities.RootEntity

AddConfigurationTableDefinition, addDesignTimePermission, AddDesignTimePermission, addRunTimePermission, AddRunTimePermission, AddTags, addVisibilityPermission, AddVisibilityPermission, CheckDesignTimePermission, CheckDesignTimePermissionForGroup, CheckDesignTimePermissionForUser, CheckPermission, CheckPermissionForGroup, CheckPermissionForUser, cleanupEntity, cleanupEntity, DeleteAllConfigurationTableRows, DeleteConfigurationTable, DeleteConfigurationTableRows, deleteDesignTimePermission, DeleteDesignTimePermission, deleteRunTimePermission, DeleteRunTimePermission, deleteVisibilityPermission, DeleteVisibilityPermission, dispose, getAspects, GetAvatar, getAvatarContent, GetAvatarURL, GetConfigurationChangeHistory, getConfigurationSetting, getConfigurationTable, GetConfigurationTable, GetConfigurationTableDefinition, GetConfigurationTableRow, GetConfigurationTables, GetDescription, getDesignTimePermissions, GetDesignTimePermissions, GetDesignTimePermissionsAsJSON, getDocumentationContent, getEntityTypeAsString, GetEventDefinition, GetEventDefinitions, GetHomeMashup, GetIncomingDependencies, GetIncomingDependenciesAsNetwork, GetInstanceMetadataAsJSON, GetInstanceMetadataWithPermissionsAsJSON, GetLastModifiedDate, GetMetadata, GetMetadataAsJSON, GetMetadataWithPermissionsAsJSON, GetOutgoingDependencies, GetOutgoingDependenciesAsNetwork, getOwner, GetPermissionsForCurrentUser, GetPermissionsForGroup, GetPermissionsForUser, GetProjectName, GetPropertyDefinition, GetPropertyDefinitions, getRunTimePermissions, GetRunTimePermissions, GetRunTimePermissionsAsJSON, GetServiceDefinition, GetServiceDefinitions, getStringConfigurationSetting, getStringConfigurationSettingWithDefault, GetSummaryInformation, getTags, GetTags, GetTagsAsInfoTable, getVisibilityPermissions, GetVisibilityPermissions, GetVisibilityPermissionsAsJSON, HasIncomingDependencies, HasOutgoingDependencies, isEditable, isEditableExtensionObject, isEditableSystemObject, isExtensionObject, IsMultiRowTable, isOwner, isSystemObject, isThemeObject, isVisible, isVisible, persistDesignTimePermissions, persistRunTimePermissions, persistVisibilityPermissions, RemoveTags, SaveConfigurationTables, SetAvatar, setConfigurationSetting, SetConfigurationTable, SetConfigurationTableRows, SetDescription, setDesignTimePermissions, SetDesignTimePermissionsAsJSON, setDocumentationContent, setExtensionObject, SetHomeMashup, setLastModifiedDate, SetMultiRowConfigurationTable, setOwner, SetOwner, SetProjectName, setRunTimePermissions, SetRunTimePermissionsAsJSON, setStringConfigurationSetting, SetTags, setVisibilityPermissions, SetVisibilityPermissionsAsJSON, toJSON, toJSONDefinition, validateConfiguration

Methods inherited from class com.thingworx.persistence.common.PersistableNamedObject

getID, hasID, isTransient

Methods inherited from class com.thingworx.types.NamedObject

getDescription, getName, setDescription, setName, toValueCollection

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

getID, hasID

Methods inherited from interface com.thingworx.types.INamedObject

getDescription, getName

Methods inherited from interface com.thingworx.security.permissions.ISecurable

getID, getName

Field Detail

METRICS_DATA_SHAPE

public static final java.lang.String METRICS_DATA_SHAPE

See Also:

Constant Field Values

DEFAULT_ENABLED

public static final boolean DEFAULT_ENABLED

See Also:

Constant Field Values

DEFAULT_AUTOSTART

public static final boolean DEFAULT_AUTOSTART

See Also:

Constant Field Values

Constructor Detail

Subsystem

@ThingworxExtensionApiMethod(since={6,6})
public Subsystem()

Method Detail

isEnabled

@ThingworxExtensionApiMethod(since={6,6})
public boolean isEnabled()

getFriendlyName

@ThingworxExtensionApiMethod(since={6,6})
public java.lang.String getFriendlyName()

setFriendlyName

@ThingworxExtensionApiMethod(since={6,6})
public void setFriendlyName(java.lang.String value)

getSubsystemState

@ThingworxExtensionApiMethod(since={6,6})
public SubsystemState getSubsystemState()

initializeSubsystem

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true)
protected void initializeSubsystem()
                                                                                                                     throws java.lang.Exception

Throws:

java.lang.Exception - If an error occurs

startSubsystem

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true)
protected void startSubsystem()
                                                                                                                throws java.lang.Exception

Throws:

java.lang.Exception - If an error occurs

stopSubsystem

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true)
protected void stopSubsystem()
                                                                                                               throws java.lang.Exception

Throws:

java.lang.Exception - If an error occurs

Start

@ThingworxExtensionApiMethod(since={6,6})
public void Start()
                                                     throws java.lang.Exception

Service Category:

Lifecycle

Service Description:

Starts the sub-system.

Throws:

java.lang.Exception - If an error occurs

Stop

@ThingworxExtensionApiMethod(since={6,6})
public void Stop()
                                                    throws java.lang.Exception

Service Category:

Lifecycle

Service Description:

Stops the sub-system.

Throws:

java.lang.Exception - If an error occurs

IsRunning

@ThingworxExtensionApiMethod(since={6,6})
public java.lang.Boolean IsRunning()
                                                                      throws java.lang.Exception

Service Category:

Lifecycle

Service Description:

Check the run status of this subsystem.

Returns:

result Run status - BOOLEAN

Throws:

java.lang.Exception - If an error occurs

Restart

@ThingworxExtensionApiMethod(since={6,6})
public void Restart()
                                                       throws java.lang.Exception

Service Category:

Lifecycle

Service Description:

Stops and restarts the sub-system.

Throws:

java.lang.Exception - If an error occurs

GetSubsystemState

@ThingworxExtensionApiMethod(since={6,6})
public java.lang.String GetSubsystemState()
                                                                             throws java.lang.Exception

Service Category:

Monitoring

Service Description:

Get the subscriber state.

Returns:

result Current subscriber state - STRING

Throws:

java.lang.Exception - If an error occurs

GetPerformanceMetrics

@ThingworxExtensionApiMethod(since={6,6})
public InfoTable GetPerformanceMetrics()
                                                                          throws java.lang.Exception

Service Category:

Service Description:

Get information on how the subsystem is performing.

Returns:

result Performance metrics - INFOTABLE - Aspects {dataShape:ThingworxMetric}

Throws:

java.lang.Exception - If an error occurs

ResetPerformanceMetrics

@ThingworxExtensionApiMethod(since={6,6})
public void ResetPerformanceMetrics()
                                                                       throws java.lang.Exception

Service Category:

Service Description:

Get information on how the subsystem is performing.

Throws:

java.lang.Exception - If an error occurs

getSubsystemPerformanceMetrics

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true)
protected InfoTable getSubsystemPerformanceMetrics()
                                                                                                                                     throws java.lang.Exception

Throws:

java.lang.Exception - If an error occurs

resetSubsystemPerformanceMetrics

@ThingworxExtensionApiMethod(since={6,6},
                             canOverride=true)
protected void resetSubsystemPerformanceMetrics()

isRunning

@ThingworxExtensionApiMethod(since={6,6})
public boolean isRunning()

setRunning

@ThingworxExtensionApiMethod(since={6,6})
public void setRunning(boolean value)

getDependsOn

@ThingworxExtensionApiMethod(since={6,6})
public java.lang.String getDependsOn()

setDependsOn

@ThingworxExtensionApiMethod(since={6,6})
public void setDependsOn(java.lang.String value)

isAutoStart

@ThingworxExtensionApiMethod(since={6,6})
public boolean isAutoStart()

setAutoStart

@ThingworxExtensionApiMethod(since={6,6})
public void setAutoStart(boolean autoStart)

getEntityType

@ThingworxExtensionApiMethod(since={6,6})
public RelationshipTypes.ThingworxRelationshipTypes getEntityType()

Description copied from class: RootEntity

Returns the type of this entity.

Specified by:

getEntityType in class RootEntity

Returns:

the entity type