Deprecated API

Contents

• Interfaces
• Classes
• Enums
• Fields
• Methods

Interfaces

Interface	Description
org.jetbrains.mps.openapi.module.RepositoryAccess

Classes

Class	Description
org.jetbrains.mps.openapi.module.SModuleAdapter	unfortunate naming, not an adapter to SModule, use SModuleListenerBase instead. The class will be removed after 3.4

Enums

Enum	Description
org.jetbrains.mps.openapi.persistence.NotImplementedModelFactoryType	Temporary stub implementation for users to migrate on the new API

Fields

Field	Description
org.jetbrains.mps.openapi.persistence.ModelFactory.OPTION_CONTENT_ONLY	String option is not informatory. Use a ContentOption instead
org.jetbrains.mps.openapi.persistence.ModelFactory.OPTION_MODELNAME	this option is unnecessary. Use ModelFactory.create(DataSource, SModelName, ModelLoadingOption...) instead.
org.jetbrains.mps.openapi.persistence.ModelFactory.OPTION_MODULEREF	not used currently
org.jetbrains.mps.openapi.persistence.ModelFactory.OPTION_PACKAGE	not used currently
org.jetbrains.mps.openapi.persistence.ModelFactory.OPTION_RELPATH	not in use anymore

Methods

Method	Description
org.jetbrains.mps.openapi.language.SAbstractConcept.getDeclarationNode()
org.jetbrains.mps.openapi.language.SAbstractConcept.getLink(String)	use SReferenceLink or SContainmentLink alternatives. For MPS internals and transition from legacy code, one can use ConceptMetaInfoConverter.
org.jetbrains.mps.openapi.language.SAbstractConcept.getLinks()	Use SAbstractConcept.getContainmentLinks() or SAbstractConcept.getReferenceLinks() instead
org.jetbrains.mps.openapi.language.SAbstractConcept.getProperty(String)	use SProperty-based alternatives. For MPS internals and transition from legacy code, one can use ConceptMetaInfoConverter.
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.getLanguageVersion()
org.jetbrains.mps.openapi.language.SProperty.getDeclarationNode()
org.jetbrains.mps.openapi.language.SReferenceLink.getDeclarationNode()
org.jetbrains.mps.openapi.language.SReferenceLink.getRoleName()
org.jetbrains.mps.openapi.language.SReferenceLink.isMultiple()
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)
org.jetbrains.mps.openapi.model.SNode.getChildren(String)	use getChildren(SContainmentLink)
org.jetbrains.mps.openapi.model.SNode.getProperty(String)	use getProperty(SProperty)
org.jetbrains.mps.openapi.model.SNode.getPropertyNames()	use getProperties()
org.jetbrains.mps.openapi.model.SNode.getReference(String)	use getReference(SReferenceLink)
org.jetbrains.mps.openapi.model.SNode.getReferenceTarget(String)	use getReferenceTarget(SReferenceLink)
org.jetbrains.mps.openapi.model.SNode.getRoleInParent()	use getContainmentLink()
org.jetbrains.mps.openapi.model.SNode.hasProperty(String)	use hasProperty(SProperty)
org.jetbrains.mps.openapi.model.SNode.insertChildBefore(String, SNode, SNode)	use insertChildBefore(SContainmentLink, SNode, SNode)
org.jetbrains.mps.openapi.model.SNode.setProperty(String, String)	use setProperty(SProperty)
org.jetbrains.mps.openapi.model.SNode.setReference(String, SReference)	use setReference(SReferenceLink, SReference)
org.jetbrains.mps.openapi.model.SNode.setReferenceTarget(String, SNode)	use setReferenceTarget(SReferenceLink, SNode)
org.jetbrains.mps.openapi.model.SNodeAccessUtil.getProperty(SNode, String)
org.jetbrains.mps.openapi.model.SNodeAccessUtil.hasProperty(SNode, String)
org.jetbrains.mps.openapi.model.SNodeAccessUtil.setProperty(SNode, String, String)
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()
org.jetbrains.mps.openapi.module.FacetsFacade.getApplicableFacetTypes(Iterable<String>)	use FacetsFacade.getApplicableFacetTypes(Collection) instead
org.jetbrains.mps.openapi.module.FacetsFacade.getInstance()	Use respective ComponentPlugin (i.e. MPSCore) to obtain instance of the registry.
org.jetbrains.mps.openapi.module.FacetsFacade.registerLanguageFacet(String, String)	use FacetsFacade.registerLanguageFacet(SLanguage, String) instead
org.jetbrains.mps.openapi.module.FacetsFacade.unregisterLanguageFacet(String, String)	use FacetsFacade.unregisterLanguageFacet(SLanguage, String) instead
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.ModelFactory.canCreate(DataSource, Map<String, String>)	rather try calling ModelFactory.create(DataSource, SModelName, ModelLoadingOption...) method and catching the ModelCreationException during creation or use ModelFactory.supports(DataSource) method to acknowledge whether this data source is supported at all.
org.jetbrains.mps.openapi.persistence.ModelFactory.create(DataSource, Map<String, String>)	use more flexible ModelFactory.create(DataSource, SModelName, ModelLoadingOption...) instead
org.jetbrains.mps.openapi.persistence.ModelFactory.getFileExtension()	Outrageous breaking of the separation location from the loading strategy principle, which is planted in the create, load, etc. methods. The location notion is hidden in DataSource and there is absolutely no need to expose it. In order to work out the currently running scenarios we set up special DataSourceFactory <-> ModelFactory relations which are exposed through the DataSourceFactoryRuleService, ModelFactoryService and ModelFactory.getPreferredDataSourceTypes().
org.jetbrains.mps.openapi.persistence.ModelFactory.getFormatTitle()	use ModelFactory.getType() and ModelFactoryType.getFormatTitle() instead
org.jetbrains.mps.openapi.persistence.ModelFactory.load(DataSource, Map<String, String>)	Map is hardly perceivable. Please use rather ModelFactory.load(DataSource, ModelLoadingOption...) instead
org.jetbrains.mps.openapi.persistence.ModelRoot.canCreateModel(String)	we have a DataSourceFactory#create + ModelFactory.create(DataSource, SModelName, ModelLoadingOption...) to create a new model (from a new data source) having just a model name and a model root. this method gives out an insufficient API -- it kind of implies that a model root has the only way to create a model given a name, however obviously it is not true in a current MPS setup. Semantics of this method (as for 3.5) is to create a new model via default DataSourceFactory and default ModelFactory. Not sure if it makes sense at all shaped like this. The signature needs to be extended with a ModelFactory parameter. The same applies to the #createModel as well. [AP]
org.jetbrains.mps.openapi.persistence.ModelRoot.canCreateModels()	use specific #canCreateModel(SModelName)
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.addFindUsagesParticipant(FindUsagesParticipant) for reasons
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getDefaultModelFactory()	unclear contract, use ModelFactoryRegistry#getDefault(DataSourceType) see jetbrains.mps.extapi.persistence.ModelFactoryService see jetbrains.mps.extapi.persistence.datasource.DataSourceFactoryRuleService
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getModelFactory(String)	use ModelFactoryRegistry#getDefault(DataSourceType) see jetbrains.mps.extapi.persistence.ModelFactoryService see jetbrains.mps.extapi.persistence.datasource.DataSourceFactoryRuleService
org.jetbrains.mps.openapi.persistence.PersistenceFacade.getModelFactoryExtensions()	the model factories are separated from the type of location (while file extension as a key clearly violates this idea). Thus one might to look at the jetbrains.mps.extapi.persistence.datasource.DataSourceFactoryService which can be used to register your one custom data source factories. jetbrains.mps.extapi.persistence.ModelFactoryService is an extension point to register your custom model factory implementation and associate it (if needed) with some specific data source type.
org.jetbrains.mps.openapi.persistence.PersistenceFacade.removeFindUsagesParticipant(FindUsagesParticipant)	see PersistenceFacade.addFindUsagesParticipant(FindUsagesParticipant) for reasons
org.jetbrains.mps.openapi.persistence.PersistenceFacade.removeNavigationParticipant(NavigationParticipant)	see PersistenceFacade.addFindUsagesParticipant(FindUsagesParticipant) for reasons
org.jetbrains.mps.openapi.persistence.PersistenceFacade.setModelFactory(String, ModelFactory)	ModelFactory notion is isolated from the location by DataSource. Use ModelFactoryRegistry#register instead. see jetbrains.mps.extapi.persistence.ModelFactoryService see jetbrains.mps.extapi.persistence.datasource.DataSourceFactoryRuleService