Java Code Management

This article explains how to control Code Management (Code Weaving) behaviour for Java files. The following table describes the various instructions that may be used to control which parts of the codebase Intent Architect manages, and which parts are managed by the developers, at a very fine-grained level of control.

Instruction	Description
@IntentIgnore	Instructs Intent Architect to ignore this declaration (i.e. do not update or remove it).
@IntentIgnoreBody	Instructs Intent Architect to ignore the body of the declaration, but allows it to manage the signature. This instruction is typically applied over business-logic placeholder methods throughout the codebase.
@IntentMerge	Instructs Intent Architect to manage this declaration, allowing adding, updating, but not removing, of its child members. This instruction is typically used in areas of business logic to ensure that if the developer creates additional methods within a call, that those methods are not deleted.
@IntentManage	Instructs Intent Architect to manage this declaration, allowing adding, updating and removing of its child members. This instruction is useful in cases where Intent Architect is not fully managing a declaration and you would like it to.
@IntentManageClass	Instructs Intent Architect to manage this class, allowing adding, updating and removing of its child members. Additional management options can be supplied to this instruction to instruct Intent Architect how to treat methods, properties and constructors.

Note

Instructions can be applied as annotations to any of the following declarations: class, interface, constructor, method, or property.

Examples of applying these annotations

Decorating an entire class to be managed by the developer would be accomplished by using @IntentIgnore:

@Service
@AllArgsConstructor
@IntentIgnore // Intent Architect will not modify this class
public class UsersServiceImpl implements UsersService {
    private UserRepository userRepository;
    private ModelMapper mapper;

    @Override
    @Transactional(readOnly = false)
    public UUID Create(UserCreateDTO dto) {
        var user = new User();
        userRepository.save(user);
        return user.getId();
    }
}

A method can be decorated by the @IntentIgnoreBody annotation if Intent Architect should manage the method signature but the developer is responsible for the implementation of the method:

@Service
@AllArgsConstructor
public class UsersServiceImpl implements UsersService {
    private UserRepository userRepository;
    private ModelMapper mapper;

    @Override
    @Transactional(readOnly = false)
    @IntentIgnoreBody // Intent Architect will not modify the implementation code below
    public UUID Create(UserCreateDTO dto) {
        var user = new User();
        userRepository.save(user);
        return user.getId();
    }
}