released-abap-classes

name	released-abap-classes
description	SAP released ABAP APIs — C1/C2/C3/sAPIsC0 release contracts, released class hierarchies (cl_abap*, cl_system*, xco*, cl_bali*), API contract verification, ABAP Cloud compatibility checking, SAP API release lifecycle. Use when checking if a SAP class is released for customer use, selecting APIs for ABAP Cloud development, or verifying release contracts.
trigger	{"keywords":["released","abap","classes","apis","release-contracts","c1","c2","cloud","compatibility","sap-classes"],"intent":"Use when checking SAP class release contracts (C0-C4), verifying ABAP Cloud API compatibility, or selecting released APIs for development."}

SAP Released ABAP APIs

SAP API release contracts and compatible ABAP APIs for cloud development.

Release Contracts

Contract	Meaning	Stability
C1	Released for customer use	Stable — SAP guarantees compatibility
C2	Released with restrictions	Stable but usage-limited
C3	Released for system-internal use	May change
[sAPIsC0]	Cloud Platform released	Stable for ABAP Cloud

Key Released Class Hierarchies

CL_ABAP_* — Core ABAP Runtime

" Character/string utilities
cl_abap_char_utilities=>newline
cl_abap_char_utilities=>horizontal_tab

" Math operations
cl_abap_math=>round( iv_number = 3.14159 iv_decimals = 2 )  " → 3.14

" UUID generation
DATA(lv_uuid) = cl_system_uuid=>create_uuid_c32_static( ).

" Random integers
DATA(lv_random) = cl_abap_random_int=>create( seed = cl_abap_random=>seed( )
  min = 1 max = 100 )->get_next( ).

XCO — eXtensible Component Objects

" CDS metadata access
DATA(lo_cds) = xco_cp_cds=>object_for( 'Z_I_PRODUCT' ).
DATA(lv_exists) = lo_cds->exists( ).

" Package metadata
DATA(lo_package) = xco_cp_abap_repository=>object->devc->for( '$ZFOO' ).
DATA(lt_objects) = lo_package->list_objects( )->get( ).

" DDIC table library
DATA(lo_table) = xco_cp_ddl=>field( 'MARA' )->field( 'MATNR' ).
DATA(lv_type) = lo_table->content( )->get_data_type( ).

CL_HTTP_CLIENT / CL_WEB_HTTP_CLIENT

" Released HTTP client (C1 contract)
DATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination(
  i_destination = cl_http_destination_provider=>create_by_cloud_destination(
    i_name = 'MY_S4_SYSTEM' ) ).
DATA(lo_request) = lo_client->get_http_request( ).
DATA(lo_response) = lo_client->execute( i_method = if_web_http_client=>get ).
DATA(lv_body) = lo_response->get_text( ).

/UI2/CL_JSON

" Released JSON serialization (C1)
DATA(lv_json) = /ui2/cl_json=>serialize( data = ls_data ).
/ui2/cl_json=>deserialize( EXPORTING json = lv_json CHANGING data = ls_data ).

CL_BCS_MAIL_MESSAGE (Mail)

" Released mail client (C1)
DATA(lo_mail) = cl_bcs_mail_message=>create_instance( ).
lo_mail->set_sender( '[e-mail]' ).
lo_mail->add_recipient( '[e-mail]' ).
lo_mail->set_subject( 'Report Ready' ).
lo_mail->set_body( 'Your report is attached.' ).
lo_mail->send( ).

CL_BALI_LOG (Application Log — new)

" New BAL API (C1 in ABAP Cloud)
DATA(lo_log) = cl_bali_log=>create( ).
lo_log->add_item( item = cl_bali_message_item=>create(
  severity = if_bali_constants=>c_severity_error
  id = 'ZROUTER' number = '001' variable_1 = 'Failed' ) ).
lo_log->save( ).

Checking API Release Status

" Programmatic check
cl_abap_objectdescr=>get_object_type_info(
  EXPORTING p_name = 'CL_WEB_HTTP_CLIENT'
  IMPORTING p_release_contract = DATA(lv_contract) ).
" lv_contract = 'C1' (released) or 'C3' (not released for customer)

Not Released (Avoid in ABAP Cloud)

Class	Alternative
CL_GUI_FRONTEND_SERVICES	Not available in cloud
CL_ABAP_BROWSER	Not cloud-compatible
CL_SALV_TABLE	Use CDS + Fiori
Function modules (custom)	Released RFC scenarios only
Direct DB access	CDS views only

Gotchas

• C1 does not mean "no changes" — SAP may deprecate C1 APIs with 12-month notice
• XCO library is the future direction for DDIC/programmatic metadata
• cl_http_client is NOT released — use cl_web_http_client instead
• /ui2/cl_json is released but not in all C1 contract documents