SALOMEDS.idl

Go to the documentation of this file.

// Copyright (C) 2007-2026  CEA, EDF, 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, or (at your option) any later version.
//
// 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   : SALOMEDS.idl
//  Author : Yves FRICAUD
//
#ifndef _SALOMEDS_IDL_
#define _SALOMEDS_IDL_
 
#include "SALOME_Exception.idl"
#include "SALOME_GenericObj.idl"
 
module SALOMEDS
{
  typedef wstring URLPath;
 
  typedef string ID;
 
  typedef string PersistentReference;
 
  typedef string SalomeReference;
 
  typedef sequence<string> ListOfFileNames;
  typedef sequence<string> ListOfDates ;
  typedef sequence<string> ListOfStrings ;
  typedef sequence<ListOfStrings> ListOfListOfStrings ;
  typedef sequence<octet> TMPFile;
 
  // Reference to other objects is treated with function AddReference
  // and ReferencedObject
  // All other type of attributes defined in AttributeType enum are
  // treated with AddAdttribute and GetAttribute
  // The difference is made because Reference attribute don't contain
  // strings but reference to ID of other objects
 
  interface GenericAttribute;
  interface Study;
  interface StudyBuilder;
  interface SObject;
  interface SComponent;
  interface SComponentIterator;
  interface ChildIterator;
  interface Driver;
  interface AttributeStudyProperties;
  interface AttributeParameter;
  interface UseCaseIterator;
  interface UseCaseBuilder;
 
  interface Observer
  {
    oneway void notifyObserverID(in string theID, in long event);
  };
 
 
  typedef sequence<GenericAttribute> ListOfAttributes;
 
  exception NotImplemented {};
 
  //==========================================================================
  //==========================================================================
 
  interface StudyBuilder
  {
    exception LockProtection {};
    SComponent NewComponent(in string ComponentDataType) raises(LockProtection);
 
    void       DefineComponentInstance (in SComponent aComponent,in Object ComponentIOR) raises(LockProtection);
 
    void       RemoveComponent(in SComponent aComponent) raises(LockProtection);
 
    SObject NewObject      (in SObject theFatherObject) raises(LockProtection);
 
    SObject NewObjectToTag (in SObject theFatherObject, in long atag) raises(LockProtection);
    void    RemoveObject   (in SObject anObject) raises(LockProtection);
    void    RemoveObjectWithChildren(in SObject anObject) raises(LockProtection);
 
    void  LoadWith (in SComponent sco, in Driver Engine) raises (SALOME::SALOME_Exception);
    void  Load (in SObject sco);
 
    GenericAttribute FindOrCreateAttribute(in  SObject        anObject,
                                         in  string         aTypeOfAttribute) raises(LockProtection);
 
    boolean FindAttribute(in  SObject        anObject,
                                 out GenericAttribute anAttribute,
                                 in  string         aTypeOfAttribute);
    void RemoveAttribute(in  SObject        anObject,
                         in  string         aTypeOfAttribute) raises(LockProtection);
    void Addreference(in SObject anObject,
                      in SObject theReferencedObject) ;
 
    void RemoveReference(in SObject anObject) ;
 
    void SetGUID(in SObject anObject, in string theGUID) raises(LockProtection);
     boolean IsGUID(in SObject anObject, in string theGUID);
 
    void NewCommand(); // command management
    void CommitCommand() raises(LockProtection); // command management
    boolean HasOpenCommand();
    void AbortCommand(); // command management
    attribute long  UndoLimit;
    void Undo() raises (LockProtection);
    void Redo() raises (LockProtection);
    boolean GetAvailableUndos();
    boolean GetAvailableRedos();
    void SetName(in SObject theSO, in string theValue) raises (LockProtection);
 
    void SetComment(in SObject theSO, in string theValue) raises (LockProtection);
 
    void SetIOR(in SObject theSO, in string theValue) raises (LockProtection);
  };
 
  //===========================================================================
  interface Study
  {
 
    exception StudyInvalidReference {};
    exception StudyInvalidComponent {};
    exception StudyInvalidDirectory {};
    exception StudyNameAlreadyUsed {};
    exception StudyObjectAlreadyExists {};
    exception StudyNameError {};
    exception StudyCommentError {};
 
    void ping();
    void Shutdown();
    long getPID();
 
    oneway void ShutdownWithExit();
 
    attribute wstring Name; // equivalent to getName()
 
    typedef sequence<SObject> ListOfSObject;
    PersistentReference  GetPersistentReference() raises(StudyInvalidReference);
 
    boolean IsEmpty() raises(StudyInvalidReference);
    SComponent FindComponent  (in string aComponentName) raises(StudyInvalidReference);
 
    SComponent FindComponentID(in ID aComponentID) raises(StudyInvalidReference);
    SObject       FindObject      (in string anObjectName) raises(StudyInvalidReference);
    SObject       FindObjectID    (in ID aObjectID) raises(StudyInvalidReference);
    SObject       CreateObjectID    (in ID aObjectID) raises(StudyInvalidReference);
    SObject       FindObjectIOR   (in ID aObjectIOR) raises(StudyInvalidReference);
    ListOfSObject FindObjectByName(in string anObjectName, in string aComponentName) raises(StudyInvalidReference);
    SObject FindObjectByPath(in string thePath) raises(StudyInvalidReference);
    string GetObjectPath(in Object theObject) raises(StudyInvalidReference);
 
    ChildIterator NewChildIterator(in SObject aSO) raises(StudyInvalidReference);
 
    SComponentIterator NewComponentIterator() raises(StudyInvalidReference);
 
    StudyBuilder NewBuilder() raises(StudyInvalidReference);
    void UpdateIORLabelMap(in string anIOR, in string anEntry) raises(StudyInvalidReference);
 
    AttributeStudyProperties GetProperties() raises(StudyInvalidReference);
    attribute boolean IsSaved;
    boolean IsModified() raises(StudyInvalidReference);
 
    void Modified() raises(StudyInvalidReference);
 
    attribute wstring URL;
 
    ListOfSObject FindDependances(in SObject anObject) raises(StudyInvalidReference);
 
    string GetLastModificationDate() raises(StudyInvalidReference);
    ListOfDates GetModificationsDate() raises(StudyInvalidReference);
    string ConvertObjectToIOR(in Object theObject);
    Object ConvertIORToObject(in string theIOR);
 
    UseCaseBuilder  GetUseCaseBuilder() raises(StudyInvalidReference);
 
    void Clear() raises(StudyInvalidReference);
 
    void Init() raises(StudyInvalidReference);
 
    boolean Open (in URLPath aStudyUrl) raises (SALOME::SALOME_Exception);
 
    boolean CanOpen (in URLPath aStudyUrl);
 
    boolean Save(in boolean theMultiFile, in boolean theASCII) raises(StudyInvalidReference);
 
    boolean  SaveAs(in URLPath aUrl, // if the file already exists
                    in boolean theMultiFile, // overwrite (as option)
                    in boolean theASCII)
                    raises(StudyInvalidReference);
    boolean CanCopy(in SObject theObject) raises(StudyInvalidReference);
    boolean Copy(in SObject theObject) raises(StudyInvalidReference);
    boolean CanPaste(in SObject theObject) raises(StudyInvalidReference);
    SObject Paste(in SObject theObject) raises (SALOMEDS::StudyBuilder::LockProtection);
 
    void EnableUseCaseAutoFilling(in boolean isEnabled) raises(StudyInvalidReference);
 
    void AddPostponed(in string theIOR) raises(StudyInvalidReference);
 
    void AddCreatedPostponed(in string theIOR) raises(StudyInvalidReference);
 
    void RemovePostponed(in long theUndoLimit) raises(StudyInvalidReference);
 
    void UndoPostponed(in long theWay) raises(StudyInvalidReference);
 
    boolean DumpStudy(in string thePath,
                      in string theBaseName,
                      in boolean isPublished,
                      in boolean isMultiFile) raises(StudyInvalidReference);
 
    string GetDumpPath();
 
    AttributeParameter GetCommonParameters(in string theID, in long theSavePoint) raises(StudyInvalidReference);
 
    AttributeParameter GetModuleParameters(in string theID, in string theModuleName, in long theSavePoint) raises(StudyInvalidReference);
 
 
    string GetDefaultScript(in string theModuleName, in string indent) raises(StudyInvalidReference);
 
    long long GetLocalImpl(in string theHostname, in long thePID, out boolean isLocal);
 
 
    void SetStudyLock(in string theLockerID) raises(StudyInvalidReference);
 
    boolean IsStudyLocked() raises(StudyInvalidReference);
 
    void UnLockStudy(in string theLockerID) raises(StudyInvalidReference);
 
    ListOfStrings GetLockerID() raises(StudyInvalidReference);
 
    void SetReal( in string theVarName, in double theValue ) raises(StudyInvalidReference);
 
    void SetInteger( in string theVarName, in long theValue ) raises(StudyInvalidReference);
    void SetBoolean( in string theVarName, in boolean theValue ) raises(StudyInvalidReference);
 
    void SetString( in string theVarName, in string theValue ) raises(StudyInvalidReference);
 
    void SetStringAsDouble( in string theVarName, in double theValue ) raises(StudyInvalidReference);
 
    double GetReal( in string theVarName ) raises(StudyInvalidReference);
 
    long GetInteger( in string theVarName ) raises(StudyInvalidReference);
 
    boolean GetBoolean( in string theVarName ) raises(StudyInvalidReference);
 
    string GetString( in string theVarName ) raises(StudyInvalidReference);
 
 
    boolean IsReal( in string theVarName ) raises(StudyInvalidReference);
 
    boolean IsInteger( in string theVarName ) raises(StudyInvalidReference);
 
    boolean IsBoolean( in string theVarName ) raises(StudyInvalidReference);
 
    boolean IsString( in string theVarName ) raises(StudyInvalidReference);
 
    boolean IsVariable( in string theVarName ) raises(StudyInvalidReference);
 
    ListOfStrings GetVariableNames() raises(StudyInvalidReference);
 
    boolean RemoveVariable( in string theVarName ) raises(StudyInvalidReference);
 
    boolean RenameVariable( in string theVarName, in string theNewVarName ) raises(StudyInvalidReference);
 
    boolean IsVariableUsed( in string theVarName ) raises(StudyInvalidReference);
 
    ListOfListOfStrings ParseVariables( in string theVars ) raises(StudyInvalidReference);
 
     void attach(in SALOMEDS::Observer theObserver, in boolean modify);
     void detach(in SALOMEDS::Observer theObserver);
  };
 
  //==========================================================================
  //==========================================================================
 
  interface SObject : SALOME::GenericObj
  {
    attribute string Name; // equivalent to setName() & getName()
 
    boolean IsNull();
 
    ID GetID();
 
    SComponent GetFatherComponent();
 
    SObject    GetFather();
 
    short      Tag();
 
    short      GetLastChildTag();
 
    short      Depth();
 
    boolean FindSubObject (in long atag, out SObject obj);
 
    boolean FindAttribute(out GenericAttribute anAttribute,
                                  in  string         aTypeOfAttribute);
 
    boolean ReferencedObject(out SObject obj); // A REVOIR
 
    ListOfAttributes     GetAllAttributes();
 
    Object GetObject();
 
    string GetName();
 
    string GetComment();
 
    string GetIOR();
 
    void SetAttrString(in string name, in string value);
 
    long long GetLocalImpl(in string theHostname, in long thePID, out boolean isLocal);
  };
 
 
  //==========================================================================
  //==========================================================================
  interface GenericAttribute : SALOME::GenericObj
  {
    exception LockProtection {};
    void CheckLocked() raises (LockProtection);
 
    string Type();
 
    string GetClassType();
 
    SObject GetSObject();
 
 
    long long GetLocalImpl(in string theHostname, in long thePID, out boolean isLocal);
  };
 
 
 
  //==========================================================================
  //==========================================================================
  interface SComponent : SObject
  {
    string  ComponentDataType();
    boolean ComponentIOR (out ID theID); //returns True if there is an instance
                                         //In this case ID identifies this one
  };
 
 
  //==========================================================================
  //==========================================================================
  interface SComponentIterator : SALOME::GenericObj
  {
    void Init();
    boolean More();
    void Next();
    SComponent Value();
  };
 
  //==========================================================================
  //==========================================================================
  interface ChildIterator : SALOME::GenericObj
  {
    void Init();
    void InitEx(in boolean allLevels);
    boolean More();
    void Next();
    SObject Value();
  };
 
  //==========================================================================
  //==========================================================================
  interface UseCaseIterator : SALOME::GenericObj
  {
    void Init(in boolean allLevels);
    boolean More();
    void Next();
    SObject Value();
  };
 
  //==========================================================================
  //==========================================================================
  interface UseCaseBuilder : SALOME::GenericObj
  {
    boolean Append(in SObject theObject);
    boolean Remove(in SObject theObject);
    boolean AppendTo(in SObject theFather, in SObject theObject);
    long GetIndexInFather(in SObject theFather, in SObject theObject);
    boolean InsertBefore(in SObject theFirst, in SObject theNext);
    boolean SetCurrentObject(in SObject theObject);
    boolean SetRootCurrent();
    boolean HasChildren(in SObject theObject);
    boolean SortChildren(in SObject theObject, in boolean theAscendingOrder);
    SObject GetFather(in SObject theObject);
    boolean SetName(in string theName);
    string GetName();
    boolean IsUseCase(in SObject theObject);
    boolean IsUseCaseNode(in SObject theObject);
    SObject GetCurrentObject();
    SObject AddUseCase(in string theName);
    UseCaseIterator GetUseCaseIterator(in SObject theObject);
  };
  //==========================================================================
  //==========================================================================
  interface Driver
  {
 
    TMPFile Save(in SComponent theComponent, in string theURL, in boolean isMultiFile);
 
    TMPFile SaveASCII(in SComponent theComponent, in string theURL, in boolean isMultiFile);
 
    boolean Load(in SComponent theComponent, in TMPFile theStream, in string theURL, in boolean isMultiFile);
 
    boolean LoadASCII(in SComponent theComponent, in TMPFile theStream, in string theURL, in boolean isMultiFile);
 
    void Close (in SComponent aSComponent);
    //void Close ( in string  aIORSComponent);
 
     string ComponentDataType();
 
    // Driver Transient -> persistent called for each object in study
    string IORToLocalPersistentID (in SObject theSObject,
                                   in string IORString,
                                   in boolean isMultiFile,
                                   in boolean isASCII);
    string LocalPersistentIDToIOR (in SObject theSObject,
                                   in string aLocalPersistentID,
                                   in boolean isMultiFile,
                                   in boolean isASCII)
      raises (SALOME::SALOME_Exception);
 
    // Publishing in the study
    boolean CanPublishInStudy(in Object theIOR) raises (SALOME::SALOME_Exception);
    SObject PublishInStudy(in SObject theSObject, in Object theObject, in string theName);
 
    // copy/paste methods
 
    boolean CanCopy(in SObject theObject);
    TMPFile CopyFrom(in SObject theObject, out long theObjectID);
    boolean CanPaste(in string theComponentName, in long theObjectID);
    SObject PasteInto(in TMPFile theStream, in long theObjectID, in SObject theObject);
 
  };
};
 
#endif