வசந்த துவக்கத்தில் பல வினவல் அளவுருக்களை சரிபார்க்கிறது: ஒரு வழிகாட்டி

வசந்த துவக்க API களில் துல்லியமான தேதி சரிபார்ப்புகளை உறுதி செய்தல்

நவீன மென்பொருள் வளர்ச்சியில், ஏபிஐ நம்பகத்தன்மை மற்றும் தரவு ஒருமைப்பாடு ஆகியவை மிக முக்கியமானவை. வசந்த துவக்க பயன்பாடுகளை உருவாக்கும்போது, ​​வணிக விதிகளை அமல்படுத்த பல வினவல் அளவுருக்களை சரிபார்க்க பெரும்பாலும் அவசியம். ஒரு பொதுவான காட்சி, கோரிக்கைகளின் தேதி வரம்புகள் தர்க்கரீதியாக ஒலிப்பதை உறுதிசெய்கிறது, அதாவது தொடக்க தேதி இறுதி தேதிக்கு முன்னதாக இருப்பதை உறுதி செய்வது.

இந்த கட்டுரையில், வசந்த துவக்க பயன்பாட்டில் இரண்டு வினவல் அளவுருக்களை ஒன்றாக சரிபார்க்க முயற்சிக்கும்போது எதிர்கொள்ளும் ஒரு நிஜ உலக சிக்கலுக்குள் நுழைவோம். குறிப்பாக, இந்த நோக்கத்திற்காக தனிப்பயன் சிறுகுறிப்பு மற்றும் கட்டுப்பாட்டு வேலிடேட்டரை எவ்வாறு செயல்படுத்துவது மற்றும் பிழைத்திருத்துவது என்பதைப் பார்ப்போம். RESTFUL API களுடன் பணிபுரியும் போது பல டெவலப்பர்கள் எதிர்கொள்ளும் சவால் இது. .

டெவலப்பர்கள் கூடுதல் டி.டி.ஓக்களை உருவாக்காமல் அத்தகைய விதிகளை அமல்படுத்த விரும்பும் போது, ​​அவர்களின் குறியீட்டை சுருக்கமாகவும் பராமரிக்கவும் வைக்கலாம். ஸ்பிரிங் பூட் வலுவான சரிபார்ப்பு கருவிகளை வழங்கும் அதே வேளையில், அவற்றை பல அளவுருக்களுக்கு பயன்படுத்துவது சில நேரங்களில் எதிர்பாராத தடைகளுக்கு வழிவகுக்கும், ஏனெனில் வழங்கப்பட்ட எடுத்துக்காட்டில் பார்ப்போம்.

இந்த வழிகாட்டியின் முடிவில், வினவல் அளவுருக்களுக்கான சரிபார்ப்பு சவால்களை எவ்வாறு தீர்ப்பது மற்றும் சிறந்த நம்பகத்தன்மை மற்றும் செயல்திறனுக்காக உங்கள் வசந்த துவக்க பயன்பாடுகளை மேம்படுத்துவது பற்றிய நுண்ணறிவுகளைப் பெறுவீர்கள். இந்த கருத்துக்களை உயிர்ப்பிக்க நடைமுறை எடுத்துக்காட்டுகளையும் ஆராய்வோம்! .

வசந்த துவக்கத்தில் தனிப்பயன் வினவல் சரிபார்ப்பைப் புரிந்துகொள்வது

ஸ்பிரிங் துவக்கத்துடன் REST API களை உருவாக்கும் போது, ​​பல வினவல் அளவுருக்களை திறமையாக சரிபார்க்க வேண்டும். வழங்கப்பட்ட தீர்வில், தனிப்பயன் சிறுகுறிப்பு @Startdateboreenddate தொடக்க தேதி இறுதி தேதிக்கு பிற்பகுதியில் இல்லை என்பதை உறுதி செய்வதில் அதனுடன் தொடர்புடைய வேலிடேட்டர் முக்கிய பங்கு வகிக்கிறது. இந்த அணுகுமுறை கூடுதல் டி.டி.ஓக்களை உருவாக்குவதன் அவசியத்தைத் தவிர்க்கிறது, இதனால் செயல்படுத்தலை சுத்தமாகவும் சுருக்கமாகவும் செய்கிறது. தனிப்பயன் சிறுகுறிப்பு கட்டுப்படுத்தியில் உள்ள வினவல் அளவுருக்களுக்கு நேரடியாகப் பயன்படுத்தப்படுகிறது, இது API அழைப்புகளின் போது தடையற்ற சரிபார்ப்பை செயல்படுத்துகிறது. .

சிறுகுறிப்பு இணைக்கப்பட்டுள்ளது StartDateBoreendDateValidator வகுப்பு, இது சரிபார்ப்பு தர்க்கத்தைக் கொண்டுள்ளது. செயல்படுத்துவதன் மூலம் கட்டுப்பாடு வாலிடேட்டர் இடைமுகம், சரிபார்ப்பை எவ்வாறு கையாள்வது என்பதை வகுப்பு வரையறுக்கிறது. தி isvalid முறை இங்கே மையமாக உள்ளது, உள்ளீட்டு அளவுருக்கள் பூஜ்யமா, உள்ளூர் தேதியாக சரியாக தட்டச்சு செய்யப்பட்டதா, தொடக்க தேதி இறுதி தேதிக்கு முன் அல்லது சமமாக உள்ளதா என்பதை சரிபார்க்கவும். இந்த நிபந்தனைகள் பூர்த்தி செய்யப்பட்டால், கோரிக்கை தொடர்கிறது; இல்லையெனில், சரிபார்ப்பு தோல்வியடைகிறது, செல்லுபடியாகும் தரவு மட்டுமே சேவை அடுக்கை அடைகிறது என்பதை உறுதி செய்கிறது.

சேவை பக்கத்தில், தேதி வரம்புகளை சரிபார்க்க மாற்று அணுகுமுறை காண்பிக்கப்பட்டது. சிறுகுறிப்புகளை நம்புவதற்கு பதிலாக, தொடக்க தேதி இறுதி தேதிக்கு முன்னர் வந்து ஒரு வீசுகிறதா என்பதை சேவை முறை வெளிப்படையாக சரிபார்க்கிறது சட்டவிரோதமயமாக்கல் எக்ஸ்செப்சன் சரிபார்ப்பு தோல்வியுற்றால். சரிபார்ப்பு விதிகள் வணிக தர்க்கத்துடன் இறுக்கமாக இணைக்கப்பட்டுள்ள காட்சிகளுக்கு இந்த முறை பயனுள்ளதாக இருக்கும், மேலும் பயன்பாட்டின் வெவ்வேறு பகுதிகளில் மீண்டும் பயன்படுத்த வேண்டிய அவசியமில்லை. இந்த நெகிழ்வுத்தன்மை டெவலப்பர்கள் தங்கள் திட்டத் தேவைகளுக்கு மிகவும் பொருத்தமான சரிபார்ப்பு முறையைத் தேர்வுசெய்ய அனுமதிக்கிறது.

இந்த தீர்வுகளின் சரியான தன்மையை உறுதிப்படுத்த, UNIT ஐப் பயன்படுத்தி அலகு சோதனைகள் எழுதப்பட்டன. இந்த சோதனைகள் செல்லுபடியாகும் மற்றும் தவறான தேதி வரம்புகளை உறுதிப்படுத்துகின்றன, தனிப்பயன் சிறுகுறிப்பு மற்றும் சேவை-நிலை தர்க்கம் எதிர்பார்த்தபடி செயல்படுகின்றன என்பதை உறுதிப்படுத்துகிறது. எடுத்துக்காட்டாக, ஒரு சோதனை வழக்கு "2023-01-01" இன் தொடக்க தேதி மற்றும் "2023-12-31" இன் இறுதி தேதி ஆகியவை சரிபார்ப்பைக் கடந்து செல்கின்றன, அதே நேரத்தில் தேதிகளின் தலைகீழ் வரிசை தோல்வியடைகிறது என்பதை சரிபார்க்கிறது. அலகு சோதனைகளை இணைப்பதன் மூலம், பயன்பாட்டின் வலுவான தன்மை மேம்படுத்தப்பட்டுள்ளது, மேலும் எதிர்கால மாற்றங்கள் நம்பிக்கையுடன் சரிபார்க்கப்படலாம். .

package sk.softec.akademia.demo.validation;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target({ ElementType.PARAMETER })
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = StartDateBeforeEndDateValidator.class)
public @interface StartDateBeforeEndDate {
    String message() default "Start date cannot be later than end date";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

package sk.softec.akademia.demo.validation;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import java.time.LocalDate;
public class StartDateBeforeEndDateValidator implements ConstraintValidator<StartDateBeforeEndDate, Object[]> {
    @Override
    public boolean isValid(Object[] values, ConstraintValidatorContext context) {
        if (values == null || values.length < 2 || !(values[0] instanceof LocalDate) || !(values[1] instanceof LocalDate)) {
            return true; // Default behavior when values are not properly passed
        }
        LocalDate startDate = (LocalDate) values[0];
        LocalDate endDate = (LocalDate) values[1];
        return startDate == null || endDate == null || !startDate.isAfter(endDate);
    }
}

@Service
public class StandingOrderService {
    public List<StandingOrderResponseDTO> findByValidFromBetween(LocalDate startDate, LocalDate endDate) {
        if (startDate.isAfter(endDate)) {
            throw new IllegalArgumentException("Start date cannot be after end date.");
        }
        // Logic to fetch and return the data from the database
        return standingOrderRepository.findByDateRange(startDate, endDate);
    }
}

package sk.softec.akademia.demo.validation;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
public class StartDateBeforeEndDateValidatorTest {
    private final StartDateBeforeEndDateValidator validator = new StartDateBeforeEndDateValidator();
    @Test
    void testValidDates() {
        Object[] validDates = {LocalDate.of(2023, 1, 1), LocalDate.of(2023, 12, 31)};
        assertTrue(validator.isValid(validDates, null));
    }
    @Test
    void testInvalidDates() {
        Object[] invalidDates = {LocalDate.of(2023, 12, 31), LocalDate.of(2023, 1, 1)};
        assertFalse(validator.isValid(invalidDates, null));
    }
}

வசந்த துவக்கத்தில் வினவல் அளவுரு சரிபார்ப்புக்கான மேம்பட்ட நுட்பங்கள்

வசந்த துவக்கத்தில் பல வினவல் அளவுருக்களை சரிபார்ப்பதற்கான ஒரு மேம்பட்ட அம்சம், AOP (அம்சம் சார்ந்த நிரலாக்க) உடன் இணைந்து தனிப்பயன் சிறுகுறிப்புகளைப் பயன்படுத்துவதாகும். அம்சங்களை மேம்படுத்துவதன் மூலம், டெவலப்பர்கள் சரிபார்ப்பு தர்க்கத்தை மையப்படுத்தலாம், மேலும் குறியீட்டை மிகவும் மட்டுப்படுத்தவும் பராமரிக்கவும் முடியும். உதாரணமாக, உங்கள் கட்டுப்பாட்டு முறைக்கு தனிப்பயன் சிறுகுறிப்பை உருவாக்கலாம், இது முறை செயல்படுத்தும் முன் சரிபார்ப்பைச் செய்ய ஒரு அம்சத்தைத் தூண்டுகிறது. சரிபார்ப்பு தர்க்கத்தை பல இறுதிப் புள்ளிகள் அல்லது சேவைகளில் மீண்டும் பயன்படுத்த வேண்டியிருக்கும் போது இந்த அணுகுமுறை மிகவும் பயனுள்ளதாக இருக்கும். .

மற்றொரு பயனுள்ள நுட்பம் ஸ்பிரிங்ஸை மேம்படுத்துவதை உள்ளடக்குகிறது ஹேண்ட்லர்மெதோடார்குமென்ட்ரெசால்வர். முறை வாதங்கள் கட்டுப்படுத்திக்கு அனுப்பப்படுவதற்கு முன்பு அவற்றை இடைமறிக்கவும் கையாளவும் இது உங்களை அனுமதிக்கிறது. இதைப் பயன்படுத்தி, வினவல் அளவுருக்களை நீங்கள் சரிபார்க்கலாம், விதிவிலக்குகள் செல்லாது என்றால் அவற்றை எறியலாம், மேலும் கூடுதல் தரவுகளுடன் அளவுருக்களை வளப்படுத்தலாம். இந்த அணுகுமுறை நெகிழ்வுத்தன்மையை வழங்குகிறது மற்றும் சிக்கலான சரிபார்ப்பு தேவைகளைக் கொண்ட பயன்பாடுகளுக்கு மிகவும் பொருத்தமானது. .

கடைசியாக, ஹைபர்னேட் வாலிடேட்டர் போன்ற நூலகத்தை ஒருங்கிணைப்பதன் மூலம் சரிபார்ப்பு திறன்களை நீட்டிக்க முடியும், இது பீன் சரிபார்ப்பு ஏபிஐயின் ஒரு பகுதியாகும். தனிப்பயன் கட்டுப்பாடுகளை வரையறுத்து அவற்றை வினவல் அளவுருக்களுக்கு மேப்பிங் செய்வதன் மூலம், தர்க்கம் ஒரு தரப்படுத்தப்பட்ட கட்டமைப்பைக் கடைப்பிடிப்பதை உறுதிசெய்கிறீர்கள். வசந்த துவக்கத்துடன் இணைந்து @Exceptionhandler, நீங்கள் சரிபார்ப்பு பிழைகளை அழகாக கையாளலாம் மற்றும் ஏபிஐ வாடிக்கையாளர்களுக்கு அர்த்தமுள்ள கருத்துக்களை வழங்கலாம், ஒட்டுமொத்த டெவலப்பர் அனுபவம் மற்றும் ஏபிஐ பயன்பாட்டினை மேம்படுத்தலாம்.