ContainerInterface 类

成员函数说明

[信号] void ContainerInterface::errorOccured(ContainerInterface::ProcessError processError)

当容器内的进程发生错误时，需要发出此信号。指定的processError描述了发生的错误类型。

另请参阅QProcess::errorOccurred。

[信号] void ContainerInterface::finished(int exitCode, ContainerInterface::ExitStatus exitStatus)

当容器内的进程完成时，必须发出此信号。参数exitStatus表示进程退出的原因 - 在正常退出的情况下，exitCode将是进程main()函数的返回值。

另请参阅QProcess::finished。

[信号] void ContainerInterface::ready()

如果容器实现需要在后台进行可能昂贵的初始化工作，则可以实现通知应用程序管理器在发出此信号后将调用start()。

如果不需要这样做，则无需发出此信号，但应始终从isReady返回true。

另请参阅isReady。

[信号] void ContainerInterface::started()

当容器内的进程开始并state()返回QProcess::Running时，必须发出此信号。

另请参阅QProcess::started。

[信号] void ContainerInterface::stateChanged(ContainerInterface::RunState state)

每当容器内进程的状态变化时，需要发出此信号。

[纯虚] bool ContainerInterface::attachApplication(const QVariantMap &application)

应用程序管理器调用此函数，当需要将application附加到此容器实例时：该application映射与从ApplicationManager::get()方法返回的应用程序元数据非常相似

这些字段对于此函数不可用

这些字段是在ApplicationManager::get()方法提供的基础上添加的

[纯虚] QString ContainerInterface::controlGroup() const

此函数需要返回容器的控制组。该函数返回的控制组名称不是操作系统使用的低级名称，而是一个抽象名称。有关如何设置此映射的更多详细信息，请参阅容器文档。

另请参阅：setControlGroup()。

[纯虚] bool ContainerInterface::isReady() const

如果容器准备启动应用程序的程序则为true，否则为false。

另请参阅：ready()。

[纯虚] void ContainerInterface::kill()

当应用程序管理器希望终止容器内的当前进程并立即退出时，将调用此函数。

在Unix上，等效操作会发送SIGKILL信号。

另请参阅：terminate()。

[纯虚] QString ContainerInterface::mapContainerPathToHost(const QString &containerPath) const

每当需要在应用程序容器的文件系统命名空间与应用程序管理器之间映射路径时，应用程序管理器将调用此函数。

如果两者都在同一命名空间中运行，您可以简单返回containerPath。

[纯虚] QString ContainerInterface::mapHostPathToContainer(const QString &hostPath) const

每当需要在应用程序管理器的文件系统命名空间与应用程序容器之间映射路径时，应用程序管理器将调用此函数。

如果两者都在同一命名空间中运行，您可以简单返回hostPath。

[纯虚] qint64 ContainerInterface::processId() const

如果可用，应返回运行进程的原生进程标识符，否则返回0。

[纯虚函数] void ContainerInterface::setBaseDirectory(const QString &baseDirectory)

由应用程序管理器调用以设置容器内部进程的初始工作目录为baseDirectory。

[纯虚函数] bool ContainerInterface::setControlGroup(const QString &groupName)

此函数预期将应用程序的容器移动到控制组中。《i>groupName不是操作系统使用的底层名称，而是一个抽象。有关如何设置此映射的详细信息，请参见容器文档。如果调用成功返回true，否则返回false。

另请参阅：controlGroup。

[纯虚函数] bool ContainerInterface::setProgram(const QString &program)

由应用程序管理器调用以设置启动进程时将执行的program。在start()调用之前将调用此函数。如果program在此容器内有效则需要返回true，否则返回false。

另请参阅：start。

[纯虚函数] bool ContainerInterface::start(const QStringList &arguments, const QMap<QString, QString> &runtimeEnvironment, const QVariantMap &amConfig)

将调用此函数以异步启动由setProgram()设置的程序，并带有额外的命令行arguments和来自runtimeEnvironment的额外环境变量。

runtimeEnvironment是环境变量和它们的值的字符串映射。映射中的空值表示，应由其键表示的环境变量被取消设置。本地运行时将默认定义这些变量

amConfig地图是一组设置，由应用管理器传递给程序。相同的字符串已经编码在runtimeEnvironment中的AM_CONFIG环境变量内，但在容器插件中重新解析这个YAML片段将非常麻烦。

这些是当前在amConfig中定义的字段

应用管理器只为任何给定实例调用此函数一次。

此函数应返回true代表成功，否则返回false。如果返回true，实现需要根据此调用发出started()或errorOccurred()信号（可以延迟）。

也参见QProcess::start。

[纯虚函数] ContainerInterface::RunState ContainerInterface::state() const

这个函数需要返回容器内进程的当前状态。

也参见stateChanged，errorOccured，和QProcess::state。

[纯虚函数] void ContainerInterface::terminate()

当应用管理器尝试终止容器内的进程时，会被调用。

此函数的调用可能会导致进程不会退出。在Unix上，其等效操作是发送SIGTERM信号。

也参见kill。