Invalid value 'crescator' for orders given; Has to be either 'desc' or 'asc' (case insensitive)
Sort.Direction.fromString primește doar textele asc sau desc (cu orice fel de litere). Orice altă valoare, de exemplu crescator, aruncă IllegalArgumentException, iar cererea primește 500. Transformă tu parametrul în Sort.Direction.ASC / DESC sau validează-l înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din Sort.Direction.fromString(String) din Spring Data. Metoda transformă un text în direcția de sortare și acceptă doar asc și desc (fără să conteze literele mari). Pentru orice altă valoare aruncă IllegalArgumentException: Invalid value 'crescator' for orders given; Has to be either 'desc' or 'asc' (case insensitive).
Eroarea apare de obicei când direcția vine direct din cerere, dintr-un @RequestParam, iar interfața trimite alte cuvinte (crescator, up, ascending) sau un text gol. Fiind o excepție neprinsă, clientul primește 500, deși greșeala este în datele lui.
Același mesaj îl poți vedea și când folosești parametrul standard ?sort=pret,crescator cu un Pageable: partea de după virgulă trebuie să fie asc sau desc.
De ce apare: cauzele frecvente
1Cuvântul din interfață ajunge direct în fromString
Sort.Direction d = Sort.Direction.fromString(ordine);
// ?ordine=crescatorSort.Direction d = ordine.equals("descrescator")
? Sort.Direction.DESC : Sort.Direction.ASC;Faci tu traducerea din vocabularul interfeței în valorile pe care le acceptă Spring Data.
2Valoarea poate lipsi sau poate fi greșită
@RequestParam String ordine@RequestParam(defaultValue = "asc") String ordine
// și Sort.Direction.fromOptionalString(ordine).orElse(Sort.Direction.ASC)fromOptionalString întoarce Optional.empty() pentru o valoare necunoscută, în loc să arunce excepție.
3Parametrul sort al unui Pageable
GET /produse?sort=pret,crescatorGET /produse?sort=pret,ascFormatul standard este proprietate,asc|desc, iar Spring construiește singur Sort-ul din el.
Repară eroarea, direct în pagină
GET /produse?ordine=crescator răspunde 500 cu Invalid value 'crescator' for orders given. Interfața magazinului trimite crescator sau descrescator. Transformă tu cuvântul în direcția Spring Data, ca produsele să vină sortate după preț în ordinea cerută.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.data.domain.Sort;
import org.springframework.data.jpa.repository.JpaRepository;
import jakarta.persistence.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id @GeneratedValue
private Long id;
private String nume;
private int pret;
protected Produs() { }
public Long getId() { return id; }
public String getNume() { return nume; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> { }
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
// ordine = crescator sau descrescator (așa trimite interfața magazinului)
@GetMapping("/produse")
List<Produs> toate(@RequestParam String ordine) {
// TODO: transformă cuvântul românesc în Sort.Direction
Sort.Direction directie = Sort.Direction.fromString(ordine);
return repo.findAll(Sort.by(directie, "pret"));
}
}Tomcat started on port 8080 (http)
Started Application
GET /produse?ordine=crescator → 200
[{"id":2,"nume":"Mouse","pret":89},{"id":3,"nume":"Tastatură","pret":199},{"id":1,"nume":"Monitor","pret":899}]
GET /produse?ordine=descrescator → 200
[{"id":1,"nume":"Monitor","pret":899},{"id":3,"nume":"Tastatură","pret":199},{"id":2,"nume":"Mouse","pret":89}]Indiciu
Compară ordine cu "descrescator" și alege Sort.Direction.DESC sau Sort.Direction.ASC.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.data.domain.Sort;
import org.springframework.data.jpa.repository.JpaRepository;
import jakarta.persistence.*;
import java.util.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id @GeneratedValue
private Long id;
private String nume;
private int pret;
protected Produs() { }
public Long getId() { return id; }
public String getNume() { return nume; }
public int getPret() { return pret; }
}
interface ProdusRepository extends JpaRepository<Produs, Long> { }
@RestController
class ProdusController {
private final ProdusRepository repo;
ProdusController(ProdusRepository repo) {
this.repo = repo;
}
// ordine = crescator sau descrescator (așa trimite interfața magazinului)
@GetMapping("/produse")
List<Produs> toate(@RequestParam String ordine) {
Sort.Direction directie = ordine.equals("descrescator") ? Sort.Direction.DESC : Sort.Direction.ASC;
return repo.findAll(Sort.by(directie, "pret"));
}
}De ce merge
Sort.Direction.fromString cunoaște doar asc și desc, deci crescator arunca excepție și cererea dădea 500. Acum alegi explicit Sort.Direction.DESC pentru descrescator și ASC în rest, apoi construiești Sort.by(directie, "pret"). Repository-ul primește o sortare validă, iar vocabularul interfeței rămâne o problemă a controller-ului.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Invalid value 'up' for orders given; Has to be either 'desc' or 'asc' (case insensitive)Invalid value '' for orders given; Has to be either 'desc' or 'asc' (case insensitive)
Cum o eviți pe viitor
- Nu da textul din cerere direct lui
fromString: foloseștefromOptionalStringsau o mapare explicită. - Pune o valoare implicită pentru direcție (
defaultValue = "asc"). - Pentru valori fixe, primește parametrul ca enum propriu și tratează conversia greșită ca 400.
- Documentează valorile acceptate în specificația API.
Întrebări frecvente
De ce primesc 500 și nu 400?
Pentru Spring MVC, IllegalArgumentException aruncată din codul tău e o eroare a serverului. Dacă vrei 400, validează parametrul și aruncă ResponseStatusException(HttpStatus.BAD_REQUEST, ...).
Contează literele mari?
Nu. ASC, Asc și asc sunt acceptate; contează doar ca textul să fie unul dintre cele două cuvinte.
Erori înrudite
Page size must not be less than one Ai creat un PageRequest cu mărimea paginii 0 sau negativă, de obicei dintr-un parametru primit de la client. PageRequest.of verifică și aruncă IllegalArgumentException (500). Validează mărimea (minim 1, plus o limită maximă) sau folosește Pageable, pe care Spring îl normalizează singur. Unable to locate Attribute with the given name [pretul] on this ManagedType [Produs] Ai cerut sortarea (Sort sau ?sort= în Pageable) după un câmp care nu există în entitate. Hibernate nu găsește atributul și interogarea pică cu 500. Sortează doar după câmpuri existente și, dacă sortarea vine de la client, permite doar o listă de câmpuri cunoscute. java.lang.IllegalArgumentException: No enum constant StatusComanda.livrata Enum.valueOf(text) a primit un text care nu este exact numele unei constante (diferă majusculele sau valoarea nu există). Normalizează textul (toUpperCase) și tratează valorile necunoscute, sau lasă Spring să convertească parametrul direct în enum. Învață Spring Boot de la zero, cu exerciții la fiecare lecție
Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.
