Kas yra Lombok biblioteka ir kaip ji naudojama Java…

Lombok yra Java biblioteka, kuri padeda sumažinti šabloninio kodo kiekį (boilerplate code). Ji tai daro automatiškai generuodama metodus, tokius kaip konstruktoriai, getteriai, setteriai, equals(), hashCode() ir toString() metodus kompiliacijos metu, remiantis anotacijomis.

Pagrindinės anotacijos ir jų naudojimas:

@Getter / @Setter: generuoja getX() ir setX() metodus klases laukams.
@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor: generuoja beargumentinius konstruktorius, konstruktorius su visų laukų argumentais, pažymėtais kaip @NonNull arba final, ir su visų laukų argumentais atitinkamai.
@Data: apjungia @ToString, @EqualsAndHashCode, @Getter, @Setter ir @RequiredArgsConstructor. Naudinga modelių klasėms.
@Value: panaši į @Data, bet daro klasę nekeičiama (final). Visi laukai pagal numatytuosius yra private final.
@Builder: generuoja "Statinio statytojo" šablono kodą, kuris supaprastina objektų kūrimą su daugybe laukų.
@Slf4j (ir kiti loggerys): sukuria statinį logger lauką (log) klasėje.

Pavyzdys naudojant @Data:

// Vartotojo modelis be Lombok
public class UserManual {
    private String username;
    private String email;

    public UserManual(String username, String email) {
        this.username = username;
        this.email = email;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    @Override
    public String toString() {
        return "UserManual{" +
               "username='" + username + '\'' +
               ", email='" + email + '\'' +
               '}';
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        UserManual that = (UserManual) o;
        if (username != null ? !username.equals(that.username) : that.username != null) return false;
        return email != null ? email.equals(that.email) : that.email == null;
    }

    @Override
    public int hashCode() {
        int result = username != null ? username.hashCode() : 0;
        result = 31 * result + (email != null ? email.hashCode() : 0);
        return result;
    }
}

// Vartotojo modelis su Lombok
import lombok.Data;

@Data
public class UserLombok {
    private String username;
    private String email;
    // Getteriai, setteriai, konstruktoriai, equals, hashCode, toString
    // bus automatiškai sugeneruoti kompiliacijos metu
}

Norint naudoti Lombok, reikia pridėti priklausomybę į Maven ar Gradle sistemą ir įdiegti IDE plėtinį, kad jis galėtų teisingai interpretuoti anotacijas ir teikti automatinę pagalbą.

Maven:

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version> <!-- Naudokite naujausią versiją -->
    <scope>provided</scope>
</dependency>

Gradle:

compileOnly 'org.projectlombok:lombok:1.18.24' // Naudokite naujausią versiją
annotationProcessor 'org.projectlombok:lombok:1.18.24' // Naudokite naujausią versiją

Lombok žymiai sumažina kodo kiekį, daro jį lengviau skaitomą ir sumažina klaidų tikimybę rankiniu būdu rašant šabloninius metodus. Tačiau svarbu prisiminti, kad jis slepia dalį logikos, kas kartais gali apsunkinti derinimą ar supratimą apie sugeneruotą kodą be IDE plėtinio naudojimo.

Kas yra Lombok biblioteka ir kaip ji naudojama Java kūrime?