abapdotabapdeveloper-tools
来源资料待手动核验
A
项目简介
Mustache template engine for ABAP
abapabap-mustachehacktoberfestmustachesaptemplatingdotabapdeveloper-tools
兼容性
ABAP community catalog信息不足
Mustache template engine for ABAP
Mustache template engine for ABAP. It implements the original mustache spec plus some additions (mainly in plans now :) Mustache is a logic-less template syntax. It is good for generation of HTML or any other text stuff.
The library has a Steampunk (740+) compatible version, thanks to @DerGuteWolf. Currently it lives in the steampunk branch. This version, at the time of publication, is somewhat slower compared to the original (master) due to limited whitelisted features of the steampunk (see the PR comments), but it has own advantages and may become the default in near future. If you are using the library in older environments, please notify in the issues to take it into account
Let's assume you have some data like this:
types:
begin of ty_shop_item
name type string,
price type s_price,
end of ty_shop_item,
ty_shop_item_tt type standard table of ty_shop_item,
begin of ty_shop,
shop_name type string,
items type ty_shop_item_tt,
end of ty_shop.
Create an instance of abap mustache class, feed the desired template to it and then render with your data:
data lo_mustache type ref to lcl_mustache.
data lv_text type string.
" c_nl is a shortcut for newline char, e.g. from cl_abap_char_utilities
lo_mustache = lcl_mustache=>create(
'Welcome to {{shop_name}}!' && c_nl &&
'{{#items}}' && c_nl &&
'* {{name}} - ${{price}}' && c_nl &&
'{{/items}}' ).
lv_text = lo_mustache->render( ls_my_data ). " ls_my_data type ty_shop
As the result (lv_text) you'll get some output like this (assuming you filled the ls_my_data appropriately):
Welcome to My Super Store
* Boots - $99.00
* T-Short - $49.00
* Shirts - $59.00
lcl_mustache=>ty_struc_tt which processed as a universal structure. Field name corresponds to tag name (case insesitive) and the value may be put either to val field or as a reference to dref. The latter can be then a reference to a structure or a table. So the above example may would look like:data lt_uni_data type lcl_mustache=>ty_struc_tt.
field-symbols <i> like line of lt_uni_data.
append initial line to lt_uni_data assigning <i>.
<i>-name = 'shop_name'.
<i>-val = 'My Super Store'.
append initial line to lt_uni_data assigning <i>.
<i>-name = 'items'.
get reference of lt_items to <i>-dref. " lt_items is the ty_shop_item_tt filled elsewhere
...
lv_text = lo_mustache->render( lt_uni_data ).
lcl_mustache=>ty_struc_tt is mainly intended to be the root structure. Supposedly it is convenient to prepare parts of data as regular structures and tables. However, combining them all together at the top level in yet another dedicated structure may be cumbersome. This is where lcl_mustache=>ty_struc_tt may serve well. Although you are free to choose your own way of course.type string_table)lo_mustache = lcl_mustache=>create( lv_template ). " iv_template = lv_template
* OR
lo_mustache = lcl_mustache=>create( it_template = lt_template_tab ). " TABLE of strings
type string_table)lv_text = lo_mustache->render( ls_my_data ).
* OR
lt_text_tab = lo_mustache->render_tt( ls_my_data ). " TABLE
render_tt newline char is not inserted (still if any template line contain line breaks it will be split into several output table lines).LF and CRLF separators are supported (detected automatically).The class supports partials (see example below). So you may prepare your templates in convenient and logical sections. And reuse them if necessary.
lo_mustache = lcl_mustache=>create(
'Welcome to {{shop_name}}!' && c_nl &&
'{{>items_template}}' ). " << Calling partial !
lo_partial = lcl_mustache=>create(
'{{#items}}' && c_nl &&
'* {{name}} - ${{price}}' && c_nl &&
'{{/items}}' ).
lo_mustache->add_partial( " Register partial
iv_name = 'items_template'
io_obj = lo_partial ).
lv_text = lo_mustache->render( ls_my_data ). " ls_my_data type ty_shop
Further information can be found in wiki. There are also some notes on performance.
zmustache and zmustache_ut includes and fill with the content of zmustache.prog.abap and zmustache_ut.prog.abap respectively. zmustache_ut is the unit tests include, so you might potentially skip it (just remove the references to ltcl_mustache from the first include).Here are some stuff I might be implementing with time:
if/elseeach/elsewith and maybe path features (not sure)Still some real usage statistics would be valuable to decide on this or that feature.
Contribution is always welcomed :)
The code is licensed under MIT License. Please see LICENSE for details.