#import <XCTest/XCTest.h>
#import <xxx_Search/BMKSearchComponent.h>
@interface RoutePlanTransitSearchTest : XCTestCase<BMKRouteSearchDelegate>
{
    BMKRouteSearch *routeSearch;
    XCTestExpectation *expectation;
    int tag;
}
@end
 
@implementation RoutePlanTransitSearchTest
 
- (void)setUp {
    [super setUp];
    routeSearch = [[BMKRouteSearch alloc]init];
    routeSearch.delegate = self;
     
}
 
- (void)tearDown {
    routeSearch.delegate = nil;
    routeSearch = nil;
    expectation = nil;
    [super tearDown];
}
 
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、option为null
 * 验证：返回NO
 */
- (void)testTransitRoutePlanSearch_Option_Null{
    Boolean flag = [routeSearch transitSearch:nil];
    XCTAssertFalse(flag, "option null return NO");
}
 
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、from节点为null
 * 2、to节点正常"
 * 3、city正常
 * 验证：返回NO
 */
- (void)testTransitRoutePlanSearch_From_Null{
    
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    end.cityName = @"北京";
    end.name = @"百度大厦";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = nil;
    option.to = end;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertFalse(flag, "from null return NO");
}
 
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、from节点正常
 * 2、to节点null
 * 3、city正常
 * 验证：返回NO
 */
- (void)testTransitRoutePlanSearch_To_Null{
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"奎科科技大厦";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = nil;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertFalse(flag, "to null return NO");
}
 
/**
 * "定义一个BMKTransitRoutePlanOption对象
 * 1、from节点正常
 * 2、to节点正常
 * 3、city为null，即未指定在哪个城市检索
 * 验证：端上拦截，请求失败，返回NO
 */
- (void)testTransitRoutePlanSearch_City_Null{
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"奎科科技大厦";
    end.cityName = @"北京";
    end.name = @"百度大厦";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = nil;
    option.from = start;
    option.to = end;
    Boolean flag = [routeSearch transitSearch:option];//预期：端上拦截，请求失败，返回NO
    XCTAssertFalse(flag, @"起终点使用关键字时，必须设定城市，不能为空或者空字符串");
    NSLog(@"testTransitRoutePlanSearch_City_Null flag %d", flag);
}
 
//city.length > MAX_CITY_LENGTH, 返回NO
- (void)testTransitRoutePlanSearch_Max_City{
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"奎科科技大厦";
    end.cityName = @"北京";
    end.name = @"天通苑北一区";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京北京";
    option.from = start;
    option.to = end;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertFalse(flag, @"city lenght > max return false");
}
 
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、from的PlanNode节点，如北京，奎科科技大厦
 * 2、to的PlanNode节点，如北京，天通苑北一区"
 * 验证:
 * "返回的TransitRouteResult不为空，errorcode为no_error
 * 1、getRouteLines()不为空
 * 2、每条TransitRouteLine中getWayPoints()不为空,getAllStep()不为空
 * 3、每个路段节点，getEntrance()、getStepType()、getExit()、getInstructions()、getVehicleInfo()、不为空
 * 4、当路段公交或地铁，VehicleInfo中getPassStationNum()、getTitle()、getTotalPrice()、getUid()、getZonePrice()不为空"
 */
- (void)testTransitRoutePlanSearch_Normal{
    tag = 1;
    expectation = [self expectationWithDescription:@"search result"];
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"奎科科技大厦";
    end.cityName = @"北京";
    end.name = @"天通苑北一区";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = end;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertTrue(flag, @"normal search return ture");
    [self waitForExpectationsWithTimeout:5.0 handler:nil];
}
 
- (void)testTransitRoutePlanSearch_Normal_Pt{
    tag = 1;
    expectation = [self expectationWithDescription:@"search result"];
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.pt = CLLocationCoordinate2DMake(40.0477880000,116.3132600000);
    end.pt = CLLocationCoordinate2DMake(40.0830240000,116.4239230000);
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = end;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertTrue(flag, @"normal search return ture");
    [self waitForExpectationsWithTimeout:5.0 handler:nil];
}
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、from的PlanNode节点，通过withCityCodeAndPlaceName设置，如131，奎科科技大厦
 * 2、to的PlanNode节点，通过withCityNameAndPlaceName设置，如北京，天通苑北一区
 * 3、policy为EBUS_NO_SUBWAY"
 *
 * "返回的TransitRouteResult不为空，errorcode为no_error
 * 1、getRouteLines()不为空
 * 2、每条TransitRouteLine中getWayPoints()不为空，getAllStep()不为空
 * 3、每个路段节点，getEntrance()、getStepType()不为SUBWAY,getExit()、getInstructions()、getVehicleInfo()、不为空
 * 4、当路段公交或地铁，VehicleInfo中getPassStationNum()、getTitle()、getTotalPrice()、getUid()、getZonePrice()不为空"
 */
- (void)testTransitRoutePlanSearch_Normal_With_Policy{
    tag = 1;
    expectation = [self expectationWithDescription:@"search result"];
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"奎科科技大厦";
    end.cityName = @"北京";
    end.name = @"天通苑北一区";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = end;
    option.transitPolicy = BMK_TRANSIT_NO_SUBWAY;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertTrue(flag, @"normal search return ture");
    [self waitForExpectationsWithTimeout:5.0 handler:nil];
}
 
/**
 * "定义一个TransitRoutePlanOption对象
 * 1、from的PlanNode节点，通过withCityCodeAndPlaceName设置，如131，”窝窝窝“
 * 2、to的PlanNode节点，通过withCityNameAndPlaceName设置，如北京，”哈哈哈哈“
 * 返回的TransitRouteResult不为空，errorcode为result_not_found
 */
- (void)testTransitRoutePlanSearch_Result_Not_Found{
    tag = 2;
    expectation = [self expectationWithDescription:@"search result"];
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"gute street";
    end.cityName = @"北京";
    end.name = @"gute platz";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = end;
    option.transitPolicy = BMK_TRANSIT_NO_SUBWAY;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertTrue(flag, @"normal search return true");
    [self waitForExpectationsWithTimeout:5.0 handler:nil];
    }
 
- (void)testTransitRoutePlanSearch_Result_Ambiguous{
    tag = 3;
    expectation = [self expectationWithDescription:@"search result"];
    BMKPlanNode* start = [[BMKPlanNode alloc]init];
    BMKPlanNode* end = [[BMKPlanNode alloc]init];
    start.cityName = @"北京";
    start.name = @"百度大厦";
    end.cityName = @"北京";
    end.name = @"小明";
    BMKTransitRoutePlanOption *option = [[BMKTransitRoutePlanOption alloc] init];
    option.city = @"北京市";
    option.from = start;
    option.to = end;
    option.transitPolicy = BMK_TRANSIT_NO_SUBWAY;
    Boolean flag = [routeSearch transitSearch:option];
    XCTAssertTrue(flag, @"normal search return true");
    [self waitForExpectationsWithTimeout:5.0 handler:nil];
     
}
 
- (void)onGetTransitRouteResult:(BMKRouteSearch*)searcher result:(BMKTransitRouteResult*)result errorCode:(BMKSearchErrorCode)error{
    switch (tag) {
        case 1:
            XCTAssertEqual(error, BMK_SEARCH_NO_ERROR, @"error code wrong");
            XCTAssertNotNil(result, @"result nil");
            XCTAssertNotNil(result.routes, @"routes nil");
       
            for (BMKTransitRouteLine* plan in result.routes) {
                XCTAssertTrue(plan.distance > 0, @"plan distance 0");
                XCTAssertNotNil(plan.duration, @"plan duration nil");
                XCTAssertNotNil(plan.starting, @"plan start nil");
                XCTAssertNotNil(plan.terminal, @"plan end nil");
                XCTAssertNotNil(plan.steps, @"plan steps nil");
            }
            break;
        case 2:
            XCTAssertEqual(error, BMK_SEARCH_RESULT_NOT_FOUND, @"error code wrong");
            XCTAssertNil(result, @"result nil");
            break;
        case 3:
            XCTAssertEqual(error, BMK_SEARCH_AMBIGUOUS_ROURE_ADDR, @"error code wrong");
            XCTAssertNotNil(result, @"result nil");
            XCTAssertNotNil(result.suggestAddrResult, @"suggestAddrResult nil");
            XCTAssertNil(result.routes, @"routes nil");
            break;
        default:
            break;
    }
    [expectation fulfill];
}
 
@end

4. 执行，断言，观察结果和预期

   
   
   image.png

5.思考

1. 单元测试的覆盖率越全越好，当覆盖率（分支覆盖率、行覆盖率）达到百分百时就能说明待测接口或模块没有问题了？
   是否考虑代码分支逻辑的正确性

2. 单元测试，除了关注待测对象的功能正确性之外，是否还需要关注其他方面？
   用户体验：错误码类型、日志提示的合理性|可读性

3. 对于网络请求类接口，如何保证case运行的稳定性？
   考虑网络延迟，延迟操作，等待返回结果，具体方法：
   （1）在主线程中适当sleep，等待返回结果
   （2）在单测内部延迟判断

_expectation = [self expectationWithDescription:@"search result"];
 
BMKReverseGeoCodeSearchOption *rgcOption = [[BMKReverseGeoCodeSearchOption alloc] init];
rgcOption.location = CLLocationCoordinate2DMake(40.049850, 116.279920);
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
    BOOL result = [_geoSearch reverseGeoCode:rgcOption];
    XCTAssertTrue(result, @"geoSearch should return true");
});
 
[self waitForExpectationsWithTimeout:5.0 handler:nil];

参考文献

1. https://developer.apple.com/documentation/xctest
2. https://ocmock.org/
3. https://github.com/kiwi-bdd/Kiwi
4. https://www.zhihu.com/question/28729261