CDS测试框架介绍:如何为ABAP CDS Entities写测试

动机

而今大家还明白单元测试对咱们代码的利益。并且我们还认同她是开发进程遭到必要的一模一样有些。但是于将代码切换到数据库的模式下之时节,我们深受强行地从回了软件测试的黑暗年代…我们本面临着逻辑下推进至ABAP
CDS entities后,代码要怎样测试
的难题。

CDS Test Double Framework允许开发者们经过明确的ABAP Unit Test
Framework自动化地测试CDS entities。

本文链接:http://www.cnblogs.com/hhelibeb/p/7376232.html

英文原文:Introduction to CDS Test Double Framework – How to write unit
tests for ABAP CDS
Entities?

挑战

以CDS entity中之逻辑运行在下层的数据库中(独立于abap
runtime),使用传统的ABAP依赖注入解决方案为贯彻测试成为了无容许的工作。entity的凭借组件用以数据库中添加测试替身,并且我们得确保CDS
entity测试的时节数据库引擎调用/执行这些测试替身(double)。

以好于CDS entity under test
(CUT)遭逢不过控地测试逻辑,我们要经过测试替身注射测试专用数据。这代表必须以测试数据插入到测试替身中,这样数据可以在CUT执行时叫测试替身们回到。对于在ABAP
CDS上下文中颇具固有之特念属性之乘组件(比如数据库视图和数据库函数),这是一律宗专门之挑战。

本文中重要之缩写:

CUT = CDS entity Under
Test

DOC = Depended-On
Component

CDS Test Double Framework

CDS Test Double Framework处理了以上之挑战,并且可兑现CDS
entities测试的自动化:

  1. 在同样之Database
    Schema面临吗每个依赖组件创建临时的而更新测试替身

    1. 复制依赖组件表,但不复制任何数。不复制依赖数据库表的主键约束。这允许你轻松地栽测试数据,而休用担心数据的完整性。相似的,数据库索引也非会见于复制。
    2. 否乘数据库视图创建数量库表。这些发明有与依赖性数据库视图相同之构造。
    3. 依傍数据库functions(由带有参数的依靠CDS视图和仰表function产生)会于复制,并且function的测试替身实现会晤受涂改也允许插入需要之测试数据。
  2. 在同一之Database Schema创建一个CDS entity under
    test(CUT)的临时副本。从各种意义及来拘禁,这个副本是为CUT服务的。在原有之CDS
    entity中贯彻之逻辑在副本中相同存在,但是依靠组件为轮换为呼应的测试替身。测试替身是由我们的CDS
    Test Double Framework所创造的。

亚洲必赢bwin696.com 1

测试什么?

单元测试应当注意让由一个让定视图实现之生价之功效定义。不是享有的CDS视图都得一个单元测试。在贯彻单元测试之前,建议辨别出entity中及测试有关的上面。

寻常,需要吗一些含有了代码下推的点子的entity进行单元测试。潜在的测试候选者包括:

Calculations and/or filters, conversions, conditional expressions 比如
CASE…THEN…ELSE or COALESCE, type changing CAST operations, cardinality
changes or checks against NULL values,  JOIN behavior, complex where
conditions 等.

单元测试不使叫测试那些更适用于静态检查、集成测试相当技巧的CDS
entities属性。如果未能够打单元测试中收获其它价值的讲话,也不答应开展其,比如对那些简单的CDS投影视图。

何以使用CDS Test Double Framework写单元测试?

每当生一些,我们见面通过为广泛应用的ABAP Unit Test
Framework为以下的CDS视图创建单元测试。

@AbapCatalog.sqlViewName: 'zSo_Items_By_1'
@EndUserText.label: 'Aggregations/functions in SELECT list'
@AbapCatalog.compiler.compareFilter: true
define view Salesorder_Items_By_TaxRate
as select from CdsFrwk_Sales_Order_Item
association [1] to snwd_so as _sales_order on so_guid = _sales_order.node_key
{
so_guid,
coalesce ( _sales_order.so_id, '9999999999' ) as so_id,
currency_code,
sum( gross_amount ) as sum_gross_amount,
tax_rate,
_sales_order
}
group by
so_guid,
_sales_order.so_id,
currency_code,
tax_rate

创建ABAP测试类

创造一个ABAP测试接近以对CDS视图进行单元测试。有一个吓的实行方法:为测试类起一个同CUT相同/相似之名,并且增长TEST的后缀。比如,对于CDS视图Salesorder_Items_By_TaxRate,测试类的讳可以是:Salesorder_Items_By_TaxRate_Test.

因单元测试和CDS是殊的东西,相同/相似的名字可以助我们轻松的探寻有关的测试。

CLASS Salesorder_Items_By_TaxRate_Test DEFINITION FINAL FOR TESTING
DURATION SHORT
RISK LEVEL HARMLESS.
PRIVATE SECTION.
...
...
ENDCLASS.

CLASS SO_ITEMS_BY_TAXRATE_TEST IMPLEMENTATION.
...
...
ENDCLASS.

概念固定方式

概念以下的安装拆卸方法。

运转方式cl_cds_test_environment=>create( i_for_entity =
‘<CDS under test>’
)
,隐式地当数据库被开创有乘组件测试替身。这个点子以测试接近吃只应被调用一蹩脚。

"Fixture method class_setup is executed only once in the beginning of the execution of test class
METHOD class_setup.
"For parameter i_for_entity, specify the CDS view to be unit tested. This will create all the depended-on component Test doubles in the database.
environment = cl_cds_test_environment=>create( i_for_entity = 'Salesorder_Items_By_TaxRate' ).
ENDMETHOD.

METHOD class_teardown.
environment->destroy( ).
ENDMETHOD.

"Fixture method setup is executed once before each test method execution
<cod
METHOD setup.
environment->clear_doubles( ).
ENDMETHOD.

概念单元测试方法

METHOD cuco_1_taxrate_1_item_1_ok.

ENDMETHOD.

备输入——在测试替身中插入测试数据

METHOD cuco_1_taxrate_1_item_1_ok.

"Step 1 : Insert testdata into the doubles
"Step 1.1 : create an instance of type snwd_so. Note : CDS view Salesorder_Items_By_TaxRate depends on snwd_so.
sales_orders = VALUE #( ( client = sy-mandt node_key = '01' so_id = 'ID' ) ).

"Step 1.2 : Use the framework method CL_CDS_TEST_DATA=>create(..) to create the test_data object
test_data = cl_cds_test_data=>create( i_data = sales_orders ).

"Step 1.3 : Use the framework method environment->get_double(..) to create the instance of the double 'SNWD_SO'
DATA(sales_orders_double) = environment->get_double( i_name = 'SNWD_SO' ).

"Step 1.4 : Insert the testdata into the double depended-on component object
sales_orders_double->insert( test_data ).

"Repeat Step 1 for all the depended-on component doubles
sales_order_items = VALUE #( ( mandt = sy-mandt so_guid = '01' currency_code = 'EUR' gross_amount = '1' tax_rate = '19.00' ) ).
test_data = cl_cds_test_data=>create( i_data = sales_order_items ).
DATA(sales_order_items_double) = environment->get_double( i_name = 'CdsFrwk_DEMO_1' ).
sales_order_items_double->insert( test_data ).

...

ENDMETHOD.

执行CDS

SELECT * FROM cdsfrwk_so_items_by_taxrate INTO TABLE @act_results.

证输出——使用ABAP单元测试的预言

exp_results = VALUE #( ( so_id = 'ID' currency_code = 'EUR' sum_gross_amount = '1' tax_rate = '19.00' ) ).
cl_abap_unit_assert=>assert_equals(
act = lines( act_results )
exp = lines( exp_results ) ).

"The method looks as follows:

METHOD cuco_1_taxrate_1_item_1_ok.

"Step 1 : Insert testdata into the doubles
"Step 1.1 : create an instance of type snwd_so
sales_orders = VALUE #( ( client = sy-mandt node_key = '01' so_id = 'ID' ) ).

"Step 1.2 : Use the framework method CL_CDS_TEST_DATA=>create to create the test_data object
test_data = cl_cds_test_data=>create( i_data = sales_orders ).

"Step 1.3 : Use the framework method environment->get_double to the instance of the DOC double 'SNWD_SO'
DATA(sales_orders_double) = environment->get_double( i_name = 'SNWD_SO' ).

"Step 1.4 : Insert the testdata into the DOC double object
sales_orders_double->insert( test_data ).

"Repeat Step 1 for all the DOC doubles
sales_order_items = VALUE #( ( mandt = sy-mandt so_guid = '01' currency_code = 'EUR' gross_amount = '1' tax_rate = '19.00' ) ).
test_data = cl_cds_test_data=>create( i_data = sales_order_items ).
DATA(sales_order_items_double) = environment->get_double( i_name = 'CdsFrwk_DEMO_1' ).
sales_order_items_double->insert( test_data ).

"Step 2 : Execute the CDS
SELECT * FROM cdsfrwk_so_items_by_taxrate INTO TABLE @act_results.

"Step 3 : Verify Expected Output
exp_results = VALUE #( ( so_id = 'ID' currency_code = 'EUR' sum_gross_amount = '1' tax_rate = '19.00' ) ).
assert_so_items_by_taxrate( exp_results = exp_results ).

ENDMETHOD.

运转CDS的单元测试

在ADT中,打开包含有CDS单元测试的ABAP测试类。右键选择Run
As->ABAP Unit
Test,或者采用ctrl+shift+f10组合键来运行单元测试。结果会当eclipse中的ABAP
Unit Runner视图中形。

专注:至今为止,还非克在DDL源代码编辑器中一直运行单元测试。

深受支持的测试场景

CDS Test Double framework支持呢加的CUT的以下DOC创建测试替身:

  • DDIC tables
  • DDIC views
  • CDS views
  • CDS views with Parameters
  • External Views
  • Table Functions
  • CDS special functions. CURRENCY_CONVERSION and UNIT_CONVERSION

汝可以打开/关闭给定CDS的DCL,更多细心节会在本文的末尾提供。

乘组件是Table Function

Tables Function的测试替身的决定方式与其它的CDS视图一样。

指组件是含有参数的CDS视图

CDS Test Double Framework提供了

cl_cds_test_data=>create( .. )->for_parameters( .. )

来也涵盖参数的型的测试替身亚洲必赢bwin696.com插入数据。

METHOD eur_tax_rate_19_found.

"Step 1 : Insert testdata into the doubles
open_items = VALUE #( ( mandt = sy-mandt so_guid = '0F' tax_rate = '19.00' so_id = '1' ) ).
i_param_vals = VALUE #( ( parm_name = `pCuCo` parm_value = `EUR` ) ).

"CdsFrwk_demo_3 is a CDS view with parameters. Use framework method ->for_parameters( ) to insert test data
test_data = cl_cds_test_data=>create( i_data = open_items )->for_parameters( i_param_vals ).

DATA(open_items_double) = environment->get_double( 'CdsFrwk_demo_3' ).
open_items_double->insert( test_data ).

...
...
ENDMETHOD.

DCL对CUT的影响

若呢得以打开/关闭给定的CDS的DCL。但是,在此时此刻,如果您的CDS
DDL在测试时着DCL影响的话,我们建议在运转测试时连连关DCL。在未来,使用DCL时会产生诸多取舍可以打,并且可以动用角色权限测试替身等。但是以当下之版本被,你待注意在测试CDS
DDL时完全关闭DCL(如果有些话)。在开拓DCL时来测试可能造成测试间断性失败,因为其实访问控制角色权限会被采取。因此,建议于您的生育测试中连有一个:

DISABLE_DCL=ABAP_TRUE in the cl_cds_test_environment=>create(…)

对特殊function的支持:CURRENCY_CONVERSION和UNIT_CONVERSION

CDS Test Double framework中得以吧有限单与众不同的CDS function提供支撑:

"Step 1 : Create testdata using the special framework method create_currency_conv_data
test_data = cl_cds_test_data=>create_currency_conv_data( output = '399.21' )->for_parameters(
amount = '558.14'
source_currency = 'USD'
target_currency = 'EUR'
exchange_rate_date = '20150218'
).

"Step 2 : Get the double instance using the framework method get_double
DATA(curr_conv_data_double) = environment->get_double( cl_cds_test_environment=>currency_conversion ).

"Step 3 : Insert test_data into the double
curr_conv_data_double->insert( test_data ).

含有NULL值的测试

为在测试替身中插入null值,CDS Test Double Framework提供了方:

cl_cds_test_data=>create( .. )->set_null_values( .. )

拖欠办法可显式地设定null值。

partners = VALUE #( ( client = sy-mandt bp_id = '1' ) ).

"Step 1 : define the list of columns into which NULL is inserted
i_null_vals = VALUE #( ( `address_guid` ) ).

"Step 2 : Create testdata and set the NULL value object
test_data = cl_cds_test_data=>create( i_data = partners )->set_null_values( i_null_vals ).

"Step 3 : Get test Double instance
DATA(partners_double) = environment->get_double( i_name = 'SNWD_BPA' ).

"Step 4 : Insert test data into test double
partners_double->insert( test_data ).

Demo examples

汝得当斯包里找到多单元测试的例证:

SABP_UNIT_DOUBLE_CDS_DEMO

可用性

CDS Test Double Framework从NetWeaver AS ABAP 7.51
release开班可用。

再也多信息

报告bug的话,请为CSS组件BC-DWB-TOO-UT-CDS创建tickets。

小结:通过本文,你现在得利用CDS Test Double
Framework高效地也汝以CDS中实现之代码下推动来写自动化的测试!

 

恢宏阅读:深切探討 Test Double、Dummy、Fake、Stub 、Mock 與
Spy

 

相关文章