总结：kathasis如何发送get请求获取数据

１．进入前端页面，找到对应的模块，开始塞字段数据。

２．如果字段为基本类型，如String，比如website，则在前段界面，右击，inspect，找到对应的代码所处的jsp，跳转到该jsp，通过该jsp。在前端添加一个person，则地址栏显示：backstop/crm/ManageContacts.do?ACTION=NEW_PERSON，因此，确定

对应的action是ManageContacts。到editPerson.jsp中搜索关键字website，确认字段名是website，然后在ManageContacts中搜索website，可以查看到这个website字段具体是塞在party接口中，进入party，发现其实现类是AbstractPartyEntity，左按ctrl，右边鼠标点中AbstractPartyEntity，可发现其中PersonEntity继承了AbstractPartyEntity。而PersonEntity刚好又实现了Person这个接口。

找到界面字段在entity对应的地方后，可以开始以下操作：

１．在PersonDto中定义website字段。

２．在PersonConverte的updateDto(Person entity,PersonDto dto)中，dto.setWebsite(entity.getWebsite()），直接塞数据即可。

３．如果界面字段是一个实体类型，则在PersonDto

@JsonApiToOne(lazy = true)
    @JsonApiLookupIncludeAutomatically
    private SystemUserDto representative;

如果是一对多，则为：

@JsonApiToMany(lazy = true)
    private List<PartyLocationDto> partyLocations;

注意，在PersonDto属性中，只能定义是基本类型或者Dto实体类型，不能是Entity类型，也就是，不能定义为private SystemUser representative.

４．新建SystemUserDto等，包含需要的属性。

５．确保有SystemUserRepository。

６.   确保SystemUserConverter，用于SystemUserDto和SystemUserEntity之间的转换。

７．添加person和representative的关系，新建PersonToRepresentativeRelationship:

@Singleton
public class PersonToRepresentativeRelationship
        extends AbstractRelationshipRepository<PersonDto, SystemUserDto> {

}

添加person和PartyLocation的关系，新建PersonToPartyLocationRelationship：

@Singleton
public class PersonToPartyLocationRelationship extends AbstractEntityToPartyLocationRelationship<PersonDto> {

}

public abstract class AbstractEntityToPartyLocationRelationship<S extends AbstractKatharsisDto>
        extends AbstractRelationshipRepository<S, PartyLocationDto> {

    @Override
    public List<PartyLocation> getTargetEntities(Object source, String fieldName, QueryParamsHelper helper) {
        Person sourceEntity = cast(source);
        List<PartyLocation> partyLocations = new ArrayList<PartyLocation>();

        if(!Objects.isNull(sourceEntity.getHomeLocation())){
            partyLocations.add(sourceEntity.getHomeLocation());
        }else if(!Objects.isNull(sourceEntity.getBusinessLocation())){
            partyLocations.add(sourceEntity.getBusinessLocation());
        }else if(!Objects.isNull(sourceEntity.getOtherLocation1())){
            partyLocations.add(sourceEntity.getOtherLocation1());
        }else if(!Objects.isNull(sourceEntity.getOtherLocation2())){
            partyLocations.add(sourceEntity.getOtherLocation2());
        }
        return partyLocations;

    }

    @Override
    public void addRelations(S source, Iterable<String> targetIds, String fieldName) {
    }

}

对以上代码的理解：

在PersonDto中，通过注解，已经定义了personDto和partyLocationDto之间的关系，那么，这里的relationship则是用来定义person和partyLocation实体之间的关系。

７．在PersonConverter中的updateDto(Person entity, PersonDto dto)方法中，添加如下代码：

 private void setRepresentative(Person person, PersonDto personDto) {
        if (!Objects.isNull(person.getRepresentative())) {
            personDto.setRepresentative(new SystemUserDto(person.getRepresentative().getId()));
        }
    }

这里表示，将entity数据塞到dto中去。在塞的过程中，要保证，SystemUser对应的entity和dto也是可以相互转换的。

为什么能通过一个id，然后直接new SystemUserDto(id)就可以获取到了SystemUser的全部数据信息，因为:

在发送请求：/backstop/api/people/781187/company时，kathasis框架会自动去根据repository执行findOne或者findAll查找。