Deprecated API

Contents

• For Removal
• Interfaces
• Classes
• Methods

For Removal

Element	Description
org.jetbrains.mps.openapi.language.SLanguage.getLanguageRuntimes()	SLanguage is an identity object, use LanguageRuntime#getRuntimeModules() instead
org.jetbrains.mps.openapi.module.SModuleListenerBase
org.jetbrains.mps.openapi.module.SRepositoryListener.repositoryCommandFinished(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.repositoryCommandStarted(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.updateFinished(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.updateStarted(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListenerBase
org.jetbrains.mps.openapi.persistence.MultiStreamDataSource.getAvailableStreams()	use MultiStreamDataSource.getSubStreams()
org.jetbrains.mps.openapi.persistence.PersistenceFacade.addNavigationParticipant(NavigationParticipant)	see PersistenceFacade.getNavigationParticipants()
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getNavigationParticipants()	No reason to keep this in PersistenceComponent, NavigationParticipant API is cumbersome. Need a replacement API.
org.jetbrains.mps.openapi.persistence.PersistenceFacade.removeNavigationParticipant(NavigationParticipant)	see PersistenceFacade.getNavigationParticipants()

Interfaces

Interface	Description
org.jetbrains.mps.openapi.language.SPrimitiveDataType	Use one of SPrimitiveTypes
org.jetbrains.mps.openapi.model.SModelScope
org.jetbrains.mps.openapi.module.RepositoryAccess

Classes

Class	Description
org.jetbrains.mps.openapi.module.SModuleListenerBase
org.jetbrains.mps.openapi.module.SRepositoryListenerBase

Methods

Method	Description
org.jetbrains.mps.openapi.language.SAbstractConcept.getDeclarationNode()
org.jetbrains.mps.openapi.language.SAbstractConcept.getQualifiedName()
org.jetbrains.mps.openapi.language.SAbstractLink.getRole()	use SNamedElement.getName()
org.jetbrains.mps.openapi.language.SAbstractLink.isReference()	boolean limits API to two link kinds possible
org.jetbrains.mps.openapi.language.SContainmentLink.getDeclarationNode()
org.jetbrains.mps.openapi.language.SContainmentLink.getRoleName()
org.jetbrains.mps.openapi.language.SLanguage.getLanguageRuntimes()	SLanguage is an identity object, use LanguageRuntime#getRuntimeModules() instead
org.jetbrains.mps.openapi.language.SLanguage.getLanguageVersion()
org.jetbrains.mps.openapi.language.SProperty.getDeclarationNode()
org.jetbrains.mps.openapi.language.SReferenceLink.getDeclarationNode()
org.jetbrains.mps.openapi.language.SReferenceLink.getRoleName()	use SNamedElement.getName() instead Returns a name of this reference Though in 3.2 the name is still used as id in some cases, it should be treated only as a user-friendly text representation.
org.jetbrains.mps.openapi.language.SReferenceLink.isMultiple()
org.jetbrains.mps.openapi.model.EditableSModel.updateTimestamp()	use #save(new SaveOptionsBuilder().force().build()) instead
org.jetbrains.mps.openapi.model.SModel.getModelName()	Prefer SModel.getName() with access to distinct fractions of the name
org.jetbrains.mps.openapi.model.SNode.addChild(String, SNode)	use addChild(SContainmentLink, SNode), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.getChildren(String)	use getChildren(SContainmentLink), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.getProperty(String)	use getProperty(SProperty), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.getPropertyNames()	use getProperties()
org.jetbrains.mps.openapi.model.SNode.getReference(String)	use getReference(SReferenceLink), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.getReferenceTarget(String)	use getReferenceTarget(SReferenceLink), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.getRoleInParent()	use getContainmentLink()
org.jetbrains.mps.openapi.model.SNode.hasProperty(String)	use hasProperty(SProperty), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.insertChildBefore(String, SNode, SNode)	use insertChildBefore(SContainmentLink, SNode, SNode), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.setProperty(String, String)	use setProperty(SProperty), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNode.setReference(SReferenceLink, SReference)	cumbersome api, use explicit #dropReference() for null case, or another method that doesn't require construction of an object with source/link already specified.
org.jetbrains.mps.openapi.model.SNode.setReferenceTarget(String, SNode)	use setReferenceTarget(SReferenceLink, SNode), or jetbrains.mps.smodel.SNodeLegacy for compatibility code
org.jetbrains.mps.openapi.model.SNodeAccessUtil.getProperty(SNode, SProperty)	This method returns serialized property value. Consider use SNodeAccessUtil.setPropertyValue(SNode, SProperty, Object) that supplies values as is
org.jetbrains.mps.openapi.model.SNodeAccessUtil.hasProperty(SNode, String)
org.jetbrains.mps.openapi.model.SNodeAccessUtil.setProperty(SNode, SProperty, String)	This method takes serialized property value. Consider use SNodeAccessUtil.setPropertyValue(SNode, SProperty, Object) that consumes values as is
org.jetbrains.mps.openapi.model.SNodeAccessUtil.setReference(SNode, String, SReference)
org.jetbrains.mps.openapi.model.SNodeAccessUtil.setReferenceTarget(SNode, String, SNode)
org.jetbrains.mps.openapi.model.SReference.getRole()	use SReference.getLink() to identify reference role, or to access its name
org.jetbrains.mps.openapi.module.FacetsFacade.getInstance()	Use respective ComponentPlugin (i.e. MPSCore) to obtain instance of the registry.
org.jetbrains.mps.openapi.module.FindUsagesFacade.findInstances(SearchScope, Set<? extends SAbstractConcept>, boolean, ProgressMonitor)	please use more general version below. consider using jetbrains.mps.util.CollectConsumer if you need to recreate the old behavior.
org.jetbrains.mps.openapi.module.FindUsagesFacade.findModelUsages(SearchScope, Set<SModelReference>, ProgressMonitor)	please use more general version below. consider using jetbrains.mps.util.CollectConsumer if you need to recreate the old behavior.
org.jetbrains.mps.openapi.module.FindUsagesFacade.findUsages(SearchScope, Set<SNode>, ProgressMonitor)	please use more general version below. consider using jetbrains.mps.util.CollectConsumer if you need to recreate the old behavior.
org.jetbrains.mps.openapi.module.SRepository.getParent()
org.jetbrains.mps.openapi.module.SRepository.getRepositoryAccess()
org.jetbrains.mps.openapi.module.SRepositoryListener.repositoryCommandFinished(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.repositoryCommandStarted(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.updateFinished(SRepository)
org.jetbrains.mps.openapi.module.SRepositoryListener.updateStarted(SRepository)
org.jetbrains.mps.openapi.persistence.ModelRoot.canCreateModel(String)	use the one with SModelName as parameter
org.jetbrains.mps.openapi.persistence.ModelRoot.canCreateModels()	use specific #canCreateModel(SModelName)
org.jetbrains.mps.openapi.persistence.MultiStreamDataSource.delete(String)	use StreamDataSource.delete() and MultiStreamDataSource.getStreamByName(String)
org.jetbrains.mps.openapi.persistence.MultiStreamDataSource.getAvailableStreams()	use MultiStreamDataSource.getSubStreams()
org.jetbrains.mps.openapi.persistence.MultiStreamDataSource.openInputStream(String)	use MultiStreamDataSource.getSubStreams() and MultiStreamDataSource.getStreamByName(String)
org.jetbrains.mps.openapi.persistence.MultiStreamDataSource.openOutputStream(String)	use MultiStreamDataSource.getSubStreams() and MultiStreamDataSource.getStreamByName(String)
org.jetbrains.mps.openapi.persistence.PersistenceFacade.addFindUsagesParticipant(FindUsagesParticipant)	add/remove methods shall move to PersistenceRegistry (implementation class), instead, as components that perform registration may access PersistenceRegistry instance directly. I don't see a need to add/remove participants dynamically.
org.jetbrains.mps.openapi.persistence.PersistenceFacade.addNavigationParticipant(NavigationParticipant)	see PersistenceFacade.getNavigationParticipants()
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getDefaultModelFactory()	unclear contract, use ModelFactoryRegistry#getDefault(DataSourceType) + PreinstalledModelFactoryTypes.PLAIN_XML
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getModelFactory(String)	use PersistenceFacade.getModelFactory(ModelFactoryType) instead
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getNavigationParticipants()	No reason to keep this in PersistenceComponent, NavigationParticipant API is cumbersome. Need a replacement API.
org.jetbrains.mps.openapi.persistence.PersistenceFacade.removeFindUsagesParticipant(FindUsagesParticipant)	see PersistenceFacade.addFindUsagesParticipant(FindUsagesParticipant) for reasons
org.jetbrains.mps.openapi.persistence.PersistenceFacade.removeNavigationParticipant(NavigationParticipant)	see PersistenceFacade.getNavigationParticipants()