Deprecated API
Contents
- Terminally Deprecated
- Interfaces
- Classes
- Enum Classes
- Exception Classes
- Annotation Interfaces
- Fields
- Methods
- Constructors
- Annotation Interface Elements
-
Terminally Deprecated Elements
-
Deprecated Interfaces
-
Deprecated ClassesClassDescriptionno replacement; dynamic type no longer needs to inherit from
ObjectType.This class is deprecated and will be removed in a future version.
-
Deprecated Enum Classes
-
Deprecated Exception ClassesException ClassDescription
-
Deprecated Annotation InterfacesAnnotation InterfaceDescriptionuse is no longer needed. boundaries for
HostCompilerDirectives.BytecodeInterpreterSwitchare mostly determined automatically. To migrate remove all usages.
-
Deprecated FieldsFieldDescriptionin 24.1 without replacementin 24.1 without replacement
-
Deprecated MethodsMethodDescriptionUse
DebuggerSession.isBreakpointsActive(Breakpoint.Kind)instead.since 20.3 UseDebugScope.getDeclaredValues()on theSourceElement.ROOT.UseDebugValue.toDisplayString()instead.in 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededin 23.1 - no longer neededNo substitute. Runtime exceptions can now be thrown directly and will be observable by the guest language application.in 20.0. input value notifications are not functional forlisteners. Useevent node factoriesinstead.inputFilters do not work for execution event listeners UseInstrumenter.attachExecutionEventFactory(SourceSectionFilter, SourceSectionFilter, ExecutionEventNodeFactory)or useInstrumenter.attachExecutionEventListener(SourceSectionFilter, ExecutionEventListener)instead.since 23.0. UseTruffleInstrument.Env.getTruffleFile(TruffleContext, String).since 23.0. UseTruffleInstrument.Env.getTruffleFile(TruffleContext, URI).Do no longer use the cause will be initialized finally.since 22.2useBytecodeOSRNode.pollOSRBackEdge(BytecodeOSRNode, int)instead. It is recommended to batch up polls in the interpreter implementation. Important note:BytecodeOSRNode.pollOSRBackEdge(BytecodeOSRNode)did implicitlypollTruffle safepoints. The new method is no longer doing that. Make sure your bytecode interpreter contains a call toTruffleSafepoint.poll(Node)on loop back-edges when migrating.in 24.1 without replacementin 24.1 without replacementin 24.1, implement and useRootNode.isCaptureFramesForTrace(boolean)insteadin 24.1, implement and useRootNode.isCaptureFramesForTrace(boolean)insteadthe method will become final in future releases.Equivalent toLocation.canStore(Object).No longer needed. Declared locations can only be created with deprecated APIs.UseShape.Builder.layout(Class, MethodHandles.Lookup)instead.useConditionProfile.create()instead.useCountingConditionProfileinsteaduseLoopConditionProfile.create()instead.since 22.3, useAbstractTruffleString.copyToByteArrayUncached(int, byte[], int, int, Encoding)instead.since 22.3, useAbstractTruffleString.copyToNativeMemoryUncached(int, Object, int, int, Encoding)instead.useTruffleStringIterator.nextUncached(Encoding)instead.useTruffleStringIterator.previousUncached(Encoding)instead.com.oracle.truffle.api.TruffleLanguage.createContextLocal(TruffleLanguage.ContextLocalFactory<C, T>) since 22.1; replaced byTruffleLanguage.Env.createHostAdapter(Object[]).since 22.1; replaced byTruffleLanguage.Env.createHostAdapterWithClassOverrides(Object[], Object).com.oracle.truffle.api.TruffleLanguage.Env.createThread(Runnable, TruffleContext, ThreadGroup, long) since 23.0; replaced byTruffleLanguage.Env.isFileIOAllowed().in 24.1 useisPolyglotEvalAllowed(null) instead. Note that language implementations should now check whether polyglot eval is allowed also for individual languages, as access could be denied only for an individual language.useTruffleLanguage.Env.newInnerContextBuilder(String...)instead. Note that the replacement method configures the context differently by default. To restore the old behavior:newInnerContextBuilder() .initializeCreatorContext(true).inheritAllAccess(true).build()in 21.3, use static final context references instead. SeeTruffleLanguage.LanguageReferencefor the new intended usage.in 21.3, use static final context references instead. SeeTruffleLanguage.ContextReferencefor the new intended usage.To enable allTruffleStringencodings, it is sufficient to add theorg.graalvm.shadowed.jcodingsmodule to the language's module-inforequiresand ensure it is on the module path when languages are loaded. If the module can be found, and at least one languages requires it, all encodings are automatically enabled. When languages are loaded from the class path (i.e. as an unnamed module), having jcodings on the class path is enough to enable it.UseRuntimeReflection.register(Field...)instead. ParametersfinalIsWritableandallowUnsafeAccessno longer serve a purpose.UseRuntimeReflection.register(Field...)instead. ParameterfinalIsWritableno longer serves a purpose.UseRuntimeSerialization.register(Class[])instead. All possible custom constructors will be registered automatically.in 25.0 without replacement. This method is inherently unsafe becausesetlocale(...)is not thread-safe on the OS level.OptionValuesshould be read-only. If the value of an option needs to be altered after options are set, then the new value should be stored in the language's context or instrument fields and read from there.If a file system was previously set useallowIO(IOAccess.newBuilder().fileSystem(fileSystem).build()).useContext.Builder.allowHostClassLookup(Predicate)instead.useSource.getReader(),Source.getCharacters()orSource.getBytes()instead. The implementation is inefficient and can not distinguish byte and character based sources.useSourceSection.getCharacters()instead.
-
Deprecated ConstructorsConstructorDescriptiondo not use.
-
Deprecated Annotation Interface ElementsAnnotation Interface ElementDescriptionin 24.1 without replacementTo enable all
TruffleStringencodings, it is sufficient to add theorg.graalvm.shadowed.jcodingsmodule to the language's module-inforequiresand ensure it is on the module path when languages are loaded. If the module can be found, and at least one languages requires it, all encodings are automatically enabled. When languages are loaded from the class path (i.e. as an unnamed module), having jcodings on the class path is enough to enable it.