SALOME_Component.idl

Go to the documentation of this file.

// Copyright (C) 2007-2012  CEA/DEN, EDF R&D, OPEN CASCADE
//
// Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
//  File   : SALOME_Component.idl
//  Author : Paul RASCLE, EDF

#ifndef _SALOME_COMPONENT_IDL_
#define _SALOME_COMPONENT_IDL_

#include "SALOME_GenericObj.idl"
#include "SALOMEDS.idl"
#include "SALOME_Exception.idl"
#include "SALOME_PyNode.idl"

module Engines
{
  typedef sequence<octet> TMPFile;  
  
  struct KeyValuePair
  {
    string key;
    any value;
  };

  struct dataref
  {
    string ref;
  };

  typedef sequence<KeyValuePair> FieldsDict;

  interface EngineComponent ;
  interface fileRef ;
  interface fileTransfer ;
  interface Salome_file;

  interface Container
  {

    boolean load_component_Library(in string componentName, out string reason);


    Engines::EngineComponent create_component_instance(in string componentName,
                                                       in long studyId);


    Engines::EngineComponent create_component_instance_env(in string componentName,
                                                           in long studyId, in FieldsDict env,
                                                           out string reason);

    EngineComponent find_component_instance(in string registeredName,
                                            in long studyId);


    EngineComponent load_impl(in string nameToRegister,
                              in string componentName);


    void remove_impl(in EngineComponent component_i);

    void finalize_removal() ;

    void ping();

    readonly attribute string name ;

    readonly attribute string workingdir ;

    attribute string logfilename ;

    void Shutdown();

    string getHostName();

    long getPID();


    boolean Kill_impl() ;


    fileRef createFileRef(in string origFileName);


    Salome_file createSalome_file(in string origFileName);


    fileTransfer getFileTransfer();


    void copyFile(in Container contai, in string remoteFile, in string localFile);


    PyNode createPyNode(in string nodeName, in string code)  raises(SALOME::SALOME_Exception);


    PyScriptNode createPyScriptNode(in string nodeName, in string code)  raises(SALOME::SALOME_Exception);
  };

  interface EngineComponent
  {
    readonly attribute string instanceName ;

    readonly attribute string interfaceName ;

    void ping();


    long getStudyId();


    void destroy() ;

    Container GetContainerRef() ;


    void setProperties(in FieldsDict dico);


    FieldsDict getProperties();


    void SetOption(in string optionName, in string value);


    string GetOption(in string optionName);


    void Names( in string aGraphName , in string aNodeName ) ;


    boolean Kill_impl() ;


    boolean Stop_impl() ;


    boolean Suspend_impl() ;


    boolean Resume_impl() ;


    long CpuUsed_impl() ;
    

    TMPFile DumpPython(in Object theStudy,
                       in boolean isPublished,
                       in boolean isMultiFile,
                       out boolean isValidScript);

    

    Engines::Salome_file getInputFileToService(in string service_name, 
                                               in string Salome_file_name) raises(SALOME::SALOME_Exception);


    void checkInputFilesToService(in string service_name)           raises(SALOME::SALOME_Exception);


    Engines::Salome_file setInputFileToService(in string service_name,
                                               in string Salome_file_name)   raises(SALOME::SALOME_Exception);


    Engines::Salome_file getOutputFileToService(in string service_name, 
                                                in string Salome_file_name) raises(SALOME::SALOME_Exception);


    void checkOutputFilesToService(in string service_name)        raises(SALOME::SALOME_Exception);


    Engines::Salome_file setOutputFileToService(in string service_name,
                                                in string Salome_file_name)  raises(SALOME::SALOME_Exception);


    boolean hasObjectInfo();
    

    string getObjectInfo(in long studyId, in string entry);
  } ;

  interface ImportableComponent
  {
    SALOME::StringSeq GetImportableFormats();
    boolean           ImportDataAs(in string format, in SALOME::GenericObj exporter);
  };

  typedef sequence<octet> fileBlock;

  interface fileTransfer : SALOME::GenericObj
  {

    long open(in string fileName);

    long openW(in string fileName);


    void close(in long fileId);


    fileBlock getBlock(in long fileId);


    void putBlock(in long fileId, in fileBlock block);

  };

  struct file {
    string file_name;
    string path; 
    string type;
    string source_file_name;
    string status; 
    long   node;
    Engines::Container container;
  };

  typedef sequence<Engines::file> files;


  struct SfState {
    string  name; 
    string  hdf5_file_name; 
    long    number_of_files; 
    boolean files_ok; 

  };

  interface Salome_file : Engines::fileTransfer
  {

    void load(in string hdf5_file)                            raises (SALOME::SALOME_Exception);


    void save(in string hdf5_file)                            raises (SALOME::SALOME_Exception);


    void save_all(in string hdf5_file)                            raises (SALOME::SALOME_Exception);

/**************/


    void setLocalFile(in string comp_file_name) raises (SALOME::SALOME_Exception);


    void setDistributedFile(in string comp_file_name) raises (SALOME::SALOME_Exception);


    void connect(in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);


    void connectDistributedFile(in string file_name,
                                in Engines::Salome_file source_Salome_file) raises (SALOME::SALOME_Exception);
    

    void setDistributedSourceFile(in string file_name,
                                  in string source_file_name) raises (SALOME::SALOME_Exception);

/**************/


    void recvFiles()                                            raises (SALOME::SALOME_Exception) ;

/**************/


    void removeFile(in string file_name)                    raises (SALOME::SALOME_Exception);

    void removeFiles();

/**************/


    Engines::files getFilesInfos();


    Engines::file  getFileInfos(in string file_name) raises (SALOME::SALOME_Exception);

    Engines::SfState getSalome_fileState();



    void setContainer(in Engines::Container container);
  };

  interface fileRef
  {
    readonly attribute string origFileName;
    readonly attribute string refMachine;

    Container getContainer();

    boolean addRef(in string machine,
                   in string fileName);

    string getRef(in string machine);
  };
};

#endif