3.5.3.4.4. 在数据加载器中使用界面参数

很多时候需要根据界面传递的参数加载界面需要的数据。下面是一个浏览界面的示例，使用了界面参数并且在加载数据时使用参数来过滤数据。

假设有两个实体：Country 和 City。City 实体有 country 属性，是 Country 的引用。在 city 的浏览界面，可以接受一个 country 的实例，然后只展示该 country 的 city。

首先，看看 city 界面的 XML 描述。其数据加载器包含一个带有参数的查询：

<collection id="citiesDc"
            class="com.company.demo.entity.City"
            view="_local">
    <loader id="citiesDl">
        <query>
            <![CDATA[select e from demo_City e where e.country = :country]]>
        </query>
    </loader>
</collection>

city 界面控制器有一个 public 的参数setter，然后在 BeforeShowEvent 处理器中使用了参数。注意，该界面没有 @LoadDataBeforeShow 注解，因为需要显式的触发数据加载：

@UiController("demo_City.browse")
@UiDescriptor("city-browse.xml")
@LookupComponent("citiesTable")
public class CityBrowse extends StandardLookup<City> {

    @Inject
    private CollectionLoader<City> citiesDl;

    private Country country;

    public void setCountry(Country country) {
        this.country = country;
    }

    @Subscribe
    private void onBeforeShow(BeforeShowEvent event) {
        if (country == null)
            throw new IllegalStateException("country parameter is null");
        citiesDl.setParameter("country", country);
        citiesDl.load();
    }
}

city 界面可以从其他界面为其传递一个 country 实例并打开，示例：

@Inject
private ScreenBuilders screenBuilders;

private void showCitiesOfCountry(Country country) {
    CityBrowse cityBrowse = screenBuilders.screen(this)
            .withScreenClass(CityBrowse.class)
            .build();
    cityBrowse.setCountry(country);
    cityBrowse.show();
}