Class DTGatewayInterface
- java.lang.Object
-
- com.inductiveautomation.ignition.designer.gateway.DTGatewayInterface
-
- All Implemented Interfaces:
GatewayConstants
public class DTGatewayInterface extends java.lang.Object implements GatewayConstants
This is the designer interface to the gateway, which defines various designer-only function to deal with the gateway
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
DTGatewayInterface.DatasourceInfo
-
Field Summary
-
Fields inherited from interface com.inductiveautomation.ignition.common.gateway.GatewayConstants
_DATE_FORMATTER, ARG_MESSAGETYPE, ARG_MODULEID, ATR_INDEX, ATR_LENGTH, ATR_NAME, ATR_TYPE, booleanNull, byteNull, charNull, CONNECT_TIMEOUT, DATE_FORMAT_STRING, doubleNull, ELM_ARG, ELM_COLLIST, ELM_COLUMN, ELM_COMPRESSEDROWS, ELM_DATA, ELM_ERRORCODE, ELM_ERRORMESSAGE, ELM_EXCLS, ELM_EXMSG, ELM_EXOVERRIDES_TOSTRING, ELM_EXSTRING, ELM_MBODY, ELM_MESSAGE, ELM_MTYPE, ELM_NOTIFICATION, ELM_NOTIFICATIONS, ELM_RESPONSE, ELM_ROW, ELM_ROWS, ELM_SERIALIZED_RESPONSE, ELM_SETCOOKIE, ELM_STACKTRACE, ELM_STELM, ELM_STELM_DECL, ELM_STELM_FILE, ELM_STELM_LINE, ELM_STELM_METH, ERRNO_ASYNC_CALL, ERRNO_ASYNC_CALL_CANCELED, ERRNO_ASYNC_CALL_FAILED, ERRNO_BROWSE_ERROR, ERRNO_COMM_ERROR, ERRNO_CONNECTION_MODE, ERRNO_DBCONNECTION_NAMING, ERRNO_DBCONNECTION_SQL, ERRNO_HISTORY_QUERY_ERROR, ERRNO_INSECURE_REDIRECT, ERRNO_INTERNAL, ERRNO_INVALIDARGS, ERRNO_INVOCATION_EXCEPTION, ERRNO_LICENE_RESTRICTED, ERRNO_LOGIN_CANCELLED, ERRNO_LOGIN_FAILED, ERRNO_LOGIN_FAILED_LICENSING, ERRNO_NAMING, ERRNO_NO_SESSION, ERRNO_NON_ACTIVE_NODE, ERRNO_NON_MASTER_NODE, ERRNO_NOT_AUTHORIZED, ERRNO_NOTIMP, ERRNO_OK, ERRNO_PARSE, ERRNO_PASSWORD_EXPIRED, ERRNO_PONG, ERRNO_POST_ERROR, ERRNO_PROJECT_PULL, ERRNO_PROJECT_PUSH, ERRNO_RUNTIME_EXPIRED, ERRNO_SQL, ERRNO_SQLTAGS_PROVIDER_DISABLED, ERRNO_SQLTAGS_PROVIDER_FAULTED, ERRNO_SQLTAGS_PROVIDER_LOADING, ERRNO_SQLTAGS_PROVIDER_MISSING, ERRNO_SQLTAGS_SEND_TAGS, ERRNO_SSL_REQUIRED, ERRNO_TIMEOUT, ERRNO_TRIAL_EXPIRED, ERRNO_VERSION_INCOMPATABILITY, ERROR_MESSAGE_TYPE, floatNull, intNull, longNull, MODE_DISCONNECTED, MODE_FULL, MODE_READ_ONLY, MTYPE_COPY_IMAGE, MTYPE_CREATE_IMAGE_FOLDER, MTYPE_DBTEST, MTYPE_GET_NEW_RESOURCEID, MTYPE_INVALID, MTYPE_INVOKE_FUNCTION, MTYPE_LIST_AUTHS, MTYPE_LIST_COLS, MTYPE_LIST_DBS, MTYPE_LIST_IDPS, MTYPE_LIST_IMAGES, MTYPE_LIST_MODULES, MTYPE_LIST_ROLES, MTYPE_LIST_SECURITY_LEVELS, MTYPE_LIST_SQLTAG_PROVIDERS, MTYPE_LIST_TABLES, MTYPE_LIST_ZONES, MTYPE_PING, MTYPE_PLATFORM_EDITION, MTYPE_PUBLIC_PING, MTYPE_REMOVE_IMAGE, MTYPE_RENAME_IMAGE_FOLDER, MTYPE_REPORT_ERROR, MTYPE_SEND_EMAIL, MTYPE_SQLTAGS_ADD_SCANCLASS, MTYPE_SQLTAGS_ADD_TAGS, MTYPE_SQLTAGS_EDIT_SCANCLASS, MTYPE_SQLTAGS_EDIT_TAGS, MTYPE_SQLTAGS_ERROR_LIST, MTYPE_SQLTAGS_FSQL_BROWSE, MTYPE_SQLTAGS_FSQL_LIST, MTYPE_SQLTAGS_GET_SCANCLASS, MTYPE_SQLTAGS_LIST, MTYPE_SQLTAGS_META_LIST, MTYPE_SQLTAGS_POLL, MTYPE_SQLTAGS_REMOVE_SCANCLASS, MTYPE_SQLTAGS_REMOVE_TAGS, MTYPE_SQLTAGS_WRITE, MTYPE_STATUS_POLL, MTYPE_UPLOAD_IMAGE, MTYPE_VERSION_CHECK, OPC_BROWSE_TIMEOUT, PROTECT_DIALOG_TYPE, shortNull, SOCKET_TIMEOUT, WARNING_MESSAGE_TYPE
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
DTGatewayInterface()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
copyImage(java.awt.Component dlg, java.lang.String dest, java.lang.String[] paths)
void
createImageFolder(java.awt.Component dlg, java.lang.String name, java.lang.String parent)
void
createProject(java.awt.Component frame, java.lang.String projectName, ProjectManifest manifest, java.util.List<ProjectResource> resources)
java.util.List<java.lang.String>
getAuditProfiles(java.awt.Component owner)
AuthenticationStrategy
getAuthenticationStrategy()
java.util.Map<java.lang.String,java.lang.Long>
getAuthProfiles(java.awt.Component owner)
Dataset
getColumnList(java.awt.Component owner, java.lang.String datasource, java.lang.String tablename)
Deprecated.Silently blocks the EDT with a modal dialog.Dataset
getColumnList(java.lang.String datasource, java.lang.String tablename)
Returns a dataset where each row represents a column in the table.java.util.Map<java.lang.String,DTGatewayInterface.DatasourceInfo>
getDatasources(java.awt.Component owner)
GlobalProps
getExistingGlobalProps(java.lang.String projectName)
IdpAdapterMeta[]
getIdps(java.awt.Component owner)
Dataset
getImageList(java.awt.Component dlg, java.lang.String folder)
static DTGatewayInterface
getInstance()
java.util.List<java.lang.String>
getProjectList(java.awt.Component dlg)
java.lang.String[]
getRoles(java.awt.Component owner)
com.google.common.collect.ImmutableCollection<SecurityLevelConfig>
getSecurityLevels(java.awt.Component owner)
java.lang.String[]
getTableList(java.awt.Component owner, java.lang.String datasource)
Deprecated.Prefer callinggetTableList(String)
in a SwingWorker for true async.java.lang.String[]
getTableList(java.lang.String datasource)
Fetches the list of tables indatasource
java.util.List<java.lang.String>
getTagProviders(java.awt.Component owner)
java.util.Map<java.lang.String,ProjectManifest>
getValidProjectManifests()
java.lang.String[]
getZones(java.awt.Component owner)
RuntimeProject
loadProject(java.lang.String projectName)
Note - loads synchronouslyvoid
removeImage(java.awt.Component dlg, java.lang.String[] paths)
void
renameImageFolder(java.awt.Component dlg, java.lang.String from, java.lang.String dest)
Dataset
runQuery(java.awt.Component frame, java.lang.String query, java.lang.String dsn)
Dataset
runQuery(java.awt.Component frame, java.lang.String query, java.lang.String dsn, int limit)
java.lang.String
saveProjectAs(java.awt.Component frame, java.lang.String newName, ProjectManifest manifest, java.util.List<ProjectResource> resources)
void
uploadImage(java.awt.Component dlg, java.lang.String name, java.lang.String desc, java.lang.String type, java.lang.String parentDir, int width, int height, byte[] data)
-
-
-
Method Detail
-
getInstance
public static DTGatewayInterface getInstance()
-
getDatasources
public java.util.Map<java.lang.String,DTGatewayInterface.DatasourceInfo> getDatasources(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getTagProviders
public java.util.List<java.lang.String> getTagProviders(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getAuthProfiles
public java.util.Map<java.lang.String,java.lang.Long> getAuthProfiles(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getIdps
public IdpAdapterMeta[] getIdps(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getSecurityLevels
public com.google.common.collect.ImmutableCollection<SecurityLevelConfig> getSecurityLevels(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getAuthenticationStrategy
public AuthenticationStrategy getAuthenticationStrategy() throws GatewayException
- Throws:
GatewayException
-
getAuditProfiles
public java.util.List<java.lang.String> getAuditProfiles(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getTableList
@Deprecated(since="8.1.27") public java.lang.String[] getTableList(java.awt.Component owner, java.lang.String datasource) throws GatewayException
Deprecated.Prefer callinggetTableList(String)
in a SwingWorker for true async.Fetches the list of tables indatasource
- Parameters:
owner
- The component invoking this action; used as the basis for the automatic UI that will be displayed if this task takes longer than 3 seconds.- Returns:
- A sorted array of table names in the specified datasource.
- Throws:
GatewayException
- If there's any issue communicating with the gateway
-
getTableList
public java.lang.String[] getTableList(java.lang.String datasource) throws GatewayException
Fetches the list of tables indatasource
- Returns:
- A sorted array of table names in the specified datasource.
- Throws:
GatewayException
- If there's any issue communicating with the gateway
-
getColumnList
@Deprecated(since="8.1.27") public Dataset getColumnList(java.awt.Component owner, java.lang.String datasource, java.lang.String tablename) throws GatewayException
Deprecated.Silently blocks the EDT with a modal dialog. Prefer callinggetColumnList(String, String)
from a SwingWorker.Returns a dataset where each row represents a column in the table. The rows are:- column_name (name of column)
- data_type (type code from java.sql.Types)
- type_name (database dependent name of type)
- column_size (precision/length)
- primary_key (boolean indicating key status)
- indexed (boolean indicating index status)
- Throws:
GatewayException
-
getColumnList
public Dataset getColumnList(java.lang.String datasource, java.lang.String tablename) throws GatewayException
Returns a dataset where each row represents a column in the table. The rows are:- column_name (name of column)
- data_type (type code from java.sql.Types)
- type_name (database dependent name of type)
- column_size (precision/length)
- primary_key (boolean indicating key status)
- indexed (boolean indicating index status)
- Throws:
GatewayException
-
runQuery
public Dataset runQuery(java.awt.Component frame, java.lang.String query, java.lang.String dsn) throws GatewayException
- Throws:
GatewayException
-
runQuery
public Dataset runQuery(java.awt.Component frame, java.lang.String query, java.lang.String dsn, int limit) throws GatewayException
- Throws:
GatewayException
-
getProjectList
public java.util.List<java.lang.String> getProjectList(java.awt.Component dlg) throws GatewayException
- Throws:
GatewayException
-
getValidProjectManifests
public java.util.Map<java.lang.String,ProjectManifest> getValidProjectManifests() throws GatewayException
- Throws:
GatewayException
-
createImageFolder
public void createImageFolder(java.awt.Component dlg, java.lang.String name, java.lang.String parent) throws GatewayException
- Throws:
GatewayException
-
removeImage
public void removeImage(java.awt.Component dlg, java.lang.String[] paths) throws GatewayException
- Throws:
GatewayException
-
copyImage
public void copyImage(java.awt.Component dlg, java.lang.String dest, java.lang.String[] paths) throws GatewayException
- Throws:
GatewayException
-
renameImageFolder
public void renameImageFolder(java.awt.Component dlg, java.lang.String from, java.lang.String dest) throws GatewayException
- Throws:
GatewayException
-
uploadImage
public void uploadImage(java.awt.Component dlg, java.lang.String name, java.lang.String desc, java.lang.String type, java.lang.String parentDir, int width, int height, byte[] data) throws GatewayException
- Throws:
GatewayException
-
getImageList
public Dataset getImageList(java.awt.Component dlg, java.lang.String folder) throws GatewayException
- Throws:
GatewayException
-
saveProjectAs
public java.lang.String saveProjectAs(java.awt.Component frame, java.lang.String newName, ProjectManifest manifest, java.util.List<ProjectResource> resources) throws GatewayException
- Throws:
GatewayException
-
createProject
public void createProject(java.awt.Component frame, java.lang.String projectName, ProjectManifest manifest, java.util.List<ProjectResource> resources) throws GatewayException
- Throws:
GatewayException
-
loadProject
public RuntimeProject loadProject(java.lang.String projectName) throws java.lang.Exception
Note - loads synchronously- Parameters:
projectName
- the project name- Throws:
java.lang.Exception
- on failure to load project
-
getExistingGlobalProps
@Nullable public GlobalProps getExistingGlobalProps(java.lang.String projectName) throws java.lang.Exception
- Throws:
java.lang.Exception
-
getRoles
public java.lang.String[] getRoles(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
getZones
public java.lang.String[] getZones(java.awt.Component owner) throws GatewayException
- Throws:
GatewayException
-
-