To understand how this class work use this as a reference: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
what runs in js
new Promise( ( resolve, reject ) => { resolve( 'OK' ) } ).then( ( value ) => console.log( value ) ) // OKnow runs in ABAP ( with a bit more lines of course )
REPORT ZTEST_PROMISE_OK.
" Promise Resolver
" Must implement then method with mandatory resolve or reject method calls from inside
CLASS lcl_ok DEFINITION INHERITING FROM zcl_promise_resolver.
PUBLIC SECTION.
METHODS then REDEFINITION.
ENDCLASS.
CLASS lcl_ok IMPLEMENTATION.
METHOD then.
" resolve is declared in zcl_promise_resolver
resolve( |OK| ).
ENDMETHOD.
ENDCLASS.
" Promise handler
" has on_fulfilled and on_rejected callbacks with default empty implementation
CLASS lcl_ok_handler DEFINITION INHERITING FROM zcl_promise_handler.
PUBLIC SECTION.
METHODS ON_FULFILLED REDEFINITION.
ENDCLASS.
CLASS lcl_ok_handler IMPLEMENTATION.
METHOD on_fulfilled.
" ideally resolver needs to know which type it expects to have as a result
write cast string( with )->*.
ENDMETHOD.
endclass.
START-OF-SELECTION.
new zcl_promise( new lcl_ok( ) )->then( new lcl_ok_handler( ) ).You probably think, why we wouldn't just run write 'OK'
The answer is in the following sequence diagram
What promise class does during inititalization - is creating an asyncronous task with serialized resolver instance. Asyncronous task deserialises resolver and executes it. It may be time consuming operation, for example some calculation, query, or http request. So why won't let the rest of abap code work for something else? So when your code decides that it's time to get data from promise and only then actually triggers for wait statement. Once an asynctronous task is done by triggering resolve/reject method in your resolver instance - it will serialize again the response and send back to your main session.
You may not see the desired effect for single operations - but for promise=>all call the effect can be huge!
To use full power of promises we can also use await functions.
So mentioned above example may look a bit differently:
async function() {
console.log( await new Promise( ( resolve, reject ) => { resolve( 'OK' ) } ) ) // OK
}now works in ABAP
REPORT ZTEST_PROMISE_OK_AWAIT.
" Promise Resolver
" Must implement then method with mandatory resolve or reject method calls from inside
CLASS lcl_ok DEFINITION INHERITING FROM zcl_promise_resolver.
PUBLIC SECTION.
METHODS then REDEFINITION.
ENDCLASS.
CLASS lcl_ok IMPLEMENTATION.
METHOD then.
" resolve is declared in zcl_promise_resolver
resolve( |OK| ).
ENDMETHOD.
ENDCLASS.
CLASS lcl_app DEFINITION INHERITING FROM zcl_abap_async.
PUBLIC SECTION.
METHODs start.
ENDCLASS.
CLASS lcl_app IMPLEMENTATION.
METHOD start.
" we expect result as ref to string
write cast string(
" in case if it's async class ( child of async )
" you can just use await of any promise
await( new zcl_promise( new lcl_ok( ) ) ) )->*.
ENDMETHOD.
ENDCLASS.
START-OF-SELECTION.
" start the app
new lcl_app( )->start( ).Returns a new promise, resolved with array of promises results or rejected with a reason of the first rejected promise
Returns resolved promise
Returns rejected promise