FME Server C++ API 3.0
|
IFMEServerSession class. More...
#include <ifmeserversession.h>
IFMEServerSession class.
Package Overview:
This defines the entry-point class used to provide access to the fundamental building blocks of FME Server clients to C++ users. It currently provides methods for client access and administration of the Queue Manager.
IFMEServerSession::IFMEServerSession | ( | ) | [inline, protected] |
virtual IFMEServerSession::~IFMEServerSession | ( | ) | [inline, protected, virtual] |
IFMEServerSession::IFMEServerSession | ( | const IFMEServerSession & | other | ) | [private] |
virtual IFMEServerCustomFormat* IFMEServerSession::createCustomFormat | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerCustomFormat. This object must be freed by invoking destroyCustomFormat.
virtual IFMEServerCustomFormatVector* IFMEServerSession::createCustomFormatVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerCustomFormatVector. This object must be freed by invoking destroyCustomFormatVector.
virtual IFMEServerCustomTransformer* IFMEServerSession::createCustomTransformer | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerCustomTransformer. This object must be freed by invoking destroyCustomTransformer.
virtual IFMEServerCustomTransformerVector* IFMEServerSession::createCustomTransformerVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerCustomTransformerVector. This object must be freed by invoking destroyCustomTransformerVector.
virtual IFMEServerFileInfo* IFMEServerSession::createFileInfo | ( | ) | [pure virtual] |
BETA - Preview of the new createFileInfo method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Creates a new instance of IFMEServerFileInfo. This object must be freed by invoking destroyFileInfo.
virtual IFMEServerFileInfoVector* IFMEServerSession::createFileInfoVector | ( | ) | [pure virtual] |
BETA - Preview of the new createFileInfoVector method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Creates a new instance of IFMEServerFileInfoVector. This object must be freed by invoking destroyFileInfoVector.
virtual IFMEServerItemVector* IFMEServerSession::createItemVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerItemVector. This object must be freed by invoking destroyItemVector.
virtual IFMEServerLogFileInfo* IFMEServerSession::createLogFileInfo | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerLogFileInfo. This object must be freed by invoking destroyLogFileInfo.
virtual IFMEServerMountPoint* IFMEServerSession::createMountPoint | ( | ) | [pure virtual] |
BETA - Preview of the new createMountPoint method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Creates a new instance of IFMEServerMountPoint. This object must be freed by invoking destroyMountPoint.
virtual IFMEServerMountPointVector* IFMEServerSession::createMountPointVector | ( | ) | [pure virtual] |
BETA - Preview of the new createMountPointVector method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Creates a new instance of IFMEServerMountPointVector. This object must be freed by invoking destroyMountPointVector.
virtual IFMEServerPropertyAccessor* IFMEServerSession::createPropertyAccessor | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerPropertyAccessor. This object must be freed by invoking destroyPropertyAccessor.
virtual IFMEServerPropertyVector* IFMEServerSession::createPropertyVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerPropertyVector. This object must be freed by invoking destroyWorkspaceServiceVector.
virtual IFMEServerRepository* IFMEServerSession::createRepository | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerRepository. This object must be freed by invoking destroyRepository.
virtual IFMEServerRepositoryVector* IFMEServerSession::createRepositoryVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerRepositoryVector. This object must be freed by invoking destroyRepositoryVector.
virtual IFMEServerResource* IFMEServerSession::createResource | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerResource. This object must be freed by invoking destroyResource.
virtual IFMEServerResourceVector* IFMEServerSession::createResourceVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerResourceVector. This object must be freed by invoking destroyResourceVector.
virtual IFMEServerConnectionInfo* IFMEServerSession::createServerConnectionInfo | ( | const IFMEServerString & | url, |
const IFMEServerString & | userID, | ||
const IFMEServerString & | password | ||
) | [pure virtual] |
Return an IFMEServerConnectionInfo of SOAP connection This object must be freed by invoking destroyServerConnectionInfo.
url | The URL link of the SOAP service |
userID | The user ID used to authenticate. |
password | The password used to authenticate`. |
virtual IFMEServerConnectionInfo* IFMEServerSession::createServerConnectionInfo | ( | const IFMEServerString & | url, |
const IFMEServerStringArray & | directives | ||
) | [pure virtual] |
Return an IFMEServerConnectionInfo of SOAP connection This object must be freed by invoking destroyServerConnectionInfo.
If the SSO_AUTH_DATA directive keyword is specified, then single sign-on authentication will be performed. The value is expected to be a SPNEGO authentication token, as defined in RFC 4559.
url | The URL link of the SOAP service |
directives | The authentication parameters. |
virtual IFMEServerConnectionInfo* IFMEServerSession::createServerConnectionInfo | ( | const IFMEServerString & | host, |
FME_UInt16 | port, | ||
const IFMEServerString & | userID, | ||
const IFMEServerString & | password | ||
) | [pure virtual] |
Return an IFMEServerConnectionInfo This object must be freed by invoking destroyServerConnectionInfo.
host | The host name of the server. |
port | The port on which the server is running. |
userID | The user ID used to authenticate. |
password | The password used to authenticate`. |
virtual IFMEServerConnectionInfo* IFMEServerSession::createServerConnectionInfo | ( | const IFMEServerString & | host, |
FME_UInt16 | port, | ||
const IFMEServerStringArray & | directives | ||
) | [pure virtual] |
Return an IFMEServerConnectionInfo This object must be freed by invoking destroyServerConnectionInfo.
If the SSO_AUTH_DATA directive keyword is specified, then single sign-on authentication will be performed. The value is expected to be a SPNEGO authentication token, as defined in RFC 4559.
host | The host name of the server. |
port | The port on which the server is running. |
directives | The authentication parameters. |
virtual IFMEServerString* IFMEServerSession::createServerString | ( | ) | [pure virtual] |
Creates a new instance of IFMESETLString. This object must be freed by invoking destroySETLString.
virtual IFMEServerStringArray* IFMEServerSession::createServerStringArray | ( | ) | [pure virtual] |
Creates a new instance of IFMESETLStringArray. This object must be freed by invoking destroySETLStringArray.
virtual IFMEServerService* IFMEServerSession::createService | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerService. The service is by default enabled but unnamed. Appropriate setters should be called on the service object. This object must be freed by invoking destroyService.
virtual IFMEServerService* IFMEServerSession::createService | ( | const IFMEServerString & | name, |
const IFMEServerString & | displayName, | ||
const IFMEServerString & | description, | ||
const IFMEServerString & | urlPattern | ||
) | [pure virtual] |
Creates a new instance of IFMEServerService. The service created is by default enabled. This object must be freed by invoking destroyService.
name | the unique name of the new service |
displayName | the display name of the new service |
description | the description of the new service |
urlPattern | the locater pattern of the service |
virtual IFMEServerServiceVector* IFMEServerSession::createServiceVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerServiceVector. This object must be freed by invoking destroyServiceVector.
virtual IFMEServerTemplate* IFMEServerSession::createTemplate | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerTemplate. This object must be freed by invoking destroyTemplate.
virtual IFMEServerTemplateVector* IFMEServerSession::createTemplateVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerTemplateVector. This object must be freed by invoking destroyTemplateVector.
virtual IFMEServerTransformationRequest* IFMEServerSession::createTransformationRequest | ( | const IFMEServerString & | subsectionName, |
const IFMEServerString & | path | ||
) | [pure virtual] |
Creates a new instance of IFMEServerTransformationRequest. No validation is performed on this method's parameters; thus, if the specified subsection name or path does not exist, this will not be discovered until the user attempts to run the transformation.
This object must be freed by invoking destroyTransformationRequest. For a request object configured in this way, getType() == FME_PATH.
subsectionName | The keyword or subsection for this request. |
path | The path to a workspace of mapping file, as seen by the FME Server. This workspace does *not* reside in the repository. All FME Engines must be able to access the workspace file via the filepath as specified. |
virtual IFMEServerTransformationRequest* IFMEServerSession::createTransformationRequest | ( | const IFMEServerString & | subsectionName, |
const IFMEServerString & | repositoryName, | ||
const IFMEServerString & | workspaceName | ||
) | [pure virtual] |
Creates a new instance of IFMEServerTransformationRequest. No validation is performed on this method's parameters; thus, if the specified subsection name or path does not exist, this will not be discovered until the user attempts to run the transformation.
This object must be freed by invoking destroyTransformationRequest. For a request object configured in this way, getType() == FME_PATH.
subsectionName | The name of an FME Engine subsection to be used for this request. |
repositoryName | The name of the repository in which the specified workspace resides. |
workspaceName | The name, including the ".fmw" extension, of the workspace to be used. The name must not include a filepath. Examples: "roads.fmw", "reduceAllParcels.fmw". The workspace must reside in the specified repository. |
virtual IFMEServerTransformationRequest* IFMEServerSession::createTransformationRequest | ( | const IFMEServerString & | subsectionName, |
const IFMEServerString & | repositoryName, | ||
const IFMEServerWorkspace & | workspace | ||
) | [pure virtual] |
Creates a new instance of IFMEServerTransformationRequest. No validation is performed on this method's parameters; thus, if the specified subsection name or path does not exist, this will not be discovered until the user attempts to run the transformation.
This object must be freed by invoking destroyTransformationRequest. For a request object configured in this way, getType() == FME_PATH.
subsectionName | The keyword or subsection for this request. |
repositoryName | The name of the repository in which the workspace object was retrieved from. |
workspace | The workspace object from in the repository |
virtual IFMEServerTransformationResult* IFMEServerSession::createTransformationResult | ( | const IFMEServerString & | fmeServerResponse | ) | [pure virtual] |
Creates a new instance of IFMEServerTransformationResult and uses the created object to parse the given FME Server response string. This object must be freed by invoking destroyTransformationResult.
fmeServerResponse | A valid FME Server response string. |
virtual IFMEServerTransformationResult* IFMEServerSession::createTransformationResult | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerTransformationResult. This object must be freed by invoking destroyTransformationResult.
virtual IFMEServerWorkspace* IFMEServerSession::createWorkspace | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspace. This object must be freed by invoking destroyWorkspace.
virtual IFMEServerWorkspaceService* IFMEServerSession::createWorkspaceService | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspaceService. This object must be freed by invoking destroyWorkspaceService.
virtual IFMEServerWorkspaceServiceVector* IFMEServerSession::createWorkspaceServiceVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspaceServiceVector. This object must be freed by invoking destroyWorkspaceServiceVector.
virtual IFMEServerWorkspaceSummary* IFMEServerSession::createWorkspaceSummary | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspaceSummary. This object must be freed by invoking destroyWorkspaceSummary.
virtual IFMEServerWorkspaceSummaryVector* IFMEServerSession::createWorkspaceSummaryVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspaceSummaryVector. This object must be freed by invoking destroyWorkspaceSummaryVector.
virtual IFMEServerWorkspaceVector* IFMEServerSession::createWorkspaceVector | ( | ) | [pure virtual] |
Creates a new instance of IFMEServerWorkspaceVector. This object must be freed by invoking destroyWorkspaceVector.
virtual void IFMEServerSession::destroyCustomFormat | ( | IFMEServerCustomFormat *& | customFormat | ) | [pure virtual] |
Frees the memory allocated for IFMEServerCustomFormat.
virtual void IFMEServerSession::destroyCustomFormatVector | ( | IFMEServerCustomFormatVector *& | customFormatVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerCustomFormatVector.
virtual void IFMEServerSession::destroyCustomTransformer | ( | IFMEServerCustomTransformer *& | customTransformer | ) | [pure virtual] |
Frees the memory allocated for IFMEServerCustomTransformer.
virtual void IFMEServerSession::destroyCustomTransformerVector | ( | IFMEServerCustomTransformerVector *& | customTransformerVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerCustomTransformerVector.
virtual void IFMEServerSession::destroyFileInfo | ( | IFMEServerFileInfo *& | fileInfo | ) | [pure virtual] |
BETA - Preview of the new destroyFileInfo method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Frees the memory allocated for IFMEServerFileInfo.
virtual void IFMEServerSession::destroyFileInfoVector | ( | IFMEServerFileInfoVector *& | fileInfos | ) | [pure virtual] |
BETA - Preview of the new destroyFileInfoVector method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Frees the memory allocated for IFMEServerFileInfoVector.
virtual void IFMEServerSession::destroyItemVector | ( | IFMEServerItemVector *& | itemVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerItemVector.
virtual void IFMEServerSession::destroyLogFileInfo | ( | IFMEServerLogFileInfo *& | logFileInfo | ) | [pure virtual] |
Frees the memory allocated for IFMEServerService.
virtual void IFMEServerSession::destroyMountPoint | ( | IFMEServerMountPoint *& | mountPoint | ) | [pure virtual] |
BETA - Preview of the new destroyMountPoint method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Frees the memory allocated for IFMEServerMountPoint.
virtual void IFMEServerSession::destroyMountPointVector | ( | IFMEServerMountPointVector *& | mountPoints | ) | [pure virtual] |
BETA - Preview of the new destroyMountPointVector method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Frees the memory allocated for IFMEServerMountPointVector.
virtual void IFMEServerSession::destroyPropertyAccessor | ( | IFMEServerPropertyAccessor *& | propertyAccessor | ) | [pure virtual] |
Frees the memory allocated for IFMEServerPropertyAccessor.
virtual void IFMEServerSession::destroyPropertyVector | ( | IFMEServerPropertyVector *& | propertyVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerPropertyVector.
virtual void IFMEServerSession::destroyRepository | ( | IFMEServerRepository *& | repository | ) | [pure virtual] |
Frees the memory allocated for IFMEServerRepository.
virtual void IFMEServerSession::destroyRepositoryVector | ( | IFMEServerRepositoryVector *& | repositoryVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerRepositoryVector.
virtual void IFMEServerSession::destroyResource | ( | IFMEServerResource *& | resource | ) | [pure virtual] |
Frees the memory allocated for IFMEServerResource.
virtual void IFMEServerSession::destroyResourceVector | ( | IFMEServerResourceVector *& | resourceVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerResourceVector.
virtual void IFMEServerSession::destroyServerConnectionInfo | ( | IFMEServerConnectionInfo *& | pServerConnectionInfo | ) | [pure virtual] |
Frees the memory allocated for IFMEServerConnectionInfo.
virtual void IFMEServerSession::destroyServerStatus | ( | IFMEServerStatus *& | serverStatus | ) | [pure virtual] |
Frees the memory allocated for IFMEServerStatus.
virtual void IFMEServerSession::destroyServerString | ( | IFMEServerString *& | serverString | ) | [pure virtual] |
Frees the memory allocated for IFMESETLString.
virtual void IFMEServerSession::destroyServerStringArray | ( | IFMEServerStringArray *& | serverStringArray | ) | [pure virtual] |
Frees the memory allocated for IFMESETLStringArray.
virtual void IFMEServerSession::destroyService | ( | IFMEServerService *& | service | ) | [pure virtual] |
Frees the memory allocated for IFMEServerService.
virtual void IFMEServerSession::destroyServiceVector | ( | IFMEServerServiceVector *& | serviceVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerServiceVector.
virtual void IFMEServerSession::destroyTemplate | ( | IFMEServerTemplate *& | serverTemplate | ) | [pure virtual] |
Frees the memory allocated for IFMEServerTemplate.
virtual void IFMEServerSession::destroyTemplateVector | ( | IFMEServerTemplateVector *& | templateVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerTemplateVector.
virtual void IFMEServerSession::destroyTransformationRequest | ( | IFMEServerTransformationRequest *& | transformationRequest | ) | [pure virtual] |
Frees the memory allocated for IFMEServerTransformationRequest.
virtual void IFMEServerSession::destroyTransformationResult | ( | IFMEServerTransformationResult *& | transformationResult | ) | [pure virtual] |
Frees the memory allocated for IFMEServerTransformationResult.
virtual void IFMEServerSession::destroyWorkspace | ( | IFMEServerWorkspace *& | workspace | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspace.
virtual void IFMEServerSession::destroyWorkspaceService | ( | IFMEServerWorkspaceService *& | workspaceService | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspaceService.
virtual void IFMEServerSession::destroyWorkspaceServiceVector | ( | IFMEServerWorkspaceServiceVector *& | workspaceServiceVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspaceServiceVector.
virtual void IFMEServerSession::destroyWorkspaceSummary | ( | IFMEServerWorkspaceSummary *& | workspaceSummary | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspaceSummary.
virtual void IFMEServerSession::destroyWorkspaceSummaryVector | ( | IFMEServerWorkspaceSummaryVector *& | workspaceSummaryVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspaceSummaryVector.
virtual void IFMEServerSession::destroyWorkspaceVector | ( | IFMEServerWorkspaceVector *& | workspaceVector | ) | [pure virtual] |
Frees the memory allocated for IFMEServerWorkspaceVector.
virtual IFMEServerStatus* IFMEServerSession::disconnect | ( | ) | [pure virtual] |
Disconnects the session with the FME Server. This should be called when a server session is no longer need to free up resources.
virtual IFMEServerIdentity* IFMEServerSession::getIdentity | ( | ) | [pure virtual] |
Gets the user identity.
If single sign-on authentication is done via init(), then the identity returned is also an IFMEServerSingleSignOnIdentity.
NULL may be returned if, for example, init() has not been called.
virtual IFMEServerMountPointManager* IFMEServerSession::getMountPointManager | ( | ) | [pure virtual] |
BETA - Preview of the new getMountPointManager method. Safe Software reserves the right to release subsequent versions that require changes to applications that use this method.
Gets the mount point manager
virtual IFMEServerStatus* IFMEServerSession::getProperty | ( | const IFMEServerString & | propName, |
IFMEServerString & | propValue | ||
) | [pure virtual] |
Gets the specified property for the current session.
propName | the name of the property to get. |
If SESSION_PROP_ISALIVE property name is specified, then propValue will be "true" if session is alive, otherwise "false" or an error will occur.
If SESSION_PROP_SERVERBUILDVERSION property name is specified, then propValue will be the build string of the connected FME Server.
If SESSION_PROP_SERVERLOCALE property name is specified, then propValue will be the locale string of the connected FME Server.
propValue | the property value for the session. |
virtual IFMEServerRepositoryManager* IFMEServerSession::getRepositoryManager | ( | ) | [pure virtual] |
Gets the repository manager
virtual IFMEServerSecurityManager* IFMEServerSession::getSecurityManager | ( | ) | [pure virtual] |
Gets the security manager
virtual IFMEServerTransformationManager* IFMEServerSession::getTransformationManager | ( | ) | [pure virtual] |
Gets the transformation manager
virtual IFMEServerStatus* IFMEServerSession::init | ( | const IFMEServerConnectionInfo & | connectionInfo, |
const IFMEServerStringArray * | directives | ||
) | [pure virtual] |
Initializes the FME Server session. This method must always be called first.
The directives are reserved for future use. Until they are used, just pass in NULL.
IFMEServerSession& IFMEServerSession::operator= | ( | const IFMEServerSession & | other | ) | [private] |